Notifications

enum NotificationType {
  RENT_DUE = "rent_due", // Rent payment reminder
  RENT_REMINDER = "rent_reminder", // Follow-up reminder
  PAYMENT_RECEIVED = "payment_received", // Payment confirmation
  AGREEMENT_EXPIRING = "agreement_expiring", // Agreement renewal notice
  MAINTENANCE_REQUEST = "maintenance_request", // New maintenance ticket
  MAINTENANCE_UPDATE = "maintenance_update", // Status update
  GENERAL = "general", // Other notifications
}

interface Notification {
  id: number;
  user_id: number; // Recipient
  type: NotificationType; // Category
  channel: NotificationChannel; // Delivery channel
 
  title: string; // Short title
  message: string; // Full message content
 
  metadata?: {
    agreement_id?: number;
    payment_id?: number;
    property_id?: number;
    maintenance_request_id?: number;
    action_url?: string; // Deep link
  };
 
  status: NotificationStatus; // pending | sent | delivered | failed | read
 
  sent_at?: Date; // When sent
  delivered_at?: Date; // When delivered
  read_at?: Date; // When read/opened
  error_message?: string; // If failed
}

📋 *Rent Reminder*
Hi {tenant_name}! Your rent of ₹{amount} for {property_name} is due on {due_date}.
Pay now: {payment_link}

✅ *Payment Received*
Payment of ₹{amount} received for {property_name}.
Transaction ID: {txn_id}
Thank you!

📄 *Agreement Ready*
Your rental agreement for {property_name} is ready to sign.
Review & Sign: {signing_link}

[LandlordX] Your rent of Rs.{amount} is due on {date}. Pay at {short_link}

interface NotificationPreferences {
  user_id: number;
 
  // Channel preferences
  whatsapp_enabled: boolean; // Default: true
  email_enabled: boolean; // Default: true
  sms_enabled: boolean; // Default: true
  in_app_enabled: boolean; // Default: true
 
  // Type preferences
  rent_reminders: boolean; // Default: true
  payment_confirmations: boolean; // Default: true
  maintenance_updates: boolean; // Default: true
  promotional: boolean; // Default: false
 
  // Timing preferences
  reminder_days_before: number; // Default: 5
  quiet_hours_start?: string; // e.g., "22:00"
  quiet_hours_end?: string; // e.g., "08:00"
}