Sailhouse

Os topics são os baldes onde seus eventos ficam agrupados. Você publica um evento JSON em um único topic, identificado por um slug, e a plataforma o distribui para cada assinatura ligada a esse topic. Os eventos também carregam metadados, e é assim que a plataforma cola trace IDs ou marca um evento disparado por cron com o seu agendamento. Topics e assinaturas são os dois recursos base, e todo o resto é construído em cima deles.

O Sailhouse suporta os dois modelos de entrega. Uma assinatura push envia uma requisição POST para o seu endpoint quando chega um evento, e espera uma resposta 200 em 5 segundos. Uma pull inverte isso: o seu worker pede os eventos no ritmo dele, o que combina com trabalhos pesados de processamento como um ciclo de cobrança ou um resumo semanal. Você escolhe por assinatura, então um mesmo topic pode alimentar ao mesmo tempo um webhook em tempo real e um worker em lote.

Os grupos de espera são o recurso que torna prático o trabalho de agentes em paralelo. Você entrega à plataforma uma lista de eventos para disparar e um topic para avisar na conclusão; o Sailhouse executa e publica um evento quando o grupo inteiro termina. Sem isso você escreveria verificações duplicadas ou um laço sujeito a condição de corrida do tipo "já terminou tudo?". É o mesmo padrão de um wait-group de uma linguagem de programação, movido para um sistema orientado a eventos onde as retentativas não geram chamadas extras.

O Sailhouse cria recursos sob demanda. Você envia um evento para um topic que não existe e a plataforma o cria com o slug que você passou, e depois guarda o evento ali. As assinaturas pull podem ser criadas do mesmo jeito, com uma janela de tempo de até 24 horas que puxa tudo o que entrou em um topic nesse período. O objetivo é ter menos passos de esquema entre escrever o código e lançar, algo que importa quando você itera sobre um agente.

Você pode enfileirar trabalho para depois de duas formas. Os eventos agendados definem um horário em um evento único ou em uma assinatura, útil para processar um pagamento 14 dias depois de um pedido ou enviar um lembrete. Os cron jobs, hoje em beta privada, disparam eventos para um topic em um agendamento repetido, sempre em UTC, para resumos diários ou cálculos de uso de hora em hora. Os dois reutilizam o mesmo modelo de assinatura, então não há um agendador separado para aprender.

Os filtros de assinatura deixam você manter topics genéricos e ainda assim cortar ruído e custo. Em vez de dividir um topic em uma dúzia de topics estreitos, você filtra na assinatura com um caminho JSON, e assim um consumidor só vê os eventos que lhe interessam. A plataforma também suporta limite de taxa e deduplicação na mesma camada, que é onde você colocaria defesas contra entregas duplicadas ou uma rajada de um publicador descontrolado.

O Sailhouse oferece SDKs próprios para TypeScript e JavaScript, Go, Python (beta) e Rust (beta), além de uma CLI e uma API REST para todo o resto. A parte de observabilidade cobre o rastreamento de eventos, então você pode colar trace IDs e seguir um evento pelo sistema. Por ser hospedada, as regiões de ingestão hoje abrangem Londres, Ashburn e San Jose, com os dados gravados de forma central e criptografados em trânsito e em repouso.