@voyantjs/finance 0.6.9 → 0.7.0

package/dist/service-aggregates.js

@@ -0,0 +1,106 @@
+import { and, inArray, ne, sql } from "drizzle-orm";
+import { invoices } from "./schema.js";
+const ALL_INVOICE_STATUSES = [
+    "draft",
+    "sent",
+    "partially_paid",
+    "paid",
+    "overdue",
+    "void",
+];
+/** Statuses where balance_due_cents > 0 is meaningful money we're owed. */
+const OUTSTANDING_STATUSES = ["sent", "partially_paid", "overdue"];
+export async function getFinanceAggregates(db, options = {}) {
+    const fromDate = options.from ? new Date(options.from) : undefined;
+    const toDate = options.to ? new Date(options.to) : undefined;
+    const rangeConditions = [];
+    if (fromDate)
+        rangeConditions.push(sql `${invoices.createdAt} >= ${fromDate}`);
+    if (toDate)
+        rangeConditions.push(sql `${invoices.createdAt} < ${toDate}`);
+    const rangeWhere = rangeConditions.length ? and(...rangeConditions) : undefined;
+    const [totalRow] = await db
+        .select({ count: sql `count(*)::int` })
+        .from(invoices)
+        .where(rangeWhere);
+    const statusRows = await db
+        .select({
+        status: invoices.status,
+        count: sql `count(*)::int`,
+    })
+        .from(invoices)
+        .where(rangeWhere)
+        .groupBy(invoices.status);
+    const countsByStatusMap = new Map(statusRows.map((row) => [row.status, row.count]));
+    const monthlyInvoiceCountsRows = await db
+        .select({
+        yearMonth: sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+        count: sql `count(*)::int`,
+    })
+        .from(invoices)
+        .where(rangeWhere)
+        .groupBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`)
+        .orderBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`);
+    const monthlyRevenueRows = await db
+        .select({
+        yearMonth: sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+        currency: invoices.currency,
+        totalCents: sql `coalesce(sum(${invoices.totalCents}), 0)::bigint`,
+    })
+        .from(invoices)
+        .where(and(...(rangeConditions.length ? rangeConditions : []), ne(invoices.status, "void")))
+        .groupBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`, invoices.currency)
+        .orderBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`, invoices.currency);
+    // Outstanding + overdue always look at the whole book (not the date range),
+    // since "what are we owed right now" is a point-in-time question — bounding
+    // it by `from..to` would hide old unpaid invoices.
+    const outstandingRows = await db
+        .select({
+        currency: invoices.currency,
+        balanceDueCents: sql `coalesce(sum(${invoices.balanceDueCents}), 0)::bigint`,
+        count: sql `count(*)::int`,
+    })
+        .from(invoices)
+        .where(and(inArray(invoices.status, [...OUTSTANDING_STATUSES]), sql `${invoices.balanceDueCents} > 0`))
+        .groupBy(invoices.currency)
+        .orderBy(invoices.currency);
+    const todayUtc = new Date();
+    todayUtc.setUTCHours(0, 0, 0, 0);
+    const todayDateString = todayUtc.toISOString().slice(0, 10);
+    const overdueRows = await db
+        .select({
+        currency: invoices.currency,
+        balanceDueCents: sql `coalesce(sum(${invoices.balanceDueCents}), 0)::bigint`,
+        count: sql `count(*)::int`,
+    })
+        .from(invoices)
+        .where(and(inArray(invoices.status, [...OUTSTANDING_STATUSES]), sql `${invoices.balanceDueCents} > 0`, sql `${invoices.dueDate} < ${todayDateString}`))
+        .groupBy(invoices.currency)
+        .orderBy(invoices.currency);
+    return {
+        total: totalRow?.count ?? 0,
+        countsByStatus: ALL_INVOICE_STATUSES.map((status) => ({
+            status,
+            count: countsByStatusMap.get(status) ?? 0,
+        })),
+        monthlyRevenue: monthlyRevenueRows.map((row) => ({
+            yearMonth: row.yearMonth,
+            currency: row.currency,
+            totalCents: Number(row.totalCents),
+        })),
+        monthlyInvoiceCounts: monthlyInvoiceCountsRows.map((row) => ({
+            yearMonth: row.yearMonth,
+            count: row.count,
+        })),
+        outstanding: outstandingRows.map((row) => ({
+            currency: row.currency,
+            balanceDueCents: Number(row.balanceDueCents),
+            count: row.count,
+        })),
+        overdue: overdueRows.map((row) => ({
+            currency: row.currency,
+            balanceDueCents: Number(row.balanceDueCents),
+            count: row.count,
+        })),
+    };
+}

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

