@voyantjs/finance 0.3.0 → 0.4.0

package/dist/validation-public.d.ts

@@ -0,0 +1,443 @@
+import { z } from "zod";
+export declare const publicFinanceInvoiceTypeSchema: z.ZodEnum<{
+    invoice: "invoice";
+    proforma: "proforma";
+    credit_note: "credit_note";
+}>;
+export declare const publicFinanceDocumentAvailabilitySchema: z.ZodEnum<{
+    pending: "pending";
+    failed: "failed";
+    ready: "ready";
+    stale: "stale";
+    missing: "missing";
+}>;
+export declare const publicFinanceDocumentFormatSchema: z.ZodEnum<{
+    json: "json";
+    pdf: "pdf";
+    html: "html";
+    xml: "xml";
+}>;
+export declare const publicPaymentOptionsQuerySchema: z.ZodObject<{
+    personId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    instrumentType: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        voucher: "voucher";
+        wallet: "wallet";
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        cash: "cash";
+        direct_bill: "direct_bill";
+        bank_account: "bank_account";
+    }>>;
+    includeInactive: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+}, z.core.$strip>;
+export declare const publicStartPaymentSessionSchema: z.ZodObject<{
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    paymentMethod: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        voucher: "voucher";
+        wallet: "wallet";
+        bank_transfer: "bank_transfer";
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        cash: "cash";
+        cheque: "cheque";
+        direct_bill: "direct_bill";
+    }>>>;
+    paymentInstrumentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    payerPersonId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    payerOrganizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    payerEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    payerName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    externalReference: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    clientReference: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    returnUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cancelUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    callbackUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    expiresAt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    providerPayload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const publicValidateVoucherSchema: z.ZodObject<{
+    code: z.ZodString;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    bookingId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    currency: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    amountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const publicPaymentAccountSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    provider: z.ZodNullable<z.ZodString>;
+    instrumentType: z.ZodEnum<{
+        other: "other";
+        voucher: "voucher";
+        wallet: "wallet";
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        cash: "cash";
+        direct_bill: "direct_bill";
+        bank_account: "bank_account";
+    }>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        revoked: "revoked";
+        active: "active";
+        inactive: "inactive";
+        failed_verification: "failed_verification";
+    }>;
+    brand: z.ZodNullable<z.ZodString>;
+    last4: z.ZodNullable<z.ZodString>;
+    expiryMonth: z.ZodNullable<z.ZodNumber>;
+    expiryYear: z.ZodNullable<z.ZodNumber>;
+    isDefault: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const publicBookingPaymentScheduleSchema: z.ZodObject<{
+    id: z.ZodString;
+    scheduleType: z.ZodEnum<{
+        other: "other";
+        deposit: "deposit";
+        installment: "installment";
+        balance: "balance";
+        hold: "hold";
+    }>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        cancelled: "cancelled";
+        pending: "pending";
+        paid: "paid";
+        due: "due";
+        waived: "waived";
+    }>;
+    dueDate: z.ZodString;
+    currency: z.ZodString;
+    amountCents: z.ZodNumber;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const publicBookingGuaranteeSchema: z.ZodObject<{
+    id: z.ZodString;
+    bookingPaymentScheduleId: z.ZodNullable<z.ZodString>;
+    guaranteeType: z.ZodString;
+    status: z.ZodString;
+    currency: z.ZodNullable<z.ZodString>;
+    amountCents: z.ZodNullable<z.ZodNumber>;
+    provider: z.ZodNullable<z.ZodString>;
+    referenceNumber: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const publicBookingPaymentOptionsSchema: z.ZodObject<{
+    bookingId: z.ZodString;
+    accounts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+        instrumentType: z.ZodEnum<{
+            other: "other";
+            voucher: "voucher";
+            wallet: "wallet";
+            credit_card: "credit_card";
+            debit_card: "debit_card";
+            cash: "cash";
+            direct_bill: "direct_bill";
+            bank_account: "bank_account";
+        }>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            revoked: "revoked";
+            active: "active";
+            inactive: "inactive";
+            failed_verification: "failed_verification";
+        }>;
+        brand: z.ZodNullable<z.ZodString>;
+        last4: z.ZodNullable<z.ZodString>;
+        expiryMonth: z.ZodNullable<z.ZodNumber>;
+        expiryYear: z.ZodNullable<z.ZodNumber>;
+        isDefault: z.ZodBoolean;
+    }, z.core.$strip>>;
+    schedules: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        scheduleType: z.ZodEnum<{
+            other: "other";
+            deposit: "deposit";
+            installment: "installment";
+            balance: "balance";
+            hold: "hold";
+        }>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            cancelled: "cancelled";
+            pending: "pending";
+            paid: "paid";
+            due: "due";
+            waived: "waived";
+        }>;
+        dueDate: z.ZodString;
+        currency: z.ZodString;
+        amountCents: z.ZodNumber;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    guarantees: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        bookingPaymentScheduleId: z.ZodNullable<z.ZodString>;
+        guaranteeType: z.ZodString;
+        status: z.ZodString;
+        currency: z.ZodNullable<z.ZodString>;
+        amountCents: z.ZodNullable<z.ZodNumber>;
+        provider: z.ZodNullable<z.ZodString>;
+        referenceNumber: z.ZodNullable<z.ZodString>;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    recommendedTarget: z.ZodNullable<z.ZodObject<{
+        targetType: z.ZodNullable<z.ZodEnum<{
+            booking_payment_schedule: "booking_payment_schedule";
+            booking_guarantee: "booking_guarantee";
+        }>>;
+        targetId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const publicPaymentSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    targetType: z.ZodEnum<{
+        other: "other";
+        booking: "booking";
+        order: "order";
+        invoice: "invoice";
+        booking_payment_schedule: "booking_payment_schedule";
+        booking_guarantee: "booking_guarantee";
+    }>;
+    targetId: z.ZodNullable<z.ZodString>;
+    bookingId: z.ZodNullable<z.ZodString>;
+    invoiceId: z.ZodNullable<z.ZodString>;
+    bookingPaymentScheduleId: z.ZodNullable<z.ZodString>;
+    bookingGuaranteeId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        cancelled: "cancelled";
+        pending: "pending";
+        failed: "failed";
+        paid: "paid";
+        requires_redirect: "requires_redirect";
+        processing: "processing";
+        authorized: "authorized";
+    }>;
+    provider: z.ZodNullable<z.ZodString>;
+    providerSessionId: z.ZodNullable<z.ZodString>;
+    providerPaymentId: z.ZodNullable<z.ZodString>;
+    externalReference: z.ZodNullable<z.ZodString>;
+    clientReference: z.ZodNullable<z.ZodString>;
+    currency: z.ZodString;
+    amountCents: z.ZodNumber;
+    paymentMethod: z.ZodNullable<z.ZodEnum<{
+        other: "other";
+        voucher: "voucher";
+        wallet: "wallet";
+        bank_transfer: "bank_transfer";
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        cash: "cash";
+        cheque: "cheque";
+        direct_bill: "direct_bill";
+    }>>;
+    payerEmail: z.ZodNullable<z.ZodString>;
+    payerName: z.ZodNullable<z.ZodString>;
+    redirectUrl: z.ZodNullable<z.ZodString>;
+    returnUrl: z.ZodNullable<z.ZodString>;
+    cancelUrl: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    failureCode: z.ZodNullable<z.ZodString>;
+    failureMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const publicFinanceBookingDocumentSchema: z.ZodObject<{
+    invoiceId: z.ZodString;
+    invoiceNumber: z.ZodString;
+    invoiceType: z.ZodEnum<{
+        invoice: "invoice";
+        proforma: "proforma";
+        credit_note: "credit_note";
+    }>;
+    invoiceStatus: z.ZodEnum<{
+        draft: "draft";
+        sent: "sent";
+        partially_paid: "partially_paid";
+        paid: "paid";
+        overdue: "overdue";
+        void: "void";
+    }>;
+    currency: z.ZodString;
+    totalCents: z.ZodNumber;
+    paidCents: z.ZodNumber;
+    balanceDueCents: z.ZodNumber;
+    issueDate: z.ZodString;
+    dueDate: z.ZodString;
+    renditionId: z.ZodNullable<z.ZodString>;
+    documentStatus: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        ready: "ready";
+        stale: "stale";
+        missing: "missing";
+    }>;
+    format: z.ZodNullable<z.ZodEnum<{
+        json: "json";
+        pdf: "pdf";
+        html: "html";
+        xml: "xml";
+    }>>;
+    language: z.ZodNullable<z.ZodString>;
+    generatedAt: z.ZodNullable<z.ZodString>;
+    fileSize: z.ZodNullable<z.ZodNumber>;
+    checksum: z.ZodNullable<z.ZodString>;
+    downloadUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const publicBookingFinanceDocumentsSchema: z.ZodObject<{
+    bookingId: z.ZodString;
+    documents: z.ZodArray<z.ZodObject<{
+        invoiceId: z.ZodString;
+        invoiceNumber: z.ZodString;
+        invoiceType: z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+            credit_note: "credit_note";
+        }>;
+        invoiceStatus: z.ZodEnum<{
+            draft: "draft";
+            sent: "sent";
+            partially_paid: "partially_paid";
+            paid: "paid";
+            overdue: "overdue";
+            void: "void";
+        }>;
+        currency: z.ZodString;
+        totalCents: z.ZodNumber;
+        paidCents: z.ZodNumber;
+        balanceDueCents: z.ZodNumber;
+        issueDate: z.ZodString;
+        dueDate: z.ZodString;
+        renditionId: z.ZodNullable<z.ZodString>;
+        documentStatus: z.ZodEnum<{
+            pending: "pending";
+            failed: "failed";
+            ready: "ready";
+            stale: "stale";
+            missing: "missing";
+        }>;
+        format: z.ZodNullable<z.ZodEnum<{
+            json: "json";
+            pdf: "pdf";
+            html: "html";
+            xml: "xml";
+        }>>;
+        language: z.ZodNullable<z.ZodString>;
+        generatedAt: z.ZodNullable<z.ZodString>;
+        fileSize: z.ZodNullable<z.ZodNumber>;
+        checksum: z.ZodNullable<z.ZodString>;
+        downloadUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const publicFinanceBookingPaymentSchema: z.ZodObject<{
+    id: z.ZodString;
+    invoiceId: z.ZodString;
+    invoiceNumber: z.ZodString;
+    invoiceType: z.ZodEnum<{
+        invoice: "invoice";
+        proforma: "proforma";
+        credit_note: "credit_note";
+    }>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        pending: "pending";
+        failed: "failed";
+        refunded: "refunded";
+    }>;
+    paymentMethod: z.ZodEnum<{
+        other: "other";
+        voucher: "voucher";
+        wallet: "wallet";
+        bank_transfer: "bank_transfer";
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        cash: "cash";
+        cheque: "cheque";
+        direct_bill: "direct_bill";
+    }>;
+    amountCents: z.ZodNumber;
+    currency: z.ZodString;
+    paymentDate: z.ZodString;
+    referenceNumber: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const publicBookingFinancePaymentsSchema: z.ZodObject<{
+    bookingId: z.ZodString;
+    payments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        invoiceId: z.ZodString;
+        invoiceNumber: z.ZodString;
+        invoiceType: z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+            credit_note: "credit_note";
+        }>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            failed: "failed";
+            refunded: "refunded";
+        }>;
+        paymentMethod: z.ZodEnum<{
+            other: "other";
+            voucher: "voucher";
+            wallet: "wallet";
+            bank_transfer: "bank_transfer";
+            credit_card: "credit_card";
+            debit_card: "debit_card";
+            cash: "cash";
+            cheque: "cheque";
+            direct_bill: "direct_bill";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        paymentDate: z.ZodString;
+        referenceNumber: z.ZodNullable<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const publicVoucherValidationSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        expired: "expired";
+        inactive: "inactive";
+        not_found: "not_found";
+        not_started: "not_started";
+        booking_mismatch: "booking_mismatch";
+        currency_mismatch: "currency_mismatch";
+        insufficient_balance: "insufficient_balance";
+    }>>;
+    voucher: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        code: z.ZodString;
+        label: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+        currency: z.ZodNullable<z.ZodString>;
+        amountCents: z.ZodNullable<z.ZodNumber>;
+        remainingAmountCents: z.ZodNullable<z.ZodNumber>;
+        expiresAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PublicPaymentOptionsQuery = z.infer<typeof publicPaymentOptionsQuerySchema>;
+export type PublicBookingPaymentOptions = z.infer<typeof publicBookingPaymentOptionsSchema>;
+export type PublicPaymentSession = z.infer<typeof publicPaymentSessionSchema>;
+export type PublicFinanceBookingDocument = z.infer<typeof publicFinanceBookingDocumentSchema>;
+export type PublicBookingFinanceDocuments = z.infer<typeof publicBookingFinanceDocumentsSchema>;
+export type PublicFinanceBookingPayment = z.infer<typeof publicFinanceBookingPaymentSchema>;
+export type PublicBookingFinancePayments = z.infer<typeof publicBookingFinancePaymentsSchema>;
+export type PublicStartPaymentSessionInput = z.infer<typeof publicStartPaymentSessionSchema>;
+export type PublicValidateVoucherInput = z.infer<typeof publicValidateVoucherSchema>;
+export type PublicVoucherValidationResult = z.infer<typeof publicVoucherValidationSchema>;
+//# sourceMappingURL=validation-public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-public.d.ts","sourceRoot":"","sources":["../src/validation-public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,eAAO,MAAM,8BAA8B;;;;EAAiD,CAAA;AAC5F,eAAO,MAAM,uCAAuC;;;;;;EAMlD,CAAA;AACF,eAAO,MAAM,iCAAiC;;;;;EAAyC,CAAA;AAEvF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;iBAM1C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB1C,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;iBAMtC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWrC,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;iBAQ7C,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;iBAWvC,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW5C,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BrC,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB7C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG9C,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY5C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7C,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;iBAyBxC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAC7E,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAC5F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AACpF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA"}

