@voyant-travel/trips 0.110.2

package/dist/service-types.d.ts

@@ -0,0 +1,285 @@
+import type { BookingDraftV1, QuoteResponseV1 } from "@voyant-travel/catalog/booking-engine";
+import type { CatalogComponentBookingDraftOverrides } from "./catalog-component-adapter.js";
+import type { TripComponent, TripEnvelope, TripReservationPlan } from "./schema.js";
+import type { PriceTripInput, StartTripCheckoutInput, TripComponentStatus } from "./validation.js";
+export interface Trip {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+}
+export interface TripListResult {
+    data: Trip[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface PriceTripResult {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+    pricing: {
+        currency: string;
+        subtotalAmountCents: number;
+        taxAmountCents: number;
+        totalAmountCents: number;
+        componentCount: number;
+        pricedComponentCount: number;
+        warnings?: string[];
+    };
+    warnings: string[];
+    failures: Array<{
+        componentId: string;
+        reason: string;
+    }>;
+}
+export interface CatalogComponentQuoteInput {
+    component: TripComponent;
+    bookingDraft: BookingDraftV1;
+    scope: PriceTripInput["scope"];
+    ttlMs?: number;
+}
+export interface PriceTripDeps {
+    quoteCatalogComponent: (input: CatalogComponentQuoteInput) => Promise<QuoteResponseV1>;
+    componentBookingDraftOverrides?: Record<string, CatalogComponentBookingDraftOverrides>;
+}
+export interface ReserveComponentInput {
+    envelope: TripEnvelope;
+    component: TripComponent;
+    reservationPlanId?: string | null;
+}
+export interface ReserveComponentResult {
+    status: "held" | "booked";
+    bookingId?: string;
+    bookingGroupId?: string;
+    orderId?: string;
+    paymentSessionId?: string;
+    providerRef?: string;
+    supplierRef?: string;
+    holdToken?: string;
+    holdExpiresAt?: string;
+    warnings?: string[];
+}
+export type ReserveComponentPreflightStatus = "ok" | "price_changed" | "unavailable" | "expired";
+export interface ReserveComponentPreflightResult {
+    status: ReserveComponentPreflightStatus;
+    reason?: string;
+    warnings?: string[];
+    details?: Record<string, unknown>;
+}
+export interface ReleaseReservedComponentInput {
+    component: TripComponent;
+    reserveResult: ReserveComponentResult;
+}
+export interface ReleaseReservedComponentResult {
+    released: boolean;
+    reason?: string;
+}
+export type TripReservationPlanComponentKind = "catalog_backed" | "non_catalog";
+export interface SubmitTripReservationPlanComponent {
+    componentId: string;
+    reservationKind: TripReservationPlanComponentKind;
+    component: TripComponent;
+}
+export interface SubmitTripReservationPlanInput {
+    reservationPlan: TripReservationPlan;
+    envelope: TripEnvelope;
+    components: SubmitTripReservationPlanComponent[];
+    idempotencyKey?: string | null;
+}
+export interface SubmitTripReservationPlanResult {
+    reservationPlanId: string;
+    status: "reserved" | "failed";
+    reserved: Array<{
+        componentId: string;
+        status: "held" | "booked";
+        result: ReserveComponentResult;
+    }>;
+    failures: Array<{
+        componentId: string;
+        reason: string;
+        code?: string;
+        details?: Record<string, unknown>;
+    }>;
+    compensations: Array<{
+        componentId: string;
+        status: "released" | "release_failed" | "release_not_configured";
+        reason?: string;
+    }>;
+    warnings: string[];
+}
+export interface ReserveTripDeps {
+    quoteCatalogComponentBeforeReserve?: (input: CatalogComponentQuoteInput) => Promise<QuoteResponseV1>;
+    validateNonCatalogComponentBeforeReserve?: (input: ReserveComponentInput) => Promise<ReserveComponentPreflightResult | null | undefined>;
+    submitReservationPlan: (input: SubmitTripReservationPlanInput) => Promise<SubmitTripReservationPlanResult>;
+}
+export interface ReserveTripResult {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+    reservationPlanId?: string | null;
+    reserved: Array<{
+        componentId: string;
+        status: "held" | "booked";
+    }>;
+    failures: Array<{
+        componentId: string;
+        reason: string;
+        code?: string;
+        details?: Record<string, unknown>;
+    }>;
+    compensations: Array<{
+        componentId: string;
+        status: "released" | "release_failed" | "release_not_configured";
+        reason?: string;
+    }>;
+    warnings: string[];
+}
+export type CheckoutHandoffKind = "card_redirect" | "payment_session" | "bank_transfer_instructions" | "hold_placed" | "inquiry_received";
+export interface ComponentCheckoutInput {
+    envelope: TripEnvelope;
+    component: TripComponent;
+    intent: StartTripCheckoutInput["intent"];
+    request: StartTripCheckoutInput["request"];
+}
+export interface ComponentCheckoutResult {
+    kind: CheckoutHandoffKind;
+    status?: "checkout_started" | "booked";
+    bookingId?: string;
+    bookingGroupId?: string;
+    orderId?: string;
+    paymentSessionId?: string;
+    providerRef?: string;
+    supplierRef?: string;
+    checkoutUrl?: string | null;
+    externalReference?: string | null;
+    bankTransferInstructions?: Record<string, unknown> | null;
+    expiresAt?: string | null;
+    warnings?: string[];
+}
+export interface TripCheckoutInput {
+    trip: Trip;
+    intent: StartTripCheckoutInput["intent"];
+    request: StartTripCheckoutInput["request"];
+}
+export interface TripCheckoutResult {
+    kind: CheckoutHandoffKind;
+    status?: "checkout_started" | "booked";
+    paymentSessionId?: string;
+    checkoutUrl?: string | null;
+    bankTransferInstructions?: Record<string, unknown> | null;
+    expiresAt?: string | null;
+    warnings?: string[];
+}
+export interface StartCheckoutDeps {
+    startTripCheckout?: (input: TripCheckoutInput) => Promise<TripCheckoutResult>;
+    startComponentCheckout: (input: ComponentCheckoutInput) => Promise<ComponentCheckoutResult>;
+}
+export interface StartedTripComponentCheckout {
+    componentId: string;
+    kind: CheckoutHandoffKind;
+    bookingId: string | null;
+    orderId: string | null;
+    paymentSessionId: string | null;
+    checkoutUrl: string | null;
+    bankTransferInstructions: Record<string, unknown> | null;
+    expiresAt: string | null;
+}
+export interface StartCheckoutTarget {
+    envelopeId: string;
+    status: "checkout_started";
+    currency: string;
+    totalAmountCents: number;
+    paymentSessionId: string | null;
+    checkoutUrl: string | null;
+    holdExpiresAt: string | null;
+}
+export interface StartCheckoutResult {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+    target: StartCheckoutTarget;
+    componentCheckouts: StartedTripComponentCheckout[];
+    failures: Array<{
+        componentId: string;
+        reason: string;
+    }>;
+    warnings: string[];
+}
+export interface CompleteTripCheckoutInput {
+    envelopeId?: string;
+    paymentSessionId?: string;
+    paidAt?: string;
+    actorId?: string | null;
+    payload?: Record<string, unknown>;
+}
+export interface CompleteTripCheckoutResult {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+    updatedComponentIds: string[];
+    alreadyCompleted: boolean;
+}
+export type ComponentCancellationAction = "cancel" | "no_op" | "staff_remediation";
+export interface ComponentCancellationPreviewInput {
+    envelope: TripEnvelope;
+    component: TripComponent;
+    reason?: string;
+    requestedAt: Date;
+    request: Record<string, unknown>;
+}
+export interface ComponentCancellationPreview {
+    componentId: string;
+    action: ComponentCancellationAction;
+    currentStatus: TripComponentStatus;
+    staffActionRequired: boolean;
+    reason?: string;
+    refundAmountCents?: number;
+    refundCurrency?: string;
+    penaltyAmountCents?: number;
+    supplierCancellationDeadline?: string | null;
+    policySummary?: string | null;
+    snapshot?: Record<string, unknown>;
+}
+export interface PreviewTripCancellationDeps {
+    previewComponentCancellation?: (input: ComponentCancellationPreviewInput) => Promise<ComponentCancellationPreview>;
+}
+export interface TripCancellationPreviewResult {
+    envelope: TripEnvelope;
+    components: TripComponent[];
+    preview: {
+        envelopeId: string;
+        selectedComponentIds: string[];
+        currency: string | null;
+        estimatedRefundAmountCents: number;
+        estimatedPenaltyAmountCents: number;
+        staffActionRequired: boolean;
+        components: ComponentCancellationPreview[];
+        warnings: string[];
+    };
+}
+export interface CancelComponentInput extends ComponentCancellationPreviewInput {
+    preview: ComponentCancellationPreview;
+}
+export interface CancelComponentResult {
+    status: "cancelled" | "refused" | "failed";
+    refundAmountCents?: number;
+    refundCurrency?: string;
+    reason?: string;
+    snapshot?: Record<string, unknown>;
+}
+export interface CancelTripComponentsDeps extends PreviewTripCancellationDeps {
+    cancelComponent?: (input: CancelComponentInput) => Promise<CancelComponentResult>;
+}
+export interface CancelTripComponentsResult extends TripCancellationPreviewResult {
+    cancelled: Array<{
+        componentId: string;
+        status: "cancelled";
+    }>;
+    remediation: Array<{
+        componentId: string;
+        reason: string;
+    }>;
+    skipped: Array<{
+        componentId: string;
+        reason: string;
+    }>;
+}
+export declare class TripsInvariantError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=service-types.d.ts.map

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

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

package/dist/service-types.js

@@ -0,0 +1,6 @@
+export class TripsInvariantError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TripsInvariantError";
+    }
+}

