nap-core 0.3.12

Core library for the Narrative Addressing Protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

//! Replace merge strategy.
//!
//! Simple value overwrite using the Rule 6 conflict matrix.
//! No recursion, no special identity handling.

use serde_json::Value;

use crate::merge::conflict::{Conflict, MergeResult};

/// Merge a single value using the replace strategy.
///
/// Applies the conflict matrix:
/// - `current == base && proposed != base` → accept proposed
/// - `proposed == base && current != base` → accept current
/// - `current == proposed` → accept either
/// - all equal → accept base
/// - `current != base && proposed != base && current != proposed` → conflict
pub fn merge_replace(path: &str, base: &Value, current: &Value, proposed: &Value) -> MergeResult {
    // All equal → accept base
    if current == base && proposed == base {
        return MergeResult::Merged(base.clone());
    }

    // Only current changed → accept current
    if current != base && proposed == base {
        return MergeResult::Merged(current.clone());
    }

    // Only proposed changed → accept proposed
    if current == base && proposed != base {
        return MergeResult::Merged(proposed.clone());
    }

    // Both changed to the same value → accept either
    if current == proposed {
        return MergeResult::Merged(current.clone());
    }

    // Both changed differently → conflict
    MergeResult::Conflicts(vec![Conflict::value_mismatch(
        path,
        base.clone(),
        current.clone(),
        proposed.clone(),
    )])
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::json;

    #[test]
    fn test_replace_accept_current() {
        let result = merge_replace(
            "name",
            &json!("Luke"),
            &json!("Luke Skywalker"),
            &json!("Luke"),
        );
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), json!("Luke Skywalker"));
    }

    #[test]
    fn test_replace_accept_proposed() {
        let result = merge_replace(
            "name",
            &json!("Luke"),
            &json!("Luke"),
            &json!("Luke Skywalker"),
        );
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), json!("Luke Skywalker"));
    }

    #[test]
    fn test_replace_accept_either_when_equal() {
        let result = merge_replace(
            "name",
            &json!("Luke"),
            &json!("Luke Skywalker"),
            &json!("Luke Skywalker"),
        );
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), json!("Luke Skywalker"));
    }

    #[test]
    fn test_replace_accept_all_equal() {
        let result = merge_replace("name", &json!("Luke"), &json!("Luke"), &json!("Luke"));
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), json!("Luke"));
    }

    #[test]
    fn test_replace_conflict() {
        let result = merge_replace(
            "name",
            &json!("Luke"),
            &json!("Luke Skywalker"),
            &json!("Anakin"),
        );
        assert!(result.is_conflict());
        let conflicts = result.unwrap_conflicts();
        assert_eq!(conflicts.len(), 1);
        assert_eq!(conflicts[0].current, json!("Luke Skywalker"));
        assert_eq!(conflicts[0].proposed, json!("Anakin"));
    }

    #[test]
    fn test_replace_with_numbers() {
        let result = merge_replace("version", &json!(1), &json!(2), &json!(1));
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), json!(2));
    }

    #[test]
    fn test_replace_with_null() {
        // Explicit deletion vs change
        let result = merge_replace(
            "homeworld",
            &json!("Stewjon"),
            &json!(Value::Null),
            &json!("Stewjon"),
        );
        assert!(result.is_merged());
        assert_eq!(result.unwrap_merged(), Value::Null);
    }
}