Skip to main content

cripsy_binary_api/domain/
event.rs

1//! Eventos del ciclo de vida: el reemplazo tipado del polling.
2
3use serde::{Deserialize, Serialize};
4use serde_json::Value;
5
6use super::account::AccountBalance;
7use super::candle::Candle;
8use super::operation::{Operation, OperationResult, OrderId};
9use super::payout::Payout;
10use super::platform::{CommissionChange, LiveDeal, TopAsset};
11
12/// Tick de precio (stream nativo): densidad intrasegundo sin polling.
13#[derive(Debug, Clone, Copy, PartialEq, Serialize, Deserialize)]
14pub struct PriceTick {
15    pub price: f64,
16    pub bid: Option<f64>,
17    pub ask: Option<f64>,
18    /// Epoch milisegundos del bróker.
19    pub at_ms: i64,
20}
21
22/// Evento emitido por la sesión de un bróker.
23///
24/// Cada solicitud de datos **push** (resultado de orden, cambio de balance,
25/// payout en vivo) llega aquí; la consulta por polling (`get_operation_result`)
26/// queda solo como respaldo.
27#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
28#[non_exhaustive]
29pub enum Event {
30    OrderOpened(Operation),
31    OrderClosed {
32        id: OrderId,
33        result: OperationResult,
34    },
35    PositionChanged(super::position::Position),
36    BalanceChanged(AccountBalance),
37    Candle(Candle),
38    /// Tick de precio en vivo (stream `candles-generated`, campo `value`).
39    PriceTick {
40        symbol: String,
41        tick: PriceTick,
42    },
43    PayoutChanged(Payout),
44    /// Humor del mercado: porcentaje de call (0-100).
45    TradersMoodChanged {
46        symbol: String,
47        call_percent: f64,
48    },
49    /// Popularidad del activo en la plataforma.
50    TopAssetUpdated(TopAsset),
51    /// Indicadores técnicos del bróker (forma libre, no recalculados).
52    TechnicalIndicators {
53        symbol: String,
54        indicators: Value,
55    },
56    /// Operación de un tercero capturada en vivo.
57    LiveDeal(LiveDeal),
58    /// Comisión de un activo actualizada por el bróker.
59    CommissionChanged(CommissionChange),
60    /// Pérdida de continuidad: el canal descartó `count` eventos.
61    ///
62    /// El stream continúa entregando los eventos posteriores. Se emite para
63    /// distinguir «me quedé atrás» de «la sesión terminó».
64    EventsLost {
65        count: u64,
66    },
67    /// La conexión se interrumpió y la sesión inicia la reconexión.
68    ///
69    /// Las peticiones en vuelo se descartan y, mientras no haya socket, las
70    /// llamadas devuelven `BrokerError::NotConnected`. Los streams de velas
71    /// siguen abiertos y se reanudan al restablecerse la sesión.
72    Disconnected {
73        motivo: String,
74    },
75    /// Sesión restablecida: estado, catálogo y suscripciones ya restaurados.
76    Reconnected {
77        /// Intentos de reconexión consumidos (1 = volvió al primer intento).
78        intentos: u32,
79        /// Tiempo total sin conexión, en milisegundos.
80        downtime_ms: u64,
81    },
82}