Typed notifications for Node.js and Bun

import { createNotify, createClient } from '@betternotify/core';
import { emailChannel } from '@betternotify/email';
import { smtpTransport } from '@betternotify/smtp';

const notify = createNotify({
  channels: { email: emailChannel() }
});

const catalog = notify.catalog({
  welcome: notify.email()
    .input(z.object({ name: z.string() }))
    .subject(({ input }) => `Welcome, ${input.name}`)
    .template(WelcomeEmail)
});

const client = createClient({
  catalog,
  transportsByChannel: {
    email: smtpTransport({ host: '...' })
  }
});

// fully typed: TS knows welcome expects { name: string }
await client.welcome.send({
  to: 'ada@example.com',
  input: { name: 'Ada' }
});

import { createNotify, createClient } from '@betternotify/core';
import { whatsappChannel,
  whatsappMetaTransport } from '@betternotify/whatsapp';

const notify = createNotify({
  channels: { whatsapp: whatsappChannel() }
});

// interactive message with reply buttons
const catalog = notify.catalog({
  confirm: notify.whatsapp()
    .interactive()
    .input(z.object({
      orderId: z.string()
    }))
    .body(
      ({ input }) =>
        `Order ${input.orderId} confirmed`
    )
    .buttons([
      { id: 'track', title: 'Track' },
      { id: 'help', title: 'Help' }
    ])
});

const client = createClient({
  catalog,
  transportsByChannel: {
    whatsapp: whatsappMetaTransport({
      accessToken: '...',
      phoneNumberId: '...'
    })
  }
});

await client.confirm.send({
  to: '5511999887766',
  input: { orderId: '#4821' }
});

import { createNotify, createClient } from '@betternotify/core';
import { telegramChannel } from '@betternotify/telegram';
import { telegramTransport } from '@betternotify/telegram';

const notify = createNotify({
  channels: { telegram: telegramChannel() }
});

const catalog = notify.catalog({
  alert: notify.telegram()
    .input(z.object({ msg: z.string() }))
    .body(({ input }) => `Alert: ${input.msg}`)
    .parseMode('HTML')
});

const client = createClient({
  catalog,
  transportsByChannel: {
    telegram: telegramTransport({ token: '...' })
  }
});

await client.alert.send({
  to: '-1001234567890',
  input: { msg: 'Disk at 92%' }
});

import { multiTransport, createTransport } from '@betternotify/core/transports';
import { telegramTransport } from '@betternotify/telegram';
import { smtpTransport } from '@betternotify/smtp';

const smtp = smtpTransport({ host: '...' });

const smtpMirror = createTransport({
  name: 'smtp-mirror',
  send: async (rendered, ctx) => {
    await smtp.send({
      from: 'bot@example.com',
      to: [{ email: 'team@example.com' }],
      subject: `[${ctx.route}] Mirror`,
      html: `<p>${rendered.body}</p>`
    }, ctx);
    return { messageId: 0, chatId: rendered.to ?? 0 };
  }
});

const transport = multiTransport({
  strategy: 'mirrored',
  transports: [
    { transport: telegramTransport({ token: '...' }) },
    { transport: smtpMirror }
  ]
});