@voyantjs/notifications 0.6.8 → 0.6.9

package/dist/service-shared.js

@@ -1,5 +1,6 @@
-import { bookingParticipants } from "@voyantjs/bookings/schema";
+import { bookingItems, bookingTravelers } from "@voyantjs/bookings/schema";
 import { and, desc, eq } from "drizzle-orm";
+import { renderLiquidTemplate } from "./liquid.js";
 export class NotificationError extends Error {
     constructor(message) {
         super(message);
@@ -48,35 +49,265 @@ export function summarizeNotificationAttachments(attachments) {
         contentId: attachment.contentId ?? null,
     }));
 }
-function resolveMustachePath(path, scope) {
-    const parts = path.match(/[^.[\]]+/g) ?? [];
-    let current = scope;
-    for (const part of parts) {
-        if (current == null || typeof current !== "object")
-            return undefined;
-        current = current[part];
-    }
-    return current;
-}
-function stringifyRenderedValue(value) {
-    if (value == null)
-        return "";
-    if (typeof value === "string")
-        return value;
-    if (typeof value === "number" || typeof value === "boolean")
-        return String(value);
-    return JSON.stringify(value);
-}
 export function renderNotificationTemplate(template, data) {
-    if (!template)
-        return null;
-    return template.replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_match, path) => {
-        return stringifyRenderedValue(resolveMustachePath(path.trim(), data));
-    });
+    return renderLiquidTemplate(template, normalizeNotificationTemplateData(data));
+}
+export function previewNotificationTemplate(input) {
+    const data = normalizeNotificationTemplateData(input.data ?? {});
+    return {
+        channel: input.channel,
+        provider: input.provider ?? null,
+        fromAddress: input.fromAddress ?? null,
+        subject: renderNotificationTemplate(input.subjectTemplate, data),
+        html: renderNotificationTemplate(input.htmlTemplate, data),
+        text: renderNotificationTemplate(input.textTemplate, data),
+    };
 }
 export function toTimestamp(value) {
     return value ? new Date(value) : null;
 }
