1use serde::{Deserialize, Deserializer, Serialize};
3use serde_json::{Map, Value};
4use time::OffsetDateTime;
5use uuid::Uuid;
6
7pub const MODEL_LOG_PROTOCOL: u32 = 2;
8
9#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
10#[serde(rename_all = "snake_case")]
11pub enum ChangeKind {
12 Create,
13 Update,
14 Delete,
15}
16
17fn present<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Option<Value>, D::Error> {
18 Value::deserialize(deserializer).map(Some)
19}
20
21#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
24pub struct FieldDiff {
25 pub field: String,
26 #[serde(
27 default,
28 skip_serializing_if = "Option::is_none",
29 deserialize_with = "present"
30 )]
31 pub old_value: Option<Value>,
32 #[serde(
33 default,
34 skip_serializing_if = "Option::is_none",
35 deserialize_with = "present"
36 )]
37 pub new_value: Option<Value>,
38 #[serde(default, skip_serializing_if = "is_false")]
39 pub old_sql_null: bool,
40 #[serde(default, skip_serializing_if = "is_false")]
41 pub new_sql_null: bool,
42}
43fn is_false(value: &bool) -> bool {
44 !value
45}
46
47#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
48pub struct ModelOperation {
49 #[serde(with = "crate::decimal_i64")]
50 pub id: i64,
51 pub record_id: Uuid,
52 #[serde(with = "crate::decimal_i64")]
53 pub revision: i64,
54 pub kind: ChangeKind,
55 pub diff: Vec<FieldDiff>,
56 #[serde(with = "time::serde::rfc3339")]
57 pub created_at: OffsetDateTime,
58 pub schema_version: u32,
59}
60
61#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
62pub struct ModelChanges {
63 pub model: String,
64 pub history: Uuid,
66 pub operations: Vec<ModelOperation>,
67 #[serde(with = "crate::decimal_i64")]
68 pub next_cursor: i64,
69 pub has_more: bool,
70}
71
72#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
73pub struct ModelState {
74 pub model: String,
75 pub record_id: Uuid,
76 #[serde(with = "crate::decimal_i64")]
77 pub revision: i64,
78 pub schema_version: u32,
79 pub values: Option<Map<String, Value>>,
80 #[serde(default)]
81 pub sql_null_fields: Vec<String>,
82 #[serde(default, with = "time::serde::rfc3339::option")]
83 pub updated_at: Option<OffsetDateTime>,
84 #[serde(default, with = "time::serde::rfc3339::option")]
85 pub deleted_at: Option<OffsetDateTime>,
86}
87
88#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
89#[serde(tag = "status", content = "data", rename_all = "snake_case")]
90pub enum ModelWriteResult {
91 Accepted(Vec<ModelState>),
92 Conflict(Vec<ModelState>),
93 Rejected { code: String, reason: String },
94}
95
96#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
98pub struct ModelWrite {
99 pub model: String,
100 pub record_id: Uuid,
101 pub operation_id: Uuid,
102 pub replica_id: Uuid,
103 #[serde(with = "crate::decimal_i64")]
104 pub base_revision: i64,
105 pub schema_version: u32,
106 pub kind: ChangeKind,
107 pub changes: Option<Map<String, Value>>,
108 #[serde(default)]
109 pub sql_null_fields: Vec<String>,
110}
111
112#[cfg(test)]
113mod tests {
114 use super::*;
115 #[test]
116 fn diff_distinguishes_missing_null_and_json_types() {
117 let input = serde_json::json!([
118 {"field":"optional", "new_value":null},
119 {"field":"document", "old_value":{"x":[1,true,null]}, "new_value":"text"},
120 {"field":"removed", "old_value":null, "old_sql_null":true}
121 ]);
122 let diff: Vec<FieldDiff> = serde_json::from_value(input.clone()).unwrap();
123 assert_eq!(diff[0].old_value, None);
124 assert_eq!(diff[0].new_value, Some(Value::Null));
125 assert_eq!(diff[2].new_value, None);
126 assert_eq!(serde_json::to_value(diff).unwrap(), input);
127 }
128}