Horizon-Network-Common 0.2.0

Shared network types and protocols for Horizon ecosystem (Horizon, Atlas, Maestro)
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

//! # Horizon Network Common
//!
//! Shared types and protocols for the Horizon ecosystem:
//! - **Horizon** - Game server instances (regions)
//! - **Horizon-Atlas** - Server meshing proxy and load balancer
//! - **Horizon-Maestro** - Container orchestration and deployment
//!
//! This crate provides the common data structures and communication protocols
//! that enable these three systems to work together for infinite world scaling.
//!
//! ## Architecture
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────────────┐
//! │                         Maestro                                  │
//! │              (Container Orchestration)                           │
//! └─────────────────────────┬───────────────────────────────────────┘
//!                           │ SpawnServerRequest / SpawnServerResponse
//!                           ▼
//! ┌─────────────────────────────────────────────────────────────────┐
//! │                          Atlas                                   │
//! │        (Server Meshing Proxy + Player Routing)                   │
//! └────────┬────────────────┬───────────────────┬───────────────────┘
//!          │                │                   │
//!          │ Registration   │ Heartbeat         │ Transfer
//!          ▼                ▼                   ▼
//! ┌────────────────┐ ┌────────────────┐ ┌────────────────┐
//! │   Horizon      │ │   Horizon      │ │   Horizon      │
//! │  Region(0,0,0) │ │  Region(1,0,0) │ │  Region(0,1,0) │
//! └────────────────┘ └────────────────┘ └────────────────┘
//! ```

pub mod spatial;
pub mod server;
pub mod player;
pub mod transfer;
pub mod health;
pub mod messages;

// Re-export commonly used types

// Spatial types
pub use spatial::{WorldCoordinate, RegionCoordinate, RegionBounds};

// Server types (full structured types)
pub use server::{
    ServerId, ServerInfo, ServerStatus, ServerRegistration, ServerHeartbeat, 
    RegistrationResponse, SpawnServerRequest, SpawnServerResponse,
};

// API-compatible types (flat structures for REST APIs)
pub use server::{
    ApiServerRegistration, ApiRegistrationResponse, AdjacentServerInfo,
    ApiServerHeartbeat, ApiHeartbeatResponse, ServerCommand,
};

// Player types  
pub use player::{PlayerId, PlayerInfo, PlayerState, AuthenticationStatus, ConnectionState, MovementData, DisconnectReason};

// Transfer types
pub use transfer::{TransferToken, TransferRequest, TransferResult, TransferReason, TransferError, TransferNotification};

// Health check types
pub use health::{HealthStatus, HealthCheck, HealthCheckRequest, ComponentHealth, ClusterHealth};

// Inter-service message types
pub use messages::{HorizonMessage, AtlasMessage, AtlasToMaestroMessage, MaestroMessage, Envelope, Ack};