Componentes
Cliente de servidor perezoso
El SDK de servidor pusher se importa de forma perezosa dentro de getPusherClient(). La
dependencia se mantiene fuera del bundle hasta que las cuatro variables de entorno
requeridas están presentes, de modo que las solicitudes que nunca tocan el tiempo real siguen siendo
ligeras. El cliente se memoiza por proceso.
getPusherClient() devuelve null a menos que INTEGRATION_PUSHER_APP_ID,
INTEGRATION_PUSHER_KEY, INTEGRATION_PUSHER_SECRET e
INTEGRATION_PUSHER_CLUSTER estén todos configurados.
Publisher best-effort
publishContractEvent() es el único punto que llama a trigger. Absorbe
sus propios fallos con logging estructurado: un publish fallido nunca rompe el
worker, webhook o acción de administración que lo produjo.
Un único evento se distribuye a ambos el canal del contrato y el canal de la
cuenta, de modo que los listeners con alcance de cuenta y con alcance de contrato reciben el mismo
mensaje.
Contabilidad de salud
Solo un 5xx o un error de red cuenta contra el veredicto de salud de Pusher. Un
4xx significa que nuestra solicitud estaba mal formada (nuestro bug), no que Pusher esté caído, así que
nunca cambia el estado de la integración. Consulta Operaciones para
el health probe.
