@voyant-travel/finance 0.119.5

package/dist/routes-invoice-documents.js

@@ -0,0 +1,91 @@
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { buildInlineDownload, resolveWaitRequest } from "./routes-runtime.js";
+import { financeService } from "./service.js";
+import { waitForInvoiceRendition, waitFormatForMode } from "./service-rendition-wait.js";
+import { insertInvoiceAttachmentSchema, insertInvoiceExternalRefSchema, invoiceDocumentWaitQuerySchema, renderInvoiceInputSchema, updateInvoiceAttachmentSchema, } from "./validation.js";
+export const financeInvoiceDocumentRoutes = new Hono()
+    // ========================================================================
+    // Invoice Renditions & External Refs (nested under invoice)
+    // ========================================================================
+    .get("/invoices/:id/renditions", async (c) => {
+    const rows = await financeService.listInvoiceRenditions(c.get("db"), c.req.param("id"));
+    return c.json({ data: rows });
+})
+    .get("/invoices/:id/attachments", async (c) => {
+    const rows = await financeService.listInvoiceAttachments(c.get("db"), c.req.param("id"));
+    return c.json({ data: rows });
+})
+    .post("/invoices/:id/attachments", async (c) => {
+    const row = await financeService.createInvoiceAttachment(c.get("db"), c.req.param("id"), await parseJsonBody(c, insertInvoiceAttachmentSchema));
+    if (!row)
+        return c.json({ error: "Invoice not found" }, 404);
+    return c.json({ data: row }, 201);
+})
+    .patch("/invoices/:id/attachments/:attachmentId", async (c) => {
+    const row = await financeService.updateInvoiceAttachment(c.get("db"), c.req.param("id"), c.req.param("attachmentId"), await parseJsonBody(c, updateInvoiceAttachmentSchema));
+    if (!row)
+        return c.json({ error: "Attachment not found" }, 404);
+    return c.json({ data: row });
+})
+    .get("/invoice-attachments/:id/download", async (c) => {
+    const attachment = await financeService.getInvoiceAttachmentById(c.get("db"), c.req.param("id"));
+    if (!attachment)
+        return c.json({ error: "Attachment not found" }, 404);
+    const download = await buildInlineDownload(c, attachment);
+    if (download.status === "resolver_not_configured") {
+        return c.json({ error: "Document download resolver is not configured" }, 501);
+    }
+    if (download.status !== "ready") {
+        return c.json({ error: "Attachment file is not available" }, 404);
+    }
+    return c.redirect(download.download.url, 302);
+})
+    .delete("/invoices/:id/attachments/:attachmentId", async (c) => {
+    const row = await financeService.deleteInvoiceAttachment(c.get("db"), c.req.param("id"), c.req.param("attachmentId"));
+    if (!row)
+        return c.json({ error: "Attachment not found" }, 404);
+    return c.json({ success: true });
+})
+    .post("/invoices/:id/render", async (c) => {
+    const input = await parseJsonBody(c, renderInvoiceInputSchema);
+    const waitRequest = resolveWaitRequest(input, parseQuery(c, invoiceDocumentWaitQuerySchema));
+    const result = await financeService.renderInvoice(c.get("db"), c.req.param("id"), input);
+    if (result.status === "not_found")
+        return c.json({ error: "Invoice not found" }, 404);
+    if (waitRequest.mode !== "none" && result.rendition) {
+        const waitResult = await waitForInvoiceRendition(c.get("db"), c.req.param("id"), {
+            renditionId: result.rendition.id,
+            format: waitFormatForMode(waitRequest.mode),
+            timeoutMs: waitRequest.timeoutMs,
+        });
+        const payload = {
+            rendition: waitResult.rendition ?? result.rendition,
+        };
+        if (waitResult.status !== "ready") {
+            return c.json({ data: payload }, 202);
+        }
+        const download = await buildInlineDownload(c, waitResult.rendition);
+        if (download.status !== "ready") {
+            return c.json({ data: payload }, 202);
+        }
+        return c.json({ data: { ...payload, download: download.download } }, 201);
+    }
+    return c.json({ data: result.rendition }, 201);
+})
+    .get("/invoices/:id/external-refs", async (c) => {
+    const rows = await financeService.listInvoiceExternalRefs(c.get("db"), c.req.param("id"));
+    return c.json({ data: rows });
+})
+    .post("/invoices/:id/external-refs", async (c) => {
+    const row = await financeService.registerInvoiceExternalRef(c.get("db"), c.req.param("id"), await parseJsonBody(c, insertInvoiceExternalRefSchema));
+    if (!row)
+        return c.json({ error: "Invoice not found" }, 404);
+    return c.json({ data: row }, 201);
+})
+    .delete("/invoices/:id/external-refs/:refId", async (c) => {
+    const row = await financeService.deleteInvoiceExternalRef(c.get("db"), c.req.param("refId"));
+    if (!row)
+        return c.json({ error: "External ref not found" }, 404);
+    return c.json({ success: true });
+});

