@voyant-travel/finance 0.158.0 → 0.161.0

package/dist/service-issue.js

@@ -20,6 +20,84 @@ const TAX_REGIME_CODES = new Set([
 const ISSUED_EVENT = "invoice.issued";
 const PROFORMA_ISSUED_EVENT = "invoice.proforma.issued";
 const PROFORMA_CONVERTED_EVENT = "invoice.proforma.converted";
+/**
+ * Package-owned invoice-from-booking composer shared by HTTP routes and Tools.
+ * It owns the cross-module projection read so transport adapters never reach
+ * into booking or finance tables themselves.
+ */
+export async function issueInvoiceFromBookingCommand(db, input, runtime = {}) {
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, input.bookingId))
+        .limit(1);
+    if (!booking)
+        return { status: "booking_not_found" };
+    const items = await db
+        .select()
+        .from(bookingItems)
+        .where(eq(bookingItems.bookingId, booking.id))
+        .orderBy(asc(bookingItems.createdAt), asc(bookingItems.id));
+    const [paymentSchedule] = input.bookingPaymentScheduleId
+        ? await db
+            .select()
+            .from(bookingPaymentSchedules)
+            .where(and(eq(bookingPaymentSchedules.id, input.bookingPaymentScheduleId), eq(bookingPaymentSchedules.bookingId, booking.id)))
+            .limit(1)
+        : [];
+    if (input.bookingPaymentScheduleId && !paymentSchedule) {
+        return { status: "payment_schedule_not_found" };
+    }
+    const bookingData = {
+        booking: {
+            id: booking.id,
+            bookingNumber: booking.bookingNumber,
+            personId: booking.personId,
+            organizationId: booking.organizationId,
+            startDate: booking.startDate,
+            endDate: booking.endDate,
+            sellCurrency: booking.sellCurrency,
+            baseCurrency: booking.baseCurrency,
+            fxRateSetId: booking.fxRateSetId,
+            sellAmountCents: booking.sellAmountCents,
+            baseSellAmountCents: booking.baseSellAmountCents,
+        },
+        paymentSchedule: paymentSchedule
+            ? {
+                id: paymentSchedule.id,
+                bookingId: paymentSchedule.bookingId,
+                bookingItemId: paymentSchedule.bookingItemId,
+                scheduleType: paymentSchedule.scheduleType,
+                dueDate: paymentSchedule.dueDate,
+                currency: paymentSchedule.currency,
+                amountCents: paymentSchedule.amountCents,
+            }
+            : null,
+        items: items.map((item) => ({
+            id: item.id,
+            title: item.title,
+            productId: item.productId,
+            productName: item.productNameSnapshot,
+            productNameSnapshot: item.productNameSnapshot,
+            optionNameSnapshot: item.optionNameSnapshot,
+            unitNameSnapshot: item.unitNameSnapshot,
+            departureLabelSnapshot: item.departureLabelSnapshot,
+            startDate: item.serviceDate ?? item.startsAt,
+            serviceDate: item.serviceDate,
+            startsAt: item.startsAt,
+            endDate: item.endsAt ?? item.serviceDate,
+            endsAt: item.endsAt,
+            quantity: item.quantity,
+            unitSellAmountCents: item.unitSellAmountCents,
+            totalSellAmountCents: item.totalSellAmountCents,
+        })),
+    };
+    const issuer = input.invoiceType === "proforma" ? issueProformaFromBooking : issueInvoiceFromBooking;
+    const invoice = await issuer(db, input, bookingData, runtime);
+    if (!invoice)
+        return { status: "booking_not_found" };
+    return { status: "issued", invoice };
+}
 /**
  * Create + emit an invoice from a booking. Returns the persisted row
  * after flipping the status from `draft` to `issued`. Drafts shouldn't
@@ -41,7 +119,7 @@ export async function issueInvoiceFromBooking(db, input, bookingData, runtime =
             const [row] = await updateIssuedInvoice(tx);
             if (row) {
                 await touchLinkedBookingUpdatedAt(tx, row.bookingId);
-                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, invoiceIssueLedgerOptions(runtime)));
             }
             return row;
         })
@@ -75,7 +153,7 @@ export async function issueProformaFromBooking(db, input, bookingData, runtime =
             const [row] = await updateIssuedInvoice(tx);
             if (row) {
                 await touchLinkedBookingUpdatedAt(tx, row.bookingId);
-                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, invoiceIssueLedgerOptions(runtime)));
             }
             return row;
         })
@@ -89,6 +167,21 @@ export async function issueProformaFromBooking(db, input, bookingData, runtime =
     });
     return row;
 }
+function invoiceIssueLedgerOptions(runtime) {
+    return {
+        authorizationSource: runtime.actionLedgerAuthorizationSource,
+        actionName: runtime.actionLedgerActionName,
+        routeOrToolName: runtime.actionLedgerRouteOrToolName,
+        capabilityId: runtime.actionLedgerCapabilityId,
+        capabilityVersion: runtime.actionLedgerCapabilityVersion,
+        evaluatedRisk: runtime.actionLedgerEvaluatedRisk,
+        causationActionId: runtime.actionLedgerCausationActionId,
+        approvalId: runtime.actionLedgerApprovalId,
+        idempotencyScope: runtime.actionLedgerIdempotencyScope,
+        idempotencyKey: runtime.actionLedgerIdempotencyKey,
+        idempotencyFingerprint: runtime.actionLedgerIdempotencyFingerprint,
+    };
+}
 async function emitIssued(db, runtime, eventName, invoice, options = {}) {
     if (!runtime.eventBus)
         return;

package/dist/service-shared.d.ts

@@ -368,6 +368,18 @@ export interface FinanceServiceRuntime extends InvoiceFxOptions {
     eventBus?: EventBus;
     actionLedgerContext?: ActionLedgerRequestContextValues;
     actionLedgerAuthorizationSource?: string | null;
+    actionLedgerActionName?: string | null;
+    actionLedgerRouteOrToolName?: string | null;
+    actionLedgerTargetType?: string | null;
+    actionLedgerTargetId?: string | null;
+    actionLedgerCapabilityId?: string | null;
+    actionLedgerCapabilityVersion?: string | null;
+    actionLedgerEvaluatedRisk?: "low" | "medium" | "high" | "critical" | null;
+    actionLedgerCausationActionId?: string | null;
+    actionLedgerApprovalId?: string | null;
+    actionLedgerIdempotencyScope?: string | null;
+    actionLedgerIdempotencyKey?: string | null;
+    actionLedgerIdempotencyFingerprint?: string | null;
     descriptionResolver?: InvoiceLineDescriptionResolver;
     invoiceDueDateResolver?: InvoiceDueDateResolver;
     paymentScheduleLineDescriptionFormat?: PaymentScheduleLineDescriptionFormat;

package/dist/service.d.ts

@@ -1147,6 +1147,21 @@ export declare const financeService: {
             generated: undefined;
         }, {}, {}>;
     }>, "where" | "orderBy">;
+    getCreditNoteById(db: import("drizzle-orm/postgres-js").PostgresJsDatabase, creditNoteId: string): Promise<{
+        id: string;
+        creditNoteNumber: string;
+        invoiceId: string;
+        status: "draft" | "issued" | "applied";
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        fxRateSetId: string | null;
+        reason: string;
+        notes: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
     createCreditNote(db: import("drizzle-orm/postgres-js").PostgresJsDatabase, invoiceId: string, data: import("./service-shared.js").CreateCreditNoteInput, runtime?: import("./service-shared.js").FinanceServiceRuntime): Promise<{
         id: string;
         status: "draft" | "issued" | "applied";