@voyant-travel/finance 0.138.3 → 0.138.5

package/dist/checkout-routes.d.ts

@@ -37,6 +37,7 @@ export type CheckoutRouteRuntime = {
     listBookingReminderRuns?: CheckoutRoutesOptions["listBookingReminderRuns"];
 };
 export declare const CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY = "providers.finance.checkout.runtime";
+export declare const CHECKOUT_ROUTE_RUNTIME_NOT_CONFIGURED_MESSAGE = "Checkout payment links require a configured checkout provider. Configure a Finance checkout runtime with a card payment starter before generating payment links.";
 export declare function createCheckoutRoutes(options?: CheckoutRoutesOptions): import("hono/hono-base").HonoBase<Env, {
     "/bookings/:bookingId/collection-plan": {
         $post: {
@@ -353,6 +354,17 @@ export declare function createCheckoutRoutes(options?: CheckoutRoutesOptions): i
             };
             outputFormat: "json";
             status: 201;
+        } | {
+            input: {
+                param: {
+                    bookingId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
         } | {
             input: {
                 param: {
@@ -581,6 +593,13 @@ export declare function createCheckoutRoutes(options?: CheckoutRoutesOptions): i
             };
             outputFormat: "json";
             status: 201;
+        } | {
+            input: {};
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
         } | {
             input: {};
             output: {
@@ -907,6 +926,17 @@ export declare function createCheckoutAdminRoutes(options?: CheckoutRoutesOption
             };
             outputFormat: "json";
             status: 201;
+        } | {
+            input: {
+                param: {
+                    bookingId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
         } | {
             input: {
                 param: {
@@ -1135,6 +1165,13 @@ export declare function createCheckoutAdminRoutes(options?: CheckoutRoutesOption
             };
             outputFormat: "json";
             status: 201;
+        } | {
+            input: {};
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
         } | {
             input: {};
             output: {

package/dist/checkout-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout-routes.d.ts","sourceRoot":"","sources":["../src/checkout-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAQ1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAG3B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAI/B,MAAM,0BAA0B,CAAA;AAEjC,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,SAAS,EAAE,eAAe,CAAA;QAC1B,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,sBAAsB,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC9D,6BAA6B,CAAC,EAAE,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,8BAA8B,GAAG,IAAI,CAAA;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACxD,sBAAsB,CAAC,EAAE,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IAC3C,mBAAmB,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACxD,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,2BAA2B,GAAG,IAAI,CAAA;IACvC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,4BAA4B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/F,uBAAuB,CAAC,EAAE,CACxB,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtC,CAAA;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,yBAAyB,EAAE,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,sBAAsB,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC7D,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACvD,mBAAmB,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACvD,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,uBAAuB,CAAC,EAAE,qBAAqB,CAAC,yBAAyB,CAAC,CAAA;CAC3E,CAAA;AAED,eAAO,MAAM,oCAAoC,uCAAuC,CAAA;AAkHxF,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAKvE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAgB5E;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAYtB;AAED,eAAO,MAAM,2BAA2B,6BAAuB,CAAA;AAC/D,eAAO,MAAM,gCAAgC,kCAA4B,CAAA;AACzE,eAAO,MAAM,gCAAgC,kCAA4B,CAAA;AACzE,eAAO,MAAM,4CAA4C,uCAAuC,CAAA"}
+{"version":3,"file":"checkout-routes.d.ts","sourceRoot":"","sources":["../src/checkout-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAQ1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAG3B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAI/B,MAAM,0BAA0B,CAAA;AAEjC,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,SAAS,EAAE,eAAe,CAAA;QAC1B,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,sBAAsB,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC9D,6BAA6B,CAAC,EAAE,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,8BAA8B,GAAG,IAAI,CAAA;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACxD,sBAAsB,CAAC,EAAE,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IAC3C,mBAAmB,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACxD,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,2BAA2B,GAAG,IAAI,CAAA;IACvC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,4BAA4B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/F,uBAAuB,CAAC,EAAE,CACxB,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtC,CAAA;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,yBAAyB,EAAE,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,sBAAsB,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC7D,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACvD,mBAAmB,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACvD,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,uBAAuB,CAAC,EAAE,qBAAqB,CAAC,yBAAyB,CAAC,CAAA;CAC3E,CAAA;AAED,eAAO,MAAM,oCAAoC,uCAAuC,CAAA;AACxF,eAAO,MAAM,6CAA6C,qKAC0G,CAAA;AA4HpK,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAKvE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAc5E;AAuBD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAYtB;AAED,eAAO,MAAM,2BAA2B,6BAAuB,CAAA;AAC/D,eAAO,MAAM,gCAAgC,kCAA4B,CAAA;AACzE,eAAO,MAAM,gCAAgC,kCAA4B,CAAA;AACzE,eAAO,MAAM,4CAA4C,uCAAuC,CAAA"}

package/dist/checkout-routes.js

@@ -4,6 +4,12 @@ import { Hono } from "hono";
 import { bootstrapCheckoutCollection, initiateCheckoutCollection, previewCheckoutCollection, } from "./checkout-service.js";
 import { bootstrapCheckoutCollectionSchema, checkoutReminderRunListQuerySchema, initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./checkout-validation.js";
 export const CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY = "providers.finance.checkout.runtime";
+export const CHECKOUT_ROUTE_RUNTIME_NOT_CONFIGURED_MESSAGE = "Checkout payment links require a configured checkout provider. Configure a Finance checkout runtime with a card payment starter before generating payment links.";
+class CheckoutRouteRuntimeNotConfiguredError extends Error {
+    constructor() {
+        super(CHECKOUT_ROUTE_RUNTIME_NOT_CONFIGURED_MESSAGE);
+    }
+}
 function runtimeEnv(c) {
     return c.env;
 }
@@ -26,9 +32,8 @@ function attachCollectionRoutes(app, options) {
     // Pin the middleware to this module's Env so Hono doesn't intersect the
     // middleware's default VoyantBindings into the handlers' `c.env` type.
     const collectionIdempotency = () => idempotencyKey();
-    function getRuntime(bindings, resolveFromContainer) {
-        return (resolveFromContainer?.(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY) ??
-            buildCheckoutRouteRuntime(bindings, options));
+    function getRuntime(bindings, container) {
+        return resolveCheckoutRouteRuntime(bindings, options, container);
     }
     return (app
         // Mostly a read, but `ensureDefaultPaymentPlan` can materialize a
@@ -49,8 +54,10 @@ function attachCollectionRoutes(app, options) {
     })
         .post("/bookings/:bookingId/initiate-collection", collectionIdempotency(), async (c) => {
         try {
-            const runtime = getRuntime(c.env, (key) => c.var.container?.resolve(key));
-            const result = await initiateCheckoutCollection(c.get("db"), c.req.param("bookingId"), await parseJsonBody(c, initiateCheckoutCollectionSchema), options.policy, runtime);
+            const input = await parseJsonBody(c, initiateCheckoutCollectionSchema);
+            const runtime = getRuntime(c.env, c.var.container);
+            assertCheckoutRuntimeSupportsCollection(runtime, input);
+            const result = await initiateCheckoutCollection(c.get("db"), c.req.param("bookingId"), input, options.policy, runtime);
             if (!result) {
                 return c.json({ error: "Booking not found" }, 404);
             }
@@ -61,13 +68,18 @@ function attachCollectionRoutes(app, options) {
             if (message.includes("Booking not found")) {
                 return c.json({ error: message }, 404);
             }
+            if (error instanceof CheckoutRouteRuntimeNotConfiguredError) {
+                return c.json({ error: message }, 501);
+            }
             return c.json({ error: message }, 409);
         }
     })
         .post("/collections/bootstrap", collectionIdempotency(), async (c) => {
         try {
-            const runtime = getRuntime(c.env, (key) => c.var.container?.resolve(key));
-            const result = await bootstrapCheckoutCollection(c.get("db"), await parseJsonBody(c, bootstrapCheckoutCollectionSchema), options.policy, runtime);
+            const input = await parseJsonBody(c, bootstrapCheckoutCollectionSchema);
+            const runtime = getRuntime(c.env, c.var.container);
+            assertCheckoutRuntimeSupportsCollection(runtime, input);
+            const result = await bootstrapCheckoutCollection(c.get("db"), input, options.policy, runtime);
             if (!result) {
                 return c.json({ error: "Booking session not found" }, 404);
             }
@@ -78,6 +90,9 @@ function attachCollectionRoutes(app, options) {
             if (message.includes("Booking not found")) {
                 return c.json({ error: message }, 404);
             }
+            if (error instanceof CheckoutRouteRuntimeNotConfiguredError) {
+                return c.json({ error: message }, 501);
+            }
             return c.json({ error: message }, 409);
         }
     }));
@@ -91,8 +106,7 @@ export function createCheckoutRoutes(options = {}) {
 export function createCheckoutAdminRoutes(options = {}) {
     const app = new Hono().get("/bookings/:bookingId/reminder-runs", async (c) => {
         const query = parseQuery(c, checkoutReminderRunListQuerySchema);
-        const runtime = c.var.container?.resolve(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY) ??
-            buildCheckoutRouteRuntime(c.env, options);
+        const runtime = resolveCheckoutRouteRuntime(c.env, options, c.var.container);
         if (!runtime.listBookingReminderRuns) {
             return c.json({ data: [], total: 0, limit: query.limit, offset: query.offset });
         }
@@ -100,6 +114,17 @@ export function createCheckoutAdminRoutes(options = {}) {
     });
     return attachCollectionRoutes(app, options);
 }
+function resolveCheckoutRouteRuntime(bindings, options, container) {
+    if (container?.has(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY)) {
+        return container.resolve(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY);
+    }
+    return buildCheckoutRouteRuntime(bindings, options);
+}
+function assertCheckoutRuntimeSupportsCollection(runtime, input) {
+    if (input.method === "card" && Object.keys(runtime.paymentStarters).length === 0) {
+        throw new CheckoutRouteRuntimeNotConfiguredError();
+    }
+}
 export function buildCheckoutRouteRuntime(bindings, options = {}) {
     return {
         bindings,

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

@@ -274,6 +274,29 @@ export declare const financeInvoiceCoreRoutes: OpenAPIHono<Env, import("hono/typ
             };
             outputFormat: "json";
             status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    creditNoteNumber: string;
+                    amountCents: number;
+                    currency: string;
+                    reason: string;
+                    status?: "draft" | "issued" | "applied" | undefined;
+                    baseCurrency?: string | null | undefined;
+                    baseAmountCents?: number | null | undefined;
+                    fxRateSetId?: string | null | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
         } | {
             input: {
                 param: {
@@ -363,6 +386,30 @@ export declare const financeInvoiceCoreRoutes: OpenAPIHono<Env, import("hono/typ
             };
             outputFormat: "json";
             status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                    creditNoteId: string;
+                };
+            } & {
+                json: {
+                    creditNoteNumber?: string | undefined;
+                    status?: "draft" | "issued" | "applied" | undefined;
+                    amountCents?: number | undefined;
+                    currency?: string | undefined;
+                    baseCurrency?: string | null | undefined;
+                    baseAmountCents?: number | null | undefined;
+                    fxRateSetId?: string | null | undefined;
+                    reason?: string | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
         } | {
             input: {
                 param: {
@@ -1005,6 +1052,43 @@ export declare const financeInvoiceCoreRoutes: OpenAPIHono<Env, import("hono/typ
             };
             outputFormat: "json";
             status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            } & {
+                json: {
+                    invoiceNumber?: string | undefined;
+                    bookingId?: string | undefined;
+                    personId?: string | null | undefined;
+                    organizationId?: string | null | undefined;
+                    status?: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void" | undefined;
+                    currency?: string | undefined;
+                    baseCurrency?: string | null | undefined;
+                    fxRateSetId?: string | null | undefined;
+                    subtotalCents?: number | undefined;
+                    baseSubtotalCents?: number | null | undefined;
+                    taxCents?: number | undefined;
+                    baseTaxCents?: number | null | undefined;
+                    totalCents?: number | undefined;
+                    baseTotalCents?: number | null | undefined;
+                    paidCents?: number | undefined;
+                    basePaidCents?: number | null | undefined;
+                    balanceDueCents?: number | undefined;
+                    baseBalanceDueCents?: number | null | undefined;
+                    commissionPercent?: number | null | undefined;
+                    commissionAmountCents?: number | null | undefined;
+                    issueDate?: string | undefined;
+                    dueDate?: string | undefined;
+                    notes?: string | null | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
         };
     };
 } & {
@@ -1068,6 +1152,17 @@ export declare const financeInvoiceCoreRoutes: OpenAPIHono<Env, import("hono/typ
             };
             outputFormat: "json";
             status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
         } | {
             input: {
                 param: {
@@ -1115,17 +1210,6 @@ export declare const financeInvoiceCoreRoutes: OpenAPIHono<Env, import("hono/typ
             };
             outputFormat: "json";
             status: 200;
-        } | {
-            input: {
-                param: {
-                    id: string;
-                };
-            };
-            output: {
-                error: string;
-            };
-            outputFormat: "json";
-            status: 409;
         };
     };
 } & {

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

@@ -1 +1 @@
-{"version":3,"file":"routes-invoice-core.d.ts","sourceRoot":"","sources":["../src/routes-invoice-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAe/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAgqB7C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQZ,CAAA"}
+{"version":3,"file":"routes-invoice-core.d.ts","sourceRoot":"","sources":["../src/routes-invoice-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAe/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAgwB7C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQZ,CAAA"}

package/dist/routes-invoice-core.js

@@ -25,7 +25,7 @@ import { createRoute, OpenAPIHono, z } from "@hono/zod-openapi";
 import { openApiValidationHook, parseOptionalJsonBody, requireUserId } from "@voyant-travel/hono";
 import { creditNoteLineItemSchema, creditNoteSchema, errorResponseSchema, financeNoteSchema, invoiceDetailSchema, invoiceLineItemSchema, invoiceSchema, paymentSchema, paymentSessionSchema, successResponseSchema, } from "./routes-invoice-schemas.js";
 import { getActionLedgerRequestContext, getFinanceRouteRuntime } from "./routes-runtime.js";
-import { financeService, PaymentValidationError } from "./service.js";
+import { financeService, InvoiceNumberConflictError, InvoiceValidationError, PaymentValidationError, } from "./service.js";
 import { createPaymentSessionFromInvoiceSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceLineItemSchema, insertPaymentSchema, updateCreditNoteSchema, updateInvoiceLineItemSchema, updateInvoiceSchema, voidInvoiceSchema, } from "./validation.js";
 const idParamSchema = z.object({ id: z.string() });
 const lineParamSchema = z.object({ id: z.string(), lineId: z.string() });
@@ -69,6 +69,10 @@ const updateInvoiceRoute = createRoute({
             description: "Invoice not found",
             content: { "application/json": { schema: errorResponseSchema } },
         },
+        409: {
+            description: "Invoice number already exists",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
     },
 });
 const deleteInvoiceRoute = createRoute({
@@ -154,13 +158,28 @@ const invoiceActionRoutes = new OpenAPIHono({ defaultHook: openApiValidationHook
     return row ? c.json({ data: row }, 200) : c.json({ error: "Invoice not found" }, 404);
 })
     .openapi(updateInvoiceRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.updateInvoice(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
-        eventBus: runtime?.eventBus,
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.invoice.route",
-    });
-    return row ? c.json({ data: row }, 200) : c.json({ error: "Invoice not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.updateInvoice(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
+            eventBus: runtime?.eventBus,
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.invoice.route",
+        });
+        return row ? c.json({ data: row }, 200) : c.json({ error: "Invoice not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceNumberConflictError) {
+            return c.json({
+                error: "Invoice number already exists",
+                code: error.code,
+                invoiceNumber: error.invoiceNumber,
+            }, 409);
+        }
+        if (error instanceof InvoiceValidationError) {
+            return c.json({ error: error.message, code: error.code, details: error.details }, error.status);
+        }
+        throw error;
+    }
 })
     .openapi(deleteInvoiceRoute, async (c) => {
     const runtime = getFinanceRouteRuntime(c);
@@ -304,22 +323,48 @@ const deleteInvoiceLineItemRoute = createRoute({
 const invoiceLineItemRoutes = new OpenAPIHono({ defaultHook: openApiValidationHook })
     .openapi(listInvoiceLineItemsRoute, async (c) => c.json({ data: await financeService.listInvoiceLineItems(c.get("db"), c.req.valid("param").id) }, 200))
     .openapi(createInvoiceLineItemRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.createInvoiceLineItem(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
-        eventBus: runtime?.eventBus,
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.invoice_line_item.route",
-    });
-    return row ? c.json({ data: row }, 201) : c.json({ error: "Invoice not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.createInvoiceLineItem(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
+            eventBus: runtime?.eventBus,
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.invoice_line_item.route",
+        });
+        return row ? c.json({ data: row }, 201) : c.json({ error: "Invoice not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceValidationError) {
+            if (error.status === 404) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 404);
+            }
+            if (error.status === 409)
+                throw error;
+            return c.json({ error: error.message, code: error.code, details: error.details }, 400);
+        }
+        throw error;
+    }
 })
     .openapi(updateInvoiceLineItemRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.updateInvoiceLineItem(c.get("db"), c.req.valid("param").lineId, c.req.valid("json"), {
-        eventBus: runtime?.eventBus,
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.invoice_line_item.route",
-    });
-    return row ? c.json({ data: row }, 200) : c.json({ error: "Line item not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.updateInvoiceLineItem(c.get("db"), c.req.valid("param").lineId, c.req.valid("json"), {
+            eventBus: runtime?.eventBus,
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.invoice_line_item.route",
+        });
+        return row ? c.json({ data: row }, 200) : c.json({ error: "Line item not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceValidationError) {
+            if (error.status === 404) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 404);
+            }
+            if (error.status === 409)
+                throw error;
+            return c.json({ error: error.message, code: error.code, details: error.details }, 400);
+        }
+        throw error;
+    }
 })
     .openapi(deleteInvoiceLineItemRoute, async (c) => {
     const runtime = getFinanceRouteRuntime(c);
@@ -428,6 +473,10 @@ const createCreditNoteRoute = createRoute({
             description: "Invoice not found",
             content: { "application/json": { schema: errorResponseSchema } },
         },
+        409: {
+            description: "Credit note would exceed the invoice balance due",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
     },
 });
 const updateCreditNoteRoute = createRoute({
@@ -453,27 +502,59 @@ const updateCreditNoteRoute = createRoute({
             description: "Credit note not found",
             content: { "application/json": { schema: errorResponseSchema } },
         },
+        409: {
+            description: "Credit note would exceed the invoice balance due",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
     },
 });
 const creditNoteRoutes = new OpenAPIHono({ defaultHook: openApiValidationHook })
     .openapi(listCreditNotesRoute, async (c) => c.json({ data: await financeService.listCreditNotes(c.get("db"), c.req.valid("param").id) }, 200))
     .openapi(createCreditNoteRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.createCreditNote(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
-        ...(runtime ?? {}),
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.credit_note.route",
-    });
-    return row ? c.json({ data: row }, 201) : c.json({ error: "Invoice not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.createCreditNote(c.get("db"), c.req.valid("param").id, c.req.valid("json"), {
+            ...(runtime ?? {}),
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.credit_note.route",
+        });
+        return row ? c.json({ data: row }, 201) : c.json({ error: "Invoice not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceValidationError) {
+            if (error.status === 404) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 404);
+            }
+            if (error.status === 409) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 409);
+            }
+            return c.json({ error: error.message, code: error.code, details: error.details }, 400);
+        }
+        throw error;
+    }
 })
     .openapi(updateCreditNoteRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.updateCreditNote(c.get("db"), c.req.valid("param").creditNoteId, c.req.valid("json"), {
-        ...(runtime ?? {}),
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.credit_note.route",
-    });
-    return row ? c.json({ data: row }, 200) : c.json({ error: "Credit note not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.updateCreditNote(c.get("db"), c.req.valid("param").creditNoteId, c.req.valid("json"), {
+            ...(runtime ?? {}),
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.credit_note.route",
+        });
+        return row ? c.json({ data: row }, 200) : c.json({ error: "Credit note not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceValidationError) {
+            if (error.status === 404) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 404);
+            }
+            if (error.status === 409) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 409);
+            }
+            return c.json({ error: error.message, code: error.code, details: error.details }, 400);
+        }
+        throw error;
+    }
 });
 // --- credit note line items ------------------------------------------------
 const listCreditNoteLineItemsRoute = createRoute({
@@ -519,13 +600,26 @@ const creditNoteLineItemRoutes = new OpenAPIHono({ defaultHook: openApiValidatio
     data: await financeService.listCreditNoteLineItems(c.get("db"), c.req.valid("param").creditNoteId),
 }, 200))
     .openapi(createCreditNoteLineItemRoute, async (c) => {
-    const runtime = getFinanceRouteRuntime(c);
-    const row = await financeService.createCreditNoteLineItem(c.get("db"), c.req.valid("param").creditNoteId, c.req.valid("json"), {
-        eventBus: runtime?.eventBus,
-        actionLedgerContext: getActionLedgerRequestContext(c),
-        actionLedgerAuthorizationSource: "finance.credit_note_line_item.route",
-    });
-    return row ? c.json({ data: row }, 201) : c.json({ error: "Credit note not found" }, 404);
+    try {
+        const runtime = getFinanceRouteRuntime(c);
+        const row = await financeService.createCreditNoteLineItem(c.get("db"), c.req.valid("param").creditNoteId, c.req.valid("json"), {
+            eventBus: runtime?.eventBus,
+            actionLedgerContext: getActionLedgerRequestContext(c),
+            actionLedgerAuthorizationSource: "finance.credit_note_line_item.route",
+        });
+        return row ? c.json({ data: row }, 201) : c.json({ error: "Credit note not found" }, 404);
+    }
+    catch (error) {
+        if (error instanceof InvoiceValidationError) {
+            if (error.status === 404) {
+                return c.json({ error: error.message, code: error.code, details: error.details }, 404);
+            }
+            if (error.status === 409)
+                throw error;
+            return c.json({ error: error.message, code: error.code, details: error.details }, 400);
+        }
+        throw error;
+    }
 });
 // --- finance notes ---------------------------------------------------------
 const listNotesRoute = createRoute({

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

@@ -1 +1 @@
-{"version":3,"file":"routes-invoice-issue.d.ts","sourceRoot":"","sources":["../src/routes-invoice-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAc/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AA6G7C,eAAO,MAAM,yBAAyB,2BAEpC,CAAA"}
+{"version":3,"file":"routes-invoice-issue.d.ts","sourceRoot":"","sources":["../src/routes-invoice-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAc/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAsH7C,eAAO,MAAM,yBAAyB,2BAEpC,CAAA"}

package/dist/routes-invoice-issue.js

@@ -18,7 +18,7 @@ import { openApiValidationHook, parseJsonBody } from "@voyant-travel/hono";
 import { listResponseSchema } from "@voyant-travel/types";
 import { errorResponseSchema, invoiceListItemSchema, invoiceSchema, } from "./routes-invoice-schemas.js";
 import { getActionLedgerRequestContext, getFinanceRouteRuntime, routeIdempotencyKey, } from "./routes-runtime.js";
-import { financeService, InvoiceFromBookingValidationError, InvoiceNumberAllocationError, InvoiceNumberConflictError, } from "./service.js";
+import { financeService, InvoiceFromBookingValidationError, InvoiceNumberAllocationError, InvoiceNumberConflictError, InvoiceValidationError, } from "./service.js";
 import { insertInvoiceSchema, invoiceFromBookingSchema, invoiceListQuerySchema, } from "./validation.js";
 const idParamSchema = z.object({ id: z.string() });
 const listInvoicesRoute = createRoute({
@@ -50,6 +50,14 @@ const createInvoiceRoute = createRoute({
             description: "invalid_request: request body failed validation",
             content: { "application/json": { schema: errorResponseSchema } },
         },
+        404: {
+            description: "Booking, person, or organization reference not found",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
+        409: {
+            description: "Invoice number already exists",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
     },
 });
 const issueInvoiceFromBookingRoute = createRoute({
@@ -126,7 +134,24 @@ financeInvoiceIssueRoutes.use("/invoices/from-booking", postOnly(routeIdempotenc
 })));
 financeInvoiceIssueRoutes
     .openapi(listInvoicesRoute, async (c) => c.json(await financeService.listInvoices(c.get("db"), c.req.valid("query")), 200))
-    .openapi(createInvoiceRoute, async (c) => c.json({ data: (await financeService.createInvoice(c.get("db"), c.req.valid("json"))) ?? null }, 201))
+    .openapi(createInvoiceRoute, async (c) => {
+    try {
+        return c.json({ data: (await financeService.createInvoice(c.get("db"), c.req.valid("json"))) ?? null }, 201);
+    }
+    catch (error) {
+        if (error instanceof InvoiceNumberConflictError) {
+            return c.json({
+                error: "Invoice number already exists",
+                code: error.code,
+                invoiceNumber: error.invoiceNumber,
+            }, 409);
+        }
+        if (error instanceof InvoiceValidationError) {
+            return c.json({ error: error.message, code: error.code, details: error.details }, error.status);
+        }
+        throw error;
+    }
+})
     .openapi(issueInvoiceFromBookingRoute, async (c) => {
     const input = c.req.valid("json");
     const db = c.get("db");