@dainamite/billing 0.19.0 → 0.21.0

package/dist/modules/billing/lib/prepaidPeriodClose.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/lib/prepaidPeriodClose.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport {\n  BillingAccount,\n  BillingAccountBalance,\n  BillingAccountTransaction,\n  BillingItem,\n  BillingStatement,\n  BillRun,\n} from '../data/entities'\nimport type { BillCycle } from '../data/validators'\nimport { advanceNextBillDate, addDays, deriveBillPeriod, isCycleDue, type BillPeriod } from './billPeriod'\nimport { applyBalanceMovement } from './balanceLedger'\nimport { resolveLowBalanceThreshold } from './balanceStatus'\nimport { buildInvoiceLinesFromItems } from './invoiceWriter'\nimport { selectItemsForPeriod, type SelectableItem } from './itemSelector'\nimport { absMoney, addMoney, fromUnits, subMoney, toUnits } from './money'\nimport {\n  getLowBalanceThresholdDefault,\n  getNearLimitBufferDefault,\n  getStatementEnabled,\n} from './prepaidConfig'\nimport { buildBalanceCrossingEvents, type DomainEvent } from './balanceEvents'\n\n/**\n * Prepaid period close (SPEC-002 P3).\n *\n * A prepaid account never gets a payable draft invoice. Instead the Bill Run,\n * for a due prepaid account:\n *   1. charges its `recurring` / `one_time` items to the **balance** (atomic\n *      debit + transaction, deterministic `source_ref =\n *      recurring-{itemId}-{periodEndISO}`, then `billed_to_date = period_end`),\n *   2. builds a non-fiscal **BillingStatement** (opening, topups, usage,\n *      recurring, closing + per-item breakdown).\n *\n * Metered usage was already rated + debited in real time during the period \u2014\n * it is NOT re-rated here; the statement only summarizes it.\n *\n * Three anti-duplicate guards: the statement unique\n * `(bill_account_id, period_start, period_end)`, the per-item `billed_to_date`,\n * and the deterministic charge `source_ref`.\n */\n\nexport type PrepaidCloseMode = 'real' | 'test' | 'dry'\n\nexport type PrepaidAccountWarnings = {\n  // Reserved for future per-close warnings (e.g. negative-balance close).\n  closed_negative?: boolean\n}\n\nexport type PrepaidAccountResult =\n  | {\n      status: 'success' | 'success_with_warnings' | 'skipped_existing_statement'\n      warnings: PrepaidAccountWarnings | null\n      statementId: string | null\n      cyclesEmitted: number\n      statementEvents: DomainEvent[]\n    }\n  | { status: 'failed'; errorMessage: string }\n\nconst SCHEDULED_CYCLE_LIMIT = 1\nconst CATCH_UP_HARD_CAP = 60\n\nexport type ProcessPrepaidParams = {\n  asOfDate: Date\n  mode: PrepaidCloseMode\n  triggeredBy: 'schedule' | 'manual'\n  catchUp?: boolean\n}\n\n/**\n * Multi-cycle prepaid account processing (mirrors the postpaid engine's\n * catch-up loop). One statement + one set of recurring debits per missed\n * period \u2014 never combined.\n */\nexport async function processPrepaidAccount(\n  em: EntityManager,\n  account: BillingAccount,\n  billRun: BillRun,\n  params: ProcessPrepaidParams,\n): Promise<PrepaidAccountResult> {\n  const maxCycles =\n    params.triggeredBy === 'schedule' || !params.catchUp\n      ? SCHEDULED_CYCLE_LIMIT\n      : CATCH_UP_HARD_CAP\n\n  const statementEnabled = await getStatementEnabled(em)\n  // Resolve the crossing thresholds once \u2014 they don't change during the run.\n  const balanceRow = await em.findOne(BillingAccountBalance, {\n    tenantId: account.tenantId,\n    billAccountId: account.id,\n  })\n  const threshold = resolveLowBalanceThreshold(\n    balanceRow?.lowBalanceThreshold ?? null,\n    await getLowBalanceThresholdDefault(em),\n  )\n  const nearLimitBuffer = await getNearLimitBufferDefault(em)\n  const creditLimit = account.creditLimit ?? '0'\n\n  let cyclesEmitted = 0\n  let lastStatementId: string | null = null\n  const statementEvents: DomainEvent[] = []\n  // Chain opening \u2192 closing across cycles in a catch-up run. Null on the first\n  // cycle \u2192 closePrepaidPeriod resolves it from the prior statement / ledger.\n  let previousClosing: string | null = null\n\n  while (cyclesEmitted < maxCycles && isCycleDue(account.nextBillDate, params.asOfDate)) {\n    const period = deriveBillPeriod(account.nextBillDate, account.billCycle as BillCycle)\n\n    // Statement anti-duplicate (only when we would actually persist).\n    if (params.mode !== 'dry') {\n      const existing = await em.findOne(BillingStatement, {\n        tenantId: account.tenantId,\n        billAccountId: account.id,\n        periodStart: period.periodStart,\n        periodEnd: period.periodEnd,\n      })\n      if (existing) {\n        return {\n          status: 'skipped_existing_statement',\n          warnings: null,\n          statementId: existing.id,\n          cyclesEmitted,\n          statementEvents,\n        }\n      }\n    }\n\n    const cycle = await closePrepaidPeriod(em, account, period, billRun, {\n      mode: params.mode,\n      statementEnabled,\n      previousClosing,\n      threshold,\n      nearLimitBuffer,\n      creditLimit,\n    })\n    previousClosing = cycle.closingBalance\n    // Recurring charges move the balance too, so they can trip the same\n    // low/exhausted/over_limit crossings as a usage debit (SPEC-002). These\n    // are accumulated and emitted by the engine AFTER the run commits.\n    statementEvents.push(...cycle.crossingEvents)\n\n    // A negative closing balance is NORMAL for prepaid (the customer overspent;\n    // it's cleared by the next top-up), so it is not flagged as a warning.\n    if (cycle.statementId) {\n      lastStatementId = cycle.statementId\n      statementEvents.push({\n        id: 'billing.statement.generated',\n        payload: {\n          statementId: cycle.statementId,\n          billAccountId: account.id,\n          tenantId: account.tenantId,\n          organizationId: account.organizationId,\n          billRunId: billRun.id,\n          periodStart: period.periodStart.toISOString().slice(0, 10),\n          periodEnd: period.periodEnd.toISOString().slice(0, 10),\n          currencyCode: account.currencyCode,\n          openingBalance: cycle.openingBalance,\n          closingBalance: cycle.closingBalance,\n          totalTopups: cycle.totalTopups,\n          totalUsage: cycle.totalUsage,\n          totalRecurring: cycle.totalRecurring,\n          totalAdjustments: cycle.totalAdjustments,\n        },\n      })\n    }\n\n    if (params.mode === 'real') {\n      account.nextBillDate = advanceNextBillDate(\n        account.nextBillDate,\n        account.billCycle as BillCycle,\n      )\n      account.lastBillDate = period.periodEnd\n      account.updatedAt = new Date()\n      await em.flush()\n    } else {\n      // test / dry: do not advance state; one iteration only.\n      cyclesEmitted += 1\n      break\n    }\n    cyclesEmitted += 1\n  }\n\n  return {\n    status: 'success',\n    warnings: null,\n    statementId: lastStatementId,\n    cyclesEmitted,\n    statementEvents,\n  }\n}\n\ntype ClosePeriodResult = {\n  statementId: string | null\n  openingBalance: string\n  totalTopups: string\n  totalUsage: string\n  totalRecurring: string\n  totalAdjustments: string\n  closingBalance: string\n  crossingEvents: DomainEvent[]\n}\n\ntype DebitBreakdownEntry = {\n  billing_item_id: string\n  billing_type: string\n  uom_code?: string\n  quantity: string\n  amount: string\n}\n\nasync function closePrepaidPeriod(\n  em: EntityManager,\n  account: BillingAccount,\n  period: BillPeriod,\n  billRun: BillRun,\n  opts: {\n    mode: PrepaidCloseMode\n    statementEnabled: boolean\n    previousClosing: string | null\n    threshold: string\n    nearLimitBuffer: string\n    creditLimit: string\n  },\n): Promise<ClosePeriodResult> {\n  const periodEndISO = period.periodEnd.toISOString().slice(0, 10)\n\n  // Recurring + one_time items eligible for this period (usage excluded by the\n  // selector \u2014 it was rated in real time).\n  const items = await em.find(BillingItem, {\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    billAccountId: account.id,\n    deletedAt: null,\n  } as never)\n  const { included } = selectItemsForPeriod(items as unknown as SelectableItem[], period)\n  const billableItems = included as unknown as BillingItem[]\n  const lines = buildInvoiceLinesFromItems(billableItems)\n\n  // Window bounds for categorized sums (topups / usage already in the ledger).\n  const windowStart = period.periodStart\n  const windowEnd = addDays(period.periodEnd, 1) // exclusive upper bound\n\n  // Opening chains from the prior statement's closing \u2014 NOT a created_at sum.\n  // Recurring debits are stamped at run time (after period_end), so a\n  // `SUM(amount WHERE created_at < period_start)` would drop the prior period's\n  // recurring charge and break the chain. Resolution order:\n  //   1. previous cycle's closing (catch-up, in this run),\n  //   2. the prior persisted statement's closing (month-over-month),\n  //   3. the ledger balance before the first-ever statement window.\n  const openingBalance = await resolveOpeningBalance(em, account, period, opts.previousClosing)\n  const totalTopups = await sumByTypeInWindow(em, account, 'topup', windowStart, windowEnd)\n  const totalUsage = absMoney(\n    await sumByTypeInWindow(em, account, 'usage', windowStart, windowEnd),\n  )\n  // Manual adjustments / reversals that landed in the window \u2014 SIGNED (a credit\n  // is +, a debit \u2212). Kept as a first-class term so the statement is\n  // self-consistent and the opening\u2192closing chain never drifts.\n  const totalAdjustments = addMoney(\n    await sumByTypeInWindow(em, account, 'adjustment', windowStart, windowEnd),\n    await sumByTypeInWindow(em, account, 'reversal', windowStart, windowEnd),\n  )\n\n  let totalRecurring = '0.0000'\n  const breakdown: DebitBreakdownEntry[] = []\n  const chargeTransactionIds: string[] = []\n  // The balance just before / after the recurring batch \u2014 for crossing events.\n  let recurringBalanceBefore: string | null = null\n  let recurringBalanceAfter: string | null = null\n\n  if (opts.mode === 'real') {\n    const now = new Date()\n    for (const line of lines) {\n      const movement = await applyBalanceMovement(em, {\n        organizationId: account.organizationId,\n        tenantId: account.tenantId,\n        billAccountId: account.id,\n        currencyCode: account.currencyCode,\n        type: line.billingType === 'one_time' ? 'one_time' : 'recurring',\n        amount: fromUnits(-toUnits(line.totalNetAmount)),\n        description: line.description,\n        billingItemId: line.billingItemId,\n        sourceRef: `recurring-${line.billingItemId}-${periodEndISO}`,\n        metadata: {\n          bill_period_start: period.periodStart.toISOString().slice(0, 10),\n          bill_period_end: periodEndISO,\n          bill_run_id: billRun.id,\n        },\n      })\n      if (recurringBalanceBefore === null) recurringBalanceBefore = movement.balanceBefore\n      recurringBalanceAfter = movement.balanceAfter\n      totalRecurring = addMoney(totalRecurring, line.totalNetAmount)\n      if (!movement.deduplicated) chargeTransactionIds.push(movement.transaction.id)\n      breakdown.push({\n        billing_item_id: line.billingItemId,\n        billing_type: line.billingType,\n        quantity: line.quantity,\n        amount: line.totalNetAmount,\n      })\n      const item = billableItems.find((it) => it.id === line.billingItemId)\n      if (item) {\n        item.billedToDate = period.periodEnd\n        item.updatedAt = now\n      }\n    }\n    await em.flush()\n  } else {\n    // test / dry: compute the would-be charges, persist nothing.\n    for (const line of lines) {\n      totalRecurring = addMoney(totalRecurring, line.totalNetAmount)\n      breakdown.push({\n        billing_item_id: line.billingItemId,\n        billing_type: line.billingType,\n        quantity: line.quantity,\n        amount: line.totalNetAmount,\n      })\n    }\n  }\n\n  // closing = opening + topups + adjustments \u2212 usage \u2212 recurring.\n  const closingBalance = subMoney(\n    subMoney(addMoney(addMoney(openingBalance, totalTopups), totalAdjustments), totalUsage),\n    totalRecurring,\n  )\n\n  // The recurring batch can push the balance low / exhausted / over-limit \u2014\n  // emit those crossings (real mode only; dry/test never move the balance).\n  const crossingEvents =\n    recurringBalanceBefore !== null && recurringBalanceAfter !== null\n      ? buildBalanceCrossingEvents({\n          scope: {\n            billAccountId: account.id,\n            tenantId: account.tenantId,\n            organizationId: account.organizationId,\n            currencyCode: account.currencyCode,\n          },\n          balanceBefore: recurringBalanceBefore,\n          balanceAfter: recurringBalanceAfter,\n          threshold: opts.threshold,\n          creditLimit: opts.creditLimit,\n          nearLimitBuffer: opts.nearLimitBuffer,\n        })\n      : []\n\n  let statementId: string | null = null\n  if (opts.mode === 'real' && opts.statementEnabled) {\n    const now = new Date()\n    const statement = em.create(BillingStatement, {\n      organizationId: account.organizationId,\n      tenantId: account.tenantId,\n      billAccountId: account.id,\n      billRunId: billRun.id,\n      periodStart: period.periodStart,\n      periodEnd: period.periodEnd,\n      currencyCode: account.currencyCode,\n      openingBalance,\n      totalTopups,\n      totalUsage,\n      totalRecurring,\n      totalAdjustments,\n      closingBalance,\n      debitBreakdown: { items: breakdown },\n      status: 'generated',\n      createdAt: now,\n      updatedAt: now,\n    })\n    em.persist(statement)\n    await em.flush()\n    statementId = statement.id\n\n    // Backfill statement_id on the charge transactions for attribution.\n    if (chargeTransactionIds.length > 0) {\n      await em.nativeUpdate(\n        BillingAccountTransaction,\n        { id: { $in: chargeTransactionIds } } as never,\n        { statementId } as never,\n      )\n    }\n  }\n\n  return {\n    statementId,\n    openingBalance,\n    totalTopups,\n    totalUsage,\n    totalRecurring,\n    totalAdjustments,\n    closingBalance,\n    crossingEvents,\n  }\n}\n\n/**\n * Resolve a period's opening balance by chaining from the prior statement's\n * closing (the spec's \"chains cleanly\"), with a ledger fallback for the very\n * first statement. See the call site for why a created_at sum alone is wrong.\n */\nasync function resolveOpeningBalance(\n  em: EntityManager,\n  account: BillingAccount,\n  period: BillPeriod,\n  previousClosing: string | null,\n): Promise<string> {\n  if (previousClosing !== null) return previousClosing\n  const prior = await em.findOne(\n    BillingStatement,\n    {\n      tenantId: account.tenantId,\n      organizationId: account.organizationId,\n      billAccountId: account.id,\n      periodEnd: { $lt: period.periodStart },\n    } as never,\n    { orderBy: { periodEnd: 'DESC' } },\n  )\n  if (prior) return fromUnits(toUnits(prior.closingBalance))\n  // First-ever statement: the ledger balance just before the period window\n  // (only top-ups/usage exist before the first close, so created_at is safe).\n  return sumAmountsBefore(em, account, period.periodStart)\n}\n\n/** Balance at `before` = SUM(amount) of transactions created strictly before it. */\nasync function sumAmountsBefore(\n  em: EntityManager,\n  account: BillingAccount,\n  before: Date,\n): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(amount), 0) AS total\n       FROM billing_account_transactions\n      WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n        AND deleted_at IS NULL AND created_at < ?`,\n    [account.tenantId, account.organizationId, account.id, before],\n  )) as unknown as Array<{ total: string }>\n  return fromUnits(toUnits(rows?.[0]?.total ?? 0))\n}\n\n/** SUM(amount) for one transaction type within [from, to). */\nasync function sumByTypeInWindow(\n  em: EntityManager,\n  account: BillingAccount,\n  type: string,\n  from: Date,\n  to: Date,\n): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(amount), 0) AS total\n       FROM billing_account_transactions\n      WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n        AND deleted_at IS NULL AND type = ?\n        AND created_at >= ? AND created_at < ?`,\n    [account.tenantId, account.organizationId, account.id, type, from, to],\n  )) as unknown as Array<{ total: string }>\n  return fromUnits(toUnits(rows?.[0]?.total ?? 0))\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport {\n  BillingAccount,\n  BillingAccountBalance,\n  BillingAccountTransaction,\n  BillingItem,\n  BillingStatement,\n  BillingRun,\n} from '../data/entities'\nimport type { BillCycle } from '../data/validators'\nimport {\n  addDays,\n  advanceNextBillDate,\n  deriveBillPeriod,\n  isCycleDue,\n  shiftCycles,\n  type BillPeriod,\n} from './billPeriod'\nimport { applyBalanceMovement } from './balanceLedger'\nimport { resolveLowBalanceThreshold } from './balanceStatus'\nimport {\n  buildInvoiceLinesFromItems,\n  buildRecurringLineDescriptors,\n  type InvoiceLineDescriptor,\n} from './invoiceWriter'\nimport { shouldIncludeItem, type SelectableItem } from './itemSelector'\nimport { computeRecurringLines, type RecurringSkip } from './servicePeriods'\nimport { absMoney, addMoney, fromUnits, subMoney, toUnits } from './money'\nimport {\n  getLowBalanceThresholdDefault,\n  getNearLimitBufferDefault,\n  getPrepaidTaxPoint,\n  getStatementEnabled,\n} from './prepaidConfig'\nimport {\n  buildVatSummary,\n  resolvePrepaidDebit,\n  type PrepaidDebit,\n  type PrepaidTaxPoint,\n  type VatSummaryRow,\n} from './prepaidTaxPoint'\nimport { buildBalanceCrossingEvents, type DomainEvent } from './balanceEvents'\nimport { toIsoDate, toUtcMidnight } from './dateOnly'\n\n/**\n * Prepaid period close (SPEC-002 P3, reworked by Spec F).\n *\n * A prepaid account never gets a payable draft invoice. For every due bill\n * date D (catch-up up to `asOfDate`, one rule for every trigger) the run:\n *   1. charges `recurring` items per their `charge_timing` and `prorate`\n *      (Spec F, F-D4 \u2014 the same `computeRecurringLines` the postpaid engine\n *      uses: in advance \u2192 `[D, D + cycle \u2212 1]`, in arrears \u2192 `[D \u2212 cycle,\n *      D \u2212 1]`) and `one_time` items on the first bill date whose window\n *      overlaps them, debiting the balance through the org's tax point\n *      (Spec F, F-D3 \u2014 `resolvePrepaidDebit`);\n *   2. builds a non-fiscal **BillingStatement** for `[D \u2212 cycle, D \u2212 1]`\n *      (opening, top-ups, usage, charges taken at D, closing, per-line\n *      breakdown, VAT summary).\n *\n * Metered usage was rated + debited in real time during the period \u2014 it is\n * NOT re-rated here; the statement only summarises it.\n *\n * Bill date and item watermarks advance in memory, so test and dry runs\n * simulate every due cycle exactly like a real run; only persistence differs.\n *\n * Anti-duplicate guards: the per-item `billed_to_date` watermark, the\n * deterministic charge `source_ref`, and the statement unique\n * `(bill_account_id, period_start, period_end)`. A statement that already\n * exists for a period means that period was closed: the run skips the\n * statement, still applies (idempotent) charges, and advances \u2014 it never\n * leaves the account stuck behind an existing statement.\n */\n\nexport type PrepaidCloseMode = 'real' | 'test' | 'dry'\n\nexport type PrepaidCycleStatus = 'charged' | 'previewed' | 'empty' | 'skipped_existing'\n\n/** Same shape as the postpaid `CycleRecord` (Spec F, P-D6) plus prepaid fields. */\nexport type PrepaidCycleRecord = {\n  bill_date: string\n  period_start: string\n  period_end: string\n  status: PrepaidCycleStatus\n  line_count: number\n  total_net: string\n  /** What left the balance for this bill date (gross in `consumption` mode). */\n  total_debit: string\n  invoice_id: null\n  statement_id: string | null\n}\n\nexport type PrepaidSkippedItem = {\n  item_id: string\n  reason: string\n  service_period_start: string | null\n  service_period_end: string | null\n}\n\nexport type PrepaidAccountWarnings = {\n  skipped_items?: PrepaidSkippedItem[]\n  catch_up_cap_reached?: boolean\n}\n\nexport type PrepaidAccountResult =\n  | {\n      status: 'success' | 'success_with_warnings' | 'skipped_existing_statement'\n      warnings: PrepaidAccountWarnings | null\n      statementId: string | null\n      cyclesEmitted: number\n      cycles: PrepaidCycleRecord[]\n      statementEvents: DomainEvent[]\n    }\n  | { status: 'failed'; errorMessage: string }\n\nconst CATCH_UP_HARD_CAP = 60\nconst SKIPPED_ITEMS_WARNING_CAP = 200\n/** Skip reasons that are normal state, not worth surfacing on the outcome. */\nconst QUIET_SKIP_REASONS = new Set(['item-inactive', 'item-soft-deleted'])\n\nexport type ProcessPrepaidParams = {\n  asOfDate: Date\n  mode: PrepaidCloseMode\n  triggeredBy: 'schedule' | 'manual'\n}\n\ntype ChargeLine = {\n  descriptor: InvoiceLineDescriptor\n  amounts: PrepaidDebit\n  sourceRef: string\n}\n\ntype CycleContext = {\n  mode: PrepaidCloseMode\n  taxPoint: PrepaidTaxPoint\n  statementEnabled: boolean\n  threshold: string\n  nearLimitBuffer: string\n  creditLimit: string\n}\n\nfunction chargeSourceRef(line: InvoiceLineDescriptor, kind: 'charge' | 'credit'): string {\n  if (line.billingType === 'one_time') return `one_time-${line.billingItemId}`\n  const start = line.servicePeriodStart ? toIsoDate(line.servicePeriodStart) : 'na'\n  const end = line.servicePeriodEnd ? toIsoDate(line.servicePeriodEnd) : 'na'\n  return `recurring-${line.billingItemId}-${kind}-${start}-${end}`\n}\n\nfunction money4(value: number): string {\n  return fromUnits(Math.round(value * 10000))\n}\n\nfunction toSkipWarning(skip: RecurringSkip): PrepaidSkippedItem {\n  return {\n    item_id: skip.billingItemId,\n    reason: skip.reason,\n    service_period_start: skip.servicePeriodStart ? toIsoDate(skip.servicePeriodStart) : null,\n    service_period_end: skip.servicePeriodEnd ? toIsoDate(skip.servicePeriodEnd) : null,\n  }\n}\n\nfunction toCharge(descriptor: InvoiceLineDescriptor, kind: 'charge' | 'credit', taxPoint: PrepaidTaxPoint): ChargeLine {\n  return {\n    descriptor,\n    amounts: resolvePrepaidDebit({\n      lineAmount: descriptor.lineAmount,\n      priceBasis: descriptor.priceBasis,\n      taxRate: descriptor.taxRate,\n      taxPoint,\n    }),\n    sourceRef: chargeSourceRef(descriptor, kind),\n  }\n}\n\nexport async function processPrepaidAccount(\n  em: EntityManager,\n  account: BillingAccount,\n  billRun: BillingRun,\n  params: ProcessPrepaidParams,\n): Promise<PrepaidAccountResult> {\n  const scope = { tenantId: account.tenantId, organizationId: account.organizationId }\n  const cycle = account.billCycle as BillCycle\n  const balanceRow = await em.findOne(BillingAccountBalance, {\n    tenantId: account.tenantId,\n    billAccountId: account.id,\n  })\n  const ctx: CycleContext = {\n    mode: params.mode,\n    taxPoint: await getPrepaidTaxPoint(em, scope),\n    statementEnabled: await getStatementEnabled(em, scope),\n    threshold: resolveLowBalanceThreshold(\n      balanceRow?.lowBalanceThreshold ?? null,\n      await getLowBalanceThresholdDefault(em, scope),\n    ),\n    nearLimitBuffer: await getNearLimitBufferDefault(em, scope),\n    creditLimit: account.creditLimit ?? '0',\n  }\n\n  const items = (await em.find(BillingItem, {\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    billAccountId: account.id,\n    deletedAt: null,\n  } as never)) as BillingItem[]\n  const recurringItems = items.filter((it) => it.type === 'recurring')\n  const oneTimeItems = items.filter((it) => it.type === 'one_time')\n\n  // In-memory cycle state \u2014 persisted per cycle only in real mode.\n  const watermarks = new Map<string, Date | null>(\n    recurringItems.map((it) => [it.id, it.billedToDate ? toUtcMidnight(it.billedToDate) : null]),\n  )\n  const billedOneTimes = new Set<string>(oneTimeItems.filter((it) => it.billedToDate).map((it) => it.id))\n  let billDate = toUtcMidnight(account.nextBillDate)\n  // Chain opening \u2192 closing across cycles. Null on the first cycle \u2192\n  // resolved from the prior statement / ledger.\n  let previousClosing: string | null = null\n\n  const cycles: PrepaidCycleRecord[] = []\n  const skippedItems: PrepaidSkippedItem[] = []\n  const warnings: PrepaidAccountWarnings = {}\n  const statementEvents: DomainEvent[] = []\n  let lastStatementId: string | null = null\n\n  const pushSkips = (skips: readonly RecurringSkip[]) => {\n    for (const skip of skips) {\n      if (QUIET_SKIP_REASONS.has(skip.reason)) continue\n      if (skippedItems.length < SKIPPED_ITEMS_WARNING_CAP) skippedItems.push(toSkipWarning(skip))\n    }\n  }\n\n  while (isCycleDue(billDate, params.asOfDate)) {\n    if (cycles.length >= CATCH_UP_HARD_CAP) {\n      warnings.catch_up_cap_reached = true\n      break\n    }\n    const nextBillDate = advanceNextBillDate(billDate, cycle)\n    const period = deriveBillPeriod(billDate, cycle)\n\n    // \u2500\u2500 Recurring: service periods against the in-memory watermarks \u2500\u2500\n    const charges: ChargeLine[] = []\n    const watermarkUpdates = new Map<string, Date | null>()\n    for (const item of recurringItems) {\n      const unitPrice = (item.rateJson as { unit_price?: number } | null)?.unit_price\n      if (typeof unitPrice !== 'number') continue\n      const computed = computeRecurringLines(\n        {\n          id: item.id,\n          chargeTiming: item.chargeTiming ?? 'in_advance',\n          prorate: item.prorate ?? true,\n          billStartDate: item.billStartDate,\n          billEndDate: item.billEndDate ?? null,\n          billedToDate: watermarks.get(item.id) ?? null,\n          unitPrice,\n          isActive: item.isActive,\n          deletedAt: item.deletedAt ?? null,\n        },\n        { billDate, cycle },\n      )\n      pushSkips(computed.skipped)\n      if (computed.newBilledToDate?.getTime() !== watermarks.get(item.id)?.getTime()) {\n        watermarkUpdates.set(item.id, computed.newBilledToDate)\n      }\n      const descriptors = buildRecurringLineDescriptors(item, computed.lines)\n      descriptors.forEach((descriptor, index) => {\n        charges.push(toCharge(descriptor, computed.lines[index]?.kind ?? 'charge', ctx.taxPoint))\n      })\n    }\n\n    // \u2500\u2500 One-time: first bill date whose [D \u2212 cycle, D + cycle \u2212 1] window\n    //    overlaps (same rule as postpaid) \u2500\u2500\n    const oneTimeWindow: BillPeriod = {\n      periodStart: shiftCycles(billDate, cycle, -1),\n      periodEnd: addDays(nextBillDate, -1),\n    }\n    const oneTimesThisCycle = oneTimeItems.filter(\n      (it) => !billedOneTimes.has(it.id) && shouldIncludeItem(it as SelectableItem, oneTimeWindow).include,\n    )\n    for (const descriptor of buildInvoiceLinesFromItems(oneTimesThisCycle)) {\n      charges.push(toCharge(descriptor, 'charge', ctx.taxPoint))\n    }\n\n    const closed = await closePrepaidPeriod(em, account, billRun, { billDate, period, charges, previousClosing }, ctx)\n    previousClosing = closed.closingBalance\n    statementEvents.push(...closed.events)\n    if (closed.statementId) lastStatementId = closed.statementId\n    cycles.push(closed.record)\n\n    // Advance the in-memory state (every mode); persist in real mode only.\n    for (const [itemId, watermark] of watermarkUpdates) watermarks.set(itemId, watermark)\n    for (const item of oneTimesThisCycle) billedOneTimes.add(item.id)\n    if (params.mode === 'real') {\n      const now = new Date()\n      for (const item of recurringItems) {\n        if (!watermarkUpdates.has(item.id)) continue\n        item.billedToDate = watermarkUpdates.get(item.id) ?? null\n        item.updatedAt = now\n      }\n      for (const item of oneTimesThisCycle) {\n        item.billedToDate = period.periodEnd\n        item.updatedAt = now\n      }\n      account.nextBillDate = nextBillDate\n      account.lastBillDate = period.periodEnd\n      account.updatedAt = now\n      await em.flush()\n    }\n    billDate = nextBillDate\n  }\n\n  const finalWarnings: PrepaidAccountWarnings = {\n    ...warnings,\n    ...(skippedItems.length ? { skipped_items: skippedItems } : {}),\n  }\n  return {\n    status: warnings.catch_up_cap_reached ? 'success_with_warnings' : 'success',\n    warnings: Object.keys(finalWarnings).length ? finalWarnings : null,\n    statementId: lastStatementId,\n    cyclesEmitted: cycles.filter((c) => c.status === 'charged' || c.status === 'previewed').length,\n    cycles,\n    statementEvents,\n  }\n}\n\ntype ClosePeriodInput = {\n  billDate: Date\n  period: BillPeriod\n  charges: ChargeLine[]\n  previousClosing: string | null\n}\n\ntype ClosePeriodResult = {\n  record: PrepaidCycleRecord\n  /** The statement CREATED by this close (null when skipped or not written). */\n  statementId: string | null\n  closingBalance: string\n  events: DomainEvent[]\n}\n\ntype DebitBreakdownEntry = {\n  billing_item_id: string\n  billing_type: string\n  description: string\n  quantity: string\n  /** What left the balance (kept as `amount` for older statement readers). */\n  amount: string\n  net: string\n  tax: string\n  tax_rate: string\n  service_period_start: string | null\n  service_period_end: string | null\n  proration: unknown\n}\n\nasync function closePrepaidPeriod(\n  em: EntityManager,\n  account: BillingAccount,\n  billRun: BillingRun,\n  input: ClosePeriodInput,\n  ctx: CycleContext,\n): Promise<ClosePeriodResult> {\n  const { period, charges } = input\n  const periodStartIso = toIsoDate(period.periodStart)\n  const periodEndIso = toIsoDate(period.periodEnd)\n\n  // Statement anti-duplicate (real only \u2014 test / dry never write statements).\n  // Date-only parameters go as ISO strings (P-D5).\n  const existingStatement =\n    ctx.mode === 'real'\n      ? await em.findOne(BillingStatement, {\n          tenantId: account.tenantId,\n          billAccountId: account.id,\n          periodStart: periodStartIso,\n          periodEnd: periodEndIso,\n        } as never)\n      : null\n\n  // Ledger window of this statement: (previous bill date, this bill date] \u2014\n  // i.e. from the day after the previous bill date up to and including the\n  // bill date D itself. Charges are taken AT D, so money that arrives on D\n  // (a top-up made on the bill date) belongs to the same statement as the\n  // charges \u2014 never an opening balance that pretends the account was short.\n  // Consecutive windows stay contiguous: [D_prev + 1, D + 1).\n  const windowStart = addDays(period.periodStart, 1)\n  const windowEnd = addDays(input.billDate, 1) // exclusive upper bound\n  const openingBalance = await resolveOpeningBalance(em, account, windowStart, period, input.previousClosing)\n  const totalTopups = await sumByTypeInWindow(em, account, 'topup', windowStart, windowEnd)\n  const totalUsage = absMoney(await sumByTypeInWindow(em, account, 'usage', windowStart, windowEnd))\n  // Manual adjustments / reversals in the window \u2014 SIGNED. A first-class term\n  // so the statement stays self-consistent and the chain never drifts.\n  const totalAdjustments = addMoney(\n    await sumByTypeInWindow(em, account, 'adjustment', windowStart, windowEnd),\n    await sumByTypeInWindow(em, account, 'reversal', windowStart, windowEnd),\n  )\n\n  let totalRecurring = '0.0000'\n  let totalNet = '0.0000'\n  const breakdown: DebitBreakdownEntry[] = []\n  const chargeTransactionIds: string[] = []\n  let balanceBefore: string | null = null\n  let balanceAfter: string | null = null\n\n  for (const charge of charges) {\n    const { descriptor, amounts } = charge\n    const debit = money4(amounts.debit)\n    totalRecurring = addMoney(totalRecurring, debit)\n    totalNet = addMoney(totalNet, money4(amounts.net))\n    const metadata = {\n      bill_date: toIsoDate(input.billDate),\n      bill_period_start: periodStartIso,\n      bill_period_end: periodEndIso,\n      bill_run_id: billRun.id,\n      service_period_start: descriptor.servicePeriodStart ? toIsoDate(descriptor.servicePeriodStart) : null,\n      service_period_end: descriptor.servicePeriodEnd ? toIsoDate(descriptor.servicePeriodEnd) : null,\n      net: money4(amounts.net),\n      tax: money4(amounts.tax),\n      tax_rate: String(amounts.taxRate),\n      tax_point: ctx.taxPoint,\n      ...(descriptor.metadataExtra ?? {}),\n    }\n    breakdown.push({\n      billing_item_id: descriptor.billingItemId,\n      billing_type: descriptor.billingType,\n      description: descriptor.description,\n      quantity: descriptor.quantity,\n      amount: debit,\n      net: metadata.net,\n      tax: metadata.tax,\n      tax_rate: metadata.tax_rate,\n      service_period_start: metadata.service_period_start,\n      service_period_end: metadata.service_period_end,\n      proration: (descriptor.metadataExtra as { proration?: unknown } | undefined)?.proration ?? null,\n    })\n    if (ctx.mode !== 'real') continue\n    const movement = await applyBalanceMovement(em, {\n      organizationId: account.organizationId,\n      tenantId: account.tenantId,\n      billAccountId: account.id,\n      currencyCode: account.currencyCode,\n      // Credits back (an item ended inside a charged period) stay typed as the\n      // charge they reverse: adjustments are summed by date window on\n      // statements and would be counted twice.\n      type: descriptor.billingType === 'one_time' ? 'one_time' : 'recurring',\n      amount: fromUnits(-toUnits(debit)),\n      description: descriptor.description,\n      billingItemId: descriptor.billingItemId,\n      sourceRef: charge.sourceRef,\n      metadata,\n    })\n    if (balanceBefore === null) balanceBefore = movement.balanceBefore\n    balanceAfter = movement.balanceAfter\n    if (!movement.deduplicated) chargeTransactionIds.push(movement.transaction.id)\n  }\n  if (ctx.mode === 'real' && charges.length > 0) await em.flush()\n\n  // closing = opening + top-ups + adjustments \u2212 usage \u2212 charges.\n  const closingBalance = subMoney(\n    subMoney(addMoney(addMoney(openingBalance, totalTopups), totalAdjustments), totalUsage),\n    totalRecurring,\n  )\n  const vatSummary: VatSummaryRow[] = buildVatSummary(\n    charges.map((c) => c.amounts),\n    ctx.taxPoint,\n  )\n\n  const events: DomainEvent[] =\n    balanceBefore !== null && balanceAfter !== null\n      ? buildBalanceCrossingEvents({\n          scope: {\n            billAccountId: account.id,\n            tenantId: account.tenantId,\n            organizationId: account.organizationId,\n            currencyCode: account.currencyCode,\n          },\n          balanceBefore,\n          balanceAfter,\n          threshold: ctx.threshold,\n          creditLimit: ctx.creditLimit,\n          nearLimitBuffer: ctx.nearLimitBuffer,\n        })\n      : []\n\n  let createdStatementId: string | null = null\n  if (ctx.mode === 'real' && ctx.statementEnabled && !existingStatement) {\n    const now = new Date()\n    const statement = em.create(BillingStatement, {\n      organizationId: account.organizationId,\n      tenantId: account.tenantId,\n      billAccountId: account.id,\n      billRunId: billRun.id,\n      periodStart: period.periodStart,\n      periodEnd: period.periodEnd,\n      currencyCode: account.currencyCode,\n      openingBalance,\n      totalTopups,\n      totalUsage,\n      totalRecurring,\n      totalAdjustments,\n      closingBalance,\n      debitBreakdown: { items: breakdown, bill_date: toIsoDate(input.billDate), tax_point: ctx.taxPoint },\n      vatSummary,\n      status: 'generated',\n      createdAt: now,\n      updatedAt: now,\n    })\n    em.persist(statement)\n    await em.flush()\n    createdStatementId = statement.id\n    if (chargeTransactionIds.length > 0) {\n      await em.nativeUpdate(\n        BillingAccountTransaction,\n        { id: { $in: chargeTransactionIds } } as never,\n        { statementId: createdStatementId } as never,\n      )\n    }\n    events.push({\n      id: 'billing.statement.generated',\n      payload: {\n        statementId: createdStatementId,\n        billAccountId: account.id,\n        tenantId: account.tenantId,\n        organizationId: account.organizationId,\n        billRunId: billRun.id,\n        periodStart: periodStartIso,\n        periodEnd: periodEndIso,\n        currencyCode: account.currencyCode,\n        openingBalance,\n        closingBalance,\n        totalTopups,\n        totalUsage,\n        totalRecurring,\n        totalAdjustments,\n      },\n    })\n  }\n\n  let status: PrepaidCycleStatus\n  if (ctx.mode !== 'real') status = charges.length > 0 ? 'previewed' : 'empty'\n  else if (existingStatement && chargeTransactionIds.length === 0) status = 'skipped_existing'\n  else status = chargeTransactionIds.length > 0 ? 'charged' : 'empty'\n\n  return {\n    record: {\n      bill_date: toIsoDate(input.billDate),\n      period_start: periodStartIso,\n      period_end: periodEndIso,\n      status,\n      line_count: charges.length,\n      total_net: totalNet,\n      total_debit: totalRecurring,\n      invoice_id: null,\n      statement_id: createdStatementId ?? existingStatement?.id ?? null,\n    },\n    statementId: createdStatementId,\n    closingBalance,\n    events,\n  }\n}\n\n/**\n * Resolve a period's opening balance by chaining from the prior statement's\n * closing (the spec's \"chains cleanly\"), with a ledger fallback for the very\n * first statement. Charges are stamped at run time (after the window), so a\n * `SUM(amount WHERE created_at < period_start)` would drop the prior\n * period's charges and break the chain. Resolution order:\n *   1. previous cycle's closing (catch-up, in this run),\n *   2. the prior persisted statement's closing (month-over-month),\n *   3. the ledger balance before the first-ever statement window.\n */\nasync function resolveOpeningBalance(\n  em: EntityManager,\n  account: BillingAccount,\n  windowStart: Date,\n  period: BillPeriod,\n  previousClosing: string | null,\n): Promise<string> {\n  if (previousClosing !== null) return previousClosing\n  const prior = await em.findOne(\n    BillingStatement,\n    {\n      tenantId: account.tenantId,\n      organizationId: account.organizationId,\n      billAccountId: account.id,\n      periodEnd: { $lt: toIsoDate(period.periodStart) },\n    } as never,\n    { orderBy: { periodEnd: 'DESC' } },\n  )\n  if (prior) return fromUnits(toUnits(prior.closingBalance))\n  // First-ever statement: the ledger balance just before its window (only\n  // top-ups / usage exist before the first close, so created_at is safe).\n  return sumAmountsBefore(em, account, windowStart)\n}\n\n/** Balance at `before` = SUM(amount) of transactions created strictly before it. */\nasync function sumAmountsBefore(em: EntityManager, account: BillingAccount, before: Date): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(amount), 0) AS total\n       FROM billing_account_transactions\n      WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n        AND deleted_at IS NULL AND created_at < ?`,\n    [account.tenantId, account.organizationId, account.id, before],\n  )) as unknown as Array<{ total: string }>\n  return fromUnits(toUnits(rows?.[0]?.total ?? 0))\n}\n\n/** SUM(amount) for one transaction type within [from, to). */\nasync function sumByTypeInWindow(\n  em: EntityManager,\n  account: BillingAccount,\n  type: string,\n  from: Date,\n  to: Date,\n): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(amount), 0) AS total\n       FROM billing_account_transactions\n      WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n        AND deleted_at IS NULL AND type = ?\n        AND created_at >= ? AND created_at < ?`,\n    [account.tenantId, account.organizationId, account.id, type, from, to],\n  )) as unknown as Array<{ total: string }>\n  return fromUnits(toUnits(rows?.[0]?.total ?? 0))\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/lib/prepaidTaxPoint.js

@@ -0,0 +1,37 @@
+import { lineVat } from "./lineAmounts.js";
+import { round2 } from "./vat.js";
+function toNumber(value) {
+  const n = typeof value === "number" ? value : Number.parseFloat(value);
+  return Number.isFinite(n) ? n : 0;
+}
+function resolvePrepaidDebit(input) {
+  if (input.taxPoint === "topup") {
+    const amount = round2(toNumber(input.lineAmount));
+    return { debit: amount, net: amount, tax: 0, taxRate: 0 };
+  }
+  const rate = Math.max(0, toNumber(input.taxRate));
+  const vat = lineVat({ amount: input.lineAmount, priceBasis: input.priceBasis, taxRate: rate });
+  return { debit: vat.gross, net: vat.net, tax: vat.tax, taxRate: rate };
+}
+function buildVatSummary(debits, taxPoint) {
+  if (taxPoint === "topup") return [];
+  const byRate = /* @__PURE__ */ new Map();
+  for (const debit of debits) {
+    const row = byRate.get(debit.taxRate) ?? { net: 0, tax: 0, gross: 0 };
+    row.net = round2(row.net + debit.net);
+    row.tax = round2(row.tax + debit.tax);
+    row.gross = round2(row.gross + debit.debit);
+    byRate.set(debit.taxRate, row);
+  }
+  return Array.from(byRate.entries()).sort(([a], [b]) => b - a).map(([rate, row]) => ({
+    rate: String(rate),
+    net: row.net.toFixed(4),
+    tax: row.tax.toFixed(4),
+    gross: row.gross.toFixed(4)
+  }));
+}
+export {
+  buildVatSummary,
+  resolvePrepaidDebit
+};
+//# sourceMappingURL=prepaidTaxPoint.js.map

package/dist/modules/billing/lib/prepaidTaxPoint.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/prepaidTaxPoint.ts"],
+  "sourcesContent": ["import { lineVat, type PriceBasis } from './lineAmounts'\nimport { round2 } from './vat'\n\n/**\n * Prepaid tax point (Spec F, F-D3 / P-D10) \u2014 how much a prepaid charge takes\n * from the balance. Shared by the Bill Run period close and real-time usage\n * consumption so the two paths can never drift apart.\n *\n *   - `topup` (default): VAT was charged on the top-up receipt, so the\n *     balance holds VAT-inclusive money and the item amount is debited as\n *     entered (`debit = net = amount`, `tax = 0`). The item's VAT rate and\n *     price basis do not apply.\n *   - `consumption`: the receipt carried no VAT; each debit is the line's\n *     gross at the item's rate and basis (`lineVat`).\n */\n\nexport type PrepaidTaxPoint = 'topup' | 'consumption'\n\nexport type PrepaidDebitInput = {\n  /** Extended line amount on `priceBasis` (negative for credits). */\n  lineAmount: number | string\n  priceBasis: PriceBasis\n  /** Item VAT rate in percent. */\n  taxRate: number | string\n  taxPoint: PrepaidTaxPoint\n}\n\nexport type PrepaidDebit = {\n  /** What leaves the balance (positive charge, negative credit back). */\n  debit: number\n  net: number\n  tax: number\n  /** VAT rate applied (0 in `topup` mode). */\n  taxRate: number\n}\n\nfunction toNumber(value: number | string): number {\n  const n = typeof value === 'number' ? value : Number.parseFloat(value)\n  return Number.isFinite(n) ? n : 0\n}\n\nexport function resolvePrepaidDebit(input: PrepaidDebitInput): PrepaidDebit {\n  if (input.taxPoint === 'topup') {\n    const amount = round2(toNumber(input.lineAmount))\n    return { debit: amount, net: amount, tax: 0, taxRate: 0 }\n  }\n  const rate = Math.max(0, toNumber(input.taxRate))\n  const vat = lineVat({ amount: input.lineAmount, priceBasis: input.priceBasis, taxRate: rate })\n  return { debit: vat.gross, net: vat.net, tax: vat.tax, taxRate: rate }\n}\n\nexport type VatSummaryRow = { rate: string; net: string; tax: string; gross: string }\n\n/**\n * Per-rate VAT summary of a set of prepaid debits (statement `vat_summary`).\n * Empty when no debit carried VAT information (`topup` mode).\n */\nexport function buildVatSummary(debits: ReadonlyArray<PrepaidDebit>, taxPoint: PrepaidTaxPoint): VatSummaryRow[] {\n  if (taxPoint === 'topup') return []\n  const byRate = new Map<number, { net: number; tax: number; gross: number }>()\n  for (const debit of debits) {\n    const row = byRate.get(debit.taxRate) ?? { net: 0, tax: 0, gross: 0 }\n    row.net = round2(row.net + debit.net)\n    row.tax = round2(row.tax + debit.tax)\n    row.gross = round2(row.gross + debit.debit)\n    byRate.set(debit.taxRate, row)\n  }\n  return Array.from(byRate.entries())\n    .sort(([a], [b]) => b - a)\n    .map(([rate, row]) => ({\n      rate: String(rate),\n      net: row.net.toFixed(4),\n      tax: row.tax.toFixed(4),\n      gross: row.gross.toFixed(4),\n    }))\n}\n"],
+  "mappings": "AAAA,SAAS,eAAgC;AACzC,SAAS,cAAc;AAmCvB,SAAS,SAAS,OAAgC;AAChD,QAAM,IAAI,OAAO,UAAU,WAAW,QAAQ,OAAO,WAAW,KAAK;AACrE,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAEO,SAAS,oBAAoB,OAAwC;AAC1E,MAAI,MAAM,aAAa,SAAS;AAC9B,UAAM,SAAS,OAAO,SAAS,MAAM,UAAU,CAAC;AAChD,WAAO,EAAE,OAAO,QAAQ,KAAK,QAAQ,KAAK,GAAG,SAAS,EAAE;AAAA,EAC1D;AACA,QAAM,OAAO,KAAK,IAAI,GAAG,SAAS,MAAM,OAAO,CAAC;AAChD,QAAM,MAAM,QAAQ,EAAE,QAAQ,MAAM,YAAY,YAAY,MAAM,YAAY,SAAS,KAAK,CAAC;AAC7F,SAAO,EAAE,OAAO,IAAI,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,SAAS,KAAK;AACvE;AAQO,SAAS,gBAAgB,QAAqC,UAA4C;AAC/G,MAAI,aAAa,QAAS,QAAO,CAAC;AAClC,QAAM,SAAS,oBAAI,IAAyD;AAC5E,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,OAAO,IAAI,MAAM,OAAO,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,EAAE;AACpE,QAAI,MAAM,OAAO,IAAI,MAAM,MAAM,GAAG;AACpC,QAAI,MAAM,OAAO,IAAI,MAAM,MAAM,GAAG;AACpC,QAAI,QAAQ,OAAO,IAAI,QAAQ,MAAM,KAAK;AAC1C,WAAO,IAAI,MAAM,SAAS,GAAG;AAAA,EAC/B;AACA,SAAO,MAAM,KAAK,OAAO,QAAQ,CAAC,EAC/B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,EACxB,IAAI,CAAC,CAAC,MAAM,GAAG,OAAO;AAAA,IACrB,MAAM,OAAO,IAAI;AAAA,IACjB,KAAK,IAAI,IAAI,QAAQ,CAAC;AAAA,IACtB,KAAK,IAAI,IAAI,QAAQ,CAAC;AAAA,IACtB,OAAO,IAAI,MAAM,QAAQ,CAAC;AAAA,EAC5B,EAAE;AACN;",
+  "names": []
+}

