@dainamite/billing 0.20.0 → 0.22.0

package/dist/modules/billing/commands/memos.js

@@ -0,0 +1,179 @@
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import { ensureOrganizationScope, ensureTenantScope } from "@open-mercato/shared/lib/commands/scope";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillingInvoice, BillingInvoiceLine } from "../data/entities.js";
+import {
+  billingDraftDeleteSchema,
+  billingMemoCreateSchema
+} from "../data/validators.js";
+import { getBillingSettings, taxRateColumn } from "../lib/billingSettings.js";
+import { canCorrect, isMemo } from "../lib/documentTypes.js";
+import { creditFits, loadCorrectionTotals } from "../lib/memoGuards.js";
+import { draftNumber } from "../lib/numbering.js";
+import { lineAmountsFromNet, money4, sumTotals } from "../lib/vat.js";
+import { toCents } from "../lib/allocation.js";
+function getEm(ctx) {
+  return ctx.container.resolve("em").fork();
+}
+const createMemoCommand = {
+  id: "billing.invoices.create_memo",
+  async execute(rawInput, ctx) {
+    const parsed = billingMemoCreateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = { tenantId: parsed.tenantId, organizationId: parsed.organizationId };
+    const em = getEm(ctx);
+    const original = await em.findOne(BillingInvoice, { id: parsed.invoiceId, ...scope, deletedAt: null });
+    if (!original) throw new CrudHttpError(404, { error: "Invoice not found" });
+    if (!canCorrect(original, parsed.type)) {
+      throw new CrudHttpError(409, {
+        error: "Only posted, partially paid or paid invoices can be corrected",
+        code: "billing.memo.invalid_original",
+        currentStatus: original.status,
+        documentType: original.documentType
+      });
+    }
+    const originalLines = await em.find(
+      BillingInvoiceLine,
+      { invoiceId: original.id, ...scope, deletedAt: null },
+      { orderBy: { lineNumber: "asc" } }
+    );
+    const byId = new Map(originalLines.map((line) => [line.id, line]));
+    const defaultRate = (await getBillingSettings(em, scope)).defaultTaxRate;
+    let drafts;
+    if (parsed.lines && parsed.lines.length > 0) {
+      drafts = parsed.lines.map((line) => {
+        const source = line.correctsLineId ? byId.get(line.correctsLineId) : null;
+        if (line.correctsLineId && !source) {
+          throw new CrudHttpError(400, { error: "A copied line does not belong to the original invoice", code: "billing.memo.invalid_line" });
+        }
+        return {
+          correctsLineId: source?.id ?? null,
+          description: line.description,
+          quantity: line.quantity,
+          unitPriceNet: line.unitPriceNet,
+          // Copied lines keep the original rate (P-D7); new lines default to the org rate.
+          taxRate: source ? source.taxRate : line.taxRate !== void 0 ? taxRateColumn(line.taxRate) : defaultRate,
+          billingType: source?.billingType ?? "manual",
+          servicePeriodStart: source?.servicePeriodStart ?? null,
+          servicePeriodEnd: source?.servicePeriodEnd ?? null
+        };
+      });
+    } else if (parsed.type === "credit_memo") {
+      drafts = originalLines.map((line) => ({
+        correctsLineId: line.id,
+        description: line.description,
+        quantity: Number.parseFloat(line.quantity),
+        unitPriceNet: Math.abs(Number.parseFloat(line.unitPriceNet)),
+        taxRate: line.taxRate,
+        billingType: line.billingType,
+        servicePeriodStart: line.servicePeriodStart ?? null,
+        servicePeriodEnd: line.servicePeriodEnd ?? null
+      }));
+    } else {
+      drafts = [];
+    }
+    const amounts = drafts.map((d) => lineAmountsFromNet(d.quantity * d.unitPriceNet, Number.parseFloat(d.taxRate) || 0));
+    const totals = sumTotals(amounts);
+    if (parsed.type === "credit_memo") {
+      const corrections = await loadCorrectionTotals(em, scope, original.id);
+      if (!creditFits(toCents(original.totalGross), corrections, toCents(totals.totalGross))) {
+        throw new CrudHttpError(409, {
+          error: "The credit exceeds what is left to credit on this invoice",
+          code: "billing.memo.exceeds_invoice"
+        });
+      }
+    }
+    const now = /* @__PURE__ */ new Date();
+    const memo = em.create(BillingInvoice, {
+      ...scope,
+      billAccountId: original.billAccountId,
+      documentType: parsed.type,
+      number: draftNumber(),
+      series: null,
+      status: "draft",
+      testRun: false,
+      billRunId: null,
+      billDate: null,
+      periodStart: original.periodStart ?? null,
+      periodEnd: original.periodEnd ?? null,
+      currencyCode: original.currencyCode,
+      subtotalNet: totals.subtotalNet,
+      taxTotal: totals.taxTotal,
+      totalGross: totals.totalGross,
+      paidTotal: "0",
+      creditedTotal: "0",
+      outstanding: totals.totalGross,
+      correctsInvoiceId: original.id,
+      correctionReason: parsed.reason,
+      correctsInvoiceNumber: original.number,
+      correctsIssueDate: original.issueDate ?? null,
+      createdAt: now,
+      updatedAt: now
+    });
+    em.persist(memo);
+    await em.flush();
+    drafts.forEach((draft, index) => {
+      em.persist(
+        em.create(BillingInvoiceLine, {
+          ...scope,
+          invoiceId: memo.id,
+          lineNumber: index + 1,
+          billingItemId: null,
+          billingType: draft.billingType,
+          description: draft.description,
+          quantity: money4(draft.quantity),
+          unitPriceNet: money4(draft.unitPriceNet),
+          taxRate: draft.taxRate,
+          netAmount: money4(amounts[index].net),
+          taxAmount: money4(amounts[index].tax),
+          grossAmount: money4(amounts[index].gross),
+          servicePeriodStart: draft.servicePeriodStart,
+          servicePeriodEnd: draft.servicePeriodEnd,
+          correctsLineId: draft.correctsLineId,
+          metadata: null,
+          createdAt: now,
+          updatedAt: now
+        })
+      );
+    });
+    await em.flush();
+    return { memoId: memo.id, number: memo.number, documentType: memo.documentType, totalGross: memo.totalGross };
+  }
+};
+const deleteDraftMemoCommand = {
+  id: "billing.invoices.delete_draft",
+  async execute(rawInput, ctx) {
+    const parsed = billingDraftDeleteSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = { tenantId: parsed.tenantId, organizationId: parsed.organizationId };
+    const em = getEm(ctx);
+    const memo = await em.findOne(BillingInvoice, { id: parsed.invoiceId, ...scope, deletedAt: null });
+    if (!memo) throw new CrudHttpError(404, { error: "Document not found" });
+    if (memo.status !== "draft" || !isMemo(memo.documentType)) {
+      throw new CrudHttpError(409, {
+        error: "Only draft credit / debit memos can be deleted",
+        code: "billing.memo.not_draft"
+      });
+    }
+    await em.transactional(async (tem) => {
+      await tem.execute(
+        `DELETE FROM billing_invoice_lines WHERE invoice_id = ? AND tenant_id = ? AND organization_id = ?`,
+        [memo.id, scope.tenantId, scope.organizationId]
+      );
+      await tem.execute(
+        `DELETE FROM billing_invoices WHERE id = ? AND tenant_id = ? AND organization_id = ? AND status = 'draft'`,
+        [memo.id, scope.tenantId, scope.organizationId]
+      );
+    });
+    return { deleted: true };
+  }
+};
+registerCommand(createMemoCommand);
+registerCommand(deleteDraftMemoCommand);
+export {
+  createMemoCommand,
+  deleteDraftMemoCommand
+};
+//# sourceMappingURL=memos.js.map

