@voyant-travel/finance 0.119.5

package/dist/index.js

@@ -0,0 +1,108 @@
+import { Hono } from "hono";
+import { buildFinanceCheckoutRouteRuntime, createFinanceCheckoutAdminRoutes, createFinanceCheckoutRoutes, FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, } from "./checkout-routes.js";
+import { createInvoiceFxRoutes } from "./invoice-fx.js";
+import { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
+import { financeRoutes } from "./routes.js";
+import { financeActionLedgerRoutes } from "./routes-action-ledger.js";
+import { createFinanceAdminDocumentRoutes } from "./routes-documents.js";
+import { createPublicFinanceRoutes } from "./routes-public.js";
+import { createFinanceAdminSettlementRoutes } from "./routes-settlement.js";
+import { supplierInvoiceRoutes } from "./routes-supplier-invoices.js";
+export { buildFinanceCheckoutRouteRuntime, CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, createFinanceCheckoutAdminRoutes, createFinanceCheckoutRoutes, FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, } from "./checkout-routes.js";
+export { bootstrapCheckoutCollection, initiateCheckoutCollection, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./checkout-service.js";
+export { bootstrapCheckoutCollectionSchema, bootstrappedCheckoutCollectionSchema, checkoutBankTransferInstructionsSchema, checkoutCollectionIntentSchema, checkoutCollectionInvoiceSchema, checkoutCollectionMethodSchema, checkoutCollectionPlanSchema, checkoutCollectionScheduleSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutInvoiceNotificationSchema, checkoutNotificationAttachmentSchema, checkoutNotificationChannelSchema, checkoutNotificationDeliverySchema, checkoutNotificationDeliveryStatusSchema, checkoutPaymentSessionNotificationSchema, checkoutPaymentSessionTargetSchema, checkoutProviderStartInputSchema, checkoutProviderStartResultSchema, checkoutReminderRunListQuerySchema, checkoutReminderRunListResponseSchema, checkoutReminderRunSchema, checkoutReminderRunStatusSchema, checkoutReminderTargetTypeSchema, initiateCheckoutCollectionSchema, initiatedCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./checkout-validation.js";
+export { buildBookingCheckoutUrl, buildPaymentLinkUrl, } from "./payment-link.js";
+export { createPublicFinanceRoutes, publicFinanceRoutes, } from "./routes-public.js";
+export { supplierInvoiceRoutes, } from "./routes-supplier-invoices.js";
+export { publicFinanceService } from "./service-public.js";
+export const invoiceLinkable = {
+    module: "finance",
+    entity: "invoice",
+    table: "invoices",
+    idPrefix: "inv",
+};
+export const invoiceTemplateLinkable = {
+    module: "finance",
+    entity: "invoiceTemplate",
+    table: "invoice_templates",
+    idPrefix: "invt",
+};
+export const creditNoteLinkable = {
+    module: "finance",
+    entity: "creditNote",
+    table: "credit_notes",
+    idPrefix: "crn",
+};
+export const supplierInvoiceLinkable = {
+    module: "finance",
+    entity: "supplierInvoice",
+    table: "supplier_invoices",
+    idPrefix: "sinv",
+};
+export const financeLinkable = {
+    invoice: invoiceLinkable,
+    invoiceTemplate: invoiceTemplateLinkable,
+    creditNote: creditNoteLinkable,
+    supplierInvoice: supplierInvoiceLinkable,
+};
+export const financeModule = {
+    name: "finance",
+    linkable: financeLinkable,
+    requiresTransactionalDb: true,
+};
+export function createFinanceHonoModule(options = {}) {
+    const adminRoutes = new Hono()
+        .route("/", financeRoutes)
+        .route("/", createFinanceCheckoutAdminRoutes(options))
+        .route("/", financeActionLedgerRoutes)
+        .route("/", supplierInvoiceRoutes)
+        .route("/", createInvoiceFxRoutes(options))
+        .route("/", createFinanceAdminDocumentRoutes(options))
+        .route("/", createFinanceAdminSettlementRoutes(options));
+    const module = {
+        ...financeModule,
+        bootstrap: ({ bindings, container, eventBus }) => {
+            const runtime = buildFinanceRouteRuntime(bindings, options);
+            // Wire the framework's eventBus into the route runtime so subscribers
+            // (notably the storefront's checkout-finalize workflow on
+            // `payment.completed`) actually receive emissions from
+            // `financeService.completePaymentSession`. Without this, the Netopia
+            // webhook silently no-ops because the runtime has no bus attached.
+            if (!runtime.eventBus && eventBus)
+                runtime.eventBus = eventBus;
+            container.register(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, runtime);
+            container.register(FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, buildFinanceCheckoutRouteRuntime(bindings, options));
+        },
+    };
+    const publicRoutes = new Hono()
+        .route("/", createPublicFinanceRoutes(options))
+        .route("/", createFinanceCheckoutRoutes(options));
+    return {
+        module,
+        adminRoutes,
+        publicRoutes,
+        routes: adminRoutes,
+    };
+}
+export const financeHonoModule = createFinanceHonoModule();
+export { computeBookingItemTaxLine, createBookingTaxHonoExtension, createBookingTaxRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxRoutes, resolveBookingSellTaxRate, } from "./booking-tax.js";
+export { resolveStoredDocumentDownload, } from "./document-download.js";
+export { createInvoiceFxHonoExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, mountInvoiceFxRoutes, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, } from "./invoice-fx.js";
+export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
+export { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
+export { bookingsCreateExtension } from "./routes-booking-create.js";
+export { createFinanceAdminDocumentRoutes, } from "./routes-documents.js";
+export { createFinanceAdminSettlementRoutes, } from "./routes-settlement.js";
+export { apServiceTypeEnum, bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, costAllocationSplitMethodEnum, costAllocationTargetTypeEnum, creditNoteLineItems, creditNotes, financeNotes, invoiceAttachments, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierCostAllocations, supplierInvoiceAttachments, supplierInvoiceLines, supplierInvoiceStatusEnum, supplierInvoices, supplierPayments, taxClasses, taxPolicyProfiles, taxPolicyRules, taxRegimes, voucherRedemptions, voucherSourceTypeEnum, voucherStatusEnum, vouchers, } from "./schema.js";
+export { financeService, InvoiceLineItemsPersistenceError, InvoiceNumberAllocationError, InvoiceNumberConflictError, renderInvoiceBody, } from "./service.js";
+export { bookingCreateSchema, createBooking, } from "./service-booking-create.js";
+export { dualCreateBooking, dualCreateBookingSchema, } from "./service-bookings-dual-create.js";
+export { createPdfInvoiceDocumentGenerator, createStorageBackedInvoiceDocumentGenerator, defaultPdfInvoiceDocumentSerializer, defaultStorageBackedInvoiceDocumentSerializer, financeDocumentsService, } from "./service-documents.js";
+export { buildInvoiceIssuedEvent, issueInvoiceFromBooking, issueProformaFromBooking, } from "./service-issue.js";
+export { getLatestInvoiceRendition, waitForInvoiceRendition, waitFormatForMode, } from "./service-rendition-wait.js";
+export { financeSettlementService } from "./service-settlement.js";
+export { recomputeTotalsFromLines, SupplierInvoiceServiceError, supplierInvoicesService, validateAllocations, } from "./service-supplier-invoices.js";
+export { VoucherServiceError, vouchersService } from "./service-vouchers.js";
+export { migrateVouchersFromPaymentInstruments, } from "./service-vouchers-migration.js";
+export { agingReportQuerySchema, allocateInvoiceNumberInputSchema, applyDefaultBookingPaymentPlanSchema, apServiceTypeSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, costAllocationSplitMethodSchema, costAllocationTargetTypeSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, financeAggregatesQuerySchema, generatedInvoiceDocumentResultSchema, generateInvoiceDocumentInputSchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceRenditionSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierInvoiceAttachmentSchema, insertSupplierInvoiceSchema, insertSupplierPaymentSchema, insertTaxClassSchema, insertTaxPolicyProfileSchema, insertTaxPolicyRuleSchema, insertTaxRegimeSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentKindSchema, paymentListQuerySchema, paymentListSortDirSchema, paymentListSortFieldSchema, paymentProvenanceSchema, paymentSessionListQuerySchema, paymentTargetSchema, polledInvoiceSettlementProviderResultSchema, polledInvoiceSettlementResultSchema, pollInvoiceSettlementInputSchema, profitabilityQuerySchema, renderInvoiceInputSchema, revenueReportQuerySchema, setSupplierCostAllocationsSchema, setSupplierInvoiceLinesSchema, supplierCostAllocationInputSchema, supplierInvoiceLineInputSchema, supplierInvoiceListQuerySchema, supplierInvoiceStatusSchema, supplierPaymentListQuerySchema, taxClassListQuerySchema, taxPolicyProfileListQuerySchema, taxPolicyRuleListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteLineItemSchema, updateCreditNoteSchema, updateInvoiceExternalRefSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceRenditionSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSchema, updatePaymentSessionSchema, updateSupplierInvoiceSchema, updateSupplierPaymentSchema, updateTaxClassSchema, updateTaxPolicyProfileSchema, updateTaxPolicyRuleSchema, updateTaxRegimeSchema, } from "./validation.js";
+export { publicBookingFinanceDocumentsSchema, publicBookingFinancePaymentsSchema, publicBookingPaymentOptionsSchema, publicFinanceBookingDocumentSchema, publicFinanceBookingPaymentSchema, publicFinanceDocumentAvailabilitySchema, publicFinanceDocumentFormatSchema, publicFinanceDocumentLookupQuerySchema, publicFinanceDocumentLookupSchema, publicFinanceInvoiceTypeSchema, publicPaymentOptionsQuerySchema, publicPaymentSessionSchema, publicStartPaymentSessionSchema, publicValidateVoucherSchema, publicVoucherValidationSchema, } from "./validation-public.js";

package/dist/invoice-fx.d.ts

@@ -0,0 +1,134 @@
+import type { ModuleContainer } from "@voyant-travel/core";
+import type { HonoExtension } from "@voyant-travel/hono/module";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { Hono } from "hono";
+import type { Env } from "./routes-shared.js";
+export type InvoiceFxSettings = {
+    baseCurrency?: string | null;
+    fxCommissionBps?: number | null;
+    fxCommissionInvoiceMention?: string | null;
+};
+export type ResolveInvoiceFxSettings = (db: PostgresJsDatabase) => InvoiceFxSettings | null | undefined | Promise<InvoiceFxSettings | null | undefined>;
+export type UpdateInvoiceFxSettings = (db: PostgresJsDatabase, settings: InvoiceFxSettings) => InvoiceFxSettings | null | undefined | Promise<InvoiceFxSettings | null | undefined>;
+export type ResolveInvoiceExchangeRateInput = {
+    /** Currency being invoiced, e.g. EUR. */
+    baseCurrency: string;
+    /** Operator accounting/reporting currency, e.g. RON. */
+    quoteCurrency: string;
+    date?: string;
+};
+export type InvoiceExchangeRateResolution = {
+    rate: number;
+    fxRateSetId?: string;
+    source?: string;
+    quotedAt?: string;
+    validUntil?: string;
+};
+export type ResolveInvoiceExchangeRate = (input: ResolveInvoiceExchangeRateInput) => number | InvoiceExchangeRateResolution | null | undefined | Promise<number | InvoiceExchangeRateResolution | null | undefined>;
+export type HandleInvoiceFxResolutionError = (error: unknown, input: ResolveInvoiceExchangeRateInput) => void | Promise<void>;
+export interface InvoiceFxOptions {
+    invoiceFxSettings?: InvoiceFxSettings | null;
+    resolveInvoiceFxSettings?: ResolveInvoiceFxSettings;
+    updateInvoiceFxSettings?: UpdateInvoiceFxSettings;
+    resolveInvoiceExchangeRate?: ResolveInvoiceExchangeRate;
+    resolveInvoiceExchangeRateResolver?: (bindings: Record<string, unknown>) => ResolveInvoiceExchangeRate | undefined;
+    onInvoiceFxResolutionError?: HandleInvoiceFxResolutionError;
+}
+export interface InvoiceFxRouteOptions extends InvoiceFxOptions {
+}
+export type InvoiceFxInvoice = {
+    currency: string;
+    baseCurrency?: string | null;
+    issueDate?: string | Date | null;
+};
+export type InvoiceFxContext = {
+    baseCurrency: string;
+    fxRateSetId?: string;
+    fxRate: number;
+    fxRateSource?: string;
+    fxRateQuotedAt?: string;
+    fxRateValidUntil?: string;
+    fxCommissionBps: number;
+    effectiveRate: number;
+    fxCommissionInvoiceMention?: string;
+};
+export type ResolvedInvoiceFxSettings = {
+    baseCurrency: string;
+    fxCommissionBps: number;
+    fxCommissionInvoiceMention?: string;
+};
+export type VoyantDataFxResolverOptions = {
+    baseUrl?: string;
+    apiKey: string;
+    authHeader?: string;
+    authScheme?: string | null;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+    userAgent?: string;
+};
+type InvoiceFxRouteEnv = Env & {
+    Variables: Env["Variables"] & {
+        container?: ModuleContainer;
+    };
+};
+export declare function resolveInvoiceFxSettingsOrDefault(db: PostgresJsDatabase, options?: InvoiceFxOptions): Promise<ResolvedInvoiceFxSettings>;
+export declare function resolveInvoiceFxContext(db: PostgresJsDatabase, invoice: InvoiceFxInvoice, options?: InvoiceFxOptions): Promise<InvoiceFxContext | null>;
+export declare function createVoyantDataFxExchangeRateResolver(options: VoyantDataFxResolverOptions): ResolveInvoiceExchangeRate;
+export declare function createInvoiceFxRoutes(options?: InvoiceFxRouteOptions): import("hono/hono-base").HonoBase<InvoiceFxRouteEnv, {
+    "/invoice-fx-settings": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    baseCurrency: string;
+                    fxCommissionBps: number;
+                    fxCommissionInvoiceMention?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/invoice-fx-settings": {
+        $patch: {
+            input: {};
+            output: {
+                data: {
+                    baseCurrency: string;
+                    fxCommissionBps: number;
+                    fxCommissionInvoiceMention?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/invoice-fx-rate": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    fxCommissionInvoiceMention?: string | undefined;
+                    fxCommissionBps: number;
+                    effectiveRate: number;
+                    validUntil?: string | undefined;
+                    quotedAt?: string | undefined;
+                    source?: string | undefined;
+                    fxRateSetId?: string | undefined;
+                    rate: number;
+                    baseCurrency: string;
+                    quoteCurrency: string;
+                    date: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+}, "/", "/invoice-fx-rate">;
+export declare function mountInvoiceFxRoutes(hono: Hono, options?: InvoiceFxRouteOptions): Hono;
+export declare function createInvoiceFxHonoExtension(options?: InvoiceFxRouteOptions): HonoExtension;
+export {};
+//# sourceMappingURL=invoice-fx.d.ts.map

package/dist/invoice-fx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-fx.d.ts","sourceRoot":"","sources":["../src/invoice-fx.ts"],"names":[],"mappings":"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"}

package/dist/invoice-fx.js

@@ -0,0 +1,240 @@
+import { createVoyantDataClient } from "@voyant-travel/data-sdk";
+import { ApiHttpError, parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono as HonoApp } from "hono";
+import { z } from "zod";
+import { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
+const invoiceFxSettingsPatchSchema = z.object({
+    baseCurrency: z.string().min(3).max(8).nullable().optional(),
+    fxCommissionBps: z.number().int().min(0).max(100_000).nullable().optional(),
+    fxCommissionInvoiceMention: z.string().nullable().optional(),
+});
+const invoiceExchangeRateQuerySchema = z.object({
+    baseCurrency: z.string().min(3).max(8),
+    quoteCurrency: z.string().min(3).max(8),
+    date: z.string().optional(),
+});
+function getInvoiceFxRuntime(options, bindings, container) {
+    return ((container?.has(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY)
+        ? container.resolve(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY)
+        : undefined) ?? buildFinanceRouteRuntime(bindings, options));
+}
+export async function resolveInvoiceFxSettingsOrDefault(db, options = {}) {
+    const settings = await resolveConfiguredInvoiceFxSettings(db, options);
+    return {
+        baseCurrency: normalizeCurrency(settings?.baseCurrency) ?? "RON",
+        fxCommissionBps: normalizeBasisPoints(settings?.fxCommissionBps),
+        fxCommissionInvoiceMention: normalizeOptionalText(settings?.fxCommissionInvoiceMention),
+    };
+}
+export async function resolveInvoiceFxContext(db, invoice, options = {}) {
+    const settings = await resolveConfiguredInvoiceFxSettings(db, options);
+    const baseCurrency = normalizeCurrency(settings?.baseCurrency) ?? normalizeCurrency(invoice.baseCurrency) ?? "RON";
+    const invoiceCurrency = normalizeCurrency(invoice.currency);
+    if (!baseCurrency || !invoiceCurrency || invoiceCurrency === baseCurrency)
+        return null;
+    if (!options.resolveInvoiceExchangeRate)
+        return null;
+    const rateInput = {
+        baseCurrency: invoiceCurrency,
+        quoteCurrency: baseCurrency,
+        date: toDateString(invoice.issueDate),
+    };
+    let fxResolution;
+    try {
+        fxResolution = await options.resolveInvoiceExchangeRate(rateInput);
+    }
+    catch (error) {
+        await notifyInvoiceFxResolutionError(options, error, rateInput);
+        return null;
+    }
+    const resolvedRate = normalizeInvoiceExchangeRateResolution(fxResolution);
+    if (!resolvedRate)
+        return null;
+    const fxCommissionBps = normalizeBasisPoints(settings?.fxCommissionBps);
+    const effectiveRate = roundRate(resolvedRate.rate * (1 + fxCommissionBps / 10_000));
+    return {
+        baseCurrency,
+        ...(resolvedRate.fxRateSetId ? { fxRateSetId: resolvedRate.fxRateSetId } : {}),
+        fxRate: roundRate(resolvedRate.rate),
+        ...(resolvedRate.source ? { fxRateSource: resolvedRate.source } : {}),
+        ...(resolvedRate.quotedAt ? { fxRateQuotedAt: resolvedRate.quotedAt } : {}),
+        ...(resolvedRate.validUntil ? { fxRateValidUntil: resolvedRate.validUntil } : {}),
+        fxCommissionBps,
+        effectiveRate,
+        ...(fxCommissionBps > 0 && normalizeOptionalText(settings?.fxCommissionInvoiceMention)
+            ? { fxCommissionInvoiceMention: normalizeOptionalText(settings?.fxCommissionInvoiceMention) }
+            : {}),
+    };
+}
+export function createVoyantDataFxExchangeRateResolver(options) {
+    const client = createVoyantDataClient({
+        apiKey: options.apiKey,
+        ...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
+        ...(options.authHeader ? { authHeader: options.authHeader } : {}),
+        ...(options.authScheme !== undefined ? { authScheme: options.authScheme } : {}),
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+        ...(options.headers ? { headers: options.headers } : {}),
+        userAgent: options.userAgent ?? "voyant-finance",
+    });
+    return async ({ baseCurrency, quoteCurrency }) => {
+        const quote = await client.fx.pair(baseCurrency, quoteCurrency);
+        if (typeof quote.conversionRate !== "number" || !Number.isFinite(quote.conversionRate)) {
+            return null;
+        }
+        const source = normalizeOptionalText(quote.source);
+        const quotedAt = normalizeOptionalText(quote.timeLastUpdateUtc);
+        const validUntil = normalizeOptionalText(quote.timeNextUpdateUtc);
+        return {
+            rate: quote.conversionRate,
+            ...(source ? { source } : {}),
+            ...(quotedAt ? { quotedAt } : {}),
+            ...(validUntil ? { validUntil } : {}),
+        };
+    };
+}
+export function createInvoiceFxRoutes(options = {}) {
+    return new HonoApp()
+        .get("/invoice-fx-settings", async (c) => {
+        const runtime = getInvoiceFxRuntime(options, c.env, c.var.container);
+        return c.json({
+            data: await resolveInvoiceFxSettingsOrDefault(c.get("db"), runtime),
+        });
+    })
+        .patch("/invoice-fx-settings", async (c) => {
+        const runtime = getInvoiceFxRuntime(options, c.env, c.var.container);
+        if (!runtime.updateInvoiceFxSettings) {
+            throw new ApiHttpError("Invoice FX settings updates are not configured", {
+                status: 501,
+                code: "invoice_fx_settings_update_not_configured",
+            });
+        }
+        const current = await resolveInvoiceFxSettingsOrDefault(c.get("db"), runtime);
+        const patch = await parseJsonBody(c, invoiceFxSettingsPatchSchema);
+        const next = await runtime.updateInvoiceFxSettings(c.get("db"), {
+            ...current,
+            ...patch,
+        });
+        return c.json({
+            data: await resolveInvoiceFxSettingsOrDefault(c.get("db"), { invoiceFxSettings: next }),
+        });
+    })
+        .get("/invoice-fx-rate", async (c) => {
+        const runtime = getInvoiceFxRuntime(options, c.env, c.var.container);
+        if (!runtime.resolveInvoiceExchangeRate) {
+            throw new ApiHttpError("Invoice FX rate resolution is not configured", {
+                status: 501,
+                code: "invoice_fx_rate_resolution_not_configured",
+            });
+        }
+        const query = parseQuery(c, invoiceExchangeRateQuerySchema);
+        const input = {
+            baseCurrency: normalizeCurrency(query.baseCurrency) ?? query.baseCurrency,
+            quoteCurrency: normalizeCurrency(query.quoteCurrency) ?? query.quoteCurrency,
+            date: query.date,
+        };
+        let rateResolution;
+        try {
+            rateResolution = await runtime.resolveInvoiceExchangeRate(input);
+        }
+        catch (error) {
+            await notifyInvoiceFxResolutionError(runtime, error, input);
+            throw new ApiHttpError("Invoice FX rate resolution failed", {
+                status: 502,
+                code: "invoice_fx_rate_resolution_failed",
+            });
+        }
+        const resolvedRate = normalizeInvoiceExchangeRateResolution(rateResolution);
+        if (!resolvedRate) {
+            throw new ApiHttpError("Invoice FX rate was not found", {
+                status: 404,
+                code: "invoice_fx_rate_not_found",
+            });
+        }
+        const settings = await resolveInvoiceFxSettingsOrDefault(c.get("db"), runtime);
+        const fxCommissionBps = settings.fxCommissionBps;
+        const effectiveRate = roundRate(resolvedRate.rate * (1 + fxCommissionBps / 10_000));
+        return c.json({
+            data: {
+                ...input,
+                rate: roundRate(resolvedRate.rate),
+                ...(resolvedRate.fxRateSetId ? { fxRateSetId: resolvedRate.fxRateSetId } : {}),
+                ...(resolvedRate.source ? { source: resolvedRate.source } : {}),
+                ...(resolvedRate.quotedAt ? { quotedAt: resolvedRate.quotedAt } : {}),
+                ...(resolvedRate.validUntil ? { validUntil: resolvedRate.validUntil } : {}),
+                fxCommissionBps,
+                effectiveRate,
+                ...(fxCommissionBps > 0 && settings.fxCommissionInvoiceMention
+                    ? { fxCommissionInvoiceMention: settings.fxCommissionInvoiceMention }
+                    : {}),
+            },
+        });
+    });
+}
+export function mountInvoiceFxRoutes(hono, options = {}) {
+    hono.route("/v1/admin/finance", createInvoiceFxRoutes(options));
+    return hono;
+}
+export function createInvoiceFxHonoExtension(options = {}) {
+    const extension = {
+        name: "finance.invoice-fx",
+        module: "finance",
+    };
+    return {
+        extension,
+        adminRoutes: createInvoiceFxRoutes(options),
+        routes: createInvoiceFxRoutes(options),
+    };
+}
+async function resolveConfiguredInvoiceFxSettings(db, options) {
+    return options.invoiceFxSettings !== undefined
+        ? options.invoiceFxSettings
+        : ((await options.resolveInvoiceFxSettings?.(db)) ?? null);
+}
+function normalizeCurrency(value) {
+    const normalized = value?.trim().toUpperCase();
+    return normalized ? normalized : null;
+}
+async function notifyInvoiceFxResolutionError(options, error, input) {
+    try {
+        await options.onInvoiceFxResolutionError?.(error, input);
+    }
+    catch {
+        // FX enrichment is optional; a reporting hook must not fail invoice issuance.
+    }
+}
+function normalizeBasisPoints(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.round(value) : 0;
+}
+function normalizeInvoiceExchangeRateResolution(resolution) {
+    if (typeof resolution === "number") {
+        return Number.isFinite(resolution) && resolution > 0 ? { rate: resolution } : null;
+    }
+    if (!resolution || typeof resolution !== "object")
+        return null;
+    if (typeof resolution.rate !== "number" || !Number.isFinite(resolution.rate))
+        return null;
+    if (resolution.rate <= 0)
+        return null;
+    const source = normalizeOptionalText(resolution.source);
+    const fxRateSetId = normalizeOptionalText(resolution.fxRateSetId);
+    const quotedAt = normalizeOptionalText(resolution.quotedAt);
+    const validUntil = normalizeOptionalText(resolution.validUntil);
+    return {
+        rate: resolution.rate,
+        ...(fxRateSetId ? { fxRateSetId } : {}),
+        ...(source ? { source } : {}),
+        ...(quotedAt ? { quotedAt } : {}),
+        ...(validUntil ? { validUntil } : {}),
+    };
+}
+function normalizeOptionalText(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function toDateString(value) {
+    if (value instanceof Date)
+        return value.toISOString().slice(0, 10);
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function roundRate(value) {
+    return Number(value.toFixed(8));
+}

package/dist/invoice-number-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function isInvoiceNumberUniqueConstraintError(error: unknown): boolean;
+//# sourceMappingURL=invoice-number-errors.d.ts.map

package/dist/invoice-number-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number-errors.d.ts","sourceRoot":"","sources":["../src/invoice-number-errors.ts"],"names":[],"mappings":"AAeA,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,WAGlE"}

package/dist/invoice-number-errors.js

@@ -0,0 +1,58 @@
+const INVOICE_NUMBER_UNIQUE_TARGETS = [
+    "invoices_invoice_number_type_active_idx",
+    "invoices_invoice_number_type_unique",
+    "invoices_invoice_number_unique",
+    "invoices_invoice_number_key",
+    "invoice_number",
+];
+const UNIQUE_VIOLATION_SQLSTATE = "23505";
+export function isInvoiceNumberUniqueConstraintError(error) {
+    const signals = collectErrorSignals(error, new Set(), 0);
+    return signals.hasUniqueViolation && signals.hasInvoiceNumberTarget;
+}
+function collectErrorSignals(error, seen, depth) {
+    if (!error || typeof error !== "object" || depth > 6 || seen.has(error)) {
+        return { hasInvoiceNumberTarget: false, hasUniqueViolation: false };
+    }
+    seen.add(error);
+    const record = error;
+    const strings = errorStrings(record);
+    const signals = {
+        hasInvoiceNumberTarget: strings.some((value) => INVOICE_NUMBER_UNIQUE_TARGETS.some((target) => value.includes(target))),
+        hasUniqueViolation: strings.some((value) => value.includes(UNIQUE_VIOLATION_SQLSTATE)),
+    };
+    for (const nested of nestedErrors(record)) {
+        const nestedSignals = collectErrorSignals(nested, seen, depth + 1);
+        signals.hasInvoiceNumberTarget ||= nestedSignals.hasInvoiceNumberTarget;
+        signals.hasUniqueViolation ||= nestedSignals.hasUniqueViolation;
+    }
+    return signals;
+}
+function errorStrings(error) {
+    return [
+        error.code,
+        error.sqlState,
+        error.sqlstate,
+        error.sql_state,
+        error.constraint,
+        error.constraintName,
+        error.constraint_name,
+        error.detail,
+        error.message,
+        error.stack,
+    ].filter((value) => typeof value === "string");
+}
+function nestedErrors(error) {
+    const values = [
+        error.cause,
+        error.originalError,
+        error.original,
+        error.error,
+        error.queryError,
+        error.sourceError,
+    ];
+    if (Array.isArray(error.errors)) {
+        values.push(...error.errors);
+    }
+    return values;
+}