+function centsToAmount(value) {
+    if (typeof value !== "number")
+        return null;
+    return value / 100;
+}
+function buildFullName(firstName, lastName) {
+    return [firstName, lastName]
+        .map((part) => (typeof part === "string" ? part.trim() : ""))
+        .filter(Boolean)
+        .join(" ");
+}
+function parseDate(value) {
+    if (!value)
+        return null;
+    const date = value instanceof Date ? value : new Date(String(value));
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+function dateDiffInDays(from, to) {
+    const diff = to.getTime() - from.getTime();
+    return Math.ceil(diff / (24 * 60 * 60 * 1000));
+}
+function enrichTraveler(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const traveler = value;
+    const fullName = buildFullName(traveler.firstName, traveler.lastName);
+    return {
+        ...traveler,
+        fullName: fullName || null,
+        name: fullName || null,
+        role: traveler.participantType ?? null,
+    };
+}
+function enrichBooking(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const booking = value;
+    const bookingNumber = typeof booking.bookingNumber === "string"
+        ? booking.bookingNumber
+        : typeof booking.reference === "string"
+            ? booking.reference
+            : typeof booking.code === "string"
+                ? booking.code
+                : typeof booking.number === "string"
+                    ? booking.number
+                    : null;
+    const currency = typeof booking.currency === "string"
+        ? booking.currency
+        : typeof booking.sellCurrency === "string"
+            ? booking.sellCurrency
+            : null;
+    const totalAmount = centsToAmount(booking.totalAmountCents) ??
+        centsToAmount(booking.sellAmountCents) ??
+        (typeof booking.totalAmount === "number" ? booking.totalAmount : null);
+    const startDate = parseDate(booking.startDate);
+    const endDate = parseDate(booking.endDate);
+    const dateRange = startDate && endDate
+        ? `${startDate.toISOString().slice(0, 10)} - ${endDate.toISOString().slice(0, 10)}`
+        : null;
+    return {
+        ...booking,
+        code: bookingNumber,
+        number: bookingNumber,
+        reference: bookingNumber,
+        currency,
+        total: totalAmount,
+        totalAmount,
+        totalPrice: totalAmount,
+        dateRange,
+    };
+}
+function enrichInvoice(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const invoice = value;
+    return {
+        ...invoice,
+        number: typeof invoice.number === "string"
+            ? invoice.number
+            : typeof invoice.invoiceNumber === "string"
+                ? invoice.invoiceNumber
+                : null,
+        type: typeof invoice.type === "string"
+            ? invoice.type
+            : typeof invoice.invoiceType === "string"
+                ? invoice.invoiceType
+                : null,
+        subtotalAmount: centsToAmount(invoice.subtotalCents) ??
+            (typeof invoice.subtotalAmount === "number" ? invoice.subtotalAmount : null),
+        taxAmount: centsToAmount(invoice.taxCents) ??
+            (typeof invoice.taxAmount === "number" ? invoice.taxAmount : null),
+        totalAmount: centsToAmount(invoice.totalCents) ??
+            (typeof invoice.totalAmount === "number" ? invoice.totalAmount : null),
+        paidAmount: centsToAmount(invoice.paidCents) ??
+            (typeof invoice.paidAmount === "number" ? invoice.paidAmount : null),
+        balanceDueAmount: centsToAmount(invoice.balanceDueCents) ??
+            (typeof invoice.balanceDueAmount === "number" ? invoice.balanceDueAmount : null),
+    };
+}
+function enrichPaymentSession(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const session = value;
+    return {
+        ...session,
+        amount: centsToAmount(session.amountCents) ??
+            (typeof session.amount === "number" ? session.amount : null),
+        paymentUrl: typeof session.paymentUrl === "string"
+            ? session.paymentUrl
+            : typeof session.redirectUrl === "string"
+                ? session.redirectUrl
+                : null,
+        reference: typeof session.reference === "string"
+            ? session.reference
+            : typeof session.externalReference === "string"
+                ? session.externalReference
+                : null,
+        method: typeof session.method === "string"
+            ? session.method
+            : typeof session.paymentMethod === "string"
+                ? session.paymentMethod
+                : null,
+    };
+}
+function enrichPaymentSchedule(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const schedule = value;
+    const dueDate = parseDate(schedule.dueDate);
+    const today = new Date();
+    return {
+        ...schedule,
+        amountDue: centsToAmount(schedule.amountCents) ??
+            (typeof schedule.amountDue === "number" ? schedule.amountDue : null),
+        type: typeof schedule.type === "string"
+            ? schedule.type
+            : typeof schedule.scheduleType === "string"
+                ? schedule.scheduleType
+                : null,
+        daysLeft: dueDate ? dateDiffInDays(today, dueDate) : null,
+    };
+}
+function enrichDocument(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    return value;
+}
+function enrichBookingItem(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const item = value;
+    return {
+        ...item,
+        description: typeof item.description === "string" && item.description.trim().length > 0
+            ? item.description
+            : typeof item.title === "string"
+                ? item.title
+                : null,
+        currency: typeof item.currency === "string"
+            ? item.currency
+            : typeof item.sellCurrency === "string"
+                ? item.sellCurrency
+                : null,
+        unitPrice: centsToAmount(item.unitSellAmountCents) ??
+            (typeof item.unitPrice === "number" ? item.unitPrice : null),
+        total: centsToAmount(item.totalSellAmountCents) ??
+            (typeof item.total === "number" ? item.total : null),
+    };
+}
+export function normalizeNotificationTemplateData(data) {
+    const traveler = enrichTraveler(data.traveler);
+    const travelers = Array.isArray(data.travelers)
+        ? data.travelers.map((entry) => enrichTraveler(entry))
+        : traveler
+            ? [traveler]
+            : [];
+    const booking = enrichBooking(data.booking);
+    const invoice = enrichInvoice(data.invoice);
+    const paymentSession = enrichPaymentSession(data.paymentSession);
+    const paymentSchedule = enrichPaymentSchedule(data.paymentSchedule);
+    const documents = Array.isArray(data.documents)
+        ? data.documents.map((document) => enrichDocument(document))
+        : [];
+    const items = Array.isArray(data.items) ? data.items.map((item) => enrichBookingItem(item)) : [];
+    const payment = paymentSchedule && typeof paymentSchedule === "object"
+        ? {
+            amount: paymentSchedule.amountDue ?? null,
+            currency: paymentSchedule.currency ?? null,
+            dueDate: paymentSchedule.dueDate ?? null,
+            daysLeft: paymentSchedule.daysLeft ?? null,
+            reference: booking?.reference ??
+                invoice?.number ??
+                null,
+            method: paymentSession?.method ??
+                paymentSession?.provider ??
+                null,
+            link: paymentSession?.paymentUrl ?? null,
+            payMode: paymentSchedule.type ?? null,
+            paidAmount: invoice?.paidAmount ?? null,
+            balanceDue: invoice?.balanceDueAmount ?? null,
+            isPaidInFull: invoice?.balanceDueAmount === 0,
+        }
+        : paymentSession && typeof paymentSession === "object"
+            ? {
+                amount: paymentSession.amount ?? null,
+                currency: paymentSession.currency ?? null,
+                dueDate: null,
+                daysLeft: null,
+                reference: paymentSession.reference ?? null,
+                method: paymentSession.method ?? null,
+                link: paymentSession.paymentUrl ?? null,
+                payMode: null,
+                paidAmount: null,
+                balanceDue: invoice?.balanceDueAmount ?? null,
+                isPaidInFull: invoice?.balanceDueAmount ===
+                    0,
+            }
+            : null;
+    const product = items.length > 0 && items[0] && typeof items[0] === "object"
+        ? {
+            title: items[0].title ??
+                items[0].description ??
+                null,
+        }
+        : null;
+    return {
+        ...data,
+        traveler,
+        travelers,
+        billingPerson: traveler,
+        billing: traveler,
+        booking,
+        invoice,
+        paymentSession,
+        paymentSchedule,
+        payment,
+        documents,
+        documentsCount: documents.length,
+        items,
+        product,
+    };
+}
 export function startOfUtcDay(value) {
     return new Date(Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate()));
 }
