@voyant-travel/finance 0.190.0 → 0.192.0

package/dist/card-payment.d.ts

@@ -41,6 +41,9 @@ export interface CardPaymentStartArgs {
     billing: CardPaymentBilling;
     description?: string;
     returnUrl?: string;
+    cancelUrl?: string;
+    shipping?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
 }
 /** Result of a card-payment start: the hosted-payment URL to redirect to. */
 export interface CardPaymentStartResult {
@@ -68,4 +71,16 @@ export interface PaymentAdapterCardPaymentStarterOptions {
      */
     resolveNotifyUrl?(c: Context): string | undefined;
 }
+export interface PaymentAdapterCardPaymentExecution {
+    context: PaymentAdapterRuntimeContext;
+    runtime?: FinanceServiceRuntime;
+    notifyUrl?: string;
+    idempotencyKey?: string;
+}
+/**
+ * Start a payment through a selected adapter without requiring an HTTP
+ * framework context. Package runtimes use this function; the Hono-oriented
+ * starter below remains the checkout-surface convenience wrapper.
+ */
+export declare function startPaymentAdapterCardPayment(adapter: PaymentAdapter, args: CardPaymentStartArgs, execution: PaymentAdapterCardPaymentExecution): Promise<CardPaymentStartResult | null>;
 export declare function createPaymentAdapterCardPaymentStarter(adapter: PaymentAdapter, options?: PaymentAdapterCardPaymentStarterOptions): CardPaymentStarter;

package/dist/card-payment.js

@@ -1,23 +1,56 @@
-import { eq } from "drizzle-orm";
+import { and, eq, isNull, sql } from "drizzle-orm";
+import { applyPaymentAdapterInitiationResult } from "./payment-adapter-events.js";
 import { paymentSessions } from "./schema/payment-sessions.js";
-import { financePaymentSessionCompletionService } from "./service-payment-session-completion.js";
-import { financePaymentSessionService } from "./service-payment-sessions.js";
-export function createPaymentAdapterCardPaymentStarter(adapter, options = {}) {
-    return async (c, args) => {
-        const [session] = await args.db
-            .select()
+const PAYMENT_ADAPTER_INITIATION_CLAIM_KEY = "paymentAdapterInitiationClaim";
+const PAYMENT_ADAPTER_INITIATION_STATE_KEY = "paymentAdapterInitiationState";
+/**
+ * Start a payment through a selected adapter without requiring an HTTP
+ * framework context. Package runtimes use this function; the Hono-oriented
+ * starter below remains the checkout-surface convenience wrapper.
+ */
+export async function startPaymentAdapterCardPayment(adapter, args, execution) {
+    const [initialSession] = await args.db
+        .select()
+        .from(paymentSessions)
+        .where(eq(paymentSessions.id, args.sessionId))
+        .limit(1);
+    if (!initialSession)
+        return null;
+    const idempotencyKey = initialSession.idempotencyKey ?? execution.idempotencyKey ?? `payment:${initialSession.id}`;
+    const [session] = await args.db
+        .update(paymentSessions)
+        .set({
+        status: "processing",
+        idempotencyKey,
+        metadata: sql `coalesce(${paymentSessions.metadata}, '{}'::jsonb) || ${JSON.stringify({
+            [PAYMENT_ADAPTER_INITIATION_CLAIM_KEY]: idempotencyKey,
+            [PAYMENT_ADAPTER_INITIATION_STATE_KEY]: "in_flight",
+        })}::jsonb`,
+        updatedAt: new Date(),
+    })
+        .where(and(eq(paymentSessions.id, args.sessionId), eq(paymentSessions.status, "pending"), isNull(paymentSessions.providerConnectionId), isNull(paymentSessions.providerSessionId), isNull(paymentSessions.providerPaymentId)))
+        .returning();
+    if (!session) {
+        const [continuation] = await args.db
+            .select({ redirectUrl: paymentSessions.redirectUrl })
             .from(paymentSessions)
             .where(eq(paymentSessions.id, args.sessionId))
             .limit(1);
-        if (!session)
-            return null;
-        const idempotencyKey = session.idempotencyKey ?? options.idempotencyKey?.(session.id) ?? `payment:${session.id}`;
-        const notifyUrl = options.resolveNotifyUrl?.(c);
-        const result = await adapter.initiate(options.resolveContext?.(c) ?? { env: c.env }, {
+        return continuation ? { redirectUrl: continuation.redirectUrl } : null;
+    }
+    const metadata = {
+        ...(args.metadata ?? {}),
+        billing: args.billing,
+        ...(execution.notifyUrl ? { notifyUrl: execution.notifyUrl } : {}),
+    };
+    let result;
+    try {
+        result = await adapter.initiate(execution.context, {
             paymentSessionId: session.id,
             money: { amountMinor: session.amountCents, currency: session.currency },
             description: args.description ?? session.notes ?? undefined,
             returnUrl: args.returnUrl ?? session.returnUrl ?? undefined,
+            cancelUrl: args.cancelUrl ?? session.cancelUrl ?? undefined,
             idempotencyKey,
             customer: {
                 email: args.billing.email,
@@ -25,35 +58,35 @@ export function createPaymentAdapterCardPaymentStarter(adapter, options = {}) {
                 firstName: args.billing.firstName,
                 lastName: args.billing.lastName ?? null,
             },
-            ...(notifyUrl ? { metadata: { notifyUrl } } : {}),
+            shipping: args.shipping,
+            metadata,
+        });
+        await applyPaymentAdapterInitiationResult(args.db, session.id, adapter.id, result, { idempotencyKey, claimedAt: session.updatedAt }, execution.runtime);
+    }
+    catch (error) {
+        const retrySafe = adapter.capabilities.idempotencyKeys && adapter.capabilities.retrySafeInitiation;
+        await args.db
+            .update(paymentSessions)
+            .set({
+            status: retrySafe ? "pending" : "processing",
+            metadata: sql `coalesce(${paymentSessions.metadata}, '{}'::jsonb) || ${JSON.stringify({
+                [PAYMENT_ADAPTER_INITIATION_CLAIM_KEY]: retrySafe ? null : idempotencyKey,
+                [PAYMENT_ADAPTER_INITIATION_STATE_KEY]: retrySafe ? "retryable" : "uncertain",
+            })}::jsonb`,
+            updatedAt: new Date(),
+        })
+            .where(and(eq(paymentSessions.id, session.id), eq(paymentSessions.status, "processing"), eq(paymentSessions.idempotencyKey, idempotencyKey), eq(paymentSessions.updatedAt, session.updatedAt), isNull(paymentSessions.providerConnectionId), isNull(paymentSessions.providerSessionId), isNull(paymentSessions.providerPaymentId), sql `${paymentSessions.metadata}->>${PAYMENT_ADAPTER_INITIATION_CLAIM_KEY} = ${idempotencyKey}`));
+        throw error;
+    }
+    return { redirectUrl: result.checkout?.url ?? null };
+}
+export function createPaymentAdapterCardPaymentStarter(adapter, options = {}) {
+    return async (c, args) => {
+        return startPaymentAdapterCardPayment(adapter, args, {
+            context: options.resolveContext?.(c) ?? { env: c.env },
+            runtime: options.resolveRuntime?.(c),
+            notifyUrl: options.resolveNotifyUrl?.(c),
+            idempotencyKey: options.idempotencyKey?.(args.sessionId),
         });
-        const providerData = {
-            providerSessionId: result.processorSessionId ?? undefined,
-            providerPaymentId: result.processorPaymentId ?? undefined,
-            providerPayload: result.raw === undefined ? undefined : { initiation: result.raw },
-            metadata: { paymentAdapterInitiationIdempotencyKey: result.idempotencyKey },
-        };
-        if (result.nextState === "paid" || result.nextState === "authorized") {
-            await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
-                provider: adapter.id,
-                redirectUrl: result.checkout?.url ?? undefined,
-                idempotencyKey,
-            });
-            await financePaymentSessionCompletionService.completePaymentSession(args.db, session.id, {
-                status: result.nextState,
-                captureMode: "automatic",
-                ...providerData,
-            }, options.resolveRuntime?.(c));
-        }
-        else {
-            await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
-                provider: adapter.id,
-                status: result.nextState,
-                redirectUrl: result.checkout?.url ?? undefined,
-                idempotencyKey,
-                ...providerData,
-            });
-        }
-        return { redirectUrl: result.checkout?.url ?? null };
     };
 }

package/dist/checkout-routes.d.ts

@@ -15,6 +15,7 @@ export type CheckoutRoutesOptions = {
     notificationDispatcher?: CheckoutNotificationDispatcher | null;
     resolveNotificationDispatcher?: (bindings: Record<string, unknown>) => CheckoutNotificationDispatcher | null;
     paymentStarters?: Record<string, CheckoutPaymentStarter>;
+    resolveSelectedPaymentStarter?: (bindings: Record<string, unknown>) => CheckoutPaymentStarter | null;
     resolvePaymentStarters?: (bindings: Record<string, unknown>) => Record<string, CheckoutPaymentStarter>;
     bankTransferDetails?: CheckoutBankTransferDetails | null;
     resolveBankTransferDetails?: (bindings: Record<string, unknown>) => CheckoutBankTransferDetails | null;
@@ -31,6 +32,7 @@ export interface CheckoutReminderRunList {
 export type CheckoutRouteRuntime = {
     bindings: Record<string, unknown>;
     notificationDispatcher: CheckoutNotificationDispatcher | null;
+    selectedPaymentStarter: CheckoutPaymentStarter | null;
     paymentStarters: Record<string, CheckoutPaymentStarter>;
     bankTransferDetails: CheckoutBankTransferDetails | null;
     publicCheckoutBaseUrl?: string | null;
@@ -279,6 +281,7 @@ export declare function createCheckoutRoutes(options?: CheckoutRoutesOptions): i
                         targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
                         targetId: string | null;
                         paymentId: string | null;
+                        providerConnectionId: string | null;
                         providerSessionId: string | null;
                         providerPaymentId: string | null;
                         externalReference: string | null;
@@ -518,6 +521,7 @@ export declare function createCheckoutRoutes(options?: CheckoutRoutesOptions): i
                         targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
                         targetId: string | null;
                         paymentId: string | null;
+                        providerConnectionId: string | null;
                         providerSessionId: string | null;
                         providerPaymentId: string | null;
                         externalReference: string | null;
@@ -851,6 +855,7 @@ export declare function createCheckoutAdminRoutes(options?: CheckoutRoutesOption
                         targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
                         targetId: string | null;
                         paymentId: string | null;
+                        providerConnectionId: string | null;
                         providerSessionId: string | null;
                         providerPaymentId: string | null;
                         externalReference: string | null;
@@ -1090,6 +1095,7 @@ export declare function createCheckoutAdminRoutes(options?: CheckoutRoutesOption
                         targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
                         targetId: string | null;
                         paymentId: string | null;
+                        providerConnectionId: string | null;
                         providerSessionId: string | null;
                         providerPaymentId: string | null;
                         externalReference: string | null;

package/dist/checkout-routes.js

@@ -121,7 +121,15 @@ function resolveCheckoutRouteRuntime(bindings, options, container) {
     return buildCheckoutRouteRuntime(bindings, options);
 }
 function assertCheckoutRuntimeSupportsCollection(runtime, input) {
-    if (input.method === "card" && Object.keys(runtime.paymentStarters).length === 0) {
+    if (input.method === "card" && input.startProvider && !input.startProvider.provider) {
+        if (!runtime.selectedPaymentStarter) {
+            throw new CheckoutRouteRuntimeNotConfiguredError();
+        }
+        return;
+    }
+    if (input.method === "card" &&
+        !runtime.selectedPaymentStarter &&
+        Object.keys(runtime.paymentStarters).length === 0) {
         throw new CheckoutRouteRuntimeNotConfiguredError();
     }
 }
@@ -129,6 +137,7 @@ export function buildCheckoutRouteRuntime(bindings, options = {}) {
     return {
         bindings,
         notificationDispatcher: options.resolveNotificationDispatcher?.(bindings) ?? options.notificationDispatcher ?? null,
+        selectedPaymentStarter: options.resolveSelectedPaymentStarter?.(bindings) ?? null,
         paymentStarters: options.resolvePaymentStarters?.(bindings) ?? options.paymentStarters ?? {},
         bankTransferDetails: options.resolveBankTransferDetails?.(bindings) ?? options.bankTransferDetails ?? null,
         publicCheckoutBaseUrl: options.resolvePublicCheckoutBaseUrl?.(bindings) ?? options.publicCheckoutBaseUrl ?? null,

package/dist/checkout-service-plan.d.ts

@@ -105,6 +105,8 @@ export interface CheckoutRuntimeOptions {
     bindings?: Record<string, unknown>;
     bankTransferDetails?: CheckoutBankTransferDetails | null;
     notificationDispatcher?: CheckoutNotificationDispatcher | null;
+    /** Deployment-selected PaymentAdapter bridge. Takes precedence over legacy keyed starters. */
+    selectedPaymentStarter?: CheckoutPaymentStarter | null;
     paymentStarters?: Record<string, CheckoutPaymentStarter>;
     publicCheckoutBaseUrl?: string | null;
 }

package/dist/checkout-service.js

@@ -190,6 +190,27 @@ async function createCollectionInvoice(db, context, plan, notes) {
     return invoice;
 }
 export async function initiateCheckoutCollection(db, bookingId, input, options = {}, runtime = {}) {
+    let providerStarter = null;
+    if (input.startProvider) {
+        if (input.method !== "card") {
+            throw new Error("Provider start is only available for card collections");
+        }
+        // Resolve deployment-owned processor readiness before any checkout read
+        // that may materialize a default payment plan. The selected PaymentAdapter
+        // wins over legacy provider hints; keyed starters remain only for explicit
+        // self-hosted provider requests. A missing adapter is a zero-mutation
+        // failure.
+        const requestedProvider = input.startProvider.provider;
+        providerStarter =
+            runtime.selectedPaymentStarter ??
+                (requestedProvider ? runtime.paymentStarters?.[requestedProvider] : undefined) ??
+                null;
+        if (!providerStarter) {
+            throw new Error(requestedProvider
+                ? `Payment provider "${requestedProvider}" is not configured`
+                : "No payment adapter is selected for card collection");
+        }
+    }
     const context = await loadBookingContext(db, bookingId);
     if (!context)
         return null;
@@ -250,17 +271,13 @@ export async function initiateCheckoutCollection(db, bookingId, input, options =
         }
     }
     if (input.startProvider) {
-        if (input.method !== "card") {
-            throw new Error("Provider start is only available for card collections");
-        }
         if (!paymentSession) {
             throw new Error("No payment session available for provider start");
         }
-        const starter = runtime.paymentStarters?.[input.startProvider.provider];
-        if (!starter) {
-            throw new Error(`Payment provider "${input.startProvider.provider}" is not configured`);
+        if (!providerStarter) {
+            throw new Error("No payment adapter is selected for card collection");
         }
-        providerStart = await starter({
+        providerStart = await providerStarter({
             db,
             bookingId,
             plan,

package/dist/checkout-validation.d.ts

@@ -46,7 +46,7 @@ export declare const checkoutReminderTargetTypeSchema: z.ZodEnum<{
     booking_cancelled_non_payment: "booking_cancelled_non_payment";
 }>;
 export declare const checkoutProviderStartInputSchema: z.ZodObject<{
-    provider: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
     payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>;
 export declare const checkoutNotificationAttachmentSchema: z.ZodObject<{
@@ -249,6 +249,7 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        providerConnectionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         paymentMethod: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
             bank_transfer: "bank_transfer";
             credit_card: "credit_card";
@@ -322,6 +323,7 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        providerConnectionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         paymentMethod: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
             bank_transfer: "bank_transfer";
             credit_card: "credit_card";
@@ -407,7 +409,7 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
         paymentLinkBaseUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
     startProvider: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
         payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -501,6 +503,7 @@ export declare const bootstrapCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        providerConnectionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         paymentMethod: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
             bank_transfer: "bank_transfer";
             credit_card: "credit_card";
@@ -574,6 +577,7 @@ export declare const bootstrapCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        providerConnectionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         paymentMethod: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
             bank_transfer: "bank_transfer";
             credit_card: "credit_card";
@@ -659,7 +663,7 @@ export declare const bootstrapCheckoutCollectionSchema: z.ZodObject<{
         paymentLinkBaseUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
     startProvider: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
         payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -954,6 +958,7 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
             expired: "expired";
         }>;
         provider: z.ZodNullable<z.ZodString>;
+        providerConnectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         providerSessionId: z.ZodNullable<z.ZodString>;
         providerPaymentId: z.ZodNullable<z.ZodString>;
         externalReference: z.ZodNullable<z.ZodString>;
@@ -983,6 +988,7 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
         notes: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, z.ZodTransform<{
         legacyOrderId: string | null;
+        providerConnectionId: string | null;
         target: {
             type: "booking";
             bookingId: string;
@@ -1113,6 +1119,7 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey?: string | null | undefined;
         } | null | undefined;
         legacyOrderId?: string | null | undefined;
+        providerConnectionId?: string | null | undefined;
     }>>>;
     invoiceNotification: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
@@ -1331,6 +1338,7 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
             expired: "expired";
         }>;
         provider: z.ZodNullable<z.ZodString>;
+        providerConnectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         providerSessionId: z.ZodNullable<z.ZodString>;
         providerPaymentId: z.ZodNullable<z.ZodString>;
         externalReference: z.ZodNullable<z.ZodString>;
@@ -1360,6 +1368,7 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
         notes: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, z.ZodTransform<{
         legacyOrderId: string | null;
+        providerConnectionId: string | null;
         target: {
             type: "booking";
             bookingId: string;
@@ -1490,6 +1499,7 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey?: string | null | undefined;
         } | null | undefined;
         legacyOrderId?: string | null | undefined;
+        providerConnectionId?: string | null | undefined;
     }>>>;
     invoiceNotification: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;

package/dist/checkout-validation.js

@@ -28,7 +28,12 @@ export const checkoutReminderTargetTypeSchema = z.enum([
     "invoice",
 ]);
 export const checkoutProviderStartInputSchema = z.object({
-    provider: z.string().min(1).max(255),
+    /**
+     * Legacy provider hint. Deployments with a selected PaymentAdapter ignore
+     * this value and always use their selected adapter. New clients should omit
+     * it so processor selection remains deployment-owned.
+     */
+    provider: z.string().min(1).max(255).optional(),
     payload: z.record(z.string(), z.unknown()).optional().nullable(),
 });
 export const checkoutNotificationAttachmentSchema = z

package/dist/index.d.ts

@@ -28,12 +28,13 @@ export { PAYMENT_ADAPTER_CONTRACT_VERSION, PAYMENT_ADAPTER_RUNTIME_PORT_ID, paym
 export { type BookingCancellationSettlementInput, buildPaidBookingCancellationSettlementNote, closeTerminalBookingPaymentSchedules, financeBookingLifecycle, recordPaidBookingCancellationSettlement, } from "./booking-lifecycle.js";
 export { type BookingTaxRouteOptions, type BookingTaxSettings, computeBookingItemTaxLine, createBookingTaxPreviewApiExtension, createBookingTaxPreviewRoutes, createBookingTaxSettingsApiExtension, createBookingTaxSettingsRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxPreviewRoutes, mountBookingTaxSettingsRoutes, type ProductTaxFacts, type ResolveBookingSellTaxRateOptions, type ResolveBookingTaxSettings, type ResolvedBookingSellTaxRate, resolveBookingSellTaxRate, type TaxPolicyCondition, type UpdateBookingTaxSettings, } from "./booking-tax.js";
 export { BOOKING_TAX_PREVIEW_RUNTIME_KEY, BOOKING_TAX_SETTINGS_RUNTIME_KEY, type BookingTaxRuntime, createBookingTaxPreviewVoyantRuntime, createBookingTaxSettingsVoyantRuntime, } from "./booking-tax-runtime.js";
-export type { CardPaymentBilling, CardPaymentStartArgs, CardPaymentStarter, CardPaymentStartResult, PaymentAdapterCardPaymentStarterOptions, } from "./card-payment.js";
-export { createPaymentAdapterCardPaymentStarter } from "./card-payment.js";
+export type { CardPaymentBilling, CardPaymentStartArgs, CardPaymentStarter, CardPaymentStartResult, PaymentAdapterCardPaymentExecution, PaymentAdapterCardPaymentStarterOptions, } from "./card-payment.js";
+export { createPaymentAdapterCardPaymentStarter, startPaymentAdapterCardPayment, } from "./card-payment.js";
 export { type DocumentDownloadEnvelope, type DocumentDownloadResolution, type DocumentDownloadResolver, resolveStoredDocumentDownload, type StoredDocumentReference, } from "./document-download.js";
 export { createInvoiceFxApiExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, type InvoiceExchangeRateResolution, type InvoiceFxContext, type InvoiceFxOptions, type InvoiceFxRouteOptions, type InvoiceFxSettings, mountInvoiceFxRoutes, type ResolvedInvoiceFxSettings, type ResolveInvoiceExchangeRate, type ResolveInvoiceExchangeRateInput, type ResolveInvoiceFxSettings, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, type UpdateInvoiceFxSettings, type VoyantDataFxResolverOptions, } from "./invoice-fx.js";
 export { type CreateOrderPaymentSessionsOptions, createOrderPaymentSessions, type EnsureOrderSessionParams, type OrderPaymentSessionSummary, type OrderPaymentSessions, type OrderPaymentSessionTargetType, type StartOrderPaymentProvider, } from "./order-payment-sessions.js";
-export { applyPaymentAdapterCallbackEvent } from "./payment-adapter-events.js";
+export { applyPaymentAdapterCallbackEvent, applyPaymentAdapterInitiationResult, applyPaymentAdapterStatusResult, } from "./payment-adapter-events.js";
+export { type PaymentAdapterStatusRefreshExecution, refreshPaymentAdapterStatus, } from "./payment-adapter-status.js";
 export type { ComputedScheduleEntry, ComputeScheduleInput, DepositKind, DepositRule, PaymentPolicy, PaymentPolicyCascadeLayers, PaymentPolicySource, PaymentScheduleEntryType, ResolvedPaymentPolicy, } from "./payment-policy.js";
 export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, normalizePaymentPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
 export { createPaymentPolicyCascade, type PaymentPolicyCascade, type PaymentPolicyCascadeOptions, type PaymentPolicyCascadeReaders, readPolicySourceFromInternalNotes, stampPolicySourceOnBooking, } from "./payment-policy-cascade.js";

package/dist/index.js

@@ -4,6 +4,7 @@ import { registerBookingFinancialLifecycle } from "@voyant-travel/bookings";
 import { customFieldsRuntimePort } from "@voyant-travel/core/custom-fields";
 import { defineGraphRuntimeFactory } from "@voyant-travel/core/project";
 import { stampOpenApiRegistryApiId } from "@voyant-travel/hono";
+import { paymentAdapterRuntimePort } from "@voyant-travel/payments";
 import { financeBookingLifecycle } from "./booking-lifecycle.js";
 import { createBookingTaxSettingsRoutes } from "./booking-tax.js";
 import { buildFinanceCheckoutRouteRuntime, createFinanceCheckoutAdminRoutes, createFinanceCheckoutRoutes, FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, } from "./checkout-routes.js";
@@ -68,7 +69,9 @@ export const financeApiModule = createFinanceApiModule();
 export const createFinanceVoyantRuntime = defineGraphRuntimeFactory(async ({ api, getPort, getPorts, hasPort }) => {
     const configured = createFinanceApiModule(createFinanceRuntime(await getPort(financeHostRuntimePort), await getPort(customFieldsRuntimePort), await getPort(financeNotificationsRuntimePort), hasPort(financeCheckoutPaymentStartersRuntimePort)
         ? await getPort(financeCheckoutPaymentStartersRuntimePort)
-        : undefined, await getPorts(financeInvoiceSettlementPollerRuntimePort)));
+        : undefined, await getPorts(financeInvoiceSettlementPollerRuntimePort), hasPort(paymentAdapterRuntimePort)
+        ? await getPort(paymentAdapterRuntimePort)
+        : undefined));
     const bootstrap = configured.module.bootstrap;
     const selected = {
         module: {
@@ -91,11 +94,12 @@ export { PAYMENT_ADAPTER_CONTRACT_VERSION, PAYMENT_ADAPTER_RUNTIME_PORT_ID, paym
 export { buildPaidBookingCancellationSettlementNote, closeTerminalBookingPaymentSchedules, financeBookingLifecycle, recordPaidBookingCancellationSettlement, } from "./booking-lifecycle.js";
 export { computeBookingItemTaxLine, createBookingTaxPreviewApiExtension, createBookingTaxPreviewRoutes, createBookingTaxSettingsApiExtension, createBookingTaxSettingsRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxPreviewRoutes, mountBookingTaxSettingsRoutes, resolveBookingSellTaxRate, } from "./booking-tax.js";
 export { BOOKING_TAX_PREVIEW_RUNTIME_KEY, BOOKING_TAX_SETTINGS_RUNTIME_KEY, createBookingTaxPreviewVoyantRuntime, createBookingTaxSettingsVoyantRuntime, } from "./booking-tax-runtime.js";
-export { createPaymentAdapterCardPaymentStarter } from "./card-payment.js";
+export { createPaymentAdapterCardPaymentStarter, startPaymentAdapterCardPayment, } from "./card-payment.js";
 export { resolveStoredDocumentDownload, } from "./document-download.js";
 export { createInvoiceFxApiExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, mountInvoiceFxRoutes, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, } from "./invoice-fx.js";
 export { createOrderPaymentSessions, } from "./order-payment-sessions.js";
-export { applyPaymentAdapterCallbackEvent } from "./payment-adapter-events.js";
+export { applyPaymentAdapterCallbackEvent, applyPaymentAdapterInitiationResult, applyPaymentAdapterStatusResult, } from "./payment-adapter-events.js";
+export { refreshPaymentAdapterStatus, } from "./payment-adapter-status.js";
 export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, normalizePaymentPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
 export { createPaymentPolicyCascade, readPolicySourceFromInternalNotes, stampPolicySourceOnBooking, } from "./payment-policy-cascade.js";
 export { createBookingScheduleAdminRoutes, createBookingScheduleApiExtension, createBookingScheduleVoyantRuntime, createPaymentPolicyPublicRoutes, generatePaymentScheduleForBooking, } from "./payment-schedule/routes.js";

package/dist/payment-adapter-events.d.ts

@@ -1,6 +1,54 @@
-import type { PaymentCallbackEvent } from "@voyant-travel/payments";
+import type { PaymentCallbackEvent, PaymentInitiationResult, PaymentStatusResult } from "@voyant-travel/payments";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
-import type { FinanceServiceRuntime } from "./service-shared.js";
+import { type FinanceServiceRuntime } from "./service-shared.js";
+export declare function applyPaymentAdapterInitiationResult(db: PostgresJsDatabase, paymentSessionId: string, adapterId: string, result: PaymentInitiationResult, claim: {
+    idempotencyKey: string;
+    claimedAt: Date;
+}, runtime?: FinanceServiceRuntime): Promise<{
+    id: string;
+    targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+    targetId: string | null;
+    bookingId: string | null;
+    orderId: string | null;
+    invoiceId: string | null;
+    bookingPaymentScheduleId: string | null;
+    bookingGuaranteeId: string | null;
+    paymentInstrumentId: string | null;
+    paymentAuthorizationId: string | null;
+    paymentCaptureId: string | null;
+    paymentId: string | null;
+    status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
+    provider: string | null;
+    providerConnectionId: string | null;
+    providerSessionId: string | null;
+    providerPaymentId: string | null;
+    externalReference: string | null;
+    idempotencyKey: string | null;
+    clientReference: string | null;
+    currency: string;
+    amountCents: number;
+    paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "travel_credit" | "other" | null;
+    payerPersonId: string | null;
+    payerOrganizationId: string | null;
+    payerEmail: string | null;
+    payerName: string | null;
+    redirectUrl: string | null;
+    returnUrl: string | null;
+    cancelUrl: string | null;
+    callbackUrl: string | null;
+    expiresAt: Date | null;
+    completedAt: Date | null;
+    failedAt: Date | null;
+    cancelledAt: Date | null;
+    expiredAt: Date | null;
+    failureCode: string | null;
+    failureMessage: string | null;
+    notes: string | null;
+    providerPayload: Record<string, unknown> | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+} | null>;
 export declare function applyPaymentAdapterCallbackEvent(db: PostgresJsDatabase, event: PaymentCallbackEvent, runtime?: FinanceServiceRuntime): Promise<{
     id: string;
     targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
@@ -16,6 +64,52 @@ export declare function applyPaymentAdapterCallbackEvent(db: PostgresJsDatabase,
     paymentId: string | null;
     status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
     provider: string | null;
+    providerConnectionId: string | null;
+    providerSessionId: string | null;
+    providerPaymentId: string | null;
+    externalReference: string | null;
+    idempotencyKey: string | null;
+    clientReference: string | null;
+    currency: string;
+    amountCents: number;
+    paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "travel_credit" | "other" | null;
+    payerPersonId: string | null;
+    payerOrganizationId: string | null;
+    payerEmail: string | null;
+    payerName: string | null;
+    redirectUrl: string | null;
+    returnUrl: string | null;
+    cancelUrl: string | null;
+    callbackUrl: string | null;
+    expiresAt: Date | null;
+    completedAt: Date | null;
+    failedAt: Date | null;
+    cancelledAt: Date | null;
+    expiredAt: Date | null;
+    failureCode: string | null;
+    failureMessage: string | null;
+    notes: string | null;
+    providerPayload: Record<string, unknown> | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+} | null>;
+export declare function applyPaymentAdapterStatusResult(db: PostgresJsDatabase, paymentSessionId: string, result: PaymentStatusResult, statusLeaseToken: string, runtime?: FinanceServiceRuntime, checkedAt?: Date): Promise<{
+    id: string;
+    targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+    targetId: string | null;
+    bookingId: string | null;
+    orderId: string | null;
+    invoiceId: string | null;
+    bookingPaymentScheduleId: string | null;
+    bookingGuaranteeId: string | null;
+    paymentInstrumentId: string | null;
+    paymentAuthorizationId: string | null;
+    paymentCaptureId: string | null;
+    paymentId: string | null;
+    status: "paid" | "pending" | "failed" | "requires_redirect" | "processing" | "authorized" | "cancelled" | "expired";
+    provider: string | null;
+    providerConnectionId: string | null;
     providerSessionId: string | null;
     providerPaymentId: string | null;
     externalReference: string | null;