https://github.com/fastify/fastify-kafka
Fastify plugin to interact with Apache Kafka
https://github.com/fastify/fastify-kafka
event-sourcing events fastify fastify-plugin kafka
Last synced: 3 months ago
JSON representation
Fastify plugin to interact with Apache Kafka
- Host: GitHub
- URL: https://github.com/fastify/fastify-kafka
- Owner: fastify
- License: mit
- Created: 2017-11-03T13:16:58.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T06:41:37.000Z (3 months ago)
- Last Synced: 2025-03-28T21:07:17.460Z (3 months ago)
- Topics: event-sourcing, events, fastify, fastify-plugin, kafka
- Language: JavaScript
- Homepage: https://npmjs.com/package/@fastify/kafka
- Size: 120 KB
- Stars: 60
- Watchers: 16
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @fastify/kafka
[](https://github.com/fastify/fastify-kafka/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@fastify/kafka)
[](https://github.com/neostandard/neostandard)
Fastify plugin to interact with [Apache Kafka](http://kafka.apache.org/), supporting Kafka producers and consumers.
To achieve the best performance, the plugin uses [`node-rdkafka`](https://github.com/Blizzard/node-rdkafka).
### Install
```
npm i @fastify/kafka
```
### Compatibility
| Plugin version | Fastify version |
| ---------------|-----------------|
| `>=3.x` | `^5.x` |
| `>=0.x <3.x` | `^4.x` |
| `>=0.x <3.x` | `^3.x` |
| `>=0.x <3.x` | `^2.x` |
| `>=0.x <3.x` | `^1.x` |
Please note that if a Fastify version is out of support, then so are the corresponding versions of this plugin
in the table above.
See [Fastify's LTS policy](https://github.com/fastify/fastify/blob/main/docs/Reference/LTS.md) for more details.
### Usage
```js
const crypto = require('node:crypto')
const fastify = require('fastify')()
const group = crypto.randomBytes(20).toString('hex')
fastify
.register(require('@fastify/kafka'), {
producer: {
'metadata.broker.list': '127.0.0.1:9092',
'fetch.wait.max.ms': 10,
'fetch.error.backoff.ms': 50,
'dr_cb': true
},
consumer: {
'metadata.broker.list': '127.0.0.1:9092',
'group.id': group,
'fetch.wait.max.ms': 10,
'fetch.error.backoff.ms': 50,
'auto.offset.reset': 'earliest'
}
})
fastify.post('/data', (req, reply) => {
fastify.kafka.push({
topic: 'updates',
payload: req.body,
key: 'dataKey'
})
})
fastify.kafka.subscribe('updates')
fastify.kafka.on('updates', (msg, commit) => {
console.log(msg.value.toString())
commit()
})
fastify.listen({ port: 3000 }, err => {
if (err) throw err
console.log(`server listening on ${fastify.server.address().port}`)
})
```
For more examples on how to use this plugin, you can take a look at the [examples directory](./examples).
### API
This module exposes the following APIs:
##### Producer
- `fastify.kafka.producer`: the producer instance
- `fastify.kafka.push`: utility to produce a new message
##### Consumer
- `fastify.kafka.consumer`: the consumer instance
- `fastify.kafka.consume`: utility to start the message consuming
- `fastify.kafka.subscribe`: utility to begin subscribing to one or more topics
- `fastify.kafka.on`: topic listener
## Acknowledgments
This project is kindly sponsored by:
- [LetzDoIt](https://www.letzdoitapp.com/)
## License
Licensed under [MIT](./LICENSE).