package/dist/routes-invoice-issue.d.ts

@@ -0,0 +1,384 @@
+import type { Env } from "./routes-shared.js";
+export declare const financeInvoiceIssueRoutes: import("hono/hono-base").HonoBase<Env, {
+    "/invoices": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    bookingPaymentScheduleIds: string[];
+                    id: string;
+                    invoiceNumber: string;
+                    invoiceType: "invoice" | "proforma" | "credit_note";
+                    convertedFromInvoiceId: string | null;
+                    seriesId: string | null;
+                    sequence: number | null;
+                    templateId: string | null;
+                    taxRegimeId: string | null;
+                    language: string | null;
+                    bookingId: string;
+                    personId: string | null;
+                    organizationId: string | null;
+                    status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                    currency: string;
+                    baseCurrency: string | null;
+                    fxRateSetId: string | null;
+                    subtotalCents: number;
+                    baseSubtotalCents: number | null;
+                    taxCents: number;
+                    baseTaxCents: number | null;
+                    totalCents: number;
+                    baseTotalCents: number | null;
+                    paidCents: number;
+                    basePaidCents: number | null;
+                    balanceDueCents: number;
+                    baseBalanceDueCents: number | null;
+                    commissionPercent: number | null;
+                    commissionAmountCents: number | null;
+                    issueDate: string;
+                    dueDate: string;
+                    notes: string | null;
+                    voidedAt: string | null;
+                    voidReason: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/invoices": {
+        $post: {
+            input: {};
+            output: {
+                data: {
+                    subtotalCents: number;
+                    currency: string;
+                    id: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    taxRegimeId: string | null;
+                    taxCents: number;
+                    totalCents: number;
+                    status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                    bookingId: string;
+                    notes: string | null;
+                    templateId: string | null;
+                    dueDate: string;
+                    invoiceNumber: string;
+                    invoiceType: "invoice" | "proforma" | "credit_note";
+                    convertedFromInvoiceId: string | null;
+                    seriesId: string | null;
+                    sequence: number | null;
+                    language: string | null;
+                    personId: string | null;
+                    organizationId: string | null;
+                    baseCurrency: string | null;
+                    fxRateSetId: string | null;
+                    baseSubtotalCents: number | null;
+                    baseTaxCents: number | null;
+                    baseTotalCents: number | null;
+                    paidCents: number;
+                    basePaidCents: number | null;
+                    balanceDueCents: number;
+                    baseBalanceDueCents: number | null;
+                    commissionPercent: number | null;
+                    commissionAmountCents: number | null;
+                    issueDate: string;
+                    voidedAt: string | null;
+                    voidReason: string | null;
+                } | undefined;
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/invoices/from-booking": {
+        $post: {
+            input: {};
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {};
+            output: {
+                error: import("./service-shared.js").InvoiceNumberAllocationErrorCode;
+                scope: import("./service-shared.js").InvoiceNumberScope;
+                seriesId: string | null;
+            };
+            outputFormat: "json";
+            status: 409;
+        } | {
+            input: {};
+            output: {
+                error: string;
+                code: string;
+                invoiceNumber: string;
+            };
+            outputFormat: "json";
+            status: 409;
+        } | {
+            input: {};
+            output: {
+                error: string;
+                code: string;
+                details: {
+                    [x: string]: import("hono/utils/types").JSONValue;
+                } | undefined;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    subtotalCents: number;
+                    currency: string;
+                    id: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    taxRegimeId: string | null;
+                    taxCents: number;
+                    totalCents: number;
+                    status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                    bookingId: string;
+                    notes: string | null;
+                    templateId: string | null;
+                    dueDate: string;
+                    invoiceNumber: string;
+                    invoiceType: "invoice" | "proforma" | "credit_note";
+                    convertedFromInvoiceId: string | null;
+                    seriesId: string | null;
+                    sequence: number | null;
+                    language: string | null;
+                    personId: string | null;
+                    organizationId: string | null;
+                    baseCurrency: string | null;
+                    fxRateSetId: string | null;
+                    baseSubtotalCents: number | null;
+                    baseTaxCents: number | null;
+                    baseTotalCents: number | null;
+                    paidCents: number;
+                    basePaidCents: number | null;
+                    balanceDueCents: number;
+                    baseBalanceDueCents: number | null;
+                    commissionPercent: number | null;
+                    commissionAmountCents: number | null;
+                    issueDate: string;
+                    voidedAt: string | null;
+                    voidReason: string | null;
+                } | null;
+            };
+            outputFormat: "json";
+            status: 201;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    invoice: {
+                        subtotalCents: number;
+                        currency: string;
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        taxRegimeId: string | null;
+                        taxCents: number;
+                        totalCents: number;
+                        status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                        bookingId: string;
+                        notes: string | null;
+                        templateId: string | null;
+                        dueDate: string;
+                        invoiceNumber: string;
+                        invoiceType: "invoice" | "proforma" | "credit_note";
+                        convertedFromInvoiceId: string | null;
+                        seriesId: string | null;
+                        sequence: number | null;
+                        language: string | null;
+                        personId: string | null;
+                        organizationId: string | null;
+                        baseCurrency: string | null;
+                        fxRateSetId: string | null;
+                        baseSubtotalCents: number | null;
+                        baseTaxCents: number | null;
+                        baseTotalCents: number | null;
+                        paidCents: number;
+                        basePaidCents: number | null;
+                        balanceDueCents: number;
+                        baseBalanceDueCents: number | null;
+                        commissionPercent: number | null;
+                        commissionAmountCents: number | null;
+                        issueDate: string;
+                        voidedAt: string | null;
+                        voidReason: string | null;
+                    };
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        errorMessage: string | null;
+                        invoiceId: string;
+                        templateId: string | null;
+                        language: string | null;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        generatedAt: string | null;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: 202;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    download: {
+                        url: string;
+                        expiresAt: string | null;
+                        filename: string | null;
+                    };
+                    invoice: {
+                        subtotalCents: number;
+                        currency: string;
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        taxRegimeId: string | null;
+                        taxCents: number;
+                        totalCents: number;
+                        status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                        bookingId: string;
+                        notes: string | null;
+                        templateId: string | null;
+                        dueDate: string;
+                        invoiceNumber: string;
+                        invoiceType: "invoice" | "proforma" | "credit_note";
+                        convertedFromInvoiceId: string | null;
+                        seriesId: string | null;
+                        sequence: number | null;
+                        language: string | null;
+                        personId: string | null;
+                        organizationId: string | null;
+                        baseCurrency: string | null;
+                        fxRateSetId: string | null;
+                        baseSubtotalCents: number | null;
+                        baseTaxCents: number | null;
+                        baseTotalCents: number | null;
+                        paidCents: number;
+                        basePaidCents: number | null;
+                        balanceDueCents: number;
+                        baseBalanceDueCents: number | null;
+                        commissionPercent: number | null;
+                        commissionAmountCents: number | null;
+                        issueDate: string;
+                        voidedAt: string | null;
+                        voidReason: string | null;
+                    };
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        errorMessage: string | null;
+                        invoiceId: string;
+                        templateId: string | null;
+                        language: string | null;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        generatedAt: string | null;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/invoices/:id/convert-to-invoice": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    subtotalCents: number;
+                    currency: string;
+                    id: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    taxRegimeId: string | null;
+                    taxCents: number;
+                    totalCents: number;
+                    status: "void" | "paid" | "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "overdue";
+                    bookingId: string;
+                    notes: string | null;
+                    templateId: string | null;
+                    dueDate: string;
+                    invoiceNumber: string;
+                    invoiceType: "invoice" | "proforma" | "credit_note";
+                    convertedFromInvoiceId: string | null;
+                    seriesId: string | null;
+                    sequence: number | null;
+                    language: string | null;
+                    personId: string | null;
+                    organizationId: string | null;
+                    baseCurrency: string | null;
+                    fxRateSetId: string | null;
+                    baseSubtotalCents: number | null;
+                    baseTaxCents: number | null;
+                    baseTotalCents: number | null;
+                    paidCents: number;
+                    basePaidCents: number | null;
+                    balanceDueCents: number;
+                    baseBalanceDueCents: number | null;
+                    commissionPercent: number | null;
+                    commissionAmountCents: number | null;
+                    issueDate: string;
+                    voidedAt: string | null;
+                    voidReason: string | null;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+}, "/", "/invoices/:id/convert-to-invoice">;
+//# sourceMappingURL=routes-invoice-issue.d.ts.map

package/dist/routes-invoice-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-invoice-issue.d.ts","sourceRoot":"","sources":["../src/routes-invoice-issue.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAe7C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAqQlC,CAAA"}

package/dist/routes-invoice-issue.js

@@ -0,0 +1,208 @@
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { FINANCE_ROUTE_RUNTIME_CONTAINER_KEY } from "./route-runtime.js";
+import { buildInlineDownload, getActionLedgerRequestContext, resolveWaitRequest, routeIdempotencyKey, } from "./routes-runtime.js";
+import { financeService, InvoiceFromBookingValidationError, InvoiceNumberAllocationError, InvoiceNumberConflictError, } from "./service.js";
+import { waitForInvoiceRendition, waitFormatForMode } from "./service-rendition-wait.js";
+import { insertInvoiceSchema, invoiceDocumentWaitQuerySchema, invoiceFromBookingSchema, invoiceListQuerySchema, } from "./validation.js";
+export const financeInvoiceIssueRoutes = new Hono()
+    // ========================================================================
+    // Invoices CRUD
+    // ========================================================================
+    // GET /invoices — List invoices
+    .get("/invoices", async (c) => {
+    const query = parseQuery(c, invoiceListQuerySchema);
+    return c.json(await financeService.listInvoices(c.get("db"), query));
+})
+    // POST /invoices — Create invoice
+    .post("/invoices", routeIdempotencyKey("POST /v1/admin/finance/invoices"), async (c) => {
+    return c.json({
+        data: await financeService.createInvoice(c.get("db"), await parseJsonBody(c, insertInvoiceSchema)),
+    }, 201);
+})
+    // POST /invoices/from-booking — Create + issue invoice/proforma from a booking or schedule row
+    .post("/invoices/from-booking", routeIdempotencyKey("POST /v1/admin/finance/invoices/from-booking", {
+    fingerprintSearchParams: ["wait", "waitTimeoutMs"],
+}), async (c) => {
+    const input = await parseJsonBody(c, invoiceFromBookingSchema);
+    const waitRequest = resolveWaitRequest(input, parseQuery(c, invoiceDocumentWaitQuerySchema));
+    const db = c.get("db");
+    const [{ bookingItems, bookings }, { bookingPaymentSchedules }, { and, asc, eq }, { issueInvoiceFromBooking, issueProformaFromBooking },] = await Promise.all([
+        import("@voyant-travel/bookings/schema"),
+        import("./schema.js"),
+        import("drizzle-orm"),
+        import("./service-issue.js"),
+    ]);
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, input.bookingId))
+        .limit(1);
+    if (!booking) {
+        return c.json({ error: "Booking not found" }, 404);
+    }
+    const items = await db
+        .select()
+        .from(bookingItems)
+        .where(eq(bookingItems.bookingId, booking.id))
+        .orderBy(asc(bookingItems.createdAt), asc(bookingItems.id));
+    const [paymentSchedule] = input.bookingPaymentScheduleId
+        ? await db
+            .select()
+            .from(bookingPaymentSchedules)
+            .where(and(eq(bookingPaymentSchedules.id, input.bookingPaymentScheduleId), eq(bookingPaymentSchedules.bookingId, booking.id)))
+            .limit(1)
+        : [];
+    if (input.bookingPaymentScheduleId && !paymentSchedule) {
+        return c.json({ error: "Booking payment schedule not found" }, 404);
+    }
+    const runtime = (() => {
+        try {
+            return c.var.container?.resolve(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY);
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    const issuer = input.invoiceType === "proforma" ? issueProformaFromBooking : issueInvoiceFromBooking;
+    let row;
+    try {
+        row = await issuer(db, input, {
+            booking: {
+                id: booking.id,
+                bookingNumber: booking.bookingNumber,
+                personId: booking.personId,
+                organizationId: booking.organizationId,
+                startDate: booking.startDate,
+                endDate: booking.endDate,
+                sellCurrency: booking.sellCurrency,
+                baseCurrency: booking.baseCurrency,
+                fxRateSetId: booking.fxRateSetId,
+                sellAmountCents: booking.sellAmountCents,
+                baseSellAmountCents: booking.baseSellAmountCents,
+            },
+            paymentSchedule: paymentSchedule
+                ? {
+                    id: paymentSchedule.id,
+                    bookingId: paymentSchedule.bookingId,
+                    bookingItemId: paymentSchedule.bookingItemId,
+                    scheduleType: paymentSchedule.scheduleType,
+                    dueDate: paymentSchedule.dueDate,
+                    currency: paymentSchedule.currency,
+                    amountCents: paymentSchedule.amountCents,
+                }
+                : null,
+            items: items.map((item) => ({
+                id: item.id,
+                title: item.title,
+                productId: item.productId,
+                productName: item.productNameSnapshot,
+                productNameSnapshot: item.productNameSnapshot,
+                optionNameSnapshot: item.optionNameSnapshot,
+                unitNameSnapshot: item.unitNameSnapshot,
+                departureLabelSnapshot: item.departureLabelSnapshot,
+                startDate: item.serviceDate ?? item.startsAt,
+                serviceDate: item.serviceDate,
+                startsAt: item.startsAt,
+                endDate: item.endsAt ?? item.serviceDate,
+                endsAt: item.endsAt,
+                quantity: item.quantity,
+                unitSellAmountCents: item.unitSellAmountCents,
+                totalSellAmountCents: item.totalSellAmountCents,
+            })),
+        }, {
+            ...(runtime ?? {}),
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.invoice.from_booking.route",
+        });
+    }
+    catch (error) {
+        if (error instanceof InvoiceNumberAllocationError) {
+            return c.json({ error: error.code, scope: error.scope, seriesId: error.seriesId ?? null }, 409);
+        }
+        if (error instanceof InvoiceNumberConflictError) {
+            return c.json({
+                error: "Invoice number already exists",
+                code: error.code,
+                invoiceNumber: error.invoiceNumber,
+            }, 409);
+        }
+        if (error instanceof InvoiceFromBookingValidationError) {
+            return c.json({ error: error.message, code: error.code, details: error.details }, error.status);
+        }
+        throw error;
+    }
+    if (!row || waitRequest.mode === "none") {
+        return c.json({ data: row }, 201);
+    }
+    const waitResult = await waitForInvoiceRendition(db, row.id, {
+        format: waitFormatForMode(waitRequest.mode),
+        timeoutMs: waitRequest.timeoutMs,
+    });
+    const payload = {
+        invoice: row,
+        rendition: waitResult.rendition,
+    };
+    if (waitResult.status !== "ready") {
+        return c.json({ data: payload }, 202);
+    }
+    const download = await buildInlineDownload(c, waitResult.rendition);
+    if (download.status !== "ready") {
+        return c.json({ data: payload }, 202);
+    }
+    return c.json({ data: { ...payload, download: download.download } }, 201);
+})
+    // POST /invoices/:id/convert-to-invoice — Convert a proforma into a final invoice
+    .post("/invoices/:id/convert-to-invoice", async (c) => {
+    const { convertProformaToInvoice } = await import("./service-issue.js");
+    const input = await c.req
+        .json()
+        .catch(() => ({}));
+    const runtime = (() => {
+        try {
+            return c.var.container?.resolve(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY);
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    let result;
+    try {
+        result = await convertProformaToInvoice(c.get("db"), c.req.param("id"), input, {
+            eventBus: runtime?.eventBus,
+        });
+    }
+    catch (error) {
+        if (error instanceof InvoiceNumberConflictError) {
+            return c.json({
+                error: "Invoice number already exists",
+                code: error.code,
+                invoiceNumber: error.invoiceNumber,
+            }, 409);
+        }
+        throw error;
+    }
+    if (result.status === "not_found") {
+        return c.json({ error: "Invoice not found" }, 404);
+    }
+    if (result.status === "not_proforma") {
+        return c.json({ error: "Only proforma invoices can be converted" }, 409);
+    }
+    if (result.status === "already_converted") {
+        return c.json({
+            error: "This proforma has already been converted",
+            code: "proforma_already_converted",
+            existingInvoiceId: result.invoice?.id ?? null,
+            existingInvoiceNumber: result.invoice?.invoiceNumber ?? null,
+        }, 409);
+    }
+    if (result.status === "duplicate_fiscal_invoice") {
+        return c.json({
+            error: "A fiscal invoice already exists for this booking amount",
+            code: "duplicate_fiscal_invoice",
+            existingInvoiceId: result.invoice.id,
+            existingInvoiceNumber: result.invoice.invoiceNumber,
+        }, 409);
+    }
+    return c.json({ data: result.invoice }, 201);
+});