package/dist/validation-public.js

@@ -0,0 +1,183 @@
+import { z } from "zod";
+import { paymentInstrumentStatusSchema, paymentInstrumentTypeSchema, paymentMethodSchema, paymentScheduleStatusSchema, paymentScheduleTypeSchema, paymentSessionStatusSchema, paymentSessionTargetTypeSchema, } from "./validation-shared.js";
+export const publicFinanceInvoiceTypeSchema = z.enum(["invoice", "proforma", "credit_note"]);
+export const publicFinanceDocumentAvailabilitySchema = z.enum([
+    "missing",
+    "pending",
+    "ready",
+    "failed",
+    "stale",
+]);
+export const publicFinanceDocumentFormatSchema = z.enum(["html", "pdf", "xml", "json"]);
+export const publicPaymentOptionsQuerySchema = z.object({
+    personId: z.string().optional(),
+    organizationId: z.string().optional(),
+    provider: z.string().optional(),
+    instrumentType: paymentInstrumentTypeSchema.optional(),
+    includeInactive: z.coerce.boolean().default(false),
+});
+export const publicStartPaymentSessionSchema = z.object({
+    provider: z.string().max(255).optional().nullable(),
+    paymentMethod: paymentMethodSchema.optional().nullable(),
+    paymentInstrumentId: z.string().optional().nullable(),
+    payerPersonId: z.string().optional().nullable(),
+    payerOrganizationId: z.string().optional().nullable(),
+    payerEmail: z.string().email().optional().nullable(),
+    payerName: z.string().max(255).optional().nullable(),
+    externalReference: z.string().max(255).optional().nullable(),
+    idempotencyKey: z.string().max(255).optional().nullable(),
+    clientReference: z.string().max(255).optional().nullable(),
+    returnUrl: z.string().url().optional().nullable(),
+    cancelUrl: z.string().url().optional().nullable(),
+    callbackUrl: z.string().url().optional().nullable(),
+    expiresAt: z.string().optional().nullable(),
+    notes: z.string().optional().nullable(),
+    providerPayload: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+});
+export const publicValidateVoucherSchema = z.object({
+    code: z.string().min(1).max(255),
+    provider: z.string().max(255).optional().nullable(),
+    bookingId: z.string().optional().nullable(),
+    currency: z.string().min(3).max(3).optional().nullable(),
+    amountCents: z.number().int().min(1).optional().nullable(),
+});
+export const publicPaymentAccountSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    provider: z.string().nullable(),
+    instrumentType: paymentInstrumentTypeSchema,
+    status: paymentInstrumentStatusSchema,
+    brand: z.string().nullable(),
+    last4: z.string().nullable(),
+    expiryMonth: z.number().int().nullable(),
+    expiryYear: z.number().int().nullable(),
+    isDefault: z.boolean(),
+});
+export const publicBookingPaymentScheduleSchema = z.object({
+    id: z.string(),
+    scheduleType: paymentScheduleTypeSchema,
+    status: paymentScheduleStatusSchema,
+    dueDate: z.string(),
+    currency: z.string(),
+    amountCents: z.number().int(),
+    notes: z.string().nullable(),
+});
+export const publicBookingGuaranteeSchema = z.object({
+    id: z.string(),
+    bookingPaymentScheduleId: z.string().nullable(),
+    guaranteeType: z.string(),
+    status: z.string(),
+    currency: z.string().nullable(),
+    amountCents: z.number().int().nullable(),
+    provider: z.string().nullable(),
+    referenceNumber: z.string().nullable(),
+    expiresAt: z.string().nullable(),
+    notes: z.string().nullable(),
+});
+export const publicBookingPaymentOptionsSchema = z.object({
+    bookingId: z.string(),
+    accounts: z.array(publicPaymentAccountSchema),
+    schedules: z.array(publicBookingPaymentScheduleSchema),
+    guarantees: z.array(publicBookingGuaranteeSchema),
+    recommendedTarget: z
+        .object({
+        targetType: z.enum(["booking_payment_schedule", "booking_guarantee"]).nullable(),
+        targetId: z.string().nullable(),
+    })
+        .nullable(),
+});
+export const publicPaymentSessionSchema = z.object({
+    id: z.string(),
+    targetType: paymentSessionTargetTypeSchema,
+    targetId: z.string().nullable(),
+    bookingId: z.string().nullable(),
+    invoiceId: z.string().nullable(),
+    bookingPaymentScheduleId: z.string().nullable(),
+    bookingGuaranteeId: z.string().nullable(),
+    status: paymentSessionStatusSchema,
+    provider: z.string().nullable(),
+    providerSessionId: z.string().nullable(),
+    providerPaymentId: z.string().nullable(),
+    externalReference: z.string().nullable(),
+    clientReference: z.string().nullable(),
+    currency: z.string(),
+    amountCents: z.number().int(),
+    paymentMethod: paymentMethodSchema.nullable(),
+    payerEmail: z.string().nullable(),
+    payerName: z.string().nullable(),
+    redirectUrl: z.string().nullable(),
+    returnUrl: z.string().nullable(),
+    cancelUrl: z.string().nullable(),
+    expiresAt: z.string().nullable(),
+    completedAt: z.string().nullable(),
+    failureCode: z.string().nullable(),
+    failureMessage: z.string().nullable(),
+});
+export const publicFinanceBookingDocumentSchema = z.object({
+    invoiceId: z.string(),
+    invoiceNumber: z.string(),
+    invoiceType: publicFinanceInvoiceTypeSchema,
+    invoiceStatus: z.enum(["draft", "sent", "partially_paid", "paid", "overdue", "void"]),
+    currency: z.string(),
+    totalCents: z.number().int(),
+    paidCents: z.number().int(),
+    balanceDueCents: z.number().int(),
+    issueDate: z.string(),
+    dueDate: z.string(),
+    renditionId: z.string().nullable(),
+    documentStatus: publicFinanceDocumentAvailabilitySchema,
+    format: publicFinanceDocumentFormatSchema.nullable(),
+    language: z.string().nullable(),
+    generatedAt: z.string().nullable(),
+    fileSize: z.number().int().nullable(),
+    checksum: z.string().nullable(),
+    downloadUrl: z.string().nullable(),
+});
+export const publicBookingFinanceDocumentsSchema = z.object({
+    bookingId: z.string(),
+    documents: z.array(publicFinanceBookingDocumentSchema),
+});
+export const publicFinanceBookingPaymentSchema = z.object({
+    id: z.string(),
+    invoiceId: z.string(),
+    invoiceNumber: z.string(),
+    invoiceType: publicFinanceInvoiceTypeSchema,
+    status: z.enum(["pending", "completed", "failed", "refunded"]),
+    paymentMethod: paymentMethodSchema,
+    amountCents: z.number().int(),
+    currency: z.string(),
+    paymentDate: z.string(),
+    referenceNumber: z.string().nullable(),
+    notes: z.string().nullable(),
+});
+export const publicBookingFinancePaymentsSchema = z.object({
+    bookingId: z.string(),
+    payments: z.array(publicFinanceBookingPaymentSchema),
+});
+export const publicVoucherValidationSchema = z.object({
+    valid: z.boolean(),
+    reason: z
+        .enum([
+        "not_found",
+        "inactive",
+        "not_started",
+        "expired",
+        "booking_mismatch",
+        "currency_mismatch",
+        "insufficient_balance",
+    ])
+        .nullable(),
+    voucher: z
+        .object({
+        id: z.string(),
+        code: z.string(),
+        label: z.string(),
+        provider: z.string().nullable(),
+        currency: z.string().nullable(),
+        amountCents: z.number().int().nullable(),
+        remainingAmountCents: z.number().int().nullable(),
+        expiresAt: z.string().nullable(),
+    })
+        .nullable(),
+});