V0.3.3 - The fancy frog release 🐸

[scopsy]

What's new?

• Email attachments support
• New direct messaging interface
• New NestJS module for Notifire by @devblin in Added nestjs module for notifire #106
• New readme file for our npm package by @SachinHatikankar100 in Added Readme file for npm #121
• Code generator for SMS providers by @galezra in feat: add support for optional types in Hygen provider script generator (SMS/EMAIL) #131
• Docs for generating a new provider by @cloudguruab in 67 docs for template provider #132

Email attachments support

This incredible community effort started from @davidsoderberg who took on him to finalize the interface for the $attachments and later on all the community took the effort to update all of our 9 email providers.

So how this works?
The $attachment interface receives an array of attachment objects. Each attachment contains a file buffer, the mime type and the attachment name to be used.

const fileBuffer = fs.readFileSync('event.ics');
await notifire.trigger('test', {
    $user_id: '1234',
    $email: '[email protected]',
    $attachments: [{
        file: fileBuffer,
        mime: 'text/plain',
        name: 'event.ics'
    }]
});

NestJS module

Created by @devblin you can now use notifire in your nestjs application easily by installing the @notifire/nest package.

Initializing module with templates and providers:

import { NotifireModule } from "@notifire/nest";

@Module({
  imports: [
    NotifireModule.forRoot({
      providers: [
        new SendgridEmailProvider({
          apiKey: process.env.SENDGRID_API_KEY,
          from: '[email protected]',
        }),
      ],
      templates: [
        {
          id: 'password-reset',
          messages: [
            {
              subject: 'Your password reset request',
              channel: ChannelTypeEnum.EMAIL,
              template: `
                      Hi {{firstName}}!
                      To reset your password click <a href="{{resetLink}}">here.</a>
               `,
            },
          ],
        },
      ],
    }),
  ],
})

Using notifire's singleton service in other services and modules:

import { Injectable } from '@nestjs/common';
import { NotifireService } from '@notifire/nest';

@Injectable()
export class UserService {
  constructor(private readonly notifire: NotifireService) {}

  async triggerEvent() {
    await this.notifire.trigger('password-reset', {
      $email: '[email protected]',
      $user_id: 'id'
    });
  }
}

---

Mail attachments contributors

• Add Attachments Interface by @davidsoderberg in Add Attachments Interface #93
• Added attachment support for mailjet provider by @devblin in feat: added attachment support for mailjet provider #116
• Nodemailer attachments support by @galezra in Nodemailer attachments support #120
• Postmark attachments support by @galezra in Postmark attachments support #119
• Sendgrid attachments support by @galezra in Sendgrid attachments support #117
• Added attachment support to mailgun by @l0ne in feat: add attachment support to MailgunEmailProvider #122
• Mandrill attachment by @diganta413 in Mandrill attachment #124
• Added SES attachments support by @galezra in Added SES attachments support #129
• Addd emailjs attachment support by @peoray in feat: add emailjs attachment support #130

New providers

• Added Sendinblue as a provider by @galezra in Added Sendinblue as a provider #111
• Added Nexmo/Vonage SMS by @ranrib in feat(nexmo.js): add support for Nexmo/Vonage SMS #136
• Added sms77 as an SMS provider @matthiez in Added sms77 as a sms provider & fix docs typo #134

Other changes

• Fixed typo at the quick-start docs page by @chasmfiend in Update quick-start.md #110

New Contributors in this version

• @chasmfiend made their first contribution in Update quick-start.md #110
• @devblin made their first contribution in Added nestjs module for notifire #106
• @galezra made their first contribution in Added Sendinblue as a provider #111
• @l0ne made their first contribution in feat: add attachment support to MailgunEmailProvider #122
• @cloudguruab made their first contribution in 67 docs for template provider #132
• @matthiez made their first contribution in Added sms77 as a sms provider & fix docs typo #134
• @peoray made their first contribution in feat: add emailjs attachment support #130
• @ranrib made their first contribution in feat(nexmo.js): add support for Nexmo/Vonage SMS #136

---

This discussion was created from the release V0.3.3 - The fancy frog release 🐸.