package/dist/modules/billing/lib/seeds/demo.js

@@ -1,4 +1,5 @@
 import { BillingAccount, BillingItem, BillingAccountUsage } from "../../data/entities.js";
+import { DEFAULT_DEMO_SELLER, applySellerDefaults } from "./sellerSettings.js";
 const SRC = "demo-billing";
 const ACCOUNT_NAME_PREFIX = "Demo \u2014 ";
 const ACCOUNTS = [
@@ -11,7 +12,15 @@ const ACCOUNTS = [
     },
     items: [
       { ref: `${SRC}-nw-rec`, type: "recurring", description: "Platform subscription (monthly)", unitPrice: 199 },
-      { ref: `${SRC}-nw-usg`, type: "usage", description: "Data transfer (per GB)", unitPrice: 0.5, uomCode: "gb" }
+      {
+        ref: `${SRC}-nw-addon`,
+        type: "recurring",
+        description: "Priority support add-on (monthly)",
+        unitPrice: 60,
+        taxRate: "8",
+        start: "prevMonthMid"
+      },
+      { ref: `${SRC}-nw-usg`, type: "usage", description: "Data transfer (per GB)", unitPrice: 0.5, uomCode: "gb", start: "prevMonth" }
     ],
     usage: [
       { ref: `${SRC}-nw-usage`, uomCode: "gb", quantity: 120, lineDescription: "Data transfer (prev. month)" }
@@ -25,7 +34,38 @@ const ACCOUNTS = [
       invoiceLanguage: "en"
     },
     items: [
-      { ref: `${SRC}-gx-rec`, type: "recurring", description: "Cloud plan (monthly)", unitPrice: 49 }
+      { ref: `${SRC}-gx-rec`, type: "recurring", description: "Cloud plan (monthly)", unitPrice: 49 },
+      {
+        ref: `${SRC}-gx-arr`,
+        type: "recurring",
+        description: "Managed backups (billed in arrears)",
+        unitPrice: 15,
+        // 0 % — shows a mixed-rate VAT summary on the document.
+        taxRate: "0",
+        chargeTiming: "in_arrears",
+        start: "prevMonth"
+      }
+    ],
+    usage: []
+  },
+  {
+    // B2C: a private person on a flat monthly internet plan, invoiced in Polish.
+    account: {
+      name: `${ACCOUNT_NAME_PREFIX}Jan Kowalski`,
+      customerId: "demo-cust-jan-kowalski",
+      customerKind: "person",
+      currencyCode: "PLN",
+      invoiceLanguage: "pl"
+    },
+    items: [
+      // B2C price quoted gross (79.00 PLN incl. 23 % VAT) — Spec F, F-D2.
+      {
+        ref: `${SRC}-jk-rec`,
+        type: "recurring",
+        description: "Internet 300 Mb/s (miesi\u0119cznie)",
+        unitPrice: 79,
+        priceBasis: "gross"
+      }
     ],
     usage: []
   }
@@ -50,7 +90,10 @@ async function seedBillingDemo(em, scope, options = {}) {
   const nextBillDate = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1));
   const prevMonthStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 1));
   const prevMonthEnd = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 0));
