@dainamite/billing 0.17.0 → 0.19.0

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

@@ -7,10 +7,32 @@ const BILL_RUN_OUTCOME_STATUSES = [
   "success",
   "success_with_warnings",
   "skipped_existing_draft",
+  // SPEC-002: prepaid period close was skipped because a statement already
+  // exists for the window.
+  "skipped_existing_statement",
   "failed"
 ];
 const DRAFT_INVOICE_EDIT_ACTIONS = ["line_added", "line_removed", "line_edited"];
 const INVOICE_STATUSES = ["draft", "posted", "paid", "void"];
+const BILLING_MODES = ["postpaid", "prepaid"];
+const TRANSACTION_TYPES = [
+  "topup",
+  "usage",
+  "recurring",
+  "one_time",
+  "adjustment",
+  "reversal"
+];
+const TOPUP_STATUSES = [
+  "pending",
+  "captured",
+  "failed",
+  "expired",
+  "cancelled"
+];
+const STATEMENT_STATUSES = ["generated", "sent"];
+const BALANCE_STATUSES = ["ok", "low", "exhausted"];
+const CREDIT_STATUSES = ["within_limit", "near_limit", "over_limit"];
 const WEEKLY_ANCHORS = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
 const billCycleAnchorSchema = z.string().min(1).refine(
   (val) => {
@@ -111,6 +133,7 @@ const listPaginationBase = {
   sortField: z.string().optional(),
   sortDir: z.enum(["asc", "desc"]).optional()
 };
+const moneyNonNegative = z.number().finite().nonnegative();
 const billingAccountCreateSchema = scopedSchema.extend({
   customerId: z.string().min(1).max(255),
   name: z.string().trim().min(1).max(255),
@@ -126,7 +149,15 @@ const billingAccountCreateSchema = scopedSchema.extend({
   invoiceAddress: invoiceAddressSchema,
   nextBillDate: z.coerce.date(),
   lastBillDate: z.coerce.date().optional(),
-  isActive: z.boolean().optional()
+  isActive: z.boolean().optional(),
+  // SPEC-002: mode is immutable after create (like currencyCode). Default
+  // 'postpaid' so existing callers are unaffected.
+  billingMode: z.enum(BILLING_MODES).optional(),
+  // Credit line (both modes). 0 = no credit.
+  creditLimit: moneyNonNegative.optional(),
+  // Initial low-balance threshold for a prepaid account's balance row.
+  // Null = resolve the tenant config default at read time.
+  lowBalanceThreshold: moneyNonNegative.nullable().optional()
 });
 const billingAccountUpdateSchema = scopedSchema.extend({
   id: z.string().uuid(),
@@ -139,7 +170,14 @@ const billingAccountUpdateSchema = scopedSchema.extend({
   invoiceAddress: invoiceAddressSchema.optional(),
   nextBillDate: z.coerce.date().optional(),
   lastBillDate: z.coerce.date().nullable().optional(),
-  isActive: z.boolean().optional()
+  isActive: z.boolean().optional(),
+  // SPEC-002: credit_limit is editable (it's an AR/overdraft policy knob);
+  // `billingMode` is intentionally NOT updatable — mode is frozen at create
+  // (like currencyCode), no live postpaid↔prepaid switch in v1.
+  creditLimit: moneyNonNegative.optional(),
+  // Editing the prepaid balance row's low-balance threshold. Null clears it
+  // back to the tenant config default.
+  lowBalanceThreshold: moneyNonNegative.nullable().optional()
   // `currencyCode` is intentionally NOT updatable — currency is frozen at
   // account create time so historical invoices keep their currency context.
   // `customerId` is also immutable; create a new account if the customer
@@ -154,6 +192,7 @@ const billingAccountListQuerySchema = z.object({
   customerId: z.string().optional(),
   currencyCode: z.string().optional(),
   billCycle: z.enum(BILL_CYCLES).optional(),
+  billingMode: z.enum(BILLING_MODES).optional(),
   isActive: z.coerce.boolean().optional(),
   search: z.string().optional()
 }).passthrough();
@@ -353,15 +392,75 @@ const billingWipeTestInvoicesSchema = scopedSchema.extend({
   /** Optional — when set, wipes only test invoices from this run. */
   billRunId: z.string().uuid().optional()
 });
+const billingTopupCreateSchema = scopedSchema.extend({
+  // The route maps the `/accounts/{id}/topups` path param into billAccountId.
+  billAccountId: z.string().uuid(),
+  amount: z.number().finite().positive(),
+  // Optional — defaults to the tenant config `prepaid.topup_provider`.
+  providerKey: z.string().trim().min(1).max(64).optional(),
+  successUrl: z.string().trim().url().max(2048).optional(),
+  cancelUrl: z.string().trim().url().max(2048).optional(),
+  // Optional idempotency for the initiating request.
+  sourceRef: z.string().trim().min(1).max(255).optional()
+});
+const billingTopupListQuerySchema = z.object({
+  ...listPaginationBase,
+  id: z.string().uuid().optional(),
+  billAccountId: z.string().uuid().optional(),
+  status: z.enum(TOPUP_STATUSES).optional(),
+  search: z.string().optional()
+}).passthrough();
+const billingTransactionAdjustSchema = scopedSchema.extend({
+  billAccountId: z.string().uuid(),
+  // SIGNED: > 0 credit, < 0 debit. Zero is rejected.
+  amount: z.number().finite(),
+  description: z.string().trim().min(1).max(500),
+  sourceRef: z.string().trim().min(1).max(255).optional()
+}).superRefine((val, ctx) => {
+  if (val.amount === 0) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["amount"],
+      message: "amount must be non-zero (positive credit or negative debit)"
+    });
+  }
+});
+const billingTransactionListQuerySchema = z.object({
+  ...listPaginationBase,
+  id: z.string().uuid().optional(),
+  billAccountId: z.string().uuid().optional(),
+  type: z.enum(TRANSACTION_TYPES).optional(),
+  createdFrom: z.coerce.date().optional(),
+  createdTo: z.coerce.date().optional()
+}).passthrough();
+const billingStatementGenerateSchema = scopedSchema.extend({
+  billAccountId: z.string().uuid(),
+  // "today" the close evaluates the due period against. Defaults to now.
+  asOfDate: z.coerce.date().optional()
+});
+const billingStatementListQuerySchema = z.object({
+  ...listPaginationBase,
+  id: z.string().uuid().optional(),
+  billAccountId: z.string().uuid().optional(),
+  status: z.enum(STATEMENT_STATUSES).optional(),
+  periodEndFrom: z.coerce.date().optional(),
+  periodEndTo: z.coerce.date().optional()
+}).passthrough();
 export {
+  BALANCE_STATUSES,
   BILLING_ITEM_TYPES,
+  BILLING_MODES,
   BILL_CYCLES,
   BILL_RUN_MODES,
   BILL_RUN_OUTCOME_STATUSES,
   BILL_RUN_STATUSES,
   BILL_RUN_TRIGGERS,
+  CREDIT_STATUSES,
   DRAFT_INVOICE_EDIT_ACTIONS,
   INVOICE_STATUSES,
+  STATEMENT_STATUSES,
+  TOPUP_STATUSES,
+  TRANSACTION_TYPES,
   billCycleAnchorSchema,
   billingAccountCreateSchema,
   billingAccountDeleteSchema,
@@ -379,6 +478,12 @@ export {
   billingRunListQuerySchema,
   billingRunRetryFailedSchema,
   billingRunTriggerSchema,
+  billingStatementGenerateSchema,
+  billingStatementListQuerySchema,
+  billingTopupCreateSchema,
+  billingTopupListQuerySchema,
+  billingTransactionAdjustSchema,
+  billingTransactionListQuerySchema,
   billingUsageCreateSchema,
   billingUsageListQuerySchema,
   billingWipeTestInvoicesSchema,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/data/validators.ts"],
-  "sourcesContent": ["import { z } from 'zod'\n\n// \u2500\u2500\u2500 Enums \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const BILLING_ITEM_TYPES = ['one_time', 'recurring', 'usage'] as const\nexport type BillingItemType = (typeof BILLING_ITEM_TYPES)[number]\n\nexport const BILL_CYCLES = ['weekly', 'monthly', 'quarterly', 'annually'] as const\nexport type BillCycle = (typeof BILL_CYCLES)[number]\n\nexport const BILL_RUN_TRIGGERS = ['schedule', 'manual'] as const\nexport type BillRunTrigger = (typeof BILL_RUN_TRIGGERS)[number]\n\nexport const BILL_RUN_STATUSES = ['running', 'completed', 'partial_failure', 'failed'] as const\nexport type BillRunStatus = (typeof BILL_RUN_STATUSES)[number]\n\nexport const BILL_RUN_OUTCOME_STATUSES = [\n  'success',\n  'success_with_warnings',\n  'skipped_existing_draft',\n  'failed',\n] as const\nexport type BillRunOutcomeStatus = (typeof BILL_RUN_OUTCOME_STATUSES)[number]\n\nexport const DRAFT_INVOICE_EDIT_ACTIONS = ['line_added', 'line_removed', 'line_edited'] as const\nexport type DraftInvoiceEditAction = (typeof DRAFT_INVOICE_EDIT_ACTIONS)[number]\n\nexport const INVOICE_STATUSES = ['draft', 'posted', 'paid', 'void'] as const\nexport type InvoiceStatus = (typeof INVOICE_STATUSES)[number]\n\n// `mon`\u2013`sun` for weekly cycles; 1\u201328 (as text) for the others.\n// Why text for numeric anchors: the column type stays uniform across cycles\n// and we never do arithmetic on the raw value (the engine parses it on use).\nconst WEEKLY_ANCHORS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] as const\n\nexport const billCycleAnchorSchema = z\n  .string()\n  .min(1)\n  .refine(\n    (val) => {\n      if ((WEEKLY_ANCHORS as readonly string[]).includes(val.toLowerCase())) return true\n      const n = Number.parseInt(val, 10)\n      return Number.isInteger(n) && n >= 1 && n <= 28\n    },\n    {\n      message:\n        'bill_cycle_anchor must be 1\u201328 (monthly/quarterly/annually) or mon\u2013sun (weekly)',\n    },\n  )\n\n// \u2500\u2500\u2500 rate_json \u2014 pricing definitions \u2500\u2500\u2500\u2500\u2500\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// Validated at API ingress so the engine can trust the shape downstream.\n// Negative amounts are intentionally allowed only on `one_time` (refunds /\n// credits / proration credits). Recurring and usage unit prices MUST be\n// non-negative \u2014 discounts on those are modeled as separate `one_time`\n// credit items.\n\nconst numericNonNegative = z.number().finite().nonnegative()\nconst numericAny = z.number().finite()\n\nexport const rateJsonOneTime = z\n  .object({ amount: numericAny })\n  .strict()\n\nexport const rateJsonRecurring = z\n  .object({ unit_price: numericNonNegative })\n  .strict()\n\nexport const rateJsonUsageSimple = z\n  .object({ unit_price: numericNonNegative })\n  .strict()\n\nconst tierWithUnitPrice = z\n  .object({\n    up_to: z.union([z.number().int().positive(), z.null()]),\n    unit_price: numericNonNegative,\n  })\n  .strict()\n\nconst tierWithFlatAmount = z\n  .object({\n    up_to: z.union([z.number().int().positive(), z.null()]),\n    flat_amount: numericNonNegative,\n  })\n  .strict()\n\n// All tiers must use the same key shape (consistent with the model). Mixing\n// `unit_price` and `flat_amount` across tiers is rejected \u2014 see spec\n// validation rules.\nconst tiersUnitPrice = z\n  .array(tierWithUnitPrice)\n  .min(1, 'tiers must be a non-empty array')\nconst tiersFlatAmount = z\n  .array(tierWithFlatAmount)\n  .min(1, 'tiers must be a non-empty array')\n\nfunction refineTierProgression<T extends { up_to: number | null }>(\n  tiers: T[],\n  ctx: z.RefinementCtx,\n): void {\n  const openTopCount = tiers.filter((t) => t.up_to === null).length\n  if (openTopCount !== 1) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: 'tiers must contain exactly one open-ended top tier (up_to: null)',\n    })\n    return\n  }\n  if (tiers[tiers.length - 1].up_to !== null) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: 'the open-ended top tier (up_to: null) must be the last entry',\n    })\n    return\n  }\n  for (let i = 1; i < tiers.length - 1; i++) {\n    const prev = tiers[i - 1].up_to\n    const curr = tiers[i].up_to\n    if (prev !== null && curr !== null && curr <= prev) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: `up_to values must be strictly increasing across tiers (failed at index ${i})`,\n      })\n      return\n    }\n  }\n}\n\nexport const rateJsonUsageVolume = z\n  .object({\n    model: z.literal('volume'),\n    tiers: tiersUnitPrice,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageGraduated = z\n  .object({\n    model: z.literal('graduated'),\n    tiers: tiersUnitPrice,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageFlat = z\n  .object({\n    model: z.literal('flat'),\n    tiers: tiersFlatAmount,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageTiered = z.discriminatedUnion('model', [\n  rateJsonUsageVolume,\n  rateJsonUsageGraduated,\n  rateJsonUsageFlat,\n])\n\nexport const rateJsonUsage = z.union([rateJsonUsageSimple, rateJsonUsageTiered])\n\n/**\n * Validate a `rate_json` payload against the rules for a given Billing Item\n * `type`. Returns the parsed value or throws a `ZodError` whose message\n * surfaces the specific shape violation.\n */\nexport function validateRateJson(\n  type: BillingItemType,\n  rateJson: unknown,\n):\n  | z.infer<typeof rateJsonOneTime>\n  | z.infer<typeof rateJsonRecurring>\n  | z.infer<typeof rateJsonUsage> {\n  switch (type) {\n    case 'one_time':\n      return rateJsonOneTime.parse(rateJson)\n    case 'recurring':\n      return rateJsonRecurring.parse(rateJson)\n    case 'usage':\n      return rateJsonUsage.parse(rateJson)\n  }\n}\n\n// \u2500\u2500\u2500 Invoice address (BillingAccount.invoice_address) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const invoiceAddressSchema = z\n  .object({\n    line1: z.string().min(1),\n    line2: z.string().optional(),\n    city: z.string().min(1),\n    postal_code: z.string().min(1),\n    country: z.string().min(2).max(3), // ISO 3166-1 alpha-2 or alpha-3\n  })\n  .strict()\n\nexport type InvoiceAddress = z.infer<typeof invoiceAddressSchema>\n\n// \u2500\u2500\u2500 Scope (injected by withScopedPayload at API ingress) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst scopedSchema = z.object({\n  tenantId: z.string().uuid(),\n  organizationId: z.string().uuid(),\n})\n\n// \u2500\u2500\u2500 List pagination (shared shape) \u2500\u2500\u2500\u2500\u2500\u2500\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\nconst listPaginationBase = {\n  page: z.coerce.number().int().min(1).default(1),\n  pageSize: z.coerce.number().int().min(1).max(100).default(50),\n  sortField: z.string().optional(),\n  sortDir: z.enum(['asc', 'desc']).optional(),\n}\n\n// \u2500\u2500\u2500 BillingAccount payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingAccountCreateSchema = scopedSchema.extend({\n  customerId: z.string().min(1).max(255),\n  name: z.string().trim().min(1).max(255),\n  currencyCode: z.string().trim().toUpperCase().length(3),\n  billCycle: z.enum(BILL_CYCLES),\n  billCycleAnchor: billCycleAnchorSchema,\n  invoiceEmail: z.string().trim().email().max(320),\n  invoiceLanguage: z.string().trim().toLowerCase().min(2).max(5),\n  // Nullable + optional \u2014 consistent with the update schema, and the\n  // cpq-billing-connector's shell-account seed sends `taxId: null`\n  // for customers with no tax id.\n  taxId: z.string().trim().max(64).nullable().optional(),\n  invoiceAddress: invoiceAddressSchema,\n  nextBillDate: z.coerce.date(),\n  lastBillDate: z.coerce.date().optional(),\n  isActive: z.boolean().optional(),\n})\n\nexport type BillingAccountCreateInput = z.infer<typeof billingAccountCreateSchema>\n\nexport const billingAccountUpdateSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n  name: z.string().trim().min(1).max(255).optional(),\n  billCycle: z.enum(BILL_CYCLES).optional(),\n  billCycleAnchor: billCycleAnchorSchema.optional(),\n  invoiceEmail: z.string().trim().email().max(320).optional(),\n  invoiceLanguage: z.string().trim().toLowerCase().min(2).max(5).optional(),\n  taxId: z.string().trim().max(64).nullable().optional(),\n  invoiceAddress: invoiceAddressSchema.optional(),\n  nextBillDate: z.coerce.date().optional(),\n  lastBillDate: z.coerce.date().nullable().optional(),\n  isActive: z.boolean().optional(),\n  // `currencyCode` is intentionally NOT updatable \u2014 currency is frozen at\n  // account create time so historical invoices keep their currency context.\n  // `customerId` is also immutable; create a new account if the customer\n  // FK changes.\n})\n\nexport type BillingAccountUpdateInput = z.infer<typeof billingAccountUpdateSchema>\n\nexport const billingAccountDeleteSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n})\n\nexport type BillingAccountDeleteInput = z.infer<typeof billingAccountDeleteSchema>\n\nexport const billingAccountListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    customerId: z.string().optional(),\n    currencyCode: z.string().optional(),\n    billCycle: z.enum(BILL_CYCLES).optional(),\n    isActive: z.coerce.boolean().optional(),\n    search: z.string().optional(),\n  })\n  .passthrough()\n\nexport type BillingAccountListQuery = z.infer<typeof billingAccountListQuerySchema>\n\n// \u2500\u2500\u2500 BillingItem payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nconst ratePayloadByType = z\n  .object({\n    type: z.enum(BILLING_ITEM_TYPES),\n    rateJson: z.unknown(),\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['rateJson'],\n        message: err instanceof Error ? err.message : 'rate_json is invalid for this type',\n      })\n    }\n  })\n\nexport const billingItemCreateSchema = scopedSchema\n  .extend({\n    billAccountId: z.string().uuid(),\n    type: z.enum(BILLING_ITEM_TYPES),\n    billStartDate: z.coerce.date(),\n    billEndDate: z.coerce.date().nullable().optional(),\n    description: z.string().trim().min(1).max(500),\n    rateJson: z.unknown(), // shape validated via the refine below\n    uomCode: z.string().trim().max(64).optional(),\n    subscriptionId: z.string().trim().max(255).optional(),\n    subscriptionItemId: z.string().trim().max(255).optional(),\n    // `source_ref` is the idempotency key. NULL \u2192 no dedup, always create.\n    sourceRef: z.string().trim().min(1).max(255).optional(),\n    // currency_mismatch and billed_to_date are system-managed, never set by\n    // clients on create.\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      const message = err instanceof Error ? err.message : 'rate_json is invalid for this type'\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['rateJson'], message })\n    }\n    if (val.type === 'usage' && !val.uomCode) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['uomCode'],\n        message: 'uomCode is required for type=usage',\n      })\n    }\n  })\n\nexport type BillingItemCreateInput = z.infer<typeof billingItemCreateSchema>\n\n// \u2500\u2500\u2500 Bulk item create (Phase 4g) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// One scope envelope, N item payloads. The CPQ connector activating\n// a large subscription used to fire one `billing.items.create` per\n// charge \u2014 bulk-create collapses that into a single command with a\n// batched `source_ref` idempotency check + single flush.\n\nconst billingItemBulkEntrySchema = z\n  .object({\n    billAccountId: z.string().uuid(),\n    type: z.enum(BILLING_ITEM_TYPES),\n    billStartDate: z.coerce.date(),\n    billEndDate: z.coerce.date().nullable().optional(),\n    description: z.string().trim().min(1).max(500),\n    rateJson: z.unknown(),\n    uomCode: z.string().trim().max(64).optional(),\n    subscriptionId: z.string().trim().max(255).optional(),\n    subscriptionItemId: z.string().trim().max(255).optional(),\n    sourceRef: z.string().trim().min(1).max(255).optional(),\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      const message = err instanceof Error ? err.message : 'rate_json is invalid for this type'\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['rateJson'], message })\n    }\n    if (val.type === 'usage' && !val.uomCode) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['uomCode'],\n        message: 'uomCode is required for type=usage',\n      })\n    }\n  })\n\nexport type BillingItemBulkEntry = z.infer<typeof billingItemBulkEntrySchema>\n\nexport const billingItemBulkCreateSchema = scopedSchema.extend({\n  // Cap at 500 per call \u2014 keeps a single bulk transaction bounded.\n  // A CPQ subscription with >500 charges should be split by the\n  // caller (the connector); 500 is already far past any realistic\n  // single-subscription charge count.\n  items: z.array(billingItemBulkEntrySchema).min(1).max(500),\n})\n\nexport type BillingItemBulkCreateInput = z.infer<typeof billingItemBulkCreateSchema>\n\nexport const billingItemUpdateSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n  // `type` is immutable \u2014 changing one_time \u2192 recurring would silently\n  // change billing semantics. Cancel the old item, create a new one.\n  billStartDate: z.coerce.date().optional(),\n  billEndDate: z.coerce.date().nullable().optional(),\n  description: z.string().trim().min(1).max(500).optional(),\n  rateJson: z.unknown().optional(),\n  uomCode: z.string().trim().max(64).nullable().optional(),\n  subscriptionId: z.string().trim().max(255).nullable().optional(),\n  subscriptionItemId: z.string().trim().max(255).nullable().optional(),\n  // `source_ref` immutable \u2014 it's the idempotency identity of the item.\n  isActive: z.boolean().optional(),\n})\n\nexport type BillingItemUpdateInput = z.infer<typeof billingItemUpdateSchema>\n\nexport const billingItemDeleteSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n})\n\nexport type BillingItemDeleteInput = z.infer<typeof billingItemDeleteSchema>\n\nexport const billingItemListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    search: z.string().optional(),\n    billAccountId: z.string().uuid().optional(),\n    type: z.enum(BILLING_ITEM_TYPES).optional(),\n    subscriptionId: z.string().optional(),\n    isActive: z.coerce.boolean().optional(),\n    activeAt: z.coerce.date().optional(), // bill_start_date <= X AND (bill_end_date IS NULL OR bill_end_date >= X)\n  })\n  .passthrough()\n\nexport type BillingItemListQuery = z.infer<typeof billingItemListQuerySchema>\n\n// \u2500\u2500\u2500 BillingAccountUsage payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingUsageCreateSchema = scopedSchema.extend({\n  billAccountId: z.string().uuid(),\n  uomCode: z.string().trim().min(1).max(64),\n  // `quantity` arrives as a number from JSON; MikroORM stores it as\n  // numeric(18,4). The service coerces to a string at persist time.\n  quantity: z.number().finite().nonnegative(),\n  periodStart: z.coerce.date(),\n  periodEnd: z.coerce.date(),\n  lineDescription: z.string().trim().min(1).max(500).optional(),\n  sourceRef: z.string().trim().min(1).max(255).optional(),\n}).superRefine((val, ctx) => {\n  if (val.periodEnd < val.periodStart) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['periodEnd'],\n      message: 'periodEnd must be on or after periodStart',\n    })\n  }\n})\n\nexport type BillingUsageCreateInput = z.infer<typeof billingUsageCreateSchema>\n\nexport const billingUsageListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    billAccountId: z.string().uuid().optional(),\n    uomCode: z.string().optional(),\n    rated: z.coerce.boolean().optional(), // true \u2192 already rated; false \u2192 unrated\n    periodEndFrom: z.coerce.date().optional(),\n    periodEndTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingUsageListQuery = z.infer<typeof billingUsageListQuerySchema>\n\n// Suppress unused-export TS warning \u2014 `ratePayloadByType` is reserved for\n// reuse by a future per-tenant rate-validation CLI tool.\nvoid ratePayloadByType\n\n// \u2500\u2500\u2500 Bill Run trigger payloads (Phase 2) \u2500\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\nexport const BILL_RUN_MODES = ['real', 'test', 'dry'] as const\nexport type BillRunMode = (typeof BILL_RUN_MODES)[number]\n\nexport const billingRunTriggerSchema = scopedSchema.extend({\n  // `triggeredBy` is filled in by the route layer (always 'manual' for\n  // API triggers; the cron worker sets 'schedule'). The client cannot\n  // forge a 'schedule' trigger \u2014 the field is intentionally omitted\n  // from the input shape.\n  mode: z.enum(BILL_RUN_MODES).default('real'),\n  asOfDate: z.coerce.date().optional(),\n  scopedAccountIds: z.array(z.string().uuid()).optional(),\n  catchUp: z.boolean().optional(),\n})\n\nexport type BillingRunTriggerInput = z.infer<typeof billingRunTriggerSchema>\n\nexport const billingRunRetryFailedSchema = scopedSchema.extend({\n  billRunId: z.string().uuid(),\n  mode: z.enum(BILL_RUN_MODES).default('real'),\n})\n\nexport type BillingRunRetryFailedInput = z.infer<typeof billingRunRetryFailedSchema>\n\nexport const billingRunListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    search: z.string().optional(),\n    status: z.enum(BILL_RUN_STATUSES).optional(),\n    triggeredBy: z.enum(BILL_RUN_TRIGGERS).optional(),\n    parentRunId: z.string().uuid().optional(),\n    asOfDateFrom: z.coerce.date().optional(),\n    asOfDateTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingRunListQuery = z.infer<typeof billingRunListQuerySchema>\n\n// \u2500\u2500\u2500 Invoice post (Phase 4) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingInvoicePostSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n})\n\nexport type BillingInvoicePostInput = z.infer<typeof billingInvoicePostSchema>\n\n// \u2500\u2500\u2500 Draft invoice edits (Phase 4b) \u2500\u2500\u2500\u2500\u2500\u2500\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/**\n * Fields the operator may change on a draft invoice line. Per spec:\n * \"operator CAN: add lines, remove lines, edit line description /\n * quantity / unit_price / amount\". `taxRate` is owned by core/sales\n * tax service and `currencyCode` is frozen at account create \u2014 both\n * intentionally absent from this schema.\n */\nconst lineEditableFields = z.object({\n  description: z.string().trim().min(1).max(500).optional(),\n  quantity: z.coerce.number().finite().nonnegative().optional(),\n  unitPriceNet: z.coerce.number().finite().optional(),\n  // `totalNetAmount` is operator-overridable for the \"I know better\n  // than `unit_price \u00D7 quantity`\" cases (rare; mostly for negative\n  // credits or rounding fix-ups). When provided, it short-circuits\n  // the auto-compute path.\n  totalNetAmount: z.coerce.number().finite().optional(),\n})\n\nexport const billingInvoiceEditLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n  changes: lineEditableFields,\n})\n\nexport type BillingInvoiceEditLineInput = z.infer<typeof billingInvoiceEditLineSchema>\n\nexport const billingInvoiceAddLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  description: z.string().trim().min(1).max(500),\n  quantity: z.coerce.number().finite().nonnegative(),\n  unitPriceNet: z.coerce.number().finite(),\n  // Optional metadata for traceability \u2014 typically operators leave\n  // `billing_item_id` blank because ad-hoc lines aren't tied to a\n  // Billing Item.\n  billingItemId: z.string().uuid().optional(),\n  billingType: z.enum(BILLING_ITEM_TYPES).optional(),\n})\n\nexport type BillingInvoiceAddLineInput = z.infer<typeof billingInvoiceAddLineSchema>\n\nexport const billingInvoiceRemoveLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n})\n\nexport type BillingInvoiceRemoveLineInput = z.infer<typeof billingInvoiceRemoveLineSchema>\n\n// \u2500\u2500\u2500 Test-invoices wipe (Phase 4b) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingWipeTestInvoicesSchema = scopedSchema.extend({\n  /** Optional \u2014 when set, wipes only test invoices from this run. */\n  billRunId: z.string().uuid().optional(),\n})\n\nexport type BillingWipeTestInvoicesInput = z.infer<typeof billingWipeTestInvoicesSchema>\n\n\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { z } from 'zod'\n\n// \u2500\u2500\u2500 Enums \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const BILLING_ITEM_TYPES = ['one_time', 'recurring', 'usage'] as const\nexport type BillingItemType = (typeof BILLING_ITEM_TYPES)[number]\n\nexport const BILL_CYCLES = ['weekly', 'monthly', 'quarterly', 'annually'] as const\nexport type BillCycle = (typeof BILL_CYCLES)[number]\n\nexport const BILL_RUN_TRIGGERS = ['schedule', 'manual'] as const\nexport type BillRunTrigger = (typeof BILL_RUN_TRIGGERS)[number]\n\nexport const BILL_RUN_STATUSES = ['running', 'completed', 'partial_failure', 'failed'] as const\nexport type BillRunStatus = (typeof BILL_RUN_STATUSES)[number]\n\nexport const BILL_RUN_OUTCOME_STATUSES = [\n  'success',\n  'success_with_warnings',\n  'skipped_existing_draft',\n  // SPEC-002: prepaid period close was skipped because a statement already\n  // exists for the window.\n  'skipped_existing_statement',\n  'failed',\n] as const\nexport type BillRunOutcomeStatus = (typeof BILL_RUN_OUTCOME_STATUSES)[number]\n\nexport const DRAFT_INVOICE_EDIT_ACTIONS = ['line_added', 'line_removed', 'line_edited'] as const\nexport type DraftInvoiceEditAction = (typeof DRAFT_INVOICE_EDIT_ACTIONS)[number]\n\nexport const INVOICE_STATUSES = ['draft', 'posted', 'paid', 'void'] as const\nexport type InvoiceStatus = (typeof INVOICE_STATUSES)[number]\n\n// \u2500\u2500\u2500 Prepaid (SPEC-002) enums \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const BILLING_MODES = ['postpaid', 'prepaid'] as const\nexport type BillingMode = (typeof BILLING_MODES)[number]\n\nexport const TRANSACTION_TYPES = [\n  'topup',\n  'usage',\n  'recurring',\n  'one_time',\n  'adjustment',\n  'reversal',\n] as const\nexport type TransactionType = (typeof TRANSACTION_TYPES)[number]\n\nexport const TOPUP_STATUSES = [\n  'pending',\n  'captured',\n  'failed',\n  'expired',\n  'cancelled',\n] as const\nexport type TopupStatus = (typeof TOPUP_STATUSES)[number]\n\nexport const STATEMENT_STATUSES = ['generated', 'sent'] as const\nexport type StatementStatus = (typeof STATEMENT_STATUSES)[number]\n\n// Prepaid funds status (the account's own money).\nexport const BALANCE_STATUSES = ['ok', 'low', 'exhausted'] as const\nexport type BalanceStatus = (typeof BALANCE_STATUSES)[number]\n\n// Credit-line status (extended overdraft / AR exposure \u2014 both modes).\nexport const CREDIT_STATUSES = ['within_limit', 'near_limit', 'over_limit'] as const\nexport type CreditStatus = (typeof CREDIT_STATUSES)[number]\n\n// `mon`\u2013`sun` for weekly cycles; 1\u201328 (as text) for the others.\n// Why text for numeric anchors: the column type stays uniform across cycles\n// and we never do arithmetic on the raw value (the engine parses it on use).\nconst WEEKLY_ANCHORS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] as const\n\nexport const billCycleAnchorSchema = z\n  .string()\n  .min(1)\n  .refine(\n    (val) => {\n      if ((WEEKLY_ANCHORS as readonly string[]).includes(val.toLowerCase())) return true\n      const n = Number.parseInt(val, 10)\n      return Number.isInteger(n) && n >= 1 && n <= 28\n    },\n    {\n      message:\n        'bill_cycle_anchor must be 1\u201328 (monthly/quarterly/annually) or mon\u2013sun (weekly)',\n    },\n  )\n\n// \u2500\u2500\u2500 rate_json \u2014 pricing definitions \u2500\u2500\u2500\u2500\u2500\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// Validated at API ingress so the engine can trust the shape downstream.\n// Negative amounts are intentionally allowed only on `one_time` (refunds /\n// credits / proration credits). Recurring and usage unit prices MUST be\n// non-negative \u2014 discounts on those are modeled as separate `one_time`\n// credit items.\n\nconst numericNonNegative = z.number().finite().nonnegative()\nconst numericAny = z.number().finite()\n\nexport const rateJsonOneTime = z\n  .object({ amount: numericAny })\n  .strict()\n\nexport const rateJsonRecurring = z\n  .object({ unit_price: numericNonNegative })\n  .strict()\n\nexport const rateJsonUsageSimple = z\n  .object({ unit_price: numericNonNegative })\n  .strict()\n\nconst tierWithUnitPrice = z\n  .object({\n    up_to: z.union([z.number().int().positive(), z.null()]),\n    unit_price: numericNonNegative,\n  })\n  .strict()\n\nconst tierWithFlatAmount = z\n  .object({\n    up_to: z.union([z.number().int().positive(), z.null()]),\n    flat_amount: numericNonNegative,\n  })\n  .strict()\n\n// All tiers must use the same key shape (consistent with the model). Mixing\n// `unit_price` and `flat_amount` across tiers is rejected \u2014 see spec\n// validation rules.\nconst tiersUnitPrice = z\n  .array(tierWithUnitPrice)\n  .min(1, 'tiers must be a non-empty array')\nconst tiersFlatAmount = z\n  .array(tierWithFlatAmount)\n  .min(1, 'tiers must be a non-empty array')\n\nfunction refineTierProgression<T extends { up_to: number | null }>(\n  tiers: T[],\n  ctx: z.RefinementCtx,\n): void {\n  const openTopCount = tiers.filter((t) => t.up_to === null).length\n  if (openTopCount !== 1) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: 'tiers must contain exactly one open-ended top tier (up_to: null)',\n    })\n    return\n  }\n  if (tiers[tiers.length - 1].up_to !== null) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: 'the open-ended top tier (up_to: null) must be the last entry',\n    })\n    return\n  }\n  for (let i = 1; i < tiers.length - 1; i++) {\n    const prev = tiers[i - 1].up_to\n    const curr = tiers[i].up_to\n    if (prev !== null && curr !== null && curr <= prev) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: `up_to values must be strictly increasing across tiers (failed at index ${i})`,\n      })\n      return\n    }\n  }\n}\n\nexport const rateJsonUsageVolume = z\n  .object({\n    model: z.literal('volume'),\n    tiers: tiersUnitPrice,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageGraduated = z\n  .object({\n    model: z.literal('graduated'),\n    tiers: tiersUnitPrice,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageFlat = z\n  .object({\n    model: z.literal('flat'),\n    tiers: tiersFlatAmount,\n  })\n  .strict()\n  .superRefine((val, ctx) => refineTierProgression(val.tiers, ctx))\n\nexport const rateJsonUsageTiered = z.discriminatedUnion('model', [\n  rateJsonUsageVolume,\n  rateJsonUsageGraduated,\n  rateJsonUsageFlat,\n])\n\nexport const rateJsonUsage = z.union([rateJsonUsageSimple, rateJsonUsageTiered])\n\n/**\n * Validate a `rate_json` payload against the rules for a given Billing Item\n * `type`. Returns the parsed value or throws a `ZodError` whose message\n * surfaces the specific shape violation.\n */\nexport function validateRateJson(\n  type: BillingItemType,\n  rateJson: unknown,\n):\n  | z.infer<typeof rateJsonOneTime>\n  | z.infer<typeof rateJsonRecurring>\n  | z.infer<typeof rateJsonUsage> {\n  switch (type) {\n    case 'one_time':\n      return rateJsonOneTime.parse(rateJson)\n    case 'recurring':\n      return rateJsonRecurring.parse(rateJson)\n    case 'usage':\n      return rateJsonUsage.parse(rateJson)\n  }\n}\n\n// \u2500\u2500\u2500 Invoice address (BillingAccount.invoice_address) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const invoiceAddressSchema = z\n  .object({\n    line1: z.string().min(1),\n    line2: z.string().optional(),\n    city: z.string().min(1),\n    postal_code: z.string().min(1),\n    country: z.string().min(2).max(3), // ISO 3166-1 alpha-2 or alpha-3\n  })\n  .strict()\n\nexport type InvoiceAddress = z.infer<typeof invoiceAddressSchema>\n\n// \u2500\u2500\u2500 Scope (injected by withScopedPayload at API ingress) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst scopedSchema = z.object({\n  tenantId: z.string().uuid(),\n  organizationId: z.string().uuid(),\n})\n\n// \u2500\u2500\u2500 List pagination (shared shape) \u2500\u2500\u2500\u2500\u2500\u2500\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\nconst listPaginationBase = {\n  page: z.coerce.number().int().min(1).default(1),\n  pageSize: z.coerce.number().int().min(1).max(100).default(50),\n  sortField: z.string().optional(),\n  sortDir: z.enum(['asc', 'desc']).optional(),\n}\n\n// \u2500\u2500\u2500 BillingAccount payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// numeric(18,4) money inputs arrive as numbers; the command coerces to a\n// 4dp string at persist time.\nconst moneyNonNegative = z.number().finite().nonnegative()\n\nexport const billingAccountCreateSchema = scopedSchema.extend({\n  customerId: z.string().min(1).max(255),\n  name: z.string().trim().min(1).max(255),\n  currencyCode: z.string().trim().toUpperCase().length(3),\n  billCycle: z.enum(BILL_CYCLES),\n  billCycleAnchor: billCycleAnchorSchema,\n  invoiceEmail: z.string().trim().email().max(320),\n  invoiceLanguage: z.string().trim().toLowerCase().min(2).max(5),\n  // Nullable + optional \u2014 consistent with the update schema, and the\n  // cpq-billing-connector's shell-account seed sends `taxId: null`\n  // for customers with no tax id.\n  taxId: z.string().trim().max(64).nullable().optional(),\n  invoiceAddress: invoiceAddressSchema,\n  nextBillDate: z.coerce.date(),\n  lastBillDate: z.coerce.date().optional(),\n  isActive: z.boolean().optional(),\n  // SPEC-002: mode is immutable after create (like currencyCode). Default\n  // 'postpaid' so existing callers are unaffected.\n  billingMode: z.enum(BILLING_MODES).optional(),\n  // Credit line (both modes). 0 = no credit.\n  creditLimit: moneyNonNegative.optional(),\n  // Initial low-balance threshold for a prepaid account's balance row.\n  // Null = resolve the tenant config default at read time.\n  lowBalanceThreshold: moneyNonNegative.nullable().optional(),\n})\n\nexport type BillingAccountCreateInput = z.infer<typeof billingAccountCreateSchema>\n\nexport const billingAccountUpdateSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n  name: z.string().trim().min(1).max(255).optional(),\n  billCycle: z.enum(BILL_CYCLES).optional(),\n  billCycleAnchor: billCycleAnchorSchema.optional(),\n  invoiceEmail: z.string().trim().email().max(320).optional(),\n  invoiceLanguage: z.string().trim().toLowerCase().min(2).max(5).optional(),\n  taxId: z.string().trim().max(64).nullable().optional(),\n  invoiceAddress: invoiceAddressSchema.optional(),\n  nextBillDate: z.coerce.date().optional(),\n  lastBillDate: z.coerce.date().nullable().optional(),\n  isActive: z.boolean().optional(),\n  // SPEC-002: credit_limit is editable (it's an AR/overdraft policy knob);\n  // `billingMode` is intentionally NOT updatable \u2014 mode is frozen at create\n  // (like currencyCode), no live postpaid\u2194prepaid switch in v1.\n  creditLimit: moneyNonNegative.optional(),\n  // Editing the prepaid balance row's low-balance threshold. Null clears it\n  // back to the tenant config default.\n  lowBalanceThreshold: moneyNonNegative.nullable().optional(),\n  // `currencyCode` is intentionally NOT updatable \u2014 currency is frozen at\n  // account create time so historical invoices keep their currency context.\n  // `customerId` is also immutable; create a new account if the customer\n  // FK changes.\n})\n\nexport type BillingAccountUpdateInput = z.infer<typeof billingAccountUpdateSchema>\n\nexport const billingAccountDeleteSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n})\n\nexport type BillingAccountDeleteInput = z.infer<typeof billingAccountDeleteSchema>\n\nexport const billingAccountListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    customerId: z.string().optional(),\n    currencyCode: z.string().optional(),\n    billCycle: z.enum(BILL_CYCLES).optional(),\n    billingMode: z.enum(BILLING_MODES).optional(),\n    isActive: z.coerce.boolean().optional(),\n    search: z.string().optional(),\n  })\n  .passthrough()\n\nexport type BillingAccountListQuery = z.infer<typeof billingAccountListQuerySchema>\n\n// \u2500\u2500\u2500 BillingItem payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nconst ratePayloadByType = z\n  .object({\n    type: z.enum(BILLING_ITEM_TYPES),\n    rateJson: z.unknown(),\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['rateJson'],\n        message: err instanceof Error ? err.message : 'rate_json is invalid for this type',\n      })\n    }\n  })\n\nexport const billingItemCreateSchema = scopedSchema\n  .extend({\n    billAccountId: z.string().uuid(),\n    type: z.enum(BILLING_ITEM_TYPES),\n    billStartDate: z.coerce.date(),\n    billEndDate: z.coerce.date().nullable().optional(),\n    description: z.string().trim().min(1).max(500),\n    rateJson: z.unknown(), // shape validated via the refine below\n    uomCode: z.string().trim().max(64).optional(),\n    subscriptionId: z.string().trim().max(255).optional(),\n    subscriptionItemId: z.string().trim().max(255).optional(),\n    // `source_ref` is the idempotency key. NULL \u2192 no dedup, always create.\n    sourceRef: z.string().trim().min(1).max(255).optional(),\n    // currency_mismatch and billed_to_date are system-managed, never set by\n    // clients on create.\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      const message = err instanceof Error ? err.message : 'rate_json is invalid for this type'\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['rateJson'], message })\n    }\n    if (val.type === 'usage' && !val.uomCode) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['uomCode'],\n        message: 'uomCode is required for type=usage',\n      })\n    }\n  })\n\nexport type BillingItemCreateInput = z.infer<typeof billingItemCreateSchema>\n\n// \u2500\u2500\u2500 Bulk item create (Phase 4g) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// One scope envelope, N item payloads. The CPQ connector activating\n// a large subscription used to fire one `billing.items.create` per\n// charge \u2014 bulk-create collapses that into a single command with a\n// batched `source_ref` idempotency check + single flush.\n\nconst billingItemBulkEntrySchema = z\n  .object({\n    billAccountId: z.string().uuid(),\n    type: z.enum(BILLING_ITEM_TYPES),\n    billStartDate: z.coerce.date(),\n    billEndDate: z.coerce.date().nullable().optional(),\n    description: z.string().trim().min(1).max(500),\n    rateJson: z.unknown(),\n    uomCode: z.string().trim().max(64).optional(),\n    subscriptionId: z.string().trim().max(255).optional(),\n    subscriptionItemId: z.string().trim().max(255).optional(),\n    sourceRef: z.string().trim().min(1).max(255).optional(),\n  })\n  .superRefine((val, ctx) => {\n    try {\n      validateRateJson(val.type, val.rateJson)\n    } catch (err) {\n      const message = err instanceof Error ? err.message : 'rate_json is invalid for this type'\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['rateJson'], message })\n    }\n    if (val.type === 'usage' && !val.uomCode) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['uomCode'],\n        message: 'uomCode is required for type=usage',\n      })\n    }\n  })\n\nexport type BillingItemBulkEntry = z.infer<typeof billingItemBulkEntrySchema>\n\nexport const billingItemBulkCreateSchema = scopedSchema.extend({\n  // Cap at 500 per call \u2014 keeps a single bulk transaction bounded.\n  // A CPQ subscription with >500 charges should be split by the\n  // caller (the connector); 500 is already far past any realistic\n  // single-subscription charge count.\n  items: z.array(billingItemBulkEntrySchema).min(1).max(500),\n})\n\nexport type BillingItemBulkCreateInput = z.infer<typeof billingItemBulkCreateSchema>\n\nexport const billingItemUpdateSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n  // `type` is immutable \u2014 changing one_time \u2192 recurring would silently\n  // change billing semantics. Cancel the old item, create a new one.\n  billStartDate: z.coerce.date().optional(),\n  billEndDate: z.coerce.date().nullable().optional(),\n  description: z.string().trim().min(1).max(500).optional(),\n  rateJson: z.unknown().optional(),\n  uomCode: z.string().trim().max(64).nullable().optional(),\n  subscriptionId: z.string().trim().max(255).nullable().optional(),\n  subscriptionItemId: z.string().trim().max(255).nullable().optional(),\n  // `source_ref` immutable \u2014 it's the idempotency identity of the item.\n  isActive: z.boolean().optional(),\n})\n\nexport type BillingItemUpdateInput = z.infer<typeof billingItemUpdateSchema>\n\nexport const billingItemDeleteSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n})\n\nexport type BillingItemDeleteInput = z.infer<typeof billingItemDeleteSchema>\n\nexport const billingItemListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    search: z.string().optional(),\n    billAccountId: z.string().uuid().optional(),\n    type: z.enum(BILLING_ITEM_TYPES).optional(),\n    subscriptionId: z.string().optional(),\n    isActive: z.coerce.boolean().optional(),\n    activeAt: z.coerce.date().optional(), // bill_start_date <= X AND (bill_end_date IS NULL OR bill_end_date >= X)\n  })\n  .passthrough()\n\nexport type BillingItemListQuery = z.infer<typeof billingItemListQuerySchema>\n\n// \u2500\u2500\u2500 BillingAccountUsage payloads \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingUsageCreateSchema = scopedSchema.extend({\n  billAccountId: z.string().uuid(),\n  uomCode: z.string().trim().min(1).max(64),\n  // `quantity` arrives as a number from JSON; MikroORM stores it as\n  // numeric(18,4). The service coerces to a string at persist time.\n  quantity: z.number().finite().nonnegative(),\n  periodStart: z.coerce.date(),\n  periodEnd: z.coerce.date(),\n  lineDescription: z.string().trim().min(1).max(500).optional(),\n  sourceRef: z.string().trim().min(1).max(255).optional(),\n}).superRefine((val, ctx) => {\n  if (val.periodEnd < val.periodStart) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['periodEnd'],\n      message: 'periodEnd must be on or after periodStart',\n    })\n  }\n})\n\nexport type BillingUsageCreateInput = z.infer<typeof billingUsageCreateSchema>\n\nexport const billingUsageListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    billAccountId: z.string().uuid().optional(),\n    uomCode: z.string().optional(),\n    rated: z.coerce.boolean().optional(), // true \u2192 already rated; false \u2192 unrated\n    periodEndFrom: z.coerce.date().optional(),\n    periodEndTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingUsageListQuery = z.infer<typeof billingUsageListQuerySchema>\n\n// Suppress unused-export TS warning \u2014 `ratePayloadByType` is reserved for\n// reuse by a future per-tenant rate-validation CLI tool.\nvoid ratePayloadByType\n\n// \u2500\u2500\u2500 Bill Run trigger payloads (Phase 2) \u2500\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\nexport const BILL_RUN_MODES = ['real', 'test', 'dry'] as const\nexport type BillRunMode = (typeof BILL_RUN_MODES)[number]\n\nexport const billingRunTriggerSchema = scopedSchema.extend({\n  // `triggeredBy` is filled in by the route layer (always 'manual' for\n  // API triggers; the cron worker sets 'schedule'). The client cannot\n  // forge a 'schedule' trigger \u2014 the field is intentionally omitted\n  // from the input shape.\n  mode: z.enum(BILL_RUN_MODES).default('real'),\n  asOfDate: z.coerce.date().optional(),\n  scopedAccountIds: z.array(z.string().uuid()).optional(),\n  catchUp: z.boolean().optional(),\n})\n\nexport type BillingRunTriggerInput = z.infer<typeof billingRunTriggerSchema>\n\nexport const billingRunRetryFailedSchema = scopedSchema.extend({\n  billRunId: z.string().uuid(),\n  mode: z.enum(BILL_RUN_MODES).default('real'),\n})\n\nexport type BillingRunRetryFailedInput = z.infer<typeof billingRunRetryFailedSchema>\n\nexport const billingRunListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    search: z.string().optional(),\n    status: z.enum(BILL_RUN_STATUSES).optional(),\n    triggeredBy: z.enum(BILL_RUN_TRIGGERS).optional(),\n    parentRunId: z.string().uuid().optional(),\n    asOfDateFrom: z.coerce.date().optional(),\n    asOfDateTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingRunListQuery = z.infer<typeof billingRunListQuerySchema>\n\n// \u2500\u2500\u2500 Invoice post (Phase 4) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingInvoicePostSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n})\n\nexport type BillingInvoicePostInput = z.infer<typeof billingInvoicePostSchema>\n\n// \u2500\u2500\u2500 Draft invoice edits (Phase 4b) \u2500\u2500\u2500\u2500\u2500\u2500\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/**\n * Fields the operator may change on a draft invoice line. Per spec:\n * \"operator CAN: add lines, remove lines, edit line description /\n * quantity / unit_price / amount\". `taxRate` is owned by core/sales\n * tax service and `currencyCode` is frozen at account create \u2014 both\n * intentionally absent from this schema.\n */\nconst lineEditableFields = z.object({\n  description: z.string().trim().min(1).max(500).optional(),\n  quantity: z.coerce.number().finite().nonnegative().optional(),\n  unitPriceNet: z.coerce.number().finite().optional(),\n  // `totalNetAmount` is operator-overridable for the \"I know better\n  // than `unit_price \u00D7 quantity`\" cases (rare; mostly for negative\n  // credits or rounding fix-ups). When provided, it short-circuits\n  // the auto-compute path.\n  totalNetAmount: z.coerce.number().finite().optional(),\n})\n\nexport const billingInvoiceEditLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n  changes: lineEditableFields,\n})\n\nexport type BillingInvoiceEditLineInput = z.infer<typeof billingInvoiceEditLineSchema>\n\nexport const billingInvoiceAddLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  description: z.string().trim().min(1).max(500),\n  quantity: z.coerce.number().finite().nonnegative(),\n  unitPriceNet: z.coerce.number().finite(),\n  // Optional metadata for traceability \u2014 typically operators leave\n  // `billing_item_id` blank because ad-hoc lines aren't tied to a\n  // Billing Item.\n  billingItemId: z.string().uuid().optional(),\n  billingType: z.enum(BILLING_ITEM_TYPES).optional(),\n})\n\nexport type BillingInvoiceAddLineInput = z.infer<typeof billingInvoiceAddLineSchema>\n\nexport const billingInvoiceRemoveLineSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n})\n\nexport type BillingInvoiceRemoveLineInput = z.infer<typeof billingInvoiceRemoveLineSchema>\n\n// \u2500\u2500\u2500 Test-invoices wipe (Phase 4b) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingWipeTestInvoicesSchema = scopedSchema.extend({\n  /** Optional \u2014 when set, wipes only test invoices from this run. */\n  billRunId: z.string().uuid().optional(),\n})\n\nexport type BillingWipeTestInvoicesInput = z.infer<typeof billingWipeTestInvoicesSchema>\n\n// \u2500\u2500\u2500 Prepaid: top-ups (SPEC-002 P2) \u2500\u2500\u2500\u2500\u2500\u2500\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\nexport const billingTopupCreateSchema = scopedSchema.extend({\n  // The route maps the `/accounts/{id}/topups` path param into billAccountId.\n  billAccountId: z.string().uuid(),\n  amount: z.number().finite().positive(),\n  // Optional \u2014 defaults to the tenant config `prepaid.topup_provider`.\n  providerKey: z.string().trim().min(1).max(64).optional(),\n  successUrl: z.string().trim().url().max(2048).optional(),\n  cancelUrl: z.string().trim().url().max(2048).optional(),\n  // Optional idempotency for the initiating request.\n  sourceRef: z.string().trim().min(1).max(255).optional(),\n})\n\nexport type BillingTopupCreateInput = z.infer<typeof billingTopupCreateSchema>\n\nexport const billingTopupListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    status: z.enum(TOPUP_STATUSES).optional(),\n    search: z.string().optional(),\n  })\n  .passthrough()\n\nexport type BillingTopupListQuery = z.infer<typeof billingTopupListQuerySchema>\n\n// \u2500\u2500\u2500 Prepaid: transactions / manual adjustments (SPEC-002 P1/P5) \u2500\u2500\n\nexport const billingTransactionAdjustSchema = scopedSchema\n  .extend({\n    billAccountId: z.string().uuid(),\n    // SIGNED: > 0 credit, < 0 debit. Zero is rejected.\n    amount: z.number().finite(),\n    description: z.string().trim().min(1).max(500),\n    sourceRef: z.string().trim().min(1).max(255).optional(),\n  })\n  .superRefine((val, ctx) => {\n    if (val.amount === 0) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['amount'],\n        message: 'amount must be non-zero (positive credit or negative debit)',\n      })\n    }\n  })\n\nexport type BillingTransactionAdjustInput = z.infer<typeof billingTransactionAdjustSchema>\n\nexport const billingTransactionListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    type: z.enum(TRANSACTION_TYPES).optional(),\n    createdFrom: z.coerce.date().optional(),\n    createdTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingTransactionListQuery = z.infer<typeof billingTransactionListQuerySchema>\n\n// \u2500\u2500\u2500 Prepaid: statements (SPEC-002 P3) \u2500\u2500\u2500\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\nexport const billingStatementGenerateSchema = scopedSchema.extend({\n  billAccountId: z.string().uuid(),\n  // \"today\" the close evaluates the due period against. Defaults to now.\n  asOfDate: z.coerce.date().optional(),\n})\n\nexport type BillingStatementGenerateInput = z.infer<typeof billingStatementGenerateSchema>\n\nexport const billingStatementListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    status: z.enum(STATEMENT_STATUSES).optional(),\n    periodEndFrom: z.coerce.date().optional(),\n    periodEndTo: z.coerce.date().optional(),\n  })\n  .passthrough()\n\nexport type BillingStatementListQuery = z.infer<typeof billingStatementListQuerySchema>\n\n\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/events.js

@@ -19,6 +19,58 @@ const events = [
     entity: "bill_run",
     category: "lifecycle",
     clientBroadcast: true
+  },
+  // ─── Prepaid balance billing (SPEC-002) ──────────────────────
+  {
+    id: "billing.balance.topped_up",
+    label: "Balance Topped Up",
+    entity: "balance",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    id: "billing.balance.low",
+    label: "Balance Low",
+    entity: "balance",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    id: "billing.balance.exhausted",
+    label: "Balance Exhausted",
+    entity: "balance",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    // Per-debit signal — useful for a live balance UI but potentially
+    // high-volume, so excluded from workflow triggers (see Open Question #2).
+    id: "billing.usage.rated",
+    label: "Usage Rated",
+    entity: "transaction",
+    category: "lifecycle",
+    excludeFromTriggers: true
+  },
+  {
+    id: "billing.statement.generated",
+    label: "Consumption Statement Generated",
+    entity: "statement",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    id: "billing.credit.over_limit",
+    label: "Credit Over Limit",
+    entity: "credit",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    id: "billing.credit.near_limit",
+    label: "Credit Near Limit",
+    entity: "credit",
+    category: "lifecycle",
+    clientBroadcast: true
   }
 ];
 const eventsConfig = createModuleEvents({

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/billing/events.ts"],
-  "sourcesContent": ["import { createModuleEvents } from '@open-mercato/shared/modules/events'\n\n/**\n * Billing module events.\n *\n * Emission contract:\n *   - `billing.invoice.posted` fires once per posted draft AFTER the post\n *     transaction commits (sequence number assigned, status set to `posted`\n *     in core/sales). Consumed by mailers / accounting bridges / analytics.\n *   - `billing.invoice.line_posted` fires once per line on a posted invoice\n *     so analytics can aggregate without scanning core/sales lines directly.\n *   - `billing.run.completed` fires once per Bill Run after all per-account\n *     transactions finished (status is one of `completed` / `partial_failure`\n *     / `failed`). Useful for \"did the nightly run go OK?\" alerts.\n */\nconst events = [\n  {\n    id: 'billing.invoice.posted',\n    label: 'Billing Invoice Posted',\n    entity: 'invoice',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.invoice.line_posted',\n    label: 'Billing Invoice Line Posted',\n    entity: 'invoice_line',\n    category: 'lifecycle',\n  },\n  {\n    id: 'billing.run.completed',\n    label: 'Bill Run Completed',\n    entity: 'bill_run',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n] as const\n\nexport const eventsConfig = createModuleEvents({\n  moduleId: 'billing',\n  events,\n})\n\nexport const emitBillingEvent = eventsConfig.emit\nexport type BillingEventId = (typeof events)[number]['id']\n\nexport default eventsConfig\n"],
-  "mappings": "AAAA,SAAS,0BAA0B;AAenC,MAAM,SAAS;AAAA,EACb;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AACF;AAEO,MAAM,eAAe,mBAAmB;AAAA,EAC7C,UAAU;AAAA,EACV;AACF,CAAC;AAEM,MAAM,mBAAmB,aAAa;AAG7C,IAAO,iBAAQ;",
+  "sourcesContent": ["import { createModuleEvents } from '@open-mercato/shared/modules/events'\n\n/**\n * Billing module events.\n *\n * Emission contract:\n *   - `billing.invoice.posted` fires once per posted draft AFTER the post\n *     transaction commits (sequence number assigned, status set to `posted`\n *     in core/sales). Consumed by mailers / accounting bridges / analytics.\n *   - `billing.invoice.line_posted` fires once per line on a posted invoice\n *     so analytics can aggregate without scanning core/sales lines directly.\n *   - `billing.run.completed` fires once per Bill Run after all per-account\n *     transactions finished (status is one of `completed` / `partial_failure`\n *     / `failed`). Useful for \"did the nightly run go OK?\" alerts.\n */\nconst events = [\n  {\n    id: 'billing.invoice.posted',\n    label: 'Billing Invoice Posted',\n    entity: 'invoice',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.invoice.line_posted',\n    label: 'Billing Invoice Line Posted',\n    entity: 'invoice_line',\n    category: 'lifecycle',\n  },\n  {\n    id: 'billing.run.completed',\n    label: 'Bill Run Completed',\n    entity: 'bill_run',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  // \u2500\u2500\u2500 Prepaid balance billing (SPEC-002) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  {\n    id: 'billing.balance.topped_up',\n    label: 'Balance Topped Up',\n    entity: 'balance',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.balance.low',\n    label: 'Balance Low',\n    entity: 'balance',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.balance.exhausted',\n    label: 'Balance Exhausted',\n    entity: 'balance',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    // Per-debit signal \u2014 useful for a live balance UI but potentially\n    // high-volume, so excluded from workflow triggers (see Open Question #2).\n    id: 'billing.usage.rated',\n    label: 'Usage Rated',\n    entity: 'transaction',\n    category: 'lifecycle',\n    excludeFromTriggers: true,\n  },\n  {\n    id: 'billing.statement.generated',\n    label: 'Consumption Statement Generated',\n    entity: 'statement',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.credit.over_limit',\n    label: 'Credit Over Limit',\n    entity: 'credit',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.credit.near_limit',\n    label: 'Credit Near Limit',\n    entity: 'credit',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n] as const\n\nexport const eventsConfig = createModuleEvents({\n  moduleId: 'billing',\n  events,\n})\n\nexport const emitBillingEvent = eventsConfig.emit\nexport type BillingEventId = (typeof events)[number]['id']\n\nexport default eventsConfig\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AAenC,MAAM,SAAS;AAAA,EACb;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA;AAAA,EAEA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA;AAAA;AAAA,IAGE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,qBAAqB;AAAA,EACvB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,iBAAiB;AAAA,EACnB;AACF;AAEO,MAAM,eAAe,mBAAmB;AAAA,EAC7C,UAAU;AAAA,EACV;AACF,CAAC;AAEM,MAAM,mBAAmB,aAAa;AAG7C,IAAO,iBAAQ;",
   "names": []
 }

package/dist/modules/billing/i18n/en.json

@@ -1,9 +1,11 @@
 {
   "billing.accounts.actions.open": "Open",
+  "billing.accounts.columns.credit_limit": "Credit limit",
   "billing.accounts.columns.currency": "Currency",
   "billing.accounts.columns.customer": "Customer",
   "billing.accounts.columns.cycle": "Cycle",
   "billing.accounts.columns.last_bill": "Last bill",
+  "billing.accounts.columns.mode": "Mode",
   "billing.accounts.columns.name": "Name",
   "billing.accounts.columns.next_bill": "Next bill",
   "billing.accounts.columns.status": "Status",
@@ -62,6 +64,8 @@
   "billing.accounts.form.error.next_bill_date_required": "Next bill date is required",
   "billing.accounts.form.invoice_email": "Invoice email",
   "billing.accounts.form.invoice_language": "Invoice language (ISO 639-1)",
+  "billing.accounts.form.mode.locked": "Immutable — frozen at account create time.",
+  "billing.accounts.form.mode.title": "Billing mode & credit",
   "billing.accounts.form.name": "Name",
   "billing.accounts.form.name.placeholder": "Auto-filled from customer — override e.g. \"Acme — production\"",
   "billing.accounts.form.next_bill_date": "Next bill date",
@@ -69,6 +73,7 @@
   "billing.accounts.form.saving": "Saving…",
   "billing.accounts.form.submit_hint": "to save,",
   "billing.accounts.form.tax_id": "Tax ID (NIP / VATIN, optional)",
+  "billing.accounts.form.threshold.hint": "Blank = tenant default",
   "billing.accounts.title": "Billing Accounts",
   "billing.common.active": "Active",
   "billing.common.cancel": "Cancel",
@@ -233,6 +238,37 @@
   "billing.items.type.one_time": "One-time",
   "billing.items.type.recurring": "Recurring",
   "billing.items.type.usage": "Usage",
+  "billing.mode.postpaid": "Postpaid",
+  "billing.mode.prepaid": "Prepaid",
+  "billing.prepaid.credit.near_limit": "Near limit",
+  "billing.prepaid.adjust.action": "Adjust",
+  "billing.prepaid.adjust.amount": "Amount (+credit / −debit)",
+  "billing.prepaid.adjust.confirm": "Apply adjustment",
+  "billing.prepaid.adjust.description": "Reason",
+  "billing.prepaid.adjust.error": "Adjustment failed",
+  "billing.prepaid.adjust.invalid_amount": "Enter a non-zero amount",
+  "billing.prepaid.adjust.invalid_description": "Enter a reason",
+  "billing.prepaid.adjust.submitting": "Applying…",
+  "billing.prepaid.adjust.success": "Balance adjusted",
+  "billing.prepaid.credit.over_limit": "Over limit",
+  "billing.prepaid.credit.within_limit": "Within limit",
+  "billing.prepaid.panel.balance": "Balance",
+  "billing.prepaid.panel.credit": "Credit",
+  "billing.prepaid.panel.last_movement": "Last movement",
+  "billing.prepaid.panel.no_transactions": "No balance movements yet.",
+  "billing.prepaid.panel.threshold": "Low threshold",
+  "billing.prepaid.panel.title": "Prepaid balance",
+  "billing.prepaid.panel.transactions": "Balance transactions",
+  "billing.prepaid.status.exhausted": "Exhausted",
+  "billing.prepaid.status.low": "Low",
+  "billing.prepaid.status.ok": "OK",
+  "billing.prepaid.topup.action": "Top up",
+  "billing.prepaid.topup.amount": "Amount",
+  "billing.prepaid.topup.confirm": "Start checkout",
+  "billing.prepaid.topup.created": "Top-up session created",
+  "billing.prepaid.topup.error": "Top-up failed",
+  "billing.prepaid.topup.invalid": "Enter a positive amount",
+  "billing.prepaid.topup.submitting": "Starting…",
   "billing.runs.actions.open": "Open",
   "billing.runs.columns.accounts": "Accounts",
   "billing.runs.columns.as_of_date": "As-of date",
@@ -256,6 +292,10 @@
   "billing.runs.detail.title": "Bill Run",
   "billing.runs.filters.status": "Status",
   "billing.runs.filters.triggered_by": "Trigger",
+  "billing.runs.mode.catch_up": "Catch-up",
+  "billing.runs.mode.dry_run": "Dry-run",
+  "billing.runs.mode.real": "Real",
+  "billing.runs.mode.test": "Test",
   "billing.runs.outcomes.columns.account": "Account",
   "billing.runs.outcomes.columns.error": "Error",
   "billing.runs.outcomes.columns.invoice": "Invoice",
@@ -277,10 +317,6 @@
   "billing.runs.summary.title": "Summary",
   "billing.runs.summary.usage": "Usage rated",
   "billing.runs.summary.warnings": "Warnings",
-  "billing.runs.mode.catch_up": "Catch-up",
-  "billing.runs.mode.dry_run": "Dry-run",
-  "billing.runs.mode.real": "Real",
-  "billing.runs.mode.test": "Test",
   "billing.runs.title": "Bill Runs",
   "billing.runs.trigger.action": "New run",
   "billing.runs.trigger.dialog.as_of_date": "As-of date",
@@ -299,6 +335,78 @@
   "billing.runs.trigger.manual": "Manual",
   "billing.runs.trigger.schedule": "Schedule",
   "billing.runs.trigger.success": "Bill Run triggered",
+  "billing.statements.breakdown.amount": "Amount",
+  "billing.statements.breakdown.item": "Item",
+  "billing.statements.breakdown.quantity": "Qty",
+  "billing.statements.breakdown.type": "Type",
+  "billing.statements.columns.adjustments": "Adjustments",
+  "billing.statements.columns.closing": "Closing",
+  "billing.statements.columns.opening": "Opening",
+  "billing.statements.columns.period": "Period",
+  "billing.statements.columns.recurring": "Recurring",
+  "billing.statements.columns.status": "Status",
+  "billing.statements.columns.account": "Account",
+  "billing.statements.columns.topups": "Top-ups",
+  "billing.statements.columns.usage": "Usage",
+  "billing.statements.detail.bill_run": "Bill Run",
+  "billing.statements.detail.breakdown": "Period-close charges",
+  "billing.statements.detail.load_error": "Failed to load statement",
+  "billing.statements.detail.loading": "Loading statement…",
+  "billing.statements.detail.no_charges": "No recurring charges this period.",
+  "billing.statements.detail.not_found": "Statement not found",
+  "billing.statements.detail.title": "Statement",
+  "billing.statements.detail.view_account": "View account",
+  "billing.statements.filters.status": "Status",
+  "billing.statements.status.generated": "Generated",
+  "billing.statements.status.sent": "Sent",
+  "billing.statements.title": "Statements",
+  "billing.topups.columns.account": "Account",
+  "billing.topups.columns.amount": "Amount",
+  "billing.topups.columns.created": "Created",
+  "billing.topups.columns.provider": "Provider",
+  "billing.topups.columns.status": "Status",
+  "billing.topups.detail.balance_txn": "Balance transaction",
+  "billing.topups.detail.gateway_txn": "Gateway transaction",
+  "billing.topups.detail.load_error": "Failed to load top-up",
+  "billing.topups.detail.loading": "Loading top-up…",
+  "billing.topups.detail.not_found": "Top-up not found",
+  "billing.topups.detail.payment_id": "Payment ID",
+  "billing.topups.detail.receipt": "VAT receipt",
+  "billing.topups.detail.title": "Top-up",
+  "billing.topups.detail.updated": "Updated",
+  "billing.topups.detail.view_account": "View account",
+  "billing.topups.filters.status": "Status",
+  "billing.topups.status.cancelled": "Cancelled",
+  "billing.topups.status.captured": "Captured",
+  "billing.topups.status.expired": "Expired",
+  "billing.topups.status.failed": "Failed",
+  "billing.topups.status.pending": "Pending",
+  "billing.topups.title": "Top-ups",
+  "billing.transactions.columns.amount": "Amount",
+  "billing.transactions.columns.balance_after": "Balance",
+  "billing.transactions.columns.description": "Description",
+  "billing.transactions.columns.type": "Type",
+  "billing.transactions.columns.when": "When",
+  "billing.transactions.type.adjustment": "Adjustment",
+  "billing.transactions.type.one_time": "One-time",
+  "billing.transactions.type.recurring": "Recurring",
+  "billing.transactions.type.reversal": "Reversal",
+  "billing.transactions.type.topup": "Top-up",
+  "billing.transactions.type.usage": "Usage",
+  "billing.transactions.columns.account": "Account",
+  "billing.transactions.detail.item": "Billing item",
+  "billing.transactions.detail.load_error": "Failed to load transaction",
+  "billing.transactions.detail.loading": "Loading transaction…",
+  "billing.transactions.detail.not_found": "Transaction not found",
+  "billing.transactions.detail.source_ref": "Source ref",
+  "billing.transactions.detail.statement": "Statement",
+  "billing.transactions.detail.title": "Transaction",
+  "billing.transactions.detail.topup": "Top-up",
+  "billing.transactions.detail.usage": "Usage record",
+  "billing.transactions.detail.user": "User",
+  "billing.transactions.detail.view_account": "View account",
+  "billing.transactions.filters.type": "Type",
+  "billing.transactions.title": "Transactions",
   "billing.usage.columns.description": "Description",
   "billing.usage.columns.period": "Period",
   "billing.usage.columns.quantity": "Quantity",