@@ -89,37 +320,66 @@ export function toDateString(value) {
 export function buildReminderDedupeKey(ruleId, targetId, runDate) {
     return `${ruleId}:${targetId}:${runDate}`;
 }
-export function resolveReminderRecipient(participants) {
-    const withEmail = participants.filter((participant) => participant.email);
+export function resolveReminderRecipient(booking, participants) {
+    if (booking?.contactEmail) {
+        return {
+            email: booking.contactEmail,
+            firstName: booking.contactFirstName ?? "",
+            lastName: booking.contactLastName ?? "",
+            participantType: "booking_contact",
+            isPrimary: true,
+        };
+    }
+    const withEmail = participants.filter((traveler) => traveler.email);
     if (withEmail.length === 0) {
         return null;
     }
-    const primary = withEmail.find((participant) => participant.isPrimary);
+    const nonStaffWithEmail = withEmail.filter((traveler) => traveler.participantType !== "staff");
+    const primary = nonStaffWithEmail.find((traveler) => traveler.isPrimary) ??
+        withEmail.find((traveler) => traveler.isPrimary);
     if (primary) {
         return primary;
     }
-    const preferredTypes = ["booker", "contact", "traveler", "occupant"];
+    const preferredTypes = ["traveler", "occupant", "other"];
     for (const type of preferredTypes) {
-        const match = withEmail.find((participant) => participant.participantType === type);
+        const match = nonStaffWithEmail.find((traveler) => traveler.participantType === type);
         if (match) {
             return match;
         }
     }
-    return withEmail[0] ?? null;
+    return nonStaffWithEmail[0] ?? withEmail[0] ?? null;
 }
 export async function listBookingNotificationParticipants(db, bookingId) {
     return db
         .select({
-        id: bookingParticipants.id,
-        firstName: bookingParticipants.firstName,
-        lastName: bookingParticipants.lastName,
-        email: bookingParticipants.email,
-        participantType: bookingParticipants.participantType,
-        isPrimary: bookingParticipants.isPrimary,
+        id: bookingTravelers.id,
+        firstName: bookingTravelers.firstName,
+        lastName: bookingTravelers.lastName,
+        email: bookingTravelers.email,
+        participantType: bookingTravelers.participantType,
+        isPrimary: bookingTravelers.isPrimary,
+    })
+        .from(bookingTravelers)
+        .where(eq(bookingTravelers.bookingId, bookingId))
+        .orderBy(desc(bookingTravelers.isPrimary), bookingTravelers.createdAt);
+}
+export async function listBookingNotificationItems(db, bookingId) {
+    const rows = await db
+        .select({
+        id: bookingItems.id,
+        title: bookingItems.title,
+        description: bookingItems.description,
+        quantity: bookingItems.quantity,
+        itemType: bookingItems.itemType,
+        serviceDate: bookingItems.serviceDate,
+        sellCurrency: bookingItems.sellCurrency,
+        unitSellAmountCents: bookingItems.unitSellAmountCents,
+        totalSellAmountCents: bookingItems.totalSellAmountCents,
     })
-        .from(bookingParticipants)
-        .where(eq(bookingParticipants.bookingId, bookingId))
-        .orderBy(desc(bookingParticipants.isPrimary), bookingParticipants.createdAt);
+        .from(bookingItems)
+        .where(eq(bookingItems.bookingId, bookingId))
+        .orderBy(bookingItems.createdAt);
+    return rows.map((row) => enrichBookingItem(row));
 }
 export async function paginate(rowsPromise, totalPromise, limit, offset) {
     const [data, totalRows] = await Promise.all([rowsPromise, totalPromise]);

package/dist/service.d.ts

@@ -1,9 +1,10 @@
 export { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
 export type { NotificationService } from "./service-shared.js";
-export { createNotificationService, NotificationError, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
+export { createNotificationService, NotificationError, previewNotificationTemplate, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
 import { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
 import { getDeliveryById, listDeliveries, sendInvoiceNotification, sendNotification, sendPaymentSessionNotification } from "./service-deliveries.js";
 import { runDueReminders } from "./service-reminders.js";
+import { previewNotificationTemplate } from "./service-shared.js";
 import { createReminderRule, createTemplate, getReminderRuleById, getReminderRunById, getTemplateById, getTemplateBySlug, listReminderRules, listReminderRuns, listTemplates, updateReminderRule, updateTemplate } from "./service-templates.js";
 export declare const notificationsService: {
     listTemplates: typeof listTemplates;
@@ -11,6 +12,7 @@ export declare const notificationsService: {
     getTemplateBySlug: typeof getTemplateBySlug;
     createTemplate: typeof createTemplate;
     updateTemplate: typeof updateTemplate;
+    previewNotificationTemplate: typeof previewNotificationTemplate;
     listDeliveries: typeof listDeliveries;
     getDeliveryById: typeof getDeliveryById;
     sendNotification: typeof sendNotification;

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAA;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAEL,sCAAsC,EACvC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBhC,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAA;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAEL,sCAAsC,EACvC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBhC,CAAA"}

package/dist/service.js

@@ -1,8 +1,9 @@
 export { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
-export { createNotificationService, NotificationError, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
+export { createNotificationService, NotificationError, previewNotificationTemplate, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
 import { bookingDocumentNotificationsService, createDefaultBookingDocumentAttachment, } from "./service-booking-documents.js";
 import { getDeliveryById, listDeliveries, sendInvoiceNotification, sendNotification, sendPaymentSessionNotification, } from "./service-deliveries.js";
 import { runDueReminders } from "./service-reminders.js";
+import { previewNotificationTemplate } from "./service-shared.js";
 import { createReminderRule, createTemplate, getReminderRuleById, getReminderRunById, getTemplateById, getTemplateBySlug, listReminderRules, listReminderRuns, listTemplates, updateReminderRule, updateTemplate, } from "./service-templates.js";
 export const notificationsService = {
     listTemplates,
@@ -10,6 +11,7 @@ export const notificationsService = {
     getTemplateBySlug,
     createTemplate,
     updateTemplate,
+    previewNotificationTemplate,
     listDeliveries,
     getDeliveryById,
     sendNotification,

package/dist/template-authoring.d.ts

@@ -0,0 +1,23 @@
+export type NotificationTemplateVariableType = "string" | "number" | "currency" | "date" | "datetime" | "boolean" | "email" | "phone" | "url" | "array";
+export interface NotificationTemplateVariableDefinition {
+    key: string;
+    label: string;
+    example: string;
+    type: NotificationTemplateVariableType;
+    description?: string;
+}
+export interface NotificationTemplateVariableCategory {
+    id: string;
+    label: string;
+    description?: string;
+    variables: NotificationTemplateVariableDefinition[];
+}
+export interface NotificationLiquidSnippet {
+    id: string;
+    label: string;
+    description: string;
+    code: string;
+}
+export declare const notificationTemplateVariableCatalog: NotificationTemplateVariableCategory[];
+export declare const notificationLiquidSnippets: NotificationLiquidSnippet[];
+//# sourceMappingURL=template-authoring.d.ts.map

package/dist/template-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-authoring.d.ts","sourceRoot":"","sources":["../src/template-authoring.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gCAAgC,GACxC,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,GACN,UAAU,GACV,SAAS,GACT,OAAO,GACP,OAAO,GACP,KAAK,GACL,OAAO,CAAA;AAEX,MAAM,WAAW,sCAAsC;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gCAAgC,CAAA;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,oCAAoC;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,sCAAsC,EAAE,CAAA;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,mCAAmC,EAAE,oCAAoC,EA4UrF,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,yBAAyB,EAuDjE,CAAA"}