package/dist/modules/billing/commands/memos.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/commands/memos.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { CommandHandler, CommandRuntimeContext } from '@open-mercato/shared/lib/commands/types'\nimport { registerCommand } from '@open-mercato/shared/lib/commands'\nimport { ensureOrganizationScope, ensureTenantScope } from '@open-mercato/shared/lib/commands/scope'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { BillingInvoice, BillingInvoiceLine } from '../data/entities'\nimport {\n  billingDraftDeleteSchema,\n  billingMemoCreateSchema,\n  type BillingDraftDeleteInput,\n  type BillingMemoCreateInput,\n} from '../data/validators'\nimport { getBillingSettings, taxRateColumn } from '../lib/billingSettings'\nimport { canCorrect, isMemo } from '../lib/documentTypes'\nimport { creditFits, loadCorrectionTotals } from '../lib/memoGuards'\nimport { draftNumber } from '../lib/numbering'\nimport { lineAmountsFromNet, money4, sumTotals } from '../lib/vat'\nimport { toCents } from '../lib/allocation'\n\n/**\n * Corrective documents (Spec D).\n *\n * `billing.invoices.create_memo` \u2014 creates a DRAFT credit or debit memo for\n * a posted / partially paid / paid billing invoice (D-D3). The memo copies\n * the original's account, currency and period, snapshots its number and\n * issue date, and requires a reason (D-D4). Credit memo lines copied from\n * the original keep the original VAT rate; without lines a credit memo is\n * a full credit (D-D9). Amounts are stored positive (D-D5). Posting goes\n * through `billing.invoices.post` (series, settlement \u2014 see commands/invoices).\n *\n * `billing.invoices.delete_draft` \u2014 deletes a draft memo with its lines\n * (D-D7: posted documents are never deleted or voided).\n */\n\nfunction getEm(ctx: CommandRuntimeContext): EntityManager {\n  return (ctx.container.resolve('em') as EntityManager).fork()\n}\n\ntype MemoResult = { memoId: string; number: string; documentType: string; totalGross: string }\n\nconst createMemoCommand: CommandHandler<BillingMemoCreateInput, MemoResult> = {\n  id: 'billing.invoices.create_memo',\n  async execute(rawInput, ctx) {\n    const parsed = billingMemoCreateSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n    const scope = { tenantId: parsed.tenantId, organizationId: parsed.organizationId }\n    const em = getEm(ctx)\n\n    const original = await em.findOne(BillingInvoice, { id: parsed.invoiceId, ...scope, deletedAt: null } as never)\n    if (!original) throw new CrudHttpError(404, { error: 'Invoice not found' })\n    if (!canCorrect(original, parsed.type)) {\n      throw new CrudHttpError(409, {\n        error: 'Only posted, partially paid or paid invoices can be corrected',\n        code: 'billing.memo.invalid_original',\n        currentStatus: original.status,\n        documentType: original.documentType,\n      })\n    }\n\n    const originalLines = await em.find(\n      BillingInvoiceLine,\n      { invoiceId: original.id, ...scope, deletedAt: null } as never,\n      { orderBy: { lineNumber: 'asc' } as never },\n    )\n    const byId = new Map(originalLines.map((line) => [line.id, line]))\n    const defaultRate = (await getBillingSettings(em, scope)).defaultTaxRate\n\n    type Draft = {\n      correctsLineId: string | null\n      description: string\n      quantity: number\n      unitPriceNet: number\n      taxRate: string\n      billingType: string\n      servicePeriodStart: Date | null\n      servicePeriodEnd: Date | null\n    }\n    let drafts: Draft[]\n    if (parsed.lines && parsed.lines.length > 0) {\n      drafts = parsed.lines.map((line) => {\n        const source = line.correctsLineId ? byId.get(line.correctsLineId) : null\n        if (line.correctsLineId && !source) {\n          throw new CrudHttpError(400, { error: 'A copied line does not belong to the original invoice', code: 'billing.memo.invalid_line' })\n        }\n        return {\n          correctsLineId: source?.id ?? null,\n          description: line.description,\n          quantity: line.quantity,\n          unitPriceNet: line.unitPriceNet,\n          // Copied lines keep the original rate (P-D7); new lines default to the org rate.\n          taxRate: source ? source.taxRate : line.taxRate !== undefined ? taxRateColumn(line.taxRate) : defaultRate,\n          billingType: source?.billingType ?? 'manual',\n          servicePeriodStart: source?.servicePeriodStart ?? null,\n          servicePeriodEnd: source?.servicePeriodEnd ?? null,\n        }\n      })\n    } else if (parsed.type === 'credit_memo') {\n      // Full credit: every original line (amounts positive, D-D5).\n      drafts = originalLines.map((line) => ({\n        correctsLineId: line.id,\n        description: line.description,\n        quantity: Number.parseFloat(line.quantity),\n        unitPriceNet: Math.abs(Number.parseFloat(line.unitPriceNet)),\n        taxRate: line.taxRate,\n        billingType: line.billingType,\n        servicePeriodStart: line.servicePeriodStart ?? null,\n        servicePeriodEnd: line.servicePeriodEnd ?? null,\n      }))\n    } else {\n      drafts = []\n    }\n\n    const amounts = drafts.map((d) => lineAmountsFromNet(d.quantity * d.unitPriceNet, Number.parseFloat(d.taxRate) || 0))\n    const totals = sumTotals(amounts)\n\n    if (parsed.type === 'credit_memo') {\n      const corrections = await loadCorrectionTotals(em, scope, original.id)\n      if (!creditFits(toCents(original.totalGross), corrections, toCents(totals.totalGross))) {\n        throw new CrudHttpError(409, {\n          error: 'The credit exceeds what is left to credit on this invoice',\n          code: 'billing.memo.exceeds_invoice',\n        })\n      }\n    }\n\n    const now = new Date()\n    const memo = em.create(BillingInvoice, {\n      ...scope,\n      billAccountId: original.billAccountId,\n      documentType: parsed.type,\n      number: draftNumber(),\n      series: null,\n      status: 'draft',\n      testRun: false,\n      billRunId: null,\n      billDate: null,\n      periodStart: original.periodStart ?? null,\n      periodEnd: original.periodEnd ?? null,\n      currencyCode: original.currencyCode,\n      subtotalNet: totals.subtotalNet,\n      taxTotal: totals.taxTotal,\n      totalGross: totals.totalGross,\n      paidTotal: '0',\n      creditedTotal: '0',\n      outstanding: totals.totalGross,\n      correctsInvoiceId: original.id,\n      correctionReason: parsed.reason,\n      correctsInvoiceNumber: original.number,\n      correctsIssueDate: original.issueDate ?? null,\n      createdAt: now,\n      updatedAt: now,\n    } as never)\n    em.persist(memo)\n    await em.flush()\n    drafts.forEach((draft, index) => {\n      em.persist(\n        em.create(BillingInvoiceLine, {\n          ...scope,\n          invoiceId: memo.id,\n          lineNumber: index + 1,\n          billingItemId: null,\n          billingType: draft.billingType,\n          description: draft.description,\n          quantity: money4(draft.quantity),\n          unitPriceNet: money4(draft.unitPriceNet),\n          taxRate: draft.taxRate,\n          netAmount: money4(amounts[index].net),\n          taxAmount: money4(amounts[index].tax),\n          grossAmount: money4(amounts[index].gross),\n          servicePeriodStart: draft.servicePeriodStart,\n          servicePeriodEnd: draft.servicePeriodEnd,\n          correctsLineId: draft.correctsLineId,\n          metadata: null,\n          createdAt: now,\n          updatedAt: now,\n        } as never),\n      )\n    })\n    await em.flush()\n    return { memoId: memo.id, number: memo.number, documentType: memo.documentType, totalGross: memo.totalGross }\n  },\n}\n\nconst deleteDraftMemoCommand: CommandHandler<BillingDraftDeleteInput, { deleted: boolean }> = {\n  id: 'billing.invoices.delete_draft',\n  async execute(rawInput, ctx) {\n    const parsed = billingDraftDeleteSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n    const scope = { tenantId: parsed.tenantId, organizationId: parsed.organizationId }\n    const em = getEm(ctx)\n    const memo = await em.findOne(BillingInvoice, { id: parsed.invoiceId, ...scope, deletedAt: null } as never)\n    if (!memo) throw new CrudHttpError(404, { error: 'Document not found' })\n    if (memo.status !== 'draft' || !isMemo(memo.documentType)) {\n      throw new CrudHttpError(409, {\n        error: 'Only draft credit / debit memos can be deleted',\n        code: 'billing.memo.not_draft',\n      })\n    }\n    await em.transactional(async (tem) => {\n      await (tem as EntityManager).execute(\n        `DELETE FROM billing_invoice_lines WHERE invoice_id = ? AND tenant_id = ? AND organization_id = ?`,\n        [memo.id, scope.tenantId, scope.organizationId],\n      )\n      await (tem as EntityManager).execute(\n        `DELETE FROM billing_invoices WHERE id = ? AND tenant_id = ? AND organization_id = ? AND status = 'draft'`,\n        [memo.id, scope.tenantId, scope.organizationId],\n      )\n    })\n    return { deleted: true }\n  },\n}\n\nregisterCommand(createMemoCommand)\nregisterCommand(deleteDraftMemoCommand)\n\nexport { createMemoCommand, deleteDraftMemoCommand }\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/billing/commands/payments.js

@@ -0,0 +1,379 @@
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import { ensureOrganizationScope, ensureTenantScope } from "@open-mercato/shared/lib/commands/scope";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillingAccount, BillingPayment, BillingTopup } from "../data/entities.js";
+import {
+  billingAllocationRemoveSchema,
+  billingPaymentAllocateSchema,
+  billingPaymentAssignSchema,
+  billingPaymentConvertSchema,
+  billingPaymentCreateSchema,
+  billingPaymentIdSchema,
+  billingPaymentImportSchema
+} from "../data/validators.js";
+import { emitBillingEvent } from "../events.js";
+import { withAccountLock } from "../lib/accountLock.js";
+import {
+  allocate,
+  applyAccountCredit,
+  emptyEffects,
+  mergeEffects,
+  toCents,
+  unallocate
+} from "../lib/allocation.js";
+import { emitAllocationEffects } from "../lib/allocationEvents.js";
+import { getBillingSettings, receiptTaxRate } from "../lib/billingSettings.js";
+import { importPayments } from "../lib/paymentImport.js";
+import { captureTopup } from "../lib/topupCapture.js";
+import { createHash } from "node:crypto";
+function getEm(ctx) {
+  return ctx.container.resolve("em").fork();
+}
+function userIdOf(ctx) {
+  return ctx.auth?.sub ?? null;
+}
+function scopeOf(input) {
+  return { tenantId: input.tenantId, organizationId: input.organizationId };
+}
+async function loadPayment(em, scope, paymentId) {
+  const payment = await em.findOne(BillingPayment, { id: paymentId, ...scope, deletedAt: null });
+  if (!payment) throw new CrudHttpError(404, { error: "Payment not found", code: "billing.payment.not_found" });
+  return payment;
+}
+async function loadAccount(em, scope, billAccountId) {
+  const account = await em.findOne(BillingAccount, { id: billAccountId, ...scope, deletedAt: null });
+  if (!account) throw new CrudHttpError(404, { error: "Billing account not found", code: "billing.payment.account_missing" });
+  return account;
+}
+async function countActiveAllocations(em, scope, paymentId) {
+  const rows = await em.execute(
+    `SELECT COUNT(*)::int AS n FROM billing_allocations
+      WHERE tenant_id = ? AND organization_id = ? AND source_type = 'payment' AND source_id = ? AND deleted_at IS NULL`,
+    [scope.tenantId, scope.organizationId, paymentId]
+  );
+  return Number(rows?.[0]?.n ?? 0);
+}
+async function paymentResult(em, scope, paymentId) {
+  const rows = await em.execute(
+    `SELECT status, unallocated_amount FROM billing_payments WHERE id = ? AND tenant_id = ? AND organization_id = ?`,
+    [paymentId, scope.tenantId, scope.organizationId]
+  );
+  return { paymentId, status: rows?.[0]?.status ?? "unmatched", unallocatedAmount: rows?.[0]?.unallocated_amount ?? "0" };
+}
+const importPaymentsCommand = {
+  id: "billing.payments.import",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentImportSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const { summary, effects, paymentIds } = await importPayments(getEm(ctx), {
+      scope,
+      fileName: parsed.fileName,
+      content: parsed.content,
+      userId: userIdOf(ctx)
+    });
+    for (const paymentId of paymentIds) await emitBillingEvent("billing.payment.created", { ...scope, paymentId, source: "csv" });
+    await emitAllocationEffects(scope, effects);
+    await emitBillingEvent("billing.payment_import.completed", { ...scope, importId: summary.importId, counts: summary.counts });
+    return summary;
+  }
+};
+const createPaymentCommand = {
+  id: "billing.payments.create",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentCreateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    if (parsed.billAccountId) {
+      const account = await loadAccount(em, scope, parsed.billAccountId);
+      if (account.currencyCode !== parsed.currencyCode) {
+        throw new CrudHttpError(409, { error: "Payment currency differs from the account", code: "billing.payment.currency_mismatch" });
+      }
+    }
+    const amount = parsed.amount.toFixed(4);
+    const now = /* @__PURE__ */ new Date();
+    const payment = em.create(BillingPayment, {
+      ...scope,
+      receivedAt: /* @__PURE__ */ new Date(`${parsed.receivedAt}T00:00:00Z`),
+      amount,
+      currencyCode: parsed.currencyCode,
+      reference: parsed.reference ?? null,
+      payerName: parsed.payerName ?? null,
+      payerAccount: parsed.payerAccount ?? null,
+      source: "manual",
+      billAccountId: parsed.billAccountId ?? null,
+      status: parsed.billAccountId ? "matched" : "unmatched",
+      unallocatedAmount: amount,
+      matchReason: parsed.billAccountId ? null : "manual",
+      sourceRef: `manual:${createHash("sha256").update(`${scope.tenantId}|${now.toISOString()}|${Math.random()}`).digest("hex")}`,
+      createdAt: now,
+      updatedAt: now
+    });
+    em.persist(payment);
+    await em.flush();
+    let effects = emptyEffects();
+    if (parsed.billAccountId) {
+      effects = await withAccountLock(
+        em,
+        { tenantId: scope.tenantId, billAccountId: parsed.billAccountId },
+        (tem) => applyAccountCredit(tem, scope, { id: parsed.billAccountId, currencyCode: parsed.currencyCode }, {
+          onlySources: [{ type: "payment", id: payment.id }]
+        })
+      );
+    }
+    await emitBillingEvent("billing.payment.created", { ...scope, paymentId: payment.id, source: "manual" });
+    await emitAllocationEffects(scope, effects);
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const assignPaymentCommand = {
+  id: "billing.payments.assign",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentAssignSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const [payment, account] = await Promise.all([
+      loadPayment(em, scope, parsed.paymentId),
+      loadAccount(em, scope, parsed.billAccountId)
+    ]);
+    if (payment.status !== "unmatched") {
+      throw new CrudHttpError(409, { error: "Only unmatched payments can be assigned", code: "billing.payment.not_unmatched" });
+    }
+    if (account.billingMode === "prepaid") {
+      throw new CrudHttpError(409, {
+        error: 'Prepaid accounts take payments as top-ups \u2014 use "Convert to top-up"',
+        code: "billing.payment.prepaid_account"
+      });
+    }
+    if (account.currencyCode !== payment.currencyCode) {
+      throw new CrudHttpError(409, { error: "Payment currency differs from the account", code: "billing.payment.currency_mismatch" });
+    }
+    const effects = await withAccountLock(em, { tenantId: scope.tenantId, billAccountId: account.id }, async (tem) => {
+      await tem.execute(
+        `UPDATE billing_payments SET bill_account_id = ?, status = 'matched', match_reason = 'manual', updated_at = now()
+          WHERE id = ? AND tenant_id = ? AND organization_id = ? AND status = 'unmatched'`,
+        [account.id, payment.id, scope.tenantId, scope.organizationId]
+      );
+      return applyAccountCredit(tem, scope, { id: account.id, currencyCode: account.currencyCode }, {
+        onlySources: [{ type: "payment", id: payment.id }]
+      });
+    });
+    await emitAllocationEffects(scope, effects);
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const unassignPaymentCommand = {
+  id: "billing.payments.unassign",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentIdSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const payment = await loadPayment(em, scope, parsed.paymentId);
+    if (payment.status !== "matched" || !payment.billAccountId) {
+      throw new CrudHttpError(409, { error: "Only fully unallocated matched payments can be unassigned", code: "billing.payment.not_matched" });
+    }
+    if (await countActiveAllocations(em, scope, payment.id) > 0) {
+      throw new CrudHttpError(409, { error: "Un-allocate the payment first", code: "billing.payment.has_allocations" });
+    }
+    await em.execute(
+      `UPDATE billing_payments SET bill_account_id = NULL, status = 'unmatched', match_reason = 'manual', updated_at = now()
+        WHERE id = ? AND tenant_id = ? AND organization_id = ?`,
+      [payment.id, scope.tenantId, scope.organizationId]
+    );
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const allocatePaymentCommand = {
+  id: "billing.payments.allocate",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentAllocateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const payment = await loadPayment(em, scope, parsed.paymentId);
+    if (!payment.billAccountId) {
+      throw new CrudHttpError(409, { error: "Assign the payment to an account first", code: "billing.payment.unassigned" });
+    }
+    const effects = await withAccountLock(em, { tenantId: scope.tenantId, billAccountId: payment.billAccountId }, async (tem) => {
+      const all = emptyEffects();
+      for (const entry of parsed.allocations) {
+        mergeEffects(
+          all,
+          await allocate(tem, scope, {
+            source: { type: "payment", id: payment.id },
+            invoiceId: entry.invoiceId,
+            amountCents: toCents(entry.amount),
+            by: "user",
+            userId: userIdOf(ctx)
+          })
+        );
+      }
+      return all;
+    });
+    await emitAllocationEffects(scope, effects);
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const unallocateCommand = {
+  id: "billing.payments.unallocate",
+  async execute(rawInput, ctx) {
+    const parsed = billingAllocationRemoveSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const rows = await em.execute(
+      `SELECT bill_account_id FROM billing_allocations
+        WHERE id = ? AND tenant_id = ? AND organization_id = ? AND deleted_at IS NULL`,
+      [parsed.allocationId, scope.tenantId, scope.organizationId]
+    );
+    const billAccountId = rows?.[0]?.bill_account_id;
+    if (!billAccountId) throw new CrudHttpError(404, { error: "Allocation not found", code: "billing.allocation.not_found" });
+    const effects = await withAccountLock(
+      em,
+      { tenantId: scope.tenantId, billAccountId },
+      (tem) => unallocate(tem, scope, { allocationId: parsed.allocationId, userId: userIdOf(ctx) })
+    );
+    await emitAllocationEffects(scope, effects);
+    return { allocationId: parsed.allocationId, effects };
+  }
+};
+const ignorePaymentCommand = {
+  id: "billing.payments.ignore",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentIdSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const payment = await loadPayment(em, scope, parsed.paymentId);
+    if (!["unmatched", "matched"].includes(payment.status) || await countActiveAllocations(em, scope, payment.id) > 0) {
+      throw new CrudHttpError(409, { error: "Only unallocated payments can be ignored", code: "billing.payment.has_allocations" });
+    }
+    await em.execute(
+      `UPDATE billing_payments SET status = 'ignored', metadata = COALESCE(metadata, '{}'::jsonb) || jsonb_build_object('ignored_from', ?::text), updated_at = now()
+        WHERE id = ? AND tenant_id = ? AND organization_id = ?`,
+      [payment.status, payment.id, scope.tenantId, scope.organizationId]
+    );
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const restorePaymentCommand = {
+  id: "billing.payments.restore",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentIdSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const payment = await loadPayment(em, scope, parsed.paymentId);
+    if (payment.status !== "ignored") {
+      throw new CrudHttpError(409, { error: "Only ignored payments can be restored", code: "billing.payment.not_ignored" });
+    }
+    const status = payment.billAccountId ? "matched" : "unmatched";
+    let effects = emptyEffects();
+    if (payment.billAccountId) {
+      const account = await loadAccount(em, scope, payment.billAccountId);
+      effects = await withAccountLock(em, { tenantId: scope.tenantId, billAccountId: account.id }, async (tem) => {
+        await tem.execute(`UPDATE billing_payments SET status = ?, updated_at = now() WHERE id = ?`, [status, payment.id]);
+        return applyAccountCredit(tem, scope, { id: account.id, currencyCode: account.currencyCode }, {
+          onlySources: [{ type: "payment", id: payment.id }]
+        });
+      });
+    } else {
+      await em.execute(`UPDATE billing_payments SET status = ?, updated_at = now() WHERE id = ?`, [status, payment.id]);
+    }
+    await emitAllocationEffects(scope, effects);
+    return paymentResult(em, scope, payment.id);
+  }
+};
+const convertToTopupCommand = {
+  id: "billing.payments.convert_to_topup",
+  async execute(rawInput, ctx) {
+    const parsed = billingPaymentConvertSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const scope = scopeOf(parsed);
+    const em = getEm(ctx);
+    const [payment, account] = await Promise.all([
+      loadPayment(em, scope, parsed.paymentId),
+      loadAccount(em, scope, parsed.billAccountId)
+    ]);
+    if (account.billingMode !== "prepaid") {
+      throw new CrudHttpError(409, { error: "Only prepaid accounts take top-ups", code: "billing.payment.not_prepaid" });
+    }
+    if (account.currencyCode !== payment.currencyCode) {
+      throw new CrudHttpError(409, { error: "Payment currency differs from the account", code: "billing.payment.currency_mismatch" });
+    }
+    const sourceRef = `topup-${payment.id}`;
+    if (payment.status === "converted_to_topup" && payment.topupId) {
+      return { ...await paymentResult(em, scope, payment.id), topupId: payment.topupId };
+    }
+    if (payment.status !== "unmatched" || toCents(payment.unallocatedAmount) !== toCents(payment.amount)) {
+      throw new CrudHttpError(409, { error: "Only unmatched, unallocated payments can be converted", code: "billing.payment.not_convertible" });
+    }
+    let topup = await em.findOne(BillingTopup, { ...scope, sourceRef });
+    if (!topup) {
+      const now = /* @__PURE__ */ new Date();
+      topup = em.create(BillingTopup, {
+        ...scope,
+        billAccountId: account.id,
+        status: "pending",
+        amount: payment.amount,
+        currencyCode: payment.currencyCode,
+        providerKey: "bank_transfer",
+        paymentId: payment.id,
+        sourceRef,
+        metadata: { billing_payment_id: payment.id, reference: payment.reference ?? null },
+        createdAt: now,
+        updatedAt: now
+      });
+      em.persist(topup);
+      await em.flush();
+    }
+    const settings = await getBillingSettings(em, scope);
+    await captureTopup(em, {
+      topup,
+      account: { id: account.id, organizationId: account.organizationId, tenantId: account.tenantId, currencyCode: account.currencyCode },
+      taxRate: receiptTaxRate(settings),
+      gatewayTransactionId: payment.reference ?? null
+    });
+    await em.execute(
+      `UPDATE billing_payments
+          SET status = 'converted_to_topup', bill_account_id = ?, topup_id = ?, unallocated_amount = 0, updated_at = now()
+        WHERE id = ? AND tenant_id = ? AND organization_id = ?`,
+      [account.id, topup.id, payment.id, scope.tenantId, scope.organizationId]
+    );
+    await emitBillingEvent("billing.payment.converted_to_topup", { ...scope, paymentId: payment.id, topupId: topup.id, billAccountId: account.id });
+    return { ...await paymentResult(em, scope, payment.id), topupId: topup.id };
+  }
+};
+registerCommand(importPaymentsCommand);
+registerCommand(createPaymentCommand);
+registerCommand(assignPaymentCommand);
+registerCommand(unassignPaymentCommand);
+registerCommand(allocatePaymentCommand);
+registerCommand(unallocateCommand);
+registerCommand(ignorePaymentCommand);
+registerCommand(restorePaymentCommand);
+registerCommand(convertToTopupCommand);
+export {
+  allocatePaymentCommand,
+  assignPaymentCommand,
+  convertToTopupCommand,
+  createPaymentCommand,
+  ignorePaymentCommand,
+  importPaymentsCommand,
+  restorePaymentCommand,
+  unallocateCommand,
+  unassignPaymentCommand
+};
+//# sourceMappingURL=payments.js.map