@voyant-travel/trips 0.110.2

package/dist/service-checkout.js

@@ -0,0 +1,328 @@
+import { eq } from "drizzle-orm";
+import { tripComponents, tripEnvelopes } from "./schema.js";
+import { aggregateComponentPricing, assertTripComponentCanBeUpdated, assertTripComponentCanStartCheckout, checkoutResultToComponentPatch, shouldReplayCheckout, } from "./service-helpers.js";
+import { appendWarningCodes, commonString, createComponentEvent, markComponentForStaffRemediation, minComponentHoldExpiry, statusToEventType, } from "./service-internals.js";
+import { getTrip } from "./service-trips.js";
+import { TripsInvariantError } from "./service-types.js";
+import { assertTripTravelerPartyComplete } from "./traveler-party-validation.js";
+const payableEnvelopeStatuses = new Set(["reserved", "checkout_started", "booked"]);
+const payableComponentStatuses = new Set(["held", "checkout_started", "booked"]);
+export async function startCheckout(db, input, deps) {
+    const trip = await getTrip(db, input.envelopeId);
+    if (!trip) {
+        throw new TripsInvariantError(`Trip envelope ${input.envelopeId} was not found`);
+    }
+    if (shouldReplayCheckout(trip.envelope, input.idempotencyKey)) {
+        return replayCheckoutResult(trip);
+    }
+    if (trip.envelope.status !== "reserved") {
+        throw new TripsInvariantError(`Trip envelope ${input.envelopeId} is ${trip.envelope.status} and must be reserved before checkout`);
+    }
+    assertTripTravelerPartyComplete(trip.envelope.travelerParty, "Trip checkout");
+    const warnings = new Set();
+    const failures = [];
+    const componentCheckouts = [];
+    const componentsById = new Map(trip.components.map((component) => [component.id, component]));
+    const checkoutable = trip.components.filter((component) => component.status !== "removed" && component.status !== "cancelled");
+    if (deps.startTripCheckout) {
+        const result = await deps.startTripCheckout({
+            trip,
+            intent: input.intent,
+            request: input.request,
+        });
+        for (const warning of result.warnings ?? [])
+            warnings.add(warning);
+        const [envelope] = (await db
+            .update(tripEnvelopes)
+            .set({
+            status: result.status ?? "checkout_started",
+            checkoutIdempotencyKey: input.idempotencyKey ?? null,
+            checkoutStartedAt: new Date(),
+            paymentSessionId: result.paymentSessionId ?? null,
+            updatedAt: new Date(),
+        })
+            .where(eq(tripEnvelopes.id, input.envelopeId))
+            .returning());
+        if (!envelope) {
+            throw new Error("startCheckout: aggregate envelope update returned no rows");
+        }
+        const refreshed = await getTrip(db, input.envelopeId);
+        const components = refreshed?.components ?? trip.components;
+        const componentCheckouts = aggregateComponentCheckouts(components, result);
+        return {
+            envelope,
+            components,
+            target: checkoutTargetFromTrip(envelope, components, componentCheckouts),
+            componentCheckouts,
+            failures: [],
+            warnings: [...warnings],
+        };
+    }
+    for (const component of checkoutable) {
+        try {
+            assertTripComponentCanStartCheckout(component);
+            const result = await deps.startComponentCheckout({
+                envelope: trip.envelope,
+                component,
+                intent: input.intent,
+                request: input.request,
+            });
+            const updated = await applyCheckoutResultToComponent(db, component, result);
+            componentsById.set(updated.id, updated);
+            componentCheckouts.push(toStartedComponentCheckout(updated, result));
+            for (const warning of result.warnings ?? [])
+                warnings.add(warning);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : "checkout_start_failed";
+            warnings.add(reason);
+            failures.push({ componentId: component.id, reason });
+            const updated = await markComponentForStaffRemediation(db, component, reason);
+            componentsById.set(updated.id, updated);
+        }
+    }
+    if (failures.length > 0) {
+        const [failedEnvelope] = (await db
+            .update(tripEnvelopes)
+            .set({
+            status: "failed",
+            updatedAt: new Date(),
+        })
+            .where(eq(tripEnvelopes.id, input.envelopeId))
+            .returning());
+        if (!failedEnvelope) {
+            throw new Error("startCheckout: failed envelope update returned no rows");
+        }
+        const refreshed = await getTrip(db, input.envelopeId);
+        const components = refreshed?.components ?? [...componentsById.values()];
+        return {
+            envelope: failedEnvelope,
+            components,
+            target: checkoutTargetFromTrip(failedEnvelope, components, componentCheckouts),
+            componentCheckouts,
+            failures,
+            warnings: [...warnings],
+        };
+    }
+    const refs = commonEnvelopeCheckoutRefs(componentCheckouts);
+    const [envelope] = (await db
+        .update(tripEnvelopes)
+        .set({
+        status: "checkout_started",
+        checkoutIdempotencyKey: input.idempotencyKey ?? null,
+        checkoutStartedAt: new Date(),
+        ...refs,
+        updatedAt: new Date(),
+    })
+        .where(eq(tripEnvelopes.id, input.envelopeId))
+        .returning());
+    if (!envelope) {
+        throw new Error("startCheckout: envelope update returned no rows");
+    }
+    const refreshed = await getTrip(db, input.envelopeId);
+    const components = refreshed?.components ?? [...componentsById.values()];
+    return {
+        envelope,
+        components,
+        target: checkoutTargetFromTrip(envelope, components, componentCheckouts),
+        componentCheckouts,
+        failures,
+        warnings: [...warnings],
+    };
+}
+export async function completeTripCheckout(db, input) {
+    if (!input.envelopeId && !input.paymentSessionId) {
+        throw new TripsInvariantError("completeTripCheckout requires an envelopeId or paymentSessionId");
+    }
+    const trip = await findTripForCheckoutCompletion(db, input);
+    if (!trip)
+        return null;
+    if (!payableEnvelopeStatuses.has(trip.envelope.status)) {
+        throw new TripsInvariantError(`Trip envelope ${trip.envelope.id} is ${trip.envelope.status} and cannot be completed from payment`);
+    }
+    const paymentSessionId = input.paymentSessionId ?? trip.envelope.paymentSessionId ?? null;
+    if (input.paymentSessionId &&
+        trip.envelope.paymentSessionId &&
+        trip.envelope.paymentSessionId !== input.paymentSessionId) {
+        throw new TripsInvariantError(`Payment session ${input.paymentSessionId} does not belong to trip envelope ${trip.envelope.id}`);
+    }
+    const alreadyCompleted = trip.envelope.status === "booked" &&
+        trip.components
+            .filter((component) => component.status !== "removed" && component.status !== "cancelled")
+            .every((component) => component.status === "booked");
+    if (alreadyCompleted) {
+        return {
+            envelope: trip.envelope,
+            components: trip.components,
+            updatedComponentIds: [],
+            alreadyCompleted: true,
+        };
+    }
+    const paidAt = input.paidAt ? new Date(input.paidAt) : new Date();
+    const updatedComponentIds = [];
+    for (const component of trip.components) {
+        if (component.status === "removed" || component.status === "cancelled")
+            continue;
+        if (!payableComponentStatuses.has(component.status)) {
+            throw new TripsInvariantError(`Trip component ${component.id} is ${component.status} and cannot be completed from payment`);
+        }
+        if (component.status === "booked")
+            continue;
+        const [updated] = (await db
+            .update(tripComponents)
+            .set({ status: "booked", updatedAt: paidAt })
+            .where(eq(tripComponents.id, component.id))
+            .returning());
+        if (!updated) {
+            throw new Error(`completeTripCheckout: update returned no row for ${component.id}`);
+        }
+        updatedComponentIds.push(updated.id);
+        await createComponentEvent(db, {
+            envelopeId: updated.envelopeId,
+            componentId: updated.id,
+            eventType: "booked",
+            fromStatus: component.status,
+            toStatus: "booked",
+            actorId: input.actorId ?? null,
+            payload: {
+                paymentSessionId,
+                paidAt: paidAt.toISOString(),
+                ...(input.payload ?? {}),
+            },
+        });
+    }
+    const [envelope] = (await db
+        .update(tripEnvelopes)
+        .set({
+        status: "booked",
+        paymentSessionId: paymentSessionId ?? trip.envelope.paymentSessionId ?? null,
+        updatedAt: paidAt,
+    })
+        .where(eq(tripEnvelopes.id, trip.envelope.id))
+        .returning());
+    if (!envelope) {
+        throw new Error(`completeTripCheckout: envelope update returned no row for ${trip.envelope.id}`);
+    }
+    const refreshed = await getTrip(db, envelope.id);
+    return {
+        envelope,
+        components: refreshed?.components ?? trip.components,
+        updatedComponentIds,
+        alreadyCompleted: false,
+    };
+}
+async function findTripForCheckoutCompletion(db, input) {
+    if (input.envelopeId) {
+        return getTrip(db, input.envelopeId);
+    }
+    const [envelope] = (await db
+        .select()
+        .from(tripEnvelopes)
+        .where(eq(tripEnvelopes.paymentSessionId, input.paymentSessionId))
+        .limit(1));
+    if (!envelope)
+        return null;
+    return getTrip(db, envelope.id);
+}
+function aggregateComponentCheckouts(components, result) {
+    return components
+        .filter((component) => component.status !== "removed" && component.status !== "cancelled")
+        .map((component) => ({
+        componentId: component.id,
+        kind: result.kind,
+        bookingId: component.bookingId,
+        orderId: component.orderId,
+        paymentSessionId: result.paymentSessionId ?? null,
+        checkoutUrl: result.checkoutUrl ?? null,
+        bankTransferInstructions: result.bankTransferInstructions ?? null,
+        expiresAt: result.expiresAt ?? component.holdExpiresAt?.toISOString() ?? null,
+    }));
+}
+async function applyCheckoutResultToComponent(db, component, result) {
+    const nextStatus = result.status ?? "checkout_started";
+    assertTripComponentCanBeUpdated(component, { status: nextStatus });
+    const [updated] = (await db
+        .update(tripComponents)
+        .set({
+        ...checkoutResultToComponentPatch(result),
+        warningCodes: appendWarningCodes(component.warningCodes, result.warnings ?? []),
+        updatedAt: new Date(),
+    })
+        .where(eq(tripComponents.id, component.id))
+        .returning());
+    if (!updated) {
+        throw new Error(`applyCheckoutResultToComponent: update returned no row for ${component.id}`);
+    }
+    await createComponentEvent(db, {
+        envelopeId: updated.envelopeId,
+        componentId: updated.id,
+        eventType: statusToEventType(updated.status),
+        fromStatus: component.status,
+        toStatus: updated.status,
+        payload: {
+            kind: result.kind,
+            bookingId: updated.bookingId,
+            bookingGroupId: updated.bookingGroupId,
+            orderId: updated.orderId,
+            paymentSessionId: updated.paymentSessionId,
+            providerRef: updated.providerRef,
+            supplierRef: updated.supplierRef,
+            checkoutUrl: result.checkoutUrl,
+            externalReference: result.externalReference,
+        },
+    });
+    return updated;
+}
+function replayCheckoutResult(trip) {
+    const components = trip.components;
+    const componentCheckouts = components
+        .filter((component) => component.status === "checkout_started" || component.status === "booked")
+        .map((component) => toStartedComponentCheckout(component, {
+        kind: component.paymentSessionId ? "payment_session" : "hold_placed",
+        status: component.status === "booked" ? "booked" : "checkout_started",
+        paymentSessionId: component.paymentSessionId ?? undefined,
+    }));
+    return {
+        envelope: trip.envelope,
+        components,
+        target: checkoutTargetFromTrip(trip.envelope, components, componentCheckouts),
+        componentCheckouts,
+        failures: [],
+        warnings: ["idempotent_replay"],
+    };
+}
+function toStartedComponentCheckout(component, result) {
+    return {
+        componentId: component.id,
+        kind: result.kind,
+        bookingId: component.bookingId,
+        orderId: component.orderId,
+        paymentSessionId: component.paymentSessionId,
+        checkoutUrl: result.checkoutUrl ?? null,
+        bankTransferInstructions: result.bankTransferInstructions ?? null,
+        expiresAt: result.expiresAt ?? component.holdExpiresAt?.toISOString() ?? null,
+    };
+}
+function checkoutTargetFromTrip(envelope, components, componentCheckouts) {
+    return {
+        envelopeId: envelope.id,
+        status: "checkout_started",
+        currency: envelope.aggregateCurrency ?? aggregateComponentPricing(components).currency,
+        totalAmountCents: envelope.aggregateTotalAmountCents ?? aggregateComponentPricing(components).totalAmountCents,
+        paymentSessionId: envelope.paymentSessionId ??
+            commonString(componentCheckouts.map((checkout) => checkout.paymentSessionId ?? undefined)) ??
+            null,
+        checkoutUrl: commonString(componentCheckouts.map((checkout) => checkout.checkoutUrl ?? undefined)) ?? null,
+        holdExpiresAt: minComponentHoldExpiry(components)?.toISOString() ?? null,
+    };
+}
+function commonEnvelopeCheckoutRefs(componentCheckouts) {
+    const refs = {};
+    const paymentSessionId = commonString(componentCheckouts.map((checkout) => checkout.paymentSessionId ?? undefined));
+    const orderId = commonString(componentCheckouts.map((checkout) => checkout.orderId ?? undefined));
+    if (paymentSessionId)
+        refs.paymentSessionId = paymentSessionId;
+    if (orderId)
+        refs.orderId = orderId;
+    return refs;
+}

