66a6659ccd
- Add SMS opt-in fields to clients schema (smsOptIn, smsConsentDate, smsOptOutDate, smsConsentText) - Add channel column to reminderLogs with per-channel idempotency - Create SMS service with Telnyx SDK integration and E.164 validation - Update reminders service to conditionally send SMS to opted-in clients - Add TCPA opt-out text to SMS reminders - Graceful degradation: catch SMS errors without blocking email - Fix: use clients.phone instead of non-existent clients.phoneE164 - Update clients route to expose SMS fields in API - Add telnyx dependency to API package - Create database migration 0028_sms_reminders Co-Authored-By: Paperclip <noreply@paperclip.ing>
205 lines
5.8 KiB
TypeScript
205 lines
5.8 KiB
TypeScript
import cron from "node-cron";
|
|
import { randomBytes } from "node:crypto";
|
|
import {
|
|
and,
|
|
eq,
|
|
getDb,
|
|
gte,
|
|
lt,
|
|
appointments,
|
|
clients,
|
|
pets,
|
|
services,
|
|
staff,
|
|
reminderLogs,
|
|
session,
|
|
} from "@groombook/db";
|
|
import {
|
|
buildReminderEmail,
|
|
sendEmail,
|
|
} from "./email.js";
|
|
import { smsSend } from "./sms.js";
|
|
|
|
const TCPA_OPT_OUT = "Reply STOP to opt out. Msg & data rates may apply.";
|
|
|
|
function getReminderWindows(): { label: string; hours: number }[] {
|
|
const early = Number(process.env.REMINDER_HOURS_EARLY ?? 24);
|
|
const late = Number(process.env.REMINDER_HOURS_LATE ?? 2);
|
|
return [
|
|
{ label: `${early}h`, hours: early },
|
|
{ label: `${late}h`, hours: late },
|
|
];
|
|
}
|
|
|
|
export async function runReminderCheck(): Promise<void> {
|
|
const db = getDb();
|
|
const now = new Date();
|
|
|
|
for (const window of getReminderWindows()) {
|
|
const windowStart = new Date(now.getTime() + (window.hours - 1) * 3600_000);
|
|
const windowEnd = new Date(now.getTime() + window.hours * 3600_000);
|
|
|
|
const upcoming = await db
|
|
.select({
|
|
id: appointments.id,
|
|
startTime: appointments.startTime,
|
|
clientId: appointments.clientId,
|
|
petId: appointments.petId,
|
|
serviceId: appointments.serviceId,
|
|
staffId: appointments.staffId,
|
|
status: appointments.status,
|
|
confirmationToken: appointments.confirmationToken,
|
|
})
|
|
.from(appointments)
|
|
.where(
|
|
and(
|
|
gte(appointments.startTime, windowStart),
|
|
lt(appointments.startTime, windowEnd),
|
|
eq(appointments.status, "scheduled")
|
|
)
|
|
);
|
|
|
|
for (const appt of upcoming) {
|
|
const [emailLog] = await db
|
|
.select({ id: reminderLogs.id })
|
|
.from(reminderLogs)
|
|
.where(
|
|
and(
|
|
eq(reminderLogs.appointmentId, appt.id),
|
|
eq(reminderLogs.reminderType, window.label),
|
|
eq(reminderLogs.channel, "email")
|
|
)
|
|
)
|
|
.limit(1);
|
|
|
|
const [smsLog] = await db
|
|
.select({ id: reminderLogs.id })
|
|
.from(reminderLogs)
|
|
.where(
|
|
and(
|
|
eq(reminderLogs.appointmentId, appt.id),
|
|
eq(reminderLogs.reminderType, window.label),
|
|
eq(reminderLogs.channel, "sms")
|
|
)
|
|
)
|
|
.limit(1);
|
|
|
|
const [client] = await db
|
|
.select({
|
|
name: clients.name,
|
|
email: clients.email,
|
|
emailOptOut: clients.emailOptOut,
|
|
smsOptIn: clients.smsOptIn,
|
|
phone: clients.phone,
|
|
})
|
|
.from(clients)
|
|
.where(eq(clients.id, appt.clientId))
|
|
.limit(1);
|
|
|
|
if (!client || !client.email || client.emailOptOut) continue;
|
|
|
|
const [pet] = await db
|
|
.select({ name: pets.name })
|
|
.from(pets)
|
|
.where(eq(pets.id, appt.petId))
|
|
.limit(1);
|
|
|
|
const [service] = await db
|
|
.select({ name: services.name })
|
|
.from(services)
|
|
.where(eq(services.id, appt.serviceId))
|
|
.limit(1);
|
|
|
|
let groomerName: string | null = null;
|
|
if (appt.staffId) {
|
|
const [groomer] = await db
|
|
.select({ name: staff.name })
|
|
.from(staff)
|
|
.where(eq(staff.id, appt.staffId))
|
|
.limit(1);
|
|
groomerName = groomer?.name ?? null;
|
|
}
|
|
|
|
if (!pet || !service) continue;
|
|
|
|
let confirmationToken = appt.confirmationToken;
|
|
if (!confirmationToken) {
|
|
confirmationToken = randomBytes(32).toString("hex");
|
|
await db
|
|
.update(appointments)
|
|
.set({ confirmationToken, updatedAt: new Date() })
|
|
.where(eq(appointments.id, appt.id));
|
|
}
|
|
|
|
if (!emailLog) {
|
|
const sent = await sendEmail(
|
|
buildReminderEmail(
|
|
client.email,
|
|
{
|
|
clientName: client.name,
|
|
petName: pet.name,
|
|
serviceName: service.name,
|
|
groomerName,
|
|
startTime: appt.startTime,
|
|
},
|
|
window.hours,
|
|
confirmationToken
|
|
)
|
|
);
|
|
|
|
if (sent) {
|
|
await db
|
|
.insert(reminderLogs)
|
|
.values({ appointmentId: appt.id, reminderType: window.label, channel: "email" })
|
|
.onConflictDoNothing();
|
|
}
|
|
}
|
|
|
|
if (!smsLog && client.smsOptIn && client.phone) {
|
|
const apiUrl = process.env.API_URL ?? "http://localhost:3000";
|
|
const confirmUrl = `${apiUrl}/api/book/confirm/${confirmationToken}`;
|
|
const cancelUrl = `${apiUrl}/api/book/cancel/${confirmationToken}`;
|
|
const when = window.hours >= 24 ? "tomorrow" : `in ${window.hours} hours`;
|
|
const smsBody = [
|
|
`Hi ${client.name}, just a reminder: ${pet.name}'s grooming appointment is ${when}.`,
|
|
`Service: ${service.name}${groomerName ? ` with ${groomerName}` : ""}`,
|
|
`Confirm: ${confirmUrl}`,
|
|
`Cancel: ${cancelUrl}`,
|
|
TCPA_OPT_OUT,
|
|
].join(". ");
|
|
try {
|
|
const smsOk = await smsSend(client.phone, smsBody);
|
|
if (smsOk) {
|
|
await db
|
|
.insert(reminderLogs)
|
|
.values({ appointmentId: appt.id, reminderType: window.label, channel: "sms" })
|
|
.onConflictDoNothing();
|
|
}
|
|
} catch (err) {
|
|
console.error("[reminders] SMS send failed:", err);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
export function startReminderScheduler(): void {
|
|
cron.schedule("* * * * *", () => {
|
|
runReminderCheck().catch((err) => {
|
|
console.error("[reminders] Error during reminder check:", err);
|
|
});
|
|
runSessionCleanup().catch((err) => {
|
|
console.error("[reminders] Error during session cleanup:", err);
|
|
});
|
|
});
|
|
console.log("[reminders] Reminder scheduler started");
|
|
}
|
|
|
|
export async function runSessionCleanup(): Promise<void> {
|
|
const db = getDb();
|
|
const now = new Date();
|
|
await db
|
|
.delete(session)
|
|
.where(lt(session.expiresAt, now));
|
|
}
|