PubSub v0.1.0 - Initial Public Release 🚀

Production-ready Pub/Sub library and standalone service for Go 1.25+

Battle-tested in FreiCON Railway Management System with 95.9% test coverage and zero linter issues.

✨ Features

Core Pub/Sub

• Reliable Message Delivery - Exponential backoff retry (30s → 30m)
• Dead Letter Queue (DLQ) - Failed message tracking after 5 attempts
• Topic-Based Routing - Publisher/Subscriber pattern
• Queue Worker - Background processing with retry logic
• Subscription Management - Full CRUD operations

Architecture

• Clean Architecture + Domain-Driven Design patterns
• Repository Pattern - Clean data access abstraction
• Options Pattern - Modern Go API design (2025 best practices)
• Zero ORM Bloat - Type-safe Relica query builder

Database Support

• Multi-Database - MySQL, PostgreSQL, SQLite
• Embedded Migrations - Automatic schema setup
• Production-Ready - Relica adapters with auto-populate ID

Dual Mode

• As Library - Embed in your Go application
• As Service - Standalone REST API server with Docker support

📦 Installation

As Library

go get github.com/coregx/pubsub@v0.1.0

As Standalone Server

Download pre-built binaries from Assets below or use Docker:

docker pull ghcr.io/coregx/pubsub-server:v0.1.0  # Coming soon

📊 Quality Metrics

• ✅ Test Coverage: 95.9%
• ✅ Linter Issues: 0 (golangci-lint with 34+ linters)
• ✅ Go Version: 1.25+
• ✅ Platforms: Linux, macOS, Windows (amd64, arm64)

📚 Documentation

• README.md - Getting started guide
• API Reference - Complete godoc
• Examples - Working code samples
• CHANGELOG.md - Detailed changes
• ROADMAP.md - Future plans

🔧 What's Next (v0.2.0)

• HTTP webhook delivery provider
• gRPC delivery provider
• Message encryption
• Rate limiting
• Prometheus metrics

See ROADMAP.md for details.

🙏 Credits

Built with:

• Relica v0.7.0 - Type-safe query builder
• Go 1.25+ standard library

Full Changelog: https://github.com/coregx/pubsub/commits/v0.1.0