package/dist/service-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { PricingBreakdownV1 } from "@voyant-travel/catalog/booking-engine";
+import type { NewTripComponent, TripComponent, TripEnvelope } from "./schema.js";
+import type { ComponentCheckoutResult, ReserveComponentResult } from "./service-types.js";
+import { type TripComponentPricingSnapshot, type TripComponentTaxLine, type TripEnvelopePricingSnapshot, type UpdateTripComponentInput, type UpdateTripComponentRefsInput } from "./validation.js";
+export declare function hasCommittedComponentReference(component: Pick<TripComponent, "bookingId" | "bookingGroupId" | "orderId" | "paymentSessionId" | "providerRef" | "supplierRef">): boolean;
+export declare function assertTripComponentCanBeUpdated(component: TripComponent, patch: UpdateTripComponentInput): void;
+export declare function assertTripComponentCanReceiveRefs(component: TripComponent, refs: UpdateTripComponentRefsInput): void;
+export declare function assertTripComponentCanBeReserved(component: TripComponent, now?: Date): void;
+export declare function reserveResultToComponentPatch(result: ReserveComponentResult): Partial<NewTripComponent>;
+export declare function shouldReplayReserve(envelope: Pick<TripEnvelope, "reserveIdempotencyKey" | "status">, idempotencyKey?: string): boolean;
+export declare function shouldReplayCheckout(envelope: Pick<TripEnvelope, "checkoutIdempotencyKey" | "status">, idempotencyKey?: string): boolean;
+export declare function assertTripComponentCanStartCheckout(component: TripComponent, now?: Date): void;
+export declare function checkoutResultToComponentPatch(result: ComponentCheckoutResult): Partial<NewTripComponent>;
+export declare function pricingSnapshotFromBreakdown(pricing: PricingBreakdownV1, priceExpiresAt?: string, warnings?: string[]): TripComponentPricingSnapshot;
+export declare function taxLinesFromBreakdown(pricing: PricingBreakdownV1): TripComponentTaxLine[];
+export declare function aggregateComponentPricing(components: Array<Pick<TripComponent, "pricingSnapshot" | "warningCodes">>, preferredCurrency?: string): TripEnvelopePricingSnapshot;
+//# sourceMappingURL=service-helpers.d.ts.map

