@dainamite/billing 0.20.0 → 0.21.0

package/dist/modules/billing/index.js

@@ -3,10 +3,14 @@ const metadata = {
   name: "billing",
   title: "Billing",
   version: "0.1.0",
-  description: "Lightweight recurring-billing engine \u2014 collects one-time / recurring / usage items, runs Bill Runs, produces draft invoices in core/sales.",
+  description: "Lightweight recurring-billing engine \u2014 collects one-time / recurring / usage items, runs Bill Runs and issues its own invoices, memos and top-up receipts (no core sales dependency).",
   author: "Dainamite",
   license: "MIT",
-  requires: ["auth", "directory", "dictionaries", "configs", "sales", "payment_gateways"],
+  // Spec 0: billing owns its documents. `payment_gateways` is optional
+  // (online top-ups only, resolved at runtime); no sales / configs /
+  // dictionaries dependency. Spec B: `attachments` (platform module) stores
+  // frozen invoice PDFs and the document logo.
+  requires: ["auth", "directory", "attachments"],
   ejectable: false
 };
 import { features } from "./acl.js";

package/dist/modules/billing/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/billing/index.ts"],
-  "sourcesContent": ["import type { ModuleInfo } from '@open-mercato/shared/modules/registry'\n\n// Side-effect import \u2014 registers every CRUD command in the global\n// command bus at module load time. The makeCrudRoute factory looks up\n// `actions.<verb>.commandId` against this registry at request time, so\n// without this import every billing write returns \"command not found\".\n// Pattern mirrors `@open-mercato/core/src/modules/customers/index.ts`.\nimport './commands'\n\nexport const metadata: ModuleInfo = {\n  name: 'billing',\n  title: 'Billing',\n  version: '0.1.0',\n  description:\n    'Lightweight recurring-billing engine \u2014 collects one-time / recurring / usage items, runs Bill Runs, produces draft invoices in core/sales.',\n  author: 'Dainamite',\n  license: 'MIT',\n  requires: ['auth', 'directory', 'dictionaries', 'configs', 'sales', 'payment_gateways'],\n  ejectable: false,\n}\n\nexport { features } from './acl'\n"],
-  "mappings": "AAOA,OAAO;AAEA,MAAM,WAAuB;AAAA,EAClC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,aACE;AAAA,EACF,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU,CAAC,QAAQ,aAAa,gBAAgB,WAAW,SAAS,kBAAkB;AAAA,EACtF,WAAW;AACb;AAEA,SAAS,gBAAgB;",
+  "sourcesContent": ["import type { ModuleInfo } from '@open-mercato/shared/modules/registry'\n\n// Side-effect import \u2014 registers every CRUD command in the global\n// command bus at module load time. The makeCrudRoute factory looks up\n// `actions.<verb>.commandId` against this registry at request time, so\n// without this import every billing write returns \"command not found\".\n// Pattern mirrors `@open-mercato/core/src/modules/customers/index.ts`.\nimport './commands'\n\nexport const metadata: ModuleInfo = {\n  name: 'billing',\n  title: 'Billing',\n  version: '0.1.0',\n  description:\n    'Lightweight recurring-billing engine \u2014 collects one-time / recurring / usage items, runs Bill Runs and issues its own invoices, memos and top-up receipts (no core sales dependency).',\n  author: 'Dainamite',\n  license: 'MIT',\n  // Spec 0: billing owns its documents. `payment_gateways` is optional\n  // (online top-ups only, resolved at runtime); no sales / configs /\n  // dictionaries dependency. Spec B: `attachments` (platform module) stores\n  // frozen invoice PDFs and the document logo.\n  requires: ['auth', 'directory', 'attachments'],\n  ejectable: false,\n}\n\nexport { features } from './acl'\n"],
+  "mappings": "AAOA,OAAO;AAEA,MAAM,WAAuB;AAAA,EAClC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,aACE;AAAA,EACF,QAAQ;AAAA,EACR,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,EAKT,UAAU,CAAC,QAAQ,aAAa,aAAa;AAAA,EAC7C,WAAW;AACb;AAEA,SAAS,gBAAgB;",
   "names": []
 }

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

