kotoba-handler 0.1.22

Unified Web Handler for Kotoba ecosystem - integrates server, CLI, and WASM execution
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

//! Common types for handler operations

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Handler execution context
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HandlerContext {
    pub method: String,
    pub path: String,
    pub headers: HashMap<String, String>,
    pub query_params: HashMap<String, String>,
    pub body: Option<String>,
    pub environment: HashMap<String, String>,
}

/// Handler configuration
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HandlerConfig {
    pub timeout_ms: u64,
    pub max_memory_mb: u64,
    pub enable_caching: bool,
    pub enable_logging: bool,
}

/// Handler result
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HandlerResult {
    pub status_code: u16,
    pub headers: HashMap<String, String>,
    pub body: String,
    pub execution_time_ms: u64,
    pub memory_used_mb: f64,
}

/// Handler metadata
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HandlerMetadata {
    pub id: String,
    pub name: String,
    pub version: String,
    pub description: String,
    pub capabilities: Vec<String>,
}

/// WebSocket message types
#[cfg(feature = "websocket")]
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum WebSocketMessage {
    Text(String),
    Binary(Vec<u8>),
    Ping,
    Pong,
    Close,
}

/// Execution mode
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum ExecutionMode {
    Sync,
    Async,
    Streaming,
}

/// Handler capabilities
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HandlerCapabilities {
    pub supports_async: bool,
    pub supports_streaming: bool,
    pub supports_websocket: bool,
    pub supports_file_upload: bool,
    pub max_payload_size: u64,
    pub supported_content_types: Vec<String>,
}