@voyantjs/finance 0.75.6 → 0.76.0

package/dist/routes.d.ts

@@ -8,7 +8,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                 data: {
                     total: number;
                     countsByStatus: {
-                        status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                        status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                         count: number;
                     }[];
                     counts: {
@@ -59,7 +59,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                         id: string;
                         invoiceNumber: string | null;
                         bookingId: string | null;
-                        status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                        status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                         currency: string;
                         totalCents: number;
                         balanceDueCents: number;
@@ -2357,7 +2357,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     bookingId: string;
                     personId: string | null;
                     organizationId: string | null;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     currency: string;
                     baseCurrency: string | null;
                     fxRateSetId: string | null;
@@ -2394,7 +2394,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
             output: {
                 data: {
                     id: string;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     organizationId: string | null;
                     createdAt: string;
                     currency: string;
@@ -2441,12 +2441,21 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
             };
             outputFormat: "json";
             status: 404;
+        } | {
+            input: {};
+            output: {
+                error: "invoice_number_series_not_found" | "invoice_number_series_inactive" | "invoice_number_series_scope_mismatch" | "no_active_series_for_scope";
+                scope: "invoice" | "proforma";
+                seriesId: string | null;
+            };
+            outputFormat: "json";
+            status: 409;
         } | {
             input: {};
             output: {
                 data: {
                     id: string;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     organizationId: string | null;
                     createdAt: string;
                     currency: string;
@@ -2482,6 +2491,128 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
             };
             outputFormat: "json";
             status: 201;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    invoice: {
+                        id: string;
+                        status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                        organizationId: string | null;
+                        createdAt: string;
+                        currency: string;
+                        notes: string | null;
+                        updatedAt: string;
+                        bookingId: string;
+                        personId: string | null;
+                        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;
+                        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;
+                    };
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        templateId: string | null;
+                        language: string | null;
+                        invoiceId: string;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        errorMessage: string | null;
+                        generatedAt: string | null;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: 202;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    download: {
+                        url: string;
+                        expiresAt: string | null;
+                    };
+                    invoice: {
+                        id: string;
+                        status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                        organizationId: string | null;
+                        createdAt: string;
+                        currency: string;
+                        notes: string | null;
+                        updatedAt: string;
+                        bookingId: string;
+                        personId: string | null;
+                        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;
+                        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;
+                    };
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        templateId: string | null;
+                        language: string | null;
+                        invoiceId: string;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        errorMessage: string | null;
+                        generatedAt: string | null;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
         };
     };
 } & {
@@ -2517,7 +2648,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
             output: {
                 data: {
                     id: string;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     organizationId: string | null;
                     createdAt: string;
                     currency: string;
@@ -2588,7 +2719,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     bookingId: string;
                     personId: string | null;
                     organizationId: string | null;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     currency: string;
                     baseCurrency: string | null;
                     fxRateSetId: string | null;
@@ -2648,7 +2779,7 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     bookingId: string;
                     personId: string | null;
                     organizationId: string | null;
-                    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+                    status: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
                     currency: string;
                     baseCurrency: string | null;
                     fxRateSetId: string | null;
@@ -3269,6 +3400,9 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     resetStrategy: "never" | "annual" | "monthly";
                     resetAt: string | null;
                     scope: "invoice" | "proforma" | "credit_note";
+                    isDefault: boolean;
+                    externalProvider: string | null;
+                    externalConfigKey: string | null;
                     active: boolean;
                     createdAt: string;
                     updatedAt: string;
@@ -3300,6 +3434,9 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     currentSequence: number;
                     resetStrategy: "never" | "annual" | "monthly";
                     resetAt: string | null;
+                    isDefault: boolean;
+                    externalProvider: string | null;
+                    externalConfigKey: string | null;
                 } | null;
             };
             outputFormat: "json";
@@ -3337,6 +3474,9 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     resetStrategy: "never" | "annual" | "monthly";
                     resetAt: string | null;
                     scope: "invoice" | "proforma" | "credit_note";
+                    isDefault: boolean;
+                    externalProvider: string | null;
+                    externalConfigKey: string | null;
                     active: boolean;
                     createdAt: string;
                     updatedAt: string;
@@ -3377,6 +3517,9 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     resetStrategy: "never" | "annual" | "monthly";
                     resetAt: string | null;
                     scope: "invoice" | "proforma" | "credit_note";
+                    isDefault: boolean;
+                    externalProvider: string | null;
+                    externalConfigKey: string | null;
                     active: boolean;
                     createdAt: string;
                     updatedAt: string;
@@ -3494,11 +3637,11 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
                     metadata: import("hono/utils/types").JSONValue;
                     language: string;
                     jurisdiction: string | null;
+                    isDefault: boolean;
                     slug: string;
                     bodyFormat: "html" | "markdown" | "lexical_json";
                     body: string;
                     cssStyles: string | null;
-                    isDefault: boolean;
                 } | null;
             };
             outputFormat: "json";
