@voyantjs/finance 0.52.2 → 0.52.3

package/dist/schema.d.ts

@@ -87,7 +87,7 @@ export declare const vouchers: import("drizzle-orm/pg-core").PgTableWithColumns<
             tableName: "vouchers";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "void" | "active" | "expired" | "redeemed";
+            data: "expired" | "void" | "active" | "redeemed";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -496,7 +496,7 @@ export declare const paymentInstruments: import("drizzle-orm/pg-core").PgTableWi
             tableName: "payment_instruments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "internal" | "supplier" | "other" | "client" | "channel" | "agency";
+            data: "other" | "client" | "supplier" | "channel" | "agency" | "internal";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -581,7 +581,7 @@ export declare const paymentInstruments: import("drizzle-orm/pg-core").PgTableWi
             tableName: "payment_instruments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "voucher" | "wallet" | "credit_card" | "debit_card" | "cash" | "direct_bill" | "bank_account";
+            data: "credit_card" | "debit_card" | "cash" | "wallet" | "direct_bill" | "voucher" | "other" | "bank_account";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -598,7 +598,7 @@ export declare const paymentInstruments: import("drizzle-orm/pg-core").PgTableWi
             tableName: "payment_instruments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "active" | "expired" | "revoked" | "inactive" | "failed_verification";
+            data: "expired" | "active" | "inactive" | "revoked" | "failed_verification";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -1100,7 +1100,7 @@ export declare const paymentSessions: import("drizzle-orm/pg-core").PgTableWithC
             tableName: "payment_sessions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+            data: "failed" | "expired" | "cancelled" | "pending" | "processing" | "paid" | "requires_redirect" | "authorized";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -1253,7 +1253,7 @@ export declare const paymentSessions: import("drizzle-orm/pg-core").PgTableWithC
             tableName: "payment_sessions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
+            data: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other";
             driverParam: string;
             notNull: false;
             hasDefault: false;
@@ -1725,7 +1725,7 @@ export declare const paymentAuthorizations: import("drizzle-orm/pg-core").PgTabl
             tableName: "payment_authorizations";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "failed" | "expired" | "authorized" | "partially_captured" | "captured" | "voided";
+            data: "failed" | "expired" | "pending" | "authorized" | "partially_captured" | "captured" | "voided";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -1742,7 +1742,7 @@ export declare const paymentAuthorizations: import("drizzle-orm/pg-core").PgTabl
             tableName: "payment_authorizations";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "manual" | "automatic";
+            data: "automatic" | "manual";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -2006,7 +2006,7 @@ export declare const paymentCaptures: import("drizzle-orm/pg-core").PgTableWithC
             tableName: "payment_captures";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "completed" | "failed" | "refunded" | "voided";
+            data: "failed" | "pending" | "completed" | "refunded" | "voided";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -2253,7 +2253,7 @@ export declare const bookingPaymentSchedules: import("drizzle-orm/pg-core").PgTa
             tableName: "booking_payment_schedules";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+            data: "expired" | "cancelled" | "pending" | "paid" | "due" | "waived";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -2449,7 +2449,7 @@ export declare const bookingGuarantees: import("drizzle-orm/pg-core").PgTableWit
             tableName: "booking_guarantees";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
+            data: "bank_transfer" | "credit_card" | "voucher" | "other" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -2466,7 +2466,7 @@ export declare const bookingGuarantees: import("drizzle-orm/pg-core").PgTableWit
             tableName: "booking_guarantees";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "failed" | "cancelled" | "active" | "expired" | "released";
+            data: "failed" | "expired" | "cancelled" | "pending" | "active" | "released";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -2994,7 +2994,7 @@ export declare const bookingItemCommissions: import("drizzle-orm/pg-core").PgTab
             tableName: "booking_item_commissions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "internal" | "supplier" | "other" | "affiliate" | "channel" | "agency" | "agent";
+            data: "agent" | "other" | "supplier" | "channel" | "agency" | "internal" | "affiliate";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -3079,7 +3079,7 @@ export declare const bookingItemCommissions: import("drizzle-orm/pg-core").PgTab
             tableName: "booking_item_commissions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "void" | "paid" | "accrued" | "payable";
+            data: "pending" | "paid" | "void" | "accrued" | "payable";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -3394,7 +3394,7 @@ export declare const invoices: import("drizzle-orm/pg-core").PgTableWithColumns<
             tableName: "invoices";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
+            data: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -4058,7 +4058,7 @@ export declare const payments: import("drizzle-orm/pg-core").PgTableWithColumns<
             tableName: "payments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
+            data: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -4126,7 +4126,7 @@ export declare const payments: import("drizzle-orm/pg-core").PgTableWithColumns<
             tableName: "payments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "completed" | "failed" | "refunded";
+            data: "failed" | "pending" | "completed" | "refunded";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -4765,7 +4765,7 @@ export declare const supplierPayments: import("drizzle-orm/pg-core").PgTableWith
             tableName: "supplier_payments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
+            data: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -4799,7 +4799,7 @@ export declare const supplierPayments: import("drizzle-orm/pg-core").PgTableWith
             tableName: "supplier_payments";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "completed" | "failed" | "refunded";
+            data: "failed" | "pending" | "completed" | "refunded";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -5515,7 +5515,7 @@ export declare const invoiceRenditions: import("drizzle-orm/pg-core").PgTableWit
             tableName: "invoice_renditions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "json" | "pdf" | "html" | "xml";
