@voyant-travel/finance 0.119.5

package/dist/routes-supplier-invoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-supplier-invoices.d.ts","sourceRoot":"","sources":["../src/routes-supplier-invoices.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAoD7C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAsK9B,CAAA;AAEJ,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}

package/dist/routes-supplier-invoices.js

@@ -0,0 +1,159 @@
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { resolveStoredDocumentDownload } from "./document-download.js";
+import { getActionLedgerRequestContext, getFinanceRouteRuntime } from "./routes-runtime.js";
+import { financeService } from "./service.js";
+import { SupplierInvoiceServiceError, supplierInvoicesService, } from "./service-supplier-invoices.js";
+import { insertSupplierInvoiceAttachmentSchema, insertSupplierInvoiceSchema, insertSupplierPaymentSchema, setSupplierCostAllocationsSchema, setSupplierInvoiceLinesSchema, supplierInvoiceListQuerySchema, supplierPaymentListQuerySchema, updateSupplierInvoiceSchema, } from "./validation.js";
+/**
+ * Map a SupplierInvoiceServiceError to HTTP. `not_found` → 404; the allocation
+ * invariant violations (§6.1) → 422. Anything else re-throws to the boundary.
+ */
+function handleSupplierInvoiceError(c, error) {
+    if (error instanceof SupplierInvoiceServiceError) {
+        const status = error.code === "supplier_invoice_not_found" ? 404 : 422;
+        return c.json({ error: error.message, code: error.code }, status);
+    }
+    throw error;
+}
+/**
+ * Action-ledger + FX runtime for the AP (supplier-invoice) service. The FX
+ * options (settings + exchange-rate resolver) let create/update/setLines snapshot
+ * each invoice's accounting-base value at the rate effective on its issue date.
+ */
+function apRuntime(c) {
+    const fx = getFinanceRouteRuntime(c);
+    return {
+        actionLedgerContext: getActionLedgerRequestContext(c),
+        actionLedgerAuthorizationSource: "finance.supplier_invoice.route",
+        ...(fx?.invoiceFxSettings !== undefined ? { invoiceFxSettings: fx.invoiceFxSettings } : {}),
+        ...(fx?.resolveInvoiceFxSettings
+            ? { resolveInvoiceFxSettings: fx.resolveInvoiceFxSettings }
+            : {}),
+        ...(fx?.resolveInvoiceExchangeRate
+            ? { resolveInvoiceExchangeRate: fx.resolveInvoiceExchangeRate }
+            : {}),
+        ...(fx?.onInvoiceFxResolutionError
+            ? { onInvoiceFxResolutionError: fx.onInvoiceFxResolutionError }
+            : {}),
+    };
+}
+export const supplierInvoiceRoutes = new Hono()
+    .get("/supplier-invoices", async (c) => {
+    const query = parseQuery(c, supplierInvoiceListQuerySchema);
+    return c.json(await supplierInvoicesService.list(c.get("db"), query));
+})
+    .post("/supplier-invoices", async (c) => {
+    try {
+        const row = await supplierInvoicesService.create(c.get("db"), await parseJsonBody(c, insertSupplierInvoiceSchema), apRuntime(c));
+        return c.json({ data: row }, 201);
+    }
+    catch (error) {
+        return handleSupplierInvoiceError(c, error);
+    }
+})
+    .get("/supplier-invoices/:id", async (c) => {
+    const row = await supplierInvoicesService.getById(c.get("db"), c.req.param("id"));
+    if (!row)
+        return c.json({ error: "Supplier invoice not found" }, 404);
+    return c.json({ data: row });
+})
+    .patch("/supplier-invoices/:id", async (c) => {
+    const row = await supplierInvoicesService.update(c.get("db"), c.req.param("id"), await parseJsonBody(c, updateSupplierInvoiceSchema), apRuntime(c));
+    if (!row)
+        return c.json({ error: "Supplier invoice not found" }, 404);
+    return c.json({ data: row });
+})
+    .delete("/supplier-invoices/:id", async (c) => {
+    const result = await supplierInvoicesService.softDelete(c.get("db"), c.req.param("id"), apRuntime(c));
+    if (!result)
+        return c.json({ error: "Supplier invoice not found" }, 404);
+    return c.json({ data: result });
+})
+    .put("/supplier-invoices/:id/lines", async (c) => {
+    try {
+        const row = await supplierInvoicesService.setLines(c.get("db"), c.req.param("id"), await parseJsonBody(c, setSupplierInvoiceLinesSchema), apRuntime(c));
+        if (!row)
+            return c.json({ error: "Supplier invoice not found" }, 404);
+        return c.json({ data: row });
+    }
+    catch (error) {
+        // setLines now rejects edits that would over-allocate surviving
+        // whole-invoice allocations (§6.1) → 422 via the shared mapper.
+        return handleSupplierInvoiceError(c, error);
+    }
+})
+    .put("/supplier-invoices/:id/allocations", async (c) => {
+    try {
+        const row = await supplierInvoicesService.setAllocations(c.get("db"), c.req.param("id"), await parseJsonBody(c, setSupplierCostAllocationsSchema), apRuntime(c));
+        if (!row)
+            return c.json({ error: "Supplier invoice not found" }, 404);
+        return c.json({ data: row });
+    }
+    catch (error) {
+        return handleSupplierInvoiceError(c, error);
+    }
+})
+    .get("/supplier-invoices/:id/document/download", async (c) => {
+    const invoice = await supplierInvoicesService.getById(c.get("db"), c.req.param("id"));
+    if (!invoice)
+        return c.json({ error: "Supplier invoice not found" }, 404);
+    if (!invoice.storageKey)
+        return c.json({ error: "No document attached" }, 404);
+    const runtime = getFinanceRouteRuntime(c);
+    const download = await resolveStoredDocumentDownload({ storageKey: invoice.storageKey }, { bindings: c.env, resolveDocumentDownloadUrl: runtime?.resolveDocumentDownloadUrl });
+    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: "Supplier invoice document is not available" }, 404);
+    }
+    return c.redirect(download.download.url, 302);
+})
+    .get("/supplier-invoices/:id/payments", async (c) => {
+    const query = parseQuery(c, supplierPaymentListQuerySchema);
+    return c.json(await financeService.listSupplierPayments(c.get("db"), {
+        ...query,
+        supplierInvoiceId: c.req.param("id"),
+    }));
+})
+    .post("/supplier-invoices/:id/payments", async (c) => {
+    const body = await parseJsonBody(c, insertSupplierPaymentSchema);
+    const row = await financeService.createSupplierPayment(c.get("db"), { ...body, supplierInvoiceId: c.req.param("id") }, {
+        ...getFinanceRouteRuntime(c),
+        actionLedgerContext: getActionLedgerRequestContext(c),
+        actionLedgerAuthorizationSource: "finance.supplier_payment.route",
+    });
+    return c.json({ data: row }, 201);
+})
+    .get("/supplier-invoices/:id/attachments", async (c) => {
+    return c.json({
+        data: await supplierInvoicesService.listAttachments(c.get("db"), c.req.param("id")),
+    });
+})
+    .post("/supplier-invoices/:id/attachments", async (c) => {
+    const row = await supplierInvoicesService.createAttachment(c.get("db"), c.req.param("id"), await parseJsonBody(c, insertSupplierInvoiceAttachmentSchema));
+    if (!row)
+        return c.json({ error: "Supplier invoice not found" }, 404);
+    return c.json({ data: row }, 201);
+})
+    .delete("/supplier-invoices/:id/attachments/:attachmentId", async (c) => {
+    const row = await supplierInvoicesService.deleteAttachment(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 });
+})
+    .get("/supplier-invoice-attachments/:id/download", async (c) => {
+    const attachment = await supplierInvoicesService.getAttachmentById(c.get("db"), c.req.param("id"));
+    if (!attachment?.storageKey)
+        return c.json({ error: "Attachment not found" }, 404);
+    const runtime = getFinanceRouteRuntime(c);
+    const download = await resolveStoredDocumentDownload({ storageKey: attachment.storageKey }, { bindings: c.env, resolveDocumentDownloadUrl: runtime?.resolveDocumentDownloadUrl });
+    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);
+});

