@multisystemsuite/timezone-engine-notification-engine

Timezone-safe notification scheduler for global alerts, reminders, and queue-based delivery.

What it is used for

• Schedule notifications in the user's local timezone
• Global reminder systems (SaaS, HRMS, healthcare)
• Queue workers that deliver at correct local wall-clock time
• Cron-style relative scheduling with IANA timezone support

Install

npm install @multisystemsuite/timezone-engine-notification-engine

Usage

import { notificationScheduler } from "@multisystemsuite/timezone-engine-notification-engine";

const scheduler = notificationScheduler();

// Schedule at a specific local time (stored as UTC internally)
scheduler.schedule({
  id: "reminder-1",
  deliverAt: new Date("2026-05-27T09:00:00"),
  timezone: "Asia/Kolkata",
  channel: "email",
});

// Schedule relative to now in a timezone
scheduler.scheduleRelative({
  id: "reminder-2",
  minutesFromNow: 30,
  timezone: "America/New_York",
});

const due = scheduler.due(new Date());
const pending = scheduler.pending(new Date());

Node.js worker pattern

setInterval(() => {
  for (const item of scheduler.due()) {
    sendNotification(item);
  }
}, 60_000);

Key exports

| Export | Purpose | | ------------------------- | -------------------------------- | | notificationScheduler() | Create scheduler instance | | .schedule() | Schedule at local datetime → UTC | | .scheduleRelative() | Schedule N minutes from now | | .due() / .pending() | Query queue by time |

Related packages

• @multisystemsuite/timezone-engine-node — server-side cron and middleware
• @multisystemsuite/timezone-engine-business-hours — only notify during open hours

Keywords

timezone, notifications, scheduling, cron, queue, enterprise

License

MIT