A generic, type-safe AWS SQS wrapper for Go that provides both production implementations for dispatching and consuming messages as well as mock implementations for testing.
TypeQueue is designed to let you:
- Dispatch messages to SQS queues with optional delay and custom trace ID support.
- Batch dispatch messages to SQS queues, increasing throughput and saving money.
- Consume messages from SQS in a type-safe manner with built-in support for JSON unmarshaling and message acknowledgement.
- Develop and Test seamlessly: swap in mock implementations for unit tests so you can develop with SQS without ever hitting the real service.
typequeue.Dispatcher{}: Sends messages to SQS queues with built-in JSON marshaling and trace ID propagation.typequeue.Consumer{}: Consumes SQS messages in a type-strict way, processing messages concurrently and acknowledging them after processing.typequeue.BatchDispatcher{}: Dispatches messages in Batches to increase throughput and save money (READ THE DOCS).typequeue_lambda.LambdaConsumer{}: Similar to theProductionConsumer, however it exposesBatchItemFailuresso that only failed events will be retried.MockDispatcher&MockConsumer: Test-friendly implementations that let you simulate SQS behavior locally. Write beautiful unit tests and develop in a live mock environment without incurring AWS costs or using actual AWS credentials.- Generic & Type-Safe: Leverages Go generics (T any) to ensure compile-time type safety for your message payloads.
Check out TypeSend—a robust, type-safe serverless email dispatching system built in Go. It offers scheduling, intuitive template editing (with a ready-to-use UI and endpoints), and extensive customization options.
Develop Confidently: With mock implementations that mimic production behavior, you can write comprehensive unit tests and even simulate live message passing—all without ever connecting to real AWS SQS. Beautiful Testing: Our design lets you focus on writing clean, expressive tests. Whether you’re verifying cross-talk between components or simulating delays and retries, TypeQueue makes it easy. Cost & Risk-Free: Avoid AWS costs and security risks during development and testing by using our fully functional mocks.
Check out the Wiki tab to view the Quick Start guide and detailed instructions.
Firstly, a Star is always appreciated!
PR's are also always welcome :) Please continue to make sure that unit tests pass, as well as integration tests via TestContainers.