@voyant-travel/finance 0.170.0 → 0.171.0

package/dist/app-api-runtime.d.ts

@@ -0,0 +1,2 @@
+import type { FinanceAppApiRuntime } from "@voyant-travel/finance-contracts/app-api";
+export declare function createFinanceAppApiRuntime(): FinanceAppApiRuntime;

package/dist/app-api-runtime.js

@@ -0,0 +1,242 @@
+import { bookings } from "@voyant-travel/bookings/schema";
+import { FinanceAppApiNumberConflictError } from "@voyant-travel/finance-contracts/app-api";
+import { and, asc, eq, sql } from "drizzle-orm";
+import { invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoices, taxRegimes, } from "./schema.js";
+import { financeService } from "./service.js";
+import { buildInvoiceIssuedEvent } from "./service-issue.js";
+import { InvoiceNumberConflictError, toRows } from "./service-shared.js";
+export function createFinanceAppApiRuntime() {
+    return {
+        async getIssuanceDocument(db, documentId) {
+            const [invoice] = await db.select().from(invoices).where(eq(invoices.id, documentId)).limit(1);
+            if (!invoice || invoice.invoiceType === "credit_note")
+                return null;
+            const [[booking], [series], [taxRegime], lines, issuedEvent] = await Promise.all([
+                db.select().from(bookings).where(eq(bookings.id, invoice.bookingId)).limit(1),
+                invoice.seriesId
+                    ? db
+                        .select()
+                        .from(invoiceNumberSeries)
+                        .where(eq(invoiceNumberSeries.id, invoice.seriesId))
+                        .limit(1)
+                    : Promise.resolve([]),
+                invoice.taxRegimeId
+                    ? db.select().from(taxRegimes).where(eq(taxRegimes.id, invoice.taxRegimeId)).limit(1)
+                    : Promise.resolve([]),
+                db
+                    .select()
+                    .from(invoiceLineItems)
+                    .where(eq(invoiceLineItems.invoiceId, documentId))
+                    .orderBy(asc(invoiceLineItems.sortOrder)),
+                buildInvoiceIssuedEvent(db, invoice),
+            ]);
+            return {
+                id: invoice.id,
+                documentType: invoice.invoiceType,
+                number: invoice.invoiceNumber,
+                status: invoice.status,
+                booking: { id: invoice.bookingId, number: booking?.bookingNumber ?? null },
+                billing: {
+                    name: [booking?.contactFirstName, booking?.contactLastName].filter(Boolean).join(" ") ||
+                        "Customer",
+                    email: booking?.contactEmail ?? null,
+                    phone: booking?.contactPhone ?? null,
+                    address: [booking?.contactAddressLine1, booking?.contactAddressLine2]
+                        .filter(Boolean)
+                        .join("\n") || null,
+                    city: booking?.contactCity ?? null,
+                    region: booking?.contactRegion ?? null,
+                    country: booking?.contactCountry ?? null,
+                    vatCode: booking?.contactTaxId ?? null,
+                    registrationNumber: null,
+                },
+                currency: { document: invoice.currency, base: invoice.baseCurrency },
+                fx: buildHydratedFx(invoice, issuedEvent),
+                totals: {
+                    subtotalCents: invoice.subtotalCents,
+                    taxCents: invoice.taxCents,
+                    totalCents: invoice.totalCents,
+                },
+                dates: { issuedOn: invoice.issueDate, dueOn: invoice.dueDate },
+                language: invoice.language,
+                taxRegime: taxRegime
+                    ? {
+                        id: taxRegime.id,
+                        code: taxRegime.code,
+                        name: taxRegime.name,
+                        legalReference: taxRegime.legalReference,
+                        specialRegime: !["standard", "reduced"].includes(taxRegime.code),
+                        marginSchemeArticle311: taxRegime.code === "margin_scheme_art311",
+                    }
+                    : null,
+                series: series
+                    ? {
+                        id: series.id,
+                        code: series.code,
+                        name: series.name,
+                        scope: series.scope,
+                    }
+                    : null,
+                allocation: {
+                    required: Boolean(series?.externalProvider),
+                    pending: invoice.status === "pending_external_allocation",
+                    placeholderNumber: invoice.status === "pending_external_allocation" ? invoice.invoiceNumber : null,
+                },
+                lines: lines.map((line, index) => {
+                    const projectedLine = issuedEvent.lineItems?.[index];
+                    return {
+                        id: line.id,
+                        description: line.description,
+                        quantity: line.quantity,
+                        unitPriceCents: line.unitPriceCents,
+                        totalCents: line.totalCents,
+                        tax: {
+                            ratePercent: projectedLine?.taxPercentage ?? line.taxRate,
+                            name: projectedLine?.taxName ?? null,
+                            regimeCode: projectedLine?.taxRegimeCode ?? null,
+                        },
+                    };
+                }),
+            };
+        },
+        async getExternalReference(db, documentId, provider) {
+            const [row] = await db
+                .select()
+                .from(invoiceExternalRefs)
+                .where(and(eq(invoiceExternalRefs.invoiceId, documentId), eq(invoiceExternalRefs.provider, provider)))
+                .limit(1);
+            return row ? mapExternalReference(row) : null;
+        },
+        async upsertExternalReference(db, documentId, provider, input) {
+            const locked = toRows(await db.execute(
+            // agent-quality: raw-sql reviewed -- identifiers are static and values are bound.
+            sql `SELECT invoice_number, series_id, status FROM invoices WHERE id = ${documentId} FOR UPDATE`))[0];
+            if (!locked)
+                return { status: "not_found" };
+            let allocationOutcome = "not_requested";
+            if (input.allocation) {
+                if (locked.status !== "pending_external_allocation") {
+                    if (locked.invoice_number !== input.allocation.invoiceNumber) {
+                        return {
+                            status: "allocation_conflict",
+                            currentNumber: locked.invoice_number,
+                            currentStatus: locked.status,
+                        };
+                    }
+                    allocationOutcome = "already_applied";
+                }
+                else {
+                    const series = toRows(await db.execute(
+                    // agent-quality: raw-sql reviewed -- identifiers are static and values are bound.
+                    sql `SELECT external_provider FROM invoice_number_series WHERE id = ${locked.series_id} FOR UPDATE`))[0];
+                    if (!series || series.external_provider !== provider) {
+                        return {
+                            status: "allocation_conflict",
+                            currentNumber: locked.invoice_number,
+                            currentStatus: locked.status,
+                        };
+                    }
+                    try {
+                        const allocation = await financeService.applyExternalInvoiceAllocation(db, documentId, {
+                            invoiceNumber: input.allocation.invoiceNumber,
+                        });
+                        if (allocation.status === "not_found")
+                            return { status: "not_found" };
+                        if (allocation.status === "not_pending_external_allocation") {
+                            return {
+                                status: "allocation_conflict",
+                                currentNumber: allocation.invoice.invoiceNumber,
+                                currentStatus: allocation.invoice.status,
+                            };
+                        }
+                        allocationOutcome = "applied";
+                    }
+                    catch (error) {
+                        if (error instanceof InvoiceNumberConflictError) {
+                            throw new FinanceAppApiNumberConflictError(input.allocation.invoiceNumber);
+                        }
+                        throw error;
+                    }
+                }
+            }
+            const [existing] = await db
+                .select()
+                .from(invoiceExternalRefs)
+                .where(and(eq(invoiceExternalRefs.invoiceId, documentId), eq(invoiceExternalRefs.provider, provider)))
+                .limit(1);
+            const referenceOutcome = existing
+                ? referenceMatches(existing, input.reference)
+                    ? "unchanged"
+                    : "updated"
+                : "created";
+            const row = referenceOutcome === "unchanged"
+                ? existing
+                : await financeService.registerInvoiceExternalRef(db, documentId, {
+                    provider,
+                    ...input.reference,
+                });
+            if (!row)
+                return { status: "not_found" };
+            return {
+                status: "ok",
+                reference: mapExternalReference(row),
+                referenceOutcome,
+                allocationOutcome,
+            };
+        },
+    };
+}
+function buildHydratedFx(invoice, issuedEvent) {
+    if (!invoice.baseCurrency || invoice.baseCurrency === invoice.currency)
+        return null;
+    const persistedRate = derivePersistedFxRate(invoice);
+    return {
+        rateSetId: issuedEvent.fxRateSetId ?? invoice.fxRateSetId,
+        rate: issuedEvent.fxRate ?? persistedRate,
+        effectiveRate: issuedEvent.effectiveRate ?? persistedRate,
+        source: issuedEvent.fxRateSource ?? null,
+        quotedAt: issuedEvent.fxRateQuotedAt ?? null,
+        validUntil: issuedEvent.fxRateValidUntil ?? null,
+        commissionBasisPoints: issuedEvent.fxCommissionBps ?? null,
+        invoiceMention: issuedEvent.fxCommissionInvoiceMention ?? null,
+    };
+}
+function derivePersistedFxRate(invoice) {
+    const pairs = [
+        [invoice.baseTotalCents, invoice.totalCents],
+        [invoice.baseSubtotalCents, invoice.subtotalCents],
+    ];
+    for (const [baseAmount, documentAmount] of pairs) {
+        if (baseAmount != null && documentAmount > 0)
+            return baseAmount / documentAmount;
+    }
+    return null;
+}
+function mapExternalReference(row) {
+    return {
+        id: row.id,
+        documentId: row.invoiceId,
+        provider: row.provider,
+        externalId: row.externalId,
+        externalNumber: row.externalNumber,
+        externalUrl: row.externalUrl,
+        status: row.status,
+        metadata: isRecord(row.metadata) ? row.metadata : null,
+        syncedAt: row.syncedAt?.toISOString() ?? null,
+        syncError: row.syncError,
+        createdAt: row.createdAt.toISOString(),
+        updatedAt: row.updatedAt.toISOString(),
+    };
+}
+function referenceMatches(existing, input) {
+    return (existing.externalId === (input.externalId ?? null) &&
+        existing.externalNumber === (input.externalNumber ?? null) &&
+        existing.externalUrl === (input.externalUrl ?? null) &&
+        existing.status === (input.status ?? null) &&
+        JSON.stringify(existing.metadata) === JSON.stringify(input.metadata ?? null) &&
+        (existing.syncedAt?.toISOString() ?? null) === (input.syncedAt ?? null) &&
+        existing.syncError === (input.syncError ?? null));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/booking-tax.d.ts

@@ -94,6 +94,17 @@ export declare function createBookingTaxSettingsRoutes(options?: BookingTaxRoute
 } & {
     "/tax-settings": {
         $patch: {
+            input: {
+                json: {
+                    taxPriceMode?: "inclusive" | "exclusive" | undefined;
+                    taxPolicyProfileId?: string | null | undefined;
+                    invoicingMode?: "direct" | "proforma-first" | undefined;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 409;
+        } | {
             input: {
                 json: {
                     taxPriceMode?: "inclusive" | "exclusive" | undefined;
@@ -110,17 +121,6 @@ export declare function createBookingTaxSettingsRoutes(options?: BookingTaxRoute
             };
             outputFormat: "json";
             status: 200;
-        } | {
-            input: {
-                json: {
-                    taxPriceMode?: "inclusive" | "exclusive" | undefined;
-                    taxPolicyProfileId?: string | null | undefined;
-                    invoicingMode?: "direct" | "proforma-first" | undefined;
-                };
-            };
-            output: {};
-            outputFormat: string;
-            status: 409;
         };
     };
 }, "/">;

package/dist/checkout-validation.d.ts

@@ -929,10 +929,10 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>>;
         targetType: z.ZodEnum<{
+            invoice: "invoice";
             other: "other";
             booking: "booking";
             order: "order";
-            invoice: "invoice";
             booking_payment_schedule: "booking_payment_schedule";
             booking_guarantee: "booking_guarantee";
             flight_order: "flight_order";
@@ -1022,7 +1022,7 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey?: string | null | undefined;
         } | null;
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetType: "invoice" | "other" | "booking" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
@@ -1049,7 +1049,7 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
         notes: string | null;
     }, {
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetType: "invoice" | "other" | "booking" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
@@ -1306,10 +1306,10 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>>;
         targetType: z.ZodEnum<{
+            invoice: "invoice";
             other: "other";
             booking: "booking";
             order: "order";
-            invoice: "invoice";
             booking_payment_schedule: "booking_payment_schedule";
             booking_guarantee: "booking_guarantee";
             flight_order: "flight_order";
@@ -1399,7 +1399,7 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
             idempotencyKey?: string | null | undefined;
         } | null;
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetType: "invoice" | "other" | "booking" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
@@ -1426,7 +1426,7 @@ export declare const bootstrappedCheckoutCollectionSchema: z.ZodObject<{
         notes: string | null;
     }, {
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetType: "invoice" | "other" | "booking" | "order" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;

package/dist/routes-action-ledger.d.ts

@@ -36,6 +36,17 @@ declare function getPaymentSessionLedgerTarget(session: {
 export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
     [x: string]: {
         $get: {
+            input: {
+                param: {
+                    [x: string]: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
             input: {
                 param: {
                     [x: string]: string;
@@ -47,7 +58,7 @@ export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
                     occurredAt: string;
                     actionName: string;
                     actionVersion: string;
-                    actionKind: "reverse" | "execute" | "delete" | "update" | "read" | "create" | "approve" | "reject" | "compensate" | "duplicate";
+                    actionKind: "reverse" | "execute" | "update" | "delete" | "read" | "create" | "approve" | "reject" | "compensate" | "duplicate";
                     status: "failed" | "cancelled" | "expired" | "approved" | "requested" | "awaiting_approval" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
                     evaluatedRisk: "low" | "medium" | "high" | "critical";
                     actorType: string | null;
@@ -89,7 +100,11 @@ export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
             };
             outputFormat: "json";
             status: 200;
-        } | {
+        };
+    };
+} & {
+    [x: string]: {
+        $get: {
             input: {
                 param: {
                     [x: string]: string;
@@ -100,11 +115,7 @@ export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
             };
             outputFormat: "json";
             status: 404;
-        };
-    };
-} & {
-    [x: string]: {
-        $get: {
+        } | {
             input: {
                 param: {
                     [x: string]: string;
@@ -116,7 +127,7 @@ export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
                     occurredAt: string;
                     actionName: string;
                     actionVersion: string;
-                    actionKind: "reverse" | "execute" | "delete" | "update" | "read" | "create" | "approve" | "reject" | "compensate" | "duplicate";
+                    actionKind: "reverse" | "execute" | "update" | "delete" | "read" | "create" | "approve" | "reject" | "compensate" | "duplicate";
                     status: "failed" | "cancelled" | "expired" | "approved" | "requested" | "awaiting_approval" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
                     evaluatedRisk: "low" | "medium" | "high" | "critical";
                     actorType: string | null;
@@ -158,17 +169,6 @@ export declare const financeActionLedgerRoutes: OpenAPIHono<Env, {
             };
             outputFormat: "json";
             status: 200;
-        } | {
-            input: {
-                param: {
-                    [x: string]: string;
-                };
-            };
-            output: {
-                error: string;
-            };
-            outputFormat: "json";
-            status: 404;
         };
     };
 }, "/">;