Function fire_before_insert

nodedb/src/control/trigger/fire_before.rs:31–71

Fire BEFORE ROW triggers for an INSERT operation. Returns the (possibly modified) NEW fields. The caller MUST use the returned fields for the actual PointPut dispatch, not the original input — a BEFORE trigger may have normalized or enriched the row. If a trigger raises an exception, the error propagates and the INSERT is aborted.

(
    state: &SharedState,
    identity: &AuthenticatedIdentity,
    tenant_id: TenantId,
    collection: &str,
    new_fields: &HashMap<String, nodedb_types::Value>,
    cascade_depth: u32,
)

///
/// If a trigger raises an exception, the error propagates and the INSERT is aborted.
pub async fn fire_before_insert(
    state: &SharedState,
    identity: &AuthenticatedIdentity,
    tenant_id: TenantId,
    collection: &str,
    new_fields: &HashMap<String, nodedb_types::Value>,
    cascade_depth: u32,
) -> crate::Result<HashMap<String, nodedb_types::Value>> {
    let triggers =
        state
            .trigger_registry
            .get_matching(tenant_id.as_u64(), collection, DmlEvent::Insert);

    let before_triggers: Vec<_> = triggers
        .into_iter()
        .filter(|t| t.timing == TriggerTiming::Before)
        .collect();

    if before_triggers.is_empty() {
        return Ok(new_fields.clone());
    }

    check_cascade_depth(cascade_depth, collection)?;

    let bindings = RowBindings::before_insert(collection, new_fields.clone());

    let result = fire_before_triggers_with_mutation(
        state,
        identity,
        tenant_id,
        collection,
        &before_triggers,
        &bindings,
        cascade_depth,
        Some(new_fields.clone()),
    )
    .await?;

    // Return the (possibly mutated) NEW fields. If None somehow, return original.
    Ok(result.unwrap_or_else(|| new_fields.clone()))
}

/// Fire BEFORE ROW triggers for an UPDATE operation.
///