package/dist/service.d.ts

@@ -0,0 +1,38 @@
+import type { TripsStatus } from "./validation.js";
+export { cancelComponents, previewCancellation } from "./service-cancellation.js";
+export { completeTripCheckout, startCheckout } from "./service-checkout.js";
+export { aggregateComponentPricing, assertTripComponentCanBeReserved, assertTripComponentCanBeUpdated, assertTripComponentCanReceiveRefs, assertTripComponentCanStartCheckout, checkoutResultToComponentPatch, hasCommittedComponentReference, pricingSnapshotFromBreakdown, reserveResultToComponentPatch, shouldReplayCheckout, shouldReplayReserve, taxLinesFromBreakdown, } from "./service-helpers.js";
+export { applyQuoteToComponent, priceTrip } from "./service-pricing.js";
+export { reserveTrip } from "./service-reservation.js";
+export { buildTripSnapshotProposal, freezeTripSnapshot, getTripSnapshotById, listTripSnapshots, } from "./service-snapshots.js";
+export { addComponent, createTrip, getTrip, listTrips, removeComponent, reorderComponents, updateComponent, updateComponentRefs, updateTrip, } from "./service-trips.js";
+export type { CancelComponentInput, CancelComponentResult, CancelTripComponentsDeps, CancelTripComponentsResult, CatalogComponentQuoteInput, CheckoutHandoffKind, CompleteTripCheckoutInput, CompleteTripCheckoutResult, ComponentCancellationAction, ComponentCancellationPreview, ComponentCancellationPreviewInput, ComponentCheckoutInput, ComponentCheckoutResult, PreviewTripCancellationDeps, PriceTripDeps, PriceTripResult, ReleaseReservedComponentInput, ReleaseReservedComponentResult, ReserveComponentInput, ReserveComponentPreflightResult, ReserveComponentPreflightStatus, ReserveComponentResult, ReserveTripDeps, ReserveTripResult, StartCheckoutDeps, StartCheckoutResult, StartCheckoutTarget, StartedTripComponentCheckout, SubmitTripReservationPlanComponent, SubmitTripReservationPlanInput, SubmitTripReservationPlanResult, Trip, TripCancellationPreviewResult, TripCheckoutInput, TripCheckoutResult, TripListResult, TripReservationPlanComponentKind, } from "./service-types.js";
+export { TripsInvariantError } from "./service-types.js";
+import { cancelComponents, previewCancellation } from "./service-cancellation.js";
+import { completeTripCheckout, startCheckout } from "./service-checkout.js";
+import { priceTrip } from "./service-pricing.js";
+import { reserveTrip } from "./service-reservation.js";
+import { freezeTripSnapshot, getTripSnapshotById, listTripSnapshots } from "./service-snapshots.js";
+import { addComponent, createTrip, getTrip, listTrips, removeComponent, reorderComponents, updateComponent, updateComponentRefs, updateTrip } from "./service-trips.js";
+export declare const tripsService: {
+    getStatus(): TripsStatus;
+    createTrip: typeof createTrip;
+    getTrip: typeof getTrip;
+    listTrips: typeof listTrips;
+    updateTrip: typeof updateTrip;
+    addComponent: typeof addComponent;
+    updateComponent: typeof updateComponent;
+    updateComponentRefs: typeof updateComponentRefs;
+    removeComponent: typeof removeComponent;
+    reorderComponents: typeof reorderComponents;
+    priceTrip: typeof priceTrip;
+    reserveTrip: typeof reserveTrip;
+    freezeTripSnapshot: typeof freezeTripSnapshot;
+    getTripSnapshotById: typeof getTripSnapshotById;
+    listTripSnapshots: typeof listTripSnapshots;
+    startCheckout: typeof startCheckout;
+    completeTripCheckout: typeof completeTripCheckout;
+    previewCancellation: typeof previewCancellation;
+    cancelComponents: typeof cancelComponents;
+};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,EACjC,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,UAAU,GACX,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,aAAa,EACb,eAAe,EACf,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,+BAA+B,EAC/B,+BAA+B,EAC/B,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,kCAAkC,EAClC,8BAA8B,EAC9B,+BAA+B,EAC/B,IAAI,EACJ,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,gCAAgC,GACjC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACnG,OAAO,EACL,YAAY,EACZ,UAAU,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACX,MAAM,oBAAoB,CAAA;AAE3B,eAAO,MAAM,YAAY;iBACV,WAAW;;;;;;;;;;;;;;;;;;;CAwBzB,CAAA"}

