Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
+346
@@ -0,0 +1,346 @@
|
||||
import { createLagoBillingGateway, createMolliePaymentGateway, type BillingGateway, type PaymentGateway } from "@hivegrid/billing";
|
||||
import { loadWebConfig } from "@hivegrid/config";
|
||||
import { resolveTenantBillingState } from "@hivegrid/db/billing-domain.server";
|
||||
import { applyLagoSubscriptionSync, applyMolliePaymentSync } from "@hivegrid/db/billing-sync.server";
|
||||
import type { Prisma } from "@hivegrid/db/prisma-browser";
|
||||
import type { AdminBillingInputRow } from "@hivegrid/view-models";
|
||||
import { db } from "~/utils/db.server";
|
||||
import { invalidateTenantModuleAccessCache } from "~/utils/connector/tenantConnector.server";
|
||||
import { clearTenantSubscriptionCache } from "~/utils/services/.server/subscriptionService";
|
||||
import { assertAdminActionReason, recordAdminAction, type AdminActionAuditContext } from "./admin-action-audit.server";
|
||||
|
||||
export type BillingSyncProvider = "lago" | "mollie";
|
||||
|
||||
export class AdminBillingError extends Error {
|
||||
override readonly name = "AdminBillingError";
|
||||
readonly i18nKey: string;
|
||||
|
||||
constructor(readonly code: "TENANT_NOT_FOUND" | "MISSING_PROVIDER_REFERENCE" | "INVALID_PLAN" | "INVALID_SEATS") {
|
||||
super(code);
|
||||
this.i18nKey = `admin.billing.errors.${code}`;
|
||||
}
|
||||
}
|
||||
|
||||
type TenantSummary = {
|
||||
id: string;
|
||||
name: string;
|
||||
slug: string;
|
||||
};
|
||||
|
||||
export type AdminBillingDeps = {
|
||||
readonly db: typeof db;
|
||||
readonly resolveBillingState: typeof resolveTenantBillingState;
|
||||
readonly invalidateModuleCache: (tenantId: string) => void;
|
||||
readonly clearSubscriptionCache: (tenantId: string) => void;
|
||||
readonly recordAction: (context: AdminActionAuditContext) => Promise<void>;
|
||||
readonly lagoGateway: BillingGateway | null;
|
||||
readonly mollieGateway: PaymentGateway | null;
|
||||
readonly applyLagoSync: typeof applyLagoSubscriptionSync;
|
||||
readonly applyMollieSync: typeof applyMolliePaymentSync;
|
||||
readonly now: () => Date;
|
||||
};
|
||||
|
||||
function createConfiguredLagoGateway(): BillingGateway | null {
|
||||
const config = loadWebConfig().config.lago;
|
||||
if (!config.apiUrl || !config.apiKey) return null;
|
||||
return createLagoBillingGateway({
|
||||
apiUrl: config.apiUrl,
|
||||
apiKey: config.apiKey,
|
||||
timeoutMs: config.timeoutMs,
|
||||
});
|
||||
}
|
||||
|
||||
function createConfiguredMollieGateway(): PaymentGateway | null {
|
||||
const config = loadWebConfig().config.mollie;
|
||||
if (!config.apiKey) return null;
|
||||
return createMolliePaymentGateway({
|
||||
apiKey: config.apiKey,
|
||||
profileId: config.profileId,
|
||||
timeoutMs: config.timeoutMs,
|
||||
});
|
||||
}
|
||||
|
||||
function defaultDeps(): AdminBillingDeps {
|
||||
return {
|
||||
db,
|
||||
resolveBillingState: resolveTenantBillingState,
|
||||
invalidateModuleCache: invalidateTenantModuleAccessCache,
|
||||
clearSubscriptionCache: clearTenantSubscriptionCache,
|
||||
recordAction: recordAdminAction,
|
||||
lagoGateway: createConfiguredLagoGateway(),
|
||||
mollieGateway: createConfiguredMollieGateway(),
|
||||
applyLagoSync: applyLagoSubscriptionSync,
|
||||
applyMollieSync: applyMolliePaymentSync,
|
||||
now: () => new Date(),
|
||||
};
|
||||
}
|
||||
|
||||
function dateToIso(value: Date | null | undefined): string | null {
|
||||
return value ? value.toISOString() : null;
|
||||
}
|
||||
|
||||
function requireTenant(tenant: TenantSummary | null): TenantSummary {
|
||||
if (!tenant) throw new AdminBillingError("TENANT_NOT_FOUND");
|
||||
return tenant;
|
||||
}
|
||||
|
||||
function normalizePlanCode(value: string | null | undefined): string {
|
||||
const planCode = (value ?? "").trim();
|
||||
if (planCode.length === 0) throw new AdminBillingError("INVALID_PLAN");
|
||||
return planCode;
|
||||
}
|
||||
|
||||
function normalizeSeatQuantity(value: number | string | null | undefined): number {
|
||||
const seatQuantity = typeof value === "number" ? value : Number.parseInt(value ?? "", 10);
|
||||
if (!Number.isInteger(seatQuantity) || seatQuantity < 1 || seatQuantity > 10_000) {
|
||||
throw new AdminBillingError("INVALID_SEATS");
|
||||
}
|
||||
return seatQuantity;
|
||||
}
|
||||
|
||||
export async function listAdminBillingRows(deps: AdminBillingDeps = defaultDeps()): Promise<AdminBillingInputRow[]> {
|
||||
const tenants = await deps.db.tenant.findMany({
|
||||
orderBy: { name: "asc" },
|
||||
take: 100,
|
||||
select: { id: true, name: true, slug: true },
|
||||
});
|
||||
|
||||
return await Promise.all(
|
||||
tenants.map(async (tenant) => {
|
||||
const state = await deps.resolveBillingState(tenant.id);
|
||||
return {
|
||||
tenantId: tenant.id,
|
||||
tenantName: tenant.name,
|
||||
tenantSlug: tenant.slug,
|
||||
status: state.status,
|
||||
readOnly: state.readOnly,
|
||||
planCode: state.planCode,
|
||||
seatQuantity: state.seatQuantity,
|
||||
lagoCustomerId: state.lagoCustomerId,
|
||||
mollieCustomerId: state.mollieCustomerId,
|
||||
lastInvoiceExternalId: state.lastInvoiceExternalId,
|
||||
lastPaymentExternalId: state.lastPaymentExternalId,
|
||||
currentPeriodStart: dateToIso(state.currentPeriodStart),
|
||||
currentPeriodEnd: dateToIso(state.currentPeriodEnd),
|
||||
pastDueSince: dateToIso(state.pastDueSince),
|
||||
frozenAt: dateToIso(state.frozenAt),
|
||||
cancelledAt: dateToIso(state.cancelledAt),
|
||||
entitlementCount: state.entitlements.length,
|
||||
};
|
||||
})
|
||||
);
|
||||
}
|
||||
|
||||
export type SetTenantBillingPlanSeatsInput = {
|
||||
readonly tenantId: string;
|
||||
readonly planCode: string;
|
||||
readonly seatQuantity: number | string;
|
||||
readonly reason: string;
|
||||
readonly actorUserId: string | null;
|
||||
readonly actorEmail?: string | null;
|
||||
readonly request?: Request;
|
||||
};
|
||||
|
||||
type SubscriptionProductMatch = { id: string } | null;
|
||||
|
||||
async function findPlanProduct(planCode: string, deps: AdminBillingDeps): Promise<SubscriptionProductMatch> {
|
||||
return await deps.db.subscriptionProduct.findFirst({
|
||||
where: {
|
||||
OR: [{ id: planCode }, { code: planCode }, { lagoPlanCode: planCode }],
|
||||
},
|
||||
select: { id: true },
|
||||
});
|
||||
}
|
||||
|
||||
async function attachMatchingProduct(
|
||||
input: { subscriptionId: string; product: { id: string }; planCode: string; seatQuantity: number; now: Date },
|
||||
tx: Prisma.TransactionClient
|
||||
): Promise<void> {
|
||||
await tx.tenantSubscriptionProduct.updateMany({
|
||||
where: {
|
||||
tenantSubscriptionId: input.subscriptionId,
|
||||
subscriptionProductId: { not: input.product.id },
|
||||
OR: [{ endsAt: null }, { endsAt: { gt: input.now } }],
|
||||
},
|
||||
data: {
|
||||
cancelledAt: input.now,
|
||||
endsAt: input.now,
|
||||
},
|
||||
});
|
||||
|
||||
const existing = await tx.tenantSubscriptionProduct.findFirst({
|
||||
where: {
|
||||
tenantSubscriptionId: input.subscriptionId,
|
||||
subscriptionProductId: input.product.id,
|
||||
},
|
||||
select: { id: true },
|
||||
});
|
||||
|
||||
if (existing) {
|
||||
await tx.tenantSubscriptionProduct.update({
|
||||
where: { id: existing.id },
|
||||
data: {
|
||||
planCode: input.planCode,
|
||||
seatQuantity: input.seatQuantity,
|
||||
quantity: input.seatQuantity,
|
||||
cancelledAt: null,
|
||||
endsAt: null,
|
||||
},
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
await tx.tenantSubscriptionProduct.create({
|
||||
data: {
|
||||
tenantSubscriptionId: input.subscriptionId,
|
||||
subscriptionProductId: input.product.id,
|
||||
planCode: input.planCode,
|
||||
seatQuantity: input.seatQuantity,
|
||||
quantity: input.seatQuantity,
|
||||
cancelledAt: null,
|
||||
endsAt: null,
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
export async function setTenantBillingPlanSeats(input: SetTenantBillingPlanSeatsInput, deps: AdminBillingDeps = defaultDeps()): Promise<void> {
|
||||
const reason = assertAdminActionReason(input.reason);
|
||||
const planCode = normalizePlanCode(input.planCode);
|
||||
const seatQuantity = normalizeSeatQuantity(input.seatQuantity);
|
||||
const now = deps.now();
|
||||
const tenant = requireTenant(
|
||||
await deps.db.tenant.findUnique({
|
||||
where: { id: input.tenantId },
|
||||
select: { id: true, name: true, slug: true },
|
||||
})
|
||||
);
|
||||
const before = await deps.resolveBillingState(tenant.id);
|
||||
const product = await findPlanProduct(planCode, deps);
|
||||
|
||||
await deps.db.$transaction(async (tx) => {
|
||||
const subscription = await tx.tenantSubscription.upsert({
|
||||
where: { tenantId: tenant.id },
|
||||
create: {
|
||||
tenantId: tenant.id,
|
||||
planCode,
|
||||
seatQuantity,
|
||||
status: "active",
|
||||
},
|
||||
update: {
|
||||
planCode,
|
||||
seatQuantity,
|
||||
status: "active",
|
||||
frozenAt: null,
|
||||
cancelledAt: null,
|
||||
},
|
||||
select: { id: true },
|
||||
});
|
||||
|
||||
if (product) {
|
||||
await attachMatchingProduct({ subscriptionId: subscription.id, product, planCode, seatQuantity, now }, tx);
|
||||
}
|
||||
});
|
||||
|
||||
deps.clearSubscriptionCache(tenant.id);
|
||||
deps.invalidateModuleCache(tenant.id);
|
||||
|
||||
await deps.recordAction({
|
||||
action: "subscription.overridden",
|
||||
actorUserId: input.actorUserId,
|
||||
actorEmail: input.actorEmail ?? null,
|
||||
targetKind: "tenant",
|
||||
targetId: tenant.id,
|
||||
reason,
|
||||
before: { planCode: before.planCode, seatQuantity: before.seatQuantity, status: before.status },
|
||||
after: { planCode, seatQuantity, status: "active", catalogProductAttached: Boolean(product) },
|
||||
request: input.request,
|
||||
});
|
||||
}
|
||||
|
||||
export type RequestManualBillingSyncInput = {
|
||||
readonly tenantId: string;
|
||||
readonly provider: BillingSyncProvider;
|
||||
readonly actorUserId: string | null;
|
||||
readonly actorEmail?: string | null;
|
||||
readonly request?: Request;
|
||||
};
|
||||
|
||||
async function applyManualProviderSync(input: {
|
||||
provider: BillingSyncProvider;
|
||||
tenantId: string;
|
||||
state: Awaited<ReturnType<typeof resolveTenantBillingState>>;
|
||||
now: Date;
|
||||
}, deps: AdminBillingDeps): Promise<Record<string, unknown>> {
|
||||
if (input.provider === "lago") {
|
||||
if (!deps.lagoGateway) throw new AdminBillingError("MISSING_PROVIDER_REFERENCE");
|
||||
const [customer, invoices] = await Promise.all([
|
||||
deps.lagoGateway.getCustomer(input.tenantId),
|
||||
deps.lagoGateway.listInvoices({ tenantId: input.tenantId, perPage: 1 }),
|
||||
]);
|
||||
const latestInvoice = invoices[0] ?? null;
|
||||
const result = await deps.applyLagoSync({
|
||||
tenantId: input.tenantId,
|
||||
eventKey: `admin:lago:${input.tenantId}:${input.now.toISOString()}`,
|
||||
lagoCustomerId: customer?.providerCustomerId ?? input.state.lagoCustomerId,
|
||||
status: input.state.status,
|
||||
planCode: input.state.planCode,
|
||||
seatQuantity: input.state.seatQuantity,
|
||||
invoiceExternalId: latestInvoice?.providerInvoiceId ?? input.state.lastInvoiceExternalId,
|
||||
receivedAt: input.now,
|
||||
});
|
||||
return {
|
||||
provider: input.provider,
|
||||
synced: true,
|
||||
billingStatus: result.status,
|
||||
invoiceExternalId: latestInvoice?.providerInvoiceId ?? input.state.lastInvoiceExternalId,
|
||||
};
|
||||
}
|
||||
|
||||
const providerPaymentId = input.state.lastPaymentExternalId;
|
||||
const invoiceExternalId = input.state.lastInvoiceExternalId;
|
||||
if (!providerPaymentId || !invoiceExternalId) throw new AdminBillingError("MISSING_PROVIDER_REFERENCE");
|
||||
if (!deps.mollieGateway) throw new AdminBillingError("MISSING_PROVIDER_REFERENCE");
|
||||
const payment = await deps.mollieGateway.getPayment(providerPaymentId);
|
||||
if (!payment) throw new AdminBillingError("MISSING_PROVIDER_REFERENCE");
|
||||
const result = await deps.applyMollieSync({
|
||||
tenantId: input.tenantId,
|
||||
eventKey: `admin:mollie:${input.tenantId}:${payment.providerPaymentId}:${input.now.toISOString()}`,
|
||||
mollieCustomerId: input.state.mollieCustomerId,
|
||||
paymentExternalId: payment.externalId ?? providerPaymentId,
|
||||
invoiceExternalId: payment.metadata.invoiceExternalId ?? invoiceExternalId,
|
||||
status: payment.status,
|
||||
receivedAt: input.now,
|
||||
});
|
||||
return {
|
||||
provider: input.provider,
|
||||
synced: true,
|
||||
billingStatus: result.status,
|
||||
providerPaymentId: payment.providerPaymentId,
|
||||
paymentStatus: payment.status,
|
||||
};
|
||||
}
|
||||
|
||||
export async function requestManualBillingSync(input: RequestManualBillingSyncInput, deps: AdminBillingDeps = defaultDeps()): Promise<void> {
|
||||
const tenant = requireTenant(
|
||||
await deps.db.tenant.findUnique({
|
||||
where: { id: input.tenantId },
|
||||
select: { id: true, name: true, slug: true },
|
||||
})
|
||||
);
|
||||
const state = await deps.resolveBillingState(tenant.id);
|
||||
const syncResult = await applyManualProviderSync({ provider: input.provider, tenantId: tenant.id, state, now: deps.now() }, deps);
|
||||
|
||||
deps.clearSubscriptionCache(tenant.id);
|
||||
deps.invalidateModuleCache(tenant.id);
|
||||
|
||||
await deps.recordAction({
|
||||
action: "subscription.syncRequested",
|
||||
actorUserId: input.actorUserId,
|
||||
actorEmail: input.actorEmail ?? null,
|
||||
targetKind: "tenant",
|
||||
targetId: tenant.id,
|
||||
reason: `manual-${input.provider}-sync`,
|
||||
after: syncResult,
|
||||
request: input.request,
|
||||
});
|
||||
}
|
||||
Reference in new issue
Block a user