@dainamite/billing 0.17.0 → 0.19.0

package/dist/modules/billing/data/entities.js

@@ -13,6 +13,8 @@ import { Entity, Index, PrimaryKey, Property, Unique } from "@mikro-orm/decorato
 OptionalProps;
 let BillingAccount = class {
   constructor() {
+    this.billingMode = "postpaid";
+    this.creditLimit = "0";
     this.isActive = true;
     this.createdAt = /* @__PURE__ */ new Date();
     this.updatedAt = /* @__PURE__ */ new Date();
@@ -60,6 +62,12 @@ __decorateClass([
 __decorateClass([
   Property({ name: "last_bill_date", type: "date", columnType: "date", nullable: true })
 ], BillingAccount.prototype, "lastBillDate", 2);
+__decorateClass([
+  Property({ name: "billing_mode", type: "text", default: "postpaid" })
+], BillingAccount.prototype, "billingMode", 2);
+__decorateClass([
+  Property({ name: "credit_limit", type: "numeric", columnType: "numeric(18, 4)", default: "0" })
+], BillingAccount.prototype, "creditLimit", 2);
 __decorateClass([
   Property({ name: "is_active", type: "boolean", default: true })
 ], BillingAccount.prototype, "isActive", 2);
@@ -349,6 +357,9 @@ __decorateClass([
 __decorateClass([
   Property({ name: "draft_invoice_id", type: "uuid", nullable: true })
 ], BillRunOutcome.prototype, "draftInvoiceId", 2);
+__decorateClass([
+  Property({ name: "statement_id", type: "uuid", nullable: true })
+], BillRunOutcome.prototype, "statementId", 2);
 __decorateClass([
   Property({ name: "is_active", type: "boolean", default: true })
 ], BillRunOutcome.prototype, "isActive", 2);
@@ -422,12 +433,291 @@ DraftInvoiceEdit = __decorateClass([
     properties: ["organizationId", "tenantId", "userId", "createdAt"]
   })
 ], DraftInvoiceEdit);
+OptionalProps;
+let BillingAccountBalance = class {
+  constructor() {
+    this.balance = "0";
+    this.createdAt = /* @__PURE__ */ new Date();
+    this.updatedAt = /* @__PURE__ */ new Date();
+  }
+};
+__decorateClass([
+  PrimaryKey({ type: "uuid", defaultRaw: "gen_random_uuid()" })
+], BillingAccountBalance.prototype, "id", 2);
+__decorateClass([
+  Property({ name: "organization_id", type: "uuid" })
+], BillingAccountBalance.prototype, "organizationId", 2);
+__decorateClass([
+  Property({ name: "tenant_id", type: "uuid" })
+], BillingAccountBalance.prototype, "tenantId", 2);
+__decorateClass([
+  Property({ name: "bill_account_id", type: "uuid" })
+], BillingAccountBalance.prototype, "billAccountId", 2);
+__decorateClass([
+  Property({ name: "currency_code", type: "text" })
+], BillingAccountBalance.prototype, "currencyCode", 2);
+__decorateClass([
+  Property({ name: "balance", type: "numeric", columnType: "numeric(18, 4)", default: "0" })
+], BillingAccountBalance.prototype, "balance", 2);
+__decorateClass([
+  Property({
+    name: "low_balance_threshold",
+    type: "numeric",
+    columnType: "numeric(18, 4)",
+    nullable: true
+  })
+], BillingAccountBalance.prototype, "lowBalanceThreshold", 2);
+__decorateClass([
+  Property({ name: "last_movement_at", type: Date, nullable: true })
+], BillingAccountBalance.prototype, "lastMovementAt", 2);
+__decorateClass([
+  Property({ name: "created_at", type: Date, onCreate: () => /* @__PURE__ */ new Date() })
+], BillingAccountBalance.prototype, "createdAt", 2);
+__decorateClass([
+  Property({ name: "updated_at", type: Date, onUpdate: () => /* @__PURE__ */ new Date() })
+], BillingAccountBalance.prototype, "updatedAt", 2);
+BillingAccountBalance = __decorateClass([
+  Entity({ tableName: "billing_account_balances" }),
+  Unique({
+    name: "billing_account_balances_account_unique",
+    properties: ["tenantId", "billAccountId"]
+  }),
+  Index({
+    name: "billing_account_balances_balance_idx",
+    properties: ["organizationId", "tenantId", "balance"]
+  })
+], BillingAccountBalance);
+OptionalProps;
+let BillingAccountTransaction = class {
+  constructor() {
+    this.createdAt = /* @__PURE__ */ new Date();
+  }
+};
+__decorateClass([
+  PrimaryKey({ type: "uuid", defaultRaw: "gen_random_uuid()" })
+], BillingAccountTransaction.prototype, "id", 2);
+__decorateClass([
+  Property({ name: "organization_id", type: "uuid" })
+], BillingAccountTransaction.prototype, "organizationId", 2);
+__decorateClass([
+  Property({ name: "tenant_id", type: "uuid" })
+], BillingAccountTransaction.prototype, "tenantId", 2);
+__decorateClass([
+  Property({ name: "bill_account_id", type: "uuid" })
+], BillingAccountTransaction.prototype, "billAccountId", 2);
+__decorateClass([
+  Property({ type: "text" })
+], BillingAccountTransaction.prototype, "type", 2);
+__decorateClass([
+  Property({ type: "numeric", columnType: "numeric(18, 4)" })
+], BillingAccountTransaction.prototype, "amount", 2);
+__decorateClass([
+  Property({ name: "currency_code", type: "text" })
+], BillingAccountTransaction.prototype, "currencyCode", 2);
+__decorateClass([
+  Property({ name: "balance_after", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingAccountTransaction.prototype, "balanceAfter", 2);
+__decorateClass([
+  Property({ name: "usage_id", type: "uuid", nullable: true })
+], BillingAccountTransaction.prototype, "usageId", 2);
+__decorateClass([
+  Property({ name: "billing_item_id", type: "uuid", nullable: true })
+], BillingAccountTransaction.prototype, "billingItemId", 2);
+__decorateClass([
+  Property({ name: "topup_id", type: "uuid", nullable: true })
+], BillingAccountTransaction.prototype, "topupId", 2);
+__decorateClass([
+  Property({ name: "statement_id", type: "uuid", nullable: true })
+], BillingAccountTransaction.prototype, "statementId", 2);
+__decorateClass([
+  Property({ type: "text" })
+], BillingAccountTransaction.prototype, "description", 2);
+__decorateClass([
+  Property({ name: "source_ref", type: "text", nullable: true })
+], BillingAccountTransaction.prototype, "sourceRef", 2);
+__decorateClass([
+  Property({ type: "jsonb", nullable: true })
+], BillingAccountTransaction.prototype, "metadata", 2);
+__decorateClass([
+  Property({ name: "user_id", type: "uuid", nullable: true })
+], BillingAccountTransaction.prototype, "userId", 2);
+__decorateClass([
+  Property({ name: "created_at", type: Date, onCreate: () => /* @__PURE__ */ new Date() })
+], BillingAccountTransaction.prototype, "createdAt", 2);
+__decorateClass([
+  Property({ name: "deleted_at", type: Date, nullable: true })
+], BillingAccountTransaction.prototype, "deletedAt", 2);
+BillingAccountTransaction = __decorateClass([
+  Entity({ tableName: "billing_account_transactions" }),
+  Unique({
+    name: "billing_account_transactions_source_ref_unique",
+    properties: ["tenantId", "billAccountId", "sourceRef"]
+  }),
+  Index({
+    name: "billing_account_transactions_history_idx",
+    properties: ["organizationId", "tenantId", "billAccountId", "createdAt"]
+  }),
+  Index({
+    name: "billing_account_transactions_account_type_idx",
+    properties: ["billAccountId", "type", "createdAt"]
+  })
+], BillingAccountTransaction);
+OptionalProps;
+let BillingTopup = class {
+  constructor() {
+    this.createdAt = /* @__PURE__ */ new Date();
+    this.updatedAt = /* @__PURE__ */ new Date();
+  }
+};
+__decorateClass([
+  PrimaryKey({ type: "uuid", defaultRaw: "gen_random_uuid()" })
+], BillingTopup.prototype, "id", 2);
+__decorateClass([
+  Property({ name: "organization_id", type: "uuid" })
+], BillingTopup.prototype, "organizationId", 2);
+__decorateClass([
+  Property({ name: "tenant_id", type: "uuid" })
+], BillingTopup.prototype, "tenantId", 2);
+__decorateClass([
+  Property({ name: "bill_account_id", type: "uuid" })
+], BillingTopup.prototype, "billAccountId", 2);
+__decorateClass([
+  Property({ type: "text" })
+], BillingTopup.prototype, "status", 2);
+__decorateClass([
+  Property({ type: "numeric", columnType: "numeric(18, 4)" })
+], BillingTopup.prototype, "amount", 2);
+__decorateClass([
+  Property({ name: "currency_code", type: "text" })
+], BillingTopup.prototype, "currencyCode", 2);
+__decorateClass([
+  Property({ name: "provider_key", type: "text" })
+], BillingTopup.prototype, "providerKey", 2);
+__decorateClass([
+  Property({ name: "payment_id", type: "uuid" })
+], BillingTopup.prototype, "paymentId", 2);
+__decorateClass([
+  Property({ name: "gateway_transaction_id", type: "uuid", nullable: true })
+], BillingTopup.prototype, "gatewayTransactionId", 2);
+__decorateClass([
+  Property({ name: "transaction_id", type: "uuid", nullable: true })
+], BillingTopup.prototype, "transactionId", 2);
+__decorateClass([
+  Property({ name: "receipt_invoice_id", type: "uuid", nullable: true })
+], BillingTopup.prototype, "receiptInvoiceId", 2);
+__decorateClass([
+  Property({ name: "source_ref", type: "text", nullable: true })
+], BillingTopup.prototype, "sourceRef", 2);
+__decorateClass([
+  Property({ type: "jsonb", nullable: true })
+], BillingTopup.prototype, "metadata", 2);
+__decorateClass([
+  Property({ name: "created_at", type: Date, onCreate: () => /* @__PURE__ */ new Date() })
+], BillingTopup.prototype, "createdAt", 2);
+__decorateClass([
+  Property({ name: "updated_at", type: Date, onUpdate: () => /* @__PURE__ */ new Date() })
+], BillingTopup.prototype, "updatedAt", 2);
+__decorateClass([
+  Property({ name: "deleted_at", type: Date, nullable: true })
+], BillingTopup.prototype, "deletedAt", 2);
+BillingTopup = __decorateClass([
+  Entity({ tableName: "billing_topups" }),
+  Unique({
+    name: "billing_topups_payment_id_unique",
+    properties: ["tenantId", "paymentId"]
+  }),
+  Index({
+    name: "billing_topups_account_history_idx",
+    properties: ["organizationId", "tenantId", "billAccountId", "createdAt"]
+  }),
+  Index({
+    name: "billing_topups_status_idx",
+    properties: ["tenantId", "status"]
+  })
+], BillingTopup);
+OptionalProps;
+let BillingStatement = class {
+  constructor() {
+    this.totalAdjustments = "0";
+    this.createdAt = /* @__PURE__ */ new Date();
+    this.updatedAt = /* @__PURE__ */ new Date();
+  }
+};
+__decorateClass([
+  PrimaryKey({ type: "uuid", defaultRaw: "gen_random_uuid()" })
+], BillingStatement.prototype, "id", 2);
+__decorateClass([
+  Property({ name: "organization_id", type: "uuid" })
+], BillingStatement.prototype, "organizationId", 2);
+__decorateClass([
+  Property({ name: "tenant_id", type: "uuid" })
+], BillingStatement.prototype, "tenantId", 2);
+__decorateClass([
+  Property({ name: "bill_account_id", type: "uuid" })
+], BillingStatement.prototype, "billAccountId", 2);
+__decorateClass([
+  Property({ name: "bill_run_id", type: "uuid", nullable: true })
+], BillingStatement.prototype, "billRunId", 2);
+__decorateClass([
+  Property({ name: "period_start", type: "date", columnType: "date" })
+], BillingStatement.prototype, "periodStart", 2);
+__decorateClass([
+  Property({ name: "period_end", type: "date", columnType: "date" })
+], BillingStatement.prototype, "periodEnd", 2);
+__decorateClass([
+  Property({ name: "currency_code", type: "text" })
+], BillingStatement.prototype, "currencyCode", 2);
+__decorateClass([
+  Property({ name: "opening_balance", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingStatement.prototype, "openingBalance", 2);
+__decorateClass([
+  Property({ name: "total_topups", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingStatement.prototype, "totalTopups", 2);
+__decorateClass([
+  Property({ name: "total_usage", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingStatement.prototype, "totalUsage", 2);
+__decorateClass([
+  Property({ name: "total_recurring", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingStatement.prototype, "totalRecurring", 2);
+__decorateClass([
+  Property({ name: "total_adjustments", type: "numeric", columnType: "numeric(18, 4)", default: "0" })
+], BillingStatement.prototype, "totalAdjustments", 2);
+__decorateClass([
+  Property({ name: "closing_balance", type: "numeric", columnType: "numeric(18, 4)" })
+], BillingStatement.prototype, "closingBalance", 2);
+__decorateClass([
+  Property({ name: "debit_breakdown", type: "jsonb" })
+], BillingStatement.prototype, "debitBreakdown", 2);
+__decorateClass([
+  Property({ type: "text" })
+], BillingStatement.prototype, "status", 2);
+__decorateClass([
+  Property({ name: "created_at", type: Date, onCreate: () => /* @__PURE__ */ new Date() })
+], BillingStatement.prototype, "createdAt", 2);
+__decorateClass([
+  Property({ name: "updated_at", type: Date, onUpdate: () => /* @__PURE__ */ new Date() })
+], BillingStatement.prototype, "updatedAt", 2);
+BillingStatement = __decorateClass([
+  Entity({ tableName: "billing_statements" }),
+  Unique({
+    name: "billing_statements_period_unique",
+    properties: ["tenantId", "billAccountId", "periodStart", "periodEnd"]
+  }),
+  Index({
+    name: "billing_statements_account_period_idx",
+    properties: ["organizationId", "tenantId", "billAccountId", "periodEnd"]
+  })
+], BillingStatement);
 export {
   BillRun,
   BillRunOutcome,
   BillingAccount,
+  BillingAccountBalance,
+  BillingAccountTransaction,
   BillingAccountUsage,
   BillingItem,
+  BillingStatement,
+  BillingTopup,
   DraftInvoiceEdit
 };
 //# sourceMappingURL=entities.js.map

package/dist/modules/billing/data/entities.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/data/entities.ts"],
-  "sourcesContent": ["import { OptionalProps } from '@mikro-orm/core'\nimport { Entity, Index, PrimaryKey, Property, Unique } from '@mikro-orm/decorators/legacy'\n\n// \u2500\u2500\u2500 BillingAccount \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A container per customer (typically one customer = one account, but the\n// engine does not enforce uniqueness \u2014 multi-account-per-customer is a\n// legitimate model for B2B with separate budgets / currencies / branches).\n//\n// The `(organization_id, tenant_id, next_bill_date)` partial index is the\n// Bill Run hot path \u2014 every nightly run filters by tenant + org and orders\n// by next_bill_date. Multi-org tenants share `tenant_id` across orgs, so a\n// `(tenant_id, next_bill_date)`-only index would scan every other org's\n// rows for each tenant \u2014 fine at 1 org / tenant, painful at 50.\n\n@Entity({ tableName: 'billing_accounts' })\n@Index({\n  name: 'billing_accounts_next_bill_date_idx',\n  properties: ['organizationId', 'tenantId', 'nextBillDate'],\n  expression:\n    'CREATE INDEX \"billing_accounts_next_bill_date_idx\" ON \"billing_accounts\" (\"organization_id\", \"tenant_id\", \"next_bill_date\") WHERE \"deleted_at\" IS NULL',\n})\n@Index({\n  name: 'billing_accounts_customer_idx',\n  properties: ['organizationId', 'tenantId', 'customerId'],\n})\n@Index({\n  name: 'billing_accounts_sort_idx',\n  properties: ['organizationId', 'tenantId', 'deletedAt', 'createdAt'],\n})\nexport class BillingAccount {\n  [OptionalProps]?:\n    | 'taxId'\n    | 'lastBillDate'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // String FK to customers.person.id (or any external customer system).\n  // Kept as text so the package stays installable without the customers\n  // module \u2014 see SPEC-001 cross-package data rule.\n  @Property({ name: 'customer_id', type: 'text' })\n  customerId!: string\n\n  @Property({ type: 'text' })\n  name!: string\n\n  // ISO 4217 currency code. An account is single-currency by design \u2014\n  // multi-currency = multiple accounts.\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  // 'monthly' | 'quarterly' | 'annually' | 'weekly'. Validated at API ingress.\n  @Property({ name: 'bill_cycle', type: 'text' })\n  billCycle!: string\n\n  // Day-of-month for monthly/quarterly/annually (1\u201328), or weekday code\n  // ('mon'\u2026'sun') for weekly. Text so both shapes coexist.\n  @Property({ name: 'bill_cycle_anchor', type: 'text' })\n  billCycleAnchor!: string\n\n  @Property({ name: 'invoice_email', type: 'text' })\n  invoiceEmail!: string\n\n  // ISO 639-1 (`en`, `pl`, \u2026). Used by mailer / template renderer.\n  @Property({ name: 'invoice_language', type: 'text' })\n  invoiceLanguage!: string\n\n  // NIP / VATIN / TaxID. Nullable for individuals without a registered tax ID.\n  @Property({ name: 'tax_id', type: 'text', nullable: true })\n  taxId?: string | null\n\n  // { line1, line2?, city, postal_code, country } \u2014 JSONB because address\n  // shape differs across countries and we never query by address fields.\n  @Property({ name: 'invoice_address', type: 'jsonb' })\n  invoiceAddress!: Record<string, unknown>\n\n  // Anchor of the NEXT bill period to be processed (advanced by Bill Run\n  // on success). Date-only \u2014 calendar-aware cycle arithmetic.\n  @Property({ name: 'next_bill_date', type: 'date', columnType: 'date' })\n  nextBillDate!: Date\n\n  // Anchor of the most recently billed period; null for fresh accounts.\n  @Property({ name: 'last_bill_date', type: 'date', columnType: 'date', nullable: true })\n  lastBillDate?: Date | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingItem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A single line that will appear on an invoice. Three flavours:\n// `one_time` / `recurring` / `usage` \u2014 see rate_json shape per type in\n// data/validators.ts.\n//\n// `(tenant_id, bill_account_id, source_ref)` is unique for idempotency.\n// Postgres treats NULLs as distinct, so items without a source_ref do not\n// conflict \u2014 that is intentional (CSV imports / manual entries).\n\n@Entity({ tableName: 'billing_items' })\n@Unique({\n  name: 'billing_items_source_ref_unique',\n  properties: ['tenantId', 'billAccountId', 'sourceRef'],\n})\n@Index({\n  name: 'billing_items_account_type_idx',\n  properties: ['billAccountId', 'type'],\n})\n@Index({\n  name: 'billing_items_account_active_idx',\n  properties: ['billAccountId', 'type', 'isActive'],\n  expression:\n    'CREATE INDEX \"billing_items_account_active_idx\" ON \"billing_items\" (\"bill_account_id\", \"type\", \"is_active\") WHERE \"deleted_at\" IS NULL',\n})\n@Index({\n  name: 'billing_items_subscription_idx',\n  properties: ['organizationId', 'tenantId', 'subscriptionId'],\n})\nexport class BillingItem {\n  [OptionalProps]?:\n    | 'billEndDate'\n    | 'uomCode'\n    | 'subscriptionId'\n    | 'subscriptionItemId'\n    | 'sourceRef'\n    | 'currencyMismatch'\n    | 'billedToDate'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // FK string to BillingAccount.id (intra-module; no ORM relation kept to\n  // avoid coupling \u2014 we resolve at runtime).\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'one_time' | 'recurring' | 'usage'.\n  @Property({ type: 'text' })\n  type!: string\n\n  @Property({ name: 'bill_start_date', type: 'date', columnType: 'date' })\n  billStartDate!: Date\n\n  // Null = open-ended (typical for ongoing recurring items).\n  @Property({ name: 'bill_end_date', type: 'date', columnType: 'date', nullable: true })\n  billEndDate?: Date | null\n\n  @Property({ type: 'text' })\n  description!: string\n\n  // Pricing definition. Shape validated by Zod per `type`; see\n  // data/validators.ts.\n  @Property({ name: 'rate_json', type: 'jsonb' })\n  rateJson!: Record<string, unknown>\n\n  // Required for type='usage' (must match a Usage record's uom_code\n  // exactly \u2014 no conversion). Ignored for other types.\n  @Property({ name: 'uom_code', type: 'text', nullable: true })\n  uomCode?: string | null\n\n  // String FK to upstream subscription (e.g. CPQ's\n  // cpq_inventory_subscriptions.id). Null for CSV / manual / non-subscription\n  // contexts.\n  @Property({ name: 'subscription_id', type: 'text', nullable: true })\n  subscriptionId?: string | null\n\n  @Property({ name: 'subscription_item_id', type: 'text', nullable: true })\n  subscriptionItemId?: string | null\n\n  // Idempotency key \u2014 duplicate POST returns the existing row.\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // Set when the integrator POSTed a value in a different currency than the\n  // account's currency_code. Operator sees a warning on the draft.\n  @Property({ name: 'currency_mismatch', type: 'boolean', default: false })\n  currencyMismatch: boolean = false\n\n  // Anti-double-bill guard at the item level \u2014 see spec\n  // \"Why two anti-duplicate guards\".\n  @Property({ name: 'billed_to_date', type: 'date', columnType: 'date', nullable: true })\n  billedToDate?: Date | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingAccountUsage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Bucket for pre-aggregated usage uploaded by external systems. The\n// selection index `(bill_account_id, uom_code, rated_in_bill_run_id,\n// period_end)` matches the Bill Run \"find unrated records\" predicate\n// exactly \u2014 keep it in sync if that predicate changes.\n\n@Entity({ tableName: 'billing_account_usage' })\n@Unique({\n  name: 'billing_account_usage_source_ref_unique',\n  properties: ['tenantId', 'billAccountId', 'sourceRef'],\n})\n@Index({\n  name: 'billing_account_usage_rating_idx',\n  properties: ['billAccountId', 'uomCode', 'ratedInBillRunId', 'periodEnd'],\n})\nexport class BillingAccountUsage {\n  [OptionalProps]?:\n    | 'lineDescription'\n    | 'sourceRef'\n    | 'ratedInBillRunId'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // Must match the `uom_code` on a corresponding `type='usage'` Billing Item.\n  @Property({ name: 'uom_code', type: 'text' })\n  uomCode!: string\n\n  // numeric(18,4) \u2192 string in app code (standard MikroORM numeric handling).\n  @Property({ type: 'numeric', columnType: 'numeric(18, 4)' })\n  quantity!: string\n\n  @Property({ name: 'period_start', type: Date })\n  periodStart!: Date\n\n  @Property({ name: 'period_end', type: Date })\n  periodEnd!: Date\n\n  // Optional per-record description. When set, Bill Run emits one invoice\n  // line per Usage record with this description. When null, the run\n  // aggregates all matching Usage records into a single line using the\n  // Billing Item's `description`.\n  @Property({ name: 'line_description', type: 'text', nullable: true })\n  lineDescription?: string | null\n\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // Set when consumed; prevents double-rating on retry.\n  @Property({ name: 'rated_in_bill_run_id', type: 'uuid', nullable: true })\n  ratedInBillRunId?: string | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillRun \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A single execution of the engine \u2014 one row per trigger (schedule or\n// manual). The concurrency lock is a Postgres transaction-scoped advisory\n// lock keyed by hash(tenant_id || 'billing-run'); it is NOT stored on this\n// row. Crash recovery for zombie `status='running'` rows is handled by\n// workers/reap-stale-bill-runs.ts.\n\n@Entity({ tableName: 'billing_runs' })\n@Index({\n  name: 'billing_runs_tenant_status_idx',\n  properties: ['tenantId', 'status', 'startedAt'],\n})\n@Index({\n  name: 'billing_runs_parent_idx',\n  properties: ['parentRunId'],\n})\nexport class BillRun {\n  [OptionalProps]?:\n    | 'parentRunId'\n    | 'dryRun'\n    | 'testMode'\n    | 'catchUp'\n    | 'scopedAccountIds'\n    | 'startedAt'\n    | 'finishedAt'\n    | 'summary'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // 'schedule' | 'manual'.\n  @Property({ name: 'triggered_by', type: 'text' })\n  triggeredBy!: string\n\n  // Set when this run is a \"retry failed\" of a previous run.\n  @Property({ name: 'parent_run_id', type: 'uuid', nullable: true })\n  parentRunId?: string | null\n\n  // True \u2192 compute everything but persist nothing (preview).\n  @Property({ name: 'dry_run', type: 'boolean', default: false })\n  dryRun: boolean = false\n\n  // True \u2192 persist drafts flagged as test, but do not advance state.\n  @Property({ name: 'test_mode', type: 'boolean', default: false })\n  testMode: boolean = false\n\n  // True \u2192 loop missed cycles per account in one run (manual only).\n  @Property({ name: 'catch_up', type: 'boolean', default: false })\n  catchUp: boolean = false\n\n  // Optional \u2014 run processes only these accounts when set. JSONB\n  // (Postgres arrays would work too, but jsonb keeps tooling uniform\n  // across this package).\n  @Property({ name: 'scoped_account_ids', type: 'jsonb', nullable: true })\n  scopedAccountIds?: string[] | null\n\n  // The \"today\" the run uses to evaluate `next_bill_date <= as_of_date`.\n  @Property({ name: 'as_of_date', type: 'date', columnType: 'date' })\n  asOfDate!: Date\n\n  @Property({ name: 'started_at', type: Date, nullable: true })\n  startedAt?: Date | null\n\n  @Property({ name: 'finished_at', type: Date, nullable: true })\n  finishedAt?: Date | null\n\n  // 'running' | 'completed' | 'partial_failure' | 'failed'.\n  @Property({ type: 'text' })\n  status!: string\n\n  // { accounts_processed, drafts_created, drafts_skipped_existing,\n  //   accounts_failed, accounts_with_warnings, usage_records_rated }\n  @Property({ type: 'jsonb', nullable: true })\n  summary?: Record<string, unknown> | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillRunOutcome \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Per-account outcome of a Bill Run. Stored in its own table (not as a\n// JSONB array on BillRun.summary) so operators can query failures across\n// runs without jsonb_array_elements gymnastics. See spec rationale.\n\n@Entity({ tableName: 'billing_run_outcomes' })\n@Index({\n  name: 'billing_run_outcomes_run_status_idx',\n  properties: ['billRunId', 'status'],\n})\n@Index({\n  name: 'billing_run_outcomes_account_history_idx',\n  properties: ['organizationId', 'tenantId', 'billAccountId', 'createdAt'],\n})\nexport class BillRunOutcome {\n  [OptionalProps]?:\n    | 'errorMessage'\n    | 'warnings'\n    | 'draftInvoiceId'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_run_id', type: 'uuid' })\n  billRunId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'success' | 'success_with_warnings' | 'skipped_existing_draft' | 'failed'.\n  @Property({ type: 'text' })\n  status!: string\n\n  @Property({ name: 'error_message', type: 'text', nullable: true })\n  errorMessage?: string | null\n\n  // E.g. `{ unmatched_usage_uoms: [\"api_request\"] }`.\n  @Property({ type: 'jsonb', nullable: true })\n  warnings?: Record<string, unknown> | null\n\n  // FK string to the core/sales invoice (drafted by the run). Null when\n  // the run skipped (status='skipped_existing_draft' or 'failed').\n  @Property({ name: 'draft_invoice_id', type: 'uuid', nullable: true })\n  draftInvoiceId?: string | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 DraftInvoiceEdit (audit) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Append-only audit of every operator edit on a draft invoice line.\n// Pattern mirrors `cpq_subscription_change_logs` \u2014 minimal columns\n// (no updated_at / is_active), append-only, soft-delete reserved for\n// compliance erasure only.\n\n@Entity({ tableName: 'billing_draft_invoice_edits' })\n@Index({\n  name: 'billing_draft_invoice_edits_invoice_idx',\n  properties: ['organizationId', 'tenantId', 'invoiceId', 'createdAt'],\n})\n@Index({\n  name: 'billing_draft_invoice_edits_user_idx',\n  properties: ['organizationId', 'tenantId', 'userId', 'createdAt'],\n})\nexport class DraftInvoiceEdit {\n  [OptionalProps]?: 'invoiceLineId' | 'beforeJson' | 'afterJson' | 'createdAt' | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // FK string to the core/sales invoice (no ORM relation across packages).\n  @Property({ name: 'invoice_id', type: 'uuid' })\n  invoiceId!: string\n\n  // Null for `line_added` / `line_removed` actions whose target line does\n  // not yet (or no longer) exist on the invoice.\n  @Property({ name: 'invoice_line_id', type: 'uuid', nullable: true })\n  invoiceLineId?: string | null\n\n  @Property({ name: 'user_id', type: 'uuid' })\n  userId!: string\n\n  // 'line_added' | 'line_removed' | 'line_edited'.\n  @Property({ type: 'text' })\n  action!: string\n\n  // Snapshot before the edit. Null for `line_added` (no prior state).\n  @Property({ name: 'before_json', type: 'jsonb', nullable: true })\n  beforeJson?: Record<string, unknown> | null\n\n  // Snapshot after the edit. Null for `line_removed` (no resulting state).\n  @Property({ name: 'after_json', type: 'jsonb', nullable: true })\n  afterJson?: Record<string, unknown> | null\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  // Reserved for compliance erasure only; runtime never deletes audit rows\n  // through normal flows.\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { OptionalProps } from '@mikro-orm/core'\nimport { Entity, Index, PrimaryKey, Property, Unique } from '@mikro-orm/decorators/legacy'\n\n// \u2500\u2500\u2500 BillingAccount \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A container per customer (typically one customer = one account, but the\n// engine does not enforce uniqueness \u2014 multi-account-per-customer is a\n// legitimate model for B2B with separate budgets / currencies / branches).\n//\n// The `(organization_id, tenant_id, next_bill_date)` partial index is the\n// Bill Run hot path \u2014 every nightly run filters by tenant + org and orders\n// by next_bill_date. Multi-org tenants share `tenant_id` across orgs, so a\n// `(tenant_id, next_bill_date)`-only index would scan every other org's\n// rows for each tenant \u2014 fine at 1 org / tenant, painful at 50.\n\n@Entity({ tableName: 'billing_accounts' })\n@Index({\n  name: 'billing_accounts_next_bill_date_idx',\n  properties: ['organizationId', 'tenantId', 'nextBillDate'],\n  expression:\n    'CREATE INDEX \"billing_accounts_next_bill_date_idx\" ON \"billing_accounts\" (\"organization_id\", \"tenant_id\", \"next_bill_date\") WHERE \"deleted_at\" IS NULL',\n})\n@Index({\n  name: 'billing_accounts_customer_idx',\n  properties: ['organizationId', 'tenantId', 'customerId'],\n})\n@Index({\n  name: 'billing_accounts_sort_idx',\n  properties: ['organizationId', 'tenantId', 'deletedAt', 'createdAt'],\n})\nexport class BillingAccount {\n  [OptionalProps]?:\n    | 'taxId'\n    | 'lastBillDate'\n    | 'billingMode'\n    | 'creditLimit'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // String FK to customers.person.id (or any external customer system).\n  // Kept as text so the package stays installable without the customers\n  // module \u2014 see SPEC-001 cross-package data rule.\n  @Property({ name: 'customer_id', type: 'text' })\n  customerId!: string\n\n  @Property({ type: 'text' })\n  name!: string\n\n  // ISO 4217 currency code. An account is single-currency by design \u2014\n  // multi-currency = multiple accounts.\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  // 'monthly' | 'quarterly' | 'annually' | 'weekly'. Validated at API ingress.\n  @Property({ name: 'bill_cycle', type: 'text' })\n  billCycle!: string\n\n  // Day-of-month for monthly/quarterly/annually (1\u201328), or weekday code\n  // ('mon'\u2026'sun') for weekly. Text so both shapes coexist.\n  @Property({ name: 'bill_cycle_anchor', type: 'text' })\n  billCycleAnchor!: string\n\n  @Property({ name: 'invoice_email', type: 'text' })\n  invoiceEmail!: string\n\n  // ISO 639-1 (`en`, `pl`, \u2026). Used by mailer / template renderer.\n  @Property({ name: 'invoice_language', type: 'text' })\n  invoiceLanguage!: string\n\n  // NIP / VATIN / TaxID. Nullable for individuals without a registered tax ID.\n  @Property({ name: 'tax_id', type: 'text', nullable: true })\n  taxId?: string | null\n\n  // { line1, line2?, city, postal_code, country } \u2014 JSONB because address\n  // shape differs across countries and we never query by address fields.\n  @Property({ name: 'invoice_address', type: 'jsonb' })\n  invoiceAddress!: Record<string, unknown>\n\n  // Anchor of the NEXT bill period to be processed (advanced by Bill Run\n  // on success). Date-only \u2014 calendar-aware cycle arithmetic.\n  @Property({ name: 'next_bill_date', type: 'date', columnType: 'date' })\n  nextBillDate!: Date\n\n  // Anchor of the most recently billed period; null for fresh accounts.\n  @Property({ name: 'last_bill_date', type: 'date', columnType: 'date', nullable: true })\n  lastBillDate?: Date | null\n\n  // Billing mode \u2014 'postpaid' (default; the shipped Bill Run \u2192 draft \u2192\n  // post flow) or 'prepaid' (top up a balance, draw it down in real time;\n  // SPEC-002). Immutable after create (like currency_code); validated at\n  // API ingress. Existing rows default to postpaid \u2014 zero behavior change.\n  @Property({ name: 'billing_mode', type: 'text', default: 'postpaid' })\n  billingMode: string = 'postpaid'\n\n  // Credit line extended to this customer (both modes). Prepaid: permitted\n  // overdraft below zero. Postpaid: max outstanding AR exposure. `0` = no\n  // credit. Reported, never enforced by billing (SPEC-002 assumption #11).\n  @Property({ name: 'credit_limit', type: 'numeric', columnType: 'numeric(18, 4)', default: '0' })\n  creditLimit: string = '0'\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingItem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A single line that will appear on an invoice. Three flavours:\n// `one_time` / `recurring` / `usage` \u2014 see rate_json shape per type in\n// data/validators.ts.\n//\n// `(tenant_id, bill_account_id, source_ref)` is unique for idempotency.\n// Postgres treats NULLs as distinct, so items without a source_ref do not\n// conflict \u2014 that is intentional (CSV imports / manual entries).\n\n@Entity({ tableName: 'billing_items' })\n@Unique({\n  name: 'billing_items_source_ref_unique',\n  properties: ['tenantId', 'billAccountId', 'sourceRef'],\n})\n@Index({\n  name: 'billing_items_account_type_idx',\n  properties: ['billAccountId', 'type'],\n})\n@Index({\n  name: 'billing_items_account_active_idx',\n  properties: ['billAccountId', 'type', 'isActive'],\n  expression:\n    'CREATE INDEX \"billing_items_account_active_idx\" ON \"billing_items\" (\"bill_account_id\", \"type\", \"is_active\") WHERE \"deleted_at\" IS NULL',\n})\n@Index({\n  name: 'billing_items_subscription_idx',\n  properties: ['organizationId', 'tenantId', 'subscriptionId'],\n})\nexport class BillingItem {\n  [OptionalProps]?:\n    | 'billEndDate'\n    | 'uomCode'\n    | 'subscriptionId'\n    | 'subscriptionItemId'\n    | 'sourceRef'\n    | 'currencyMismatch'\n    | 'billedToDate'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // FK string to BillingAccount.id (intra-module; no ORM relation kept to\n  // avoid coupling \u2014 we resolve at runtime).\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'one_time' | 'recurring' | 'usage'.\n  @Property({ type: 'text' })\n  type!: string\n\n  @Property({ name: 'bill_start_date', type: 'date', columnType: 'date' })\n  billStartDate!: Date\n\n  // Null = open-ended (typical for ongoing recurring items).\n  @Property({ name: 'bill_end_date', type: 'date', columnType: 'date', nullable: true })\n  billEndDate?: Date | null\n\n  @Property({ type: 'text' })\n  description!: string\n\n  // Pricing definition. Shape validated by Zod per `type`; see\n  // data/validators.ts.\n  @Property({ name: 'rate_json', type: 'jsonb' })\n  rateJson!: Record<string, unknown>\n\n  // Required for type='usage' (must match a Usage record's uom_code\n  // exactly \u2014 no conversion). Ignored for other types.\n  @Property({ name: 'uom_code', type: 'text', nullable: true })\n  uomCode?: string | null\n\n  // String FK to upstream subscription (e.g. CPQ's\n  // cpq_inventory_subscriptions.id). Null for CSV / manual / non-subscription\n  // contexts.\n  @Property({ name: 'subscription_id', type: 'text', nullable: true })\n  subscriptionId?: string | null\n\n  @Property({ name: 'subscription_item_id', type: 'text', nullable: true })\n  subscriptionItemId?: string | null\n\n  // Idempotency key \u2014 duplicate POST returns the existing row.\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // Set when the integrator POSTed a value in a different currency than the\n  // account's currency_code. Operator sees a warning on the draft.\n  @Property({ name: 'currency_mismatch', type: 'boolean', default: false })\n  currencyMismatch: boolean = false\n\n  // Anti-double-bill guard at the item level \u2014 see spec\n  // \"Why two anti-duplicate guards\".\n  @Property({ name: 'billed_to_date', type: 'date', columnType: 'date', nullable: true })\n  billedToDate?: Date | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingAccountUsage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Bucket for pre-aggregated usage uploaded by external systems. The\n// selection index `(bill_account_id, uom_code, rated_in_bill_run_id,\n// period_end)` matches the Bill Run \"find unrated records\" predicate\n// exactly \u2014 keep it in sync if that predicate changes.\n\n@Entity({ tableName: 'billing_account_usage' })\n@Unique({\n  name: 'billing_account_usage_source_ref_unique',\n  properties: ['tenantId', 'billAccountId', 'sourceRef'],\n})\n@Index({\n  name: 'billing_account_usage_rating_idx',\n  properties: ['billAccountId', 'uomCode', 'ratedInBillRunId', 'periodEnd'],\n})\nexport class BillingAccountUsage {\n  [OptionalProps]?:\n    | 'lineDescription'\n    | 'sourceRef'\n    | 'ratedInBillRunId'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // Must match the `uom_code` on a corresponding `type='usage'` Billing Item.\n  @Property({ name: 'uom_code', type: 'text' })\n  uomCode!: string\n\n  // numeric(18,4) \u2192 string in app code (standard MikroORM numeric handling).\n  @Property({ type: 'numeric', columnType: 'numeric(18, 4)' })\n  quantity!: string\n\n  @Property({ name: 'period_start', type: Date })\n  periodStart!: Date\n\n  @Property({ name: 'period_end', type: Date })\n  periodEnd!: Date\n\n  // Optional per-record description. When set, Bill Run emits one invoice\n  // line per Usage record with this description. When null, the run\n  // aggregates all matching Usage records into a single line using the\n  // Billing Item's `description`.\n  @Property({ name: 'line_description', type: 'text', nullable: true })\n  lineDescription?: string | null\n\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // Set when consumed; prevents double-rating on retry.\n  @Property({ name: 'rated_in_bill_run_id', type: 'uuid', nullable: true })\n  ratedInBillRunId?: string | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillRun \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A single execution of the engine \u2014 one row per trigger (schedule or\n// manual). The concurrency lock is a Postgres transaction-scoped advisory\n// lock keyed by hash(tenant_id || 'billing-run'); it is NOT stored on this\n// row. Crash recovery for zombie `status='running'` rows is handled by\n// workers/reap-stale-bill-runs.ts.\n\n@Entity({ tableName: 'billing_runs' })\n@Index({\n  name: 'billing_runs_tenant_status_idx',\n  properties: ['tenantId', 'status', 'startedAt'],\n})\n@Index({\n  name: 'billing_runs_parent_idx',\n  properties: ['parentRunId'],\n})\nexport class BillRun {\n  [OptionalProps]?:\n    | 'parentRunId'\n    | 'dryRun'\n    | 'testMode'\n    | 'catchUp'\n    | 'scopedAccountIds'\n    | 'startedAt'\n    | 'finishedAt'\n    | 'summary'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // 'schedule' | 'manual'.\n  @Property({ name: 'triggered_by', type: 'text' })\n  triggeredBy!: string\n\n  // Set when this run is a \"retry failed\" of a previous run.\n  @Property({ name: 'parent_run_id', type: 'uuid', nullable: true })\n  parentRunId?: string | null\n\n  // True \u2192 compute everything but persist nothing (preview).\n  @Property({ name: 'dry_run', type: 'boolean', default: false })\n  dryRun: boolean = false\n\n  // True \u2192 persist drafts flagged as test, but do not advance state.\n  @Property({ name: 'test_mode', type: 'boolean', default: false })\n  testMode: boolean = false\n\n  // True \u2192 loop missed cycles per account in one run (manual only).\n  @Property({ name: 'catch_up', type: 'boolean', default: false })\n  catchUp: boolean = false\n\n  // Optional \u2014 run processes only these accounts when set. JSONB\n  // (Postgres arrays would work too, but jsonb keeps tooling uniform\n  // across this package).\n  @Property({ name: 'scoped_account_ids', type: 'jsonb', nullable: true })\n  scopedAccountIds?: string[] | null\n\n  // The \"today\" the run uses to evaluate `next_bill_date <= as_of_date`.\n  @Property({ name: 'as_of_date', type: 'date', columnType: 'date' })\n  asOfDate!: Date\n\n  @Property({ name: 'started_at', type: Date, nullable: true })\n  startedAt?: Date | null\n\n  @Property({ name: 'finished_at', type: Date, nullable: true })\n  finishedAt?: Date | null\n\n  // 'running' | 'completed' | 'partial_failure' | 'failed'.\n  @Property({ type: 'text' })\n  status!: string\n\n  // { accounts_processed, drafts_created, drafts_skipped_existing,\n  //   accounts_failed, accounts_with_warnings, usage_records_rated }\n  @Property({ type: 'jsonb', nullable: true })\n  summary?: Record<string, unknown> | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillRunOutcome \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Per-account outcome of a Bill Run. Stored in its own table (not as a\n// JSONB array on BillRun.summary) so operators can query failures across\n// runs without jsonb_array_elements gymnastics. See spec rationale.\n\n@Entity({ tableName: 'billing_run_outcomes' })\n@Index({\n  name: 'billing_run_outcomes_run_status_idx',\n  properties: ['billRunId', 'status'],\n})\n@Index({\n  name: 'billing_run_outcomes_account_history_idx',\n  properties: ['organizationId', 'tenantId', 'billAccountId', 'createdAt'],\n})\nexport class BillRunOutcome {\n  [OptionalProps]?:\n    | 'errorMessage'\n    | 'warnings'\n    | 'draftInvoiceId'\n    | 'statementId'\n    | 'isActive'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_run_id', type: 'uuid' })\n  billRunId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'success' | 'success_with_warnings' | 'skipped_existing_draft' | 'failed'.\n  @Property({ type: 'text' })\n  status!: string\n\n  @Property({ name: 'error_message', type: 'text', nullable: true })\n  errorMessage?: string | null\n\n  // E.g. `{ unmatched_usage_uoms: [\"api_request\"] }`.\n  @Property({ type: 'jsonb', nullable: true })\n  warnings?: Record<string, unknown> | null\n\n  // FK string to the core/sales invoice (drafted by the run). Null when\n  // the run skipped (status='skipped_existing_draft' or 'failed').\n  @Property({ name: 'draft_invoice_id', type: 'uuid', nullable: true })\n  draftInvoiceId?: string | null\n\n  // FK (string) to the BillingStatement produced for a PREPAID account\n  // (SPEC-002). Prepaid accounts get a statement instead of a draft invoice\n  // at period close, so this is the prepaid analogue of `draft_invoice_id`.\n  @Property({ name: 'statement_id', type: 'uuid', nullable: true })\n  statementId?: string | null\n\n  @Property({ name: 'is_active', type: 'boolean', default: true })\n  isActive: boolean = true\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 DraftInvoiceEdit (audit) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Append-only audit of every operator edit on a draft invoice line.\n// Pattern mirrors `cpq_subscription_change_logs` \u2014 minimal columns\n// (no updated_at / is_active), append-only, soft-delete reserved for\n// compliance erasure only.\n\n@Entity({ tableName: 'billing_draft_invoice_edits' })\n@Index({\n  name: 'billing_draft_invoice_edits_invoice_idx',\n  properties: ['organizationId', 'tenantId', 'invoiceId', 'createdAt'],\n})\n@Index({\n  name: 'billing_draft_invoice_edits_user_idx',\n  properties: ['organizationId', 'tenantId', 'userId', 'createdAt'],\n})\nexport class DraftInvoiceEdit {\n  [OptionalProps]?: 'invoiceLineId' | 'beforeJson' | 'afterJson' | 'createdAt' | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // FK string to the core/sales invoice (no ORM relation across packages).\n  @Property({ name: 'invoice_id', type: 'uuid' })\n  invoiceId!: string\n\n  // Null for `line_added` / `line_removed` actions whose target line does\n  // not yet (or no longer) exist on the invoice.\n  @Property({ name: 'invoice_line_id', type: 'uuid', nullable: true })\n  invoiceLineId?: string | null\n\n  @Property({ name: 'user_id', type: 'uuid' })\n  userId!: string\n\n  // 'line_added' | 'line_removed' | 'line_edited'.\n  @Property({ type: 'text' })\n  action!: string\n\n  // Snapshot before the edit. Null for `line_added` (no prior state).\n  @Property({ name: 'before_json', type: 'jsonb', nullable: true })\n  beforeJson?: Record<string, unknown> | null\n\n  // Snapshot after the edit. Null for `line_removed` (no resulting state).\n  @Property({ name: 'after_json', type: 'jsonb', nullable: true })\n  afterJson?: Record<string, unknown> | null\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  // Reserved for compliance erasure only; runtime never deletes audit rows\n  // through normal flows.\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingAccountBalance (SPEC-002) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// The denormalized running balance for a prepaid account \u2014 exactly one\n// row per prepaid account. It is the O(1) read AND the row the atomic\n// `UPDATE \u2026 RETURNING` debit/credit locks, which is why the balance is\n// NOT a column on `billing_accounts`: the high-write balance update never\n// touches the account row that the Bill Run hot-path index sits on.\n//\n// `balance` is the cache; the source of truth is\n// `SUM(billing_account_transactions.amount)`. The reconciliation invariant\n// `balance == SUM(amount) == latest.balance_after` is unit-tested.\n\n@Entity({ tableName: 'billing_account_balances' })\n@Unique({\n  name: 'billing_account_balances_account_unique',\n  properties: ['tenantId', 'billAccountId'],\n})\n@Index({\n  name: 'billing_account_balances_balance_idx',\n  properties: ['organizationId', 'tenantId', 'balance'],\n})\nexport class BillingAccountBalance {\n  [OptionalProps]?:\n    | 'lowBalanceThreshold'\n    | 'lastMovementAt'\n    | 'createdAt'\n    | 'updatedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  // Unique FK (string) to BillingAccount.id \u2014 one balance per account.\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // Denormalized from the account so the balance row is self-contained.\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  // Running balance. May be NEGATIVE (usage is never rejected). Maintained\n  // exclusively by the atomic `UPDATE \u2026 RETURNING` in lib/balanceLedger.ts.\n  @Property({ name: 'balance', type: 'numeric', columnType: 'numeric(18, 4)', default: '0' })\n  balance: string = '0'\n\n  // When `balance <= threshold` \u2192 status `low` + `billing.balance.low`.\n  // Null = use the tenant config default\n  // (`billing.prepaid.low_balance_threshold_default`).\n  @Property({\n    name: 'low_balance_threshold',\n    type: 'numeric',\n    columnType: 'numeric(18, 4)',\n    nullable: true,\n  })\n  lowBalanceThreshold?: string | null\n\n  // Timestamp of the most recent transaction \u2014 a cheap \"is this account\n  // active?\" signal.\n  @Property({ name: 'last_movement_at', type: Date, nullable: true })\n  lastMovementAt?: Date | null\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n}\n\n// \u2500\u2500\u2500 BillingAccountTransaction (SPEC-002, append-only) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// The source of truth for every balance movement. Append-only \u2014 pattern\n// mirrors DraftInvoiceEdit (no `updated_at` / `is_active`; `deleted_at`\n// reserved for compliance erasure only). `balance = SUM(amount)`.\n//\n// The unique `(tenant_id, bill_account_id, source_ref)` is the idempotency\n// gate: a deduplicated usage upload or a retried recurring charge can never\n// double-debit (Postgres treats NULL source_ref as distinct \u2014 manual\n// adjustments without a key always insert).\n\n@Entity({ tableName: 'billing_account_transactions' })\n@Unique({\n  name: 'billing_account_transactions_source_ref_unique',\n  properties: ['tenantId', 'billAccountId', 'sourceRef'],\n})\n@Index({\n  name: 'billing_account_transactions_history_idx',\n  properties: ['organizationId', 'tenantId', 'billAccountId', 'createdAt'],\n})\n@Index({\n  name: 'billing_account_transactions_account_type_idx',\n  properties: ['billAccountId', 'type', 'createdAt'],\n})\nexport class BillingAccountTransaction {\n  [OptionalProps]?:\n    | 'usageId'\n    | 'billingItemId'\n    | 'topupId'\n    | 'statementId'\n    | 'sourceRef'\n    | 'metadata'\n    | 'userId'\n    | 'createdAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'topup' | 'usage' | 'recurring' | 'one_time' | 'adjustment' | 'reversal'.\n  @Property({ type: 'text' })\n  type!: string\n\n  // SIGNED: `> 0` credit, `< 0` debit. Balance = SUM(amount).\n  @Property({ type: 'numeric', columnType: 'numeric(18, 4)' })\n  amount!: string\n\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  // Running balance AFTER this transaction \u2014 snapshotted from the atomic\n  // `UPDATE \u2026 RETURNING`. Enables audit + fast statement math without\n  // re-summing the whole ledger.\n  @Property({ name: 'balance_after', type: 'numeric', columnType: 'numeric(18, 4)' })\n  balanceAfter!: string\n\n  // FK (string) to BillingAccountUsage for type='usage'.\n  @Property({ name: 'usage_id', type: 'uuid', nullable: true })\n  usageId?: string | null\n\n  // FK (string) to the Billing Item that priced this debit.\n  @Property({ name: 'billing_item_id', type: 'uuid', nullable: true })\n  billingItemId?: string | null\n\n  // FK (string) to BillingTopup for type='topup'.\n  @Property({ name: 'topup_id', type: 'uuid', nullable: true })\n  topupId?: string | null\n\n  // FK (string) to the BillingStatement a period-close charge was rolled into.\n  @Property({ name: 'statement_id', type: 'uuid', nullable: true })\n  statementId?: string | null\n\n  @Property({ type: 'text' })\n  description!: string\n\n  // Idempotency key, unique per (tenant_id, bill_account_id, source_ref).\n  // usage debits = the usage record's source_ref; recurring =\n  // `recurring-{itemId}-{periodEndISO}`; topup = `topup-{paymentId}`.\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // e.g. usage_tier_breakdown, uom_code, bill_period_start/end, gateway ids.\n  @Property({ type: 'jsonb', nullable: true })\n  metadata?: Record<string, unknown> | null\n\n  // Operator for manual `adjustment` / `reversal`.\n  @Property({ name: 'user_id', type: 'uuid', nullable: true })\n  userId?: string | null\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  // Compliance erasure only.\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingTopup (SPEC-002 \u2014 the \"registered top-up\") \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// One row per top-up attempt with a lifecycle (pending \u2192 captured | failed\n// | expired | cancelled), linked to its GatewayTransaction, its balance\n// credit transaction, and its VAT receipt invoice. \"The balance went up\"\n// is always explainable.\n\n@Entity({ tableName: 'billing_topups' })\n@Unique({\n  name: 'billing_topups_payment_id_unique',\n  properties: ['tenantId', 'paymentId'],\n})\n@Index({\n  name: 'billing_topups_account_history_idx',\n  properties: ['organizationId', 'tenantId', 'billAccountId', 'createdAt'],\n})\n@Index({\n  name: 'billing_topups_status_idx',\n  properties: ['tenantId', 'status'],\n})\nexport class BillingTopup {\n  [OptionalProps]?:\n    | 'gatewayTransactionId'\n    | 'transactionId'\n    | 'receiptInvoiceId'\n    | 'sourceRef'\n    | 'metadata'\n    | 'createdAt'\n    | 'updatedAt'\n    | 'deletedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // 'pending' | 'captured' | 'failed' | 'expired' | 'cancelled'.\n  @Property({ type: 'text' })\n  status!: string\n\n  @Property({ type: 'numeric', columnType: 'numeric(18, 4)' })\n  amount!: string\n\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  @Property({ name: 'provider_key', type: 'text' })\n  providerKey!: string\n\n  // The UUID we pass to createPaymentSession and match the captured event\n  // on. Unique per tenant.\n  @Property({ name: 'payment_id', type: 'uuid' })\n  paymentId!: string\n\n  // FK (string) to payment_gateways.GatewayTransaction once the session is\n  // created.\n  @Property({ name: 'gateway_transaction_id', type: 'uuid', nullable: true })\n  gatewayTransactionId?: string | null\n\n  // FK (string) to the credit BillingAccountTransaction written on capture.\n  @Property({ name: 'transaction_id', type: 'uuid', nullable: true })\n  transactionId?: string | null\n\n  // FK (string) to the core/sales VAT receipt invoice.\n  @Property({ name: 'receipt_invoice_id', type: 'uuid', nullable: true })\n  receiptInvoiceId?: string | null\n\n  // Optional idempotency for the initiating request.\n  @Property({ name: 'source_ref', type: 'text', nullable: true })\n  sourceRef?: string | null\n\n  // success_url / cancel_url, provider payload echoes.\n  @Property({ type: 'jsonb', nullable: true })\n  metadata?: Record<string, unknown> | null\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n\n  @Property({ name: 'deleted_at', type: Date, nullable: true })\n  deletedAt?: Date | null\n}\n\n// \u2500\u2500\u2500 BillingStatement (SPEC-002 \u2014 period close) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// A non-fiscal consumption summary for a prepaid account's bill period.\n// Chains cleanly: each statement's `opening_balance` equals the prior\n// statement's `closing_balance`. Anti-duplicate via the unique\n// (tenant_id, bill_account_id, period_start, period_end).\n\n@Entity({ tableName: 'billing_statements' })\n@Unique({\n  name: 'billing_statements_period_unique',\n  properties: ['tenantId', 'billAccountId', 'periodStart', 'periodEnd'],\n})\n@Index({\n  name: 'billing_statements_account_period_idx',\n  properties: ['organizationId', 'tenantId', 'billAccountId', 'periodEnd'],\n})\nexport class BillingStatement {\n  [OptionalProps]?:\n    | 'billRunId'\n    | 'totalAdjustments'\n    | 'createdAt'\n    | 'updatedAt'\n\n  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })\n  id!: string\n\n  @Property({ name: 'organization_id', type: 'uuid' })\n  organizationId!: string\n\n  @Property({ name: 'tenant_id', type: 'uuid' })\n  tenantId!: string\n\n  @Property({ name: 'bill_account_id', type: 'uuid' })\n  billAccountId!: string\n\n  // FK (string) to the BillRun that generated it (period close reuses the\n  // run engine). Null for a manually-generated statement.\n  @Property({ name: 'bill_run_id', type: 'uuid', nullable: true })\n  billRunId?: string | null\n\n  @Property({ name: 'period_start', type: 'date', columnType: 'date' })\n  periodStart!: Date\n\n  @Property({ name: 'period_end', type: 'date', columnType: 'date' })\n  periodEnd!: Date\n\n  @Property({ name: 'currency_code', type: 'text' })\n  currencyCode!: string\n\n  // Balance at period_start (= the prior statement's closing_balance).\n  @Property({ name: 'opening_balance', type: 'numeric', columnType: 'numeric(18, 4)' })\n  openingBalance!: string\n\n  // Sum of credits in window.\n  @Property({ name: 'total_topups', type: 'numeric', columnType: 'numeric(18, 4)' })\n  totalTopups!: string\n\n  // Sum of metered (real-time) usage debits in window (absolute).\n  @Property({ name: 'total_usage', type: 'numeric', columnType: 'numeric(18, 4)' })\n  totalUsage!: string\n\n  // Sum of recurring + one_time charges debited at this close (absolute).\n  @Property({ name: 'total_recurring', type: 'numeric', columnType: 'numeric(18, 4)' })\n  totalRecurring!: string\n\n  // Signed sum of manual adjustment + reversal movements in the window. Kept as\n  // its own term so the statement stays self-consistent (closing reproduces\n  // from the shown components) and the opening\u2192closing chain never drifts.\n  @Property({ name: 'total_adjustments', type: 'numeric', columnType: 'numeric(18, 4)', default: '0' })\n  totalAdjustments: string = '0'\n\n  // opening + topups + adjustments \u2212 usage \u2212 recurring (= the period's net).\n  @Property({ name: 'closing_balance', type: 'numeric', columnType: 'numeric(18, 4)' })\n  closingBalance!: string\n\n  // Per billing_item_id: { billing_type, uom_code?, quantity, amount }.\n  @Property({ name: 'debit_breakdown', type: 'jsonb' })\n  debitBreakdown!: Record<string, unknown>\n\n  // 'generated' | 'sent'.\n  @Property({ type: 'text' })\n  status!: string\n\n  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })\n  createdAt: Date = new Date()\n\n  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })\n  updatedAt: Date = new Date()\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/data/entityIds.js

@@ -4,7 +4,12 @@ const billingEntityIds = {
   usage: "billing:billing_account_usage",
   run: "billing:billing_run",
   runOutcome: "billing:billing_run_outcome",
-  draftInvoiceEdit: "billing:billing_draft_invoice_edit"
+  draftInvoiceEdit: "billing:billing_draft_invoice_edit",
+  // SPEC-002 (prepaid balance billing)
+  balance: "billing:billing_account_balance",
+  transaction: "billing:billing_account_transaction",
+  topup: "billing:billing_topup",
+  statement: "billing:billing_statement"
 };
 export {
   billingEntityIds

package/dist/modules/billing/data/entityIds.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/data/entityIds.ts"],
-  "sourcesContent": ["/**\n * Canonical entity IDs for the billing module.\n *\n * Mirrors what `E.billing.<entity>` would be in\n * `.mercato/generated/entities.ids.generated.ts` if the standalone-app\n * CLI properly discovered `@dainamite/*` workspace entities (see the\n * Phase 0 deviation note in `xd-249-billing-spec.md`). Until the CLI\n * gap is closed upstream, this is the single source of truth \u2014 every\n * place that previously would have referenced `E.billing.*` (CRUD\n * factory `entityId`, indexer `entityType`, response enricher\n * `targetEntity`, etc.) imports from here instead.\n *\n * When the CLI is fixed, this file can be replaced by `import { E }\n * from '#generated/entities.ids.generated'` in one PR.\n */\nexport const billingEntityIds = {\n  account: 'billing:billing_account',\n  item: 'billing:billing_item',\n  usage: 'billing:billing_account_usage',\n  run: 'billing:billing_run',\n  runOutcome: 'billing:billing_run_outcome',\n  draftInvoiceEdit: 'billing:billing_draft_invoice_edit',\n} as const\n\nexport type BillingEntityId = (typeof billingEntityIds)[keyof typeof billingEntityIds]\n"],
-  "mappings": "AAeO,MAAM,mBAAmB;AAAA,EAC9B,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,kBAAkB;AACpB;",
+  "sourcesContent": ["/**\n * Canonical entity IDs for the billing module.\n *\n * Mirrors what `E.billing.<entity>` would be in\n * `.mercato/generated/entities.ids.generated.ts` if the standalone-app\n * CLI properly discovered `@dainamite/*` workspace entities (see the\n * Phase 0 deviation note in `xd-249-billing-spec.md`). Until the CLI\n * gap is closed upstream, this is the single source of truth \u2014 every\n * place that previously would have referenced `E.billing.*` (CRUD\n * factory `entityId`, indexer `entityType`, response enricher\n * `targetEntity`, etc.) imports from here instead.\n *\n * When the CLI is fixed, this file can be replaced by `import { E }\n * from '#generated/entities.ids.generated'` in one PR.\n */\nexport const billingEntityIds = {\n  account: 'billing:billing_account',\n  item: 'billing:billing_item',\n  usage: 'billing:billing_account_usage',\n  run: 'billing:billing_run',\n  runOutcome: 'billing:billing_run_outcome',\n  draftInvoiceEdit: 'billing:billing_draft_invoice_edit',\n  // SPEC-002 (prepaid balance billing)\n  balance: 'billing:billing_account_balance',\n  transaction: 'billing:billing_account_transaction',\n  topup: 'billing:billing_topup',\n  statement: 'billing:billing_statement',\n} as const\n\nexport type BillingEntityId = (typeof billingEntityIds)[keyof typeof billingEntityIds]\n"],
+  "mappings": "AAeO,MAAM,mBAAmB;AAAA,EAC9B,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,kBAAkB;AAAA;AAAA,EAElB,SAAS;AAAA,EACT,aAAa;AAAA,EACb,OAAO;AAAA,EACP,WAAW;AACb;",
   "names": []
 }