package/dist/routes-vouchers.d.ts

@@ -0,0 +1,228 @@
+import type { Env } from "./routes-shared.js";
+export declare const financeVoucherRoutes: import("hono/hono-base").HonoBase<Env, {
+    "/vouchers": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    id: string;
+                    code: string;
+                    seriesCode: string | null;
+                    status: "active" | "void" | "expired" | "redeemed";
+                    currency: string;
+                    initialAmountCents: number;
+                    remainingAmountCents: number;
+                    issuedToPersonId: string | null;
+                    issuedToOrganizationId: string | null;
+                    sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
+                    sourceBookingId: string | null;
+                    sourcePaymentId: string | null;
+                    validFrom: string | null;
+                    expiresAt: string | null;
+                    notes: string | null;
+                    issuedByUserId: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/vouchers": {
+        $post: {
+            input: {};
+            output: {
+                data: {
+                    currency: string;
+                    id: string;
+                    code: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    status: "active" | "void" | "expired" | "redeemed";
+                    notes: string | null;
+                    expiresAt: string | null;
+                    sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
+                    seriesCode: string | null;
+                    issuedToPersonId: string | null;
+                    issuedToOrganizationId: string | null;
+                    sourceBookingId: string | null;
+                    sourcePaymentId: string | null;
+                    validFrom: string | null;
+                    initialAmountCents: number;
+                    remainingAmountCents: number;
+                    issuedByUserId: string | null;
+                } | null;
+            };
+            outputFormat: "json";
+            status: 201;
+        } | {
+            input: {};
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
+        };
+    };
+} & {
+    "/vouchers/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    redemptions: {
+                        id: string;
+                        voucherId: string;
+                        bookingId: string;
+                        paymentId: string | null;
+                        amountCents: number;
+                        createdAt: string;
+                        createdByUserId: string | null;
+                    }[];
+                    id: string;
+                    code: string;
+                    seriesCode: string | null;
+                    status: "active" | "void" | "expired" | "redeemed";
+                    currency: string;
+                    initialAmountCents: number;
+                    remainingAmountCents: number;
+                    issuedToPersonId: string | null;
+                    issuedToOrganizationId: string | null;
+                    sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
+                    sourceBookingId: string | null;
+                    sourcePaymentId: string | null;
+                    validFrom: string | null;
+                    expiresAt: string | null;
+                    notes: string | null;
+                    issuedByUserId: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/vouchers/:id": {
+        $patch: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    code: string;
+                    seriesCode: string | null;
+                    status: "active" | "void" | "expired" | "redeemed";
+                    currency: string;
+                    initialAmountCents: number;
+                    remainingAmountCents: number;
+                    issuedToPersonId: string | null;
+                    issuedToOrganizationId: string | null;
+                    sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
+                    sourceBookingId: string | null;
+                    sourcePaymentId: string | null;
+                    validFrom: string | null;
+                    expiresAt: string | null;
+                    notes: string | null;
+                    issuedByUserId: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/vouchers/:id/redeem": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    voucher: {
+                        id: string;
+                        code: string;
+                        seriesCode: string | null;
+                        status: "active" | "void" | "expired" | "redeemed";
+                        currency: string;
+                        initialAmountCents: number;
+                        remainingAmountCents: number;
+                        issuedToPersonId: string | null;
+                        issuedToOrganizationId: string | null;
+                        sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
+                        sourceBookingId: string | null;
+                        sourcePaymentId: string | null;
+                        validFrom: string | null;
+                        expiresAt: string | null;
+                        notes: string | null;
+                        issuedByUserId: string | null;
+                        createdAt: string;
+                        updatedAt: string;
+                    };
+                    redemption: {
+                        id: string;
+                        createdAt: string;
+                        bookingId: string;
+                        amountCents: number;
+                        paymentId: string | null;
+                        voucherId: string;
+                        createdByUserId: string | null;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: "code_in_use" | "voucher_not_found" | "voucher_inactive" | "voucher_not_started" | "voucher_expired" | "insufficient_balance";
+            };
+            outputFormat: "json";
+            status: 404 | 409 | 422;
+        };
+    };
+}, "/", "/vouchers/:id/redeem">;
+//# sourceMappingURL=routes-vouchers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes-vouchers.d.ts","sourceRoot":"","sources":["../src/routes-vouchers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAU7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAgE7B,CAAA"}