+            data: "json" | "html" | "pdf" | "xml";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -5532,7 +5532,7 @@ export declare const invoiceRenditions: import("drizzle-orm/pg-core").PgTableWit
             tableName: "invoice_renditions";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "pending" | "failed" | "ready" | "stale";
+            data: "failed" | "pending" | "ready" | "stale";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -6488,7 +6488,7 @@ export declare const taxPolicyRules: import("drizzle-orm/pg-core").PgTableWithCo
             tableName: "tax_policy_rules";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "all" | "accommodation" | "base" | "addon";
+            data: "base" | "addon" | "accommodation" | "all";
             driverParam: string;
             notNull: true;
             hasDefault: true;

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

@@ -0,0 +1,77 @@
+import { type ActionLedgerRequestContextValues, type BuildActionLedgerMutationInput } from "@voyantjs/action-ledger";
+import type { z } from "zod";
+import type { creditNoteLineItems, creditNotes, invoiceLineItems, invoices, payments } from "./schema.js";
+import type { updateCreditNoteSchema, updateInvoiceLineItemSchema, updateInvoiceSchema } from "./validation.js";
+type UpdateInvoiceInput = z.infer<typeof updateInvoiceSchema>;
+type UpdateInvoiceLineItemInput = z.infer<typeof updateInvoiceLineItemSchema>;
+type UpdateCreditNoteInput = z.infer<typeof updateCreditNoteSchema>;
+type InvoiceRecord = typeof invoices.$inferSelect;
+type PaymentRecord = typeof payments.$inferSelect;
+type CreditNoteRecord = typeof creditNotes.$inferSelect;
+type InvoiceLineItemRecord = typeof invoiceLineItems.$inferSelect;
+type CreditNoteLineItemRecord = typeof creditNoteLineItems.$inferSelect;
+type RecordPaymentLedgerInput = {
+    invoice: InvoiceRecord;
+    payment: PaymentRecord;
+};
+type InvoiceIssuedLedgerInput = {
+    invoice: InvoiceRecord;
+};
+type InvoiceUpdateLedgerInput = {
+    invoice: InvoiceRecord;
+    changes: UpdateInvoiceInput;
+};
+type InvoiceDeleteLedgerInput = {
+    invoice: InvoiceRecord;
+};
+type InvoiceLineItemMutationLedgerInput = {
+    invoice: InvoiceRecord;
+    lineItem: InvoiceLineItemRecord;
+    changes?: UpdateInvoiceLineItemInput;
+};
+type CreateCreditNoteLedgerInput = {
+    invoice: InvoiceRecord;
+    creditNote: CreditNoteRecord;
+};
+type CreditNoteUpdateLedgerInput = {
+    invoice: InvoiceRecord;
+    creditNote: CreditNoteRecord;
+    changes: UpdateCreditNoteInput;
+};
+type CreditNoteLineItemCreateLedgerInput = {
+    invoice: InvoiceRecord;
+    creditNote: CreditNoteRecord;
+    lineItem: CreditNoteLineItemRecord;
+};
+export declare function buildRecordPaymentActionLedgerInput(context: ActionLedgerRequestContextValues, input: RecordPaymentLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildInvoiceIssuedActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceIssuedLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildInvoiceUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceUpdateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildInvoiceDeleteActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceDeleteLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildInvoiceLineItemCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceLineItemMutationLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildInvoiceLineItemUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceLineItemMutationLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildInvoiceLineItemDeleteActionLedgerInput(context: ActionLedgerRequestContextValues, input: InvoiceLineItemMutationLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildCreditNoteCreationActionLedgerInput(context: ActionLedgerRequestContextValues, input: CreateCreditNoteLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildCreditNoteUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: CreditNoteUpdateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildCreditNoteLineItemCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: CreditNoteLineItemCreateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export {};
+//# sourceMappingURL=service-action-ledger-accounting.d.ts.map

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

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

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

@@ -0,0 +1,307 @@
+import { buildIdempotencyFingerprint, } from "@voyantjs/action-ledger";
+export async function buildRecordPaymentActionLedgerInput(context, input, options = {}) {
+    const target = getInvoiceLedgerTarget(input.invoice);
+    const idempotencyKey = input.payment.referenceNumber ??
+        input.payment.paymentCaptureId ??
+        input.payment.paymentAuthorizationId ??
+        null;
+    const idempotencyFingerprint = idempotencyKey
+        ? await buildIdempotencyFingerprint({
+            actionName: "finance.payment.record",
+            actionVersion: "v1",
+            targetType: target.type,
+            targetId: target.id,
+            commandInput: {
+                invoiceId: input.invoice.id,
+                paymentId: input.payment.id,
+                amountCents: input.payment.amountCents,
+                currency: input.payment.currency,
+                paymentMethod: input.payment.paymentMethod,
+                paymentDate: input.payment.paymentDate,
+                referenceNumber: input.payment.referenceNumber,
+                paymentAuthorizationId: input.payment.paymentAuthorizationId,
+                paymentCaptureId: input.payment.paymentCaptureId,
+            },
+        })
+        : null;
+    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: idempotencyKey ? `finance.invoice:${input.invoice.id}:payment` : null,
+        idempotencyKey,
+        idempotencyFingerprint,
+        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",
+        },
+    };
+}
+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 "@voyantjs/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,yBAAyB,CAAA;AAChC,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"}