@@ -0,0 +1,58 @@
+import { isoDay, overdueSql } from "./overdue.js";
+const ACCOUNT_FINANCIALS_SQL = `SELECT
+    i.bill_account_id,
+    COALESCE(SUM(i.outstanding), 0) AS balance_due,
+    COALESCE(SUM(i.outstanding) FILTER (WHERE ${overdueSql("i")}), 0) AS overdue_amount
+  FROM billing_invoices i
+  WHERE i.tenant_id = ? AND i.organization_id = ? AND i.bill_account_id = ANY(?::uuid[])
+    AND i.deleted_at IS NULL AND i.test_run = false
+    AND i.status IN ('posted', 'partially_paid')
+    AND i.document_type IN ('invoice', 'debit_memo')
+  GROUP BY i.bill_account_id`;
+const OVERDUE_ACCOUNT_IDS_SQL = `SELECT DISTINCT i.bill_account_id
+  FROM billing_invoices i
+  WHERE i.tenant_id = ? AND i.organization_id = ANY(?::uuid[])
+    AND i.deleted_at IS NULL AND i.test_run = false
+    AND ${overdueSql("i")}`;
+const ZERO = "0.0000";
+function money(value) {
+  const n = typeof value === "number" ? value : Number.parseFloat(value ?? "0");
+  return (Number.isFinite(n) ? n : 0).toFixed(4);
+}
+function uuidArray(ids) {
+  return `{${ids.join(",")}}`;
+}
+async function fetchAccountFinancials(em, scope, accountIds, today = /* @__PURE__ */ new Date()) {
+  const out = /* @__PURE__ */ new Map();
+  if (accountIds.length === 0) return out;
+  const rows = await em.execute(ACCOUNT_FINANCIALS_SQL, [
+    isoDay(today),
+    scope.tenantId,
+    scope.organizationId,
+    uuidArray(accountIds)
+  ]);
+  for (const row of rows ?? []) {
+    out.set(String(row.bill_account_id), { balance_due: money(row.balance_due), overdue_amount: money(row.overdue_amount) });
+  }
+  return out;
+}
+async function fetchOverdueAccountIds(em, scope, today = /* @__PURE__ */ new Date()) {
+  if (scope.organizationIds.length === 0) return [];
+  const rows = await em.execute(OVERDUE_ACCOUNT_IDS_SQL, [
+    scope.tenantId,
+    uuidArray(scope.organizationIds),
+    isoDay(today)
+  ]);
+  return (rows ?? []).map((row) => String(row.bill_account_id));
+}
+function financialsOrZero(map, accountId) {
+  return map.get(accountId) ?? { balance_due: ZERO, overdue_amount: ZERO };
+}
+export {
+  ACCOUNT_FINANCIALS_SQL,
+  OVERDUE_ACCOUNT_IDS_SQL,
+  fetchAccountFinancials,
+  fetchOverdueAccountIds,
+  financialsOrZero
+};
+//# sourceMappingURL=accountFinancials.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/accountFinancials.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { isoDay, overdueSql } from './overdue'\n\n/**\n * Account-list financials (Spec E \u00A74 / Spec F, F8, P-D15).\n *\n * One aggregate over `billing_invoices` per list page \u2014 `GROUP BY\n * bill_account_id` for the page's account ids, never a per-row fetch:\n *   - balance_due     \u03A3 outstanding of posted / partially paid receivables\n *   - overdue_amount  \u03A3 outstanding of the overdue subset\n * Test-run documents never count. Same overdue rule as the invoice list and\n * the account summary (`overdueSql`).\n */\n\nexport type AccountFinancials = { balance_due: string; overdue_amount: string }\n\nexport type FinancialsScope = { tenantId: string; organizationId: string }\n\nexport const ACCOUNT_FINANCIALS_SQL = `SELECT\n    i.bill_account_id,\n    COALESCE(SUM(i.outstanding), 0) AS balance_due,\n    COALESCE(SUM(i.outstanding) FILTER (WHERE ${overdueSql('i')}), 0) AS overdue_amount\n  FROM billing_invoices i\n  WHERE i.tenant_id = ? AND i.organization_id = ? AND i.bill_account_id = ANY(?::uuid[])\n    AND i.deleted_at IS NULL AND i.test_run = false\n    AND i.status IN ('posted', 'partially_paid')\n    AND i.document_type IN ('invoice', 'debit_memo')\n  GROUP BY i.bill_account_id`\n\nexport const OVERDUE_ACCOUNT_IDS_SQL = `SELECT DISTINCT i.bill_account_id\n  FROM billing_invoices i\n  WHERE i.tenant_id = ? AND i.organization_id = ANY(?::uuid[])\n    AND i.deleted_at IS NULL AND i.test_run = false\n    AND ${overdueSql('i')}`\n\nconst ZERO = '0.0000'\n\nfunction money(value: string | number | null | undefined): string {\n  const n = typeof value === 'number' ? value : Number.parseFloat(value ?? '0')\n  return (Number.isFinite(n) ? n : 0).toFixed(4)\n}\n\nfunction uuidArray(ids: readonly string[]): string {\n  return `{${ids.join(',')}}`\n}\n\nexport async function fetchAccountFinancials(\n  em: EntityManager,\n  scope: FinancialsScope,\n  accountIds: readonly string[],\n  today: Date = new Date(),\n): Promise<Map<string, AccountFinancials>> {\n  const out = new Map<string, AccountFinancials>()\n  if (accountIds.length === 0) return out\n  const rows = (await em.execute(ACCOUNT_FINANCIALS_SQL, [\n    isoDay(today),\n    scope.tenantId,\n    scope.organizationId,\n    uuidArray(accountIds),\n  ])) as unknown as Array<{ bill_account_id: string; balance_due: string; overdue_amount: string }>\n  for (const row of rows ?? []) {\n    out.set(String(row.bill_account_id), { balance_due: money(row.balance_due), overdue_amount: money(row.overdue_amount) })\n  }\n  return out\n}\n\n/** Ids of accounts with at least one overdue receivable (the `hasOverdue` filter). */\nexport async function fetchOverdueAccountIds(\n  em: EntityManager,\n  scope: { tenantId: string; organizationIds: readonly string[] },\n  today: Date = new Date(),\n): Promise<string[]> {\n  if (scope.organizationIds.length === 0) return []\n  const rows = (await em.execute(OVERDUE_ACCOUNT_IDS_SQL, [\n    scope.tenantId,\n    uuidArray(scope.organizationIds),\n    isoDay(today),\n  ])) as unknown as Array<{ bill_account_id: string }>\n  return (rows ?? []).map((row) => String(row.bill_account_id))\n}\n\nexport function financialsOrZero(map: Map<string, AccountFinancials>, accountId: string): AccountFinancials {\n  return map.get(accountId) ?? { balance_due: ZERO, overdue_amount: ZERO }\n}\n"],
+  "mappings": "AACA,SAAS,QAAQ,kBAAkB;AAiB5B,MAAM,yBAAyB;AAAA;AAAA;AAAA,gDAGU,WAAW,GAAG,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQxD,MAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA,UAI7B,WAAW,GAAG,CAAC;AAEzB,MAAM,OAAO;AAEb,SAAS,MAAM,OAAmD;AAChE,QAAM,IAAI,OAAO,UAAU,WAAW,QAAQ,OAAO,WAAW,SAAS,GAAG;AAC5E,UAAQ,OAAO,SAAS,CAAC,IAAI,IAAI,GAAG,QAAQ,CAAC;AAC/C;AAEA,SAAS,UAAU,KAAgC;AACjD,SAAO,IAAI,IAAI,KAAK,GAAG,CAAC;AAC1B;AAEA,eAAsB,uBACpB,IACA,OACA,YACA,QAAc,oBAAI,KAAK,GACkB;AACzC,QAAM,MAAM,oBAAI,IAA+B;AAC/C,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,QAAM,OAAQ,MAAM,GAAG,QAAQ,wBAAwB;AAAA,IACrD,OAAO,KAAK;AAAA,IACZ,MAAM;AAAA,IACN,MAAM;AAAA,IACN,UAAU,UAAU;AAAA,EACtB,CAAC;AACD,aAAW,OAAO,QAAQ,CAAC,GAAG;AAC5B,QAAI,IAAI,OAAO,IAAI,eAAe,GAAG,EAAE,aAAa,MAAM,IAAI,WAAW,GAAG,gBAAgB,MAAM,IAAI,cAAc,EAAE,CAAC;AAAA,EACzH;AACA,SAAO;AACT;AAGA,eAAsB,uBACpB,IACA,OACA,QAAc,oBAAI,KAAK,GACJ;AACnB,MAAI,MAAM,gBAAgB,WAAW,EAAG,QAAO,CAAC;AAChD,QAAM,OAAQ,MAAM,GAAG,QAAQ,yBAAyB;AAAA,IACtD,MAAM;AAAA,IACN,UAAU,MAAM,eAAe;AAAA,IAC/B,OAAO,KAAK;AAAA,EACd,CAAC;AACD,UAAQ,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,OAAO,IAAI,eAAe,CAAC;AAC9D;AAEO,SAAS,iBAAiB,KAAqC,WAAsC;AAC1G,SAAO,IAAI,IAAI,SAAS,KAAK,EAAE,aAAa,MAAM,gBAAgB,KAAK;AACzE;",
+  "names": []
+}

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

