@dainamite/billing 0.19.0 → 0.21.0

package/dist/modules/billing/subscribers/prepaid-topup-captured.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/subscribers/prepaid-topup-captured.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport type { SalesDocumentNumberGenerator } from '@open-mercato/core/modules/sales/services/salesDocumentNumberGenerator'\nimport type { TaxCalculationService } from '@open-mercato/core/modules/sales/services/taxCalculationService'\nimport { BillingAccount, BillingTopup } from '../data/entities'\nimport { emitBillingEvent } from '../events'\nimport { captureTopup } from '../lib/topupCapture'\nimport { getTopupTaxRate } from '../lib/prepaidConfig'\n\n/**\n * Subscriber: `payment_gateways.payment.captured` \u2192 prepaid top-up captured.\n *\n * Coexists with `payment-captured-to-paid.ts`: that subscriber matches\n * `paymentId == invoiceId` (postpaid), while a top-up's `paymentId` is a\n * minted UUID that only ever matches a `BillingTopup`. Finding the\n * BillingTopup IS the guard \u2014 for any non-top-up payment this is a silent\n * no-op.\n *\n * Idempotent: a re-fired capture on an already-captured top-up is a no-op\n * (the gateway delivers webhooks at-least-once).\n */\n\nexport const metadata = {\n  event: 'payment_gateways.payment.captured',\n  persistent: true,\n  id: 'billing-prepaid-topup-captured',\n}\n\ntype CapturedPayload = {\n  paymentId?: string\n  transactionId?: string\n  organizationId?: string\n  tenantId?: string\n  providerKey?: string\n}\n\nexport default async function handle(payload: CapturedPayload): Promise<void> {\n  if (!payload?.paymentId || !payload.tenantId || !payload.organizationId) {\n    return\n  }\n\n  const container = await createRequestContainer()\n  const em = (container.resolve('em') as EntityManager).fork()\n\n  const topup = await em.findOne(BillingTopup, {\n    paymentId: payload.paymentId,\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n    deletedAt: null,\n  })\n  if (!topup) {\n    // Not a prepaid top-up \u2014 other subscribers own this captured payment.\n    return\n  }\n  if (topup.status === 'captured') {\n    return // idempotent re-fire\n  }\n\n  const account = await em.findOne(BillingAccount, {\n    id: topup.billAccountId,\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n    deletedAt: null,\n  })\n  if (!account) {\n    return\n  }\n\n  const taxRate = await getTopupTaxRate(em)\n  const numberGenerator = container.resolve(\n    'salesDocumentNumberGenerator',\n  ) as SalesDocumentNumberGenerator\n  const taxService = container.resolve('taxCalculationService') as TaxCalculationService\n\n  const result = await captureTopup(\n    em,\n    { numberGenerator, taxService },\n    {\n      topup,\n      account: {\n        id: account.id,\n        organizationId: account.organizationId,\n        tenantId: account.tenantId,\n        currencyCode: account.currencyCode,\n      },\n      taxRate,\n      gatewayTransactionId: payload.transactionId ?? null,\n    },\n  )\n\n  if (result.status !== 'captured') return\n\n  // Side effects fire AFTER the capture transaction commits.\n  await emitBillingEvent('billing.balance.topped_up', {\n    billAccountId: account.id,\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    topupId: topup.id,\n    amount: topup.amount,\n    currencyCode: account.currencyCode,\n    balance: result.balanceAfter ?? null,\n    transactionId: result.transactionId ?? null,\n    receiptInvoiceId: result.receiptInvoiceId ?? null,\n  })\n\n  // Reuse the postpaid receipt path so the existing mailer / accounting bridge\n  // sends the top-up VAT receipt.\n  if (result.receiptInvoiceId) {\n    await emitBillingEvent('billing.invoice.posted', {\n      invoiceId: result.receiptInvoiceId,\n      invoiceNumber: result.invoiceNumber ?? null,\n      tenantId: account.tenantId,\n      organizationId: account.organizationId,\n      grandTotalGross: result.grossAmount ?? null,\n      currencyCode: account.currencyCode,\n      billAccountId: account.id,\n      kind: 'prepaid_topup',\n    })\n  }\n}\n"],
-  "mappings": "AACA,SAAS,8BAA8B;AAGvC,SAAS,gBAAgB,oBAAoB;AAC7C,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAezB,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAUA,eAAO,OAA8B,SAAyC;AAC5E,MAAI,CAAC,SAAS,aAAa,CAAC,QAAQ,YAAY,CAAC,QAAQ,gBAAgB;AACvE;AAAA,EACF;AAEA,QAAM,YAAY,MAAM,uBAAuB;AAC/C,QAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAE3D,QAAM,QAAQ,MAAM,GAAG,QAAQ,cAAc;AAAA,IAC3C,WAAW,QAAQ;AAAA,IACnB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AACD,MAAI,CAAC,OAAO;AAEV;AAAA,EACF;AACA,MAAI,MAAM,WAAW,YAAY;AAC/B;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,GAAG,QAAQ,gBAAgB;AAAA,IAC/C,IAAI,MAAM;AAAA,IACV,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AACD,MAAI,CAAC,SAAS;AACZ;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,gBAAgB,EAAE;AACxC,QAAM,kBAAkB,UAAU;AAAA,IAChC;AAAA,EACF;AACA,QAAM,aAAa,UAAU,QAAQ,uBAAuB;AAE5D,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA,EAAE,iBAAiB,WAAW;AAAA,IAC9B;AAAA,MACE;AAAA,MACA,SAAS;AAAA,QACP,IAAI,QAAQ;AAAA,QACZ,gBAAgB,QAAQ;AAAA,QACxB,UAAU,QAAQ;AAAA,QAClB,cAAc,QAAQ;AAAA,MACxB;AAAA,MACA;AAAA,MACA,sBAAsB,QAAQ,iBAAiB;AAAA,IACjD;AAAA,EACF;AAEA,MAAI,OAAO,WAAW,WAAY;AAGlC,QAAM,iBAAiB,6BAA6B;AAAA,IAClD,eAAe,QAAQ;AAAA,IACvB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,cAAc,QAAQ;AAAA,IACtB,SAAS,OAAO,gBAAgB;AAAA,IAChC,eAAe,OAAO,iBAAiB;AAAA,IACvC,kBAAkB,OAAO,oBAAoB;AAAA,EAC/C,CAAC;AAID,MAAI,OAAO,kBAAkB;AAC3B,UAAM,iBAAiB,0BAA0B;AAAA,MAC/C,WAAW,OAAO;AAAA,MAClB,eAAe,OAAO,iBAAiB;AAAA,MACvC,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,iBAAiB,OAAO,eAAe;AAAA,MACvC,cAAc,QAAQ;AAAA,MACtB,eAAe,QAAQ;AAAA,MACvB,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AACF;",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { BillingAccount, BillingTopup } from '../data/entities'\nimport { emitBillingEvent } from '../events'\nimport { captureTopup } from '../lib/topupCapture'\nimport { getTopupTaxRate } from '../lib/prepaidConfig'\n\n/**\n * Subscriber: `payment_gateways.payment.captured` \u2192 prepaid top-up captured.\n *\n * Coexists with `payment-captured-to-paid.ts`: that subscriber matches\n * `paymentId == invoiceId` (postpaid), while a top-up's `paymentId` is a\n * minted UUID that only ever matches a `BillingTopup`. Finding the\n * BillingTopup IS the guard \u2014 for any non-top-up payment this is a silent\n * no-op.\n *\n * Idempotent: a re-fired capture on an already-captured top-up is a no-op\n * (the gateway delivers webhooks at-least-once).\n */\n\nexport const metadata = {\n  event: 'payment_gateways.payment.captured',\n  persistent: true,\n  id: 'billing-prepaid-topup-captured',\n}\n\ntype CapturedPayload = {\n  paymentId?: string\n  transactionId?: string\n  organizationId?: string\n  tenantId?: string\n  providerKey?: string\n}\n\nexport default async function handle(payload: CapturedPayload): Promise<void> {\n  if (!payload?.paymentId || !payload.tenantId || !payload.organizationId) {\n    return\n  }\n\n  const container = await createRequestContainer()\n  const em = (container.resolve('em') as EntityManager).fork()\n\n  const topup = await em.findOne(BillingTopup, {\n    paymentId: payload.paymentId,\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n    deletedAt: null,\n  })\n  if (!topup) {\n    // Not a prepaid top-up \u2014 other subscribers own this captured payment.\n    return\n  }\n  if (topup.status === 'captured') {\n    return // idempotent re-fire\n  }\n\n  const account = await em.findOne(BillingAccount, {\n    id: topup.billAccountId,\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n    deletedAt: null,\n  })\n  if (!account) {\n    return\n  }\n\n  const taxRate = await getTopupTaxRate(em, {\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n  })\n\n  const result = await captureTopup(\n    em,\n    {\n      topup,\n      account: {\n        id: account.id,\n        organizationId: account.organizationId,\n        tenantId: account.tenantId,\n        currencyCode: account.currencyCode,\n      },\n      taxRate,\n      gatewayTransactionId: payload.transactionId ?? null,\n    },\n  )\n\n  if (result.status !== 'captured') return\n\n  // Side effects fire AFTER the capture transaction commits.\n  await emitBillingEvent('billing.balance.topped_up', {\n    billAccountId: account.id,\n    tenantId: account.tenantId,\n    organizationId: account.organizationId,\n    topupId: topup.id,\n    amount: topup.amount,\n    currencyCode: account.currencyCode,\n    balance: result.balanceAfter ?? null,\n    transactionId: result.transactionId ?? null,\n    receiptInvoiceId: result.receiptInvoiceId ?? null,\n  })\n\n  // Reuse the postpaid receipt path so the existing mailer / accounting bridge\n  // sends the top-up VAT receipt.\n  if (result.receiptInvoiceId) {\n    await emitBillingEvent('billing.invoice.posted', {\n      invoiceId: result.receiptInvoiceId,\n      invoiceNumber: result.invoiceNumber ?? null,\n      tenantId: account.tenantId,\n      organizationId: account.organizationId,\n      grandTotalGross: result.grossAmount ?? null,\n      currencyCode: account.currencyCode,\n      billAccountId: account.id,\n      kind: 'prepaid_topup',\n    })\n  }\n}\n"],
+  "mappings": "AACA,SAAS,8BAA8B;AACvC,SAAS,gBAAgB,oBAAoB;AAC7C,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAezB,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAUA,eAAO,OAA8B,SAAyC;AAC5E,MAAI,CAAC,SAAS,aAAa,CAAC,QAAQ,YAAY,CAAC,QAAQ,gBAAgB;AACvE;AAAA,EACF;AAEA,QAAM,YAAY,MAAM,uBAAuB;AAC/C,QAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAE3D,QAAM,QAAQ,MAAM,GAAG,QAAQ,cAAc;AAAA,IAC3C,WAAW,QAAQ;AAAA,IACnB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AACD,MAAI,CAAC,OAAO;AAEV;AAAA,EACF;AACA,MAAI,MAAM,WAAW,YAAY;AAC/B;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,GAAG,QAAQ,gBAAgB;AAAA,IAC/C,IAAI,MAAM;AAAA,IACV,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AACD,MAAI,CAAC,SAAS;AACZ;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,gBAAgB,IAAI;AAAA,IACxC,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,EAC1B,CAAC;AAED,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,MACE;AAAA,MACA,SAAS;AAAA,QACP,IAAI,QAAQ;AAAA,QACZ,gBAAgB,QAAQ;AAAA,QACxB,UAAU,QAAQ;AAAA,QAClB,cAAc,QAAQ;AAAA,MACxB;AAAA,MACA;AAAA,MACA,sBAAsB,QAAQ,iBAAiB;AAAA,IACjD;AAAA,EACF;AAEA,MAAI,OAAO,WAAW,WAAY;AAGlC,QAAM,iBAAiB,6BAA6B;AAAA,IAClD,eAAe,QAAQ;AAAA,IACvB,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,cAAc,QAAQ;AAAA,IACtB,SAAS,OAAO,gBAAgB;AAAA,IAChC,eAAe,OAAO,iBAAiB;AAAA,IACvC,kBAAkB,OAAO,oBAAoB;AAAA,EAC/C,CAAC;AAID,MAAI,OAAO,kBAAkB;AAC3B,UAAM,iBAAiB,0BAA0B;AAAA,MAC/C,WAAW,OAAO;AAAA,MAClB,eAAe,OAAO,iBAAiB;AAAA,MACvC,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,iBAAiB,OAAO,eAAe;AAAA,MACvC,cAAc,QAAQ;AAAA,MACtB,eAAe,QAAQ;AAAA,MACvB,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AACF;",
   "names": []
 }

package/dist/modules/billing/workers/reap-stale-bill-runs.js

@@ -1,4 +1,4 @@
-import { BillRun } from "../data/entities.js";
+import { BillingRun } from "../data/entities.js";
 const metadata = {
   queue: "billing-reap-stale-runs",
   id: "billing:reap-stale-bill-runs",
@@ -8,7 +8,7 @@ const STALE_THRESHOLD_MS = 60 * 60 * 1e3;
 async function handle(_job, ctx) {
   const em = ctx.resolve("em");
   const threshold = new Date(Date.now() - STALE_THRESHOLD_MS);
-  const stale = await em.find(BillRun, {
+  const stale = await em.find(BillingRun, {
     status: "running",
     startedAt: { $lt: threshold }
   });

package/dist/modules/billing/workers/reap-stale-bill-runs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/workers/reap-stale-bill-runs.ts"],
-  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { FilterQuery } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillRun } from '../data/entities'\n\nexport const metadata: WorkerMeta = {\n  queue: 'billing-reap-stale-runs',\n  id: 'billing:reap-stale-bill-runs',\n  concurrency: 1,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\n/**\n * Reaper for \"zombie\" Bill Runs left in `status='running'` after a crash.\n *\n * Background \u2014 the Bill Run engine acquires a per-tenant Postgres\n * transaction-scoped advisory lock (`pg_try_advisory_xact_lock`). When the\n * holding transaction ends (commit / rollback / process death) the lock is\n * released automatically \u2014 so there is no lock leak \u2014 but the `BillRun`\n * row's `status='running'` stays set forever, blocking restarts and\n * confusing the dashboard.\n *\n * Phase 0 ships this as the **registered worker shell** so the module's\n * worker auto-discovery includes it from day one. The active-advisory-lock\n * check (which is what distinguishes a real zombie from a healthy\n * long-running run) lands with the Bill Run engine itself in Phase 2.\n *\n * For now the heuristic is time-only: any `running` row older than 1 hour\n * is marked failed with an explanatory message. That is conservative \u2014\n * real runs almost never take an hour even for 500k-account tenants\n * (see spec Performance Considerations).\n */\nconst STALE_THRESHOLD_MS = 60 * 60 * 1000 // 1 hour\n\nexport default async function handle(_job: QueuedJob, ctx: HandlerContext): Promise<void> {\n  const em = ctx.resolve<EntityManager>('em')\n  const threshold = new Date(Date.now() - STALE_THRESHOLD_MS)\n  const stale = await em.find(BillRun, {\n    status: 'running',\n    startedAt: { $lt: threshold },\n  } satisfies FilterQuery<BillRun>)\n  if (stale.length === 0) return\n  const now = new Date()\n  for (const run of stale) {\n    run.status = 'failed'\n    run.finishedAt = now\n    const summary = (run.summary ?? {}) as Record<string, unknown>\n    summary.reaper_message =\n      'Stale running run reaped after crash; advisory lock released'\n    summary.reaped_at = now.toISOString()\n    run.summary = summary\n  }\n  await em.flush()\n}\n"],
-  "mappings": "AAGA,SAAS,eAAe;AAEjB,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AA0BA,MAAM,qBAAqB,KAAK,KAAK;AAErC,eAAO,OAA8B,MAAiB,KAAoC;AACxF,QAAM,KAAK,IAAI,QAAuB,IAAI;AAC1C,QAAM,YAAY,IAAI,KAAK,KAAK,IAAI,IAAI,kBAAkB;AAC1D,QAAM,QAAQ,MAAM,GAAG,KAAK,SAAS;AAAA,IACnC,QAAQ;AAAA,IACR,WAAW,EAAE,KAAK,UAAU;AAAA,EAC9B,CAAgC;AAChC,MAAI,MAAM,WAAW,EAAG;AACxB,QAAM,MAAM,oBAAI,KAAK;AACrB,aAAW,OAAO,OAAO;AACvB,QAAI,SAAS;AACb,QAAI,aAAa;AACjB,UAAM,UAAW,IAAI,WAAW,CAAC;AACjC,YAAQ,iBACN;AACF,YAAQ,YAAY,IAAI,YAAY;AACpC,QAAI,UAAU;AAAA,EAChB;AACA,QAAM,GAAG,MAAM;AACjB;",
+  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { FilterQuery } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingRun } from '../data/entities'\n\nexport const metadata: WorkerMeta = {\n  queue: 'billing-reap-stale-runs',\n  id: 'billing:reap-stale-bill-runs',\n  concurrency: 1,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\n/**\n * Reaper for \"zombie\" Bill Runs left in `status='running'` after a crash.\n *\n * Background \u2014 the Bill Run engine acquires a per-tenant Postgres\n * transaction-scoped advisory lock (`pg_try_advisory_xact_lock`). When the\n * holding transaction ends (commit / rollback / process death) the lock is\n * released automatically \u2014 so there is no lock leak \u2014 but the `BillingRun`\n * row's `status='running'` stays set forever, blocking restarts and\n * confusing the dashboard.\n *\n * Phase 0 ships this as the **registered worker shell** so the module's\n * worker auto-discovery includes it from day one. The active-advisory-lock\n * check (which is what distinguishes a real zombie from a healthy\n * long-running run) lands with the Bill Run engine itself in Phase 2.\n *\n * For now the heuristic is time-only: any `running` row older than 1 hour\n * is marked failed with an explanatory message. That is conservative \u2014\n * real runs almost never take an hour even for 500k-account tenants\n * (see spec Performance Considerations).\n */\nconst STALE_THRESHOLD_MS = 60 * 60 * 1000 // 1 hour\n\nexport default async function handle(_job: QueuedJob, ctx: HandlerContext): Promise<void> {\n  const em = ctx.resolve<EntityManager>('em')\n  const threshold = new Date(Date.now() - STALE_THRESHOLD_MS)\n  const stale = await em.find(BillingRun, {\n    status: 'running',\n    startedAt: { $lt: threshold },\n  } satisfies FilterQuery<BillingRun>)\n  if (stale.length === 0) return\n  const now = new Date()\n  for (const run of stale) {\n    run.status = 'failed'\n    run.finishedAt = now\n    const summary = (run.summary ?? {}) as Record<string, unknown>\n    summary.reaper_message =\n      'Stale running run reaped after crash; advisory lock released'\n    summary.reaped_at = now.toISOString()\n    run.summary = summary\n  }\n  await em.flush()\n}\n"],
+  "mappings": "AAGA,SAAS,kBAAkB;AAEpB,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AA0BA,MAAM,qBAAqB,KAAK,KAAK;AAErC,eAAO,OAA8B,MAAiB,KAAoC;AACxF,QAAM,KAAK,IAAI,QAAuB,IAAI;AAC1C,QAAM,YAAY,IAAI,KAAK,KAAK,IAAI,IAAI,kBAAkB;AAC1D,QAAM,QAAQ,MAAM,GAAG,KAAK,YAAY;AAAA,IACtC,QAAQ;AAAA,IACR,WAAW,EAAE,KAAK,UAAU;AAAA,EAC9B,CAAmC;AACnC,MAAI,MAAM,WAAW,EAAG;AACxB,QAAM,MAAM,oBAAI,KAAK;AACrB,aAAW,OAAO,OAAO;AACvB,QAAI,SAAS;AACb,QAAI,aAAa;AACjB,UAAM,UAAW,IAAI,WAAW,CAAC;AACjC,YAAQ,iBACN;AACF,YAAQ,YAAY,IAAI,YAAY;AACpC,QAAI,UAAU;AAAA,EAChB;AACA,QAAM,GAAG,MAAM;AACjB;",
   "names": []
 }

package/generated/entities/billing_account/index.ts

@@ -0,0 +1,26 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_account (BillingAccount, table billing_accounts).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const customer_id = "customer_id"
+export const customer_kind = "customer_kind"
+export const name = "name"
+export const currency_code = "currency_code"
+export const bill_cycle = "bill_cycle"
+export const bill_cycle_anchor = "bill_cycle_anchor"
+export const invoice_email = "invoice_email"
+export const invoice_language = "invoice_language"
+export const tax_id = "tax_id"
+export const invoice_address = "invoice_address"
+export const next_bill_date = "next_bill_date"
+export const last_bill_date = "last_bill_date"
+export const billing_mode = "billing_mode"
+export const credit_limit = "credit_limit"
+export const payment_terms_days = "payment_terms_days"
+export const auto_send_invoice = "auto_send_invoice"
+export const is_active = "is_active"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_account_balance/index.ts

@@ -0,0 +1,13 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_account_balance (BillingAccountBalance, table billing_account_balances).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const currency_code = "currency_code"
+export const balance = "balance"
+export const low_balance_threshold = "low_balance_threshold"
+export const last_movement_at = "last_movement_at"
+export const created_at = "created_at"
+export const updated_at = "updated_at"

package/generated/entities/billing_account_transaction/index.ts

@@ -0,0 +1,21 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_account_transaction (BillingAccountTransaction, table billing_account_transactions).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const type = "type"
+export const amount = "amount"
+export const currency_code = "currency_code"
+export const balance_after = "balance_after"
+export const usage_id = "usage_id"
+export const billing_item_id = "billing_item_id"
+export const topup_id = "topup_id"
+export const statement_id = "statement_id"
+export const description = "description"
+export const source_ref = "source_ref"
+export const metadata = "metadata"
+export const user_id = "user_id"
+export const created_at = "created_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_account_usage/index.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_account_usage (BillingAccountUsage, table billing_account_usage).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const uom_code = "uom_code"
+export const quantity = "quantity"
+export const period_start = "period_start"
+export const period_end = "period_end"
+export const line_description = "line_description"
+export const source_ref = "source_ref"
+export const rated_in_bill_run_id = "rated_in_bill_run_id"
+export const is_active = "is_active"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_allocation/index.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_allocation (BillingAllocation, table billing_allocations).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const source_type = "source_type"
+export const source_id = "source_id"
+export const invoice_id = "invoice_id"
+export const bill_account_id = "bill_account_id"
+export const amount = "amount"
+export const currency_code = "currency_code"
+export const allocated_by = "allocated_by"
+export const user_id = "user_id"
+export const deallocated_by_user_id = "deallocated_by_user_id"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_document_sequence/index.ts

@@ -0,0 +1,11 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_document_sequence (BillingDocumentSequence, table billing_document_sequences).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const series = "series"
+export const scope_key = "scope_key"
+export const next_value = "next_value"
+export const created_at = "created_at"
+export const updated_at = "updated_at"

package/generated/entities/billing_draft_invoice_edit/index.ts

@@ -0,0 +1,14 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_draft_invoice_edit (BillingDraftInvoiceEdit, table billing_draft_invoice_edits).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const invoice_id = "invoice_id"
+export const invoice_line_id = "invoice_line_id"
+export const user_id = "user_id"
+export const action = "action"
+export const before_json = "before_json"
+export const after_json = "after_json"
+export const created_at = "created_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_invoice/index.ts

@@ -0,0 +1,38 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_invoice (BillingInvoice, table billing_invoices).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const document_type = "document_type"
+export const number = "number"
+export const series = "series"
+export const status = "status"
+export const test_run = "test_run"
+export const bill_run_id = "bill_run_id"
+export const bill_date = "bill_date"
+export const period_start = "period_start"
+export const period_end = "period_end"
+export const issue_date = "issue_date"
+export const due_date = "due_date"
+export const currency_code = "currency_code"
+export const subtotal_net = "subtotal_net"
+export const tax_total = "tax_total"
+export const total_gross = "total_gross"
+export const paid_total = "paid_total"
+export const credited_total = "credited_total"
+export const outstanding = "outstanding"
+export const corrects_invoice_id = "corrects_invoice_id"
+export const correction_reason = "correction_reason"
+export const corrects_invoice_number = "corrects_invoice_number"
+export const corrects_issue_date = "corrects_issue_date"
+export const buyer_snapshot = "buyer_snapshot"
+export const seller_snapshot = "seller_snapshot"
+export const pdf_attachment_id = "pdf_attachment_id"
+export const topup_id = "topup_id"
+export const posted_at = "posted_at"
+export const metadata = "metadata"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_invoice_line/index.ts

@@ -0,0 +1,24 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_invoice_line (BillingInvoiceLine, table billing_invoice_lines).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const invoice_id = "invoice_id"
+export const line_number = "line_number"
+export const billing_item_id = "billing_item_id"
+export const billing_type = "billing_type"
+export const description = "description"
+export const quantity = "quantity"
+export const unit_price_net = "unit_price_net"
+export const tax_rate = "tax_rate"
+export const net_amount = "net_amount"
+export const tax_amount = "tax_amount"
+export const gross_amount = "gross_amount"
+export const service_period_start = "service_period_start"
+export const service_period_end = "service_period_end"
+export const corrects_line_id = "corrects_line_id"
+export const metadata = "metadata"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_item/index.ts

@@ -0,0 +1,26 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_item (BillingItem, table billing_items).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const type = "type"
+export const bill_start_date = "bill_start_date"
+export const bill_end_date = "bill_end_date"
+export const description = "description"
+export const rate_json = "rate_json"
+export const uom_code = "uom_code"
+export const subscription_id = "subscription_id"
+export const subscription_item_id = "subscription_item_id"
+export const source_ref = "source_ref"
+export const currency_mismatch = "currency_mismatch"
+export const billed_to_date = "billed_to_date"
+export const charge_timing = "charge_timing"
+export const prorate = "prorate"
+export const tax_rate = "tax_rate"
+export const price_basis = "price_basis"
+export const is_active = "is_active"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_payment/index.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_payment (BillingPayment, table billing_payments).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const received_at = "received_at"
+export const amount = "amount"
+export const currency_code = "currency_code"
+export const reference = "reference"
+export const payer_name = "payer_name"
+export const payer_account = "payer_account"
+export const source = "source"
+export const import_id = "import_id"
+export const bill_account_id = "bill_account_id"
+export const status = "status"
+export const unallocated_amount = "unallocated_amount"
+export const match_reason = "match_reason"
+export const source_ref = "source_ref"
+export const external_ref = "external_ref"
+export const topup_id = "topup_id"
+export const metadata = "metadata"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_payment_import/index.ts

@@ -0,0 +1,14 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_payment_import (BillingPaymentImport, table billing_payment_imports).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const file_name = "file_name"
+export const row_count = "row_count"
+export const counts = "counts"
+export const errors = "errors"
+export const user_id = "user_id"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_run/index.ts

@@ -0,0 +1,20 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_run (BillingRun, table billing_runs).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const triggered_by = "triggered_by"
+export const parent_run_id = "parent_run_id"
+export const dry_run = "dry_run"
+export const test_mode = "test_mode"
+export const scoped_account_ids = "scoped_account_ids"
+export const as_of_date = "as_of_date"
+export const started_at = "started_at"
+export const finished_at = "finished_at"
+export const status = "status"
+export const summary = "summary"
+export const is_active = "is_active"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_run_outcome/index.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_run_outcome (BillingRunOutcome, table billing_run_outcomes).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_run_id = "bill_run_id"
+export const bill_account_id = "bill_account_id"
+export const status = "status"
+export const error_message = "error_message"
+export const warnings = "warnings"
+export const draft_invoice_id = "draft_invoice_id"
+export const statement_id = "statement_id"
+export const cycles = "cycles"
+export const is_active = "is_active"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_settings/index.ts

@@ -0,0 +1,26 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_settings (BillingSettings, table billing_settings).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const low_balance_threshold_default = "low_balance_threshold_default"
+export const near_limit_buffer_default = "near_limit_buffer_default"
+export const statement_enabled = "statement_enabled"
+export const topup_tax_rate = "topup_tax_rate"
+export const prepaid_tax_point = "prepaid_tax_point"
+export const topup_provider = "topup_provider"
+export const number_masks = "number_masks"
+export const legal_name = "legal_name"
+export const seller_address = "seller_address"
+export const tax_id = "tax_id"
+export const bank_name = "bank_name"
+export const iban = "iban"
+export const bic = "bic"
+export const invoice_footer = "invoice_footer"
+export const logo_attachment_id = "logo_attachment_id"
+export const default_payment_terms_days = "default_payment_terms_days"
+export const default_tax_rate = "default_tax_rate"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities/billing_statement/index.ts

@@ -0,0 +1,22 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_statement (BillingStatement, table billing_statements).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const bill_run_id = "bill_run_id"
+export const period_start = "period_start"
+export const period_end = "period_end"
+export const currency_code = "currency_code"
+export const opening_balance = "opening_balance"
+export const total_topups = "total_topups"
+export const total_usage = "total_usage"
+export const total_recurring = "total_recurring"
+export const total_adjustments = "total_adjustments"
+export const closing_balance = "closing_balance"
+export const debit_breakdown = "debit_breakdown"
+export const vat_summary = "vat_summary"
+export const status = "status"
+export const created_at = "created_at"
+export const updated_at = "updated_at"

package/generated/entities/billing_topup/index.ts

@@ -0,0 +1,20 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Columns of billing:billing_topup (BillingTopup, table billing_topups).
+
+export const id = "id"
+export const organization_id = "organization_id"
+export const tenant_id = "tenant_id"
+export const bill_account_id = "bill_account_id"
+export const status = "status"
+export const amount = "amount"
+export const currency_code = "currency_code"
+export const provider_key = "provider_key"
+export const payment_id = "payment_id"
+export const gateway_transaction_id = "gateway_transaction_id"
+export const transaction_id = "transaction_id"
+export const receipt_invoice_id = "receipt_invoice_id"
+export const source_ref = "source_ref"
+export const metadata = "metadata"
+export const created_at = "created_at"
+export const updated_at = "updated_at"
+export const deleted_at = "deleted_at"

package/generated/entities.ids.generated.ts

@@ -0,0 +1,35 @@
+// AUTO-GENERATED by @dainamite/billing scripts/generate-entity-registry.mjs — do not edit.
+// Regenerate with `yarn workspace @dainamite/billing build`.
+//
+// Read by a consuming app's `mercato generate` (@open-mercato/cli entity-ids
+// generator), which takes the KEYS of `E.billing` and registers each id as
+// `billing:<key>`. Source of truth: src/modules/billing/data/entityIds.ts.
+
+export const M = {
+  billing: 'billing',
+} as const
+
+export const E = {
+  billing: {
+    billing_account: 'billing:billing_account',
+    billing_item: 'billing:billing_item',
+    billing_account_usage: 'billing:billing_account_usage',
+    billing_run: 'billing:billing_run',
+    billing_run_outcome: 'billing:billing_run_outcome',
+    billing_draft_invoice_edit: 'billing:billing_draft_invoice_edit',
+    billing_account_balance: 'billing:billing_account_balance',
+    billing_account_transaction: 'billing:billing_account_transaction',
+    billing_topup: 'billing:billing_topup',
+    billing_statement: 'billing:billing_statement',
+    billing_invoice: 'billing:billing_invoice',
+    billing_invoice_line: 'billing:billing_invoice_line',
+    billing_document_sequence: 'billing:billing_document_sequence',
+    billing_settings: 'billing:billing_settings',
+    billing_payment: 'billing:billing_payment',
+    billing_allocation: 'billing:billing_allocation',
+    billing_payment_import: 'billing:billing_payment_import',
+  },
+} as const
+
+export type KnownModuleId = keyof typeof M
+export type KnownEntities = typeof E

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@dainamite/billing",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Dainamite Billing — lightweight recurring-billing engine for Open Mercato (Bill Runs, one-time / recurring / usage items, draft invoices in core/sales with human approval).",
   "type": "module",
   "main": "./dist/modules/billing/index.js",
   "files": [
     "dist",
+    "generated",
     "src",
     "README.md",
     "CHANGELOG.md"
@@ -117,15 +118,15 @@
     }
   },
   "peerDependencies": {
-    "@mikro-orm/core": "^7.1.5",
-    "@mikro-orm/decorators": "^7.1.5",
-    "@mikro-orm/postgresql": "^7.1.5",
-    "@open-mercato/core": "^0.6.7",
-    "@open-mercato/events": "^0.6.7",
-    "@open-mercato/queue": "^0.6.7",
-    "@open-mercato/shared": "^0.6.7",
-    "@open-mercato/ui": "^0.6.7",
-    "@tanstack/react-table": "^8.0.0 || ^9.0.0",
+    "@mikro-orm/core": "^7.1.14",
+    "@mikro-orm/decorators": "^7.1.14",
+    "@mikro-orm/postgresql": "^7.1.14",
+    "@open-mercato/core": "^0.9.0",
+    "@open-mercato/events": "^0.9.0",
+    "@open-mercato/queue": "^0.9.0",
+    "@open-mercato/shared": "^0.9.0",
+    "@open-mercato/ui": "^0.9.0",
+    "@tanstack/react-table": "^9.0.0",
     "awilix": "^12.0.0",
     "lucide-react": "^0.400.0",
     "next": "^16.0.0",
@@ -144,5 +145,9 @@
   "license": "MIT",
   "engines": {
     "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@pdf-lib/fontkit": "^1.1.1",
+    "pdf-lib": "^1.17.1"
   }
 }