@voyant-travel/finance 0.119.5

package/dist/service-action-ledger-payment-sessions.js

@@ -0,0 +1,294 @@
+import { buildIdempotencyFingerprint, } from "@voyant-travel/action-ledger";
+export function buildPaymentInstrumentCreateActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentInstrumentLedgerTarget(input.instrument);
+    const ownerRef = getPaymentInstrumentOwnerRef(input.instrument);
+    return {
+        context,
+        actionName: "finance.payment_instrument.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_instrument.create",
+        authorizationSource: options.authorizationSource ?? "finance.payment_instrument.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `${ownerRef}:payment_instrument`,
+            commandResultRef: `payment_instrument:${input.instrument.id}`,
+            summary: `Payment instrument ${input.instrument.id} created for ${ownerRef}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildPaymentInstrumentUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentInstrumentLedgerTarget(input.instrument);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.payment_instrument.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_instrument.update",
+        authorizationSource: options.authorizationSource ?? "finance.payment_instrument.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `payment_instrument:${input.instrument.id}:update`,
+            commandResultRef: `payment_instrument:${input.instrument.id}`,
+            summary: `Payment instrument ${input.instrument.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildPaymentInstrumentDeleteActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentInstrumentLedgerTarget(input.instrument);
+    return {
+        context,
+        actionName: "finance.payment_instrument.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_instrument.delete",
+        authorizationSource: options.authorizationSource ?? "finance.payment_instrument.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `payment_instrument:${input.instrument.id}:delete`,
+            commandResultRef: null,
+            summary: `Payment instrument ${input.instrument.id} deleted`,
+            reversalKind: "none",
+        },
+    };
+}
+function getPaymentInstrumentLedgerTarget(instrument) {
+    if (instrument.personId)
+        return { type: "person", id: instrument.personId };
+    if (instrument.organizationId)
+        return { type: "organization", id: instrument.organizationId };
+    if (instrument.supplierId)
+        return { type: "supplier", id: instrument.supplierId };
+    if (instrument.channelId)
+        return { type: "channel", id: instrument.channelId };
+    return { type: "payment_instrument", id: instrument.id };
+}
+function getPaymentInstrumentOwnerRef(instrument) {
+    const target = getPaymentInstrumentLedgerTarget(instrument);
+    return `${target.type}:${target.id}`;
+}
+export async function buildPaymentSessionCreateActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentSessionLedgerTarget(input.session);
+    const idempotencyKey = input.session.idempotencyKey;
+    return {
+        context,
+        actionName: "finance.payment_session.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_session.create",
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+        idempotencyScope: idempotencyKey && target.id
+            ? `finance.payment_session:${target.type}:${target.id}:create`
+            : null,
+        idempotencyKey,
+        idempotencyFingerprint: idempotencyKey && target.id
+            ? await buildIdempotencyFingerprint({
+                actionName: "finance.payment_session.create",
+                actionVersion: "v1",
+                targetType: target.type,
+                targetId: target.id,
+                commandInput: {
+                    paymentSessionId: input.session.id,
+                    targetType: input.session.targetType,
+                    targetId: input.session.targetId,
+                    amountCents: input.session.amountCents,
+                    currency: input.session.currency,
+                    provider: input.session.provider,
+                    idempotencyKey: input.session.idempotencyKey,
+                },
+            })
+            : null,
+        mutationDetail: {
+            commandInputRef: target.id
+                ? `${target.type}:${target.id}:payment_session`
+                : "payment_session:create",
+            commandResultRef: `payment_session:${input.session.id}`,
+            summary: `Payment session ${input.session.id} created for ${target.type} ${target.id ?? "unknown"}`,
+            reversalKind: "none",
+        },
+    };
+}
+export async function buildPaymentSessionCompletionActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentSessionCompletionLedgerTarget(input.session);
+    const idempotencyKey = input.session.providerPaymentId ??
+        input.session.externalReference ??
+        input.session.idempotencyKey ??
+        null;
+    const idempotencyFingerprint = idempotencyKey
+        ? await buildIdempotencyFingerprint({
+            actionName: "finance.payment_session.complete",
+            actionVersion: "v1",
+            targetType: target.type,
+            targetId: target.id,
+            commandInput: {
+                paymentSessionId: input.session.id,
+                status: input.status,
+                providerPaymentId: input.session.providerPaymentId,
+                externalReference: input.session.externalReference,
+                paymentId: input.paymentId,
+            },
+        })
+        : null;
+    return {
+        context,
+        actionName: "finance.payment_session.complete",
+        actionVersion: "v1",
+        actionKind: "execute",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_session.complete",
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+        idempotencyScope: idempotencyKey
+            ? `finance.payment_session:${input.session.id}:complete`
+            : null,
+        idempotencyKey,
+        idempotencyFingerprint,
+        mutationDetail: {
+            commandInputRef: `payment_session:${input.session.id}:complete`,
+            commandResultRef: input.paymentId ? `payment:${input.paymentId}` : null,
+            summary: `Payment session ${input.session.id} completed as ${input.status}`,
+            reversalKind: "none",
+        },
+    };
+}
+function getPaymentSessionCompletionLedgerTarget(session) {
+    return getPaymentSessionLedgerTarget(session);
+}
+function getPaymentSessionLedgerTarget(session) {
+    if (session.bookingId)
+        return { type: "booking", id: session.bookingId };
+    if (session.invoiceId)
+        return { type: "invoice", id: session.invoiceId };
+    if (session.orderId)
+        return { type: "order", id: session.orderId };
+    if (session.targetId && session.targetType !== "other") {
+        return { type: session.targetType, id: session.targetId };
+    }
+    return { type: "payment_session", id: session.id };
+}
+export function buildPaymentSessionUpdateActionLedgerInput(context, input, options = {}) {
+    const target = getPaymentSessionLedgerTarget(input.session);
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.payment_session.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: "finance.payment_session.update",
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `payment_session:${input.session.id}:update`,
+            commandResultRef: `payment_session:${input.session.id}`,
+            summary: `Payment session ${input.session.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildPaymentSessionRequiresRedirectActionLedgerInput(context, input, options = {}) {
+    return buildPaymentSessionStatusActionLedgerInput(context, {
+        session: input.session,
+        actionName: "finance.payment_session.requires_redirect",
+        actionKind: "update",
+        routeOrToolName: "finance.payment_session.requires_redirect",
+        commandInputRef: `payment_session:${input.session.id}:requires_redirect`,
+        commandResultRef: `payment_session:${input.session.id}`,
+        summary: `Payment session ${input.session.id} marked as requiring redirect`,
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+    });
+}
+export function buildPaymentSessionFailedActionLedgerInput(context, input, options = {}) {
+    return buildPaymentSessionStatusActionLedgerInput(context, {
+        session: input.session,
+        actionName: "finance.payment_session.fail",
+        actionKind: "update",
+        routeOrToolName: "finance.payment_session.fail",
+        commandInputRef: `payment_session:${input.session.id}:fail`,
+        commandResultRef: `payment_session:${input.session.id}`,
+        summary: `Payment session ${input.session.id} marked as failed`,
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+    });
+}
+export function buildPaymentSessionCancelledActionLedgerInput(context, input, options = {}) {
+    return buildPaymentSessionStatusActionLedgerInput(context, {
+        session: input.session,
+        actionName: "finance.payment_session.cancel",
+        actionKind: "update",
+        routeOrToolName: "finance.payment_session.cancel",
+        commandInputRef: `payment_session:${input.session.id}:cancel`,
+        commandResultRef: `payment_session:${input.session.id}`,
+        summary: `Payment session ${input.session.id} marked as cancelled`,
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+    });
+}
+export function buildPaymentSessionExpiredActionLedgerInput(context, input, options = {}) {
+    return buildPaymentSessionStatusActionLedgerInput(context, {
+        session: input.session,
+        actionName: "finance.payment_session.expire",
+        actionKind: "update",
+        routeOrToolName: "finance.payment_session.expire",
+        commandInputRef: `payment_session:${input.session.id}:expire`,
+        commandResultRef: `payment_session:${input.session.id}`,
+        summary: `Payment session ${input.session.id} marked as expired`,
+        authorizationSource: options.authorizationSource ?? "finance.payment_session.route",
+    });
+}
+function buildPaymentSessionStatusActionLedgerInput(context, input) {
+    const target = getPaymentSessionLedgerTarget(input.session);
+    return {
+        context,
+        actionName: input.actionName,
+        actionVersion: "v1",
+        actionKind: input.actionKind,
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: target.type,
+        targetId: target.id,
+        routeOrToolName: input.routeOrToolName,
+        authorizationSource: input.authorizationSource,
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: input.commandInputRef,
+            commandResultRef: input.commandResultRef,
+            summary: input.summary,
+            reversalKind: "none",
+        },
+    };
+}

package/dist/service-action-ledger-supplier-invoices.d.ts

@@ -0,0 +1,27 @@
+import { type ActionLedgerRequestContextValues, type BuildActionLedgerMutationInput } from "@voyant-travel/action-ledger";
+import type { supplierInvoices } from "./schema.js";
+type SupplierInvoiceRecord = typeof supplierInvoices.$inferSelect;
+export declare function buildSupplierInvoiceCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: {
+    invoice: SupplierInvoiceRecord;
+}, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildSupplierInvoiceUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: {
+    invoice: SupplierInvoiceRecord;
+    changes: Record<string, unknown>;
+}, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildSupplierInvoiceDeleteActionLedgerInput(context: ActionLedgerRequestContextValues, input: {
+    invoice: SupplierInvoiceRecord;
+}, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export declare function buildSupplierInvoiceAllocationsActionLedgerInput(context: ActionLedgerRequestContextValues, input: {
+    invoice: SupplierInvoiceRecord;
+    allocationCount: number;
+}, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export {};
+//# sourceMappingURL=service-action-ledger-supplier-invoices.d.ts.map

package/dist/service-action-ledger-supplier-invoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-action-ledger-supplier-invoices.d.ts","sourceRoot":"","sources":["../src/service-action-ledger-supplier-invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EAEpC,MAAM,8BAA8B,CAAA;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,KAAK,qBAAqB,GAAG,OAAO,gBAAgB,CAAC,YAAY,CAAA;AAIjE,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE;IAAE,OAAO,EAAE,qBAAqB,CAAA;CAAE,EACzC,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACpD,OAAO,CAAC,8BAA8B,CAAC,CAsCzC;AAED,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE;IAAE,OAAO,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAC3E,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACpD,8BAA8B,CAyBhC;AAED,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE;IAAE,OAAO,EAAE,qBAAqB,CAAA;CAAE,EACzC,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACpD,8BAA8B,CAsBhC;AAED,wBAAgB,gDAAgD,CAC9D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE;IAAE,OAAO,EAAE,qBAAqB,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAClE,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACpD,8BAA8B,CAsBhC"}

package/dist/service-action-ledger-supplier-invoices.js

@@ -0,0 +1,111 @@
+import { buildIdempotencyFingerprint, } from "@voyant-travel/action-ledger";
+const TARGET_TYPE = "supplier_invoice";
+export async function buildSupplierInvoiceCreateActionLedgerInput(context, input, options = {}) {
+    const idempotencyKey = `${input.invoice.supplierId}:${input.invoice.supplierInvoiceNo}`;
+    return {
+        context,
+        actionName: "finance.supplier_invoice.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: TARGET_TYPE,
+        targetId: input.invoice.id,
+        routeOrToolName: "finance.supplier_invoice.create",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_invoice.route",
+        idempotencyScope: `finance.supplier:${input.invoice.supplierId}:supplier_invoice`,
+        idempotencyKey,
+        idempotencyFingerprint: await buildIdempotencyFingerprint({
+            actionName: "finance.supplier_invoice.create",
+            actionVersion: "v1",
+            targetType: TARGET_TYPE,
+            targetId: input.invoice.id,
+            commandInput: {
+                supplierInvoiceId: input.invoice.id,
+                supplierId: input.invoice.supplierId,
+                supplierInvoiceNo: input.invoice.supplierInvoiceNo,
+                currency: input.invoice.currency,
+                totalCents: input.invoice.totalCents,
+                issueDate: input.invoice.issueDate,
+                status: input.invoice.status,
+            },
+        }),
+        mutationDetail: {
+            commandInputRef: `supplier:${input.invoice.supplierId}:supplier_invoice`,
+            commandResultRef: `supplier_invoice:${input.invoice.id}`,
+            summary: `Supplier invoice ${input.invoice.supplierInvoiceNo} recorded for supplier ${input.invoice.supplierId}`,
+            reversalKind: "domain_command",
+        },
+    };
+}
+export function buildSupplierInvoiceUpdateActionLedgerInput(context, input, options = {}) {
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    return {
+        context,
+        actionName: "finance.supplier_invoice.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: TARGET_TYPE,
+        targetId: input.invoice.id,
+        routeOrToolName: "finance.supplier_invoice.update",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_invoice.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `supplier_invoice:${input.invoice.id}:update`,
+            commandResultRef: `supplier_invoice:${input.invoice.id}`,
+            summary: `Supplier invoice ${input.invoice.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildSupplierInvoiceDeleteActionLedgerInput(context, input, options = {}) {
+    return {
+        context,
+        actionName: "finance.supplier_invoice.delete",
+        actionVersion: "v1",
+        actionKind: "delete",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: TARGET_TYPE,
+        targetId: input.invoice.id,
+        routeOrToolName: "finance.supplier_invoice.delete",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_invoice.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `supplier_invoice:${input.invoice.id}:delete`,
+            commandResultRef: `supplier_invoice:${input.invoice.id}`,
+            summary: `Supplier invoice ${input.invoice.id} deleted`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildSupplierInvoiceAllocationsActionLedgerInput(context, input, options = {}) {
+    return {
+        context,
+        actionName: "finance.supplier_invoice.set_allocations",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType: TARGET_TYPE,
+        targetId: input.invoice.id,
+        routeOrToolName: "finance.supplier_invoice.set_allocations",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_invoice.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `supplier_invoice:${input.invoice.id}:allocations`,
+            commandResultRef: `supplier_invoice:${input.invoice.id}`,
+            summary: `Supplier invoice ${input.invoice.id} allocations set (${input.allocationCount})`,
+            reversalKind: "none",
+        },
+    };
+}

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

@@ -0,0 +1,21 @@
+import { type ActionLedgerRequestContextValues, type BuildActionLedgerMutationInput } from "@voyant-travel/action-ledger";
+import type { z } from "zod";
+import type { supplierPayments } from "./schema.js";
+import type { updateSupplierPaymentSchema } from "./validation.js";
+type UpdateSupplierPaymentInput = z.infer<typeof updateSupplierPaymentSchema>;
+type SupplierPaymentRecord = typeof supplierPayments.$inferSelect;
+type SupplierPaymentCreateLedgerInput = {
+    payment: SupplierPaymentRecord;
+};
+type SupplierPaymentUpdateLedgerInput = {
+    payment: SupplierPaymentRecord;
+    changes: UpdateSupplierPaymentInput;
+};
+export declare function buildSupplierPaymentCreateActionLedgerInput(context: ActionLedgerRequestContextValues, input: SupplierPaymentCreateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): Promise<BuildActionLedgerMutationInput>;
+export declare function buildSupplierPaymentUpdateActionLedgerInput(context: ActionLedgerRequestContextValues, input: SupplierPaymentUpdateLedgerInput, options?: {
+    authorizationSource?: string | null;
+}): BuildActionLedgerMutationInput;
+export {};
+//# sourceMappingURL=service-action-ledger-supplier-payments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-action-ledger-supplier-payments.d.ts","sourceRoot":"","sources":["../src/service-action-ledger-supplier-payments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EAEpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAElE,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC7E,KAAK,qBAAqB,GAAG,OAAO,gBAAgB,CAAC,YAAY,CAAA;AAEjE,KAAK,gCAAgC,GAAG;IACtC,OAAO,EAAE,qBAAqB,CAAA;CAC/B,CAAA;AACD,KAAK,gCAAgC,GAAG;IACtC,OAAO,EAAE,qBAAqB,CAAA;IAC9B,OAAO,EAAE,0BAA0B,CAAA;CACpC,CAAA;AAiCD,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,gCAAgC,EACvC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,OAAO,CAAC,8BAA8B,CAAC,CA4CzC;AAED,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,gCAAgC,EACvC,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACL,8BAA8B,CA0BhC"}

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

@@ -0,0 +1,97 @@
+import { buildIdempotencyFingerprint, } from "@voyant-travel/action-ledger";
+/**
+ * AP payments may settle a whole supplier invoice (no booking) or a
+ * booking-scoped supplier service. The ledger targets the booking when present,
+ * otherwise the supplier invoice (§5.4).
+ */
+function resolvePaymentTarget(payment) {
+    if (payment.bookingId) {
+        return {
+            targetType: "booking",
+            targetId: payment.bookingId,
+            scopeRef: `booking:${payment.bookingId}`,
+        };
+    }
+    if (payment.supplierInvoiceId) {
+        return {
+            targetType: "supplier_invoice",
+            targetId: payment.supplierInvoiceId,
+            scopeRef: `supplier_invoice:${payment.supplierInvoiceId}`,
+        };
+    }
+    return {
+        targetType: "supplier_payment",
+        targetId: payment.id,
+        scopeRef: `supplier_payment:${payment.id}`,
+    };
+}
+export async function buildSupplierPaymentCreateActionLedgerInput(context, input, options = {}) {
+    const idempotencyKey = input.payment.referenceNumber;
+    const { targetType, targetId, scopeRef } = resolvePaymentTarget(input.payment);
+    return {
+        context,
+        actionName: "finance.supplier_payment.create",
+        actionVersion: "v1",
+        actionKind: "create",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType,
+        targetId,
+        routeOrToolName: "finance.supplier_payment.create",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_payment.route",
+        idempotencyScope: idempotencyKey ? `finance.${scopeRef}:supplier_payment` : null,
+        idempotencyKey,
+        idempotencyFingerprint: idempotencyKey
+            ? await buildIdempotencyFingerprint({
+                actionName: "finance.supplier_payment.create",
+                actionVersion: "v1",
+                targetType,
+                targetId,
+                commandInput: {
+                    supplierPaymentId: input.payment.id,
+                    bookingId: input.payment.bookingId,
+                    supplierInvoiceId: input.payment.supplierInvoiceId,
+                    supplierId: input.payment.supplierId,
+                    amountCents: input.payment.amountCents,
+                    currency: input.payment.currency,
+                    paymentMethod: input.payment.paymentMethod,
+                    paymentDate: input.payment.paymentDate,
+                    referenceNumber: input.payment.referenceNumber,
+                    status: input.payment.status,
+                },
+            })
+            : null,
+        mutationDetail: {
+            commandInputRef: `${scopeRef}:supplier_payment`,
+            commandResultRef: `supplier_payment:${input.payment.id}`,
+            summary: `Supplier payment ${input.payment.id} recorded against ${scopeRef}`,
+            reversalKind: "none",
+        },
+    };
+}
+export function buildSupplierPaymentUpdateActionLedgerInput(context, input, options = {}) {
+    const changedFields = Object.keys(input.changes).sort();
+    const changeSummary = changedFields.length > 0 ? changedFields.join(", ") : "no fields";
+    const { targetType, targetId } = resolvePaymentTarget(input.payment);
+    return {
+        context,
+        actionName: "finance.supplier_payment.update",
+        actionVersion: "v1",
+        actionKind: "update",
+        status: "succeeded",
+        evaluatedRisk: "high",
+        targetType,
+        targetId,
+        routeOrToolName: "finance.supplier_payment.update",
+        authorizationSource: options.authorizationSource ?? "finance.supplier_payment.route",
+        idempotencyScope: null,
+        idempotencyKey: null,
+        idempotencyFingerprint: null,
+        mutationDetail: {
+            commandInputRef: `supplier_payment:${input.payment.id}:update`,
+            commandResultRef: `supplier_payment:${input.payment.id}`,
+            summary: `Supplier payment ${input.payment.id} updated (${changeSummary})`,
+            reversalKind: "none",
+        },
+    };
+}

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

@@ -0,0 +1,7 @@
+export * from "./service-action-ledger-accounting.js";
+export * from "./service-action-ledger-booking-payments.js";
+export * from "./service-action-ledger-bookings.js";
+export * from "./service-action-ledger-payment-authorizations.js";
+export * from "./service-action-ledger-payment-sessions.js";
+export * from "./service-action-ledger-supplier-payments.js";
+//# sourceMappingURL=service-action-ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-action-ledger.d.ts","sourceRoot":"","sources":["../src/service-action-ledger.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AACrD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,qCAAqC,CAAA;AACnD,cAAc,mDAAmD,CAAA;AACjE,cAAc,6CAA6C,CAAA;AAC3D,cAAc,8CAA8C,CAAA"}

package/dist/service-action-ledger.js

@@ -0,0 +1,6 @@
+export * from "./service-action-ledger-accounting.js";
+export * from "./service-action-ledger-booking-payments.js";
+export * from "./service-action-ledger-bookings.js";
+export * from "./service-action-ledger-payment-authorizations.js";
+export * from "./service-action-ledger-payment-sessions.js";
+export * from "./service-action-ledger-supplier-payments.js";

package/dist/service-aggregates.d.ts

@@ -0,0 +1,96 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { invoices } from "./schema.js";
+type InvoiceStatus = (typeof invoices.$inferSelect)["status"];
+type InvoiceType = Extract<(typeof invoices.$inferSelect)["invoiceType"], "invoice" | "proforma">;
+export interface FinanceAggregateOutstandingInvoice {
+    id: string;
+    invoiceNumber: string | null;
+    bookingId: string | null;
+    status: InvoiceStatus;
+    currency: string;
+    totalCents: number;
+    balanceDueCents: number;
+    issueDate: string | null;
+    dueDate: string | null;
+}
+export interface FinanceAggregates {
+    total: number;
+    countsByStatus: Array<{
+        status: InvoiceStatus;
+        count: number;
+    }>;
+    counts: {
+        invoices: {
+            issued: number;
+            paid: number;
+            void: number;
+            overdue: number;
+        };
+        proformas: {
+            issued: number;
+            converted: number;
+            void: number;
+        };
+        paymentSessions: {
+            pending: number;
+            paid: number;
+            failed: number;
+        };
+    };
+    totals: Array<{
+        currency: string;
+        invoiced: number;
+        collected: number;
+        outstanding: number;
+        refunded: number;
+    }>;
+    /** Issued total (total_cents) grouped by UTC yearMonth + currency. Void excluded. */
+    monthlyRevenue: Array<{
+        yearMonth: string;
+        currency: string;
+        totalCents: number;
+    }>;
+    /** Invoice count per UTC yearMonth, all statuses in range. */
+    monthlyInvoiceCounts: Array<{
+        yearMonth: string;
+        count: number;
+    }>;
+    /**
+     * Sum of `balance_due_cents` for invoices still expecting payment — issued /
+     * partially_paid / overdue — grouped by currency. Matches the "how much
+     * are we owed" dashboard card.
+     */
+    outstanding: Array<{
+        currency: string;
+        balanceDueCents: number;
+        count: number;
+    }>;
+    /**
+     * Same as outstanding but restricted to invoices whose `due_date` has
+     * passed (`due_date < today`). Counts remaining balance, not the original
+     * total, so partial payments reduce the number.
+     */
+    overdue: Array<{
+        currency: string;
+        balanceDueCents: number;
+        count: number;
+    }>;
+    /**
+     * Bounded top-N slice of outstanding invoices ordered by `due_date`
+     * (oldest first; nulls last) so the dashboard can render the
+     * "needs collection" list without a separate paginated request.
+     * Default 5, max 20 — caller bounds via `outstandingTopLimit`.
+     */
+    outstandingTopN: FinanceAggregateOutstandingInvoice[];
+}
+export declare function getFinanceAggregates(db: PostgresJsDatabase, options?: {
+    range?: "this_month" | "last_month" | "year_to_date" | "all_time" | "custom";
+    from?: string;
+    to?: string;
+    currency?: string[];
+    invoiceType?: InvoiceType[];
+    status?: InvoiceStatus[];
+    outstandingTopLimit?: number;
+}): Promise<FinanceAggregates>;
+export {};
+//# sourceMappingURL=service-aggregates.d.ts.map