# kiarashminoo/thunderpropagator.clustermessagebuses architecture

> Architecture diagram of the GitHub repository kiarashminoo/thunderpropagator.clustermessagebuses, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kiarashminoo/thunderpropagator.clustermessagebuses
- Repository: https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses

## Overview

ThunderPropagator.ClusterMessageBuses provides pluggable transports for coordinating cluster nodes and distributing internal events. The principal workflow is a cluster node using a configured message bus to exchange cluster traffic with peers through a broker, RPC, or socket transport. The tree also exposes request/reply, fan-out, snapshot, and subscription operations, plus shared support for channel resolution, pending requests, connection caching, and resilience. Source excerpts are limited, so transport-to-peer links are documented at the product level; unsampled implementation details are not inferred.

Main entry points: [`src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs`](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs) (Azure bus), [`src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs`](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs) (RDMA bus), [`src/ThunderPropagator.ClusterMessageBuses.ActiveMQ/ActiveMqClusterMessageBus.cs`](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.ActiveMQ/ActiveMqClusterMessageBus.cs) (ActiveMQ bus), [`src/ThunderPropagator.ClusterMessageBuses.AwsSqs/AwsSqsClusterMessageBus.cs`](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AwsSqs/AwsSqsClusterMessageBus.cs) (AWS SQS bus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_broker["Broker transports"]
  node_activemq["ActiveMQ bus"]
  node_sqs["AWS SQS bus"]
  node_azure["Azure bus"]
  node_gcp["GCP Pub/Sub bus"]
  node_kafka["Kafka bus"]
  node_mqtt["MQTT bus"]
  node_nats["NATS bus"]
  node_pulsar["Pulsar bus"]
  node_rabbit["RabbitMQ bus"]
  node_redis["Redis Pub/Sub bus"]
end

subgraph group_network["Network transports"]
  node_grpc["gRPC bus"]
  node_tcp["TCP bus"]
  node_udp["UDP bus"]
  node_webapi["Web API bus"]
  node_websocket["WebSocket bus"]
  node_zeromq["ZeroMQ bus"]
  node_rdma["RDMA bus"]
  node_srd["SRD bus"]
end

subgraph group_shared["Shared kernel"]
  node_channel_resolver["Channel resolver"]
  node_pending_requests["Pending requests"]
  node_response_envelope["Response envelope"]
  node_connection_cache["Connection cache"]
  node_resilience["Resilience pipeline"]
end

subgraph group_membership["Membership"]
  node_swim["SWIM bus"]
end

node_cluster_node(("Cluster node"))

node_cluster_node -.->|"uses bus"| node_activemq
node_cluster_node -.->|"uses bus"| node_sqs
node_cluster_node -.->|"uses bus"| node_azure
node_cluster_node -.->|"uses bus"| node_gcp
node_cluster_node -.->|"uses bus"| node_kafka
node_cluster_node -.->|"uses bus"| node_mqtt
node_cluster_node -.->|"uses bus"| node_nats
node_cluster_node -.->|"uses bus"| node_pulsar
node_cluster_node -.->|"uses bus"| node_rabbit
node_cluster_node -.->|"uses bus"| node_redis
node_cluster_node -.->|"uses bus"| node_grpc
node_cluster_node -.->|"uses bus"| node_tcp
node_cluster_node -.->|"uses bus"| node_udp
node_cluster_node -.->|"uses bus"| node_webapi
node_cluster_node -.->|"uses bus"| node_websocket
node_cluster_node -.->|"uses bus"| node_zeromq
node_cluster_node -.->|"uses bus"| node_rdma
node_cluster_node -.->|"uses bus"| node_srd
node_cluster_node -.->|"uses bus"| node_swim
node_azure -->|"resolves channels"| node_channel_resolver
node_azure -->|"tracks requests"| node_pending_requests
node_azure -->|"exchanges envelopes"| node_response_envelope
node_azure -->|"builds pipeline"| node_resilience
node_rdma -->|"caches connections"| node_connection_cache

click node_activemq "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.ActiveMQ/ActiveMqClusterMessageBus.cs"
click node_sqs "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AwsSqs/AwsSqsClusterMessageBus.cs"
click node_azure "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs"
click node_gcp "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.GcpPubSub/GcpPubSubClusterMessageBus.cs"
click node_kafka "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Kafka/KafkaClusterMessageBus.cs"
click node_mqtt "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Mqtt/MqttClusterMessageBus.cs"
click node_nats "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.NATS/NatsClusterMessageBus.cs"
click node_pulsar "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Pulsar/PulsarClusterMessageBus.cs"
click node_rabbit "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.RabbitMQ/RabbitMqClusterMessageBus.cs"
click node_redis "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.RedisPubSub/RedisPubSubClusterMessageBus.cs"
click node_grpc "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Grpc/GrpcClusterMessageBus.cs"
click node_tcp "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.TcpSocket/TcpClusterMessageBus.cs"
click node_udp "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.UdpClient/UdpClusterMessageBus.cs"
click node_webapi "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.WebApi/WebApiClusterMessageBus.cs"
click node_websocket "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.WebSocket/WebSocketClusterMessageBus.cs"
click node_zeromq "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.ZeroMQ/ZeroMqClusterMessageBus.cs"
click node_rdma "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs"
click node_srd "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Srd/SrdClusterMessageBus.cs"
click node_swim "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Swim/SwimClusterMessageBus.cs"
click node_channel_resolver "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/IClusterChannelResolver.cs"
click node_pending_requests "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/PendingRequestTracker.cs"
click node_response_envelope "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResponseEnvelope.cs"
click node_connection_cache "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterConnectionCache.cs"
click node_resilience "https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResiliencePipelineFactory.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activemq,node_sqs,node_azure,node_gcp,node_kafka,node_mqtt,node_nats,node_pulsar,node_rabbit,node_redis toneBlue
class node_grpc,node_tcp,node_udp,node_webapi,node_websocket,node_zeromq,node_rdma,node_srd toneAmber
class node_channel_resolver,node_pending_requests,node_response_envelope,node_connection_cache,node_resilience toneMint
class node_swim toneRose
class node_cluster_node toneIndigo
```

## Components

### Broker transports

- [ActiveMQ bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.ActiveMQ/ActiveMqClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.ActiveMQ/ActiveMqClusterMessageBus.cs`
- [AWS SQS bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AwsSqs/AwsSqsClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.AwsSqs/AwsSqsClusterMessageBus.cs`
- [Azure bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs`
- [GCP Pub/Sub bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.GcpPubSub/GcpPubSubClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.GcpPubSub/GcpPubSubClusterMessageBus.cs`
- [Kafka bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Kafka/KafkaClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Kafka/KafkaClusterMessageBus.cs`
- [MQTT bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Mqtt/MqttClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Mqtt/MqttClusterMessageBus.cs`
- [NATS bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.NATS/NatsClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.NATS/NatsClusterMessageBus.cs`
- [Pulsar bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Pulsar/PulsarClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Pulsar/PulsarClusterMessageBus.cs`
- [RabbitMQ bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.RabbitMQ/RabbitMqClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.RabbitMQ/RabbitMqClusterMessageBus.cs`
- [Redis Pub/Sub bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.RedisPubSub/RedisPubSubClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.RedisPubSub/RedisPubSubClusterMessageBus.cs`

### Network transports

- [gRPC bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Grpc/GrpcClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Grpc/GrpcClusterMessageBus.cs`
- [TCP bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.TcpSocket/TcpClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.TcpSocket/TcpClusterMessageBus.cs`
- [UDP bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.UdpClient/UdpClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.UdpClient/UdpClusterMessageBus.cs`
- [Web API bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.WebApi/WebApiClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.WebApi/WebApiClusterMessageBus.cs`
- [WebSocket bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.WebSocket/WebSocketClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.WebSocket/WebSocketClusterMessageBus.cs`
- [ZeroMQ bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.ZeroMQ/ZeroMqClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.ZeroMQ/ZeroMqClusterMessageBus.cs`
- [RDMA bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs`
- [SRD bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Srd/SrdClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Srd/SrdClusterMessageBus.cs`

### Shared kernel

- [Channel resolver](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/IClusterChannelResolver.cs): `src/ThunderPropagator.ClusterMessageBuses.SharedKernel/IClusterChannelResolver.cs`
- [Pending requests](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/PendingRequestTracker.cs): `src/ThunderPropagator.ClusterMessageBuses.SharedKernel/PendingRequestTracker.cs`
- [Response envelope](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResponseEnvelope.cs): `src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResponseEnvelope.cs`
- [Connection cache](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterConnectionCache.cs): `src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterConnectionCache.cs`
- [Resilience pipeline](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResiliencePipelineFactory.cs): `src/ThunderPropagator.ClusterMessageBuses.SharedKernel/ClusterResiliencePipelineFactory.cs`

### Membership

- [SWIM bus](https://github.com/kiarashminoo/thunderpropagator.clustermessagebuses/blob/develop/src/ThunderPropagator.ClusterMessageBuses.Swim/SwimClusterMessageBus.cs): `src/ThunderPropagator.ClusterMessageBuses.Swim/SwimClusterMessageBus.cs`

### Other components

- **Cluster node**

## Connections

- Cluster node → ActiveMQ bus: uses bus
- Cluster node → AWS SQS bus: uses bus
- Cluster node → Azure bus: uses bus
- Cluster node → GCP Pub/Sub bus: uses bus
- Cluster node → Kafka bus: uses bus
- Cluster node → MQTT bus: uses bus
- Cluster node → NATS bus: uses bus
- Cluster node → Pulsar bus: uses bus
- Cluster node → RabbitMQ bus: uses bus
- Cluster node → Redis Pub/Sub bus: uses bus
- Cluster node → gRPC bus: uses bus
- Cluster node → TCP bus: uses bus
- Cluster node → UDP bus: uses bus
- Cluster node → Web API bus: uses bus
- Cluster node → WebSocket bus: uses bus
- Cluster node → ZeroMQ bus: uses bus
- Cluster node → RDMA bus: uses bus
- Cluster node → SRD bus: uses bus
- Cluster node → SWIM bus: uses bus
- Azure bus → Channel resolver: resolves channels (evidence: `src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs`)
- Azure bus → Pending requests: tracks requests (evidence: `src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.cs`)
- Azure bus → Response envelope: exchanges envelopes (evidence: `src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.RequestReply.cs`)
- Azure bus → Resilience pipeline: builds pipeline (evidence: `src/ThunderPropagator.ClusterMessageBuses.AzureServiceBus/AzureServiceBusClusterMessageBus.RequestReply.cs`)
- RDMA bus → Connection cache: caches connections (evidence: `src/ThunderPropagator.ClusterMessageBuses.Rdma/RdmaClusterMessageBus.cs`)
