@mqueue/rhea/README.md

MQueue adapter for rhea AMQP v1.0

# rhea for MQueue

An [rhea](https://github.com/amqp/rhea) adapter (AMQP v1.0) for
[MQueue](https://github.com/domwebber/mqueue/blob/main/packages/queue/README.md),
adding support for rhea queues with a multi-backend setup with MQueue.

```bash
npm install --save @mqueue/queue @mqueue/rhea
# or use pnpm/yarn
```

```ts
import MQueue from "@mqueue/queue"; // or require("@mqueue/queue");
import { RheaQueue } from "@mqueue/rhea"; // or require("@mqueue/rhea");

const outgoingQueue = new MQueue.Outgoing(
  await RheaQueue.Outgoing.connect("amqp://rabbitmq:5271", "queue-name"),
);

outgoingQueue.sendMessage({
  headers: {
    "Account-ID": "123",
  },
  body: "...",
});

// ...

const incomingQueue = new MQueue.Incoming(
  await RheaQueue.Incoming.connect("amqp://rabbitmq:5271", "queue-name"),
);

// Start listening to the queue
await incomingQueue.consume(async (payload) => {
  const topicOrQueueName = payload.transport.name;
  const headers = payload.message.headers;
  const data = await payload.message.json();
  await payload.accept(); // or await payload.reject();
  // ...
});
```

## Compatibility

- [RabbitMQ v4 and later](https://rabbitmq.com)
- [RabbitMQ v3 and earler, with the AMQP v1.0 plugin](https://rabbitmq.com)
- [Apache ActiveMQ](https://activemq.apache.org)
- [Azure Service Bus](https://azure.microsoft.com/products/service-bus) -
  **Note**: identity and authentication is easier with the
  [dedicated Azure Service Bus queue adapter](https://github.com/domwebber/mqueue/blob/main/packages/azure-service-bus/README.md)

## License

[MIT © Dom Webber](./LICENSE)