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}