package/dist/service-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-helpers.d.ts","sourceRoot":"","sources":["../src/service-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAG/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEzF,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAA;AAExB,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CACb,aAAa,EACb,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,kBAAkB,GAAG,aAAa,GAAG,aAAa,CAChG,GACA,OAAO,CAST;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAkBN;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,4BAA4B,GACjC,IAAI,CAcN;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,aAAa,EACxB,GAAG,GAAE,IAAiB,GACrB,IAAI,CAsBN;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,uBAAuB,GAAG,QAAQ,CAAC,EAChE,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAMT;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,wBAAwB,GAAG,QAAQ,CAAC,EACjE,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAMT;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,aAAa,EACxB,GAAG,GAAE,IAAiB,GACrB,IAAI,CAgBN;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAa3B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,4BAA4B,CAS9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,CAUzF;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,cAAc,CAAC,CAAC,EAC1E,iBAAiB,CAAC,EAAE,MAAM,GACzB,2BAA2B,CAiC7B"}

package/dist/service-helpers.js

@@ -0,0 +1,161 @@
+import { isCatalogBackedTripComponent } from "./catalog-component-adapter.js";
+import { TripsInvariantError } from "./service-types.js";
+import { isAllowedTripComponentStatusTransition, isTerminalTripComponentStatus, } from "./validation.js";
+export function hasCommittedComponentReference(component) {
+    return Boolean(component.bookingId ||
+        component.bookingGroupId ||
+        component.orderId ||
+        component.paymentSessionId ||
+        component.providerRef ||
+        component.supplierRef);
+}
+export function assertTripComponentCanBeUpdated(component, patch) {
+    if (isTerminalTripComponentStatus(component.status)) {
+        throw new TripsInvariantError(`Trip component ${component.id} is ${component.status} and cannot be updated`);
+    }
+    if (patch.status && !isAllowedTripComponentStatusTransition(component.status, patch.status)) {
+        throw new TripsInvariantError(`Invalid trip component status transition: ${component.status} -> ${patch.status}`);
+    }
+    if (hasCommittedComponentReference(component) && patch.catalogRef !== undefined) {
+        throw new TripsInvariantError(`Trip component ${component.id} has committed references and cannot change catalog identity`);
+    }
+}
+export function assertTripComponentCanReceiveRefs(component, refs) {
+    if (isTerminalTripComponentStatus(component.status)) {
+        throw new TripsInvariantError(`Trip component ${component.id} is ${component.status} and cannot receive references`);
+    }
+    if (hasCommittedComponentReference(component) &&
+        refs.committedRef &&
+        Object.keys(refs.committedRef).length > 0) {
+        throw new TripsInvariantError(`Trip component ${component.id} already has committed references`);
+    }
+}
+export function assertTripComponentCanBeReserved(component, now = new Date()) {
+    if (component.status !== "priced") {
+        throw new TripsInvariantError(`Trip component ${component.id} is ${component.status} and must be priced before reserve`);
+    }
+    if (!isCatalogBackedTripComponent(component)) {
+        throw new TripsInvariantError(`Trip component ${component.id} is not a catalog-backed booking component`);
+    }
+    if (!component.pricingSnapshot) {
+        throw new TripsInvariantError(`Trip component ${component.id} has no pricing snapshot to reserve`);
+    }
+    if (component.priceExpiresAt && component.priceExpiresAt.getTime() <= now.getTime()) {
+        throw new TripsInvariantError(`Trip component ${component.id} price has expired`);
+    }
+}
+export function reserveResultToComponentPatch(result) {
+    const patch = {
+        status: result.status,
+    };
+    if (result.bookingId !== undefined)
+        patch.bookingId = result.bookingId;
+    if (result.bookingGroupId !== undefined)
+        patch.bookingGroupId = result.bookingGroupId;
+    if (result.orderId !== undefined)
+        patch.orderId = result.orderId;
+    if (result.paymentSessionId !== undefined)
+        patch.paymentSessionId = result.paymentSessionId;
+    if (result.providerRef !== undefined)
+        patch.providerRef = result.providerRef;
+    if (result.supplierRef !== undefined)
+        patch.supplierRef = result.supplierRef;
+    if (result.holdToken !== undefined)
+        patch.holdToken = result.holdToken;
+    if (result.holdExpiresAt !== undefined)
+        patch.holdExpiresAt = new Date(result.holdExpiresAt);
+    return patch;
+}
+export function shouldReplayReserve(envelope, idempotencyKey) {
+    return Boolean(idempotencyKey &&
+        envelope.reserveIdempotencyKey === idempotencyKey &&
+        ["reserved", "checkout_started", "booked"].includes(envelope.status));
+}
+export function shouldReplayCheckout(envelope, idempotencyKey) {
+    return Boolean(idempotencyKey &&
+        envelope.checkoutIdempotencyKey === idempotencyKey &&
+        ["checkout_started", "booked"].includes(envelope.status));
+}
+export function assertTripComponentCanStartCheckout(component, now = new Date()) {
+    if (component.status !== "held" && component.status !== "booked") {
+        throw new TripsInvariantError(`Trip component ${component.id} is ${component.status} and must be held or booked before checkout`);
+    }
+    if (!component.bookingId && !component.orderId) {
+        throw new TripsInvariantError(`Trip component ${component.id} has no booking/order reference for checkout`);
+    }
+    if (component.holdExpiresAt && component.holdExpiresAt.getTime() <= now.getTime()) {
+        throw new TripsInvariantError(`Trip component ${component.id} hold has expired`);
+    }
+}
+export function checkoutResultToComponentPatch(result) {
+    const patch = {
+        status: result.status ?? "checkout_started",
+    };
+    if (result.bookingId !== undefined)
+        patch.bookingId = result.bookingId;
+    if (result.bookingGroupId !== undefined)
+        patch.bookingGroupId = result.bookingGroupId;
+    if (result.orderId !== undefined)
+        patch.orderId = result.orderId;
+    if (result.paymentSessionId !== undefined)
+        patch.paymentSessionId = result.paymentSessionId;
+    if (result.providerRef !== undefined)
+        patch.providerRef = result.providerRef;
+    if (result.supplierRef !== undefined)
+        patch.supplierRef = result.supplierRef;
+    return patch;
+}
+export function pricingSnapshotFromBreakdown(pricing, priceExpiresAt, warnings) {
+    return {
+        currency: pricing.currency,
+        subtotalAmountCents: pricing.subtotal,
+        taxAmountCents: pricing.taxTotal,
+        totalAmountCents: pricing.total,
+        priceExpiresAt,
+        warnings,
+    };
+}
+export function taxLinesFromBreakdown(pricing) {
+    return pricing.taxes.map((tax) => ({
+        code: tax.code,
+        label: tax.label,
+        amountCents: tax.amount,
+        baseAmountCents: tax.base,
+        rate: tax.rate,
+        includedInPrice: tax.includedInPrice,
+        source: tax.scope,
+    }));
+}
+export function aggregateComponentPricing(components, preferredCurrency) {
+    const priced = components.filter((component) => component.pricingSnapshot);
+    const currency = preferredCurrency ?? priced[0]?.pricingSnapshot?.currency ?? "EUR";
+    const warnings = new Set();
+    let subtotalAmountCents = 0;
+    let taxAmountCents = 0;
+    let totalAmountCents = 0;
+    for (const component of priced) {
+        const snapshot = component.pricingSnapshot;
+        if (!snapshot)
+            continue;
+        if (snapshot.currency !== currency) {
+            warnings.add(`currency_mismatch:${snapshot.currency}`);
+            continue;
+        }
+        subtotalAmountCents += snapshot.subtotalAmountCents;
+        taxAmountCents += snapshot.taxAmountCents;
+        totalAmountCents += snapshot.totalAmountCents;
+        for (const warning of snapshot.warnings ?? [])
+            warnings.add(warning);
+        for (const warning of component.warningCodes ?? [])
+            warnings.add(warning);
+    }
+    return {
+        currency,
+        subtotalAmountCents,
+        taxAmountCents,
+        totalAmountCents,
+        componentCount: components.length,
+        pricedComponentCount: priced.length,
+        warnings: [...warnings],
+    };
+}

