adonis-server-sent-events
An addon/plugin package to provide server-sent events functionality for AdonisJS 5.0+

Getting Started
adonis install adonis-server-sent-events --save
Usage
Firstly, follow the instructions in instructions.md
file to setup the Provider and Middleware
See the instructions.md file for the complete installation steps and follow as stated.
Registering provider
Install provider:
node ace configure adonis-server-sent-events
Like any other provider, you need to register the provider inside .adonisrc.json
file.
{
"providers": [
...,
"adonis-sent-events/providers/ServerSentEventsProvider",
]
}
Registering middleware
Register the following middleware inside start/kernel.ts
file.
Server.middleware.register([
() => import('@ioc:Adonis/Middleware/EventSourceWatcher'),
])
Or alternatively setup the middleware as a named (use any name you feel like) middleware inside start/kernel.ts
file.
Server.middleware.registerNamed({
eventsource: () => import('@ioc:Adonis/Middleware/EventSourceWatcher'),
})
HINT: It would be much easier and better to make the EventSourceWatcher
middleware a global middleware
Setup serve-sent events route inside start/routes.ts
file.
import Route from '@ioc:Adonis/Core/Route'
Route.get('/stream', ({ source }) => {
source.send("Hello AdonisJS", '!This is a comment!');
}).middleware(['eventsource']);
Route.get('/stream', ({ source }) => {
source.send("Hello AdonisJS", '!This is a comment!');
})
Route.post('/send/email', 'NotificationsController.sendEmail')
Example(s)
Setup a controller to dispatch server-sent events to the browser using the source.send(data: Object, comment: String, event: String, retry: Number)
method like so:
import Mail from "@ioc:Adonis/Addons/Mail";
export default class NotificationsController {
async sendEmail ({ request, auth, source }){
let input = request.only([
'ticket_user_id'
]);
let { id, email, fullname } = await auth.getUser();
let error = false
try{
await Mail.send(
'emails.template',
{ fullname }, (message) => {
message.to(email)
message.from('crm.tickets@funsignals.co')
message.subject('Ticket Creation Job Status')
})
}catch(err){
error = true
}finally{
source.send({
ticket_reciever: id,
ticket_creator: input.ticket_user_id,
ticket_mail_status: `email sent ${error ? 'un' : ''}successfuly`
}, null, 'update', 4000)
}
}
}
send( data: object, comment: string, event: string, retry: number );
Connecting from the client-side
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<script src="https://cdn.polyfill.io/v2/polyfill.min.js?features=EventSource"></script>
</head>
<body>
<script id="server-side-events" type="text/javascript">
const stream = new EventSource("http://127.0.0.1:3333/stream");
stream.addEventListener('message', function(e){
console.log("Data: ", e.data);
}, false);
stream.addEventListener('open', function(e) {
console.log('connection open: true');
}, false);
stream.addEventListener('error', function(e) {
if (e.readyState == EventSource.CLOSED) {
console.log('connection closed: true');
}
}, false);
</script>
</body>
</html>
License
MIT
Running Tests
npm i
npm run lint
npm run test
Credits
Contributing
See the CONTRIBUTING.md file for info
Support
My Facebook Facebook Page.