@dainamite/billing 0.17.0 → 0.18.0

package/src/modules/billing/backend/billing/topups/page.tsx

@@ -0,0 +1,182 @@
+"use client"
+import * as React from 'react'
+import { useRouter } from 'next/navigation'
+import type { ColumnDef } from '@tanstack/react-table'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import type { FilterDef, FilterValues } from '@open-mercato/ui/backend/FilterBar'
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { DataTable } from '@open-mercato/ui/backend/DataTable'
+import { Tag } from '@open-mercato/ui/primitives/tag'
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import { fetchAccountNames } from '../../../components/accountNames'
+
+/**
+ * Registered top-ups admin list (SPEC-002 P2). Read-only — top-ups are
+ * initiated from a prepaid account's detail page and progress through the
+ * gateway capture lifecycle.
+ */
+
+type TopupRow = {
+  id: string
+  bill_account_id: string
+  status: string
+  amount: string
+  currency_code: string
+  provider_key: string
+  receipt_invoice_id: string | null
+  created_at: string
+}
+
+type ListResponse = { items: TopupRow[]; total: number; totalPages: number }
+
+function formatDate(value: string | null | undefined): string {
+  if (!value) return '—'
+  const d = new Date(value)
+  return Number.isNaN(d.getTime()) ? value : d.toLocaleString()
+}
+
+export function statusVariant(status: string): 'success' | 'info' | 'error' | 'default' {
+  if (status === 'captured') return 'success'
+  if (status === 'pending') return 'info'
+  if (status === 'failed') return 'error'
+  return 'default' // cancelled / expired
+}
+
+export default function BillingTopupsListPage() {
+  const t = useT()
+  const router = useRouter()
+  const [rows, setRows] = React.useState<TopupRow[]>([])
+  const [page, setPage] = React.useState(1)
+  const [pageSize] = React.useState(25)
+  const [filters, setFilters] = React.useState<FilterValues>({})
+  const [search, setSearch] = React.useState('')
+  const [total, setTotal] = React.useState(0)
+  const [totalPages, setTotalPages] = React.useState(1)
+  const [loading, setLoading] = React.useState(true)
+  const [accountNames, setAccountNames] = React.useState<Record<string, string>>({})
+
+  const filterDefs = React.useMemo<FilterDef[]>(
+    () => [
+      {
+        id: 'status',
+        label: t('billing.topups.filters.status', 'Status'),
+        type: 'select',
+        options: [
+          { value: 'pending', label: t('billing.topups.status.pending', 'Pending') },
+          { value: 'captured', label: t('billing.topups.status.captured', 'Captured') },
+          { value: 'failed', label: t('billing.topups.status.failed', 'Failed') },
+          { value: 'cancelled', label: t('billing.topups.status.cancelled', 'Cancelled') },
+          { value: 'expired', label: t('billing.topups.status.expired', 'Expired') },
+        ],
+      },
+    ],
+    [t],
+  )
+
+  const loadRows = React.useCallback(async () => {
+    setLoading(true)
+    try {
+      const params = new URLSearchParams({
+        page: String(page),
+        pageSize: String(pageSize),
+        sortField: 'createdAt',
+        sortDir: 'desc',
+      })
+      if (search.trim()) params.set('search', search.trim())
+      if (typeof filters.status === 'string' && filters.status) params.set('status', filters.status)
+      const result = await readApiResultOrThrow<ListResponse>(
+        `/api/billing/topups?${params.toString()}`,
+      )
+      const items = result.items ?? []
+      setRows(items)
+      setTotal(result.total ?? 0)
+      setTotalPages(result.totalPages ?? 1)
+      try {
+        const names = await fetchAccountNames(items.map((r) => r.bill_account_id))
+        setAccountNames((prev) => ({ ...prev, ...names }))
+      } catch {
+        // Name resolution is best-effort — fall back to the id in the cell.
+      }
+    } finally {
+      setLoading(false)
+    }
+  }, [filters.status, page, pageSize, search])
+
+  React.useEffect(() => {
+    void loadRows()
+  }, [loadRows])
+
+  const columns = React.useMemo<ColumnDef<TopupRow>[]>(
+    () => [
+      {
+        accessorKey: 'created_at',
+        header: t('billing.topups.columns.created', 'Created'),
+        cell: ({ row }) => formatDate(row.original.created_at),
+      },
+      {
+        accessorKey: 'amount',
+        header: t('billing.topups.columns.amount', 'Amount'),
+        cell: ({ row }) => (
+          <span className="font-mono tabular-nums">
+            {row.original.amount} {row.original.currency_code}
+          </span>
+        ),
+      },
+      {
+        accessorKey: 'provider_key',
+        header: t('billing.topups.columns.provider', 'Provider'),
+        cell: ({ row }) => <span className="font-mono text-xs">{row.original.provider_key}</span>,
+      },
+      {
+        accessorKey: 'status',
+        header: t('billing.topups.columns.status', 'Status'),
+        cell: ({ row }) => (
+          <Tag variant={statusVariant(row.original.status)}>
+            {t(`billing.topups.status.${row.original.status}`, row.original.status)}
+          </Tag>
+        ),
+      },
+      {
+        accessorKey: 'bill_account_id',
+        header: t('billing.topups.columns.account', 'Account'),
+        cell: ({ row }) => {
+          const name = accountNames[row.original.bill_account_id]
+          return name ? (
+            <span className="text-sm">{name}</span>
+          ) : (
+            <span className="font-mono text-xs">{row.original.bill_account_id}</span>
+          )
+        },
+      },
+    ],
+    [t, accountNames],
+  )
+
+  return (
+    <Page>
+      <PageBody>
+        <DataTable
+          title={t('billing.topups.title', 'Top-ups')}
+          refreshButton={{
+            label: t('billing.common.refresh', 'Refresh'),
+            onRefresh: loadRows,
+            isRefreshing: loading,
+          }}
+          columnChooser={{ auto: true }}
+          perspective={{ tableId: 'billing-topups' }}
+          columns={columns}
+          data={rows}
+          onRowClick={(row) => router.push(`/backend/billing/topups/${row.id}`)}
+          isLoading={loading}
+          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage }}
+          filters={filterDefs}
+          filterValues={filters}
+          onFiltersApply={setFilters}
+          onFiltersClear={() => setFilters({})}
+          searchValue={search}
+          onSearchChange={setSearch}
+        />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/billing/backend/billing/transactions/[id]/page.meta.ts

