reddb-io-server 1.0.7

RedDB server-side engine: storage, runtime, replication, MCP, AI, and the gRPC/HTTP/RedWire/PG-wire dispatchers. Re-exported by the umbrella `reddb` crate.
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

//! Reference Types for Cross-Entity Linking
//!
//! TableRef, NodeRef, VectorRef, and AnyRef for metadata linking.

use std::collections::HashMap;

use super::super::{EntityId, MetadataValue};

/// Reference to a table row (for metadata linking)
#[derive(Debug, Clone)]
pub struct TableRef {
    pub table: String,
    pub row_id: u64,
}

impl TableRef {
    pub fn new(table: impl Into<String>, row_id: u64) -> Self {
        Self {
            table: table.into(),
            row_id,
        }
    }

    /// Convert to MetadataValue for storage
    pub fn to_metadata(&self) -> MetadataValue {
        MetadataValue::Object(HashMap::from([
            (
                "_type".to_string(),
                MetadataValue::String("table_ref".to_string()),
            ),
            (
                "table".to_string(),
                MetadataValue::String(self.table.clone()),
            ),
            ("row_id".to_string(), MetadataValue::Int(self.row_id as i64)),
        ]))
    }
}

/// Reference to a graph node (for metadata linking)
#[derive(Debug, Clone)]
pub struct NodeRef {
    pub collection: String,
    pub node_id: EntityId,
}

impl NodeRef {
    pub fn new(collection: impl Into<String>, node_id: EntityId) -> Self {
        Self {
            collection: collection.into(),
            node_id,
        }
    }

    pub fn to_metadata(&self) -> MetadataValue {
        MetadataValue::Object(HashMap::from([
            (
                "_type".to_string(),
                MetadataValue::String("node_ref".to_string()),
            ),
            (
                "collection".to_string(),
                MetadataValue::String(self.collection.clone()),
            ),
            (
                "node_id".to_string(),
                MetadataValue::Int(self.node_id.0 as i64),
            ),
        ]))
    }
}

/// Reference to a vector (for metadata linking)
#[derive(Debug, Clone)]
pub struct VectorRef {
    pub collection: String,
    pub vector_id: EntityId,
}

impl VectorRef {
    pub fn new(collection: impl Into<String>, vector_id: EntityId) -> Self {
        Self {
            collection: collection.into(),
            vector_id,
        }
    }

    pub fn to_metadata(&self) -> MetadataValue {
        MetadataValue::Object(HashMap::from([
            (
                "_type".to_string(),
                MetadataValue::String("vector_ref".to_string()),
            ),
            (
                "collection".to_string(),
                MetadataValue::String(self.collection.clone()),
            ),
            (
                "vector_id".to_string(),
                MetadataValue::Int(self.vector_id.0 as i64),
            ),
        ]))
    }
}

/// Universal reference enum - can point to anything
#[derive(Debug, Clone)]
pub enum AnyRef {
    Table(TableRef),
    Node(NodeRef),
    Vector(VectorRef),
    Edge(EntityId),
}

impl AnyRef {
    pub fn to_metadata(&self) -> MetadataValue {
        match self {
            Self::Table(r) => r.to_metadata(),
            Self::Node(r) => r.to_metadata(),
            Self::Vector(r) => r.to_metadata(),
            Self::Edge(id) => MetadataValue::Object(HashMap::from([
                (
                    "_type".to_string(),
                    MetadataValue::String("edge_ref".to_string()),
                ),
                ("edge_id".to_string(), MetadataValue::Int(id.0 as i64)),
            ])),
        }
    }
}