@@ -0,0 +1,14 @@
+function accountLockKey(scope) {
+  return `billing-ar:${scope.tenantId}:${scope.billAccountId}`;
+}
+async function withAccountLock(em, scope, fn) {
+  return em.transactional(async (tem) => {
+    await tem.execute("SELECT pg_advisory_xact_lock(hashtextextended(?, 0))", [accountLockKey(scope)]);
+    return fn(tem);
+  });
+}
+export {
+  accountLockKey,
+  withAccountLock
+};
+//# sourceMappingURL=accountLock.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/accountLock.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\n\n/**\n * Per-billing-account transaction-scoped advisory lock (Spec C, P-D3).\n *\n * Every change to an account's receivables \u2014 CSV import allocations, manual\n * allocate / un-allocate, credit auto-apply on post, gateway captures and\n * (Spec D) credit memo posts \u2014 runs inside this lock, so two of them can\n * never spend the same credit or over-allocate the same invoice.\n *\n * Unlike `tenantLock` (a non-blocking try-lock for bill runs), this one\n * BLOCKS: operations on one account simply queue up. The lock is released\n * when the transaction ends (commit, rollback or process death). Keep the\n * callback short \u2014 it holds a database transaction.\n */\n\nexport type AccountLockScope = { tenantId: string; billAccountId: string }\n\nexport function accountLockKey(scope: AccountLockScope): string {\n  return `billing-ar:${scope.tenantId}:${scope.billAccountId}`\n}\n\nexport async function withAccountLock<T>(\n  em: EntityManager,\n  scope: AccountLockScope,\n  fn: (tem: EntityManager) => Promise<T>,\n): Promise<T> {\n  return em.transactional(async (tem) => {\n    await (tem as EntityManager).execute('SELECT pg_advisory_xact_lock(hashtextextended(?, 0))', [accountLockKey(scope)])\n    return fn(tem as EntityManager)\n  })\n}\n"],
+  "mappings": "AAkBO,SAAS,eAAe,OAAiC;AAC9D,SAAO,cAAc,MAAM,QAAQ,IAAI,MAAM,aAAa;AAC5D;AAEA,eAAsB,gBACpB,IACA,OACA,IACY;AACZ,SAAO,GAAG,cAAc,OAAO,QAAQ;AACrC,UAAO,IAAsB,QAAQ,wDAAwD,CAAC,eAAe,KAAK,CAAC,CAAC;AACpH,WAAO,GAAG,GAAoB;AAAA,EAChC,CAAC;AACH;",
+  "names": []
+}

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