package/dist/service-internals.d.ts

@@ -0,0 +1,11 @@
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { NewTripComponentEvent, TripComponent } from "./schema.js";
+import type { TripComponentStatus } from "./validation.js";
+export declare function createComponentEvent(db: AnyDrizzleDb, data: Omit<NewTripComponentEvent, "id" | "occurredAt">): Promise<void>;
+export declare function statusToEventType(to: TripComponentStatus): NewTripComponentEvent["eventType"];
+export declare function appendWarningCodes(existing: string[], incoming: string[]): string[];
+export declare function markComponentForStaffRemediation(db: AnyDrizzleDb, component: TripComponent, reason: string): Promise<TripComponent>;
+export declare function commonString(values: Array<string | undefined>): string | undefined;
+export declare function minComponentPriceExpiry(components: TripComponent[]): Date | null;
+export declare function minComponentHoldExpiry(components: TripComponent[]): Date | null;
+//# sourceMappingURL=service-internals.d.ts.map

package/dist/service-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-internals.d.ts","sourceRoot":"","sources":["../src/service-internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,iBAGvD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAoB7F;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEnF;AAED,wBAAsB,gCAAgC,CACpD,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CA2BxB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,IAAI,CAMhF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,IAAI,CAM/E"}

package/dist/service-internals.js