@@ -0,0 +1,185 @@
+import type { BookingGroup, BookingGroupMember } from "@voyantjs/bookings/schema";
+import type { EventBus } from "@voyantjs/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { z } from "zod";
+import { type QuickCreateBookingOutcome, type QuickCreateBookingResult } from "./service-bookings-quick-create.js";
+export declare const dualCreateBookingSchema: z.ZodObject<{
+    primary: z.ZodObject<{
+        organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        productId: z.ZodString;
+        optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            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>>;
+            accessibilityNeeds: 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>>>;
+        slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scheduleType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                deposit: "deposit";
+                installment: "installment";
+                balance: "balance";
+                hold: "hold";
+            }>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                pending: "pending";
+                expired: "expired";
+                cancelled: "cancelled";
+                paid: "paid";
+                due: "due";
+                waived: "waived";
+            }>>;
+            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>>;
+    }, z.core.$strip>;
+    secondary: z.ZodObject<{
+        organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        productId: z.ZodString;
+        optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            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>>;
+            accessibilityNeeds: 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>>>;
+        slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scheduleType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                deposit: "deposit";
+                installment: "installment";
+                balance: "balance";
+                hold: "hold";
+            }>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                pending: "pending";
+                expired: "expired";
+                cancelled: "cancelled";
+                paid: "paid";
+                due: "due";
+                waived: "waived";
+            }>>;
+            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>>;
+    }, 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 {
+    eventBus?: EventBus;
+}
+export interface BookingDualCreatedEvent {
+    groupId: string;
+    primaryBookingId: string;
+    secondaryBookingId: string;
+    productId: string;
+    createdByUserId: string | null;
+    occurredAt: Date;
+}
+export interface DualCreateBookingResult {
+    primary: QuickCreateBookingResult;
+    secondary: QuickCreateBookingResult;
+    group: BookingGroup;
+    primaryMember: BookingGroupMember;
+    secondaryMember: BookingGroupMember;
+}
+export type DualCreateBookingOutcome = {
+    status: "ok";
+    result: DualCreateBookingResult;
+} | {
+    status: "primary_failed" | "secondary_failed";
+    reason: Exclude<QuickCreateBookingOutcome, {
+        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 `quickCreateBooking(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

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-bookings-dual-create.d.ts","sourceRoot":"","sources":["../src/service-bookings-dual-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAG9B,MAAM,oCAAoC,CAAA;AAkB3C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAI5E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,IAAI,CAAA;CACjB;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,wBAAwB,CAAA;IACjC,SAAS,EAAE,wBAAwB,CAAA;IACnC,KAAK,EAAE,YAAY,CAAA;IACnB,aAAa,EAAE,kBAAkB,CAAA;IACjC,eAAe,EAAE,kBAAkB,CAAA;CACpC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACjD;IACE,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAAA;IAC7C,MAAM,EAAE,OAAO,CAAC,yBAAyB,EAAE;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CAC7D,CAAA;AAqBL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,wBAAwB,CAAA;CAC9B,GACL,OAAO,CAAC,wBAAwB,CAAC,CAkFnC"}

package/dist/service-bookings-dual-create.js

@@ -0,0 +1,131 @@
+import { bookingGroupsService } from "@voyantjs/bookings";
+import { z } from "zod";
+import { quickCreateBooking, quickCreateBookingSchema, } from "./service-bookings-quick-create.js";
+// ---------- validation ----------
+/**
+ * Sub-booking input. Takes the full quick-create payload minus `group
+ * Membership` — dual-create owns the group lifecycle (one new group, both
+ * bookings linked as members) so accepting a nested group override would
+ * just be an opportunity for the caller to desync.
+ */
+const dualSubBookingSchema = quickCreateBookingSchema.omit({ groupMembership: true });
+const dualCreateGroupSchema = z.object({
+    kind: z.enum(["shared_room", "other"]).default("shared_room"),
+    label: z.string().max(255).optional().nullable(),
+    optionUnitId: z.string().optional().nullable(),
+});
+export const dualCreateBookingSchema = z.object({
+    primary: dualSubBookingSchema,
+    secondary: dualSubBookingSchema,
+    group: dualCreateGroupSchema.default({ kind: "shared_room" }),
+});
+/**
+ * Thrown inside the outer tx to force drizzle to roll back both bookings +
+ * the group when one of the inner quick-create calls returns non-ok.
+ * Drizzle doesn't abort on a non-throwing tx callback, so we convert the
+ * discriminated outcome into a throw here.
+ */
+class DualCreateAbort extends Error {
+    outcome;
+    constructor(outcome) {
+        super(outcome.status === "ok"
+            ? "dual-create aborted: ok (unexpected)"
+            : `dual-create aborted: ${outcome.status}:${outcome.reason.status}`);
+        this.outcome = outcome;
+        this.name = "DualCreateAbort";
+    }
+}
+// ---------- service ----------
+/**
+ * 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 `quickCreateBooking(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 async function dualCreateBooking(db, rawInput, options = {}) {
+    const { userId, runtime } = options;
+    const input = dualCreateBookingSchema.parse(rawInput);
+    let result;
+    try {
+        result = await db.transaction(async (tx) => {
+            const primaryOutcome = await quickCreateBooking(tx, input.primary, { userId });
+            if (primaryOutcome.status !== "ok") {
+                throw new DualCreateAbort({ status: "primary_failed", reason: primaryOutcome });
+            }
+            const secondaryOutcome = await quickCreateBooking(tx, input.secondary, { userId });
+            if (secondaryOutcome.status !== "ok") {
+                throw new DualCreateAbort({ status: "secondary_failed", reason: secondaryOutcome });
+            }
+            const primaryBooking = primaryOutcome.result.booking;
+            const secondaryBooking = secondaryOutcome.result.booking;
+            const group = await bookingGroupsService.createBookingGroup(tx, {
+                kind: input.group.kind,
+                label: input.group.label ??
+                    `Shared — ${primaryBooking.bookingNumber} + ${secondaryBooking.bookingNumber}`,
+                productId: input.primary.productId,
+                optionUnitId: input.group.optionUnitId ?? null,
+                primaryBookingId: primaryBooking.id,
+            });
+            const primaryMemberResult = await bookingGroupsService.addGroupMember(tx, group.id, {
+                bookingId: primaryBooking.id,
+                role: "primary",
+            });
+            if (primaryMemberResult.status !== "ok") {
+                // Shouldn't happen — we just created both rows in this tx — but bail
+                // through the same abort path to unwind cleanly.
+                throw new DualCreateAbort({
+                    status: "primary_failed",
+                    reason: { status: "group_not_found" },
+                });
+            }
+            const secondaryMemberResult = await bookingGroupsService.addGroupMember(tx, group.id, {
+                bookingId: secondaryBooking.id,
+                role: "shared",
+            });
+            if (secondaryMemberResult.status !== "ok") {
+                throw new DualCreateAbort({
+                    status: "secondary_failed",
+                    reason: { status: "group_not_found" },
+                });
+            }
+            return {
+                primary: primaryOutcome.result,
+                secondary: secondaryOutcome.result,
+                group,
+                primaryMember: primaryMemberResult.member,
+                secondaryMember: secondaryMemberResult.member,
+            };
+        });
+    }
+    catch (error) {
+        if (error instanceof DualCreateAbort) {
+            return error.outcome;
+        }
+        throw error;
+    }
+    if (runtime?.eventBus) {
+        const event = {
+            groupId: result.group.id,
+            primaryBookingId: result.primary.booking.id,
+            secondaryBookingId: result.secondary.booking.id,
+            productId: input.primary.productId,
+            createdByUserId: userId ?? null,
+            occurredAt: new Date(),
+        };
+        await runtime.eventBus.emit("booking.dual-created", event);
+    }
+    return { status: "ok", result };
+}

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

@@ -0,0 +1,168 @@
+import type { Booking, BookingGroupMember, BookingTraveler } from "@voyantjs/bookings/schema";
+import type { EventBus } from "@voyantjs/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { z } from "zod";
+import type { BookingPaymentSchedule, Voucher, VoucherRedemption } from "./schema.js";
+declare const travelerInputSchema: z.ZodObject<{
+    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>>;
+    accessibilityNeeds: 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>;
+export declare const quickCreateBookingSchema: z.ZodObject<{
+    productId: z.ZodString;
+    optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    bookingNumber: z.ZodString;
+    personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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>>;
+        accessibilityNeeds: 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>>>;
+    paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        scheduleType: z.ZodDefault<z.ZodEnum<{
+            other: "other";
+            deposit: "deposit";
+            installment: "installment";
+            balance: "balance";
+            hold: "hold";
+        }>>;
+        status: z.ZodDefault<z.ZodEnum<{
+            pending: "pending";
+            expired: "expired";
+            cancelled: "cancelled";
+            paid: "paid";
+            due: "due";
+            waived: "waived";
+        }>>;
+        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>>;
+    groupMembership: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"join">;
+        groupId: z.ZodString;
+        role: z.ZodDefault<z.ZodEnum<{
+            primary: "primary";
+            shared: "shared";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"create">;
+        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>>;
+        makeBookingPrimary: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>], "action">>;
+}, z.core.$strip>;
+export type QuickCreateBookingInput = z.infer<typeof quickCreateBookingSchema>;
+export type QuickCreateTravelerInput = z.infer<typeof travelerInputSchema>;
+/**
+ * Fire-and-forget post-commit events. The orchestrator only knows about
+ * `booking.quick-created` — downstream confirm/cancel lifecycle events stay
+ * with the booking service itself (the booking lands in `draft` status so no
+ * `booking.confirmed` should fire here).
+ */
+export interface BookingQuickCreateRuntime {
+    eventBus?: EventBus;
+}
+export interface BookingQuickCreatedEvent {
+    bookingId: string;
+    bookingNumber: string;
+    productId: string;
+    travelerCount: number;
+    paymentScheduleCount: number;
+    voucherRedeemedCents: number | null;
+    groupId: string | null;
+    createdByUserId: string | null;
+    occurredAt: Date;
+}
+export interface QuickCreateBookingResult {
+    booking: Booking;
+    travelers: BookingTraveler[];
+    paymentSchedules: BookingPaymentSchedule[];
+    voucherRedemption: {
+        voucher: Voucher;
+        redemption: VoucherRedemption;
+    } | null;
+    groupMembership: {
+        groupId: string;
+        member: BookingGroupMember;
+    } | null;
+}
+export type QuickCreateBookingOutcome = {
+    status: "ok";
+    result: QuickCreateBookingResult;
+} | {
+    status: "product_not_found";
+} | {
+    status: "voucher_not_found";
+} | {
+    status: "voucher_inactive";
+} | {
+    status: "voucher_not_started";
+} | {
+    status: "voucher_expired";
+} | {
+    status: "voucher_insufficient_balance";
+} | {
+    status: "group_not_found";
+} | {
+    status: "booking_already_in_group";
+    currentGroupId: string;
+};
+export declare function quickCreateBooking(db: PostgresJsDatabase, rawInput: QuickCreateBookingInput, options?: {
+    userId?: string;
+    runtime?: BookingQuickCreateRuntime;
+}): Promise<QuickCreateBookingOutcome>;
+export {};
+//# sourceMappingURL=service-bookings-quick-create.d.ts.map

package/dist/service-bookings-quick-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bookings-quick-create.d.ts","sourceRoot":"","sources":["../src/service-bookings-quick-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAOrF,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAqBvB,CAAA;AAyCF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAenC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC9E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAI1E;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,IAAI,CAAA;CACjB;AAID,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,eAAe,EAAE,CAAA;IAC5B,gBAAgB,EAAE,sBAAsB,EAAE,CAAA;IAC1C,iBAAiB,EAAE;QACjB,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,EAAE,iBAAiB,CAAA;KAC9B,GAAG,IAAI,CAAA;IACR,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,kBAAkB,CAAA;KAC3B,GAAG,IAAI,CAAA;CACT;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,8BAA8B,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,0BAA0B,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAiClE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,yBAAyB,CAAA;CAC/B,GACL,OAAO,CAAC,yBAAyB,CAAC,CAgNpC"}