@thinwrap/notifications

30-second install

npm install @thinwrap/notifications

2-minute end-to-end example

Send an email through any supported provider with one normalized call. The example below uses SendGrid; switching providers means changing the provider ID and config — input and output shape stay identical.

import { Email } from '@thinwrap/notifications';

const email = new Email('sendgrid', {
  apiKey: process.env.SENDGRID_API_KEY!,
  from: 'you@example.com',
});

await email.send({
  to: 'user@example.com',
  subject: 'Hello',
  text: 'Hello world',
});

Same code works for all supported providers — change the provider ID and pass the matching config. The supported-providers list below is auto-sourced from the catalog and stays in lockstep with what the package actually exports.

See the universal email snippet for the full copy-paste pattern.

Supported providers

Migration paths

From @novu/providers

Novu compatibility is design inspiration credit, not a critical path — the import change is usually one line:

- import { SendgridEmailProvider } from '@novu/providers';
+ import { Email } from '@thinwrap/notifications';
- const provider = new SendgridEmailProvider({ apiKey });
+ const provider = new Email('sendgrid', { apiKey, from });

From @sendgrid/mail (or any vendor SDK)

Drop the vendor SDK; the wrapper produces the same outbound HTTP call with no transitive dependencies. Vendor-specific fields are accessible through the typed _passthrough escape valve.

- import sgMail from '@sendgrid/mail';
- sgMail.setApiKey(process.env.SENDGRID_API_KEY);
- await sgMail.send({ to, from, subject, text });
+ import { Email } from '@thinwrap/notifications';
+ const email = new Email('sendgrid', { apiKey: process.env.SENDGRID_API_KEY!, from });
+ await email.send({ to, subject, text });

From hand-rolled fetch

Keep your retry/observability layer; replace the per-vendor request shape with a single uniform call. The wrapper performs no automatic retry — compose your own from ConnectorError.providerCodeand the raw Retry-After header on e.cause.

Read more

Repo README