@@ -0,0 +1,72 @@
+import { eq } from "drizzle-orm";
+import { tripComponentEvents, tripComponents } from "./schema.js";
+export async function createComponentEvent(db, data) {
+    await db.insert(tripComponentEvents).values(data);
+}
+export function statusToEventType(to) {
+    switch (to) {
+        case "priced":
+        case "unavailable":
+            return "priced";
+        case "held":
+            return "hold_placed";
+        case "booked":
+            return "booked";
+        case "checkout_started":
+            return "checkout_started";
+        case "failed":
+            return "failed";
+        case "cancelled":
+            return "cancelled";
+        case "removed":
+            return "removed";
+        case "draft":
+            return "updated";
+    }
+}
+export function appendWarningCodes(existing, incoming) {
+    return [...new Set([...existing, ...incoming])];
+}
+export async function markComponentForStaffRemediation(db, component, reason) {
+    const [updated] = (await db
+        .update(tripComponents)
+        .set({
+        warningCodes: appendWarningCodes(component.warningCodes, [
+            "staff_remediation_required",
+            reason,
+        ]),
+        updatedAt: new Date(),
+    })
+        .where(eq(tripComponents.id, component.id))
+        .returning());
+    if (!updated) {
+        throw new Error(`markComponentForStaffRemediation: update returned no row for ${component.id}`);
+    }
+    await createComponentEvent(db, {
+        envelopeId: updated.envelopeId,
+        componentId: updated.id,
+        eventType: "staff_remediation_required",
+        fromStatus: component.status,
+        toStatus: updated.status,
+        payload: { reason },
+    });
+    return updated;
+}
+export function commonString(values) {
+    const unique = [...new Set(values.filter((value) => Boolean(value)))];
+    return unique.length === 1 ? unique[0] : undefined;
+}
+export function minComponentPriceExpiry(components) {
+    const expiries = components
+        .map((component) => component.priceExpiresAt)
+        .filter((value) => value instanceof Date)
+        .sort((a, b) => a.getTime() - b.getTime());
+    return expiries[0] ?? null;
+}
+export function minComponentHoldExpiry(components) {
+    const expiries = components
+        .map((component) => component.holdExpiresAt)
+        .filter((value) => value instanceof Date)
+        .sort((a, b) => a.getTime() - b.getTime());
+    return expiries[0] ?? null;
+}

package/dist/service-pricing.d.ts

@@ -0,0 +1,8 @@
+import type { QuoteResponseV1 } from "@voyant-travel/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { TripComponent } from "./schema.js";
+import type { PriceTripDeps, PriceTripResult } from "./service-types.js";
+import type { PriceTripInput } from "./validation.js";
+export declare function priceTrip(db: AnyDrizzleDb, input: PriceTripInput, deps: PriceTripDeps): Promise<PriceTripResult>;
+export declare function applyQuoteToComponent(db: AnyDrizzleDb, component: TripComponent, quote: QuoteResponseV1): Promise<TripComponent>;
+//# sourceMappingURL=service-pricing.d.ts.map

package/dist/service-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-pricing.d.ts","sourceRoot":"","sources":["../src/service-pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAA;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAA;AAU9D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAExE,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,iBAAiB,CAAA;AAE1E,wBAAsB,SAAS,CAC7B,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CA0E1B;AAED,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,aAAa,CAAC,CA8CxB"}