@voyantjs/travel-composer 0.55.0

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 { TravelComposerInvariantError } 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 TravelComposerInvariantError(`Trip envelope ${input.envelopeId} was not found`);
+    }
+    if (shouldReplayCheckout(trip.envelope, input.idempotencyKey)) {
+        return replayCheckoutResult(trip);
+    }
+    if (trip.envelope.status !== "reserved") {
+        throw new TravelComposerInvariantError(`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 TravelComposerInvariantError("completeTripCheckout requires an envelopeId or paymentSessionId");
+    }
+    const trip = await findTripForCheckoutCompletion(db, input);
+    if (!trip)
+        return null;
+    if (!payableEnvelopeStatuses.has(trip.envelope.status)) {
+        throw new TravelComposerInvariantError(`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 TravelComposerInvariantError(`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 TravelComposerInvariantError(`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-drafts.d.ts

@@ -0,0 +1,13 @@
+import type { AnyDrizzleDb } from "@voyantjs/db";
+import type { TripComponent, TripEnvelope } from "./schema.js";
+import { type TripDraft } from "./service-types.js";
+import type { CreateTripComponentInput, CreateTripEnvelopeInput, ReorderTripComponentsInput, UpdateTripComponentInput, UpdateTripComponentRefsInput, UpdateTripEnvelopeInput } from "./validation.js";
+export declare function createDraft(db: AnyDrizzleDb, input: CreateTripEnvelopeInput): Promise<TripDraft>;
+export declare function getDraft(db: AnyDrizzleDb, envelopeId: string): Promise<TripDraft | null>;
+export declare function updateDraft(db: AnyDrizzleDb, envelopeId: string, input: UpdateTripEnvelopeInput): Promise<TripEnvelope | null>;
+export declare function addComponent(db: AnyDrizzleDb, input: CreateTripComponentInput): Promise<TripComponent>;
+export declare function updateComponent(db: AnyDrizzleDb, componentId: string, input: UpdateTripComponentInput): Promise<TripComponent | null>;
+export declare function updateComponentRefs(db: AnyDrizzleDb, componentId: string, input: UpdateTripComponentRefsInput): Promise<TripComponent | null>;
+export declare function removeComponent(db: AnyDrizzleDb, componentId: string): Promise<TripComponent | null>;
+export declare function reorderComponents(db: AnyDrizzleDb, input: ReorderTripComponentsInput): Promise<TripComponent[]>;
+//# sourceMappingURL=service-drafts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-drafts.d.ts","sourceRoot":"","sources":["../src/service-drafts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EAAqC,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAOjG,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,iBAAiB,CAAA;AAExB,wBAAsB,WAAW,CAC/B,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAcpB;AAED,wBAAsB,QAAQ,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAe9F;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkB9B;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAmCxB;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgC/B;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,YAAY,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA8B/B;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAE/B;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,aAAa,EAAE,CAAC,CAoC1B"}

package/dist/service-drafts.js

@@ -0,0 +1,223 @@
+import { asc, eq, inArray } from "drizzle-orm";
+import { tripComponents, tripEnvelopes } from "./schema.js";
+import { assertTripComponentCanBeUpdated, assertTripComponentCanReceiveRefs, } from "./service-helpers.js";
+import { createComponentEvent, statusToEventType } from "./service-internals.js";
+import { TravelComposerInvariantError } from "./service-types.js";
+export async function createDraft(db, input) {
+    const values = {
+        title: input.title,
+        description: input.description,
+        travelerParty: input.travelerParty,
+        constraints: input.constraints,
+        createdBy: input.createdBy,
+        updatedBy: input.createdBy,
+    };
+    const [envelope] = (await db.insert(tripEnvelopes).values(values).returning());
+    if (!envelope)
+        throw new Error("createDraft: insert returned no envelope");
+    return { envelope, components: [] };
+}
+export async function getDraft(db, envelopeId) {
+    const [envelope] = (await db
+        .select()
+        .from(tripEnvelopes)
+        .where(eq(tripEnvelopes.id, envelopeId))
+        .limit(1));
+    if (!envelope)
+        return null;
+    const components = (await db
+        .select()
+        .from(tripComponents)
+        .where(eq(tripComponents.envelopeId, envelopeId))
+        .orderBy(asc(tripComponents.sequence), asc(tripComponents.createdAt)));
+    return { envelope, components };
+}
+export async function updateDraft(db, envelopeId, input) {
+    const updates = {
+        updatedAt: new Date(),
+    };
+    if (input.title !== undefined)
+        updates.title = input.title;
+    if (input.description !== undefined)
+        updates.description = input.description;
+    if (input.travelerParty !== undefined)
+        updates.travelerParty = input.travelerParty;
+    if (input.constraints !== undefined)
+        updates.constraints = input.constraints;
+    if (input.status !== undefined)
+        updates.status = input.status;
+    if (input.updatedBy !== undefined)
+        updates.updatedBy = input.updatedBy;
+    const [row] = (await db
+        .update(tripEnvelopes)
+        .set(updates)
+        .where(eq(tripEnvelopes.id, envelopeId))
+        .returning());
+    return row ?? null;
+}
+export async function addComponent(db, input) {
+    const values = {
+        envelopeId: input.envelopeId,
+        sequence: input.sequence,
+        kind: input.kind,
+        title: input.title,
+        description: input.description,
+        entityModule: input.catalogRef?.entityModule,
+        entityId: input.catalogRef?.entityId,
+        sourceKind: input.catalogRef?.sourceKind,
+        sourceConnectionId: input.catalogRef?.sourceConnectionId,
+        sourceRef: input.catalogRef?.sourceRef,
+        componentCurrency: input.estimatedPricing?.currency,
+        componentSubtotalAmountCents: input.estimatedPricing?.subtotalAmountCents,
+        componentTaxAmountCents: input.estimatedPricing?.taxAmountCents,
+        componentTotalAmountCents: input.estimatedPricing?.totalAmountCents,
+        pricingSnapshot: input.estimatedPricing,
+        metadata: input.metadata,
+    };
+    const [component] = (await db
+        .insert(tripComponents)
+        .values(values)
+        .returning());
+    if (!component)
+        throw new Error("addComponent: insert returned no component");
+    await createComponentEvent(db, {
+        envelopeId: component.envelopeId,
+        componentId: component.id,
+        eventType: "created",
+        toStatus: component.status,
+        payload: {},
+    });
+    return component;
+}
+export async function updateComponent(db, componentId, input) {
+    const existing = await getTripComponentOrThrow(db, componentId);
+    assertTripComponentCanBeUpdated(existing, input);
+    const updates = {
+        updatedAt: new Date(),
+        ...toCatalogRefPatch(input.catalogRef),
+    };
+    if (input.sequence !== undefined)
+        updates.sequence = input.sequence;
+    if (input.status !== undefined)
+        updates.status = input.status;
+    if (input.title !== undefined)
+        updates.title = input.title;
+    if (input.description !== undefined)
+        updates.description = input.description;
+    if (input.metadata !== undefined)
+        updates.metadata = input.metadata;
+    if (input.warningCodes !== undefined)
+        updates.warningCodes = input.warningCodes;
+    const [component] = (await db
+        .update(tripComponents)
+        .set(updates)
+        .where(eq(tripComponents.id, componentId))
+        .returning());
+    if (!component)
+        return null;
+    await createComponentEvent(db, {
+        envelopeId: component.envelopeId,
+        componentId: component.id,
+        eventType: input.status ? statusToEventType(input.status) : "updated",
+        fromStatus: existing.status,
+        toStatus: component.status,
+        payload: {},
+    });
+    return component;
+}
+export async function updateComponentRefs(db, componentId, input) {
+    const existing = await getTripComponentOrThrow(db, componentId);
+    assertTripComponentCanReceiveRefs(existing, input);
+    const updates = {
+        updatedAt: new Date(),
+    };
+    if (input.bookingDraftId !== undefined)
+        updates.bookingDraftId = input.bookingDraftId;
+    if (input.catalogQuoteId !== undefined)
+        updates.catalogQuoteId = input.catalogQuoteId;
+    if (input.committedRef?.bookingId !== undefined)
+        updates.bookingId = input.committedRef.bookingId;
+    if (input.committedRef?.bookingGroupId !== undefined) {
+        updates.bookingGroupId = input.committedRef.bookingGroupId;
+    }
+    if (input.committedRef?.orderId !== undefined)
+        updates.orderId = input.committedRef.orderId;
+    if (input.committedRef?.paymentSessionId !== undefined) {
+        updates.paymentSessionId = input.committedRef.paymentSessionId;
+    }
+    if (input.committedRef?.providerRef !== undefined) {
+        updates.providerRef = input.committedRef.providerRef;
+    }
+    if (input.committedRef?.supplierRef !== undefined) {
+        updates.supplierRef = input.committedRef.supplierRef;
+    }
+    const [component] = (await db
+        .update(tripComponents)
+        .set(updates)
+        .where(eq(tripComponents.id, componentId))
+        .returning());
+    return component ?? null;
+}
+export async function removeComponent(db, componentId) {
+    return updateComponent(db, componentId, { status: "removed" });
+}
+export async function reorderComponents(db, input) {
+    const rows = (await db
+        .select()
+        .from(tripComponents)
+        .where(inArray(tripComponents.id, input.componentIds)));
+    const found = new Set(rows.map((row) => row.id));
+    const missing = input.componentIds.filter((id) => !found.has(id));
+    if (missing.length > 0) {
+        throw new TravelComposerInvariantError(`Cannot reorder missing trip components: ${missing.join(", ")}`);
+    }
+    for (const row of rows) {
+        if (row.envelopeId !== input.envelopeId) {
+            throw new TravelComposerInvariantError(`Trip component ${row.id} does not belong to envelope ${input.envelopeId}`);
+        }
+        if (row.status === "removed") {
+            throw new TravelComposerInvariantError(`Trip component ${row.id} is removed`);
+        }
+    }
+    const updated = [];
+    for (const [sequence, componentId] of input.componentIds.entries()) {
+        const [row] = (await db
+            .update(tripComponents)
+            .set({ sequence, updatedAt: new Date() })
+            .where(eq(tripComponents.id, componentId))
+            .returning());
+        if (row)
+            updated.push(row);
+    }
+    return updated.sort((a, b) => a.sequence - b.sequence);
+}
+function toCatalogRefPatch(input) {
+    if (input === undefined)
+        return {};
+    if (input === null) {
+        return {
+            entityModule: null,
+            entityId: null,
+            sourceKind: null,
+            sourceConnectionId: null,
+            sourceRef: null,
+        };
+    }
+    return {
+        entityModule: input.entityModule,
+        entityId: input.entityId,
+        sourceKind: input.sourceKind,
+        sourceConnectionId: input.sourceConnectionId ?? null,
+        sourceRef: input.sourceRef ?? null,
+    };
+}
+async function getTripComponentOrThrow(db, id) {
+    const [component] = (await db
+        .select()
+        .from(tripComponents)
+        .where(eq(tripComponents.id, id))
+        .limit(1));
+    if (!component)
+        throw new TravelComposerInvariantError(`Trip component ${id} was not found`);
+    return component;
+}

package/dist/service-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { PricingBreakdownV1 } from "@voyantjs/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,kCAAkC,CAAA;AAG1E,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,CAgBN;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"}