@@ -0,0 +1,19 @@
+import React from 'react'
+import { ArrowLeftRight } from 'lucide-react'
+
+const transactionIcon = React.createElement(ArrowLeftRight, { size: 16 })
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['billing.balance.view'],
+  pageTitle: 'Transaction',
+  pageTitleKey: 'billing.transactions.detail.title',
+  pageGroup: 'Billing',
+  pageGroupKey: 'billing.nav.group',
+  navHidden: true,
+  icon: transactionIcon,
+  breadcrumb: [
+    { label: 'Transactions', labelKey: 'billing.transactions.title', href: '/backend/billing/transactions' },
+    { label: 'Transaction', labelKey: 'billing.transactions.detail.title' },
+  ],
+} as const

package/src/modules/billing/backend/billing/transactions/[id]/page.tsx

@@ -0,0 +1,179 @@
+"use client"
+import * as React from 'react'
+import Link from 'next/link'
+import { useParams } from 'next/navigation'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { FormHeader } from '@open-mercato/ui/backend/forms'
+import { Tag } from '@open-mercato/ui/primitives/tag'
+import { Button } from '@open-mercato/ui/primitives/button'
+import { LoadingMessage, ErrorMessage } from '@open-mercato/ui/backend/detail'
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import { DetailCard, DetailField } from '../../../../components/DetailFields'
+import { txnVariant } from '../page'
+
+type TransactionRow = {
+  id: string
+  bill_account_id: string
+  type: string
+  amount: string
+  currency_code: string
+  balance_after: string
+  usage_id: string | null
+  billing_item_id: string | null
+  topup_id: string | null
+  statement_id: string | null
+  description: string
+  source_ref: string | null
+  user_id: string | null
+  created_at: string
+}
+
+function formatDate(value: string | null | undefined): string {
+  if (!value) return '—'
+  const d = new Date(value)
+  return Number.isNaN(d.getTime()) ? value : d.toLocaleString()
+}
+
+// A monospace value that links somewhere when present, else an em dash.
+function RefField({ id, href }: { id: string | null; href?: string }) {
+  if (!id) return <>—</>
+  if (href) {
+    return (
+      <Link href={href} className="font-mono text-xs hover:underline">
+        {id}
+      </Link>
+    )
+  }
+  return <span className="font-mono text-xs">{id}</span>
+}
+
+export default function BillingTransactionDetailPage(props: { params?: { id?: string } }) {
+  const t = useT()
+  const urlParams = useParams<{ id: string }>()
+  const transactionId = (props.params?.id ?? urlParams?.id ?? '') as string
+
+  const [row, setRow] = React.useState<TransactionRow | null>(null)
+  const [loading, setLoading] = React.useState(true)
+  const [error, setError] = React.useState<string | null>(null)
+
+  React.useEffect(() => {
+    let cancelled = false
+    if (!transactionId) return
+    setLoading(true)
+    readApiResultOrThrow<{ items: TransactionRow[] }>(
+      `/api/billing/transactions?id=${transactionId}&pageSize=1`,
+    )
+      .then((res) => {
+        if (cancelled) return
+        const found = res.items?.[0]
+        if (!found) setError(t('billing.transactions.detail.not_found', 'Transaction not found'))
+        else setRow(found)
+      })
+      .catch(() => {
+        if (!cancelled)
+          setError(t('billing.transactions.detail.load_error', 'Failed to load transaction'))
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false)
+      })
+    return () => {
+      cancelled = true
+    }
+  }, [transactionId, t])
+
+  if (error) {
+    return (
+      <Page>
+        <PageBody>
+          <ErrorMessage label={error} />
+        </PageBody>
+      </Page>
+    )
+  }
+  if (loading || !row) {
+    return (
+      <Page>
+        <PageBody>
+          <LoadingMessage label={t('billing.transactions.detail.loading', 'Loading transaction…')} />
+        </PageBody>
+      </Page>
+    )
+  }
+
+  return (
+    <Page>
+      <FormHeader
+        mode="detail"
+        backHref="/backend/billing/transactions"
+        entityTypeLabel={t('billing.transactions.detail.title', 'Transaction')}
+        title={`${row.amount} ${row.currency_code}`}
+        statusBadge={
+          <Tag variant={txnVariant(row.type)}>
+            {t(`billing.transactions.type.${row.type}`, row.type)}
+          </Tag>
+        }
+        actionsContent={
+          <Button asChild variant="outline">
+            <Link href={`/backend/billing/accounts/${row.bill_account_id}`}>
+              {t('billing.transactions.detail.view_account', 'View account')}
+            </Link>
+          </Button>
+        }
+      />
+      <PageBody>
+        <DetailCard>
+          <DetailField label={t('billing.transactions.columns.amount', 'Amount')}>
+            <span className="font-mono tabular-nums">
+              {row.amount} {row.currency_code}
+            </span>
+          </DetailField>
+          <DetailField label={t('billing.transactions.columns.balance_after', 'Balance')}>
+            <span className="font-mono tabular-nums">{row.balance_after}</span>
+          </DetailField>
+          <DetailField label={t('billing.transactions.columns.type', 'Type')}>
+            <Tag variant={txnVariant(row.type)}>
+              {t(`billing.transactions.type.${row.type}`, row.type)}
+            </Tag>
+          </DetailField>
+          <DetailField label={t('billing.transactions.columns.when', 'When')}>
+            {formatDate(row.created_at)}
+          </DetailField>
+          <DetailField label={t('billing.transactions.columns.description', 'Description')} fullWidth>
+            {row.description || '—'}
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.source_ref', 'Source ref')}>
+            <span className="font-mono text-xs">{row.source_ref || '—'}</span>
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.topup', 'Top-up')}>
+            <RefField
+              id={row.topup_id}
+              href={row.topup_id ? `/backend/billing/topups/${row.topup_id}` : undefined}
+            />
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.statement', 'Statement')}>
+            <RefField
+              id={row.statement_id}
+              href={row.statement_id ? `/backend/billing/statements/${row.statement_id}` : undefined}
+            />
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.usage', 'Usage record')}>
+            <RefField id={row.usage_id} />
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.item', 'Billing item')}>
+            <RefField
+              id={row.billing_item_id}
+              href={row.billing_item_id ? `/backend/billing/items/${row.billing_item_id}` : undefined}
+            />
+          </DetailField>
+          <DetailField label={t('billing.transactions.detail.user', 'User')}>
+            <RefField id={row.user_id} />
+          </DetailField>
+          <DetailField label={t('billing.common.id', 'ID')}>
+            <span className="font-mono text-xs">{row.id}</span>
+          </DetailField>
+        </DetailCard>
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/billing/backend/billing/transactions/page.meta.ts

@@ -0,0 +1,16 @@
+import React from 'react'
+import { ArrowLeftRight } from 'lucide-react'
+
+const transactionsIcon = React.createElement(ArrowLeftRight, { size: 16 })
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['billing.balance.view'],
+  pageTitle: 'Transactions',
+  pageTitleKey: 'billing.transactions.title',
+  pageGroup: 'Billing',
+  pageGroupKey: 'billing.nav.group',
+  pageOrder: 70,
+  icon: transactionsIcon,
+  breadcrumb: [{ label: 'Transactions', labelKey: 'billing.transactions.title' }],
+} as const