package/dist/service.js

@@ -0,0 +1,40 @@
+export { cancelComponents, previewCancellation } from "./service-cancellation.js";
+export { completeTripCheckout, startCheckout } from "./service-checkout.js";
+export { aggregateComponentPricing, assertTripComponentCanBeReserved, assertTripComponentCanBeUpdated, assertTripComponentCanReceiveRefs, assertTripComponentCanStartCheckout, checkoutResultToComponentPatch, hasCommittedComponentReference, pricingSnapshotFromBreakdown, reserveResultToComponentPatch, shouldReplayCheckout, shouldReplayReserve, taxLinesFromBreakdown, } from "./service-helpers.js";
+export { applyQuoteToComponent, priceTrip } from "./service-pricing.js";
+export { reserveTrip } from "./service-reservation.js";
+export { buildTripSnapshotProposal, freezeTripSnapshot, getTripSnapshotById, listTripSnapshots, } from "./service-snapshots.js";
+export { addComponent, createTrip, getTrip, listTrips, removeComponent, reorderComponents, updateComponent, updateComponentRefs, updateTrip, } from "./service-trips.js";
+export { TripsInvariantError } from "./service-types.js";
+import { cancelComponents, previewCancellation } from "./service-cancellation.js";
+import { completeTripCheckout, startCheckout } from "./service-checkout.js";
+import { priceTrip } from "./service-pricing.js";
+import { reserveTrip } from "./service-reservation.js";
+import { freezeTripSnapshot, getTripSnapshotById, listTripSnapshots } from "./service-snapshots.js";
+import { addComponent, createTrip, getTrip, listTrips, removeComponent, reorderComponents, updateComponent, updateComponentRefs, updateTrip, } from "./service-trips.js";
+export const tripsService = {
+    getStatus() {
+        return {
+            module: "trips",
+            status: "scaffolded",
+        };
+    },
+    createTrip,
+    getTrip,
+    listTrips,
+    updateTrip,
+    addComponent,
+    updateComponent,
+    updateComponentRefs,
+    removeComponent,
+    reorderComponents,
+    priceTrip,
+    reserveTrip,
+    freezeTripSnapshot,
+    getTripSnapshotById,
+    listTripSnapshots,
+    startCheckout,
+    completeTripCheckout,
+    previewCancellation,
+    cancelComponents,
+};

