@voyantjs/finance 0.52.2 → 0.52.3

package/dist/service.js

@@ -1,9 +1,12 @@
+import { appendActionLedgerMutation, } from "@voyantjs/action-ledger";
 import { bookingItems, bookings } from "@voyantjs/bookings/schema";
 import { renderStructuredTemplate } from "@voyantjs/utils/template-renderer";
 import { and, asc, desc, eq, gte, ilike, lte, ne, or, sql } from "drizzle-orm";
 import { bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, creditNoteLineItems, creditNotes, financeNotes, invoiceAttachments, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierPayments, taxClasses, taxPolicyProfiles, taxPolicyRules, taxRegimes, } from "./schema.js";
+import { buildBookingGuaranteeCreateActionLedgerInput, buildBookingGuaranteeDeleteActionLedgerInput, buildBookingGuaranteeUpdateActionLedgerInput, buildBookingPaymentScheduleCreateActionLedgerInput, buildBookingPaymentScheduleDeleteActionLedgerInput, buildBookingPaymentScheduleUpdateActionLedgerInput, buildCreditNoteCreationActionLedgerInput, buildCreditNoteLineItemCreateActionLedgerInput, buildCreditNoteUpdateActionLedgerInput, buildInvoiceDeleteActionLedgerInput, buildInvoiceLineItemCreateActionLedgerInput, buildInvoiceLineItemDeleteActionLedgerInput, buildInvoiceLineItemUpdateActionLedgerInput, buildInvoiceUpdateActionLedgerInput, buildPaymentAuthorizationCreateActionLedgerInput, buildPaymentAuthorizationDeleteActionLedgerInput, buildPaymentAuthorizationUpdateActionLedgerInput, buildPaymentCaptureCreateActionLedgerInput, buildPaymentCaptureDeleteActionLedgerInput, buildPaymentCaptureUpdateActionLedgerInput, buildPaymentInstrumentCreateActionLedgerInput, buildPaymentInstrumentDeleteActionLedgerInput, buildPaymentInstrumentUpdateActionLedgerInput, buildPaymentSessionCancelledActionLedgerInput, buildPaymentSessionCompletionActionLedgerInput, buildPaymentSessionCreateActionLedgerInput, buildPaymentSessionExpiredActionLedgerInput, buildPaymentSessionFailedActionLedgerInput, buildPaymentSessionRequiresRedirectActionLedgerInput, buildPaymentSessionUpdateActionLedgerInput, buildRecordPaymentActionLedgerInput, buildSupplierPaymentCreateActionLedgerInput, buildSupplierPaymentUpdateActionLedgerInput, } from "./service-action-ledger.js";
 import { getFinanceAggregates } from "./service-aggregates.js";
 import { vouchersService } from "./service-vouchers.js";
