Done: Your straightforward message queue solution, open-source and self-hosted on Deno Deploy.
Key features:
- Open Source
- Self-Hosting via Deno Deploy
- Delayed messages without limits
- Retry handling
- Failure-Callbacks
- Dead Letter Queues
- Introduction
- Features
- What about Deno's native queue?
- Setup on Deno Deploy
- API Endpoints
- Credits
- Who is DNL
- Feedback
- License
Done isn't just another message queue service; it's a celebration of simplicity and open-source ingenuity. It's perfect for those who like their tech like they like their coffee: strong, straightforward, and capable of keeping you up at night (in a good way, we promise!).
Embrace the open-source simplicity with Done. Queue up, have fun, and get it done!
- 📡 RESTful API, Joyful You: Manage your queues with a RESTful API that's as simple as a light switch – on, off, and awesome.
- 🧰 No-Frills, All Thrills: We’ve cut the fluff, leaving you with a lean, mean, message-queuing machine.
- 🦕 Deno-Deploy-Powered: With its foundation in Deno, Done is as awesome as a dinosaur rocking shades. That's right, we're keeping it that cool ;)
await fetch('https://your-done-host.com/http://your-callback-url.com/some-path/123456789', {
method: 'POST',
headers: {
'Authorization': 'Bearer ******',
'Done-Not-Before': 1700902800, // 2023-11-25T09:00:00Z
'Content-type': 'application/json'
},
body: JSON.stringify({name: 'Foo Bar', email: 'foo@bar.com'})
});Expected response You will receive a message-id as well as the set date of callback.
201 Created
{
"id": "msg_ytc6tbklsjmurie7ppxtqfnreh",
"publishAt": "2023-11-25T09:00:00Z"
}Expected callback at 2023-11-25T09:00:00Z
Your actual callback message.
POST http://your-callback-url.com/some-path/123456789
done-message-id: msg_ytc6tbklsjmurie7ppxtqfnreh
done-status: deliver
done-retried: 0
user-agent: Done Light
{
"name": "Foo Bar",
"email": "foo@bar.com"
}You sent a request at 2023-11-25T09:00:00Z.
await fetch('https://your-done-host.com/http://your-callback-url.com/some-path/123456789', {
method: 'POST',
headers: {
'Authorization': 'Bearer ******',
'Done-Delay': '5m', // in 5 minutes
'Content-type': 'application/json'
},
body: JSON.stringify({name: 'Foo Bar', email: 'foo@bar.com'})
});Expected response You will receive a message-id as well as the calculated date of callback.
201 Created
{
"id": "msg_ytc6tbklsjmurie7ppxtqfnreh",
"publishAt": "2023-11-25T09:05:00Z"
}Expected callback at 2023-11-25T09:05:00Z
Your actual callback message.
POST http://your-callback-url.com/some-path/123456789
done-message-id: msg_ytc6tbklsjmurie7ppxtqfnreh
done-status: deliver
done-retried: 0
user-agent: Done Light
{
"name": "Foo Bar",
"email": "foo@bar.com"
}Delay format
The format for this type of delay is <number><unit>. Valid units are:
- seconds (s)
- minutes (m)
- hours (h)
- days (d)
Some delay examples:
10s(enough to catch your breath),5m(perfect for a quick coffee),20m(ideal for a power nap),2h(great for binge-watching your favorite show),14d(for those who plan way ahead).
No Delay header? No delay! Done will callback immediately as it receives the message. You sent a request at 2023-11-25T09:00:00Z.
await fetch('https://your-done-host.com/http://your-callback-url.com/some-path/123456789', {
method: 'POST',
headers: {'Authorization': 'Bearer ******'}
});Expected response You will receive a message-id as well as the calculated date of callback.
201 Created
{
"id": "msg_ytc6tbklsjmurie7ppxtqfnreh",
"publishAt": "2023-11-25T09:00:00Z"
}Expected callback immediate after 2023-11-25T09:00:00Z
Your actual callback message.
POST http://your-callback-url.com/some-path/123456789
done-message-id: msg_ytc6tbklsjmurie7ppxtqfnreh
done-status: deliver
done-retried: 0
user-agent: Done LightYou can attach callback headers which Done will integrate when calling you back. Just flag these with Done-.
// callback headers
await fetch('https://your-done-host.com/http://your-callback-url.com/some-path/123456789', {
method: 'POST',
headers: {
'Authorization': 'Bearer ******',
'Content-type': 'application/json',
'Done-Authorization': 'Bearer *********'
'Done-Foo': 'bar',
},
body: JSON.stringify({name: 'Foo Bar', email: 'foo@bar.com'})
});Expected callback message
POST http://your-callback-url.com/some-path/123456789
Authorization: Bearer *********
foo: bar
done-message-id: msg_ytc6tbklsjmurie7ppxtqfnreh
done-status: deliver
done-retried: 0
user-agent: Done Light
{
"name": "Foo Bar",
"email": "foo@bar.com"
}By default Done will try 3 times to call the specified message url. If that does not work and the message included a Done-Failure-Callback-header it will try to send the message to that given URL before moving it to the Dead Letter Queue.
await fetch('https://your-done-host.com/http://your-callback-url.com/some-path/123456789', {
method: 'POST',
headers: {
'Authorization': 'Bearer ******',
'Content-type': 'application/json',
'Done-Failure-Callback': 'http://your-callback-url.com/failure/123456789',
},
body: JSON.stringify({name: 'Foo Bar', email: 'foo@bar.com'})
});Deno's native queue is super handy for instant action in your Deno Deploy projects, like firing emails or sending requests on the fly. But when it comes to tracking those enqueued little critters, it's like herding cats. You'd have to play double duty, shuffling each message into a KV store and keeping tabs on their every move. Thinking of delaying a message? You've got a week, max. That's it.
Enter Done - your new best bud in the messaging realm. This isn't just another tool; it's a developer's dream sidekick *cough*. Picture it stepping out of Deno's shadow, ready to serve any app, anywhere. Done keeps an eagle eye on all messages and their states, making callbacks with custom headers to any external service like it's no big deal.
And when it comes to delays, Done laughs in the face of 7-day limits. Whether you're plotting to send a "see you in two months" email or scheduling an invoice way down the line, Done's your time-traveling ally. No delay cap, just boundless possibilities.
So, here's the deal: Done is unapologetically developer-friendly. No complicated setups, no riddles to solve. It's as transparent and straightforward as it gets. Just the way you like it.
P.S. Big shoutout to the Deno team! Without Deno Queues and Deno KV, this tool would've been a no-go. Huge thanks for their fantastic work – couldn't have done it without them! 🙌🦕
Setup a project over at Deno Deploy. Either you deploy Done yourself or you connect it with your Github repository to deploy it automatically.
When this is "done", all you need is an environment variable AUTH_TOKEN which you can create in your project settings. With that Done can validate your authorization bearer token against that env variable.
With that, you've got everything in place like a squirrel with a perfectly organized nut collection before winter! 🐿️
There are a couple of API endpoints defined as a bruno collection. The collection can be found here.
There is also another helping hand in the game: gotrequests.com. Just like our mentioned diligent squirrel preparing for winter by collecting nuts, it helps you collect incoming requests with all their attached data. Before you connect your real-world projects, use gotrequests.com to simulate how a callback from Done would look. It's like making sure every nut is in place before your project launches!
Done is inspired by Upstash's Qstash message queue. It's great but I thought, 'Nice, but how about a bit more love?' You know, like a unicorn in a world of horses. So, I added open source, some sprinkle of developer-friendly magic as well as home-brewability.
While Qstash is the reliable sedan, Done is the fun convertible with the top down, zooming past limitations and honking with joy at every turn!
DNL, short for 'Dots and Lines', is a venture created by Tino Ehrich, a seasoned digital carpenter with over 20 years of experience in crafting projects and assisting businesses. DNL will specifically focus on developing projects that aim to simplify the access of information, and to develop these in the open.
I would love to get your feedback. Drop by Done's Discord Channel. Hope to talk soon!
Done is free software, and is released under the terms of the Mozilla Public License version 2.0. See LICENSE.