package/dist/traveler-party-validation.d.ts

@@ -0,0 +1,3 @@
+export declare function assertTripTravelerPartyComplete(travelerParty: Record<string, unknown>, context?: string): void;
+export declare function validateTripTravelerParty(travelerParty: Record<string, unknown>): string[];
+//# sourceMappingURL=traveler-party-validation.d.ts.map

package/dist/traveler-party-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traveler-party-validation.d.ts","sourceRoot":"","sources":["../src/traveler-party-validation.ts"],"names":[],"mappings":"AAQA,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,SAAS,GACf,IAAI,CAIN;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CA6C1F"}

package/dist/traveler-party-validation.js

@@ -0,0 +1,68 @@
+import { TripsInvariantError } from "./service-types.js";
+const placeholderEmails = new Set([
+    "noreply@example.com",
+    "tbd@example.com",
+    "traveler@example.com",
+]);
+export function assertTripTravelerPartyComplete(travelerParty, context = "Trip") {
+    const errors = validateTripTravelerParty(travelerParty);
+    if (errors.length === 0)
+        return;
+    throw new TripsInvariantError(`${context} requires ${errors.join(", ")}`);
+}
+export function validateTripTravelerParty(travelerParty) {
+    const errors = [];
+    const billing = asRecord(travelerParty.billing);
+    const contact = asRecord(billing?.contact);
+    const billingEmail = stringValue(contact?.email);
+    const billingFirstName = stringValue(contact?.firstName);
+    const billingLastName = stringValue(contact?.lastName);
+    const billingPersonId = stringValue(billing?.personId);
+    const billingOrganizationId = stringValue(billing?.organizationId);
+    if (!billing) {
+        errors.push("billing information");
+    }
+    else {
+        if (!billingPersonId && !billingOrganizationId && (!billingFirstName || !billingLastName)) {
+            errors.push("a billing person, organization, or full billing contact name");
+        }
+        if (!isRealEmail(billingEmail)) {
+            errors.push("a real billing email");
+        }
+    }
+    const travelers = Array.isArray(travelerParty.travelers)
+        ? travelerParty.travelers
+            .map(asRecord)
+            .filter((traveler) => Boolean(traveler))
+        : [];
+    if (travelers.length === 0) {
+        errors.push("at least one traveler");
+    }
+    travelers.forEach((traveler, index) => {
+        const personId = stringValue(traveler.personId);
+        const firstName = stringValue(traveler.firstName);
+        const lastName = stringValue(traveler.lastName);
+        const email = stringValue(traveler.email);
+        if (!personId && (!firstName || !lastName)) {
+            errors.push(`traveler ${index + 1} name or person record`);
+        }
+        if (email && !isRealEmail(email)) {
+            errors.push(`traveler ${index + 1} real email`);
+        }
+    });
+    return errors;
+}
+function isRealEmail(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(normalized) && !placeholderEmails.has(normalized);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}