Struct PromoteOptions 

#[non_exhaustive]
pub struct PromoteOptions {
    pub upsert: bool,
    pub delete_promotion: bool,
    pub on_conflict: ConflictPolicy,
}

Options controlling Uni::promote_from_fork merge behavior.

Additive and #[non_exhaustive]: the legacy promote_from_fork entry point uses PromoteOptions::default() (insert-only), so existing callers are unaffected.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

upsert: bool

When true, a fork edit to a vertex that already exists on primary (matched by (label, ext_id)) is applied as an in-place property update instead of inserting a twin. Vertices without an ext_id keep the legacy content-UID insert-or-skip behavior. Default false preserves the historical insert-only contract.

delete_promotion: bool

When true, after the pattern loop, primary vertices present at the fork point but removed on the fork are deleted from primary (ext_id-keyed; rows without an ext_id are reported, never deleted). Requires a fork-point baseline; the host builds it and passes it to crate::run_promote. Off by default because it removes primary rows.

on_conflict: ConflictPolicy

How to resolve a vertex that diverged on BOTH primary and the fork since the fork point (a concurrent edit). Only consulted in the baseline-aware merge (i.e. when a baseline is supplied).

Implementations

impl PromoteOptions

pub fn insert_only() -> Self

Insert-only (legacy) options — the default.

pub fn with_upsert() -> Self

Enable ext_id-keyed upsert of existing primary vertices (fork-wins, no baseline).

pub fn with_merge() -> Self

Enable baseline-aware merge: ext_id upsert + conflict detection + delete-promotion. The host supplies a PromoteBaseline.

pub fn on_conflict(self, policy: ConflictPolicy) -> Self

Set the conflict policy (builder).

Trait Implementations

impl Clone for PromoteOptions

fn clone(&self) -> PromoteOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PromoteOptions

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

Formats the value using the given formatter.

impl Default for PromoteOptions

fn default() -> PromoteOptions

Returns the “default value” for a type.