package/src/modules/billing/backend/billing/transactions/page.tsx

@@ -0,0 +1,187 @@
+"use client"
+import * as React from 'react'
+import { useRouter } from 'next/navigation'
+import type { ColumnDef } from '@tanstack/react-table'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import type { FilterDef, FilterValues } from '@open-mercato/ui/backend/FilterBar'
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { DataTable } from '@open-mercato/ui/backend/DataTable'
+import { Tag } from '@open-mercato/ui/primitives/tag'
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import { fetchAccountNames } from '../../../components/accountNames'
+
+/**
+ * Balance transactions admin list (SPEC-002). Read-only — the append-only
+ * ledger is written by the command bus (real-time consume, top-up capture,
+ * period close, manual adjustment). Each row links to its detail page so an
+ * operator can trace a movement back to its source document.
+ */
+
+type TransactionRow = {
+  id: string
+  bill_account_id: string
+  type: string
+  amount: string
+  currency_code: string
+  balance_after: string
+  description: string
+  created_at: string
+}
+
+type ListResponse = { items: TransactionRow[]; total: number; totalPages: number }
+
+function formatDate(value: string | null | undefined): string {
+  if (!value) return '—'
+  const d = new Date(value)
+  return Number.isNaN(d.getTime()) ? value : d.toLocaleString()
+}
+
+export function txnVariant(type: string): 'success' | 'info' | 'error' | 'neutral' | 'default' {
+  if (type === 'topup' || type === 'adjustment') return 'success'
+  if (type === 'usage') return 'info'
+  if (type === 'reversal') return 'error'
+  return 'neutral' // recurring / one_time
+}
+
+export default function BillingTransactionsListPage() {
+  const t = useT()
+  const router = useRouter()
+  const [rows, setRows] = React.useState<TransactionRow[]>([])
+  const [page, setPage] = React.useState(1)
+  const [pageSize] = React.useState(25)
+  const [filters, setFilters] = React.useState<FilterValues>({})
+  const [total, setTotal] = React.useState(0)
+  const [totalPages, setTotalPages] = React.useState(1)
+  const [loading, setLoading] = React.useState(true)
+  const [accountNames, setAccountNames] = React.useState<Record<string, string>>({})
+
+  const filterDefs = React.useMemo<FilterDef[]>(
+    () => [
+      {
+        id: 'type',
+        label: t('billing.transactions.filters.type', 'Type'),
+        type: 'select',
+        options: [
+          { value: 'topup', label: t('billing.transactions.type.topup', 'Top-up') },
+          { value: 'usage', label: t('billing.transactions.type.usage', 'Usage') },
+          { value: 'recurring', label: t('billing.transactions.type.recurring', 'Recurring') },
+          { value: 'one_time', label: t('billing.transactions.type.one_time', 'One-time') },
+          { value: 'adjustment', label: t('billing.transactions.type.adjustment', 'Adjustment') },
+          { value: 'reversal', label: t('billing.transactions.type.reversal', 'Reversal') },
+        ],
+      },
+    ],
+    [t],
+  )
+
+  const loadRows = React.useCallback(async () => {
+    setLoading(true)
+    try {
+      const params = new URLSearchParams({
+        page: String(page),
+        pageSize: String(pageSize),
+        sortField: 'createdAt',
+        sortDir: 'desc',
+      })
+      if (typeof filters.type === 'string' && filters.type) params.set('type', filters.type)
+      const result = await readApiResultOrThrow<ListResponse>(
+        `/api/billing/transactions?${params.toString()}`,
+      )
+      const items = result.items ?? []
+      setRows(items)
+      setTotal(result.total ?? 0)
+      setTotalPages(result.totalPages ?? 1)
+      try {
+        const names = await fetchAccountNames(items.map((r) => r.bill_account_id))
+        setAccountNames((prev) => ({ ...prev, ...names }))
+      } catch {
+        // Name resolution is best-effort — fall back to the id in the cell.
+      }
+    } finally {
+      setLoading(false)
+    }
+  }, [filters.type, page, pageSize])
+
+  React.useEffect(() => {
+    void loadRows()
+  }, [loadRows])
+
+  const columns = React.useMemo<ColumnDef<TransactionRow>[]>(
+    () => [
+      {
+        accessorKey: 'created_at',
+        header: t('billing.transactions.columns.when', 'When'),
+        cell: ({ row }) => formatDate(row.original.created_at),
+      },
+      {
+        accessorKey: 'type',
+        header: t('billing.transactions.columns.type', 'Type'),
+        cell: ({ row }) => (
+          <Tag variant={txnVariant(row.original.type)}>
+            {t(`billing.transactions.type.${row.original.type}`, row.original.type)}
+          </Tag>
+        ),
+      },
+      {
+        accessorKey: 'description',
+        header: t('billing.transactions.columns.description', 'Description'),
+        cell: ({ row }) => <span className="text-sm">{row.original.description}</span>,
+      },
+      {
+        accessorKey: 'amount',
+        header: t('billing.transactions.columns.amount', 'Amount'),
+        cell: ({ row }) => (
+          <span className="font-mono tabular-nums">
+            {row.original.amount} {row.original.currency_code}
+          </span>
+        ),
+      },
+      {
+        accessorKey: 'balance_after',
+        header: t('billing.transactions.columns.balance_after', 'Balance'),
+        cell: ({ row }) => (
+          <span className="font-mono tabular-nums">{row.original.balance_after}</span>
+        ),
+      },
+      {
+        accessorKey: 'bill_account_id',
+        header: t('billing.transactions.columns.account', 'Account'),
+        cell: ({ row }) => {
+          const name = accountNames[row.original.bill_account_id]
+          return name ? (
+            <span className="text-sm">{name}</span>
+          ) : (
+            <span className="font-mono text-xs">{row.original.bill_account_id}</span>
+          )
+        },
+      },
+    ],
+    [t, accountNames],
+  )
+
+  return (
+    <Page>
+      <PageBody>
+        <DataTable
+          title={t('billing.transactions.title', 'Transactions')}
+          refreshButton={{
+            label: t('billing.common.refresh', 'Refresh'),
+            onRefresh: loadRows,
+            isRefreshing: loading,
+          }}
+          columnChooser={{ auto: true }}
+          perspective={{ tableId: 'billing-transactions' }}
+          columns={columns}
+          data={rows}
+          onRowClick={(row) => router.push(`/backend/billing/transactions/${row.id}`)}
+          isLoading={loading}
+          pagination={{ page, pageSize, total, totalPages, onPageChange: setPage }}
+          filters={filterDefs}
+          filterValues={filters}
+          onFiltersApply={setFilters}
+          onFiltersClear={() => setFilters({})}
+        />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/billing/commands/accounts.ts

@@ -11,7 +11,7 @@ import {
 } from '@open-mercato/shared/lib/commands/helpers'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
-import { BillingAccount } from '../data/entities'
+import { BillingAccount, BillingAccountBalance } from '../data/entities'
 import { billingEntityIds } from '../data/entityIds'
 import {
   billingAccountCreateSchema,
@@ -21,6 +21,8 @@ import {
   type BillingAccountDeleteInput,
   type BillingAccountUpdateInput,
 } from '../data/validators'
+import { ensureBalanceRow } from '../lib/balanceLedger'
+import { formatMoney } from '../lib/money'
 
 /**
  * BillingAccount writes — create / update / soft-delete.
@@ -59,6 +61,7 @@ const createAccountCommand: CommandHandler<BillingAccountCreateInput, { id: stri
 
     const em = getEm(ctx)
     const now = new Date()
+    const billingMode = parsed.billingMode ?? 'postpaid'
     const entity = em.create(BillingAccount, {
       organizationId: parsed.organizationId,
       tenantId: parsed.tenantId,
@@ -73,6 +76,9 @@ const createAccountCommand: CommandHandler<BillingAccountCreateInput, { id: stri
       invoiceAddress: parsed.invoiceAddress as Record<string, unknown>,
       nextBillDate: parsed.nextBillDate,
       lastBillDate: parsed.lastBillDate ?? null,
+      billingMode,
+      creditLimit:
+        parsed.creditLimit !== undefined ? formatMoney(parsed.creditLimit) : '0',
       isActive: parsed.isActive ?? true,
       createdAt: now,
       updatedAt: now,
@@ -80,6 +86,21 @@ const createAccountCommand: CommandHandler<BillingAccountCreateInput, { id: stri
     em.persist(entity)
     await em.flush()
 
+    // SPEC-002: a prepaid account gets its 1:1 balance row (starting at 0)
+    // at create time, so the consume path never races a missing row.
+    if (billingMode === 'prepaid') {
+      await ensureBalanceRow(em, {
+        organizationId: entity.organizationId,
+        tenantId: entity.tenantId,
+        billAccountId: entity.id,
+        currencyCode: entity.currencyCode,
+        lowBalanceThreshold:
+          parsed.lowBalanceThreshold !== undefined && parsed.lowBalanceThreshold !== null
+            ? formatMoney(parsed.lowBalanceThreshold)
+            : null,
+      })
+    }
+
     await emitCrudSideEffects({
       dataEngine: getDataEngine(ctx),
       action: 'created',
@@ -130,8 +151,28 @@ const updateAccountCommand: CommandHandler<BillingAccountUpdateInput, { id: stri
     if (parsed.nextBillDate !== undefined) record.nextBillDate = parsed.nextBillDate
     if (parsed.lastBillDate !== undefined) record.lastBillDate = parsed.lastBillDate
     if (parsed.isActive !== undefined) record.isActive = parsed.isActive
+    // SPEC-002: credit_limit is editable in both modes (billing_mode is not).
+    if (parsed.creditLimit !== undefined) record.creditLimit = formatMoney(parsed.creditLimit)
 
     record.updatedAt = new Date()
+
+    // SPEC-002: edit the prepaid balance row's low-balance threshold when
+    // supplied (null clears it back to the tenant config default). No-op for
+    // postpaid accounts (they have no balance row).
+    if (parsed.lowBalanceThreshold !== undefined && record.billingMode === 'prepaid') {
+      const balanceRow = await em.findOne(BillingAccountBalance, {
+        tenantId: parsed.tenantId,
+        billAccountId: record.id,
+      })
+      if (balanceRow) {
+        balanceRow.lowBalanceThreshold =
+          parsed.lowBalanceThreshold === null
+            ? null
+            : formatMoney(parsed.lowBalanceThreshold)
+        balanceRow.updatedAt = new Date()
+      }
+    }
+
     await em.flush()
 
     await emitCrudSideEffects({

package/src/modules/billing/commands/index.ts

@@ -11,3 +11,6 @@ import './items'
 import './usage'
 import './runs'
 import './invoices'
+import './topups'
+import './transactions'
+import './statements'