@voyant-travel/finance 0.119.5

package/dist/service-booking-payment-schedules.js

@@ -0,0 +1,372 @@
+import { financePaymentProcessingService } from "./service-payment-processing.js";
+import { and, appendActionLedgerMutation, asc, assertBookingPaymentScheduleHasPaymentCoverage, bookingGuarantees, bookingPaymentSchedules, bookings, buildBookingGuaranteeCreateActionLedgerInput, buildBookingPaymentScheduleCreateActionLedgerInput, buildBookingPaymentScheduleDeleteActionLedgerInput, buildBookingPaymentScheduleUpdateActionLedgerInput, eq, invoices, or, PaymentValidationError, parseDateString, startOfUtcDay, toDateString, } from "./service-shared.js";
+export const financeBookingPaymentScheduleService = {
+    listBookingPaymentSchedules(db, bookingId) {
+        return db
+            .select()
+            .from(bookingPaymentSchedules)
+            .where(eq(bookingPaymentSchedules.bookingId, bookingId))
+            .orderBy(asc(bookingPaymentSchedules.dueDate), asc(bookingPaymentSchedules.createdAt));
+    },
+    async createBookingPaymentSchedule(db, bookingId, data, runtime = {}) {
+        if (data.status === "paid") {
+            throw new PaymentValidationError("Create booking payment schedules as pending or due, then settle them through a payment session", { bookingId });
+        }
+        const createSchedule = async (writer) => {
+            const [booking] = await writer
+                .select({ id: bookings.id })
+                .from(bookings)
+                .where(eq(bookings.id, bookingId))
+                .limit(1);
+            if (!booking) {
+                return null;
+            }
+            const [row] = await writer
+                .insert(bookingPaymentSchedules)
+                .values({ ...data, bookingId })
+                .returning();
+            return row ?? null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const row = await createSchedule(tx);
+                if (row) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleCreateActionLedgerInput(actionLedgerContext, { schedule: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return row;
+            });
+        }
+        return createSchedule(db);
+    },
+    /**
+     * Persist a payment schedule that was already computed elsewhere
+     * (typically by `computePaymentSchedule()` from the policy primitive).
+     *
+     * Idempotency: when `replace: true` (the default), any existing
+     * pending/due schedule rows on the booking are cleared first so a
+     * re-fire of the same hook doesn't pile up duplicate rows. Set
+     * `replace: false` to insert alongside existing rows (e.g. when
+     * inserting a manually-added one-off installment).
+     *
+     * Skips silently when the booking row doesn't exist (returns
+     * `null`) or when there are no entries to persist.
+     */
+    async applyComputedPaymentSchedule(db, bookingId, entries, options = {}) {
+        if (entries.length === 0)
+            return [];
+        const [booking] = await db
+            .select({ id: bookings.id })
+            .from(bookings)
+            .where(eq(bookings.id, bookingId))
+            .limit(1);
+        if (!booking)
+            return null;
+        const replace = options.replace ?? true;
+        if (replace) {
+            await db
+                .delete(bookingPaymentSchedules)
+                .where(and(eq(bookingPaymentSchedules.bookingId, bookingId), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due"))));
+        }
+        const today = startOfUtcDay(new Date());
+        const rows = entries.map((entry) => {
+            const due = parseDateString(entry.dueDate) ?? today;
+            // The `full` schedule kind from the policy primitive collapses
+            // to a `balance` row in the DB (the table only has
+            // deposit/installment/balance/hold/other) — semantically the
+            // single full-payment row IS the balance to settle.
+            const persistedType = entry.scheduleType === "full" ? "balance" : entry.scheduleType;
+            return {
+                bookingId,
+                bookingItemId: null,
+                scheduleType: persistedType,
+                status: (due <= today ? "due" : "pending"),
+                dueDate: entry.dueDate,
+                currency: entry.currency,
+                amountCents: Math.max(0, Math.round(entry.amountCents)),
+                notes: entry.notes ?? null,
+            };
+        });
+        return db.insert(bookingPaymentSchedules).values(rows).returning();
+    },
+    async applyDefaultBookingPaymentPlan(db, bookingId, data, runtime = {}) {
+        const applyPlan = async (writer) => {
+            const [booking] = await writer
+                .select()
+                .from(bookings)
+                .where(eq(bookings.id, bookingId))
+                .limit(1);
+            if (!booking) {
+                return null;
+            }
+            const totalAmountCents = booking.sellAmountCents ?? 0;
+            if (totalAmountCents <= 0) {
+                return {
+                    createdSchedules: [],
+                    deletedSchedules: [],
+                    createdGuarantee: null,
+                };
+            }
+            const today = startOfUtcDay(new Date());
+            const depositDueDate = data.depositDueDate ? parseDateString(data.depositDueDate) : today;
+            const startDate = booking.startDate ? parseDateString(booking.startDate) : null;
+            const rawBalanceDueDate = startDate
+                ? new Date(startDate.getTime() - data.balanceDueDaysBeforeStart * 24 * 60 * 60 * 1000)
+                : today;
+            const balanceDueDate = rawBalanceDueDate < today ? today : rawBalanceDueDate;
+            let depositAmountCents = 0;
+            if (data.depositMode === "fixed_amount") {
+                depositAmountCents = Math.min(totalAmountCents, data.depositValue);
+            }
+            else if (data.depositMode === "percentage") {
+                depositAmountCents = Math.min(totalAmountCents, Math.round((totalAmountCents * data.depositValue) / 100));
+            }
+            const clearableScheduleWhere = and(eq(bookingPaymentSchedules.bookingId, bookingId), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due")));
+            const deletedSchedules = data.clearExistingPending
+                ? await writer.select().from(bookingPaymentSchedules).where(clearableScheduleWhere)
+                : [];
+            if (data.clearExistingPending) {
+                await writer.delete(bookingPaymentSchedules).where(clearableScheduleWhere);
+            }
+            const scheduleRows = [];
+            if (depositAmountCents > 0 && depositAmountCents < totalAmountCents) {
+                scheduleRows.push({
+                    bookingItemId: null,
+                    scheduleType: "deposit",
+                    status: depositDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(depositDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: depositAmountCents,
+                    notes: data.notes ?? null,
+                });
+                scheduleRows.push({
+                    bookingItemId: null,
+                    scheduleType: "balance",
+                    status: balanceDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(balanceDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: Math.max(0, totalAmountCents - depositAmountCents),
+                    notes: data.notes ?? null,
+                });
+            }
+            else {
+                const singleDueDate = balanceDueDate <= today ? today : balanceDueDate;
+                scheduleRows.push({
+                    bookingItemId: null,
+                    scheduleType: "balance",
+                    status: singleDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(singleDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: totalAmountCents,
+                    notes: data.notes ?? null,
+                });
+            }
+            const createdSchedules = await writer
+                .insert(bookingPaymentSchedules)
+                .values(scheduleRows.map((row) => ({
+                ...row,
+                bookingId,
+                bookingItemId: row.bookingItemId ?? null,
+                notes: row.notes ?? null,
+            })))
+                .returning();
+            let createdGuarantee = null;
+            if (data.createGuarantee) {
+                const depositSchedule = createdSchedules.find((schedule) => schedule.scheduleType === "deposit");
+                if (depositSchedule) {
+                    const [guarantee] = await writer
+                        .insert(bookingGuarantees)
+                        .values({
+                        bookingId,
+                        bookingPaymentScheduleId: depositSchedule.id,
+                        bookingItemId: null,
+                        guaranteeType: data.guaranteeType,
+                        status: "pending",
+                        paymentInstrumentId: null,
+                        paymentAuthorizationId: null,
+                        currency: depositSchedule.currency,
+                        amountCents: depositSchedule.amountCents,
+                        provider: null,
+                        referenceNumber: null,
+                        guaranteedAt: null,
+                        expiresAt: null,
+                        releasedAt: null,
+                        notes: data.notes ?? null,
+                    })
+                        .returning();
+                    createdGuarantee = guarantee ?? null;
+                }
+            }
+            return { createdSchedules, deletedSchedules, createdGuarantee };
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const applied = await applyPlan(tx);
+                if (!applied) {
+                    return null;
+                }
+                for (const schedule of applied.deletedSchedules) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleDeleteActionLedgerInput(actionLedgerContext, { schedule }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                for (const schedule of applied.createdSchedules) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleCreateActionLedgerInput(actionLedgerContext, { schedule }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                if (applied.createdGuarantee) {
+                    await appendActionLedgerMutation(tx, await buildBookingGuaranteeCreateActionLedgerInput(actionLedgerContext, { guarantee: applied.createdGuarantee }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return applied.createdSchedules;
+            });
+            return result;
+        }
+        const result = await applyPlan(db);
+        return result?.createdSchedules ?? null;
+    },
+    async updateBookingPaymentSchedule(db, scheduleId, data, runtime = {}) {
+        const updateSchedule = async (writer) => {
+            const [existing] = await writer
+                .select()
+                .from(bookingPaymentSchedules)
+                .where(eq(bookingPaymentSchedules.id, scheduleId))
+                .limit(1);
+            if (!existing) {
+                return [];
+            }
+            const nextSchedule = {
+                id: existing.id,
+                bookingId: existing.bookingId,
+                amountCents: data.amountCents ?? existing.amountCents,
+                currency: data.currency ?? existing.currency,
+            };
+            const nextStatus = data.status ?? existing.status;
+            if (nextStatus === "paid") {
+                await assertBookingPaymentScheduleHasPaymentCoverage(writer, nextSchedule);
+            }
+            return writer
+                .update(bookingPaymentSchedules)
+                .set({ ...data, updatedAt: new Date() })
+                .where(eq(bookingPaymentSchedules.id, scheduleId))
+                .returning();
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateSchedule(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleUpdateActionLedgerInput(actionLedgerContext, { schedule: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateSchedule(db);
+        return row ?? null;
+    },
+    async deleteBookingPaymentSchedule(db, scheduleId, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(bookingPaymentSchedules)
+                    .where(eq(bookingPaymentSchedules.id, scheduleId))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(bookingPaymentSchedules).where(eq(bookingPaymentSchedules.id, scheduleId));
+                await appendActionLedgerMutation(tx, buildBookingPaymentScheduleDeleteActionLedgerInput(actionLedgerContext, { schedule: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
+        const [row] = await db
+            .delete(bookingPaymentSchedules)
+            .where(eq(bookingPaymentSchedules.id, scheduleId))
+            .returning({ id: bookingPaymentSchedules.id });
+        return row ?? null;
+    },
+    async createPaymentSessionFromBookingSchedule(db, scheduleId, data, runtime = {}) {
+        const [schedule] = await db
+            .select()
+            .from(bookingPaymentSchedules)
+            .where(eq(bookingPaymentSchedules.id, scheduleId))
+            .limit(1);
+        if (!schedule) {
+            return null;
+        }
+        if (schedule.status === "paid" ||
+            schedule.status === "waived" ||
+            schedule.status === "cancelled") {
+            throw new Error(`Cannot create payment session for schedule in status "${schedule.status}"`);
+        }
+        return financePaymentProcessingService.createPaymentSession(db, {
+            targetType: "booking_payment_schedule",
+            targetId: schedule.id,
+            bookingId: schedule.bookingId,
+            bookingPaymentScheduleId: schedule.id,
+            status: "pending",
+            provider: data.provider ?? null,
+            externalReference: data.externalReference ?? null,
+            idempotencyKey: data.idempotencyKey ?? null,
+            clientReference: data.clientReference ?? schedule.id,
+            currency: schedule.currency,
+            amountCents: schedule.amountCents,
+            paymentMethod: data.paymentMethod ?? null,
+            payerPersonId: data.payerPersonId ?? null,
+            payerOrganizationId: data.payerOrganizationId ?? null,
+            payerEmail: data.payerEmail ?? null,
+            payerName: data.payerName ?? null,
+            returnUrl: data.returnUrl ?? null,
+            cancelUrl: data.cancelUrl ?? null,
+            callbackUrl: data.callbackUrl ?? null,
+            expiresAt: data.expiresAt ?? null,
+            notes: data.notes ?? schedule.notes ?? null,
+            providerPayload: data.providerPayload ?? null,
+            metadata: data.metadata ?? {
+                scheduleType: schedule.scheduleType,
+                dueDate: schedule.dueDate,
+            },
+        }, runtime);
+    },
+    async createPaymentSessionFromInvoice(db, invoiceId, data, runtime = {}) {
+        const [invoice] = await db.select().from(invoices).where(eq(invoices.id, invoiceId)).limit(1);
+        if (!invoice) {
+            return null;
+        }
+        if (invoice.status === "paid" || invoice.status === "void") {
+            throw new Error(`Cannot create payment session for invoice in status "${invoice.status}"`);
+        }
+        if (invoice.balanceDueCents <= 0) {
+            throw new Error("Invoice must have an outstanding balance before creating a payment session");
+        }
+        return financePaymentProcessingService.createPaymentSession(db, {
+            targetType: "invoice",
+            targetId: invoice.id,
+            bookingId: invoice.bookingId,
+            invoiceId: invoice.id,
+            status: "pending",
+            provider: data.provider ?? null,
+            externalReference: data.externalReference ?? invoice.invoiceNumber,
+            idempotencyKey: data.idempotencyKey ?? null,
+            clientReference: data.clientReference ?? invoice.id,
+            currency: invoice.currency,
+            amountCents: invoice.balanceDueCents,
+            paymentMethod: data.paymentMethod ?? null,
+            payerPersonId: data.payerPersonId ?? invoice.personId ?? null,
+            payerOrganizationId: data.payerOrganizationId ?? invoice.organizationId ?? null,
+            payerEmail: data.payerEmail ?? null,
+            payerName: data.payerName ?? null,
+            returnUrl: data.returnUrl ?? null,
+            cancelUrl: data.cancelUrl ?? null,
+            callbackUrl: data.callbackUrl ?? null,
+            expiresAt: data.expiresAt ?? null,
+            notes: data.notes ?? invoice.notes ?? null,
+            providerPayload: data.providerPayload ?? null,
+            metadata: data.metadata ?? {
+                invoiceNumber: invoice.invoiceNumber,
+                invoiceType: invoice.invoiceType,
+                dueDate: invoice.dueDate,
+            },
+        }, runtime);
+    },
+};

package/dist/service-bookings-dual-create.d.ts

@@ -0,0 +1,308 @@
+import type { BookingGroup, BookingGroupMember } from "@voyant-travel/bookings/schema";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { z } from "zod";
+import type { FinanceServiceRuntime } from "./service.js";
+import { type BookingCreateOutcome, type BookingCreateResult } from "./service-booking-create.js";
+export declare const dualCreateBookingSchema: z.ZodObject<{
+    primary: z.ZodObject<{
+        productId: z.ZodString;
+        personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactLastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPreferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCountry: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactRegion: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCity: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine1: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine2: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPostalCode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        pax: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        sellAmountCentsOverride: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        catalogSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        confirmedSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        priceOverrideReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        initialStatus: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            expired: "expired";
+            draft: "draft";
+            completed: "completed";
+            on_hold: "on_hold";
+            awaiting_payment: "awaiting_payment";
+            confirmed: "confirmed";
+            in_progress: "in_progress";
+        }>>;
+        suppressNotifications: z.ZodOptional<z.ZodBoolean>;
+        allowDuplicate: z.ZodOptional<z.ZodBoolean>;
+        travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientTravelerKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            firstName: z.ZodString;
+            lastName: z.ZodString;
+            email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            participantType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                traveler: "traveler";
+                occupant: "occupant";
+            }>>;
+            travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+                other: "other";
+                adult: "adult";
+                child: "child";
+                infant: "infant";
+                senior: "senior";
+            }>>>;
+            preferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            specialRequests: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            roomUnitId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            isPrimary: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        itemLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            optionUnitId: z.ZodString;
+            quantity: z.ZodNumber;
+            title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        extraLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            productExtraId: z.ZodString;
+            optionExtraConfigId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricingMode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricedPerPerson: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            quantity: z.ZodNumber;
+            sellCurrency: z.ZodString;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scheduleType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                deposit: "deposit";
+                balance: "balance";
+                installment: "installment";
+                hold: "hold";
+            }>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                pending: "pending";
+                cancelled: "cancelled";
+                due: "due";
+                paid: "paid";
+                waived: "waived";
+                expired: "expired";
+            }>>;
+            dueDate: z.ZodString;
+            currency: z.ZodString;
+            amountCents: z.ZodNumber;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        voucherRedemption: z.ZodOptional<z.ZodObject<{
+            voucherId: z.ZodString;
+            amountCents: z.ZodNumber;
+        }, z.core.$strip>>;
+        documentGeneration: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+            contractDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceType: z.ZodDefault<z.ZodEnum<{
+                invoice: "invoice";
+                proforma: "proforma";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    secondary: z.ZodObject<{
+        productId: z.ZodString;
+        personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactLastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPreferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCountry: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactRegion: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCity: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine1: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine2: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPostalCode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        pax: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        sellAmountCentsOverride: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        catalogSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        confirmedSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        priceOverrideReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        initialStatus: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            expired: "expired";
+            draft: "draft";
+            completed: "completed";
+            on_hold: "on_hold";
+            awaiting_payment: "awaiting_payment";
+            confirmed: "confirmed";
+            in_progress: "in_progress";
+        }>>;
+        suppressNotifications: z.ZodOptional<z.ZodBoolean>;
+        allowDuplicate: z.ZodOptional<z.ZodBoolean>;
+        travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientTravelerKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            firstName: z.ZodString;
+            lastName: z.ZodString;
+            email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            participantType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                traveler: "traveler";
+                occupant: "occupant";
+            }>>;
+            travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+                other: "other";
+                adult: "adult";
+                child: "child";
+                infant: "infant";
+                senior: "senior";
+            }>>>;
+            preferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            specialRequests: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            roomUnitId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            isPrimary: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        itemLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            optionUnitId: z.ZodString;
+            quantity: z.ZodNumber;
+            title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        extraLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            productExtraId: z.ZodString;
+            optionExtraConfigId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricingMode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricedPerPerson: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            quantity: z.ZodNumber;
+            sellCurrency: z.ZodString;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scheduleType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                deposit: "deposit";
+                balance: "balance";
+                installment: "installment";
+                hold: "hold";
+            }>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                pending: "pending";
+                cancelled: "cancelled";
+                due: "due";
+                paid: "paid";
+                waived: "waived";
+                expired: "expired";
+            }>>;
+            dueDate: z.ZodString;
+            currency: z.ZodString;
+            amountCents: z.ZodNumber;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        voucherRedemption: z.ZodOptional<z.ZodObject<{
+            voucherId: z.ZodString;
+            amountCents: z.ZodNumber;
+        }, z.core.$strip>>;
+        documentGeneration: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+            contractDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceType: z.ZodDefault<z.ZodEnum<{
+                invoice: "invoice";
+                proforma: "proforma";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    group: z.ZodDefault<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodEnum<{
+            other: "other";
+            shared_room: "shared_room";
+        }>>;
+        label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        optionUnitId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DualCreateBookingInput = z.infer<typeof dualCreateBookingSchema>;
+export interface DualCreateBookingRuntime extends FinanceServiceRuntime {
+}
+export interface BookingDualCreatedEvent {
+    groupId: string;
+    primaryBookingId: string;
+    secondaryBookingId: string;
+    productId: string;
+    createdByUserId: string | null;
+    occurredAt: Date;
+}
+export interface DualCreateBookingResult {
+    primary: BookingCreateResult;
+    secondary: BookingCreateResult;
+    group: BookingGroup;
+    primaryMember: BookingGroupMember;
+    secondaryMember: BookingGroupMember;
+}
+export type DualCreateBookingOutcome = {
+    status: "ok";
+    result: DualCreateBookingResult;
+} | {
+    status: "primary_failed" | "secondary_failed";
+    reason: Exclude<BookingCreateOutcome, {
+        status: "ok";
+    }>;
+};
+/**
+ * Create two bookings linked via a new `booking_group`, atomically. The
+ * canonical operator flow: two travelers book a shared room ("partaj"), each
+ * gets their own booking, and both are attached to a new shared_room group
+ * so subsequent payment / cancellation decisions can fan out across the
+ * pair.
+ *
+ * Transaction shape:
+ *  - Outer tx opens via `db.transaction`.
+ *  - Inner: two savepoint-scoped `createBooking(tx, ...)` calls — the
+ *    nested transactions drizzle opens use SAVEPOINTs, so partial failures
+ *    surface up to this layer as non-ok outcomes.
+ *  - If either fails, the outer tx throws `DualCreateAbort` so the whole
+ *    thing rolls back (no orphan booking, no orphan group).
+ *  - Group creation + both memberships run last, inside the same outer tx.
+ *
+ * Event emission (`booking.dual-created`) is post-commit — subscribers only
+ * hear about successful pairs.
+ */
+export declare function dualCreateBooking(db: PostgresJsDatabase, rawInput: DualCreateBookingInput, options?: {
+    userId?: string;
+    runtime?: DualCreateBookingRuntime;
+}): Promise<DualCreateBookingOutcome>;
+//# sourceMappingURL=service-bookings-dual-create.d.ts.map