@voyantjs/notifications 0.1.0

package/dist/tasks/index.d.ts

@@ -0,0 +1,2 @@
+export { sendDueNotificationReminders } from "./send-due-reminders.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/tasks/index.js

@@ -0,0 +1 @@
+export { sendDueNotificationReminders } from "./send-due-reminders.js";

package/dist/tasks/send-due-reminders.d.ts

@@ -0,0 +1,18 @@
+import type { NotificationProvider } from "../types.js";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+type NotificationTaskEnv = {
+    RESEND_API_KEY?: unknown;
+    EMAIL_FROM?: unknown;
+};
+export declare function sendDueNotificationReminders(db: PostgresJsDatabase, env: NotificationTaskEnv, input?: {
+    now?: string | null;
+}, options?: {
+    resolveProviders?: (env: NotificationTaskEnv) => ReadonlyArray<NotificationProvider>;
+}): Promise<{
+    processed: number;
+    sent: number;
+    skipped: number;
+    failed: number;
+}>;
+export {};
+//# sourceMappingURL=send-due-reminders.d.ts.map

package/dist/tasks/send-due-reminders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-due-reminders.d.ts","sourceRoot":"","sources":["../../src/tasks/send-due-reminders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAKjE,KAAK,mBAAmB,GAAG;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,mBAAmB,EACxB,KAAK,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,EACnC,OAAO,GAAE;IACP,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAA;CAChF;;;;;GAMP"}

package/dist/tasks/send-due-reminders.js

