@voyant-travel/finance 0.119.5

package/dist/service-action-ledger-accounting.js

@@ -0,0 +1,386 @@
+// agent-quality: file-size exception -- owner: finance; existing service module stays co-located until a dedicated split preserves behavior and tests.
+import { buildIdempotencyFingerprint, } from "@voyant-travel/action-ledger";
+export async function buildRecordPaymentActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const idempotency = await buildRecordPaymentIdempotency(input.invoice, input.payment, {
+        requestedKey: options.idempotencyKey,
+        targetType: target.type,
+        targetId: target.id,
+    });
+    return {
+        context,
+        actionName: "finance.payment.record",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment.record",
+        authorizationSource: options.authorizationSource ?? "finance.payment.route",
+        idempotencyScope: idempotency.scope,
+        idempotencyKey: idempotency.key,
+        idempotencyFingerprint: idempotency.fingerprint,
+        mutationDetail: {
+            commandInputRef: `invoice:${input.invoice.id}:payment`,
+            commandResultRef: `payment:${input.payment.id}`,
+            summary: `Payment ${input.payment.id} recorded for invoice ${input.invoice.id}`,
+            reversalKind: "none",
+        },
+    };
+}
+export async function buildRecordPaymentIdempotency(invoice, payment, options = {}) {
+    const target = getInvoiceLedgerTarget(invoice);
+    const targetType = options.targetType ?? target.type;
+    const targetId = options.targetId ?? target.id;
+    const naturalCommandInput = {
+        invoiceId: invoice.id,
+        amountCents: payment.amountCents,
+        currency: payment.currency,
+        baseCurrency: payment.baseCurrency ?? null,
+        baseAmountCents: payment.baseAmountCents ?? null,
+        fxRateSetId: payment.fxRateSetId ?? null,
+        paymentMethod: payment.paymentMethod,
+        paymentInstrumentId: normalizeLedgerIdempotencyString(payment.paymentInstrumentId),
+        paymentAuthorizationId: normalizeLedgerIdempotencyString(payment.paymentAuthorizationId),
+        paymentCaptureId: normalizeLedgerIdempotencyString(payment.paymentCaptureId),
+        status: payment.status,
+        referenceNumber: normalizeLedgerIdempotencyString(payment.referenceNumber),
+        paymentDate: payment.paymentDate,
+    };
+    const requestedKey = normalizeLedgerIdempotencyString(options.requestedKey);
+    const naturalKey = normalizeLedgerIdempotencyString(payment.referenceNumber) ??
+        normalizeLedgerIdempotencyString(payment.paymentCaptureId) ??
+        normalizeLedgerIdempotencyString(payment.paymentAuthorizationId) ??
+        (await buildIdempotencyFingerprint({
+            actionName: "finance.payment.record",
+            actionVersion: "v1",
+            targetType,
+            targetId,
+            commandInput: naturalCommandInput,
+        }));
+    return {
+        scope: `finance.invoice:${invoice.id}:payment`,
+        key: requestedKey ?? naturalKey,
+        fingerprint: await buildIdempotencyFingerprint({
+            actionName: "finance.payment.record",
+            actionVersion: "v1",
+            targetType,
+            targetId,
+            commandInput: naturalCommandInput,
+        }),
+    };
+}
+function normalizeLedgerIdempotencyString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : null;
+}
+export function buildPaymentUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.payment.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment.update",
+        authorizationSource: options.authorizationSource ?? "finance.payment.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `payment:${input.payment.id}:update`,
+            commandResultRef: `payment:${input.payment.id}`,
+            summary: `Payment ${input.payment.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildPaymentDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    return {
+        context,
+        actionName: "finance.payment.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment.delete",
+        authorizationSource: options.authorizationSource ?? "finance.payment.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `payment:${input.payment.id}:delete`,
+            commandResultRef: null,
+            summary: `Payment ${input.payment.id} deleted from invoice ${input.invoice.invoiceNumber}`,
+            reversalKind: "none",
+        },
+    };
+}
+function getInvoiceLedgerTarget(invoice) {
+    if (invoice.bookingId)
+        return { type: "booking", id: invoice.bookingId };
+    return { type: "invoice", id: invoice.id };
+}
+export async function buildInvoiceIssuedActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const invoiceTypeLabel = input.invoice.invoiceType === "proforma" ? "Proforma" : "Invoice";
+    return {
+        context,
+        actionName: "finance.invoice.issue_from_booking",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice.issue_from_booking",
+        authorizationSource: options.authorizationSource ?? "finance.invoice.from_booking.route",
+        idempotencyScope: `finance.booking:${input.invoice.bookingId}:invoice_issue`,
+        idempotencyKey: input.invoice.invoiceNumber,
+        idempotencyFingerprint: await buildIdempotencyFingerprint({
+            actionName: "finance.invoice.issue_from_booking",
+            actionVersion: "v1",
+            targetType: target.type,
+            targetId: target.id,
+            commandInput: {
+                invoiceId: input.invoice.id,
+                invoiceNumber: input.invoice.invoiceNumber,
+                invoiceType: input.invoice.invoiceType,
+                bookingId: input.invoice.bookingId,
+                totalCents: input.invoice.totalCents,
+                currency: input.invoice.currency,
+                status: input.invoice.status,
+                issueDate: input.invoice.issueDate,
+                dueDate: input.invoice.dueDate,
+            },
+        }),
+        mutationDetail: {
+            commandInputRef: `booking:${input.invoice.bookingId}:invoice_issue`,
+            commandResultRef: `invoice:${input.invoice.id}`,
+            summary: `${invoiceTypeLabel} ${input.invoice.invoiceNumber} issued for booking ${input.invoice.bookingId}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildInvoiceUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.invoice.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice.update",
+        authorizationSource: options.authorizationSource ?? "finance.invoice.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `invoice:${input.invoice.id}:update`,
+            commandResultRef: `invoice:${input.invoice.id}`,
+            summary: `Invoice ${input.invoice.invoiceNumber} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildInvoiceDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    return {
+        context,
+        actionName: "finance.invoice.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice.delete",
+        authorizationSource: options.authorizationSource ?? "finance.invoice.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `invoice:${input.invoice.id}:delete`,
+            commandResultRef: null,
+            summary: `Draft invoice ${input.invoice.invoiceNumber} deleted`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildInvoiceLineItemCreateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    return {
+        context,
+        actionName: "finance.invoice_line_item.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice_line_item.create",
+        authorizationSource: options.authorizationSource ?? "finance.invoice_line_item.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `invoice:${input.invoice.id}:line_item`,
+            commandResultRef: `invoice_line_item:${input.lineItem.id}`,
+            summary: `Line item ${input.lineItem.id} added to invoice ${input.invoice.invoiceNumber}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildInvoiceLineItemUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const changedFields = Object.keys(input.changes ?? {}).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.invoice_line_item.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice_line_item.update",
+        authorizationSource: options.authorizationSource ?? "finance.invoice_line_item.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `invoice_line_item:${input.lineItem.id}:update`,
+            commandResultRef: `invoice_line_item:${input.lineItem.id}`,
+            summary: `Line item ${input.lineItem.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildInvoiceLineItemDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    return {
+        context,
+        actionName: "finance.invoice_line_item.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.invoice_line_item.delete",
+        authorizationSource: options.authorizationSource ?? "finance.invoice_line_item.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `invoice_line_item:${input.lineItem.id}:delete`,
+            commandResultRef: null,
+            summary: `Line item ${input.lineItem.id} deleted from invoice ${input.invoice.invoiceNumber}`,
+            reversalKind: "none",
+        },
+    };
+}
+export async function buildCreditNoteCreationActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const idempotencyKey = input.creditNote.creditNoteNumber;
+    return {
+        context,
+        actionName: "finance.credit_note.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.credit_note.create",
+        authorizationSource: options.authorizationSource ?? "finance.credit_note.route",
+        idempotencyScope: `finance.invoice:${input.invoice.id}:credit_note`,
+        idempotencyKey,
+        idempotencyFingerprint: await buildIdempotencyFingerprint({
+            actionName: "finance.credit_note.create",
+            actionVersion: "v1",
+            targetType: target.type,
+            targetId: target.id,
+            commandInput: {
+                invoiceId: input.invoice.id,
+                creditNoteId: input.creditNote.id,
+                creditNoteNumber: input.creditNote.creditNoteNumber,
+                amountCents: input.creditNote.amountCents,
+                currency: input.creditNote.currency,
+                status: input.creditNote.status,
+                reason: input.creditNote.reason,
+            },
+        }),
+        mutationDetail: {
+            commandInputRef: `invoice:${input.invoice.id}:credit_note`,
+            commandResultRef: `credit_note:${input.creditNote.id}`,
+            summary: `Credit note ${input.creditNote.creditNoteNumber} created for invoice ${input.invoice.id}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildCreditNoteUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.credit_note.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.credit_note.update",
+        authorizationSource: options.authorizationSource ?? "finance.credit_note.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `credit_note:${input.creditNote.id}:update`,
+            commandResultRef: `credit_note:${input.creditNote.id}`,
+            summary: `Credit note ${input.creditNote.creditNoteNumber} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildCreditNoteLineItemCreateActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    return {
+        context,
+        actionName: "finance.credit_note_line_item.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.credit_note_line_item.create",
+        authorizationSource: options.authorizationSource ?? "finance.credit_note_line_item.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `credit_note:${input.creditNote.id}:line_item`,
+            commandResultRef: `credit_note_line_item:${input.lineItem.id}`,
+            summary: `Line item ${input.lineItem.id} added to credit note ${input.creditNote.creditNoteNumber}`,
+            reversalKind: "none",
+        },
+    };
+}

package/dist/service-action-ledger-booking-payments.d.ts

@@ -0,0 +1,48 @@
+import { type ActionLedgerRequestContextValues, type BuildActionLedgerMutationInput } from "@voyant-travel/action-ledger";
+import type { z } from "zod";
+import type { bookingGuarantees, bookingPaymentSchedules } from "./schema.js";
+import type { updateBookingGuaranteeSchema, updateBookingPaymentScheduleSchema } from "./validation.js";
+type UpdateBookingPaymentScheduleInput = z.infer<typeof updateBookingPaymentScheduleSchema>;
+type UpdateBookingGuaranteeInput = z.infer<typeof updateBookingGuaranteeSchema>;
+type BookingPaymentScheduleRecord = typeof bookingPaymentSchedules.$inferSelect;
+type BookingGuaranteeRecord = typeof bookingGuarantees.$inferSelect;
+type BookingPaymentScheduleCreateLedgerInput = {
+    schedule: BookingPaymentScheduleRecord;
+};
+type BookingPaymentScheduleUpdateLedgerInput = {
+    schedule: BookingPaymentScheduleRecord;
+    changes: UpdateBookingPaymentScheduleInput;
+};
+type BookingPaymentScheduleDeleteLedgerInput = {
+    schedule: BookingPaymentScheduleRecord;
+};
+type BookingGuaranteeCreateLedgerInput = {
+    guarantee: BookingGuaranteeRecord;
+};
+type BookingGuaranteeUpdateLedgerInput = {
+    guarantee: BookingGuaranteeRecord;
+    changes: UpdateBookingGuaranteeInput;
+};
+type BookingGuaranteeDeleteLedgerInput = {
+    guarantee: BookingGuaranteeRecord;
+};
+export declare function buildBookingPaymentScheduleCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingPaymentScheduleCreateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildBookingPaymentScheduleUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingPaymentScheduleUpdateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildBookingPaymentScheduleDeleteActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingPaymentScheduleDeleteLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildBookingGuaranteeCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingGuaranteeCreateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildBookingGuaranteeUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingGuaranteeUpdateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildBookingGuaranteeDeleteActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingGuaranteeDeleteLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export {};
+//# sourceMappingURL=service-action-ledger-booking-payments.d.ts.map

package/dist/service-action-ledger-booking-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-action-ledger-booking-payments.d.ts","sourceRoot":"","sources":["../src/service-action-ledger-booking-payments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EAEpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EACV,4BAA4B,EAC5B,kCAAkC,EACnC,MAAM,iBAAiB,CAAA;AAExB,KAAK,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC3F,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAE/E,KAAK,4BAA4B,GAAG,OAAO,uBAAuB,CAAC,YAAY,CAAA;AAC/E,KAAK,sBAAsB,GAAG,OAAO,iBAAiB,CAAC,YAAY,CAAA;AAEnE,KAAK,uCAAuC,GAAG;IAC7C,QAAQ,EAAE,4BAA4B,CAAA;CACvC,CAAA;AACD,KAAK,uCAAuC,GAAG;IAC7C,QAAQ,EAAE,4BAA4B,CAAA;IACtC,OAAO,EAAE,iCAAiC,CAAA;CAC3C,CAAA;AACD,KAAK,uCAAuC,GAAG;IAC7C,QAAQ,EAAE,4BAA4B,CAAA;CACvC,CAAA;AACD,KAAK,iCAAiC,GAAG;IACvC,SAAS,EAAE,sBAAsB,CAAA;CAClC,CAAA;AACD,KAAK,iCAAiC,GAAG;IACvC,SAAS,EAAE,sBAAsB,CAAA;IACjC,OAAO,EAAE,2BAA2B,CAAA;CACrC,CAAA;AACD,KAAK,iCAAiC,GAAG;IACvC,SAAS,EAAE,sBAAsB,CAAA;CAClC,CAAA;AAED,wBAAgB,kDAAkD,CAChE,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,uCAAuC,EAC9C,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CAwBhC;AAED,wBAAgB,kDAAkD,CAChE,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,uCAAuC,EAC9C,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CA0BhC;AAED,wBAAgB,kDAAkD,CAChE,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,uCAAuC,EAC9C,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CAwBhC;AAMD,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,iCAAiC,EACxC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,OAAO,CAAC,8BAA8B,CAAC,CA+CzC;AAED,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,iCAAiC,EACxC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CA0BhC;AAED,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,iCAAiC,EACxC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CAwBhC"}

package/dist/service-action-ledger-booking-payments.js

@@ -0,0 +1,178 @@
+import { buildIdempotencyFingerprint, } from "@voyant-travel/action-ledger";
+export function buildBookingPaymentScheduleCreateActionLedgerInput(context, input, options = {}) {
+    const target = getBookingPaymentScheduleLedgerTarget(input.schedule);
+    return {
+        context,
+        actionName: "finance.booking_payment_schedule.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_payment_schedule.create",
+        authorizationSource: options.authorizationSource ?? "finance.booking_payment_schedule.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `booking:${input.schedule.bookingId}:payment_schedule`,
+            commandResultRef: `booking_payment_schedule:${input.schedule.id}`,
+            summary: `Payment schedule ${input.schedule.id} created for booking ${input.schedule.bookingId}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildBookingPaymentScheduleUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getBookingPaymentScheduleLedgerTarget(input.schedule);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.booking_payment_schedule.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_payment_schedule.update",
+        authorizationSource: options.authorizationSource ?? "finance.booking_payment_schedule.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `booking_payment_schedule:${input.schedule.id}:update`,
+            commandResultRef: `booking_payment_schedule:${input.schedule.id}`,
+            summary: `Payment schedule ${input.schedule.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildBookingPaymentScheduleDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getBookingPaymentScheduleLedgerTarget(input.schedule);
+    return {
+        context,
+        actionName: "finance.booking_payment_schedule.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_payment_schedule.delete",
+        authorizationSource: options.authorizationSource ?? "finance.booking_payment_schedule.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `booking_payment_schedule:${input.schedule.id}:delete`,
+            commandResultRef: null,
+            summary: `Payment schedule ${input.schedule.id} deleted`,
+            reversalKind: "none",
+        },
+    };
+}
+function getBookingPaymentScheduleLedgerTarget(schedule) {
+    return { type: "booking", id: schedule.bookingId };
+}
+export async function buildBookingGuaranteeCreateActionLedgerInput(context, input, options = {}) {
+    const target = getBookingGuaranteeLedgerTarget(input.guarantee);
+    const idempotencyKey = input.guarantee.referenceNumber;
+    return {
+        context,
+        actionName: "finance.booking_guarantee.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_guarantee.create",
+        authorizationSource: options.authorizationSource ?? "finance.booking_guarantee.route",
+        idempotencyScope: idempotencyKey
+            ? `finance.booking:${input.guarantee.bookingId}:guarantee`
+            : null,
+        idempotencyKey,
+        idempotencyFingerprint: idempotencyKey
+            ? await buildIdempotencyFingerprint({
+                actionName: "finance.booking_guarantee.create",
+                actionVersion: "v1",
+                targetType: target.type,
+                targetId: target.id,
+                commandInput: {
+                    bookingGuaranteeId: input.guarantee.id,
+                    bookingId: input.guarantee.bookingId,
+                    bookingPaymentScheduleId: input.guarantee.bookingPaymentScheduleId,
+                    guaranteeType: input.guarantee.guaranteeType,
+                    status: input.guarantee.status,
+                    paymentInstrumentId: input.guarantee.paymentInstrumentId,
+                    paymentAuthorizationId: input.guarantee.paymentAuthorizationId,
+                    currency: input.guarantee.currency,
+                    amountCents: input.guarantee.amountCents,
+                    provider: input.guarantee.provider,
+                    referenceNumber: input.guarantee.referenceNumber,
+                },
+            })
+            : null,
+        mutationDetail: {
+            commandInputRef: `booking:${input.guarantee.bookingId}:guarantee`,
+            commandResultRef: `booking_guarantee:${input.guarantee.id}`,
+            summary: `Booking guarantee ${input.guarantee.id} created for booking ${input.guarantee.bookingId}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildBookingGuaranteeUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getBookingGuaranteeLedgerTarget(input.guarantee);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.booking_guarantee.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_guarantee.update",
+        authorizationSource: options.authorizationSource ?? "finance.booking_guarantee.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `booking_guarantee:${input.guarantee.id}:update`,
+            commandResultRef: `booking_guarantee:${input.guarantee.id}`,
+            summary: `Booking guarantee ${input.guarantee.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildBookingGuaranteeDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getBookingGuaranteeLedgerTarget(input.guarantee);
+    return {
+        context,
+        actionName: "finance.booking_guarantee.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.booking_guarantee.delete",
+        authorizationSource: options.authorizationSource ?? "finance.booking_guarantee.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `booking_guarantee:${input.guarantee.id}:delete`,
+            commandResultRef: null,
+            summary: `Booking guarantee ${input.guarantee.id} deleted`,
+            reversalKind: "none",
+        },
+    };
+}
+function getBookingGuaranteeLedgerTarget(guarantee) {
+    return { type: "booking", id: guarantee.bookingId };
+}

package/dist/service-action-ledger-bookings.d.ts

@@ -0,0 +1,44 @@
+import { type ActionLedgerRequestContextValues, type BuildActionLedgerMutationInput } from "@voyant-travel/action-ledger";
+import type { Booking } from "@voyant-travel/bookings/schema";
+type BookingCreateLedgerCommand = {
+    productId: string;
+    optionId?: string | null;
+    slotId?: string | null;
+    bookingNumber: string;
+    personId?: string | null;
+    organizationId?: string | null;
+    pax?: number | null;
+    itemLineCount?: number;
+    extraLineCount?: number;
+    travelerCount?: number;
+    paymentScheduleCount?: number;
+    voucherRedemptionRequested?: boolean;
+    groupMembershipAction?: "join" | "create" | null;
+    initialStatus?: string | null;
+    documentGeneration?: {
+        contractDocument: boolean;
+        invoiceDocument: boolean;
+        invoiceType: "invoice" | "proforma";
+    };
+};
+type BookingCreateSucceededLedgerInput = {
+    booking: Booking;
+    command: BookingCreateLedgerCommand;
+};
+type BookingCreateRejectedLedgerInput = {
+    existingBooking: {
+        id: string;
+        bookingNumber: string;
+        status: string;
+    };
+    command: BookingCreateLedgerCommand;
+    reason: "duplicate_booking";
+};
+export declare function buildBookingCreateSucceededActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingCreateSucceededLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildBookingCreateRejectedActionLedgerInput(context: ActionLedgerRequestContextValues, input: BookingCreateRejectedLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export {};
+//# sourceMappingURL=service-action-ledger-bookings.d.ts.map

package/dist/service-action-ledger-bookings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-action-ledger-bookings.d.ts","sourceRoot":"","sources":["../src/service-action-ledger-bookings.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EAEpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAE7D,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,qBAAqB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAA;IAChD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,kBAAkB,CAAC,EAAE;QACnB,gBAAgB,EAAE,OAAO,CAAA;QACzB,eAAe,EAAE,OAAO,CAAA;QACxB,WAAW,EAAE,SAAS,GAAG,UAAU,CAAA;KACpC,CAAA;CACF,CAAA;AAED,KAAK,iCAAiC,GAAG;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,0BAA0B,CAAA;CACpC,CAAA;AAED,KAAK,gCAAgC,GAAG;IACtC,eAAe,EAAE;QACf,EAAE,EAAE,MAAM,CAAA;QACV,aAAa,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,OAAO,EAAE,0BAA0B,CAAA;IACnC,MAAM,EAAE,mBAAmB,CAAA;CAC5B,CAAA;AAED,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,iCAAiC,EACxC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,OAAO,CAAC,8BAA8B,CAAC,CA4BzC;AAED,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,gCAAgC,EACvC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,OAAO,CAAC,8BAA8B,CAAC,CA+BzC"}