@voyant-travel/finance 0.119.5

package/dist/service-public.d.ts

@@ -0,0 +1,553 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { PublicBookingFinanceDocuments, PublicBookingFinancePayments, PublicFinanceDocumentLookup, PublicFinanceDocumentLookupQuery, PublicPaymentOptionsQuery, PublicStartPaymentSessionInput, PublicValidateVoucherInput } from "./validation-public.js";
+export interface PublicFinanceRuntimeOptions {
+    resolveDocumentDownloadUrl?: (storageKey: string) => Promise<string | null> | string | null;
+}
+export declare const publicFinanceService: {
+    getBookingDocuments(db: PostgresJsDatabase, bookingId: string, runtime?: PublicFinanceRuntimeOptions): Promise<PublicBookingFinanceDocuments | null>;
+    getDocumentByReference(db: PostgresJsDatabase, query: PublicFinanceDocumentLookupQuery | string, runtime?: PublicFinanceRuntimeOptions): Promise<PublicFinanceDocumentLookup | null>;
+    getBookingDocumentByReference(db: PostgresJsDatabase, bookingId: string, query: PublicFinanceDocumentLookupQuery | string, runtime?: PublicFinanceRuntimeOptions): Promise<PublicFinanceDocumentLookup | null>;
+    getBookingPaymentOptions(db: PostgresJsDatabase, bookingId: string, query: PublicPaymentOptionsQuery): Promise<{
+        bookingId: string;
+        accounts: {
+            id: string;
+            label: string;
+            provider: string | null;
+            instrumentType: "other" | "credit_card" | "voucher" | "debit_card" | "cash" | "wallet" | "direct_bill" | "bank_account";
+            status: "active" | "expired" | "inactive" | "revoked" | "failed_verification";
+            brand: string | null;
+            last4: string | null;
+            expiryMonth: number | null;
+            expiryYear: number | null;
+            isDefault: boolean;
+        }[];
+        schedules: {
+            id: string;
+            scheduleType: "other" | "deposit" | "balance" | "installment" | "hold";
+            status: "pending" | "cancelled" | "due" | "paid" | "waived" | "expired";
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        }[];
+        guarantees: {
+            id: string;
+            bookingPaymentScheduleId: string | null;
+            guaranteeType: "other" | "bank_transfer" | "deposit" | "credit_card" | "preauth" | "card_on_file" | "voucher" | "agency_letter";
+            status: "active" | "failed" | "pending" | "cancelled" | "expired" | "released";
+            currency: string | null;
+            amountCents: number | null;
+            provider: string | null;
+            referenceNumber: string | null;
+            expiresAt: string | null;
+            notes: string | null;
+        }[];
+        recommendedTarget: {
+            targetType: "booking_payment_schedule" | "booking_guarantee";
+            targetId: string | null;
+        } | null;
+    } | null>;
+    getBookingPayments(db: PostgresJsDatabase, bookingId: string): Promise<PublicBookingFinancePayments | null>;
+    getPaymentSession(db: PostgresJsDatabase, sessionId: string): Promise<{
+        id: string;
+        target: {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+            bookingPaymentScheduleId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking";
+            bookingId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+        } | null;
+        provenance: null;
+        targetType: "other" | "booking_payment_schedule" | "invoice" | "booking" | "booking_guarantee" | "flight_order" | "order";
+        targetId: string | null;
+        bookingId: string | null;
+        legacyOrderId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "processing" | "failed" | "pending" | "cancelled" | "paid" | "expired" | "authorized" | "requires_redirect";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "bank_transfer" | "credit_card" | "voucher" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null>;
+    getInvoiceBookingId(db: PostgresJsDatabase, invoiceId: string): Promise<string | null>;
+    startBookingSchedulePaymentSession(db: PostgresJsDatabase, bookingId: string, scheduleId: string, input: PublicStartPaymentSessionInput): Promise<{
+        id: string;
+        target: {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+            bookingPaymentScheduleId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking";
+            bookingId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+        } | null;
+        provenance: null;
+        targetType: "other" | "booking_payment_schedule" | "invoice" | "booking" | "booking_guarantee" | "flight_order" | "order";
+        targetId: string | null;
+        bookingId: string | null;
+        legacyOrderId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "processing" | "failed" | "pending" | "cancelled" | "paid" | "expired" | "authorized" | "requires_redirect";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "bank_transfer" | "credit_card" | "voucher" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null>;
+    startBookingGuaranteePaymentSession(db: PostgresJsDatabase, bookingId: string, guaranteeId: string, input: PublicStartPaymentSessionInput): Promise<{
+        id: string;
+        target: {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+            bookingPaymentScheduleId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking";
+            bookingId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+        } | null;
+        provenance: null;
+        targetType: "other" | "booking_payment_schedule" | "invoice" | "booking" | "booking_guarantee" | "flight_order" | "order";
+        targetId: string | null;
+        bookingId: string | null;
+        legacyOrderId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "processing" | "failed" | "pending" | "cancelled" | "paid" | "expired" | "authorized" | "requires_redirect";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "bank_transfer" | "credit_card" | "voucher" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null>;
+    startInvoicePaymentSession(db: PostgresJsDatabase, invoiceId: string, input: PublicStartPaymentSessionInput): Promise<{
+        id: string;
+        target: {
+            type: "booking_payment_schedule";
+            bookingPaymentScheduleId: string;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking_guarantee";
+            bookingGuaranteeId: string;
+            bookingPaymentScheduleId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "invoice";
+            invoiceId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "flight_order";
+            flightOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "booking";
+            bookingId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            legacyOrderId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "legacy_order";
+            legacyOrderId: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            provider?: undefined;
+            reference?: undefined;
+        } | {
+            type: "provider_reference";
+            provider: string;
+            reference: string;
+            bookingPaymentScheduleId?: undefined;
+            bookingGuaranteeId?: undefined;
+            invoiceId?: undefined;
+            flightOrderId?: undefined;
+            bookingId?: undefined;
+            legacyOrderId?: undefined;
+        } | null;
+        provenance: null;
+        targetType: "other" | "booking_payment_schedule" | "invoice" | "booking" | "booking_guarantee" | "flight_order" | "order";
+        targetId: string | null;
+        bookingId: string | null;
+        legacyOrderId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "processing" | "failed" | "pending" | "cancelled" | "paid" | "expired" | "authorized" | "requires_redirect";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "bank_transfer" | "credit_card" | "voucher" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null>;
+    validateVoucher(db: PostgresJsDatabase, input: PublicValidateVoucherInput): Promise<{
+        valid: false;
+        reason: "inactive";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "not_started";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "expired";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "booking_mismatch";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "currency_mismatch";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "insufficient_balance";
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: true;
+        reason: null;
+        voucher: {
+            id: string;
+            code: string;
+            label: string | null;
+            provider: string | null;
+            currency: string | null;
+            amountCents: number | null;
+            remainingAmountCents: number | null;
+            expiresAt: string | null;
+        };
+    } | {
+        valid: false;
+        reason: "not_found";
+        voucher: null;
+    }>;
+};
+//# sourceMappingURL=service-public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-public.d.ts","sourceRoot":"","sources":["../src/service-public.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAYjE,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAE5B,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5F;AA0KD,eAAO,MAAM,oBAAoB;4BAEzB,kBAAkB,aACX,MAAM,YACR,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC;+BA6C1C,kBAAkB,SACf,gCAAgC,GAAG,MAAM,YACvC,2BAA2B,GACnC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;sCAoDxC,kBAAkB,aACX,MAAM,SACV,gCAAgC,GAAG,MAAM,YACvC,2BAA2B,GACnC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;iCA8DxC,kBAAkB,aACX,MAAM,SACV,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAoH5B,kBAAkB,aACX,MAAM,GAChB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;0BA6DnB,kBAAkB,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAKnC,kBAAkB,aAAa,MAAM;2CAW7D,kBAAkB,aACX,MAAM,cACL,MAAM,SACX,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA4BjC,kBAAkB,aACX,MAAM,eACJ,MAAM,SACZ,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAuBjC,kBAAkB,aACX,MAAM,SACV,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAMb,kBAAkB,SAAS,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEhF,CAAA"}