ores.nats

ores.nats is the NATS messaging transport library for ORE Studio. It provides the three messaging patterns used across all services: synchronous request/reply, queue-group subscribe for load-balanced handlers, and JetStream for durable event streams. All payloads are JSON serialised with rfl::json. Subject names follow the convention {domain}.v1.{entity}.{operation}, with an optional prefix for multi-instance deployments. This library replaced the former binary protocol stack (ores.comms) and is a direct dependency of every domain service.

• NATS server URL and optional subject prefix from configuration.
• JSON-encoded request messages from clients or other services.
• JetStream stream/consumer configuration for durable event subscriptions.

• JSON-encoded reply messages sent to the caller's reply subject.
• Queue-group subscriptions delivering messages to exactly one handler instance.
• JetStream published messages and consumer acknowledgements.

• include/ores.nats/service/nats_client.hpp — connection and request/reply.
• include/ores.nats/service/jetstream_admin.hpp — stream and consumer management.
• include/ores.nats/service/subscription.hpp — queue-group subscribe.
• include/ores.nats/domain/message.hpp — NATS message and correlation types.
• include/ores.nats/config/ — nats_options and CLI argument parsing.

• nats.c — C NATS client library.
• rfl — JSON serialisation for message payloads.
• ores.logging — structured logging.

• NATS — the upstream messaging technology: subjects, wildcards, queue groups, JetStream, NKey/JWT security.
• ORE Studio Messaging Reference — index of every service's subject namespace and links to per-service messaging references.