@@ -20,7 +20,7 @@ async function getBalanceSnapshot(em, account) {
   const balance = row?.balance ?? "0.0000";
   const threshold = resolveLowBalanceThreshold(
     row?.lowBalanceThreshold ?? null,
-    await getLowBalanceThresholdDefault(em)
+    await getLowBalanceThresholdDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId })
   );
   return {
     billAccountId: account.id,
@@ -33,20 +33,22 @@ async function getBalanceSnapshot(em, account) {
 }
 async function getPostpaidOutstanding(em, account) {
   const rows = await em.execute(
-    `SELECT COALESCE(SUM(outstanding_amount), 0) AS total
-       FROM sales_invoices
+    `SELECT COALESCE(SUM(outstanding), 0) AS total
+       FROM billing_invoices
       WHERE tenant_id = ?
         AND organization_id = ?
         AND deleted_at IS NULL
-        AND status = 'posted'
-        AND metadata->>'bill_account_id' = ?`,
+        AND test_run = false
+        AND status IN ('posted', 'partially_paid')
+        AND document_type IN ('invoice', 'debit_memo')
+        AND bill_account_id = ?`,
     [account.tenantId, account.organizationId, account.id]
   );
   return formatMoney(rows?.[0]?.total ?? 0);
 }
 async function getCreditSnapshot(em, account) {
   const mode = account.billingMode ?? "postpaid";
-  const nearLimitBuffer = await getNearLimitBufferDefault(em);
+  const nearLimitBuffer = await getNearLimitBufferDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId });
   let balance = null;
   let outstanding = null;
   if (mode === "prepaid") {
@@ -71,7 +73,7 @@ async function buildPostpaidCreditCrossingEvents(em, account, justPostedOutstand
   if (account.billingMode !== "postpaid") return [];
   const creditLimit = account.creditLimit ?? "0";
   if (toUnits(creditLimit) <= 0) return [];
-  const nearLimitBuffer = await getNearLimitBufferDefault(em);
+  const nearLimitBuffer = await getNearLimitBufferDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId });
   const usedAfter = await getPostpaidOutstanding(em, account);
   const usedBefore = subMoney(usedAfter, justPostedOutstanding);
   const crossing = detectCreditCrossing({

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/lib/accountStatus.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingAccount, BillingAccountBalance } from '../data/entities'\nimport type { BalanceStatus, BillingMode } from '../data/validators'\nimport {\n  computeBalanceStatus,\n  resolveLowBalanceThreshold,\n} from './balanceStatus'\nimport {\n  computeCreditSnapshot,\n  detectCreditCrossing,\n  type CreditSnapshot,\n} from './creditStatus'\nimport type { DomainEvent } from './balanceEvents'\nimport { formatMoney, subMoney, toUnits } from './money'\nimport {\n  getLowBalanceThresholdDefault,\n  getNearLimitBufferDefault,\n} from './prepaidConfig'\n\n/**\n * Read-model helpers for an account's prepaid balance + credit status\n * (SPEC-002). Shared by `GET \u2026/balance`, `GET \u2026/credit-status`, and the\n * admin Prepaid panel so the math lives in exactly one place.\n */\n\nexport type BalanceSnapshot = {\n  billAccountId: string\n  currencyCode: string\n  balance: string\n  balanceStatus: BalanceStatus\n  /** The resolved threshold (account row \u2192 tenant config default). */\n  lowBalanceThreshold: string\n  lastMovementAt: string | null\n}\n\nexport async function getBalanceSnapshot(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<BalanceSnapshot> {\n  const row = await em.findOne(BillingAccountBalance, {\n    tenantId: account.tenantId,\n    billAccountId: account.id,\n  })\n  const balance = row?.balance ?? '0.0000'\n  const threshold = resolveLowBalanceThreshold(\n    row?.lowBalanceThreshold ?? null,\n    await getLowBalanceThresholdDefault(em),\n  )\n  return {\n    billAccountId: account.id,\n    currencyCode: account.currencyCode,\n    balance: formatMoney(balance),\n    balanceStatus: computeBalanceStatus(balance, threshold),\n    lowBalanceThreshold: formatMoney(threshold),\n    lastMovementAt: row?.lastMovementAt ? row.lastMovementAt.toISOString() : null,\n  }\n}\n\n/**\n * \u03A3 outstanding of POSTED (not-yet-paid) core/sales invoices the engine\n * emitted for this account \u2014 the postpaid `credit_used` (v1; mid-period\n * accrued usage is not counted, see SPEC-002 Open Question #5). Top-up\n * receipts are `paid`, so they never count here.\n */\nexport async function getPostpaidOutstanding(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(outstanding_amount), 0) AS total\n       FROM sales_invoices\n      WHERE tenant_id = ?\n        AND organization_id = ?\n        AND deleted_at IS NULL\n        AND status = 'posted'\n        AND metadata->>'bill_account_id' = ?`,\n    [account.tenantId, account.organizationId, account.id],\n  )) as unknown as Array<{ total: string }>\n  return formatMoney(rows?.[0]?.total ?? 0)\n}\n\nexport type CreditSnapshotResult = CreditSnapshot & { currencyCode: string }\n\nexport async function getCreditSnapshot(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<CreditSnapshotResult> {\n  const mode = (account.billingMode as BillingMode) ?? 'postpaid'\n  const nearLimitBuffer = await getNearLimitBufferDefault(em)\n\n  let balance: string | null = null\n  let outstanding: string | null = null\n  if (mode === 'prepaid') {\n    const row = await em.findOne(BillingAccountBalance, {\n      tenantId: account.tenantId,\n      billAccountId: account.id,\n    })\n    balance = row?.balance ?? '0.0000'\n  } else {\n    outstanding = await getPostpaidOutstanding(em, account)\n  }\n\n  const snapshot = computeCreditSnapshot({\n    mode,\n    creditLimit: account.creditLimit ?? '0',\n    nearLimitBuffer,\n    balance,\n    outstanding,\n  })\n  return { ...snapshot, currencyCode: account.currencyCode }\n}\n\n/**\n * Credit-crossing events for a postpaid account when a draft invoice is posted\n * (SPEC-002 P6). `billing.credit.over_limit` fires once on the upward crossing\n * of `credit_used` (\u03A3 posted-unpaid outstanding) past `credit_limit`. The\n * just-posted invoice's `outstanding` is already included in the current total,\n * so the prior total is `current \u2212 justPostedOutstanding`.\n */\nexport async function buildPostpaidCreditCrossingEvents(\n  em: EntityManager,\n  account: BillingAccount,\n  justPostedOutstanding: string,\n): Promise<DomainEvent[]> {\n  if ((account.billingMode as BillingMode) !== 'postpaid') return []\n  const creditLimit = account.creditLimit ?? '0'\n  if (toUnits(creditLimit) <= 0) return []\n\n  const nearLimitBuffer = await getNearLimitBufferDefault(em)\n  const usedAfter = await getPostpaidOutstanding(em, account)\n  const usedBefore = subMoney(usedAfter, justPostedOutstanding)\n  const crossing = detectCreditCrossing({\n    creditLimit,\n    nearLimitBuffer,\n    usedBefore,\n    usedAfter,\n  })\n\n  const events: DomainEvent[] = []\n  const base = {\n    billAccountId: account.id,\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    currencyCode: account.currencyCode,\n    creditLimit,\n    creditUsed: usedAfter,\n  }\n  if (crossing.overLimitCrossedUp) {\n    events.push({ id: 'billing.credit.over_limit', payload: { ...base } })\n  }\n  if (crossing.nearLimitCrossedUp) {\n    events.push({ id: 'billing.credit.near_limit', payload: { ...base } })\n  }\n  return events\n}\n"],
-  "mappings": "AACA,SAAyB,6BAA6B;AAEtD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,aAAa,UAAU,eAAe;AAC/C;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAkBP,eAAsB,mBACpB,IACA,SAC0B;AAC1B,QAAM,MAAM,MAAM,GAAG,QAAQ,uBAAuB;AAAA,IAClD,UAAU,QAAQ;AAAA,IAClB,eAAe,QAAQ;AAAA,EACzB,CAAC;AACD,QAAM,UAAU,KAAK,WAAW;AAChC,QAAM,YAAY;AAAA,IAChB,KAAK,uBAAuB;AAAA,IAC5B,MAAM,8BAA8B,EAAE;AAAA,EACxC;AACA,SAAO;AAAA,IACL,eAAe,QAAQ;AAAA,IACvB,cAAc,QAAQ;AAAA,IACtB,SAAS,YAAY,OAAO;AAAA,IAC5B,eAAe,qBAAqB,SAAS,SAAS;AAAA,IACtD,qBAAqB,YAAY,SAAS;AAAA,IAC1C,gBAAgB,KAAK,iBAAiB,IAAI,eAAe,YAAY,IAAI;AAAA,EAC3E;AACF;AAQA,eAAsB,uBACpB,IACA,SACiB;AACjB,QAAM,OAAQ,MAAM,GAAG;AAAA,IACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,CAAC,QAAQ,UAAU,QAAQ,gBAAgB,QAAQ,EAAE;AAAA,EACvD;AACA,SAAO,YAAY,OAAO,CAAC,GAAG,SAAS,CAAC;AAC1C;AAIA,eAAsB,kBACpB,IACA,SAC+B;AAC/B,QAAM,OAAQ,QAAQ,eAA+B;AACrD,QAAM,kBAAkB,MAAM,0BAA0B,EAAE;AAE1D,MAAI,UAAyB;AAC7B,MAAI,cAA6B;AACjC,MAAI,SAAS,WAAW;AACtB,UAAM,MAAM,MAAM,GAAG,QAAQ,uBAAuB;AAAA,MAClD,UAAU,QAAQ;AAAA,MAClB,eAAe,QAAQ;AAAA,IACzB,CAAC;AACD,cAAU,KAAK,WAAW;AAAA,EAC5B,OAAO;AACL,kBAAc,MAAM,uBAAuB,IAAI,OAAO;AAAA,EACxD;AAEA,QAAM,WAAW,sBAAsB;AAAA,IACrC;AAAA,IACA,aAAa,QAAQ,eAAe;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,SAAO,EAAE,GAAG,UAAU,cAAc,QAAQ,aAAa;AAC3D;AASA,eAAsB,kCACpB,IACA,SACA,uBACwB;AACxB,MAAK,QAAQ,gBAAgC,WAAY,QAAO,CAAC;AACjE,QAAM,cAAc,QAAQ,eAAe;AAC3C,MAAI,QAAQ,WAAW,KAAK,EAAG,QAAO,CAAC;AAEvC,QAAM,kBAAkB,MAAM,0BAA0B,EAAE;AAC1D,QAAM,YAAY,MAAM,uBAAuB,IAAI,OAAO;AAC1D,QAAM,aAAa,SAAS,WAAW,qBAAqB;AAC5D,QAAM,WAAW,qBAAqB;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,SAAwB,CAAC;AAC/B,QAAM,OAAO;AAAA,IACX,eAAe,QAAQ;AAAA,IACvB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,cAAc,QAAQ;AAAA,IACtB;AAAA,IACA,YAAY;AAAA,EACd;AACA,MAAI,SAAS,oBAAoB;AAC/B,WAAO,KAAK,EAAE,IAAI,6BAA6B,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AAAA,EACvE;AACA,MAAI,SAAS,oBAAoB;AAC/B,WAAO,KAAK,EAAE,IAAI,6BAA6B,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AAAA,EACvE;AACA,SAAO;AACT;",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingAccount, BillingAccountBalance } from '../data/entities'\nimport type { BalanceStatus, BillingMode } from '../data/validators'\nimport {\n  computeBalanceStatus,\n  resolveLowBalanceThreshold,\n} from './balanceStatus'\nimport {\n  computeCreditSnapshot,\n  detectCreditCrossing,\n  type CreditSnapshot,\n} from './creditStatus'\nimport type { DomainEvent } from './balanceEvents'\nimport { formatMoney, subMoney, toUnits } from './money'\nimport {\n  getLowBalanceThresholdDefault,\n  getNearLimitBufferDefault,\n} from './prepaidConfig'\n\n/**\n * Read-model helpers for an account's prepaid balance + credit status\n * (SPEC-002). Shared by `GET \u2026/balance`, `GET \u2026/credit-status`, and the\n * admin Prepaid panel so the math lives in exactly one place.\n */\n\nexport type BalanceSnapshot = {\n  billAccountId: string\n  currencyCode: string\n  balance: string\n  balanceStatus: BalanceStatus\n  /** The resolved threshold (account row \u2192 tenant config default). */\n  lowBalanceThreshold: string\n  lastMovementAt: string | null\n}\n\nexport async function getBalanceSnapshot(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<BalanceSnapshot> {\n  const row = await em.findOne(BillingAccountBalance, {\n    tenantId: account.tenantId,\n    billAccountId: account.id,\n  })\n  const balance = row?.balance ?? '0.0000'\n  const threshold = resolveLowBalanceThreshold(\n    row?.lowBalanceThreshold ?? null,\n    await getLowBalanceThresholdDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId }),\n  )\n  return {\n    billAccountId: account.id,\n    currencyCode: account.currencyCode,\n    balance: formatMoney(balance),\n    balanceStatus: computeBalanceStatus(balance, threshold),\n    lowBalanceThreshold: formatMoney(threshold),\n    lastMovementAt: row?.lastMovementAt ? row.lastMovementAt.toISOString() : null,\n  }\n}\n\n/**\n * \u03A3 outstanding of posted / partially paid billing invoices and debit memos\n * of this account (Spec 0: billing-owned `billing_invoices`) \u2014 the postpaid `credit_used` (v1; mid-period\n * accrued usage is not counted, see SPEC-002 Open Question #5). Top-up\n * receipts are `paid`, so they never count here.\n */\nexport async function getPostpaidOutstanding(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<string> {\n  const rows = (await em.execute(\n    `SELECT COALESCE(SUM(outstanding), 0) AS total\n       FROM billing_invoices\n      WHERE tenant_id = ?\n        AND organization_id = ?\n        AND deleted_at IS NULL\n        AND test_run = false\n        AND status IN ('posted', 'partially_paid')\n        AND document_type IN ('invoice', 'debit_memo')\n        AND bill_account_id = ?`,\n    [account.tenantId, account.organizationId, account.id],\n  )) as unknown as Array<{ total: string }>\n  return formatMoney(rows?.[0]?.total ?? 0)\n}\n\nexport type CreditSnapshotResult = CreditSnapshot & { currencyCode: string }\n\nexport async function getCreditSnapshot(\n  em: EntityManager,\n  account: BillingAccount,\n): Promise<CreditSnapshotResult> {\n  const mode = (account.billingMode as BillingMode) ?? 'postpaid'\n  const nearLimitBuffer = await getNearLimitBufferDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId })\n\n  let balance: string | null = null\n  let outstanding: string | null = null\n  if (mode === 'prepaid') {\n    const row = await em.findOne(BillingAccountBalance, {\n      tenantId: account.tenantId,\n      billAccountId: account.id,\n    })\n    balance = row?.balance ?? '0.0000'\n  } else {\n    outstanding = await getPostpaidOutstanding(em, account)\n  }\n\n  const snapshot = computeCreditSnapshot({\n    mode,\n    creditLimit: account.creditLimit ?? '0',\n    nearLimitBuffer,\n    balance,\n    outstanding,\n  })\n  return { ...snapshot, currencyCode: account.currencyCode }\n}\n\n/**\n * Credit-crossing events for a postpaid account when a draft invoice is posted\n * (SPEC-002 P6). `billing.credit.over_limit` fires once on the upward crossing\n * of `credit_used` (\u03A3 posted-unpaid outstanding) past `credit_limit`. The\n * just-posted invoice's `outstanding` is already included in the current total,\n * so the prior total is `current \u2212 justPostedOutstanding`.\n */\nexport async function buildPostpaidCreditCrossingEvents(\n  em: EntityManager,\n  account: BillingAccount,\n  justPostedOutstanding: string,\n): Promise<DomainEvent[]> {\n  if ((account.billingMode as BillingMode) !== 'postpaid') return []\n  const creditLimit = account.creditLimit ?? '0'\n  if (toUnits(creditLimit) <= 0) return []\n\n  const nearLimitBuffer = await getNearLimitBufferDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId })\n  const usedAfter = await getPostpaidOutstanding(em, account)\n  const usedBefore = subMoney(usedAfter, justPostedOutstanding)\n  const crossing = detectCreditCrossing({\n    creditLimit,\n    nearLimitBuffer,\n    usedBefore,\n    usedAfter,\n  })\n\n  const events: DomainEvent[] = []\n  const base = {\n    billAccountId: account.id,\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    currencyCode: account.currencyCode,\n    creditLimit,\n    creditUsed: usedAfter,\n  }\n  if (crossing.overLimitCrossedUp) {\n    events.push({ id: 'billing.credit.over_limit', payload: { ...base } })\n  }\n  if (crossing.nearLimitCrossedUp) {\n    events.push({ id: 'billing.credit.near_limit', payload: { ...base } })\n  }\n  return events\n}\n"],
+  "mappings": "AACA,SAAyB,6BAA6B;AAEtD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,aAAa,UAAU,eAAe;AAC/C;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAkBP,eAAsB,mBACpB,IACA,SAC0B;AAC1B,QAAM,MAAM,MAAM,GAAG,QAAQ,uBAAuB;AAAA,IAClD,UAAU,QAAQ;AAAA,IAClB,eAAe,QAAQ;AAAA,EACzB,CAAC;AACD,QAAM,UAAU,KAAK,WAAW;AAChC,QAAM,YAAY;AAAA,IAChB,KAAK,uBAAuB;AAAA,IAC5B,MAAM,8BAA8B,IAAI,EAAE,UAAU,QAAQ,UAAU,gBAAgB,QAAQ,eAAe,CAAC;AAAA,EAChH;AACA,SAAO;AAAA,IACL,eAAe,QAAQ;AAAA,IACvB,cAAc,QAAQ;AAAA,IACtB,SAAS,YAAY,OAAO;AAAA,IAC5B,eAAe,qBAAqB,SAAS,SAAS;AAAA,IACtD,qBAAqB,YAAY,SAAS;AAAA,IAC1C,gBAAgB,KAAK,iBAAiB,IAAI,eAAe,YAAY,IAAI;AAAA,EAC3E;AACF;AAQA,eAAsB,uBACpB,IACA,SACiB;AACjB,QAAM,OAAQ,MAAM,GAAG;AAAA,IACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASA,CAAC,QAAQ,UAAU,QAAQ,gBAAgB,QAAQ,EAAE;AAAA,EACvD;AACA,SAAO,YAAY,OAAO,CAAC,GAAG,SAAS,CAAC;AAC1C;AAIA,eAAsB,kBACpB,IACA,SAC+B;AAC/B,QAAM,OAAQ,QAAQ,eAA+B;AACrD,QAAM,kBAAkB,MAAM,0BAA0B,IAAI,EAAE,UAAU,QAAQ,UAAU,gBAAgB,QAAQ,eAAe,CAAC;AAElI,MAAI,UAAyB;AAC7B,MAAI,cAA6B;AACjC,MAAI,SAAS,WAAW;AACtB,UAAM,MAAM,MAAM,GAAG,QAAQ,uBAAuB;AAAA,MAClD,UAAU,QAAQ;AAAA,MAClB,eAAe,QAAQ;AAAA,IACzB,CAAC;AACD,cAAU,KAAK,WAAW;AAAA,EAC5B,OAAO;AACL,kBAAc,MAAM,uBAAuB,IAAI,OAAO;AAAA,EACxD;AAEA,QAAM,WAAW,sBAAsB;AAAA,IACrC;AAAA,IACA,aAAa,QAAQ,eAAe;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,SAAO,EAAE,GAAG,UAAU,cAAc,QAAQ,aAAa;AAC3D;AASA,eAAsB,kCACpB,IACA,SACA,uBACwB;AACxB,MAAK,QAAQ,gBAAgC,WAAY,QAAO,CAAC;AACjE,QAAM,cAAc,QAAQ,eAAe;AAC3C,MAAI,QAAQ,WAAW,KAAK,EAAG,QAAO,CAAC;AAEvC,QAAM,kBAAkB,MAAM,0BAA0B,IAAI,EAAE,UAAU,QAAQ,UAAU,gBAAgB,QAAQ,eAAe,CAAC;AAClI,QAAM,YAAY,MAAM,uBAAuB,IAAI,OAAO;AAC1D,QAAM,aAAa,SAAS,WAAW,qBAAqB;AAC5D,QAAM,WAAW,qBAAqB;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,SAAwB,CAAC;AAC/B,QAAM,OAAO;AAAA,IACX,eAAe,QAAQ;AAAA,IACvB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,cAAc,QAAQ;AAAA,IACtB;AAAA,IACA,YAAY;AAAA,EACd;AACA,MAAI,SAAS,oBAAoB;AAC/B,WAAO,KAAK,EAAE,IAAI,6BAA6B,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AAAA,EACvE;AACA,MAAI,SAAS,oBAAoB;AAC/B,WAAO,KAAK,EAAE,IAAI,6BAA6B,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AAAA,EACvE;AACA,SAAO;AACT;",
   "names": []
 }

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

@@ -0,0 +1,106 @@
+import { isoDay, overdueSql } from "./overdue.js";
+import { getAccountCredit } from "./allocation.js";
+import { computeBalanceStatus, resolveLowBalanceThreshold } from "./balanceStatus.js";
+import { getLowBalanceThresholdDefault } from "./prepaidConfig.js";
+import { toIsoDate } from "./dateOnly.js";
+const ACCOUNT_SUMMARY_SQL = `SELECT
+    COALESCE(SUM(i.outstanding), 0) AS open_amount,
+    COALESCE(SUM(i.outstanding) FILTER (WHERE ${overdueSql("i")}), 0) AS overdue_amount,
+    COUNT(*) FILTER (WHERE ${overdueSql("i")})::int AS overdue_count
+  FROM billing_invoices i
+  WHERE i.tenant_id = ? AND i.organization_id = ? AND i.bill_account_id = ?
+    AND i.deleted_at IS NULL AND i.test_run = false
+    AND i.status IN ('posted', 'partially_paid')
+    AND i.document_type IN ('invoice', 'debit_memo')`;
+function money(value) {
+  const n = typeof value === "number" ? value : Number.parseFloat(value ?? "0");
+  return (Number.isFinite(n) ? n : 0).toFixed(4);
+}
+async function getAccountArSummary(em, account, today = /* @__PURE__ */ new Date()) {
+  const day = isoDay(today);
+  const rows = await em.execute(ACCOUNT_SUMMARY_SQL, [
+    day,
+    day,
+    account.tenantId,
+    account.organizationId,
+    account.id
+  ]);
+  const row = rows?.[0];
+  return {
+    bill_account_id: account.id,
+    currency_code: account.currencyCode,
+    open_amount: money(row?.open_amount),
+    overdue_amount: money(row?.overdue_amount),
+    overdue_count: Number(row?.overdue_count ?? 0) || 0,
+    credit_amount: await getAccountCredit(
+      em,
+      { tenantId: account.tenantId, organizationId: account.organizationId },
+      { id: account.id, currencyCode: account.currencyCode }
+    )
+  };
+}
+const LAST_INVOICE_SQL = `SELECT id, number, issue_date, total_gross
+  FROM billing_invoices
+  WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?
+    AND deleted_at IS NULL AND test_run = false
+    AND document_type IN ('invoice', 'debit_memo')
+    AND status NOT IN ('draft')
+  ORDER BY issue_date DESC NULLS LAST, created_at DESC
+  LIMIT 1`;
+const BALANCE_SQL = `SELECT balance, low_balance_threshold
+  FROM billing_account_balances
+  WHERE tenant_id = ? AND bill_account_id = ?
+  LIMIT 1`;
+const LAST_STATEMENT_SQL = `SELECT id, period_start, period_end, closing_balance
+  FROM billing_statements
+  WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?
+  ORDER BY period_end DESC
+  LIMIT 1`;
+async function getAccountWorkspaceSummary(em, account, today = /* @__PURE__ */ new Date()) {
+  const ar = await getAccountArSummary(em, account, today);
+  const scopeParams = [account.tenantId, account.organizationId, account.id];
+  const lastInvoice = (await em.execute(LAST_INVOICE_SQL, scopeParams))?.[0];
+  let prepaid = null;
+  if (account.billingMode === "prepaid") {
+    const balanceRow = (await em.execute(BALANCE_SQL, [account.tenantId, account.id]))?.[0];
+    const statement = (await em.execute(LAST_STATEMENT_SQL, scopeParams))?.[0];
+    const balance = money(balanceRow?.balance);
+    const threshold = resolveLowBalanceThreshold(
+      balanceRow?.low_balance_threshold ?? null,
+      await getLowBalanceThresholdDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId })
+    );
+    prepaid = {
+      balance,
+      balance_status: computeBalanceStatus(balance, threshold),
+      credit_limit: money(account.creditLimit),
+      last_statement: statement ? {
+        id: statement.id,
+        period_start: toIsoDate(statement.period_start),
+        period_end: toIsoDate(statement.period_end),
+        closing_balance: money(statement.closing_balance)
+      } : null
+    };
+  }
+  return {
+    ...ar,
+    billing_mode: account.billingMode === "prepaid" ? "prepaid" : "postpaid",
+    bill_cycle: account.billCycle,
+    next_bill_date: account.nextBillDate ? toIsoDate(account.nextBillDate) : null,
+    last_invoice: lastInvoice ? {
+      id: lastInvoice.id,
+      number: lastInvoice.number,
+      issue_date: lastInvoice.issue_date ? toIsoDate(lastInvoice.issue_date) : null,
+      total_gross: money(lastInvoice.total_gross)
+    } : null,
+    prepaid
+  };
+}
+export {
+  ACCOUNT_SUMMARY_SQL,
+  BALANCE_SQL,
+  LAST_INVOICE_SQL,
+  LAST_STATEMENT_SQL,
+  getAccountArSummary,
+  getAccountWorkspaceSummary
+};
+//# sourceMappingURL=accountSummary.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/accountSummary.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { BillingAccount } from '../data/entities'\nimport { isoDay, overdueSql } from './overdue'\nimport { getAccountCredit } from './allocation'\nimport { computeBalanceStatus, resolveLowBalanceThreshold } from './balanceStatus'\nimport { getLowBalanceThresholdDefault } from './prepaidConfig'\nimport { toIsoDate } from './dateOnly'\n\n/**\n * Accounts-receivable summary of one billing account (Spec B; the endpoint\n * is Spec E's `GET /api/billing/accounts/{id}/summary`, which later adds the\n * prepaid balance and next bill date to the same response).\n *\n * One aggregate query over `billing_invoices` (indexed on\n * `bill_account_id, status, due_date`), no ORM hydration:\n *   - open_amount    \u03A3 outstanding of posted / partially paid receivables\n *   - overdue_amount \u03A3 outstanding of the overdue subset (B-D6)\n *   - overdue_count  number of overdue documents\n *   - credit_amount  unapplied credit (Spec C): unallocated payments + open\n *                    credit memos of the account\n * Test-run documents never count.\n */\n\nexport type AccountArSummary = {\n  bill_account_id: string\n  currency_code: string\n  open_amount: string\n  overdue_amount: string\n  overdue_count: number\n  credit_amount: string\n}\n\ntype SummaryRow = { open_amount: string | null; overdue_amount: string | null; overdue_count: number | string | null }\n\nexport const ACCOUNT_SUMMARY_SQL = `SELECT\n    COALESCE(SUM(i.outstanding), 0) AS open_amount,\n    COALESCE(SUM(i.outstanding) FILTER (WHERE ${overdueSql('i')}), 0) AS overdue_amount,\n    COUNT(*) FILTER (WHERE ${overdueSql('i')})::int AS overdue_count\n  FROM billing_invoices i\n  WHERE i.tenant_id = ? AND i.organization_id = ? AND i.bill_account_id = ?\n    AND i.deleted_at IS NULL AND i.test_run = false\n    AND i.status IN ('posted', 'partially_paid')\n    AND i.document_type IN ('invoice', 'debit_memo')`\n\nfunction money(value: string | number | null | undefined): string {\n  const n = typeof value === 'number' ? value : Number.parseFloat(value ?? '0')\n  return (Number.isFinite(n) ? n : 0).toFixed(4)\n}\n\nexport async function getAccountArSummary(\n  em: EntityManager,\n  account: Pick<BillingAccount, 'id' | 'tenantId' | 'organizationId' | 'currencyCode'>,\n  today: Date = new Date(),\n): Promise<AccountArSummary> {\n  const day = isoDay(today)\n  const rows = (await em.execute(ACCOUNT_SUMMARY_SQL, [\n    day,\n    day,\n    account.tenantId,\n    account.organizationId,\n    account.id,\n  ])) as unknown as SummaryRow[]\n  const row = rows?.[0]\n  return {\n    bill_account_id: account.id,\n    currency_code: account.currencyCode,\n    open_amount: money(row?.open_amount),\n    overdue_amount: money(row?.overdue_amount),\n    overdue_count: Number(row?.overdue_count ?? 0) || 0,\n    credit_amount: await getAccountCredit(\n      em,\n      { tenantId: account.tenantId, organizationId: account.organizationId },\n      { id: account.id, currencyCode: account.currencyCode },\n    ),\n  }\n}\n\n// \u2500\u2500\u2500 Spec E / Spec F (F8): the account workspace header \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type AccountWorkspaceSummary = AccountArSummary & {\n  billing_mode: 'postpaid' | 'prepaid'\n  bill_cycle: string\n  next_bill_date: string | null\n  last_invoice: { id: string; number: string; issue_date: string | null; total_gross: string } | null\n  prepaid: {\n    balance: string\n    balance_status: 'ok' | 'low' | 'exhausted'\n    credit_limit: string\n    last_statement: { id: string; period_start: string; period_end: string; closing_balance: string } | null\n  } | null\n}\n\ntype LastInvoiceRow = { id: string; number: string; issue_date: string | Date | null; total_gross: string }\ntype BalanceRow = { balance: string | null; low_balance_threshold: string | null }\ntype StatementRow = { id: string; period_start: string | Date; period_end: string | Date; closing_balance: string }\n\nexport const LAST_INVOICE_SQL = `SELECT id, number, issue_date, total_gross\n  FROM billing_invoices\n  WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n    AND deleted_at IS NULL AND test_run = false\n    AND document_type IN ('invoice', 'debit_memo')\n    AND status NOT IN ('draft')\n  ORDER BY issue_date DESC NULLS LAST, created_at DESC\n  LIMIT 1`\n\nexport const BALANCE_SQL = `SELECT balance, low_balance_threshold\n  FROM billing_account_balances\n  WHERE tenant_id = ? AND bill_account_id = ?\n  LIMIT 1`\n\nexport const LAST_STATEMENT_SQL = `SELECT id, period_start, period_end, closing_balance\n  FROM billing_statements\n  WHERE tenant_id = ? AND organization_id = ? AND bill_account_id = ?\n  ORDER BY period_end DESC\n  LIMIT 1`\n\n/**\n * Everything the account header shows, in a fixed number of small indexed\n * queries (no ORM hydration, no per-document fetch): the AR summary, cycle\n * state, the last posted invoice and \u2014 for prepaid accounts \u2014 the balance\n * with its status, the credit limit and the last statement.\n */\nexport async function getAccountWorkspaceSummary(\n  em: EntityManager,\n  account: Pick<\n    BillingAccount,\n    'id' | 'tenantId' | 'organizationId' | 'currencyCode' | 'billingMode' | 'billCycle' | 'nextBillDate' | 'creditLimit'\n  >,\n  today: Date = new Date(),\n): Promise<AccountWorkspaceSummary> {\n  const ar = await getAccountArSummary(em, account, today)\n  const scopeParams = [account.tenantId, account.organizationId, account.id]\n  const lastInvoice = ((await em.execute(LAST_INVOICE_SQL, scopeParams)) as unknown as LastInvoiceRow[])?.[0]\n  let prepaid: AccountWorkspaceSummary['prepaid'] = null\n  if (account.billingMode === 'prepaid') {\n    const balanceRow = ((await em.execute(BALANCE_SQL, [account.tenantId, account.id])) as unknown as BalanceRow[])?.[0]\n    const statement = ((await em.execute(LAST_STATEMENT_SQL, scopeParams)) as unknown as StatementRow[])?.[0]\n    const balance = money(balanceRow?.balance)\n    const threshold = resolveLowBalanceThreshold(\n      balanceRow?.low_balance_threshold ?? null,\n      await getLowBalanceThresholdDefault(em, { tenantId: account.tenantId, organizationId: account.organizationId }),\n    )\n    prepaid = {\n      balance,\n      balance_status: computeBalanceStatus(balance, threshold),\n      credit_limit: money(account.creditLimit),\n      last_statement: statement\n        ? {\n            id: statement.id,\n            period_start: toIsoDate(statement.period_start),\n            period_end: toIsoDate(statement.period_end),\n            closing_balance: money(statement.closing_balance),\n          }\n        : null,\n    }\n  }\n  return {\n    ...ar,\n    billing_mode: account.billingMode === 'prepaid' ? 'prepaid' : 'postpaid',\n    bill_cycle: account.billCycle,\n    next_bill_date: account.nextBillDate ? toIsoDate(account.nextBillDate) : null,\n    last_invoice: lastInvoice\n      ? {\n          id: lastInvoice.id,\n          number: lastInvoice.number,\n          issue_date: lastInvoice.issue_date ? toIsoDate(lastInvoice.issue_date) : null,\n          total_gross: money(lastInvoice.total_gross),\n        }\n      : null,\n    prepaid,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}