Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/billing/src/sync-outbox.ts
T
2026-07-08 16:15:37 +02:00

129 lines
5.3 KiB
TypeScript

import { publishOutboxEvent, type OutboxPublishArgs, type OutboxPublisherTransaction } from "@hivegrid/db/outbox";
import type { PaymentGatewayPayment, PaymentGatewayPaymentStatus } from "./types.js";
export const LAGO_BILLING_SYNC_EVENT_TYPE = "billing.lago.sync";
export const MOLLIE_PAYMENT_SYNC_EVENT_TYPE = "billing.mollie.payment";
export type LagoBillingSyncAction = "customer.upsert" | "subscription.upsert" | "invoice.refresh" | "webhook.received";
export type MolliePaymentSyncAction = "payment.refresh" | "payment.paid" | "payment.failed" | "payment.expired" | "payment.refunded" | "payment.cancelled";
export type LagoBillingSyncPayload = {
provider: "lago";
action: LagoBillingSyncAction;
tenantId: string;
externalId: string;
receivedAt: string;
source: "api" | "webhook" | "pull";
};
export type LagoBillingSyncInput = Omit<LagoBillingSyncPayload, "provider" | "receivedAt"> & {
receivedAt?: Date;
};
export function buildLagoBillingSyncOutboxArgs(input: LagoBillingSyncInput): OutboxPublishArgs {
return {
tenantId: input.tenantId,
type: LAGO_BILLING_SYNC_EVENT_TYPE,
dispatchKey: buildLagoBillingSyncDispatchKey(input),
payload: {
provider: "lago",
action: input.action,
tenantId: input.tenantId,
externalId: input.externalId,
source: input.source,
receivedAt: (input.receivedAt ?? new Date()).toISOString(),
},
};
}
export async function publishLagoBillingSync(tx: OutboxPublisherTransaction, input: LagoBillingSyncInput) {
return await publishOutboxEvent(tx, buildLagoBillingSyncOutboxArgs(input));
}
export function buildLagoBillingSyncDispatchKey(input: Pick<LagoBillingSyncInput, "action" | "tenantId" | "externalId">): string {
return `lago:${input.action}:${input.tenantId}:${input.externalId}`.replace(/[^A-Za-z0-9._:-]/gu, "_").slice(0, 256);
}
export type MolliePaymentSyncPayload = {
provider: "mollie";
action: MolliePaymentSyncAction;
tenantId: string;
invoiceExternalId: string;
providerPaymentId: string;
paymentExternalId: string | null;
status: PaymentGatewayPaymentStatus;
amountCents: number | null;
amountRefundedCents: number | null;
amountRemainingCents: number | null;
receivedAt: string;
source: "api" | "webhook" | "pull";
};
export type MolliePaymentSyncInput = Omit<MolliePaymentSyncPayload, "provider" | "receivedAt" | "action"> & {
action?: MolliePaymentSyncAction;
receivedAt?: Date;
};
export function buildMolliePaymentSyncOutboxArgs(input: MolliePaymentSyncInput): OutboxPublishArgs {
const action = input.action ?? actionForMolliePaymentStatus(input.status);
return {
tenantId: input.tenantId,
type: MOLLIE_PAYMENT_SYNC_EVENT_TYPE,
dispatchKey: buildMolliePaymentSyncDispatchKey({ ...input, action }),
payload: {
provider: "mollie",
action,
tenantId: input.tenantId,
invoiceExternalId: input.invoiceExternalId,
providerPaymentId: input.providerPaymentId,
paymentExternalId: input.paymentExternalId,
status: input.status,
amountCents: input.amountCents,
amountRefundedCents: input.amountRefundedCents,
amountRemainingCents: input.amountRemainingCents,
source: input.source,
receivedAt: (input.receivedAt ?? new Date()).toISOString(),
},
};
}
export function buildMolliePaymentSyncOutboxArgsFromPayment(payment: PaymentGatewayPayment, options: { source: "api" | "webhook" | "pull"; receivedAt?: Date }): OutboxPublishArgs {
const tenantId = payment.metadata.tenantId;
const invoiceExternalId = payment.metadata.invoiceExternalId;
if (!tenantId || !invoiceExternalId) {
throw new Error("Mollie payment metadata must include tenantId and invoiceExternalId.");
}
return buildMolliePaymentSyncOutboxArgs({
tenantId,
invoiceExternalId,
providerPaymentId: payment.providerPaymentId,
paymentExternalId: payment.externalId ?? payment.metadata.paymentExternalId,
status: payment.status,
amountCents: payment.amountCents,
amountRefundedCents: payment.amountRefundedCents,
amountRemainingCents: payment.amountRemainingCents,
source: options.source,
receivedAt: options.receivedAt,
});
}
export async function publishMolliePaymentSync(tx: OutboxPublisherTransaction, input: MolliePaymentSyncInput) {
return await publishOutboxEvent(tx, buildMolliePaymentSyncOutboxArgs(input));
}
export function actionForMolliePaymentStatus(status: PaymentGatewayPaymentStatus): MolliePaymentSyncAction {
if (status === "paid" || status === "authorized") return "payment.paid";
if (status === "failed" || status === "charged_back") return "payment.failed";
if (status === "expired") return "payment.expired";
if (status === "refunded") return "payment.refunded";
if (status === "canceled") return "payment.cancelled";
return "payment.refresh";
}
export function buildMolliePaymentSyncDispatchKey(input: Pick<MolliePaymentSyncInput, "tenantId" | "providerPaymentId" | "status" | "amountRefundedCents"> & { action?: MolliePaymentSyncAction }): string {
const refundPart = typeof input.amountRefundedCents === "number" ? input.amountRefundedCents : "none";
return `mollie:${input.action ?? actionForMolliePaymentStatus(input.status)}:${input.tenantId}:${input.providerPaymentId}:${input.status}:${refundPart}`
.replace(/[^A-Za-z0-9._:-]/gu, "_")
.slice(0, 256);
}