@boostengine/notifications 🔔

Unified multi-channel transactional messaging engine (WhatsApp, SMS, Email) for eCommerce. Connects Interakt, Wati, Gupshup, MSG91, and Resend with pre-built transactional templates for Order Confirmation, Live Tracking, Abandoned Cart Recovery, and COD OTP.

📸 WhatsApp Transactional Order Alert Preview

  WhatsApp Incoming Message (+91 98765 43210)
  ═════════════════════════════════════════════════════════════
  🛍️ BoostStore — Order Confirmed!
  
  Hi Rahul,
  Your order #BOOST-1001 (₹1,499) has been confirmed!
  
  📦 Items: Cyberpunk Heavy Hoodie (Size: L)
  🚚 Delivery Destination: Mumbai, Maharashtra
  
  [ Track Live Shipment 📍 ]     [ WhatsApp Support 💬 ]
  ═════════════════════════════════════════════════════════════

🌟 Key Highlights

• 💬 WhatsApp Business Automation: Native integrations for Interakt, WATI, and Gupshup with pre-approved Meta HSM template variables.
• 📱 Indian High-Delivery SMS: Direct fallback to MSG91 with DLT template ID verification for OTPs and delivery alerts.
• 📧 Transactional Email: Modern HTML transactional receipts using Resend or custom SMTP.
• 🛡️ Channel Fallback Engine: If WhatsApp message fails to deliver, automatically falls back to transactional SMS within seconds.

📦 Installation

# npm
npm install @boostengine/notifications

# pnpm
pnpm add @boostengine/notifications

# yarn
yarn add @boostengine/notifications

🚀 Quickstart Guide

import { createNotificationManager } from '@boostengine/notifications';

// 1. Initialize Notification Manager
export const notifications = createNotificationManager({
  defaultChannel: 'whatsapp',
  providers: {
    whatsapp: {
      provider: 'interakt',
      apiKey: process.env.INTERAKT_API_KEY!,
    },
    sms: {
      provider: 'msg91',
      authKey: process.env.MSG91_AUTH_KEY!,
      senderId: 'BOOSTS',
    },
    email: {
      provider: 'resend',
      apiKey: process.env.RESEND_API_KEY!,
      from: '[email protected]',
    },
  },
});

// 2. Send an Order Confirmation Alert
await notifications.sendOrderConfirmation({
  channel: 'whatsapp',
  recipient: '+919876543210',
  orderNumber: 'BOOST-1001',
  customerName: 'Rahul Sharma',
  totalAmount: 1499,
  trackingUrl: 'https://booststore.in/orders/track/BOOST-1001',
});

📄 License

MIT © Boost Engine