package/dist/routes-vouchers.js

@@ -0,0 +1,54 @@
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { financeService } from "./service.js";
+import { VoucherServiceError } from "./service-vouchers.js";
+import { insertVoucherSchema, redeemVoucherSchema, updateVoucherSchema, voucherListQuerySchema, } from "./validation.js";
+export const financeVoucherRoutes = new Hono()
+    // ========================================================================
+    // Vouchers — issuance, lookup, redemption
+    // ========================================================================
+    .get("/vouchers", async (c) => {
+    const query = parseQuery(c, voucherListQuerySchema);
+    return c.json(await financeService.vouchers.list(c.get("db"), query));
+})
+    .post("/vouchers", async (c) => {
+    try {
+        const row = await financeService.vouchers.create(c.get("db"), await parseJsonBody(c, insertVoucherSchema), c.get("userId"));
+        return c.json({ data: row }, 201);
+    }
+    catch (error) {
+        if (error instanceof VoucherServiceError && error.code === "code_in_use") {
+            return c.json({ error: "Voucher code already in use" }, 409);
+        }
+        throw error;
+    }
+})
+    .get("/vouchers/:id", async (c) => {
+    const row = await financeService.vouchers.getById(c.get("db"), c.req.param("id"));
+    if (!row)
+        return c.json({ error: "Voucher not found" }, 404);
+    return c.json({ data: row });
+})
+    .patch("/vouchers/:id", async (c) => {
+    const row = await financeService.vouchers.update(c.get("db"), c.req.param("id"), await parseJsonBody(c, updateVoucherSchema));
+    if (!row)
+        return c.json({ error: "Voucher not found" }, 404);
+    return c.json({ data: row });
+})
+    .post("/vouchers/:id/redeem", async (c) => {
+    try {
+        const result = await financeService.vouchers.redeem(c.get("db"), c.req.param("id"), await parseJsonBody(c, redeemVoucherSchema), c.get("userId"));
+        return c.json({ data: result }, 201);
+    }
+    catch (error) {
+        if (error instanceof VoucherServiceError) {
+            const status = error.code === "voucher_not_found"
+                ? 404
+                : error.code === "insufficient_balance"
+                    ? 409
+                    : 422;
+            return c.json({ error: error.code }, status);
+        }
+        throw error;
+    }
+});