+export { buildBookingGuaranteeCreateActionLedgerInput, buildBookingGuaranteeDeleteActionLedgerInput, buildBookingGuaranteeUpdateActionLedgerInput, buildBookingPaymentScheduleCreateActionLedgerInput, buildBookingPaymentScheduleDeleteActionLedgerInput, buildBookingPaymentScheduleUpdateActionLedgerInput, buildCreditNoteCreationActionLedgerInput, buildCreditNoteLineItemCreateActionLedgerInput, buildCreditNoteUpdateActionLedgerInput, buildInvoiceDeleteActionLedgerInput, buildInvoiceIssuedActionLedgerInput, buildInvoiceLineItemCreateActionLedgerInput, buildInvoiceLineItemDeleteActionLedgerInput, buildInvoiceLineItemUpdateActionLedgerInput, buildInvoiceUpdateActionLedgerInput, buildPaymentAuthorizationCreateActionLedgerInput, buildPaymentAuthorizationDeleteActionLedgerInput, buildPaymentAuthorizationUpdateActionLedgerInput, buildPaymentCaptureCreateActionLedgerInput, buildPaymentCaptureDeleteActionLedgerInput, buildPaymentCaptureUpdateActionLedgerInput, buildPaymentInstrumentCreateActionLedgerInput, buildPaymentInstrumentDeleteActionLedgerInput, buildPaymentInstrumentUpdateActionLedgerInput, buildPaymentSessionCancelledActionLedgerInput, buildPaymentSessionCompletionActionLedgerInput, buildPaymentSessionCreateActionLedgerInput, buildPaymentSessionExpiredActionLedgerInput, buildPaymentSessionFailedActionLedgerInput, buildPaymentSessionRequiresRedirectActionLedgerInput, buildPaymentSessionUpdateActionLedgerInput, buildRecordPaymentActionLedgerInput, buildSupplierPaymentCreateActionLedgerInput, buildSupplierPaymentUpdateActionLedgerInput, } from "./service-action-ledger.js";
 export class PaymentValidationError extends Error {
     status = 400;
     code = "invalid_request";
@@ -253,19 +256,59 @@ export const financeService = {
             .limit(1);
         return row ?? null;
     },
-    async createPaymentInstrument(db, data) {
-        const [row] = await db.insert(paymentInstruments).values(data).returning();
+    async createPaymentInstrument(db, data, runtime = {}) {
+        const createInstrument = (writer) => writer.insert(paymentInstruments).values(data).returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const created = await createInstrument(tx);
+                if (created[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentInstrumentCreateActionLedgerInput(actionLedgerContext, { instrument: created[0] }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return created;
+            });
+            return row ?? null;
+        }
+        const [row] = await createInstrument(db);
         return row ?? null;
     },
-    async updatePaymentInstrument(db, id, data) {
-        const [row] = await db
+    async updatePaymentInstrument(db, id, data, runtime = {}) {
+        const updateInstrument = (writer) => writer
             .update(paymentInstruments)
             .set({ ...data, updatedAt: new Date() })
             .where(eq(paymentInstruments.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateInstrument(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentInstrumentUpdateActionLedgerInput(actionLedgerContext, { instrument: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateInstrument(db);
         return row ?? null;
     },
-    async deletePaymentInstrument(db, id) {
+    async deletePaymentInstrument(db, id, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(paymentInstruments)
+                    .where(eq(paymentInstruments.id, id))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(paymentInstruments).where(eq(paymentInstruments.id, id));
+                await appendActionLedgerMutation(tx, buildPaymentInstrumentDeleteActionLedgerInput(actionLedgerContext, { instrument: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
         const [row] = await db
             .delete(paymentInstruments)
             .where(eq(paymentInstruments.id, id))
@@ -320,7 +363,7 @@ export const financeService = {
         const [row] = await db.select().from(paymentSessions).where(eq(paymentSessions.id, id)).limit(1);
         return row ?? null;
     },
-    async createPaymentSession(db, data) {
+    async createPaymentSession(db, data, runtime = {}) {
         if (data.idempotencyKey) {
             const [existing] = await db
                 .select()
@@ -332,7 +375,7 @@ export const financeService = {
             }
         }
         const target = derivePaymentSessionTarget(data);
-        const [row] = await db
+        const createSession = (writer) => writer
             .insert(paymentSessions)
             .values({
             ...data,
@@ -348,11 +391,23 @@ export const financeService = {
             expiresAt: toTimestamp(data.expiresAt),
         })
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const created = await createSession(tx);
+                if (created[0]) {
+                    await appendActionLedgerMutation(tx, await buildPaymentSessionCreateActionLedgerInput(actionLedgerContext, { session: created[0] }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return created;
+            });
+            return row ?? null;
+        }
+        const [row] = await createSession(db);
         return row ?? null;
     },
-    async updatePaymentSession(db, id, data) {
+    async updatePaymentSession(db, id, data, runtime = {}) {
         const target = derivePaymentSessionTarget(data);
-        const [row] = await db
+        const updateSession = (writer) => writer
             .update(paymentSessions)
             .set({
             ...data,
@@ -372,10 +427,22 @@ export const financeService = {
         })
             .where(eq(paymentSessions.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateSession(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentSessionUpdateActionLedgerInput(actionLedgerContext, { session: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateSession(db);
         return row ?? null;
     },
-    async markPaymentSessionRequiresRedirect(db, id, data) {
-        const [row] = await db
+    async markPaymentSessionRequiresRedirect(db, id, data, runtime = {}) {
+        const markRequiresRedirect = (writer) => writer
             .update(paymentSessions)
             .set({
             status: "requires_redirect",
@@ -395,10 +462,22 @@ export const financeService = {
         })
             .where(eq(paymentSessions.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await markRequiresRedirect(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentSessionRequiresRedirectActionLedgerInput(actionLedgerContext, { session: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await markRequiresRedirect(db);
         return row ?? null;
     },
-    async failPaymentSession(db, id, data) {
-        const [row] = await db
+    async failPaymentSession(db, id, data, runtime = {}) {
+        const failSession = (writer) => writer
             .update(paymentSessions)
             .set({
             status: "failed",
@@ -415,10 +494,22 @@ export const financeService = {
         })
             .where(eq(paymentSessions.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await failSession(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentSessionFailedActionLedgerInput(actionLedgerContext, { session: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await failSession(db);
         return row ?? null;
     },
-    async cancelPaymentSession(db, id, data) {
-        const [row] = await db
+    async cancelPaymentSession(db, id, data, runtime = {}) {
+        const cancelSession = (writer) => writer
             .update(paymentSessions)
             .set({
             status: "cancelled",
@@ -430,10 +521,22 @@ export const financeService = {
         })
             .where(eq(paymentSessions.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await cancelSession(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentSessionCancelledActionLedgerInput(actionLedgerContext, { session: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await cancelSession(db);
         return row ?? null;
     },
-    async expirePaymentSession(db, id, data) {
-        const [row] = await db
+    async expirePaymentSession(db, id, data, runtime = {}) {
+        const expireSession = (writer) => writer
             .update(paymentSessions)
             .set({
             status: "expired",
@@ -445,6 +548,18 @@ export const financeService = {
         })
             .where(eq(paymentSessions.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await expireSession(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentSessionExpiredActionLedgerInput(actionLedgerContext, { session: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await expireSession(db);
         return row ?? null;
     },
     async completePaymentSession(db, id, data, runtime = {}) {
@@ -628,6 +743,15 @@ export const financeService = {
             })
                 .where(eq(paymentSessions.id, id))
                 .returning();
+            if (updated && runtime.actionLedgerContext) {
+                await appendActionLedgerMutation(tx, await buildPaymentSessionCompletionActionLedgerInput(runtime.actionLedgerContext, {
+                    session: updated,
+                    status: data.status,
+                    paymentId,
+                }, {
+                    authorizationSource: runtime.actionLedgerAuthorizationSource,
+                }));
+            }
             return {
                 updated: updated ?? null,
                 settlement: settlementForEmit,
@@ -692,8 +816,8 @@ export const financeService = {
             .limit(1);
         return row ?? null;
     },
-    async createPaymentAuthorization(db, data) {
-        const [row] = await db
+    async createPaymentAuthorization(db, data, runtime = {}) {
+        const createAuthorization = (writer) => writer
             .insert(paymentAuthorizations)
             .values({
             ...data,
@@ -702,10 +826,22 @@ export const financeService = {
             voidedAt: toTimestamp(data.voidedAt),
         })
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const created = await createAuthorization(tx);
+                if (created[0]) {
+                    await appendActionLedgerMutation(tx, await buildPaymentAuthorizationCreateActionLedgerInput(actionLedgerContext, { authorization: created[0] }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return created;
+            });
+            return row ?? null;
+        }
+        const [row] = await createAuthorization(db);
         return row ?? null;
     },
-    async updatePaymentAuthorization(db, id, data) {
-        const [row] = await db
+    async updatePaymentAuthorization(db, id, data, runtime = {}) {
+        const updateAuthorization = (writer) => writer
             .update(paymentAuthorizations)
             .set({
             ...data,
@@ -716,9 +852,37 @@ export const financeService = {
         })
             .where(eq(paymentAuthorizations.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateAuthorization(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentAuthorizationUpdateActionLedgerInput(actionLedgerContext, { authorization: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateAuthorization(db);
         return row ?? null;
     },
-    async deletePaymentAuthorization(db, id) {
+    async deletePaymentAuthorization(db, id, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(paymentAuthorizations)
+                    .where(eq(paymentAuthorizations.id, id))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(paymentAuthorizations).where(eq(paymentAuthorizations.id, id));
+                await appendActionLedgerMutation(tx, buildPaymentAuthorizationDeleteActionLedgerInput(actionLedgerContext, { authorization: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
         const [row] = await db
             .delete(paymentAuthorizations)
             .where(eq(paymentAuthorizations.id, id))
@@ -746,8 +910,8 @@ export const financeService = {
         const [row] = await db.select().from(paymentCaptures).where(eq(paymentCaptures.id, id)).limit(1);
         return row ?? null;
     },
-    async createPaymentCapture(db, data) {
-        const [row] = await db
+    async createPaymentCapture(db, data, runtime = {}) {
+        const createCapture = (writer) => writer
             .insert(paymentCaptures)
             .values({
             ...data,
@@ -755,10 +919,22 @@ export const financeService = {
             settledAt: toTimestamp(data.settledAt),
         })
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const created = await createCapture(tx);
+                if (created[0]) {
+                    await appendActionLedgerMutation(tx, await buildPaymentCaptureCreateActionLedgerInput(actionLedgerContext, { capture: created[0] }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return created;
+            });
+            return row ?? null;
+        }
+        const [row] = await createCapture(db);
         return row ?? null;
     },
-    async updatePaymentCapture(db, id, data) {
-        const [row] = await db
+    async updatePaymentCapture(db, id, data, runtime = {}) {
+        const updateCapture = (writer) => writer
             .update(paymentCaptures)
             .set({
             ...data,
@@ -768,9 +944,37 @@ export const financeService = {
         })
             .where(eq(paymentCaptures.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateCapture(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildPaymentCaptureUpdateActionLedgerInput(actionLedgerContext, { capture: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateCapture(db);
         return row ?? null;
     },
-    async deletePaymentCapture(db, id) {
+    async deletePaymentCapture(db, id, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(paymentCaptures)
+                    .where(eq(paymentCaptures.id, id))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(paymentCaptures).where(eq(paymentCaptures.id, id));
+                await appendActionLedgerMutation(tx, buildPaymentCaptureDeleteActionLedgerInput(actionLedgerContext, { capture: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
         const [row] = await db
             .delete(paymentCaptures)
             .where(eq(paymentCaptures.id, id))
@@ -784,20 +988,33 @@ export const financeService = {
             .where(eq(bookingPaymentSchedules.bookingId, bookingId))
             .orderBy(asc(bookingPaymentSchedules.dueDate), asc(bookingPaymentSchedules.createdAt));
     },
-    async createBookingPaymentSchedule(db, bookingId, data) {
-        const [booking] = await db
-            .select({ id: bookings.id })
-            .from(bookings)
-            .where(eq(bookings.id, bookingId))
-            .limit(1);
-        if (!booking) {
-            return null;
+    async createBookingPaymentSchedule(db, bookingId, data, runtime = {}) {
+        const createSchedule = async (writer) => {
+            const [booking] = await writer
+                .select({ id: bookings.id })
+                .from(bookings)
+                .where(eq(bookings.id, bookingId))
+                .limit(1);
+            if (!booking) {
+                return null;
+            }
+            const [row] = await writer
+                .insert(bookingPaymentSchedules)
+                .values({ ...data, bookingId })
+                .returning();
+            return row ?? null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const row = await createSchedule(tx);
+                if (row) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleCreateActionLedgerInput(actionLedgerContext, { schedule: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return row;
+            });
         }
-        const [row] = await db
-            .insert(bookingPaymentSchedules)
-            .values({ ...data, bookingId })
-            .returning();
-        return row ?? null;
+        return createSchedule(db);
     },
     /**
      * Persist a payment schedule that was already computed elsewhere
@@ -849,116 +1066,183 @@ export const financeService = {
         });
         return db.insert(bookingPaymentSchedules).values(rows).returning();
     },
-    async applyDefaultBookingPaymentPlan(db, bookingId, data) {
-        const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
-        if (!booking) {
-            return null;
-        }
-        const totalAmountCents = booking.sellAmountCents ?? 0;
-        if (totalAmountCents <= 0) {
-            return [];
-        }
-        const today = startOfUtcDay(new Date());
-        const depositDueDate = data.depositDueDate ? parseDateString(data.depositDueDate) : today;
-        const startDate = booking.startDate ? parseDateString(booking.startDate) : null;
-        const rawBalanceDueDate = startDate
-            ? new Date(startDate.getTime() - data.balanceDueDaysBeforeStart * 24 * 60 * 60 * 1000)
-            : today;
-        const balanceDueDate = rawBalanceDueDate < today ? today : rawBalanceDueDate;
-        let depositAmountCents = 0;
-        if (data.depositMode === "fixed_amount") {
-            depositAmountCents = Math.min(totalAmountCents, data.depositValue);
-        }
-        else if (data.depositMode === "percentage") {
-            depositAmountCents = Math.min(totalAmountCents, Math.round((totalAmountCents * data.depositValue) / 100));
-        }
-        if (data.clearExistingPending) {
-            await db
-                .delete(bookingPaymentSchedules)
-                .where(and(eq(bookingPaymentSchedules.bookingId, bookingId), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due"))));
-        }
-        const scheduleRows = [];
-        if (depositAmountCents > 0 && depositAmountCents < totalAmountCents) {
-            scheduleRows.push({
-                bookingItemId: null,
-                scheduleType: "deposit",
-                status: depositDueDate <= today ? "due" : "pending",
-                dueDate: toDateString(depositDueDate),
-                currency: booking.sellCurrency,
-                amountCents: depositAmountCents,
-                notes: data.notes ?? null,
-            });
-            scheduleRows.push({
-                bookingItemId: null,
-                scheduleType: "balance",
-                status: balanceDueDate <= today ? "due" : "pending",
-                dueDate: toDateString(balanceDueDate),
-                currency: booking.sellCurrency,
-                amountCents: Math.max(0, totalAmountCents - depositAmountCents),
-                notes: data.notes ?? null,
-            });
-        }
-        else {
-            const singleDueDate = balanceDueDate <= today ? today : balanceDueDate;
-            scheduleRows.push({
-                bookingItemId: null,
-                scheduleType: "balance",
-                status: singleDueDate <= today ? "due" : "pending",
-                dueDate: toDateString(singleDueDate),
-                currency: booking.sellCurrency,
-                amountCents: totalAmountCents,
-                notes: data.notes ?? null,
-            });
-        }
-        const createdSchedules = await db
-            .insert(bookingPaymentSchedules)
-            .values(scheduleRows.map((row) => ({
-            ...row,
-            bookingId,
-            bookingItemId: row.bookingItemId ?? null,
-            notes: row.notes ?? null,
-        })))
-            .returning();
-        if (data.createGuarantee) {
-            const depositSchedule = createdSchedules.find((schedule) => schedule.scheduleType === "deposit");
-            if (depositSchedule) {
-                await db.insert(bookingGuarantees).values({
-                    bookingId,
-                    bookingPaymentScheduleId: depositSchedule.id,
+    async applyDefaultBookingPaymentPlan(db, bookingId, data, runtime = {}) {
+        const applyPlan = async (writer) => {
+            const [booking] = await writer
+                .select()
+                .from(bookings)
+                .where(eq(bookings.id, bookingId))
+                .limit(1);
+            if (!booking) {
+                return null;
+            }
+            const totalAmountCents = booking.sellAmountCents ?? 0;
+            if (totalAmountCents <= 0) {
+                return {
+                    createdSchedules: [],
+                    deletedSchedules: [],
+                    createdGuarantee: null,
+                };
+            }
+            const today = startOfUtcDay(new Date());
+            const depositDueDate = data.depositDueDate ? parseDateString(data.depositDueDate) : today;
+            const startDate = booking.startDate ? parseDateString(booking.startDate) : null;
+            const rawBalanceDueDate = startDate
+                ? new Date(startDate.getTime() - data.balanceDueDaysBeforeStart * 24 * 60 * 60 * 1000)
+                : today;
+            const balanceDueDate = rawBalanceDueDate < today ? today : rawBalanceDueDate;
+            let depositAmountCents = 0;
+            if (data.depositMode === "fixed_amount") {
+                depositAmountCents = Math.min(totalAmountCents, data.depositValue);
+            }
+            else if (data.depositMode === "percentage") {
+                depositAmountCents = Math.min(totalAmountCents, Math.round((totalAmountCents * data.depositValue) / 100));
+            }
+            const clearableScheduleWhere = and(eq(bookingPaymentSchedules.bookingId, bookingId), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due")));
+            const deletedSchedules = data.clearExistingPending
+                ? await writer.select().from(bookingPaymentSchedules).where(clearableScheduleWhere)
+                : [];
+            if (data.clearExistingPending) {
+                await writer.delete(bookingPaymentSchedules).where(clearableScheduleWhere);
+            }
+            const scheduleRows = [];
+            if (depositAmountCents > 0 && depositAmountCents < totalAmountCents) {
+                scheduleRows.push({
+                    bookingItemId: null,
+                    scheduleType: "deposit",
+                    status: depositDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(depositDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: depositAmountCents,
+                    notes: data.notes ?? null,
+                });
+                scheduleRows.push({
                     bookingItemId: null,
-                    guaranteeType: data.guaranteeType,
-                    status: "pending",
-                    paymentInstrumentId: null,
-                    paymentAuthorizationId: null,
-                    currency: depositSchedule.currency,
-                    amountCents: depositSchedule.amountCents,
-                    provider: null,
-                    referenceNumber: null,
-                    guaranteedAt: null,
-                    expiresAt: null,
-                    releasedAt: null,
+                    scheduleType: "balance",
+                    status: balanceDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(balanceDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: Math.max(0, totalAmountCents - depositAmountCents),
                     notes: data.notes ?? null,
                 });
             }
+            else {
+                const singleDueDate = balanceDueDate <= today ? today : balanceDueDate;
+                scheduleRows.push({
+                    bookingItemId: null,
+                    scheduleType: "balance",
+                    status: singleDueDate <= today ? "due" : "pending",
+                    dueDate: toDateString(singleDueDate),
+                    currency: booking.sellCurrency,
+                    amountCents: totalAmountCents,
+                    notes: data.notes ?? null,
+                });
+            }
+            const createdSchedules = await writer
+                .insert(bookingPaymentSchedules)
+                .values(scheduleRows.map((row) => ({
+                ...row,
+                bookingId,
+                bookingItemId: row.bookingItemId ?? null,
+                notes: row.notes ?? null,
+            })))
+                .returning();
+            let createdGuarantee = null;
+            if (data.createGuarantee) {
+                const depositSchedule = createdSchedules.find((schedule) => schedule.scheduleType === "deposit");
+                if (depositSchedule) {
+                    const [guarantee] = await writer
+                        .insert(bookingGuarantees)
+                        .values({
+                        bookingId,
+                        bookingPaymentScheduleId: depositSchedule.id,
+                        bookingItemId: null,
+                        guaranteeType: data.guaranteeType,
+                        status: "pending",
+                        paymentInstrumentId: null,
+                        paymentAuthorizationId: null,
+                        currency: depositSchedule.currency,
+                        amountCents: depositSchedule.amountCents,
+                        provider: null,
+                        referenceNumber: null,
+                        guaranteedAt: null,
+                        expiresAt: null,
+                        releasedAt: null,
+                        notes: data.notes ?? null,
+                    })
+                        .returning();
+                    createdGuarantee = guarantee ?? null;
+                }
+            }
+            return { createdSchedules, deletedSchedules, createdGuarantee };
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const applied = await applyPlan(tx);
+                if (!applied) {
+                    return null;
+                }
+                for (const schedule of applied.deletedSchedules) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleDeleteActionLedgerInput(actionLedgerContext, { schedule }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                for (const schedule of applied.createdSchedules) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleCreateActionLedgerInput(actionLedgerContext, { schedule }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                if (applied.createdGuarantee) {
+                    await appendActionLedgerMutation(tx, await buildBookingGuaranteeCreateActionLedgerInput(actionLedgerContext, { guarantee: applied.createdGuarantee }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return applied.createdSchedules;
+            });
+            return result;
         }
-        return createdSchedules;
+        const result = await applyPlan(db);
+        return result?.createdSchedules ?? null;
     },
-    async updateBookingPaymentSchedule(db, scheduleId, data) {
-        const [row] = await db
+    async updateBookingPaymentSchedule(db, scheduleId, data, runtime = {}) {
+        const updateSchedule = (writer) => writer
             .update(bookingPaymentSchedules)
             .set({ ...data, updatedAt: new Date() })
             .where(eq(bookingPaymentSchedules.id, scheduleId))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateSchedule(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildBookingPaymentScheduleUpdateActionLedgerInput(actionLedgerContext, { schedule: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateSchedule(db);
         return row ?? null;
     },
-    async deleteBookingPaymentSchedule(db, scheduleId) {
+    async deleteBookingPaymentSchedule(db, scheduleId, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(bookingPaymentSchedules)
+                    .where(eq(bookingPaymentSchedules.id, scheduleId))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(bookingPaymentSchedules).where(eq(bookingPaymentSchedules.id, scheduleId));
+                await appendActionLedgerMutation(tx, buildBookingPaymentScheduleDeleteActionLedgerInput(actionLedgerContext, { schedule: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
         const [row] = await db
             .delete(bookingPaymentSchedules)
             .where(eq(bookingPaymentSchedules.id, scheduleId))
             .returning({ id: bookingPaymentSchedules.id });
         return row ?? null;
     },
-    async createPaymentSessionFromBookingSchedule(db, scheduleId, data) {
+    async createPaymentSessionFromBookingSchedule(db, scheduleId, data, runtime = {}) {
         const [schedule] = await db
             .select()
             .from(bookingPaymentSchedules)
@@ -999,9 +1283,9 @@ export const financeService = {
                 scheduleType: schedule.scheduleType,
                 dueDate: schedule.dueDate,
             },
-        });
+        }, runtime);
     },
-    async createPaymentSessionFromInvoice(db, invoiceId, data) {
+    async createPaymentSessionFromInvoice(db, invoiceId, data, runtime = {}) {
         const [invoice] = await db.select().from(invoices).where(eq(invoices.id, invoiceId)).limit(1);
         if (!invoice) {
             return null;
@@ -1040,7 +1324,7 @@ export const financeService = {
                 invoiceType: invoice.invoiceType,
                 dueDate: invoice.dueDate,
             },
-        });
+        }, runtime);
     },
     listBookingGuarantees(db, bookingId) {
         return db
@@ -1049,38 +1333,51 @@ export const financeService = {
             .where(eq(bookingGuarantees.bookingId, bookingId))
             .orderBy(desc(bookingGuarantees.createdAt));
     },
-    async createBookingGuarantee(db, bookingId, data) {
-        const [booking] = await db
-            .select({ id: bookings.id })
-            .from(bookings)
-            .where(eq(bookings.id, bookingId))
-            .limit(1);
-        if (!booking) {
-            return null;
+    async createBookingGuarantee(db, bookingId, data, runtime = {}) {
+        const createGuarantee = async (writer) => {
+            const [booking] = await writer
+                .select({ id: bookings.id })
+                .from(bookings)
+                .where(eq(bookings.id, bookingId))
+                .limit(1);
+            if (!booking) {
+                return null;
+            }
+            const [row] = await writer
+                .insert(bookingGuarantees)
+                .values({
+                bookingId,
+                bookingPaymentScheduleId: data.bookingPaymentScheduleId ?? null,
+                bookingItemId: data.bookingItemId ?? null,
+                guaranteeType: data.guaranteeType,
+                status: data.status,
+                paymentInstrumentId: data.paymentInstrumentId ?? null,
+                paymentAuthorizationId: data.paymentAuthorizationId ?? null,
+                currency: data.currency ?? null,
+                amountCents: data.amountCents ?? null,
+                provider: data.provider ?? null,
+                referenceNumber: data.referenceNumber ?? null,
+                guaranteedAt: toTimestamp(data.guaranteedAt),
+                expiresAt: toTimestamp(data.expiresAt),
+                releasedAt: toTimestamp(data.releasedAt),
+                notes: data.notes ?? null,
+            })
+                .returning();
+            return row ?? null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const row = await createGuarantee(tx);
+                if (row) {
+                    await appendActionLedgerMutation(tx, await buildBookingGuaranteeCreateActionLedgerInput(actionLedgerContext, { guarantee: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return row;
+            });
         }
-        const [row] = await db
-            .insert(bookingGuarantees)
-            .values({
-            bookingId,
-            bookingPaymentScheduleId: data.bookingPaymentScheduleId ?? null,
-            bookingItemId: data.bookingItemId ?? null,
-            guaranteeType: data.guaranteeType,
-            status: data.status,
-            paymentInstrumentId: data.paymentInstrumentId ?? null,
-            paymentAuthorizationId: data.paymentAuthorizationId ?? null,
-            currency: data.currency ?? null,
-            amountCents: data.amountCents ?? null,
-            provider: data.provider ?? null,
-            referenceNumber: data.referenceNumber ?? null,
-            guaranteedAt: toTimestamp(data.guaranteedAt),
-            expiresAt: toTimestamp(data.expiresAt),
-            releasedAt: toTimestamp(data.releasedAt),
-            notes: data.notes ?? null,
-        })
-            .returning();
-        return row ?? null;
+        return createGuarantee(db);
     },
-    async createPaymentSessionFromBookingGuarantee(db, guaranteeId, data) {
+    async createPaymentSessionFromBookingGuarantee(db, guaranteeId, data, runtime = {}) {
         const [guarantee] = await db
             .select()
             .from(bookingGuarantees)
@@ -1127,10 +1424,10 @@ export const financeService = {
             metadata: data.metadata ?? {
                 guaranteeType: guarantee.guaranteeType,
             },
-        });
+        }, runtime);
     },
-    async updateBookingGuarantee(db, guaranteeId, data) {
-        const [row] = await db
+    async updateBookingGuarantee(db, guaranteeId, data, runtime = {}) {
+        const updateGuarantee = (writer) => writer
             .update(bookingGuarantees)
             .set({
             ...data,
@@ -1141,9 +1438,37 @@ export const financeService = {
         })
             .where(eq(bookingGuarantees.id, guaranteeId))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updateGuarantee(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildBookingGuaranteeUpdateActionLedgerInput(actionLedgerContext, { guarantee: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updateGuarantee(db);
         return row ?? null;
     },
-    async deleteBookingGuarantee(db, guaranteeId) {
+    async deleteBookingGuarantee(db, guaranteeId, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx
+                    .select()
+                    .from(bookingGuarantees)
+                    .where(eq(bookingGuarantees.id, guaranteeId))
+                    .limit(1);
+                if (!existing) {
+                    return null;
+                }
+                await tx.delete(bookingGuarantees).where(eq(bookingGuarantees.id, guaranteeId));
+                await appendActionLedgerMutation(tx, buildBookingGuaranteeDeleteActionLedgerInput(actionLedgerContext, { guarantee: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { id: existing.id };
+            });
+        }
         const [row] = await db
             .delete(bookingGuarantees)
             .where(eq(bookingGuarantees.id, guaranteeId))
@@ -1329,19 +1654,43 @@ export const financeService = {
             offset: query.offset,
         };
     },
-    async createSupplierPayment(db, data) {
-        const [row] = await db
+    async createSupplierPayment(db, data, runtime = {}) {
+        const createPayment = (writer) => writer
             .insert(supplierPayments)
             .values({ ...data, paymentInstrumentId: data.paymentInstrumentId ?? null })
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const created = await createPayment(tx);
+                if (created[0]) {
+                    await appendActionLedgerMutation(tx, await buildSupplierPaymentCreateActionLedgerInput(actionLedgerContext, { payment: created[0] }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return created;
+            });
+            return row;
+        }
+        const [row] = await createPayment(db);
         return row;
     },
-    async updateSupplierPayment(db, id, data) {
-        const [row] = await db
+    async updateSupplierPayment(db, id, data, runtime = {}) {
+        const updatePayment = (writer) => writer
             .update(supplierPayments)
             .set({ ...data, updatedAt: new Date() })
             .where(eq(supplierPayments.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const [row] = await db.transaction(async (tx) => {
+                const updated = await updatePayment(tx);
+                if (updated[0]) {
+                    await appendActionLedgerMutation(tx, buildSupplierPaymentUpdateActionLedgerInput(actionLedgerContext, { payment: updated[0], changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return row ?? null;
+        }
+        const [row] = await updatePayment(db);
         return row ?? null;
     },
     async listInvoices(db, query) {
@@ -1522,15 +1871,41 @@ export const financeService = {
         const [row] = await db.select().from(invoices).where(eq(invoices.id, id)).limit(1);
         return row ?? null;
     },
-    async updateInvoice(db, id, data) {
-        const [row] = await db
+    async updateInvoice(db, id, data, runtime = {}) {
+        const updateInvoiceRow = (writer) => writer
             .update(invoices)
             .set({ ...data, updatedAt: new Date() })
             .where(eq(invoices.id, id))
             .returning();
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [row] = await updateInvoiceRow(tx);
+                if (row) {
+                    await appendActionLedgerMutation(tx, buildInvoiceUpdateActionLedgerInput(actionLedgerContext, { invoice: row, changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return row ?? null;
+            });
+        }
+        const [row] = await updateInvoiceRow(db);
         return row ?? null;
     },
-    async deleteInvoice(db, id) {
+    async deleteInvoice(db, id, runtime = {}) {
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            return db.transaction(async (tx) => {
+                const [existing] = await tx.select().from(invoices).where(eq(invoices.id, id)).limit(1);
+                if (!existing) {
+                    return { status: "not_found" };
+                }
+                if (existing.status !== "draft") {
+                    return { status: "not_draft" };
+                }
+                await tx.delete(invoices).where(eq(invoices.id, id));
+                await appendActionLedgerMutation(tx, buildInvoiceDeleteActionLedgerInput(actionLedgerContext, { invoice: existing }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                return { status: "deleted" };
+            });
+        }
         const [existing] = await db
             .select({ id: invoices.id, status: invoices.status })
             .from(invoices)
@@ -1552,35 +1927,97 @@ export const financeService = {
             .where(eq(invoiceLineItems.invoiceId, invoiceId))
             .orderBy(asc(invoiceLineItems.sortOrder));
     },
-    async createInvoiceLineItem(db, invoiceId, data) {
-        const [invoice] = await db
-            .select({ id: invoices.id })
-            .from(invoices)
-            .where(eq(invoices.id, invoiceId))
-            .limit(1);
-        if (!invoice) {
-            return null;
+    async createInvoiceLineItem(db, invoiceId, data, runtime = {}) {
+        const createLineItem = async (writer) => {
+            const [invoice] = await writer
+                .select()
+                .from(invoices)
+                .where(eq(invoices.id, invoiceId))
+                .limit(1);
+            if (!invoice) {
+                return null;
+            }
+            const [row] = await writer
+                .insert(invoiceLineItems)
+                .values({ ...data, invoiceId })
+                .returning();
+            return row ? { invoice, lineItem: row } : null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const created = await createLineItem(tx);
+                if (created) {
+                    await appendActionLedgerMutation(tx, buildInvoiceLineItemCreateActionLedgerInput(actionLedgerContext, created, {
+                        authorizationSource: runtime.actionLedgerAuthorizationSource,
+                    }));
+                }
+                return created;
+            });
+            return result?.lineItem ?? null;
         }
-        const [row] = await db
-            .insert(invoiceLineItems)
-            .values({ ...data, invoiceId })
-            .returning();
-        return row;
+        return (await createLineItem(db))?.lineItem ?? null;
     },
-    async updateInvoiceLineItem(db, lineId, data) {
-        const [row] = await db
-            .update(invoiceLineItems)
-            .set(data)
-            .where(eq(invoiceLineItems.id, lineId))
-            .returning();
-        return row ?? null;
+    async updateInvoiceLineItem(db, lineId, data, runtime = {}) {
+        const updateLineItem = async (writer) => {
+            const [row] = await writer
+                .update(invoiceLineItems)
+                .set(data)
+                .where(eq(invoiceLineItems.id, lineId))
+                .returning();
+            if (!row) {
+                return null;
+            }
+            const [invoice] = await writer
+                .select()
+                .from(invoices)
+                .where(eq(invoices.id, row.invoiceId))
+                .limit(1);
+            return invoice ? { invoice, lineItem: row } : null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const updated = await updateLineItem(tx);
+                if (updated) {
+                    await appendActionLedgerMutation(tx, buildInvoiceLineItemUpdateActionLedgerInput(actionLedgerContext, { ...updated, changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return result?.lineItem ?? null;
+        }
+        return (await updateLineItem(db))?.lineItem ?? null;
     },
-    async deleteInvoiceLineItem(db, lineId) {
-        const [row] = await db
-            .delete(invoiceLineItems)
-            .where(eq(invoiceLineItems.id, lineId))
-            .returning({ id: invoiceLineItems.id });
-        return row ?? null;
+    async deleteInvoiceLineItem(db, lineId, runtime = {}) {
+        const deleteLineItem = async (writer) => {
+            const [row] = await writer
+                .delete(invoiceLineItems)
+                .where(eq(invoiceLineItems.id, lineId))
+                .returning();
+            if (!row) {
+                return null;
+            }
+            const [invoice] = await writer
+                .select()
+                .from(invoices)
+                .where(eq(invoices.id, row.invoiceId))
+                .limit(1);
+            return invoice ? { invoice, lineItem: row } : null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const deleted = await deleteLineItem(tx);
+                if (deleted) {
+                    await appendActionLedgerMutation(tx, buildInvoiceLineItemDeleteActionLedgerInput(actionLedgerContext, deleted, {
+                        authorizationSource: runtime.actionLedgerAuthorizationSource,
+                    }));
+                }
+                return deleted;
+            });
+            return result?.lineItem ?? null;
+        }
+        return (await deleteLineItem(db))?.lineItem ?? null;
     },
     listPayments(db, invoiceId) {
         return db
@@ -1815,7 +2252,7 @@ export const financeService = {
         const row = toRows(result)[0];
         return row ? mapRawPayment(row) : null;
     },
-    async createPayment(db, invoiceId, data) {
+    async createPayment(db, invoiceId, data, runtime = {}) {
         const [invoice] = await db.select().from(invoices).where(eq(invoices.id, invoiceId)).limit(1);
         if (!invoice) {
             return null;
@@ -1849,6 +2286,14 @@ export const financeService = {
                 .update(invoices)
                 .set({ paidCents, balanceDueCents, status: newStatus, updatedAt: new Date() })
                 .where(eq(invoices.id, invoiceId));
+            if (payment && runtime.actionLedgerContext) {
+                await appendActionLedgerMutation(tx, await buildRecordPaymentActionLedgerInput(runtime.actionLedgerContext, {
+                    invoice,
+                    payment,
+                }, {
+                    authorizationSource: runtime.actionLedgerAuthorizationSource,
+                }));
+            }
             return payment;
         });
     },
@@ -1859,28 +2304,56 @@ export const financeService = {
             .where(eq(creditNotes.invoiceId, invoiceId))
             .orderBy(desc(creditNotes.createdAt));
     },
-    async createCreditNote(db, invoiceId, data) {
-        const [invoice] = await db
-            .select({ id: invoices.id })
-            .from(invoices)
-            .where(eq(invoices.id, invoiceId))
-            .limit(1);
+    async createCreditNote(db, invoiceId, data, runtime = {}) {
+        const [invoice] = await db.select().from(invoices).where(eq(invoices.id, invoiceId)).limit(1);
         if (!invoice) {
             return null;
         }
-        const [row] = await db
-            .insert(creditNotes)
-            .values({ ...data, invoiceId })
-            .returning();
-        return row;
+        return db.transaction(async (tx) => {
+            const [row] = await tx
+                .insert(creditNotes)
+                .values({ ...data, invoiceId })
+                .returning();
+            if (row && runtime.actionLedgerContext) {
+                await appendActionLedgerMutation(tx, await buildCreditNoteCreationActionLedgerInput(runtime.actionLedgerContext, {
+                    invoice,
+                    creditNote: row,
+                }, {
+                    authorizationSource: runtime.actionLedgerAuthorizationSource,
+                }));
+            }
+            return row;
+        });
     },
-    async updateCreditNote(db, creditNoteId, data) {
-        const [row] = await db
-            .update(creditNotes)
-            .set({ ...data, updatedAt: new Date() })
-            .where(eq(creditNotes.id, creditNoteId))
-            .returning();
-        return row ?? null;
+    async updateCreditNote(db, creditNoteId, data, runtime = {}) {
+        const updateCreditNoteRow = async (writer) => {
+            const [row] = await writer
+                .update(creditNotes)
+                .set({ ...data, updatedAt: new Date() })
+                .where(eq(creditNotes.id, creditNoteId))
+                .returning();
+            if (!row) {
+                return null;
+            }
+            const [invoice] = await writer
+                .select()
+                .from(invoices)
+                .where(eq(invoices.id, row.invoiceId))
+                .limit(1);
+            return invoice ? { invoice, creditNote: row } : null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const updated = await updateCreditNoteRow(tx);
+                if (updated) {
+                    await appendActionLedgerMutation(tx, buildCreditNoteUpdateActionLedgerInput(actionLedgerContext, { ...updated, changes: data }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+                }
+                return updated;
+            });
+            return result?.creditNote ?? null;
+        }
+        return (await updateCreditNoteRow(db))?.creditNote ?? null;
     },
     listCreditNoteLineItems(db, creditNoteId) {
         return db
@@ -1889,20 +2362,44 @@ export const financeService = {
             .where(eq(creditNoteLineItems.creditNoteId, creditNoteId))
             .orderBy(asc(creditNoteLineItems.sortOrder));
     },
-    async createCreditNoteLineItem(db, creditNoteId, data) {
-        const [creditNote] = await db
-            .select({ id: creditNotes.id })
-            .from(creditNotes)
-            .where(eq(creditNotes.id, creditNoteId))
-            .limit(1);
-        if (!creditNote) {
-            return null;
+    async createCreditNoteLineItem(db, creditNoteId, data, runtime = {}) {
+        const createLineItem = async (writer) => {
+            const [creditNote] = await writer
+                .select()
+                .from(creditNotes)
+                .where(eq(creditNotes.id, creditNoteId))
+                .limit(1);
+            if (!creditNote) {
+                return null;
+            }
+            const [invoice] = await writer
+                .select()
+                .from(invoices)
+                .where(eq(invoices.id, creditNote.invoiceId))
+                .limit(1);
+            if (!invoice) {
+                return null;
+            }
+            const [row] = await writer
+                .insert(creditNoteLineItems)
+                .values({ ...data, creditNoteId })
+                .returning();
+            return row ? { invoice, creditNote, lineItem: row } : null;
+        };
+        const actionLedgerContext = runtime.actionLedgerContext;
+        if (actionLedgerContext) {
+            const result = await db.transaction(async (tx) => {
+                const created = await createLineItem(tx);
+                if (created) {
+                    await appendActionLedgerMutation(tx, buildCreditNoteLineItemCreateActionLedgerInput(actionLedgerContext, created, {
+                        authorizationSource: runtime.actionLedgerAuthorizationSource,
+                    }));
+                }
+                return created;
+            });
+            return result?.lineItem ?? null;
         }
-        const [row] = await db
-            .insert(creditNoteLineItems)
-            .values({ ...data, creditNoteId })
-            .returning();
-        return row;
+        return (await createLineItem(db))?.lineItem ?? null;
     },
     listNotes(db, invoiceId) {
         return db