@@ -0,0 +1,6 @@
+import { createDefaultNotificationProviders } from "../provider-resolution.js";
+import { createNotificationService, notificationsService } from "../service.js";
+export async function sendDueNotificationReminders(db, env, input = {}, options = {}) {
+    const dispatcher = createNotificationService(options.resolveProviders?.(env) ?? createDefaultNotificationProviders(env));
+    return notificationsService.runDueReminders(db, dispatcher, input);
+}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Channel over which a notification is delivered. Built-in channels are
+ * `"email"` and `"sms"`, but providers may declare additional channel
+ * identifiers (e.g. `"slack"`, `"push"`).
+ */
+export type NotificationChannel = "email" | "sms" | (string & {});
+/**
+ * Payload describing a single notification to send. The `template` and
+ * `data` fields are interpreted by the handling provider.
+ */
+export interface NotificationPayload {
+    /** Recipient address (email address, phone number, channel id, ...). */
+    to: string;
+    /** Channel this notification targets. */
+    channel: NotificationChannel;
+    /** Optional provider hint when the caller wants a specific provider. */
+    provider?: string;
+    /** Template identifier — interpretation is provider-specific. */
+    template: string;
+    /** Data passed to the template for rendering. */
+    data?: unknown;
+    /** Optional sender override. Providers may have their own defaults. */
+    from?: string;
+    /** Optional subject line (email-only). */
+    subject?: string;
+    /** Optional pre-rendered HTML body. */
+    html?: string;
+    /** Optional pre-rendered text body. */
+    text?: string;
+}
+/**
+ * Result returned after a provider handles a send.
+ */
+export interface NotificationResult {
+    /** Provider-assigned message/send id, if available. */
+    id?: string;
+    /** Name of the provider that handled the send. */
+    provider: string;
+}
+/**
+ * A pluggable notification provider. Implementations target one or more
+ * channels and handle the actual delivery (HTTP call, SMTP, etc.).
+ *
+ * Built-in implementations:
+ * - {@link createLocalProvider} — logs to console (dev)
+ * - {@link createResendProvider} — Resend email API
+ *
+ * Additional providers can be added by implementing this interface.
+ */
+export interface NotificationProvider {
+    /** Unique provider name (e.g. "resend", "local", "twilio"). */
+    readonly name: string;
+    /** Channels this provider can handle. */
+    readonly channels: ReadonlyArray<NotificationChannel>;
+    /** Deliver the notification. Throws on failure. */
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,yCAAyC;IACzC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACrD,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAChE"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/validation.d.ts

@@ -0,0 +1,275 @@
+import { z } from "zod";
+export declare const notificationChannelSchema: z.ZodEnum<{
+    email: "email";
+    sms: "sms";
+}>;
+export declare const notificationTemplateStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    active: "active";
+    archived: "archived";
+}>;
+export declare const notificationDeliveryStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    pending: "pending";
+    failed: "failed";
+    sent: "sent";
+}>;
+export declare const notificationTargetTypeSchema: z.ZodEnum<{
+    other: "other";
+    booking: "booking";
+    invoice: "invoice";
+    booking_payment_schedule: "booking_payment_schedule";
+    booking_guarantee: "booking_guarantee";
+    payment_session: "payment_session";
+    person: "person";
+    organization: "organization";
+}>;
+export declare const notificationReminderStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    active: "active";
+    archived: "archived";
+}>;
+export declare const notificationReminderTargetTypeSchema: z.ZodEnum<{
+    booking_payment_schedule: "booking_payment_schedule";
+}>;
+export declare const notificationReminderRunStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    sent: "sent";
+    processing: "processing";
+    skipped: "skipped";
+}>;
+export declare const insertNotificationTemplateSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    channel: z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>;
+    subjectTemplate: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    htmlTemplate: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    textTemplate: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    fromAddress: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    isSystem: z.ZodDefault<z.ZodBoolean>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const updateNotificationTemplateSchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>>;
+    subjectTemplate: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    htmlTemplate: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    textTemplate: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    fromAddress: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    isSystem: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+}, z.core.$strip>;
+export declare const notificationTemplateListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const notificationDeliveryListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        failed: "failed";
+        sent: "sent";
+    }>>;
+    templateSlug: z.ZodOptional<z.ZodString>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        booking: "booking";
+        invoice: "invoice";
+        booking_payment_schedule: "booking_payment_schedule";
+        booking_guarantee: "booking_guarantee";
+        payment_session: "payment_session";
+        person: "person";
+        organization: "organization";
+    }>>;
+    targetId: z.ZodOptional<z.ZodString>;
+    bookingId: z.ZodOptional<z.ZodString>;
+    invoiceId: z.ZodOptional<z.ZodString>;
+    paymentSessionId: z.ZodOptional<z.ZodString>;
+    personId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const insertNotificationReminderRuleSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>;
+    targetType: z.ZodEnum<{
+        booking_payment_schedule: "booking_payment_schedule";
+    }>;
+    channel: z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateSlug: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    relativeDaysFromDueDate: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    isSystem: z.ZodDefault<z.ZodBoolean>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const updateNotificationReminderRuleSchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        booking_payment_schedule: "booking_payment_schedule";
+    }>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    templateId: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    templateSlug: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    relativeDaysFromDueDate: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
+    isSystem: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+}, z.core.$strip>;
+export declare const notificationReminderRuleListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        booking_payment_schedule: "booking_payment_schedule";
+    }>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const notificationReminderRunListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    reminderRuleId: z.ZodOptional<z.ZodString>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        booking_payment_schedule: "booking_payment_schedule";
+    }>>;
+    targetId: z.ZodOptional<z.ZodString>;
+    bookingId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        sent: "sent";
+        processing: "processing";
+        skipped: "skipped";
+    }>>;
+}, z.core.$strip>;
+export declare const runDueRemindersSchema: z.ZodObject<{
+    now: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const sendPaymentSessionNotificationSchema: z.ZodObject<{
+    templateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateSlug: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    channel: z.ZodDefault<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    to: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    from: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const sendInvoiceNotificationSchema: z.ZodObject<{
+    templateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateSlug: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    channel: z.ZodDefault<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    to: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    from: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const sendNotificationSchema: z.ZodObject<{
+    templateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateSlug: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    to: z.ZodString;
+    from: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    targetType: z.ZodDefault<z.ZodEnum<{
+        other: "other";
+        booking: "booking";
+        invoice: "invoice";
+        booking_payment_schedule: "booking_payment_schedule";
+        booking_guarantee: "booking_guarantee";
+        payment_session: "payment_session";
+        person: "person";
+        organization: "organization";
+    }>>;
+    targetId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    bookingId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    invoiceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    paymentSessionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,yBAAyB;;;EAA2B,CAAA;AACjE,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,gCAAgC;;;;;EAAqD,CAAA;AAClG,eAAO,MAAM,4BAA4B;;;;;;;;;EASvC,CAAA;AACF,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,oCAAoC;;EAAuC,CAAA;AACxF,eAAO,MAAM,mCAAmC;;;;;EAAsD,CAAA;AAqBtG,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAAiC,CAAA;AAC9E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAA2C,CAAA;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;iBAK9C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY9C,CAAA;AAgBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;iBAI7C,CAAA;AAEJ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;iBAKlD,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;iBAMjD,CAAA;AAEF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAiBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;iBAKhD,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;iBAKzC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwB/B,CAAA"}

package/dist/validation.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+export const notificationChannelSchema = z.enum(["email", "sms"]);
+export const notificationTemplateStatusSchema = z.enum(["draft", "active", "archived"]);
+export const notificationDeliveryStatusSchema = z.enum(["pending", "sent", "failed", "cancelled"]);
+export const notificationTargetTypeSchema = z.enum([
+    "booking",
+    "booking_payment_schedule",
+    "booking_guarantee",
+    "invoice",
+    "payment_session",
+    "person",
+    "organization",
+    "other",
+]);
+export const notificationReminderStatusSchema = z.enum(["draft", "active", "archived"]);
+export const notificationReminderTargetTypeSchema = z.enum(["booking_payment_schedule"]);
+export const notificationReminderRunStatusSchema = z.enum(["processing", "sent", "skipped", "failed"]);
+const paginationSchema = z.object({
+    limit: z.coerce.number().int().min(1).max(100).default(20),
+    offset: z.coerce.number().int().min(0).default(0),
+});
+const notificationTemplateCoreSchema = z.object({
+    slug: z.string().min(1).max(255),
+    name: z.string().min(1).max(255),
+    channel: notificationChannelSchema,
+    provider: z.string().max(255).optional().nullable(),
+    status: notificationTemplateStatusSchema.default("draft"),
+    subjectTemplate: z.string().max(2000).optional().nullable(),
+    htmlTemplate: z.string().optional().nullable(),
+    textTemplate: z.string().optional().nullable(),
+    fromAddress: z.string().max(500).optional().nullable(),
+    isSystem: z.boolean().default(false),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+});
+export const insertNotificationTemplateSchema = notificationTemplateCoreSchema;
+export const updateNotificationTemplateSchema = notificationTemplateCoreSchema.partial();
+export const notificationTemplateListQuerySchema = paginationSchema.extend({
+    channel: notificationChannelSchema.optional(),
+    provider: z.string().optional(),
+    status: notificationTemplateStatusSchema.optional(),
+    search: z.string().optional(),
+});
+export const notificationDeliveryListQuerySchema = paginationSchema.extend({
+    channel: notificationChannelSchema.optional(),
+    provider: z.string().optional(),
+    status: notificationDeliveryStatusSchema.optional(),
+    templateSlug: z.string().optional(),
+    targetType: notificationTargetTypeSchema.optional(),
+    targetId: z.string().optional(),
+    bookingId: z.string().optional(),
+    invoiceId: z.string().optional(),
+    paymentSessionId: z.string().optional(),
+    personId: z.string().optional(),
+    organizationId: z.string().optional(),
+});
+const notificationReminderRuleCoreSchema = z.object({
+    slug: z.string().min(1).max(255),
+    name: z.string().min(1).max(255),
+    status: notificationReminderStatusSchema.default("draft"),
+    targetType: notificationReminderTargetTypeSchema,
+    channel: notificationChannelSchema,
+    provider: z.string().max(255).optional().nullable(),
+    templateId: z.string().optional().nullable(),
+    templateSlug: z.string().max(255).optional().nullable(),
+    relativeDaysFromDueDate: z.coerce.number().int().min(-365).max(365).default(0),
+    isSystem: z.boolean().default(false),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+});
+export const insertNotificationReminderRuleSchema = notificationReminderRuleCoreSchema.refine((value) => Boolean(value.templateId || value.templateSlug), {
+    message: "templateId or templateSlug is required",
+    path: ["templateId"],
+});
+export const updateNotificationReminderRuleSchema = notificationReminderRuleCoreSchema
+    .partial()
+    .refine((value) => value.templateId !== "" && value.templateSlug !== "", {
+    message: "templateId and templateSlug cannot be empty strings",
+});
+export const notificationReminderRuleListQuerySchema = paginationSchema.extend({
+    status: notificationReminderStatusSchema.optional(),
+    targetType: notificationReminderTargetTypeSchema.optional(),
+    channel: notificationChannelSchema.optional(),
+    search: z.string().optional(),
+});
+export const notificationReminderRunListQuerySchema = paginationSchema.extend({
+    reminderRuleId: z.string().optional(),
+    targetType: notificationReminderTargetTypeSchema.optional(),
+    targetId: z.string().optional(),
+    bookingId: z.string().optional(),
+    status: notificationReminderRunStatusSchema.optional(),
+});
+export const runDueRemindersSchema = z.object({
+    now: z.string().datetime().optional().nullable(),
+});
+const transportNotificationCoreSchema = z.object({
+    templateId: z.string().optional().nullable(),
+    templateSlug: z.string().optional().nullable(),
+    channel: notificationChannelSchema.default("email"),
+    provider: z.string().optional().nullable(),
+    to: z.string().min(1).optional().nullable(),
+    from: z.string().max(500).optional().nullable(),
+    subject: z.string().max(2000).optional().nullable(),
+    html: z.string().optional().nullable(),
+    text: z.string().optional().nullable(),
+    data: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    scheduledFor: z.string().optional().nullable(),
+});
+export const sendPaymentSessionNotificationSchema = transportNotificationCoreSchema.refine((value) => Boolean(value.templateId || value.templateSlug || value.subject || value.html || value.text), {
+    message: "templateId, templateSlug, or direct content is required",
+});
+export const sendInvoiceNotificationSchema = transportNotificationCoreSchema.refine((value) => Boolean(value.templateId || value.templateSlug || value.subject || value.html || value.text), {
+    message: "templateId, templateSlug, or direct content is required",
+});
+export const sendNotificationSchema = z
+    .object({
+    templateId: z.string().optional().nullable(),
+    templateSlug: z.string().optional().nullable(),
+    channel: notificationChannelSchema.optional(),
+    provider: z.string().optional().nullable(),
+    to: z.string().min(1),
+    from: z.string().max(500).optional().nullable(),
+    subject: z.string().max(2000).optional().nullable(),
+    html: z.string().optional().nullable(),
+    text: z.string().optional().nullable(),
+    data: z.record(z.string(), z.unknown()).optional().nullable(),
+    targetType: notificationTargetTypeSchema.default("other"),
+    targetId: z.string().optional().nullable(),
+    bookingId: z.string().optional().nullable(),
+    invoiceId: z.string().optional().nullable(),
+    paymentSessionId: z.string().optional().nullable(),
+    personId: z.string().optional().nullable(),
+    organizationId: z.string().optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    scheduledFor: z.string().optional().nullable(),
+})
+    .refine((value) => Boolean(value.templateId || value.templateSlug || value.subject || value.html || value.text), {
+    message: "templateId, templateSlug, or direct content is required",
+});

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@voyantjs/notifications",
+  "version": "0.1.0",
+  "license": "FSL-1.1-Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "import": "./dist/validation.js"
+    },
+    "./routes": {
+      "types": "./dist/routes.d.ts",
+      "import": "./dist/routes.js"
+    },
+    "./service": {
+      "types": "./dist/service.d.ts",
+      "import": "./dist/service.js"
+    },
+    "./tasks": {
+      "types": "./dist/tasks/index.d.ts",
+      "import": "./dist/tasks/index.js"
+    },
+    "./providers/local": {
+      "types": "./dist/providers/local.d.ts",
+      "import": "./dist/providers/local.js"
+    },
+    "./providers/resend": {
+      "types": "./dist/providers/resend.d.ts",
+      "import": "./dist/providers/resend.js"
+    },
+    "./provider-resolution": {
+      "types": "./dist/provider-resolution.d.ts",
+      "import": "./dist/provider-resolution.js"
+    }
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
+    "zod": "^4.3.6",
+    "@voyantjs/bookings": "0.1.0",
+    "@voyantjs/core": "0.1.0",
+    "@voyantjs/db": "0.1.0",
+    "@voyantjs/hono": "0.1.0",
+    "@voyantjs/finance": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "@voyantjs/voyant-typescript-config": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}