Welcome to NatsPubsub
NatsPubsub is a production-ready pub/sub library for NATS JetStream with implementations in both TypeScript and Ruby.
🚀 Quick Links
✨ Key Features
- 🎯 Topic-Based Messaging - Simple, hierarchical topic pattern
- 🔌 Declarative Subscribers - Clean DSL for defining subscribers
- 🌲 Wildcard Subscriptions - Support for
*and>wildcards - 🛡️ Inbox/Outbox Patterns - Transactional guarantees
- 🧨 Dead Letter Queue - Automatic handling of failed messages
- ⚙️ Durable Pull Consumers - Reliable message delivery
- 🎭 Middleware System - Extensible processing pipeline
- 🚀 TypeScript First - Full type safety (JavaScript package)
- 🔗 Rails Integration - Deep ActiveRecord integration (Ruby package)
📦 Choose Your Package
JavaScript/TypeScript
Perfect for Node.js microservices, perfect for modern JavaScript/TypeScript applications.
npm install nats-pubsub
Best For:
- Modern JavaScript/TypeScript applications
- Framework-agnostic projects
- Type-safe development
- Microservices architecture
Ruby
Perfect for Ruby on Rails applications with deep ActiveRecord integration.
gem install nats_pubsub
Best For:
- Rails applications
- Ruby microservices
- Teams needing Web UI
- Transactional guarantees with Inbox/Outbox
🌐 Cross-Language Compatibility
Both packages use identical event formats, enabling seamless communication across languages!
Ruby Service → NATS → JavaScript Service ✅
JavaScript Service → NATS → Ruby Service ✅
📖 Getting Started
For detailed documentation and examples:
- JavaScript/TypeScript: See the package README and examples
- Ruby: See the package README and Rails Quick Start
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
📄 License
MIT License - see LICENSE for details.