@thebookingkit/server 0.1.2 → 0.1.5

package/dist/multi-tenancy.js

@@ -0,0 +1,197 @@
+/**
+ * Multi-tenancy utilities for organization-scoped deployments.
+ *
+ * Provides organization settings resolution, cascading defaults,
+ * role-based access control, and tenant authorization helpers.
+ */
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/** Error thrown for multi-tenancy authorization violations */
+export class TenantAuthorizationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TenantAuthorizationError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Global Defaults
+// ---------------------------------------------------------------------------
+/** System-wide defaults used as the base for cascading resolution */
+export const GLOBAL_DEFAULTS = {
+    timezone: "UTC",
+    currency: "USD",
+    bufferMinutes: 0,
+};
+// ---------------------------------------------------------------------------
+// Settings Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve effective settings via the cascade:
+ * `event_type > provider > organization > global defaults`
+ *
+ * @param orgSettings - Organization-level settings
+ * @param providerSettings - Provider-level settings (overrides org)
+ * @param eventTypeSettings - Event type settings (overrides provider)
+ * @returns Fully resolved effective settings
+ */
+export function resolveEffectiveSettings(orgSettings, providerSettings, eventTypeSettings) {
+    // Start with global defaults
+    let timezone = GLOBAL_DEFAULTS.timezone;
+    let currency = GLOBAL_DEFAULTS.currency;
+    let bufferMinutes = GLOBAL_DEFAULTS.bufferMinutes;
+    let branding = {};
+    let bookingLimits = {};
+    // Apply org settings
+    if (orgSettings) {
+        if (orgSettings.defaultTimezone)
+            timezone = orgSettings.defaultTimezone;
+        if (orgSettings.defaultCurrency)
+            currency = orgSettings.defaultCurrency;
+        if (orgSettings.defaultBufferMinutes !== undefined)
+            bufferMinutes = orgSettings.defaultBufferMinutes;
+        if (orgSettings.branding)
+            branding = { ...branding, ...orgSettings.branding };
+        if (orgSettings.defaultBookingLimits)
+            bookingLimits = { ...orgSettings.defaultBookingLimits };
+    }
+    // Apply provider settings (override org)
+    if (providerSettings) {
+        if (providerSettings.timezone)
+            timezone = providerSettings.timezone;
+        if (providerSettings.currency)
+            currency = providerSettings.currency;
+        if (providerSettings.bufferMinutes !== undefined)
+            bufferMinutes = providerSettings.bufferMinutes;
+        if (providerSettings.branding)
+            branding = { ...branding, ...providerSettings.branding };
+        if (providerSettings.bookingLimits)
+            bookingLimits = { ...bookingLimits, ...providerSettings.bookingLimits };
+    }
+    // Apply event type settings (override provider)
+    if (eventTypeSettings) {
+        if (eventTypeSettings.timezone)
+            timezone = eventTypeSettings.timezone;
+        if (eventTypeSettings.currency)
+            currency = eventTypeSettings.currency;
+        if (eventTypeSettings.bufferBefore !== undefined)
+            bufferMinutes = eventTypeSettings.bufferBefore;
+        if (eventTypeSettings.bookingLimits)
+            bookingLimits = { ...bookingLimits, ...eventTypeSettings.bookingLimits };
+    }
+    return { timezone, currency, bufferMinutes, branding, bookingLimits };
+}
+// ---------------------------------------------------------------------------
+// Role-Based Access Control
+// ---------------------------------------------------------------------------
+/** Permissions granted to each role */
+const ROLE_PERMISSIONS = {
+    owner: [
+        "manage:members",
+        "manage:teams",
+        "manage:event-types",
+        "view:all-bookings",
+        "view:own-bookings",
+        "manage:own-availability",
+        "view:analytics",
+        "manage:organization",
+    ],
+    admin: [
+        "manage:teams",
+        "manage:event-types",
+        "view:all-bookings",
+        "view:own-bookings",
+        "manage:own-availability",
+        "view:analytics",
+    ],
+    member: [
+        "view:own-bookings",
+        "manage:own-availability",
+    ],
+};
+/**
+ * Get all permissions granted to a role.
+ *
+ * @param role - The organization role
+ * @returns Array of permissions
+ */
+export function getRolePermissions(role) {
+    return ROLE_PERMISSIONS[role] ?? [];
+}
+/**
+ * Check if a role has a specific permission.
+ *
+ * @param role - The organization role
+ * @param permission - The permission to check
+ * @returns Whether the role has the permission
+ */
+export function roleHasPermission(role, permission) {
+    return getRolePermissions(role).includes(permission);
+}
+/**
+ * Assert that an org member has a required permission.
+ *
+ * @param member - The org member
+ * @param permission - The required permission
+ * @throws {TenantAuthorizationError} If the member lacks the permission
+ */
+export function assertOrgPermission(member, permission) {
+    if (!roleHasPermission(member.role, permission)) {
+        throw new TenantAuthorizationError(`Role "${member.role}" does not have permission: "${permission}"`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Tenant Scoping
+// ---------------------------------------------------------------------------
+/**
+ * Validate that a resource belongs to the expected organization.
+ *
+ * @param resourceOrgId - Organization ID on the resource
+ * @param expectedOrgId - The org ID from the authenticated context
+ * @throws {TenantAuthorizationError} If there is a tenant mismatch
+ */
+export function assertTenantScope(resourceOrgId, expectedOrgId) {
+    if (resourceOrgId == null) {
+        throw new TenantAuthorizationError("Resource has no organization scope");
+    }
+    if (resourceOrgId !== expectedOrgId) {
+        throw new TenantAuthorizationError("Resource does not belong to the current organization");
+    }
+}
+/**
+ * Generate the public booking URL for an organization's provider/event type.
+ *
+ * @param orgSlug - Organization slug
+ * @param providerSlug - Provider slug or ID
+ * @param eventTypeSlug - Event type slug
+ * @param baseUrl - Base URL of the application
+ * @returns Full booking URL
+ */
+const SLUG_RE = /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/;
+export function buildOrgBookingUrl(orgSlug, providerSlug, eventTypeSlug, baseUrl) {
+    for (const [name, slug] of [["orgSlug", orgSlug], ["providerSlug", providerSlug], ["eventTypeSlug", eventTypeSlug]]) {
+        if (!SLUG_RE.test(slug)) {
+            throw new TenantAuthorizationError(`Invalid ${name}: "${slug}"`);
+        }
+    }
+    return `${baseUrl}/${orgSlug}/${providerSlug}/${eventTypeSlug}`;
+}
+/**
+ * Parse an organization slug from a booking URL path.
+ *
+ * Expected format: `/{orgSlug}/{providerSlug}/{eventTypeSlug}`
+ *
+ * @param pathname - URL pathname
+ * @returns Parsed segments, or null if format is invalid
+ */
+export function parseOrgBookingPath(pathname) {
+    const match = pathname.match(/^\/([^/]+)\/([^/]+)\/([^/]+)$/);
+    if (!match)
+        return null;
+    return {
+        orgSlug: match[1],
+        providerSlug: match[2],
+        eventTypeSlug: match[3],
+    };
+}
+//# sourceMappingURL=multi-tenancy.js.map

package/dist/multi-tenancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-tenancy.js","sourceRoot":"","sources":["../src/multi-tenancy.ts"],"names":[],"mappings":"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"}

package/dist/notification-jobs.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Notification job payload types and helper functions for E-06.
+ *
+ * These types are used by background job functions (Inngest, Trigger.dev, BullMQ, etc.)
+ * when sending booking notification emails and syncing calendar events.
+ *
+ * The actual job implementation lives in the consumer app (or a provided Inngest
+ * functions file), but the payload shapes and builder functions are framework-agnostic.
+ */
+import type { EmailAdapter, CalendarAdapter, JobAdapter } from "./adapters/index.js";
+import { JOB_NAMES } from "./adapters/job-adapter.js";
+/** Common booking data included in every notification payload */
+export interface NotificationBookingData {
+    bookingId: string;
+    eventTitle: string;
+    providerName: string;
+    providerEmail: string;
+    customerName: string;
+    customerEmail: string;
+    /** ISO datetime strings */
+    startsAt: string;
+    endsAt: string;
+    timezone: string;
+    location?: string;
+    /** Signed management URL for the customer */
+    managementUrl?: string;
+    /** Unsubscribe URL */
+    unsubscribeUrl?: string;
+}
+/** Payload for SEND_CONFIRMATION_EMAIL job */
+export interface ConfirmationEmailPayload extends NotificationBookingData {
+    /** Whether to also send a notification to the provider */
+    notifyProvider?: boolean;
+}
+/** Payload for SEND_REMINDER_EMAIL job */
+export interface ReminderEmailPayload extends NotificationBookingData {
+    /** How many hours before the appointment this reminder is for (e.g., 24 or 1) */
+    reminderHours: number;
+}
+/** Payload for SEND_CANCELLATION_EMAIL job */
+export interface CancellationEmailPayload extends NotificationBookingData {
+    /** Who initiated the cancellation */
+    cancelledBy: "customer" | "provider" | "system";
+    /** Optional reason for cancellation */
+    reason?: string;
+}
+/** Payload for SEND_RESCHEDULE_EMAIL job */
+export interface RescheduleEmailPayload extends NotificationBookingData {
+    /** Original booking datetime strings */
+    oldStartsAt: string;
+    oldEndsAt: string;
+}
+/** Payload for SYNC_CALENDAR_EVENT job */
+export interface CalendarSyncPayload {
+    bookingId: string;
+    providerId: string;
+    /** External calendar event ID (for updates/deletes) */
+    externalEventId?: string;
+    eventTitle: string;
+    customerName: string;
+    customerEmail: string;
+    startsAt: string;
+    endsAt: string;
+    timezone: string;
+    location?: string;
+    description?: string;
+}
+/** Payload for DELETE_CALENDAR_EVENT job */
+export interface CalendarDeletePayload {
+    bookingId: string;
+    providerId: string;
+    externalEventId: string;
+}
+/** Payload for AUTO_REJECT_PENDING job */
+export interface AutoRejectPendingPayload {
+    bookingId: string;
+    /** Actor to record in the booking_event */
+    actor?: string;
+}
+/**
+ * Format a UTC datetime string in a given timezone for email templates.
+ *
+ * @returns `{ date, time }` formatted for the email template variables
+ */
+export declare function formatDateTimeForEmail(isoString: string, timezone: string): {
+    date: string;
+    time: string;
+};
+/**
+ * Calculate duration in human-readable form from start/end ISO strings.
+ */
+export declare function formatDurationForEmail(startsAt: string, endsAt: string): string;
+/**
+ * Send a booking confirmation email to the customer (and optionally the provider).
+ *
+ * Call this from your Inngest/Trigger.dev/BullMQ job handler.
+ *
+ * @example
+ * ```ts
+ * // In your Inngest function:
+ * export const sendConfirmation = inngest.createFunction(
+ *   { id: "send-confirmation-email" },
+ *   { event: JOB_NAMES.SEND_CONFIRMATION_EMAIL },
+ *   async ({ event }) => {
+ *     await sendConfirmationEmail(event.data, emailAdapter);
+ *   },
+ * );
+ * ```
+ */
+export declare function sendConfirmationEmail(payload: ConfirmationEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send a reminder email to the customer before their appointment.
+ */
+export declare function sendReminderEmail(payload: ReminderEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send cancellation notification emails to customer and provider.
+ */
+export declare function sendCancellationEmail(payload: CancellationEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send reschedule notification emails to customer and provider.
+ */
+export declare function sendRescheduleEmail(payload: RescheduleEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Schedule the auto-rejection of a pending booking using the job adapter.
+ *
+ * Call this immediately after creating a booking that requires confirmation.
+ *
+ * @param bookingId - ID of the pending booking
+ * @param deadline - Date at which to auto-reject (from `getAutoRejectDeadline`)
+ * @param jobs - Your `JobAdapter` instance
+ * @returns The scheduled job ID (store it if you need to cancel on manual confirm/reject)
+ */
+export declare function scheduleAutoReject(bookingId: string, deadline: Date, jobs: JobAdapter): Promise<string>;
+/**
+ * Sync a confirmed booking to the provider's connected calendar.
+ */
+export declare function syncBookingToCalendar(payload: CalendarSyncPayload, calendarAdapter: CalendarAdapter): Promise<string | undefined>;
+/**
+ * Delete a calendar event when a booking is cancelled.
+ */
+export declare function deleteBookingFromCalendar(externalEventId: string, calendarAdapter: CalendarAdapter): Promise<void>;
+export { JOB_NAMES };
+//# sourceMappingURL=notification-jobs.d.ts.map

package/dist/notification-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-jobs.d.ts","sourceRoot":"","sources":["../src/notification-jobs.ts"],"names":[],"mappings":"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"}

package/dist/notification-jobs.js

@@ -0,0 +1,278 @@
+/**
+ * Notification job payload types and helper functions for E-06.
+ *
+ * These types are used by background job functions (Inngest, Trigger.dev, BullMQ, etc.)
+ * when sending booking notification emails and syncing calendar events.
+ *
+ * The actual job implementation lives in the consumer app (or a provided Inngest
+ * functions file), but the payload shapes and builder functions are framework-agnostic.
+ */
+import { generateICSAttachment } from "./adapters/index.js";
+import { interpolateTemplate, CONFIRMATION_EMAIL_HTML, CONFIRMATION_EMAIL_TEXT, REMINDER_EMAIL_HTML, CANCELLATION_EMAIL_HTML, RESCHEDULE_EMAIL_HTML, } from "./email-templates.js";
+import { JOB_NAMES } from "./adapters/job-adapter.js";
+// ---------------------------------------------------------------------------
+// Helper functions for building notification payloads
+// ---------------------------------------------------------------------------
+/**
+ * Format a UTC datetime string in a given timezone for email templates.
+ *
+ * @returns `{ date, time }` formatted for the email template variables
+ */
+export function formatDateTimeForEmail(isoString, timezone) {
+    const dt = new Date(isoString);
+    const date = dt.toLocaleDateString("en-US", {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        timeZone: timezone,
+    });
+    const time = dt.toLocaleTimeString("en-US", {
+        hour: "numeric",
+        minute: "2-digit",
+        hour12: true,
+        timeZone: timezone,
+    });
+    return { date, time };
+}
+/**
+ * Calculate duration in human-readable form from start/end ISO strings.
+ */
+export function formatDurationForEmail(startsAt, endsAt) {
+    const ms = new Date(endsAt).getTime() - new Date(startsAt).getTime();
+    const mins = Math.round(ms / 60000);
+    if (mins < 60)
+        return `${mins} minutes`;
+    const hours = Math.floor(mins / 60);
+    const remainder = mins % 60;
+    return remainder === 0
+        ? `${hours} hour${hours !== 1 ? "s" : ""}`
+        : `${hours}h ${remainder}m`;
+}
+// ---------------------------------------------------------------------------
+// Job execution helpers (framework-agnostic)
+// ---------------------------------------------------------------------------
+/**
+ * Send a booking confirmation email to the customer (and optionally the provider).
+ *
+ * Call this from your Inngest/Trigger.dev/BullMQ job handler.
+ *
+ * @example
+ * ```ts
+ * // In your Inngest function:
+ * export const sendConfirmation = inngest.createFunction(
+ *   { id: "send-confirmation-email" },
+ *   { event: JOB_NAMES.SEND_CONFIRMATION_EMAIL },
+ *   async ({ event }) => {
+ *     await sendConfirmationEmail(event.data, emailAdapter);
+ *   },
+ * );
+ * ```
+ */
+export async function sendConfirmationEmail(payload, emailAdapter) {
+    const { date, time } = formatDateTimeForEmail(payload.startsAt, payload.timezone);
+    const duration = formatDurationForEmail(payload.startsAt, payload.endsAt);
+    const vars = {
+        bookingId: payload.bookingId,
+        eventTitle: payload.eventTitle,
+        providerName: payload.providerName,
+        customerName: payload.customerName,
+        customerEmail: payload.customerEmail,
+        date,
+        time,
+        duration,
+        timezone: payload.timezone,
+        location: payload.location,
+        managementUrl: payload.managementUrl,
+        unsubscribeUrl: payload.unsubscribeUrl,
+    };
+    const icsAttachment = generateBookingICS(payload);
+    await emailAdapter.send({
+        to: payload.customerEmail,
+        subject: `Booking Confirmed: ${payload.eventTitle} on ${date}`,
+        html: interpolateTemplate(CONFIRMATION_EMAIL_HTML, vars),
+        text: interpolateTemplate(CONFIRMATION_EMAIL_TEXT, vars),
+        attachments: icsAttachment ? [icsAttachment] : undefined,
+        headers: buildEmailHeaders(payload.unsubscribeUrl),
+    });
+    if (payload.notifyProvider) {
+        await emailAdapter.send({
+            to: payload.providerEmail,
+            subject: `New Booking: ${payload.customerName} — ${payload.eventTitle}`,
+            html: interpolateTemplate(CONFIRMATION_EMAIL_HTML, {
+                ...vars,
+                customerName: payload.customerName,
+            }),
+            text: interpolateTemplate(CONFIRMATION_EMAIL_TEXT, vars),
+            headers: buildEmailHeaders(),
+        });
+    }
+}
+/**
+ * Send a reminder email to the customer before their appointment.
+ */
+export async function sendReminderEmail(payload, emailAdapter) {
+    const { date, time } = formatDateTimeForEmail(payload.startsAt, payload.timezone);
+    const vars = {
+        bookingId: payload.bookingId,
+        eventTitle: payload.eventTitle,
+        providerName: payload.providerName,
+        customerName: payload.customerName,
+        customerEmail: payload.customerEmail,
+        date,
+        time,
+        duration: formatDurationForEmail(payload.startsAt, payload.endsAt),
+        timezone: payload.timezone,
+        location: payload.location,
+        managementUrl: payload.managementUrl,
+        unsubscribeUrl: payload.unsubscribeUrl,
+    };
+    const label = payload.reminderHours >= 24
+        ? `${payload.reminderHours / 24} day`
+        : `${payload.reminderHours} hour`;
+    await emailAdapter.send({
+        to: payload.customerEmail,
+        subject: `Reminder: ${payload.eventTitle} in ${label}${Number(label.split(" ")[0]) !== 1 ? "s" : ""}`,
+        html: interpolateTemplate(REMINDER_EMAIL_HTML, vars),
+        headers: buildEmailHeaders(payload.unsubscribeUrl),
+    });
+}
+/**
+ * Send cancellation notification emails to customer and provider.
+ */
+export async function sendCancellationEmail(payload, emailAdapter) {
+    const { date, time } = formatDateTimeForEmail(payload.startsAt, payload.timezone);
+    const vars = {
+        bookingId: payload.bookingId,
+        eventTitle: payload.eventTitle,
+        providerName: payload.providerName,
+        customerName: payload.customerName,
+        customerEmail: payload.customerEmail,
+        date,
+        time,
+        duration: formatDurationForEmail(payload.startsAt, payload.endsAt),
+        timezone: payload.timezone,
+        location: payload.location,
+        unsubscribeUrl: payload.unsubscribeUrl,
+        cancelReason: payload.reason,
+    };
+    await emailAdapter.send({
+        to: payload.customerEmail,
+        subject: `Booking Cancelled: ${payload.eventTitle}`,
+        html: interpolateTemplate(CANCELLATION_EMAIL_HTML, vars),
+        headers: buildEmailHeaders(payload.unsubscribeUrl),
+    });
+    await emailAdapter.send({
+        to: payload.providerEmail,
+        subject: `Booking Cancelled by ${payload.cancelledBy}: ${payload.customerName}`,
+        html: interpolateTemplate(CANCELLATION_EMAIL_HTML, vars),
+        headers: buildEmailHeaders(),
+    });
+}
+/**
+ * Send reschedule notification emails to customer and provider.
+ */
+export async function sendRescheduleEmail(payload, emailAdapter) {
+    const { date: newDate, time: newTime } = formatDateTimeForEmail(payload.startsAt, payload.timezone);
+    const { date: oldDate, time: oldTime } = formatDateTimeForEmail(payload.oldStartsAt, payload.timezone);
+    const vars = {
+        bookingId: payload.bookingId,
+        eventTitle: payload.eventTitle,
+        providerName: payload.providerName,
+        customerName: payload.customerName,
+        customerEmail: payload.customerEmail,
+        date: newDate,
+        time: newTime,
+        duration: formatDurationForEmail(payload.startsAt, payload.endsAt),
+        timezone: payload.timezone,
+        location: payload.location,
+        managementUrl: payload.managementUrl,
+        unsubscribeUrl: payload.unsubscribeUrl,
+        oldDate,
+        oldTime,
+        newDate,
+        newTime,
+    };
+    await emailAdapter.send({
+        to: payload.customerEmail,
+        subject: `Booking Rescheduled: ${payload.eventTitle}`,
+        html: interpolateTemplate(RESCHEDULE_EMAIL_HTML, vars),
+        headers: buildEmailHeaders(payload.unsubscribeUrl),
+    });
+    await emailAdapter.send({
+        to: payload.providerEmail,
+        subject: `Booking Rescheduled: ${payload.customerName} — ${payload.eventTitle}`,
+        html: interpolateTemplate(RESCHEDULE_EMAIL_HTML, vars),
+        headers: buildEmailHeaders(),
+    });
+}
+/**
+ * Schedule the auto-rejection of a pending booking using the job adapter.
+ *
+ * Call this immediately after creating a booking that requires confirmation.
+ *
+ * @param bookingId - ID of the pending booking
+ * @param deadline - Date at which to auto-reject (from `getAutoRejectDeadline`)
+ * @param jobs - Your `JobAdapter` instance
+ * @returns The scheduled job ID (store it if you need to cancel on manual confirm/reject)
+ */
+export async function scheduleAutoReject(bookingId, deadline, jobs) {
+    const payload = { bookingId, actor: "system" };
+    return jobs.schedule(JOB_NAMES.AUTO_REJECT_PENDING, payload, deadline);
+}
+/**
+ * Sync a confirmed booking to the provider's connected calendar.
+ */
+export async function syncBookingToCalendar(payload, calendarAdapter) {
+    const result = await calendarAdapter.createEvent({
+        title: `${payload.eventTitle} — ${payload.customerName}`,
+        description: `Customer: ${payload.customerName} (${payload.customerEmail})`,
+        startsAt: new Date(payload.startsAt),
+        endsAt: new Date(payload.endsAt),
+        timezone: payload.timezone,
+        location: payload.location,
+        attendees: [payload.customerEmail],
+    });
+    return result.eventId;
+}
+/**
+ * Delete a calendar event when a booking is cancelled.
+ */
+export async function deleteBookingFromCalendar(externalEventId, calendarAdapter) {
+    await calendarAdapter.deleteEvent(externalEventId);
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function buildEmailHeaders(unsubscribeUrl) {
+    if (!unsubscribeUrl)
+        return undefined;
+    return {
+        "List-Unsubscribe": `<${unsubscribeUrl}>`,
+        "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
+    };
+}
+function generateBookingICS(payload) {
+    try {
+        const attachment = generateICSAttachment({
+            id: payload.bookingId,
+            title: payload.eventTitle,
+            startsAt: new Date(payload.startsAt),
+            endsAt: new Date(payload.endsAt),
+            location: payload.location,
+            description: `Booking with ${payload.providerName}`,
+            organizerEmail: payload.providerEmail,
+            attendeeEmail: payload.customerEmail,
+        });
+        return {
+            filename: attachment.filename,
+            content: attachment.content,
+            contentType: attachment.contentType ?? "text/calendar",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export { JOB_NAMES };
+//# sourceMappingURL=notification-jobs.js.map

package/dist/notification-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-jobs.js","sourceRoot":"","sources":["../src/notification-jobs.ts"],"names":[],"mappings":"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"}

package/dist/serialization-retry.d.ts

@@ -0,0 +1,28 @@
+/** Options for the serialization retry wrapper */
+export interface SerializableRetryOptions {
+    /** Maximum number of retries on serialization failure. Default: 3 */
+    maxRetries?: number;
+    /** Base delay in milliseconds for exponential backoff. Default: 50 */
+    baseDelayMs?: number;
+}
+/**
+ * Wraps a database operation in serialization retry logic.
+ *
+ * If the operation fails with SQLSTATE 40001 (serialization_failure),
+ * retries up to `maxRetries` times with jittered exponential backoff.
+ *
+ * If the operation fails with SQLSTATE 23P01 (exclusion_violation),
+ * immediately throws a `BookingConflictError` (no retry — the slot is taken).
+ *
+ * @example
+ * ```ts
+ * const booking = await withSerializableRetry(
+ *   () => db.transaction(async (tx) => {
+ *     // insert booking in SERIALIZABLE isolation
+ *   }),
+ *   { maxRetries: 3 }
+ * );
+ * ```
+ */
+export declare function withSerializableRetry<T>(fn: () => Promise<T>, options?: SerializableRetryOptions): Promise<T>;
+//# sourceMappingURL=serialization-retry.d.ts.map