+  const prevMonthMid = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 15));
+  const startFor = (item) => item.start === "prevMonth" ? prevMonthStart : item.start === "prevMonthMid" ? prevMonthMid : nextBillDate;
   const result = { accountsCreated: 0, itemsCreated: 0, usageCreated: 0 };
+  await applySellerDefaults(em, scope, DEFAULT_DEMO_SELLER);
   for (const spec of ACCOUNTS) {
     let account = await em.findOne(BillingAccount, {
       ...scope,
@@ -61,6 +104,7 @@ async function seedBillingDemo(em, scope, options = {}) {
       account = em.create(BillingAccount, {
         ...scope,
         customerId: spec.account.customerId,
+        customerKind: spec.account.customerKind ?? "company",
         name: spec.account.name,
         currencyCode: spec.account.currencyCode,
         billCycle: "monthly",
@@ -85,8 +129,12 @@ async function seedBillingDemo(em, scope, options = {}) {
           ...scope,
           billAccountId: account.id,
           type: item.type,
-          billStartDate: prevMonthStart,
+          billStartDate: startFor(item),
           billEndDate: null,
+          chargeTiming: item.chargeTiming ?? "in_advance",
+          prorate: true,
+          taxRate: item.taxRate ?? "23",
+          priceBasis: item.priceBasis ?? "net",
           description: item.description,
           rateJson: { unit_price: item.unitPrice },
           uomCode: item.uomCode ?? null,

package/dist/modules/billing/lib/seeds/demo.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/billing/lib/seeds/demo.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingAccount, BillingItem, BillingAccountUsage } from '../../data/entities'\n\n/**\n * Self-contained billing test-data seed.\n *\n * Creates a couple of demo billing accounts with recurring + usage items\n * and one unrated usage record, scoped to a single tenant. Everything is\n * idempotent: accounts are matched by name, items/usage by `source_ref`,\n * so re-running is a no-op rather than a duplicate.\n *\n * The accounts are dated so they are immediately billable: `next_bill_date`\n * is the 1st of the current month, which makes a Bill Run with the default\n * (today's) as-of date produce an invoice for the previous month \u2014 the usage\n * record is seeded into exactly that period.\n *\n * Drives `mercato billing seed`. Kept free of any customer-specific data so\n * it ships with `@dainamite/billing`.\n */\n\nexport type BillingDemoScope = { tenantId: string; organizationId: string }\nexport type BillingDemoResult = {\n  accountsCreated: number\n  itemsCreated: number\n  usageCreated: number\n}\n\n// Shared prefix for every row this seed owns \u2014 the reset path keys off it.\nconst SRC = 'demo-billing'\nconst ACCOUNT_NAME_PREFIX = 'Demo \u2014 '\n\ntype DemoAccountSpec = {\n  name: string\n  customerId: string\n  currencyCode: string\n  invoiceLanguage: string\n}\n\ntype DemoItemSpec = {\n  ref: string\n  type: 'recurring' | 'usage'\n  description: string\n  unitPrice: number\n  uomCode?: string\n}\n\ntype DemoUsageSpec = {\n  ref: string\n  uomCode: string\n  quantity: number\n  lineDescription: string\n}\n\nconst ACCOUNTS: Array<{\n  account: DemoAccountSpec\n  items: DemoItemSpec[]\n  usage: DemoUsageSpec[]\n}> = [\n  {\n    account: {\n      name: `${ACCOUNT_NAME_PREFIX}Northwind Telecom`,\n      customerId: 'demo-cust-northwind',\n      currencyCode: 'PLN',\n      invoiceLanguage: 'en',\n    },\n    items: [\n      { ref: `${SRC}-nw-rec`, type: 'recurring', description: 'Platform subscription (monthly)', unitPrice: 199 },\n      { ref: `${SRC}-nw-usg`, type: 'usage', description: 'Data transfer (per GB)', unitPrice: 0.5, uomCode: 'gb' },\n    ],\n    usage: [\n      { ref: `${SRC}-nw-usage`, uomCode: 'gb', quantity: 120, lineDescription: 'Data transfer (prev. month)' },\n    ],\n  },\n  {\n    account: {\n      name: `${ACCOUNT_NAME_PREFIX}Globex Cloud`,\n      customerId: 'demo-cust-globex',\n      currencyCode: 'EUR',\n      invoiceLanguage: 'en',\n    },\n    items: [\n      { ref: `${SRC}-gx-rec`, type: 'recurring', description: 'Cloud plan (monthly)', unitPrice: 49 },\n    ],\n    usage: [],\n  },\n]\n\n/** Delete every row this seed owns within the scope (reset before re-seed). */\nexport async function resetBillingDemo(em: EntityManager, scope: BillingDemoScope): Promise<void> {\n  await em.nativeDelete(BillingAccountUsage, {\n    ...scope,\n    sourceRef: { $like: `${SRC}-%` },\n  } as never)\n  await em.nativeDelete(BillingItem, {\n    ...scope,\n    sourceRef: { $like: `${SRC}-%` },\n  } as never)\n  await em.nativeDelete(BillingAccount, {\n    ...scope,\n    name: { $like: `${ACCOUNT_NAME_PREFIX}%` },\n  } as never)\n}\n\nexport async function seedBillingDemo(\n  em: EntityManager,\n  scope: BillingDemoScope,\n  options: { reset?: boolean; now?: Date } = {},\n): Promise<BillingDemoResult> {\n  if (options.reset) await resetBillingDemo(em, scope)\n\n  const now = options.now ?? new Date()\n  // Bill period the next run will cover, given next_bill = 1st of this month:\n  //   periodStart = 1st of previous month, periodEnd = last day of previous month.\n  // Build at UTC midnight so `date` columns don't drift a day under a positive\n  // local UTC offset (local `new Date(y, m, 1)` would persist as the prev day).\n  const nextBillDate = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1))\n  const prevMonthStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 1))\n  const prevMonthEnd = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 0))\n\n  const result: BillingDemoResult = { accountsCreated: 0, itemsCreated: 0, usageCreated: 0 }\n\n  for (const spec of ACCOUNTS) {\n    // \u2500\u2500 Account (idempotent by name within scope) \u2500\u2500\n    let account = await em.findOne(BillingAccount, {\n      ...scope,\n      name: spec.account.name,\n      deletedAt: null,\n    } as never)\n    if (!account) {\n      account = em.create(BillingAccount, {\n        ...scope,\n        customerId: spec.account.customerId,\n        name: spec.account.name,\n        currencyCode: spec.account.currencyCode,\n        billCycle: 'monthly',\n        billCycleAnchor: '1',\n        invoiceEmail: `billing@${spec.account.customerId}.demo`,\n        invoiceLanguage: spec.account.invoiceLanguage,\n        taxId: null,\n        invoiceAddress: { line1: 'ul. Demo 1', city: 'Warszawa', postal_code: '00-001', country: 'PL' },\n        nextBillDate,\n        lastBillDate: null,\n        isActive: true,\n      })\n      em.persist(account)\n      await em.flush() // need the id for child rows\n      result.accountsCreated += 1\n    }\n\n    // \u2500\u2500 Items (idempotent by source_ref) \u2500\u2500\n    for (const item of spec.items) {\n      const existing = await em.findOne(BillingItem, { ...scope, sourceRef: item.ref } as never)\n      if (existing) continue\n      em.persist(\n        em.create(BillingItem, {\n          ...scope,\n          billAccountId: account.id,\n          type: item.type,\n          billStartDate: prevMonthStart,\n          billEndDate: null,\n          description: item.description,\n          rateJson: { unit_price: item.unitPrice },\n          uomCode: item.uomCode ?? null,\n          subscriptionId: null,\n          subscriptionItemId: null,\n          sourceRef: item.ref,\n          currencyMismatch: false,\n          billedToDate: null,\n          isActive: true,\n        }),\n      )\n      result.itemsCreated += 1\n    }\n\n    // \u2500\u2500 Usage records (idempotent by source_ref) \u2500\u2500\n    for (const u of spec.usage) {\n      const existing = await em.findOne(BillingAccountUsage, { ...scope, sourceRef: u.ref } as never)\n      if (existing) continue\n      em.persist(\n        em.create(BillingAccountUsage, {\n          ...scope,\n          billAccountId: account.id,\n          uomCode: u.uomCode,\n          quantity: u.quantity.toFixed(4),\n          periodStart: prevMonthStart,\n          periodEnd: prevMonthEnd,\n          lineDescription: u.lineDescription,\n          sourceRef: u.ref,\n          ratedInBillRunId: null,\n          isActive: true,\n        }),\n      )\n      result.usageCreated += 1\n    }\n  }\n\n  await em.flush()\n  return result\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingAccount, BillingItem, BillingAccountUsage } from '../../data/entities'\nimport type { CustomerKind } from '../../data/validators'\nimport type { InvoiceLanguageCode } from '../invoiceLanguages'\nimport { DEFAULT_DEMO_SELLER, applySellerDefaults } from './sellerSettings'\n\n/**\n * Self-contained billing test-data seed.\n *\n * Creates a couple of demo billing accounts with recurring + usage items\n * and one unrated usage record, scoped to a single tenant. Everything is\n * idempotent: accounts are matched by name, items/usage by `source_ref`,\n * so re-running is a no-op rather than a duplicate.\n *\n * The accounts are dated so they are immediately billable: `next_bill_date`\n * is the 1st of the current month. A Bill Run with the default (today's)\n * as-of date then shows every Spec A behaviour on one invoice per account:\n *   - recurring items billed IN ADVANCE for this month (the default);\n *   - Globex's in-arrears item billed for last month;\n *   - Northwind's mid-cycle add-on: a prorated stub for the second half of\n *     last month plus this month;\n *   - usage (always in arrears) for last month.\n *\n * Drives `mercato billing seed`. Kept free of any customer-specific data so\n * it ships with `@dainamite/billing`.\n */\n\nexport type BillingDemoScope = { tenantId: string; organizationId: string }\nexport type BillingDemoResult = {\n  accountsCreated: number\n  itemsCreated: number\n  usageCreated: number\n}\n\n// Shared prefix for every row this seed owns \u2014 the reset path keys off it.\nconst SRC = 'demo-billing'\nconst ACCOUNT_NAME_PREFIX = 'Demo \u2014 '\n\ntype DemoAccountSpec = {\n  name: string\n  customerId: string\n  // Spec E: 'person' = a B2C account. Omitted \u2192 'company'.\n  customerKind?: CustomerKind\n  currencyCode: string\n  invoiceLanguage: InvoiceLanguageCode\n}\n\ntype DemoItemSpec = {\n  ref: string\n  type: 'recurring' | 'usage'\n  description: string\n  unitPrice: number\n  uomCode?: string\n  // Spec B: VAT %. Default 23 (PL standard rate).\n  taxRate?: string\n  // Spec A. Default 'in_advance'.\n  chargeTiming?: 'in_advance' | 'in_arrears'\n  // Spec F. Default 'net'. Consumer (B2C) prices are quoted gross.\n  priceBasis?: 'net' | 'gross'\n  // When the item starts, relative to the seeded bill date:\n  //   'billDate' (default) \u2014 1st of this month, billed in advance from day one;\n  //   'prevMonth'          \u2014 1st of last month (in-arrears items bill it now);\n  //   'prevMonthMid'       \u2014 15th of last month: an add-on bought mid-cycle,\n  //                          so the first run shows a prorated stub line.\n  start?: 'billDate' | 'prevMonth' | 'prevMonthMid'\n}\n\ntype DemoUsageSpec = {\n  ref: string\n  uomCode: string\n  quantity: number\n  lineDescription: string\n}\n\nconst ACCOUNTS: Array<{\n  account: DemoAccountSpec\n  items: DemoItemSpec[]\n  usage: DemoUsageSpec[]\n}> = [\n  {\n    account: {\n      name: `${ACCOUNT_NAME_PREFIX}Northwind Telecom`,\n      customerId: 'demo-cust-northwind',\n      currencyCode: 'PLN',\n      invoiceLanguage: 'en',\n    },\n    items: [\n      { ref: `${SRC}-nw-rec`, type: 'recurring', description: 'Platform subscription (monthly)', unitPrice: 199 },\n      {\n        ref: `${SRC}-nw-addon`,\n        type: 'recurring',\n        description: 'Priority support add-on (monthly)',\n        unitPrice: 60,\n        taxRate: '8',\n        start: 'prevMonthMid',\n      },\n      { ref: `${SRC}-nw-usg`, type: 'usage', description: 'Data transfer (per GB)', unitPrice: 0.5, uomCode: 'gb', start: 'prevMonth' },\n    ],\n    usage: [\n      { ref: `${SRC}-nw-usage`, uomCode: 'gb', quantity: 120, lineDescription: 'Data transfer (prev. month)' },\n    ],\n  },\n  {\n    account: {\n      name: `${ACCOUNT_NAME_PREFIX}Globex Cloud`,\n      customerId: 'demo-cust-globex',\n      currencyCode: 'EUR',\n      invoiceLanguage: 'en',\n    },\n    items: [\n      { ref: `${SRC}-gx-rec`, type: 'recurring', description: 'Cloud plan (monthly)', unitPrice: 49 },\n      {\n        ref: `${SRC}-gx-arr`,\n        type: 'recurring',\n        description: 'Managed backups (billed in arrears)',\n        unitPrice: 15,\n        // 0 % \u2014 shows a mixed-rate VAT summary on the document.\n        taxRate: '0',\n        chargeTiming: 'in_arrears',\n        start: 'prevMonth',\n      },\n    ],\n    usage: [],\n  },\n  {\n    // B2C: a private person on a flat monthly internet plan, invoiced in Polish.\n    account: {\n      name: `${ACCOUNT_NAME_PREFIX}Jan Kowalski`,\n      customerId: 'demo-cust-jan-kowalski',\n      customerKind: 'person',\n      currencyCode: 'PLN',\n      invoiceLanguage: 'pl',\n    },\n    items: [\n      // B2C price quoted gross (79.00 PLN incl. 23 % VAT) \u2014 Spec F, F-D2.\n      {\n        ref: `${SRC}-jk-rec`,\n        type: 'recurring',\n        description: 'Internet 300 Mb/s (miesi\u0119cznie)',\n        unitPrice: 79,\n        priceBasis: 'gross',\n      },\n    ],\n    usage: [],\n  },\n]\n\n\n/** Delete every row this seed owns within the scope (reset before re-seed). */\nexport async function resetBillingDemo(em: EntityManager, scope: BillingDemoScope): Promise<void> {\n  await em.nativeDelete(BillingAccountUsage, {\n    ...scope,\n    sourceRef: { $like: `${SRC}-%` },\n  } as never)\n  await em.nativeDelete(BillingItem, {\n    ...scope,\n    sourceRef: { $like: `${SRC}-%` },\n  } as never)\n  await em.nativeDelete(BillingAccount, {\n    ...scope,\n    name: { $like: `${ACCOUNT_NAME_PREFIX}%` },\n  } as never)\n}\n\nexport async function seedBillingDemo(\n  em: EntityManager,\n  scope: BillingDemoScope,\n  options: { reset?: boolean; now?: Date } = {},\n): Promise<BillingDemoResult> {\n  if (options.reset) await resetBillingDemo(em, scope)\n\n  const now = options.now ?? new Date()\n  // Bill period the next run will cover, given next_bill = 1st of this month:\n  //   periodStart = 1st of previous month, periodEnd = last day of previous month.\n  // Build at UTC midnight so `date` columns don't drift a day under a positive\n  // local UTC offset (local `new Date(y, m, 1)` would persist as the prev day).\n  const nextBillDate = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1))\n  const prevMonthStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 1))\n  const prevMonthEnd = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 0))\n  const prevMonthMid = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 15))\n  const startFor = (item: DemoItemSpec): Date =>\n    item.start === 'prevMonth' ? prevMonthStart : item.start === 'prevMonthMid' ? prevMonthMid : nextBillDate\n\n  const result: BillingDemoResult = { accountsCreated: 0, itemsCreated: 0, usageCreated: 0 }\n\n  // \u2500\u2500 Seller settings (Spec B: posting needs them). Only empty fields are\n  // filled, so an operator's real details are never overwritten. \u2500\u2500\n  await applySellerDefaults(em, scope, DEFAULT_DEMO_SELLER)\n\n  for (const spec of ACCOUNTS) {\n    // \u2500\u2500 Account (idempotent by name within scope) \u2500\u2500\n    let account = await em.findOne(BillingAccount, {\n      ...scope,\n      name: spec.account.name,\n      deletedAt: null,\n    } as never)\n    if (!account) {\n      account = em.create(BillingAccount, {\n        ...scope,\n        customerId: spec.account.customerId,\n        customerKind: spec.account.customerKind ?? 'company',\n        name: spec.account.name,\n        currencyCode: spec.account.currencyCode,\n        billCycle: 'monthly',\n        billCycleAnchor: '1',\n        invoiceEmail: `billing@${spec.account.customerId}.demo`,\n        invoiceLanguage: spec.account.invoiceLanguage,\n        taxId: null,\n        invoiceAddress: { line1: 'ul. Demo 1', city: 'Warszawa', postal_code: '00-001', country: 'PL' },\n        nextBillDate,\n        lastBillDate: null,\n        isActive: true,\n      })\n      em.persist(account)\n      await em.flush() // need the id for child rows\n      result.accountsCreated += 1\n    }\n\n    // \u2500\u2500 Items (idempotent by source_ref) \u2500\u2500\n    for (const item of spec.items) {\n      const existing = await em.findOne(BillingItem, { ...scope, sourceRef: item.ref } as never)\n      if (existing) continue\n      em.persist(\n        em.create(BillingItem, {\n          ...scope,\n          billAccountId: account.id,\n          type: item.type,\n          billStartDate: startFor(item),\n          billEndDate: null,\n          chargeTiming: item.chargeTiming ?? 'in_advance',\n          prorate: true,\n          taxRate: item.taxRate ?? '23',\n          priceBasis: item.priceBasis ?? 'net',\n          description: item.description,\n          rateJson: { unit_price: item.unitPrice },\n          uomCode: item.uomCode ?? null,\n          subscriptionId: null,\n          subscriptionItemId: null,\n          sourceRef: item.ref,\n          currencyMismatch: false,\n          billedToDate: null,\n          isActive: true,\n        }),\n      )\n      result.itemsCreated += 1\n    }\n\n    // \u2500\u2500 Usage records (idempotent by source_ref) \u2500\u2500\n    for (const u of spec.usage) {\n      const existing = await em.findOne(BillingAccountUsage, { ...scope, sourceRef: u.ref } as never)\n      if (existing) continue\n      em.persist(\n        em.create(BillingAccountUsage, {\n          ...scope,\n          billAccountId: account.id,\n          uomCode: u.uomCode,\n          quantity: u.quantity.toFixed(4),\n          periodStart: prevMonthStart,\n          periodEnd: prevMonthEnd,\n          lineDescription: u.lineDescription,\n          sourceRef: u.ref,\n          ratedInBillRunId: null,\n          isActive: true,\n        }),\n      )\n      result.usageCreated += 1\n    }\n  }\n\n  await em.flush()\n  return result\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/lib/seeds/paymentsSample.js

@@ -0,0 +1,93 @@
+import { PAYMENT_CSV_HEADER } from "../paymentCsv.js";
+function csvField(value) {
+  return /[",\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function money(value) {
+  return value.toFixed(2);
+}
+function buildPaymentsSampleCsv(params) {
+  const { invoices, receipt, date, debitMemo } = params;
+  const rows = [];
+  const missing = [];
+  const gross = (inv) => Number.parseFloat(inv.totalGross);
+  const [a, b, c] = invoices;
+  const rest = invoices.slice(3);
+  let d;
+  let e;
+  for (let i = 0; i < rest.length && !d; i += 1) {
+    const match = rest.slice(i + 1).find((other) => other.accountName === rest[i].accountName && other.currencyCode === rest[i].currencyCode);
+    if (match) {
+      d = rest[i];
+      e = match;
+    }
+  }
+  if (a) rows.push([date, money(gross(a)), a.currencyCode, `Payment for ${a.number}`, a.accountName, ""]);
+  else missing.push("exact payment (needs 1 posted invoice)");
+  if (b) rows.push([date, money(gross(b) / 2), b.currencyCode, `${b.number} part 1`, b.accountName, ""]);
+  else missing.push("partial payment (needs 2 posted invoices)");
+  if (c) rows.push([date, money(gross(c) + 50), c.currencyCode, `Invoice ${c.number} + advance`, c.accountName, ""]);
+  else missing.push("overpayment (needs 3 posted invoices)");
+  if (d && e) rows.push([date, money(gross(d) + gross(e)), d.currencyCode, `${d.number}, ${e.number}`, d.accountName, ""]);
+  else missing.push("two invoices in one title (needs two more posted invoices of one account)");
+  if (a) rows.push([date, "25.00", a.currencyCode, "Thank you", a.accountName, "PL61109010140000071219812874"]);
+  if (receipt) rows.push([date, "100.00", receipt.currencyCode, `Top-up ${receipt.number}`, receipt.accountName, ""]);
+  else missing.push("prepaid top-up (needs a prepaid top-up receipt)");
+  if (debitMemo) {
+    rows.push([date, money(gross(debitMemo)), debitMemo.currencyCode, `Note ${debitMemo.number}`, debitMemo.accountName, ""]);
+  }
+  rows.push([date, "12.34", "PLN", "misc transfer", "Unknown payer", ""]);
+  if (a) {
+    const other = a.currencyCode === "EUR" ? "PLN" : "EUR";
+    rows.push([date, money(gross(a)), other, a.number, a.accountName, ""]);
+    const dup = [date, "10.00", a.currencyCode, "Duplicate line", a.accountName, ""];
+    rows.push(dup, [...dup]);
+  }
+  const csv = [PAYMENT_CSV_HEADER.join(","), ...rows.map((row) => row.map(csvField).join(","))].join("\n") + "\n";
+  return { csv, rows: rows.length, missing };
+}
+async function loadSampleSources(em, scope) {
+  const invoices = await em.execute(
+    `SELECT i.number, i.total_gross, i.currency_code, a.name AS account_name
+       FROM billing_invoices i
+       JOIN billing_accounts a ON a.id = i.bill_account_id
+      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.test_run = false
+        AND i.document_type = 'invoice' AND i.status = 'posted' AND a.billing_mode = 'postpaid'
+      ORDER BY i.issue_date ASC, i.number ASC
+      LIMIT 20`,
+    [scope.tenantId, scope.organizationId]
+  );
+  const receipts = await em.execute(
+    `SELECT i.number, i.currency_code, a.name AS account_name
+       FROM billing_invoices i
+       JOIN billing_accounts a ON a.id = i.bill_account_id
+      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.document_type = 'receipt'
+      ORDER BY i.created_at DESC
+      LIMIT 1`,
+    [scope.tenantId, scope.organizationId]
+  );
+  const debits = await em.execute(
+    `SELECT i.number, i.total_gross, i.currency_code, a.name AS account_name
+       FROM billing_invoices i
+       JOIN billing_accounts a ON a.id = i.bill_account_id
+      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.test_run = false
+        AND i.document_type = 'debit_memo' AND i.status = 'posted'
+      ORDER BY i.issue_date ASC
+      LIMIT 1`,
+    [scope.tenantId, scope.organizationId]
+  );
+  return {
+    debitMemo: debits?.[0] ? { number: debits[0].number, totalGross: debits[0].total_gross, currencyCode: debits[0].currency_code, accountName: debits[0].account_name } : null,
+    invoices: (invoices ?? []).map((row) => ({
+      number: row.number,
+      totalGross: row.total_gross,
+      currencyCode: row.currency_code,
+      accountName: row.account_name
+    })),
+    receipt: receipts?.[0] ? { number: receipts[0].number, currencyCode: receipts[0].currency_code, accountName: receipts[0].account_name } : null
+  };
+}
+export {
+  buildPaymentsSampleCsv,
+  loadSampleSources
+};
+//# sourceMappingURL=paymentsSample.js.map

package/dist/modules/billing/lib/seeds/paymentsSample.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/billing/lib/seeds/paymentsSample.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { PAYMENT_CSV_HEADER } from '../paymentCsv'\n\n/**\n * Demo bank statement (Spec C): a `payments-sample.csv` built from the\n * organization's real posted invoices, so numbers and amounts line up and\n * every matcher outcome shows up after one upload:\n *\n *   exact amount + number            \u2192 allocated, invoice paid\n *   half the amount                  \u2192 invoice partially paid\n *   amount + 50                      \u2192 paid, 50 credit applied to the next open invoice\n *   two numbers, sum of both         \u2192 both paid\n *   no reference, known payer        \u2192 unmatched \u2192 assign to account\n *   a top-up receipt number          \u2192 unmatched (prepaid) \u2192 convert to top-up\n *   junk title                       \u2192 unmatched (no reference)\n *   other currency                   \u2192 unmatched (currency mismatch)\n *   the same line twice              \u2192 both stored (occurrence index); re-upload = duplicates\n *\n * Pure builder + a loader for the CLI (`mercato billing payments-sample`).\n */\n\nexport type SampleInvoice = {\n  number: string\n  totalGross: string\n  currencyCode: string\n  accountName: string\n}\n\nexport type SampleReceipt = { number: string; currencyCode: string; accountName: string }\n\nfunction csvField(value: string): string {\n  return /[\",\\n]/.test(value) ? `\"${value.replace(/\"/g, '\"\"')}\"` : value\n}\n\nfunction money(value: number): string {\n  return value.toFixed(2)\n}\n\nexport function buildPaymentsSampleCsv(params: {\n  invoices: SampleInvoice[]\n  receipt?: SampleReceipt | null\n  /** Spec D: a posted debit memo \u2014 paid by its own number like an invoice. */\n  debitMemo?: SampleInvoice | null\n  date: string\n}): { csv: string; rows: number; missing: string[] } {\n  const { invoices, receipt, date, debitMemo } = params\n  const rows: string[][] = []\n  const missing: string[] = []\n  const gross = (inv: SampleInvoice) => Number.parseFloat(inv.totalGross)\n  const [a, b, c] = invoices\n  // Two invoices of the SAME account (references to two customers are ambiguous).\n  const rest = invoices.slice(3)\n  let d: SampleInvoice | undefined\n  let e: SampleInvoice | undefined\n  for (let i = 0; i < rest.length && !d; i += 1) {\n    const match = rest.slice(i + 1).find((other) => other.accountName === rest[i].accountName && other.currencyCode === rest[i].currencyCode)\n    if (match) {\n      d = rest[i]\n      e = match\n    }\n  }\n\n  if (a) rows.push([date, money(gross(a)), a.currencyCode, `Payment for ${a.number}`, a.accountName, ''])\n  else missing.push('exact payment (needs 1 posted invoice)')\n  if (b) rows.push([date, money(gross(b) / 2), b.currencyCode, `${b.number} part 1`, b.accountName, ''])\n  else missing.push('partial payment (needs 2 posted invoices)')\n  if (c) rows.push([date, money(gross(c) + 50), c.currencyCode, `Invoice ${c.number} + advance`, c.accountName, ''])\n  else missing.push('overpayment (needs 3 posted invoices)')\n  if (d && e) rows.push([date, money(gross(d) + gross(e)), d.currencyCode, `${d.number}, ${e.number}`, d.accountName, ''])\n  else missing.push('two invoices in one title (needs two more posted invoices of one account)')\n  if (a) rows.push([date, '25.00', a.currencyCode, 'Thank you', a.accountName, 'PL61109010140000071219812874'])\n  if (receipt) rows.push([date, '100.00', receipt.currencyCode, `Top-up ${receipt.number}`, receipt.accountName, ''])\n  else missing.push('prepaid top-up (needs a prepaid top-up receipt)')\n  if (debitMemo) {\n    rows.push([date, money(gross(debitMemo)), debitMemo.currencyCode, `Note ${debitMemo.number}`, debitMemo.accountName, ''])\n  }\n  rows.push([date, '12.34', 'PLN', 'misc transfer', 'Unknown payer', ''])\n  if (a) {\n    const other = a.currencyCode === 'EUR' ? 'PLN' : 'EUR'\n    rows.push([date, money(gross(a)), other, a.number, a.accountName, ''])\n    const dup = [date, '10.00', a.currencyCode, 'Duplicate line', a.accountName, '']\n    rows.push(dup, [...dup])\n  }\n  const csv = [PAYMENT_CSV_HEADER.join(','), ...rows.map((row) => row.map(csvField).join(','))].join('\\n') + '\\n'\n  return { csv, rows: rows.length, missing }\n}\n\n/** Posted, unpaid invoices of the org (oldest first) and one top-up receipt. */\nexport async function loadSampleSources(\n  em: EntityManager,\n  scope: { tenantId: string; organizationId: string },\n): Promise<{ invoices: SampleInvoice[]; receipt: SampleReceipt | null; debitMemo: SampleInvoice | null }> {\n  const invoices = (await em.execute(\n    `SELECT i.number, i.total_gross, i.currency_code, a.name AS account_name\n       FROM billing_invoices i\n       JOIN billing_accounts a ON a.id = i.bill_account_id\n      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.test_run = false\n        AND i.document_type = 'invoice' AND i.status = 'posted' AND a.billing_mode = 'postpaid'\n      ORDER BY i.issue_date ASC, i.number ASC\n      LIMIT 20`,\n    [scope.tenantId, scope.organizationId],\n  )) as unknown as Array<{ number: string; total_gross: string; currency_code: string; account_name: string }>\n  const receipts = (await em.execute(\n    `SELECT i.number, i.currency_code, a.name AS account_name\n       FROM billing_invoices i\n       JOIN billing_accounts a ON a.id = i.bill_account_id\n      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.document_type = 'receipt'\n      ORDER BY i.created_at DESC\n      LIMIT 1`,\n    [scope.tenantId, scope.organizationId],\n  )) as unknown as Array<{ number: string; currency_code: string; account_name: string }>\n  const debits = (await em.execute(\n    `SELECT i.number, i.total_gross, i.currency_code, a.name AS account_name\n       FROM billing_invoices i\n       JOIN billing_accounts a ON a.id = i.bill_account_id\n      WHERE i.tenant_id = ? AND i.organization_id = ? AND i.deleted_at IS NULL AND i.test_run = false\n        AND i.document_type = 'debit_memo' AND i.status = 'posted'\n      ORDER BY i.issue_date ASC\n      LIMIT 1`,\n    [scope.tenantId, scope.organizationId],\n  )) as unknown as Array<{ number: string; total_gross: string; currency_code: string; account_name: string }>\n  return {\n    debitMemo: debits?.[0]\n      ? { number: debits[0].number, totalGross: debits[0].total_gross, currencyCode: debits[0].currency_code, accountName: debits[0].account_name }\n      : null,\n    invoices: (invoices ?? []).map((row) => ({\n      number: row.number,\n      totalGross: row.total_gross,\n      currencyCode: row.currency_code,\n      accountName: row.account_name,\n    })),\n    receipt: receipts?.[0]\n      ? { number: receipts[0].number, currencyCode: receipts[0].currency_code, accountName: receipts[0].account_name }\n      : null,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/billing/lib/seeds/sellerSettings.js

@@ -0,0 +1,41 @@
+import { getBillingSettings } from "../billingSettings.js";
+const SELLER_FIELDS = ["legalName", "sellerAddress", "taxId", "bankName", "iban", "bic", "invoiceFooter"];
+const DEFAULT_DEMO_SELLER = {
+  legalName: "Dainamite Demo sp. z o.o.",
+  sellerAddress: { line1: "ul. Przyk\u0142adowa 10", city: "Krak\xF3w", postal_code: "30-001", country: "PL" },
+  taxId: "PL1234563218",
+  bankName: "Demo Bank S.A.",
+  iban: "PL61109010140000071219812874",
+  bic: "WBKPPLPP",
+  invoiceFooter: "S\u0105d Rejonowy dla Krakowa-\u015Ar\xF3dmie\u015Bcia, KRS 0000000000. Kapita\u0142 zak\u0142adowy 5 000 z\u0142."
+};
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string") return value.trim() === "";
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+function sellerFieldsToFill(settings, profile) {
+  const out = {};
+  for (const field of SELLER_FIELDS) {
+    const value = profile[field];
+    if (value === void 0) continue;
+    if (isEmpty(settings[field])) out[field] = value;
+  }
+  return out;
+}
+async function applySellerDefaults(em, scope, profile) {
+  const settings = await getBillingSettings(em, scope);
+  const fill = sellerFieldsToFill(settings, profile);
+  const fields = Object.keys(fill);
+  if (fields.length === 0) return [];
+  Object.assign(settings, fill, { updatedAt: /* @__PURE__ */ new Date() });
+  await em.flush();
+  return fields;
+}
+export {
+  DEFAULT_DEMO_SELLER,
+  applySellerDefaults,
+  sellerFieldsToFill
+};
+//# sourceMappingURL=sellerSettings.js.map

package/dist/modules/billing/lib/seeds/sellerSettings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/billing/lib/seeds/sellerSettings.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { BillingSettings } from '../../data/entities'\nimport { getBillingSettings, type SettingsScope } from '../billingSettings'\n\n/**\n * Seller details for demo / seed tenants (Spec B: posting an invoice needs\n * legal name, address, tax ID and IBAN). Public seed API \u2014 demo use cases\n * (`demo_gix`, `demo_puffin`, \u2026) call `applySellerDefaults` from their own\n * `seedDefaults` with a profile of their own.\n *\n * Only EMPTY fields are filled, so an operator's real details are never\n * overwritten and re-running a seed is a no-op. Values must pass the settings\n * validators (checksum-valid IBAN, 8/11-char BIC) so the settings page can be\n * saved without touching them.\n */\n\nexport type SellerProfile = {\n  legalName: string\n  sellerAddress: { line1: string; line2?: string; city: string; postal_code: string; country: string }\n  taxId: string\n  bankName: string\n  iban: string\n  bic: string\n  invoiceFooter?: string\n}\n\nconst SELLER_FIELDS = ['legalName', 'sellerAddress', 'taxId', 'bankName', 'iban', 'bic', 'invoiceFooter'] as const\ntype SellerField = (typeof SELLER_FIELDS)[number]\n\n/** The generic seller of the billing demo seed (primary tenant). */\nexport const DEFAULT_DEMO_SELLER: SellerProfile = {\n  legalName: 'Dainamite Demo sp. z o.o.',\n  sellerAddress: { line1: 'ul. Przyk\u0142adowa 10', city: 'Krak\u00F3w', postal_code: '30-001', country: 'PL' },\n  taxId: 'PL1234563218',\n  bankName: 'Demo Bank S.A.',\n  iban: 'PL61109010140000071219812874',\n  bic: 'WBKPPLPP',\n  invoiceFooter: 'S\u0105d Rejonowy dla Krakowa-\u015Ar\u00F3dmie\u015Bcia, KRS 0000000000. Kapita\u0142 zak\u0142adowy 5 000 z\u0142.',\n}\n\nfunction isEmpty(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (typeof value === 'string') return value.trim() === ''\n  if (typeof value === 'object') return Object.keys(value as object).length === 0\n  return false\n}\n\n/** Pure: which profile values would fill which empty settings fields. */\nexport function sellerFieldsToFill(\n  settings: Pick<BillingSettings, SellerField>,\n  profile: SellerProfile,\n): Partial<Record<SellerField, unknown>> {\n  const out: Partial<Record<SellerField, unknown>> = {}\n  for (const field of SELLER_FIELDS) {\n    const value = profile[field]\n    if (value === undefined) continue\n    if (isEmpty(settings[field])) out[field] = value\n  }\n  return out\n}\n\n/**\n * Fill the organization's empty seller fields from `profile` and flush.\n * Returns the names of the fields that were filled (empty when nothing changed).\n */\nexport async function applySellerDefaults(\n  em: EntityManager,\n  scope: SettingsScope,\n  profile: SellerProfile,\n): Promise<string[]> {\n  const settings = await getBillingSettings(em, scope)\n  const fill = sellerFieldsToFill(settings, profile)\n  const fields = Object.keys(fill)\n  if (fields.length === 0) return []\n  Object.assign(settings, fill, { updatedAt: new Date() })\n  await em.flush()\n  return fields\n}\n"],
+  "mappings": "AAEA,SAAS,0BAA8C;AAwBvD,MAAM,gBAAgB,CAAC,aAAa,iBAAiB,SAAS,YAAY,QAAQ,OAAO,eAAe;AAIjG,MAAM,sBAAqC;AAAA,EAChD,WAAW;AAAA,EACX,eAAe,EAAE,OAAO,2BAAsB,MAAM,aAAU,aAAa,UAAU,SAAS,KAAK;AAAA,EACnG,OAAO;AAAA,EACP,UAAU;AAAA,EACV,MAAM;AAAA,EACN,KAAK;AAAA,EACL,eAAe;AACjB;AAEA,SAAS,QAAQ,OAAyB;AACxC,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO,MAAM,KAAK,MAAM;AACvD,MAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,KAAe,EAAE,WAAW;AAC9E,SAAO;AACT;AAGO,SAAS,mBACd,UACA,SACuC;AACvC,QAAM,MAA6C,CAAC;AACpD,aAAW,SAAS,eAAe;AACjC,UAAM,QAAQ,QAAQ,KAAK;AAC3B,QAAI,UAAU,OAAW;AACzB,QAAI,QAAQ,SAAS,KAAK,CAAC,EAAG,KAAI,KAAK,IAAI;AAAA,EAC7C;AACA,SAAO;AACT;AAMA,eAAsB,oBACpB,IACA,OACA,SACmB;AACnB,QAAM,WAAW,MAAM,mBAAmB,IAAI,KAAK;AACnD,QAAM,OAAO,mBAAmB,UAAU,OAAO;AACjD,QAAM,SAAS,OAAO,KAAK,IAAI;AAC/B,MAAI,OAAO,WAAW,EAAG,QAAO,CAAC;AACjC,SAAO,OAAO,UAAU,MAAM,EAAE,WAAW,oBAAI,KAAK,EAAE,CAAC;AACvD,QAAM,GAAG,MAAM;AACf,SAAO;AACT;",
+  "names": []
+}