@voyant-travel/finance 0.162.1 → 0.163.0

package/dist/index.js

@@ -1,6 +1,7 @@
 // agent-quality: file-size exception -- owner: finance; existing module stays co-located until a dedicated split preserves behavior and tests.
 import { OpenAPIHono } from "@hono/zod-openapi";
 import { registerBookingFinancialLifecycle } from "@voyant-travel/bookings";
+import { customFieldsRuntimePort } from "@voyant-travel/core/custom-fields";
 import { defineGraphRuntimeFactory } from "@voyant-travel/core/project";
 import { stampOpenApiRegistryApiId } from "@voyant-travel/hono";
 import { financeBookingLifecycle } from "./booking-lifecycle.js";
@@ -65,7 +66,7 @@ export function createFinanceApiModule(options = {}) {
 }
 export const financeApiModule = createFinanceApiModule();
 export const createFinanceVoyantRuntime = defineGraphRuntimeFactory(async ({ api, getPort, getPorts, hasPort }) => {
-    const configured = createFinanceApiModule(createFinanceRuntime(await getPort(financeHostRuntimePort), await getPort(financeNotificationsRuntimePort), hasPort(financeCheckoutPaymentStartersRuntimePort)
+    const configured = createFinanceApiModule(createFinanceRuntime(await getPort(financeHostRuntimePort), await getPort(customFieldsRuntimePort), await getPort(financeNotificationsRuntimePort), hasPort(financeCheckoutPaymentStartersRuntimePort)
         ? await getPort(financeCheckoutPaymentStartersRuntimePort)
         : undefined, await getPorts(financeInvoiceSettlementPollerRuntimePort)));
     const bootstrap = configured.module.bootstrap;

package/dist/route-runtime.d.ts

@@ -6,6 +6,7 @@ import type { InvoiceDueDateResolver, InvoiceLineDescriptionResolver, PaymentSch
 import type { InvoiceDocumentGenerator } from "./service-documents.js";
 export type FinanceRouteRuntime = {
     invoiceDocumentGenerator?: InvoiceDocumentGenerator;
+    resolveCustomFields?: FinanceDocumentRouteOptions["resolveCustomFields"];
     resolveDocumentDownloadUrl?: FinanceDocumentRouteOptions["resolveDocumentDownloadUrl"];
     invoiceSettlementPollers: Record<string, InvoiceSettlementPoller>;
     eventBus?: EventBus;

package/dist/route-runtime.js

@@ -2,6 +2,7 @@ export const FINANCE_ROUTE_RUNTIME_CONTAINER_KEY = "providers.finance.runtime";
 export function buildFinanceRouteRuntime(bindings, options = {}) {
     return {
         invoiceDocumentGenerator: options.resolveInvoiceDocumentGenerator?.(bindings) ?? options.invoiceDocumentGenerator,
+        resolveCustomFields: options.resolveCustomFields,
         resolveDocumentDownloadUrl: options.resolveDocumentDownloadUrl,
         invoiceSettlementPollers: options.resolveInvoiceSettlementPollers?.(bindings) ?? options.invoiceSettlementPollers ?? {},
         eventBus: options.resolveEventBus?.(bindings) ?? options.eventBus,

package/dist/routes-documents.d.ts

@@ -23,7 +23,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
 import type { EventBus, ModuleContainer } from "@voyant-travel/core";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
-import { type InvoiceDocumentGenerator } from "./service-documents.js";
+import { type InvoiceDocumentGenerator, type InvoiceDocumentRuntimeOptions } from "./service-documents.js";
 type Env = {
     Bindings: Record<string, unknown>;
     Variables: {
@@ -34,6 +34,7 @@ type Env = {
 };
 export interface FinanceDocumentRouteOptions {
     invoiceDocumentGenerator?: InvoiceDocumentGenerator;
+    resolveCustomFields?: InvoiceDocumentRuntimeOptions["resolveCustomFields"];
     resolveInvoiceDocumentGenerator?: (bindings: Record<string, unknown>) => InvoiceDocumentGenerator | undefined;
     resolveDocumentDownloadUrl?: (bindings: unknown, storageKey: string) => Promise<string | null> | string | null;
     eventBus?: EventBus;

package/dist/routes-documents.js

@@ -27,7 +27,7 @@ import { resolveStoredDocumentDownload } from "./document-download.js";
 import { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
 import { invoiceRenditionSchema } from "./routes-invoice-schemas.js";
 import { financeService } from "./service.js";
-import { financeDocumentsService } from "./service-documents.js";
+import { financeDocumentsService, } from "./service-documents.js";
 import { generateInvoiceDocumentInputSchema } from "./validation.js";
 const errorResponseSchema = z.object({ error: z.string() });
 /** The signed inline download envelope (§17: `expiresAt` is an ISO string). */
@@ -140,7 +140,12 @@ export function createFinanceAdminDocumentRoutes(options = {}) {
             return c.json({ error: "Invoice document generator is not configured" }, 501);
         }
         const input = await parseOptionalJsonBody(c, generateInvoiceDocumentInputSchema);
-        const result = await financeDocumentsService.generateInvoiceDocument(c.get("db"), c.req.valid("param").id, input, { generator, bindings: c.env, eventBus: runtime.eventBus });
+        const result = await financeDocumentsService.generateInvoiceDocument(c.get("db"), c.req.valid("param").id, input, {
+            generator,
+            bindings: c.env,
+            eventBus: runtime.eventBus,
+            resolveCustomFields: runtime.resolveCustomFields,
+        });
         if (result.status === "not_found")
             return c.json({ error: "Invoice not found" }, 404);
         if (result.status === "generator_failed") {
@@ -158,7 +163,12 @@ export function createFinanceAdminDocumentRoutes(options = {}) {
             return c.json({ error: "Invoice document generator is not configured" }, 501);
         }
         const input = await parseOptionalJsonBody(c, generateInvoiceDocumentInputSchema);
-        const result = await financeDocumentsService.regenerateInvoiceDocument(c.get("db"), c.req.valid("param").id, input, { generator, bindings: c.env, eventBus: runtime.eventBus });
+        const result = await financeDocumentsService.regenerateInvoiceDocument(c.get("db"), c.req.valid("param").id, input, {
+            generator,
+            bindings: c.env,
+            eventBus: runtime.eventBus,
+            resolveCustomFields: runtime.resolveCustomFields,
+        });
         if (result.status === "not_found")
             return c.json({ error: "Invoice not found" }, 404);
         if (result.status === "generator_failed") {

package/dist/routes-runtime.d.ts

@@ -58,6 +58,7 @@ export declare function getFinanceRouteRuntime(c: {
 }): FinanceRouteRuntime | {
     eventBus: import("@voyant-travel/core").EventBus;
     invoiceDocumentGenerator?: import("./service-documents.js").InvoiceDocumentGenerator;
+    resolveCustomFields?: import("./routes-documents.js").FinanceDocumentRouteOptions["resolveCustomFields"];
     resolveDocumentDownloadUrl?: import("./routes-documents.js").FinanceDocumentRouteOptions["resolveDocumentDownloadUrl"];
     invoiceSettlementPollers?: Record<string, import("./service-settlement.js").InvoiceSettlementPoller> | undefined;
     descriptionResolver?: import("./service-shared.js").InvoiceLineDescriptionResolver;

package/dist/runtime.d.ts

@@ -1,8 +1,9 @@
+import type { CustomFieldsRuntime } from "@voyant-travel/core/custom-fields";
 import type { FinanceApiModuleOptions } from "./index.js";
 import type { FinanceAccommodationsPaymentPolicyRuntime, FinanceBookingScheduleRuntime, FinanceCheckoutPaymentStartersRuntime, FinanceCruisesPaymentPolicyRuntime, FinanceDistributionPaymentPolicyRuntime, FinanceHostRuntime, FinanceInventoryPaymentPolicyRuntime, FinanceInvoiceSettlementPollerProvider, FinanceNotificationsRuntime, FinanceOperatorSettingsRuntime } from "./runtime-port.js";
 import type { InvoiceSettlementPoller } from "./service-settlement.js";
 /** Compose Finance's main HTTP runtime from generic host and selected providers. */
-export declare function createFinanceRuntime(host: FinanceHostRuntime, notifications: FinanceNotificationsRuntime, checkoutPaymentStarters?: FinanceCheckoutPaymentStartersRuntime, invoiceSettlementPollerProviders?: readonly FinanceInvoiceSettlementPollerProvider[]): FinanceApiModuleOptions;
+export declare function createFinanceRuntime(host: FinanceHostRuntime, customFields: CustomFieldsRuntime, notifications: FinanceNotificationsRuntime, checkoutPaymentStarters?: FinanceCheckoutPaymentStartersRuntime, invoiceSettlementPollerProviders?: readonly FinanceInvoiceSettlementPollerProvider[]): FinanceApiModuleOptions;
 /** Compose Finance's payment schedule from statically selected domain providers. */
 export declare function createFinanceBookingScheduleRuntime(host: FinanceHostRuntime, settings: FinanceOperatorSettingsRuntime, distribution: FinanceDistributionPaymentPolicyRuntime, accommodations: FinanceAccommodationsPaymentPolicyRuntime, cruises: FinanceCruisesPaymentPolicyRuntime, inventory: FinanceInventoryPaymentPolicyRuntime): FinanceBookingScheduleRuntime;
 export declare function createFinanceBookingTaxRuntime(settings: FinanceOperatorSettingsRuntime): FinanceApiModuleOptions;

package/dist/runtime.js

@@ -1,9 +1,18 @@
 import { createVoyantDataFxExchangeRateResolver, } from "./invoice-fx.js";
 /** Compose Finance's main HTTP runtime from generic host and selected providers. */
-export function createFinanceRuntime(host, notifications, checkoutPaymentStarters, invoiceSettlementPollerProviders = []) {
+export function createFinanceRuntime(host, customFields, notifications, checkoutPaymentStarters, invoiceSettlementPollerProviders = []) {
     const { primitives } = host;
     return {
         resolveDocumentDownloadUrl: primitives.storage.downloadUrl,
+        resolveCustomFields: async (db, invoice) => {
+            if (invoice.organizationId) {
+                return customFields.resolveVisibleValues(db, "organization", invoice.organizationId, "invoice");
+            }
+            if (invoice.personId) {
+                return customFields.resolveVisibleValues(db, "person", invoice.personId, "invoice");
+            }
+            return {};
+        },
         resolveInvoiceExchangeRateResolver: (bindings) => createExchangeRateResolver(primitives, bindings),
         invoiceSettlementPollers: aggregateFinanceInvoiceSettlementPollers(invoiceSettlementPollerProviders),
         invoiceDueDateResolver: ({ issueDate, dueDate, bookingPaymentSchedule }) => bookingPaymentSchedule && dueDate < issueDate ? issueDate : dueDate,

package/dist/service-booking-create.d.ts

@@ -4,7 +4,7 @@ import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import { z } from "zod";
 import type { BookingPaymentSchedule, Invoice, Payment, TravelCredit, TravelCreditRedemption } from "./schema.js";
 import { type FinanceServiceRuntime } from "./service.js";
-import { type InvoiceDocumentGenerator } from "./service-documents.js";
+import { type InvoiceDocumentGenerator, type InvoiceDocumentRuntimeOptions } from "./service-documents.js";
 declare const travelerInputSchema: z.ZodObject<{
     clientTravelerKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     firstName: z.ZodString;
@@ -301,6 +301,7 @@ export type BookingCreateTravelerInput = z.infer<typeof travelerInputSchema>;
  */
 export interface BookingCreateRuntime extends FinanceServiceRuntime {
     invoiceDocumentGenerator?: InvoiceDocumentGenerator;
+    resolveCustomFields?: InvoiceDocumentRuntimeOptions["resolveCustomFields"];
     bindings?: Record<string, unknown>;
 }
 export interface BookingCreatedEvent {

package/dist/service-booking-create.js

@@ -9,7 +9,7 @@ import { z } from "zod";
 import { bookingPaymentSchedules, travelCredits } from "./schema.js";
 import { financeService, toRows } from "./service.js";
 import { buildBookingCreateRejectedActionLedgerInput, buildBookingCreateSucceededActionLedgerInput, } from "./service-action-ledger.js";
-import { financeDocumentsService } from "./service-documents.js";
+import { financeDocumentsService, } from "./service-documents.js";
 import { TravelCreditServiceError, travelCreditsService } from "./service-travel-credits.js";
 import { paymentMethodSchema, paymentScheduleStatusSchema, paymentScheduleTypeSchema, } from "./validation-shared.js";
 // ---------- validation ----------
@@ -1205,6 +1205,7 @@ export async function createBooking(db, rawInput, options = {}) {
                         generator: runtime.invoiceDocumentGenerator,
                         eventBus: runtime.eventBus,
                         bindings: runtime.bindings,
+                        resolveCustomFields: runtime.resolveCustomFields,
                     });
                     invoiceDocument =
                         generated.status === "generated"

package/dist/service-documents.d.ts

@@ -31,12 +31,10 @@ export interface InvoiceDocumentRuntimeOptions {
     generator: InvoiceDocumentGenerator;
     eventBus?: EventBus;
     /**
-     * Optional: resolve the invoice-visible custom fields for this invoice's
-     * customer, exposed to the template as the `customFields` variable. The
-     * deployment wires this — it holds the custom-field registry and reads the
-     * entity's `custom_fields` column — keeping `finance` decoupled from
-     * `relationships`. Filter with `customFieldsVisibleIn(registry, entity,
-     * "invoice")`. See docs/architecture/custom-fields-unification-adr.md.
+     * Resolve invoice-visible custom fields for this invoice's customer, exposed
+     * to the template as `customFields`. Selected graph runtimes receive this
+     * from the database-backed `custom-fields.runtime` port; optionality remains
+     * only for direct low-level service callers.
      */
     resolveCustomFields?: (db: PostgresJsDatabase, invoice: typeof invoices.$inferSelect) => Promise<Record<string, unknown>> | Record<string, unknown>;
 }

package/dist/voyant.js

@@ -1,6 +1,7 @@
 import { actionLedgerFinanceDriftRuntimePort } from "@voyant-travel/action-ledger/runtime-port";
 import { bookingsFinanceRuntimePort } from "@voyant-travel/bookings/runtime-port";
 import { defineExtension, defineModule, providePort, requirePort, } from "@voyant-travel/core/project";
+import { customFieldsRuntimePort } from "@voyant-travel/core/runtime-port";
 import { financeAccommodationsPaymentPolicyRuntimePort, financeCheckoutPaymentStartersRuntimePort, financeCruisesPaymentPolicyRuntimePort, financeDistributionPaymentPolicyRuntimePort, financeHostRuntimePort, financeInventoryPaymentPolicyRuntimePort, financeInvoiceSettlementPollerRuntimePort, financeNotificationsRuntimePort, financeOperatorSettingsRuntimePort, } from "./runtime-port.js";
 import { financeVoyantAdmin } from "./voyant-admin.js";
 import { bookingContractDocumentRequestedPayloadSchema, bookingCreatedPayloadSchema, bookingCreateRejectedPayloadSchema, bookingDualCreatedPayloadSchema, bookingPaymentSchedulePaidPayloadSchema, invoiceDocumentGeneratedPayloadSchema, invoiceIssuedPayloadSchema, invoicePaymentRecordedPayloadSchema, invoiceProformaConvertedPayloadSchema, invoiceRenderedPayloadSchema, invoiceSettledPayloadSchema, invoiceVoidedPayloadSchema, paymentCompletedPayloadSchema, } from "./voyant-event-schemas.js";
@@ -12,6 +13,7 @@ export const financeVoyantModule = defineModule({
     runtime: { entry: "@voyant-travel/finance", export: "createFinanceVoyantRuntime" },
     runtimePorts: [
         requirePort(financeHostRuntimePort),
+        requirePort(customFieldsRuntimePort),
         requirePort(financeNotificationsRuntimePort),
         requirePort(financeCheckoutPaymentStartersRuntimePort, { optional: true }),
         requirePort(financeInvoiceSettlementPollerRuntimePort, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.162.1",
+  "version": "0.163.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -145,17 +145,17 @@
     "fflate": "^0.8.2",
     "hono": "^4.12.27",
     "zod": "^4.4.3",
-    "@voyant-travel/core": "^0.124.0",
-    "@voyant-travel/db": "^0.114.8",
-    "@voyant-travel/action-ledger": "^0.111.0",
-    "@voyant-travel/bookings": "^0.162.1",
+    "@voyant-travel/action-ledger": "^0.111.1",
+    "@voyant-travel/bookings": "^0.163.0",
+    "@voyant-travel/core": "^0.125.0",
+    "@voyant-travel/db": "^0.114.9",
     "@voyant-travel/types": "^0.109.2",
-    "@voyant-travel/finance-contracts": "^0.106.1",
-    "@voyant-travel/hono": "^0.128.0",
-    "@voyant-travel/public-document-delivery": "^0.4.0",
-    "@voyant-travel/storage": "^0.111.0",
-    "@voyant-travel/tools": "^0.3.0",
-    "@voyant-travel/utils": "^0.107.1"
+    "@voyant-travel/finance-contracts": "^0.106.2",
+    "@voyant-travel/hono": "^0.128.1",
+    "@voyant-travel/public-document-delivery": "^0.4.1",
+    "@voyant-travel/storage": "^0.111.1",
+    "@voyant-travel/utils": "^0.107.1",
+    "@voyant-travel/tools": "^0.3.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",