@voyantjs/finance-contracts 0.95.0

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

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

package/dist/validation-payments.js

@@ -0,0 +1,339 @@
+import { z } from "zod";
+import { captureModeSchema, guaranteeStatusSchema, guaranteeTypeSchema, paginationSchema, paymentAuthorizationStatusSchema, paymentCaptureStatusSchema, paymentInstrumentOwnerTypeSchema, paymentInstrumentStatusSchema, paymentInstrumentTypeSchema, paymentMethodSchema, paymentScheduleStatusSchema, paymentScheduleTypeSchema, paymentSessionStatusSchema, paymentSessionTargetTypeSchema, paymentStatusSchema, } from "./validation-shared.js";
+const paymentInstrumentCoreSchema = z.object({
+    ownerType: paymentInstrumentOwnerTypeSchema.default("client"),
+    personId: z.string().optional().nullable(),
+    organizationId: z.string().optional().nullable(),
+    supplierId: z.string().optional().nullable(),
+    channelId: z.string().optional().nullable(),
+    instrumentType: paymentInstrumentTypeSchema,
+    status: paymentInstrumentStatusSchema.default("active"),
+    label: z.string().min(1).max(255),
+    provider: z.string().max(255).optional().nullable(),
+    brand: z.string().max(100).optional().nullable(),
+    last4: z.string().max(4).optional().nullable(),
+    holderName: z.string().max(255).optional().nullable(),
+    expiryMonth: z.number().int().min(1).max(12).optional().nullable(),
+    expiryYear: z.number().int().min(2000).max(9999).optional().nullable(),
+    externalToken: z.string().max(255).optional().nullable(),
+    externalCustomerId: z.string().max(255).optional().nullable(),
+    billingEmail: z.string().email().optional().nullable(),
+    billingAddress: z.string().max(2000).optional().nullable(),
+    directBillReference: z.string().max(255).optional().nullable(),
+    notes: z.string().optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+});
+export const insertPaymentInstrumentSchema = paymentInstrumentCoreSchema;
+export const updatePaymentInstrumentSchema = paymentInstrumentCoreSchema.partial();
+export const paymentInstrumentListQuerySchema = paginationSchema.extend({
+    ownerType: paymentInstrumentOwnerTypeSchema.optional(),
+    personId: z.string().optional(),
+    organizationId: z.string().optional(),
+    supplierId: z.string().optional(),
+    channelId: z.string().optional(),
+    status: paymentInstrumentStatusSchema.optional(),
+    instrumentType: paymentInstrumentTypeSchema.optional(),
+    search: z.string().optional(),
+});
+const paymentSessionCoreSchema = z.object({
+    targetType: paymentSessionTargetTypeSchema.default("other"),
+    targetId: z.string().optional().nullable(),
+    bookingId: z.string().optional().nullable(),
+    orderId: z.string().optional().nullable(),
+    invoiceId: z.string().optional().nullable(),
+    bookingPaymentScheduleId: z.string().optional().nullable(),
+    bookingGuaranteeId: z.string().optional().nullable(),
+    paymentInstrumentId: z.string().optional().nullable(),
+    paymentAuthorizationId: z.string().optional().nullable(),
+    paymentCaptureId: z.string().optional().nullable(),
+    paymentId: z.string().optional().nullable(),
+    status: paymentSessionStatusSchema.default("pending"),
+    provider: z.string().max(255).optional().nullable(),
+    providerSessionId: z.string().max(255).optional().nullable(),
+    providerPaymentId: 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(),
+    currency: z.string().min(3).max(3),
+    amountCents: z.number().int().min(1),
+    paymentMethod: paymentMethodSchema.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(),
+    redirectUrl: z.string().url().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(),
+    completedAt: z.string().optional().nullable(),
+    failedAt: z.string().optional().nullable(),
+    cancelledAt: z.string().optional().nullable(),
+    expiredAt: z.string().optional().nullable(),
+    failureCode: z.string().max(255).optional().nullable(),
+    failureMessage: z.string().max(2000).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 insertPaymentSessionSchema = paymentSessionCoreSchema;
+export const updatePaymentSessionSchema = paymentSessionCoreSchema.partial();
+export const paymentSessionListQuerySchema = paginationSchema.extend({
+    bookingId: z.string().optional(),
+    orderId: z.string().optional(),
+    invoiceId: z.string().optional(),
+    bookingPaymentScheduleId: z.string().optional(),
+    bookingGuaranteeId: z.string().optional(),
+    targetType: paymentSessionTargetTypeSchema.optional(),
+    status: paymentSessionStatusSchema.optional(),
+    provider: z.string().optional(),
+    providerSessionId: z.string().optional(),
+    providerPaymentId: z.string().optional(),
+    externalReference: z.string().optional(),
+    clientReference: z.string().optional(),
+    idempotencyKey: z.string().optional(),
+});
+const paymentSessionProvisioningSchema = z.object({
+    provider: z.string().max(255).optional().nullable(),
+    paymentMethod: paymentMethodSchema.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 createPaymentSessionFromScheduleSchema = paymentSessionProvisioningSchema;
+export const createPaymentSessionFromGuaranteeSchema = paymentSessionProvisioningSchema;
+export const createPaymentSessionFromInvoiceSchema = paymentSessionProvisioningSchema;
+export const applyDefaultBookingPaymentPlanSchema = z.object({
+    depositMode: z.enum(["none", "percentage", "fixed_amount"]).default("percentage"),
+    depositValue: z.number().int().min(0).default(30),
+    depositDueDate: z.string().optional().nullable(),
+    balanceDueDaysBeforeStart: z.number().int().min(0).default(30),
+    clearExistingPending: z.boolean().default(true),
+    createGuarantee: z.boolean().default(false),
+    guaranteeType: guaranteeTypeSchema.default("deposit"),
+    notes: z.string().optional().nullable(),
+});
+export const markPaymentSessionRequiresRedirectSchema = z.object({
+    provider: z.string().max(255).optional().nullable(),
+    providerSessionId: z.string().max(255).optional().nullable(),
+    providerPaymentId: z.string().max(255).optional().nullable(),
+    externalReference: z.string().max(255).optional().nullable(),
+    redirectUrl: z.string().url(),
+    returnUrl: z.string().url().optional().nullable(),
+    cancelUrl: z.string().url().optional().nullable(),
+    callbackUrl: z.string().url().optional().nullable(),
+    expiresAt: z.string().optional().nullable(),
+    providerPayload: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const completePaymentSessionSchema = z.object({
+    status: z.enum(["authorized", "paid"]).default("paid"),
+    providerSessionId: z.string().max(255).optional().nullable(),
+    providerPaymentId: z.string().max(255).optional().nullable(),
+    externalReference: z.string().max(255).optional().nullable(),
+    paymentMethod: paymentMethodSchema.optional().nullable(),
+    paymentInstrumentId: z.string().optional().nullable(),
+    captureMode: captureModeSchema.default("manual"),
+    externalAuthorizationId: z.string().max(255).optional().nullable(),
+    externalCaptureId: z.string().max(255).optional().nullable(),
+    approvalCode: z.string().max(255).optional().nullable(),
+    authorizedAt: z.string().optional().nullable(),
+    capturedAt: z.string().optional().nullable(),
+    settledAt: z.string().optional().nullable(),
+    paymentDate: z.string().optional().nullable(),
+    expiresAt: z.string().optional().nullable(),
+    referenceNumber: z.string().max(255).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 failPaymentSessionSchema = z.object({
+    providerSessionId: z.string().max(255).optional().nullable(),
+    providerPaymentId: z.string().max(255).optional().nullable(),
+    externalReference: z.string().max(255).optional().nullable(),
+    failureCode: z.string().max(255).optional().nullable(),
+    failureMessage: z.string().max(2000).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 cancelPaymentSessionSchema = z.object({
+    notes: z.string().optional().nullable(),
+    providerPayload: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    cancelledAt: z.string().optional().nullable(),
+});
+export const expirePaymentSessionSchema = z.object({
+    notes: z.string().optional().nullable(),
+    providerPayload: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    expiredAt: z.string().optional().nullable(),
+});
+const paymentAuthorizationCoreSchema = z.object({
+    bookingId: z.string().optional().nullable(),
+    orderId: z.string().optional().nullable(),
+    invoiceId: z.string().optional().nullable(),
+    bookingGuaranteeId: z.string().optional().nullable(),
+    paymentInstrumentId: z.string().optional().nullable(),
+    status: paymentAuthorizationStatusSchema.default("pending"),
+    captureMode: captureModeSchema.default("manual"),
+    currency: z.string().min(3).max(3),
+    amountCents: z.number().int().min(0),
+    provider: z.string().max(255).optional().nullable(),
+    externalAuthorizationId: z.string().max(255).optional().nullable(),
+    approvalCode: z.string().max(255).optional().nullable(),
+    authorizedAt: z.string().optional().nullable(),
+    expiresAt: z.string().optional().nullable(),
+    voidedAt: z.string().optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const insertPaymentAuthorizationSchema = paymentAuthorizationCoreSchema;
+export const updatePaymentAuthorizationSchema = paymentAuthorizationCoreSchema.partial();
+export const paymentAuthorizationListQuerySchema = paginationSchema.extend({
+    bookingId: z.string().optional(),
+    orderId: z.string().optional(),
+    invoiceId: z.string().optional(),
+    bookingGuaranteeId: z.string().optional(),
+    paymentInstrumentId: z.string().optional(),
+    status: paymentAuthorizationStatusSchema.optional(),
+});
+const paymentCaptureCoreSchema = z.object({
+    paymentAuthorizationId: z.string().optional().nullable(),
+    invoiceId: z.string().optional().nullable(),
+    status: paymentCaptureStatusSchema.default("pending"),
+    currency: z.string().min(3).max(3),
+    amountCents: z.number().int().min(0),
+    provider: z.string().max(255).optional().nullable(),
+    externalCaptureId: z.string().max(255).optional().nullable(),
+    capturedAt: z.string().optional().nullable(),
+    settledAt: z.string().optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const insertPaymentCaptureSchema = paymentCaptureCoreSchema;
+export const updatePaymentCaptureSchema = paymentCaptureCoreSchema.partial();
+export const paymentCaptureListQuerySchema = paginationSchema.extend({
+    paymentAuthorizationId: z.string().optional(),
+    invoiceId: z.string().optional(),
+    status: paymentCaptureStatusSchema.optional(),
+});
+const bookingPaymentScheduleCoreSchema = z.object({
+    bookingItemId: z.string().optional().nullable(),
+    scheduleType: paymentScheduleTypeSchema.default("balance"),
+    status: paymentScheduleStatusSchema.default("pending"),
+    dueDate: z.string().min(1),
+    currency: z.string().min(3).max(3),
+    amountCents: z.number().int().min(0),
+    notes: z.string().optional().nullable(),
+});
+export const insertBookingPaymentScheduleSchema = bookingPaymentScheduleCoreSchema;
+export const updateBookingPaymentScheduleSchema = bookingPaymentScheduleCoreSchema.partial();
+const bookingGuaranteeCoreSchema = z.object({
+    bookingPaymentScheduleId: z.string().optional().nullable(),
+    bookingItemId: z.string().optional().nullable(),
+    guaranteeType: guaranteeTypeSchema,
+    status: guaranteeStatusSchema.default("pending"),
+    paymentInstrumentId: z.string().optional().nullable(),
+    paymentAuthorizationId: z.string().optional().nullable(),
+    currency: z.string().min(3).max(3).optional().nullable(),
+    amountCents: z.number().int().min(0).optional().nullable(),
+    provider: z.string().max(255).optional().nullable(),
+    referenceNumber: z.string().max(255).optional().nullable(),
+    guaranteedAt: z.string().optional().nullable(),
+    expiresAt: z.string().optional().nullable(),
+    releasedAt: z.string().optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const insertBookingGuaranteeSchema = bookingGuaranteeCoreSchema;
+export const updateBookingGuaranteeSchema = bookingGuaranteeCoreSchema.partial();
+const paymentCoreSchema = z.object({
+    amountCents: z.number().int().min(1),
+    currency: z.string().min(3).max(3),
+    baseCurrency: z.string().min(3).max(3).optional().nullable(),
+    baseAmountCents: z.number().int().min(0).optional().nullable(),
+    fxRateSetId: z.string().optional().nullable(),
+    paymentMethod: paymentMethodSchema,
+    paymentInstrumentId: z.string().optional().nullable(),
+    paymentAuthorizationId: z.string().optional().nullable(),
+    paymentCaptureId: z.string().optional().nullable(),
+    status: paymentStatusSchema.default("pending"),
+    referenceNumber: z.string().max(255).optional().nullable(),
+    paymentDate: z.string().min(1),
+    notes: z.string().optional().nullable(),
+});
+export const insertPaymentSchema = paymentCoreSchema;
+export const updatePaymentSchema = paymentCoreSchema.partial();
+const supplierPaymentCoreSchema = z.object({
+    bookingId: z.string().min(1),
+    supplierId: z.string().optional().nullable(),
+    bookingSupplierStatusId: z.string().optional().nullable(),
+    amountCents: z.number().int().min(1),
+    currency: z.string().min(3).max(3),
+    baseCurrency: z.string().min(3).max(3).optional().nullable(),
+    baseAmountCents: z.number().int().min(0).optional().nullable(),
+    fxRateSetId: z.string().optional().nullable(),
+    paymentMethod: paymentMethodSchema,
+    paymentInstrumentId: z.string().optional().nullable(),
+    status: paymentStatusSchema.default("pending"),
+    referenceNumber: z.string().max(255).optional().nullable(),
+    paymentDate: z.string().min(1),
+    notes: z.string().optional().nullable(),
+});
+export const insertSupplierPaymentSchema = supplierPaymentCoreSchema;
+export const updateSupplierPaymentSchema = supplierPaymentCoreSchema.partial();
+export const supplierPaymentListSortFieldSchema = z.enum([
+    "amountCents",
+    "status",
+    "paymentDate",
+    "createdAt",
+]);
+export const supplierPaymentListSortDirSchema = z.enum(["asc", "desc"]);
+export const supplierPaymentListQuerySchema = z.object({
+    bookingId: z.string().optional(),
+    supplierId: z.string().optional(),
+    status: paymentStatusSchema.optional(),
+    paymentMethod: paymentMethodSchema.optional(),
+    currency: z.string().optional(),
+    paymentDateFrom: z.string().optional(),
+    paymentDateTo: z.string().optional(),
+    sortBy: supplierPaymentListSortFieldSchema.default("createdAt"),
+    sortDir: supplierPaymentListSortDirSchema.default("desc"),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0),
+});
+// ---------- unified payments listing (customer + supplier) ----------
+export const paymentKindSchema = z.enum(["customer", "supplier"]);
+export const paymentListSortFieldSchema = z.enum([
+    "amountCents",
+    "status",
+    "paymentDate",
+    "createdAt",
+]);
+export const paymentListSortDirSchema = z.enum(["asc", "desc"]);
+export const paymentListQuerySchema = z.object({
+    kind: paymentKindSchema.optional(),
+    status: paymentStatusSchema.optional(),
+    paymentMethod: paymentMethodSchema.optional(),
+    currency: z.string().optional(),
+    invoiceId: z.string().optional(),
+    bookingId: z.string().optional(),
+    supplierId: z.string().optional(),
+    paymentDateFrom: z.string().optional(),
+    paymentDateTo: z.string().optional(),
+    search: z.string().optional(),
+    sortBy: paymentListSortFieldSchema.default("createdAt"),
+    sortDir: paymentListSortDirSchema.default("desc"),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0),
+});