nirv-engine 0.1.0

Universal data virtualization and compute orchestration engine with SQL Server, PostgreSQL, REST API, and file system connectors
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
131
132
133
134
135
136
137
138
139
140
141
142
143

use async_trait::async_trait;
use std::collections::HashMap;
use tokio::net::TcpStream;
use crate::utils::{NirvResult, ProtocolError, InternalQuery, QueryResult};

/// Protocol types supported by NIRV Engine
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum ProtocolType {
    PostgreSQL,
    MySQL,
    SQLite,
    SqlServer,
}

/// Connection state for protocol adapters
#[derive(Debug)]
pub struct Connection {
    pub stream: TcpStream,
    pub authenticated: bool,
    pub database: String,
    pub parameters: HashMap<String, String>,
    pub protocol_type: ProtocolType,
}

impl Connection {
    pub fn new(stream: TcpStream, protocol_type: ProtocolType) -> Self {
        Self {
            stream,
            authenticated: false,
            database: String::new(),
            parameters: HashMap::new(),
            protocol_type,
        }
    }
}

/// Authentication credentials
#[derive(Debug, Clone)]
pub struct Credentials {
    pub username: String,
    pub password: Option<String>,
    pub database: String,
    pub parameters: HashMap<String, String>,
}

impl Credentials {
    pub fn new(username: String, database: String) -> Self {
        Self {
            username,
            password: None,
            database,
            parameters: HashMap::new(),
        }
    }
    
    pub fn with_password(mut self, password: String) -> Self {
        self.password = Some(password);
        self
    }
    
    pub fn with_parameter(mut self, key: String, value: String) -> Self {
        self.parameters.insert(key, value);
        self
    }
}

/// Protocol-specific query representation
#[derive(Debug, Clone)]
pub struct ProtocolQuery {
    pub raw_query: String,
    pub parameters: Vec<String>,
    pub protocol_type: ProtocolType,
}

impl ProtocolQuery {
    pub fn new(raw_query: String, protocol_type: ProtocolType) -> Self {
        Self {
            raw_query,
            parameters: Vec::new(),
            protocol_type,
        }
    }
    
    pub fn with_parameters(mut self, parameters: Vec<String>) -> Self {
        self.parameters = parameters;
        self
    }
}

/// Protocol-specific response representation
#[derive(Debug, Clone)]
pub struct ProtocolResponse {
    pub result: QueryResult,
    pub protocol_type: ProtocolType,
    pub format: ResponseFormat,
}

/// Response format options
#[derive(Debug, Clone, PartialEq)]
pub enum ResponseFormat {
    Text,
    Binary,
}

impl ProtocolResponse {
    pub fn new(result: QueryResult, protocol_type: ProtocolType) -> Self {
        Self {
            result,
            protocol_type,
            format: ResponseFormat::Text,
        }
    }
    
    pub fn with_format(mut self, format: ResponseFormat) -> Self {
        self.format = format;
        self
    }
}

/// Main trait for database protocol adapters
#[async_trait]
pub trait ProtocolAdapter: Send + Sync {
    /// Accept a new connection and perform initial handshake
    async fn accept_connection(&self, stream: TcpStream) -> NirvResult<Connection>;
    
    /// Authenticate a connection with provided credentials
    async fn authenticate(&self, conn: &mut Connection, credentials: Credentials) -> NirvResult<()>;
    
    /// Handle a query from the client and return a response
    async fn handle_query(&self, conn: &Connection, query: ProtocolQuery) -> NirvResult<ProtocolResponse>;
    
    /// Get the protocol type this adapter handles
    fn get_protocol_type(&self) -> ProtocolType;
    
    /// Parse protocol-specific message into internal representation
    async fn parse_message(&self, conn: &Connection, data: &[u8]) -> NirvResult<ProtocolQuery>;
    
    /// Format internal query result into protocol-specific response
    async fn format_response(&self, conn: &Connection, result: QueryResult) -> NirvResult<Vec<u8>>;
    
    /// Handle connection termination
    async fn terminate_connection(&self, conn: &mut Connection) -> NirvResult<()>;
}