@voyantjs/notifications 0.6.8 → 0.7.0

package/dist/validation.js

@@ -222,6 +222,27 @@ export const sendNotificationSchema = z
     .refine((value) => Boolean(value.templateId || value.templateSlug || value.subject || value.html || value.text), {
     message: "templateId, templateSlug, or direct content is required",
 });
+export const previewNotificationTemplateSchema = z
+    .object({
+    channel: notificationChannelSchema,
+    provider: z.string().optional().nullable(),
+    subjectTemplate: z.string().max(2000).optional().nullable(),
+    htmlTemplate: z.string().optional().nullable(),
+    textTemplate: z.string().optional().nullable(),
+    fromAddress: z.string().max(500).optional().nullable(),
+    data: z.record(z.string(), z.unknown()).optional().nullable(),
+})
+    .refine((value) => Boolean(value.subjectTemplate || value.htmlTemplate || value.textTemplate), {
+    message: "subjectTemplate, htmlTemplate, or textTemplate is required",
+});
+export const previewNotificationTemplateResultSchema = z.object({
+    channel: notificationChannelSchema,
+    provider: z.string().nullable(),
+    fromAddress: z.string().nullable(),
+    subject: z.string().nullable(),
+    html: z.string().nullable(),
+    text: z.string().nullable(),
+});
 export const bookingDocumentBundleItemSchema = z.object({
     key: z.string().min(1),
     source: notificationDocumentSourceSchema,
@@ -268,3 +289,39 @@ export const sendBookingDocumentsNotificationResultSchema = z.object({
     provider: z.string().optional().nullable(),
     status: notificationDeliveryStatusSchema,
 });
+/**
+ * Confirm-and-dispatch — single orchestrated request that lists the booking's
+ * document bundle and (optionally) sends it to the client in one round-trip.
+ *
+ * `sendNotification: false` turns the call into a preview: the bundle comes
+ * back but no delivery is attempted. Templates use the preview to render the
+ * "here's what's ready" checkbox list before the operator confirms.
+ */
+export const confirmAndDispatchBookingSchema = sendBookingDocumentsNotificationSchema.extend({
+    sendNotification: z.boolean().default(true),
+});
+export const confirmAndDispatchBookingResultSchema = z.object({
+    bookingId: z.string().min(1),
+    documents: z.array(bookingDocumentBundleItemSchema),
+    /**
+     * Non-null when `sendNotification` was true and a delivery actually went
+     * out. Null when either the operator asked for a preview only, or the send
+     * couldn't proceed (no recipient / no attachments / no matching documents).
+     */
+    notification: z
+        .object({
+        recipient: z.string().min(1),
+        deliveryId: z.string().min(1),
+        provider: z.string().optional().nullable(),
+        status: notificationDeliveryStatusSchema,
+    })
+        .nullable(),
+    /**
+     * When `sendNotification` was true but the dispatcher declined to send,
+     * this captures which guard tripped so the UI can explain it — e.g.
+     * "No recipient on file, add an email to the lead traveler and retry".
+     */
+    skipReason: z
+        .enum(["preview_only", "no_documents", "no_recipient", "no_attachments", "send_failed"])
+        .nullable(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/notifications",
-  "version": "0.6.8",
+  "version": "0.7.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -48,13 +48,14 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
+    "liquidjs": "^10.24.0",
     "zod": "^4.3.6",
-    "@voyantjs/bookings": "0.6.8",
-    "@voyantjs/core": "0.6.8",
-    "@voyantjs/db": "0.6.8",
-    "@voyantjs/finance": "0.6.8",
-    "@voyantjs/hono": "0.6.8",
-    "@voyantjs/legal": "0.6.8"
+    "@voyantjs/bookings": "0.7.0",
+    "@voyantjs/core": "0.7.0",
+    "@voyantjs/db": "0.7.0",
+    "@voyantjs/finance": "0.7.0",
+    "@voyantjs/hono": "0.7.0",
+    "@voyantjs/legal": "0.7.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",