@@ -4427,6 +4570,66 @@ export declare const financeRoutes: import("hono/hono-base").HonoBase<Env, {
             };
             outputFormat: "json";
             status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        templateId: string | null;
+                        language: string | null;
+                        invoiceId: string;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        errorMessage: string | null;
+                        generatedAt: string | null;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: 202;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    download: {
+                        url: string;
+                        expiresAt: string | null;
+                    };
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        templateId: string | null;
+                        language: string | null;
+                        invoiceId: string;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        errorMessage: string | null;
+                        generatedAt: string | null;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: 201;
         } | {
             input: {
                 param: {

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AA+I7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAokDtB,CAAA;AAEJ,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAA;AAChD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAuJ7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAqnDtB,CAAA;AAEJ,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAA;AAChD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA"}

package/dist/routes.js

@@ -1,27 +1,27 @@
 import { parseJsonBody, parseQuery, requireUserId } from "@voyantjs/hono";
 import { Hono } from "hono";
+import { resolveStoredDocumentDownload } from "./document-download.js";
 import { FINANCE_ROUTE_RUNTIME_CONTAINER_KEY } from "./route-runtime.js";
-import { financeService, PaymentValidationError } from "./service.js";
+import { financeService, InvoiceNumberAllocationError, PaymentValidationError } from "./service.js";
+import { waitForInvoiceRendition, waitFormatForMode, } from "./service-rendition-wait.js";
 import { VoucherServiceError } from "./service-vouchers.js";
-import { agingReportQuerySchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, financeAggregatesQuerySchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceAttachmentSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxClassSchema, insertTaxPolicyProfileSchema, insertTaxPolicyRuleSchema, insertTaxRegimeSchema, insertVoucherSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentListQuerySchema, paymentSessionListQuerySchema, profitabilityQuerySchema, redeemVoucherSchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxClassListQuerySchema, taxPolicyProfileListQuerySchema, taxPolicyRuleListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteSchema, updateInvoiceAttachmentSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxClassSchema, updateTaxPolicyProfileSchema, updateTaxPolicyRuleSchema, updateTaxRegimeSchema, updateVoucherSchema, voucherListQuerySchema, } from "./validation.js";
+import { agingReportQuerySchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, financeAggregatesQuerySchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceAttachmentSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxClassSchema, insertTaxPolicyProfileSchema, insertTaxPolicyRuleSchema, insertTaxRegimeSchema, insertVoucherSchema, invoiceDocumentWaitQuerySchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentListQuerySchema, paymentSessionListQuerySchema, profitabilityQuerySchema, redeemVoucherSchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxClassListQuerySchema, taxPolicyProfileListQuerySchema, taxPolicyRuleListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteSchema, updateInvoiceAttachmentSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxClassSchema, updateTaxPolicyProfileSchema, updateTaxPolicyRuleSchema, updateTaxRegimeSchema, updateVoucherSchema, voucherListQuerySchema, } from "./validation.js";
 // ==========================================================================
 // Finance Routes — method-chained for Hono RPC type inference
 // ==========================================================================
-function getMetadataRecord(metadata) {
-    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
-        return null;
-    }
-    return metadata;
-}
-function maybeUrl(value) {
-    return typeof value === "string" && /^https?:\/\//i.test(value) ? value : null;
+const DEFAULT_RENDITION_WAIT_TIMEOUT_MS = 30_000;
+function resolveWaitRequest(body, query) {
+    return {
+        mode: query.wait ?? body.wait ?? "none",
+        timeoutMs: query.waitTimeoutMs ?? body.waitTimeoutMs ?? DEFAULT_RENDITION_WAIT_TIMEOUT_MS,
+    };
 }
-function getFallbackDownloadUrl(metadata) {
-    const record = getMetadataRecord(metadata);
-    if (!record) {
-        return null;
-    }
-    return maybeUrl(record.url);
+async function buildInlineDownload(c, reference) {
+    const runtime = getFinanceRouteRuntime(c);
+    return resolveStoredDocumentDownload(reference, {
+        bindings: c.env,
+        resolveDocumentDownloadUrl: runtime?.resolveDocumentDownloadUrl,
+    });
 }
 function getFinanceRouteRuntime(c) {
     try {
@@ -590,6 +590,7 @@ export const financeRoutes = new Hono()
     // POST /invoices/from-booking — Create + issue invoice (or proforma) from booking + booking items
     .post("/invoices/from-booking", async (c) => {
     const input = await parseJsonBody(c, invoiceFromBookingSchema);
+    const waitRequest = resolveWaitRequest(input, parseQuery(c, invoiceDocumentWaitQuerySchema));
     const db = c.get("db");
     const [{ bookingItems, bookings }, { eq }, { issueInvoiceFromBooking, issueProformaFromBooking },] = await Promise.all([
         import("@voyantjs/bookings/schema"),
@@ -614,31 +615,58 @@ export const financeRoutes = new Hono()
         }
     })();
     const issuer = input.invoiceType === "proforma" ? issueProformaFromBooking : issueInvoiceFromBooking;
-    const row = await issuer(db, input, {
-        booking: {
-            id: booking.id,
-            bookingNumber: booking.bookingNumber,
-            personId: booking.personId,
-            organizationId: booking.organizationId,
-            sellCurrency: booking.sellCurrency,
-            baseCurrency: booking.baseCurrency,
-            fxRateSetId: null,
-            sellAmountCents: booking.sellAmountCents,
-            baseSellAmountCents: booking.baseSellAmountCents,
-        },
-        items: items.map((item) => ({
-            id: item.id,
-            title: item.title,
-            quantity: item.quantity,
-            unitSellAmountCents: item.unitSellAmountCents,
-            totalSellAmountCents: item.totalSellAmountCents,
-        })),
-    }, {
-        eventBus: runtime?.eventBus,
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.invoice.from_booking.route",
+    let row;
+    try {
+        row = await issuer(db, input, {
+            booking: {
+                id: booking.id,
+                bookingNumber: booking.bookingNumber,
+                personId: booking.personId,
+                organizationId: booking.organizationId,
+                sellCurrency: booking.sellCurrency,
+                baseCurrency: booking.baseCurrency,
+                fxRateSetId: null,
+                sellAmountCents: booking.sellAmountCents,
+                baseSellAmountCents: booking.baseSellAmountCents,
+            },
+            items: items.map((item) => ({
+                id: item.id,
+                title: item.title,
+                quantity: item.quantity,
+                unitSellAmountCents: item.unitSellAmountCents,
+                totalSellAmountCents: item.totalSellAmountCents,
+            })),
+        }, {
+            eventBus: runtime?.eventBus,
+            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);
+        }
+        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,
     });
-    return c.json({ data: row }, 201);
+    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) => {
@@ -1085,19 +1113,14 @@ export const financeRoutes = new Hono()
     const attachment = await financeService.getInvoiceAttachmentById(c.get("db"), c.req.param("id"));
     if (!attachment)
         return c.json({ error: "Attachment not found" }, 404);
-    let location = null;
-    if (attachment.storageKey) {
-        const runtime = getFinanceRouteRuntime(c);
-        if (!runtime?.resolveDocumentDownloadUrl) {
-            return c.json({ error: "Document download resolver is not configured" }, 501);
-        }
-        location = await runtime.resolveDocumentDownloadUrl(c.env, attachment.storageKey);
+    const download = await buildInlineDownload(c, attachment);
+    if (download.status === "resolver_not_configured") {
+        return c.json({ error: "Document download resolver is not configured" }, 501);
     }
-    location ??= getFallbackDownloadUrl(attachment.metadata);
-    if (!location) {
+    if (download.status !== "ready") {
         return c.json({ error: "Attachment file is not available" }, 404);
     }
-    return c.redirect(location, 302);
+    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"));
@@ -1107,9 +1130,28 @@ export const financeRoutes = new Hono()
 })
     .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) => {

package/dist/schema.d.ts

@@ -1,4 +1,4 @@
-export declare const invoiceStatusEnum: import("drizzle-orm/pg-core").PgEnum<["draft", "sent", "partially_paid", "paid", "overdue", "void"]>;
+export declare const invoiceStatusEnum: import("drizzle-orm/pg-core").PgEnum<["draft", "pending_external_allocation", "sent", "partially_paid", "paid", "overdue", "void"]>;
 export declare const paymentMethodEnum: import("drizzle-orm/pg-core").PgEnum<["bank_transfer", "credit_card", "debit_card", "cash", "cheque", "wallet", "direct_bill", "voucher", "other"]>;
 export declare const paymentStatusEnum: import("drizzle-orm/pg-core").PgEnum<["pending", "completed", "failed", "refunded"]>;
 export declare const paymentSessionStatusEnum: import("drizzle-orm/pg-core").PgEnum<["pending", "requires_redirect", "processing", "authorized", "paid", "failed", "cancelled", "expired"]>;
@@ -3394,14 +3394,14 @@ export declare const invoices: import("drizzle-orm/pg-core").PgTableWithColumns<
             tableName: "invoices";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
+            data: "draft" | "pending_external_allocation" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["draft", "sent", "partially_paid", "paid", "overdue", "void"];
+            enumValues: ["draft", "pending_external_allocation", "sent", "partially_paid", "paid", "overdue", "void"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
@@ -5169,6 +5169,57 @@ export declare const invoiceNumberSeries: import("drizzle-orm/pg-core").PgTableW
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        isDefault: import("drizzle-orm/pg-core").PgColumn<{
+            name: "is_default";
+            tableName: "invoice_number_series";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        externalProvider: import("drizzle-orm/pg-core").PgColumn<{
+            name: "external_provider";
+            tableName: "invoice_number_series";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        externalConfigKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "external_config_key";
+            tableName: "invoice_number_series";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         active: import("drizzle-orm/pg-core").PgColumn<{
             name: "active";
             tableName: "invoice_number_series";