@dainamite/billing 0.20.0 → 0.21.0

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  // 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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",
+  "sourcesContent": ["import { z } from 'zod'\nimport { DEFAULT_INVOICE_LANGUAGE, INVOICE_LANGUAGE_CODES } from '../lib/invoiceLanguages'\nimport { DOCUMENT_SERIES, validateMask } from '../lib/numbering'\nimport { isValidBic, isValidIban, normalizeIban } from '../lib/iban'\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\n// Spec A: when a recurring item is charged relative to the bill date \u2014\n// for the coming period (in advance, default) or the period just ended.\nexport const CHARGE_TIMINGS = ['in_advance', 'in_arrears'] as const\nexport type ChargeTiming = (typeof CHARGE_TIMINGS)[number]\n\n// Spec F (F-D2): the basis the item price was entered on.\nexport const PRICE_BASES = ['net', 'gross'] as const\nexport type PriceBasis = (typeof PRICE_BASES)[number]\n\n// Spec F (F-D3): where prepaid VAT is charged.\nexport const PREPAID_TAX_POINTS = ['topup', 'consumption'] as const\nexport type PrepaidTaxPoint = (typeof PREPAID_TAX_POINTS)[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\n// Spec 0: billing-owned document statuses. No 'void' \u2014 a posted document is\n// only neutralised by a credit memo ('credited'); drafts are deleted.\nexport const INVOICE_STATUSES = ['draft', 'posted', 'partially_paid', 'paid', 'credited'] as const\nexport type InvoiceStatus = (typeof INVOICE_STATUSES)[number]\n\nexport const DOCUMENT_TYPES = ['invoice', 'credit_memo', 'debit_memo', 'receipt'] as const\nexport type DocumentType = (typeof DOCUMENT_TYPES)[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\n// Spec E (B2C): a billing account belongs to a company or a person. Both\n// live in the customers module under one `customer_entities` id space, so\n// `customer_id` is kind-agnostic \u2014 `customer_kind` only drives the lookup\n// and the label.\nexport const CUSTOMER_KINDS = ['company', 'person'] as const\nexport type CustomerKind = (typeof CUSTOMER_KINDS)[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\n// Invoice language must be one the document template supports (Spec E, D22).\n// Case/whitespace-tolerant on input, canonical lowercase code on output.\n// Spec B: payment terms in days (0 = due on issue).\nconst paymentTermsDaysSchema = z.coerce.number().int().min(0).max(365)\n\nconst invoiceLanguageSchema = z.string().trim().toLowerCase().pipe(z.enum(INVOICE_LANGUAGE_CODES))\n\nexport const billingAccountCreateSchema = scopedSchema.extend({\n  customerId: z.string().min(1).max(255),\n  // Immutable after create (like customerId). Default 'company' keeps\n  // existing callers (CPQ connector, seeds) unaffected.\n  customerKind: z.enum(CUSTOMER_KINDS).default('company'),\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: invoiceLanguageSchema.default(DEFAULT_INVOICE_LANGUAGE),\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  // Spec B: null/omitted = the organization default payment terms.\n  paymentTermsDays: paymentTermsDaysSchema.nullable().optional(),\n  autoSendInvoice: 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: invoiceLanguageSchema.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  paymentTermsDays: paymentTermsDaysSchema.nullable().optional(),\n  autoSendInvoice: 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. `customerKind` follows `customerId` and is likewise not\n  // updatable.\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    customerKind: z.enum(CUSTOMER_KINDS).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    // Spec F (F8): only accounts with at least one overdue receivable.\n    hasOverdue: z\n      .union([z.boolean(), z.enum(['true', 'false'])])\n      .transform((value) => value === true || value === 'true')\n      .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\n// Spec A: `chargeTiming` / `prorate` only mean something for recurring\n// items. Omitted \u2192 the command applies the defaults (in_advance, true).\n// Setting a non-default value on another type is a client mistake.\n// Spec B (B-D1): VAT rate in percent. Omitted on create \u2192 the command fills\n// the organization default; never re-filled on update.\nconst taxRateSchema = z.coerce.number().finite().min(0).max(100)\n\nconst chargeTimingFields = {\n  chargeTiming: z.enum(CHARGE_TIMINGS).optional(),\n  prorate: z.boolean().optional(),\n  // Spec F (F-D2). Omitted \u2192 'net' on create; unchanged on update.\n  priceBasis: z.enum(PRICE_BASES).optional(),\n}\n\nexport const GROSS_TIERED_UNSUPPORTED_MESSAGE = 'billing.item.gross_tiered_unsupported'\n\n/** Tiered usage rates (`{ model, tiers }`) are always net (Spec F, P-D4). */\nexport function isTieredRate(rateJson: unknown): boolean {\n  return typeof rateJson === 'object' && rateJson !== null && 'model' in rateJson && 'tiers' in rateJson\n}\n\nfunction refinePriceBasis(val: { priceBasis?: PriceBasis; rateJson: unknown }, ctx: z.RefinementCtx): void {\n  if (val.priceBasis === 'gross' && isTieredRate(val.rateJson)) {\n    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['priceBasis'], message: GROSS_TIERED_UNSUPPORTED_MESSAGE })\n  }\n}\n\nexport const CHARGE_TIMING_RECURRING_ONLY_MESSAGE =\n  'chargeTiming / prorate can only be set on recurring items'\n\nfunction refineChargeTiming(\n  val: { type: BillingItemType; chargeTiming?: ChargeTiming; prorate?: boolean },\n  ctx: z.RefinementCtx,\n): void {\n  if (val.type === 'recurring') return\n  if (val.chargeTiming !== undefined && val.chargeTiming !== 'in_advance') {\n    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['chargeTiming'], message: CHARGE_TIMING_RECURRING_ONLY_MESSAGE })\n  }\n  if (val.prorate === false) {\n    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['prorate'], message: CHARGE_TIMING_RECURRING_ONLY_MESSAGE })\n  }\n}\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    taxRate: taxRateSchema.optional(),\n    ...chargeTimingFields,\n    // currency_mismatch and billed_to_date are system-managed, never set by\n    // clients on create.\n  })\n  .superRefine((val, ctx) => {\n    refineChargeTiming(val, ctx)\n    refinePriceBasis(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    taxRate: taxRateSchema.optional(),\n    ...chargeTimingFields,\n  })\n  .superRefine((val, ctx) => {\n    refineChargeTiming(val, ctx)\n    refinePriceBasis(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  // Affects future invoices only \u2014 posted lines keep their snapshot.\n  taxRate: taxRateSchema.optional(),\n  // Recurring only (enforced by the command, which knows the item type).\n  // Safe to change after billing: the `billed_to_date` watermark prevents\n  // any day from being billed twice.\n  ...chargeTimingFields,\n})\n\nexport type BillingItemUpdateInput = z.infer<typeof billingItemUpdateSchema>\n\n// Change a recurring item's price from a date on: end the item the day\n// before, start a copy with the new price (see lib/itemPriceChange.ts).\nexport const billingItemChangePriceSchema = scopedSchema.extend({\n  id: z.string().uuid(),\n  effectiveDate: z.coerce.date(),\n  unitPrice: z.coerce.number().finite().nonnegative(),\n})\n\nexport type BillingItemChangePriceInput = z.infer<typeof billingItemChangePriceSchema>\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  // Spec A: there is no `catchUp` flag \u2014 every run bills all due cycles up\n  // to `asOfDate`. Old clients still sending it are not rejected: the\n  // object schema strips unknown keys.\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    // Spec F (F1): narrow the list to one run mode.\n    mode: z.enum(['real', 'test', 'dry']).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// Spec B \u2014 email a posted document (manual send / resend).\nexport const billingInvoiceSendSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n})\n\nexport type BillingInvoiceSendInput = z.infer<typeof billingInvoiceSendSchema>\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\". Spec B adds `taxRate` (VAT % of the\n * line). `currencyCode` is frozen at account create and intentionally absent.\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  taxRate: taxRateSchema.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  // Omitted \u2192 the organization default VAT rate.\n  taxRate: taxRateSchema.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// Spec F (F-D1): test and dry runs can be deleted (real runs never).\nexport const billingRunDeleteSchema = scopedSchema.extend({\n  billRunId: z.string().uuid(),\n})\n\nexport type BillingRunDeleteInput = z.infer<typeof billingRunDeleteSchema>\n\n// Post the draft invoices of a REAL run, one bounded batch per call; the\n// caller passes back `nextCursor` until `remaining` is 0.\nexport const billingRunPostDraftsSchema = scopedSchema.extend({\n  billRunId: z.string().uuid(),\n  /** Continue after this invoice id (ids are processed in ascending order). */\n  afterInvoiceId: z.string().uuid().optional(),\n  limit: z.coerce.number().int().min(1).max(100).optional(),\n})\n\nexport type BillingRunPostDraftsInput = z.infer<typeof billingRunPostDraftsSchema>\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\n// \u2500\u2500\u2500 Spec 0 \u2014 invoice ledger + billing settings \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n// Query-string boolean: only the literal strings count (\"false\" must NOT\n// coerce to true the way z.coerce.boolean() would).\nconst queryBoolean = z.preprocess(\n  (value) => (value === 'true' || value === true ? true : value === 'false' || value === false ? false : undefined),\n  z.boolean().optional(),\n)\n\nexport const billingInvoiceListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    status: z.enum(INVOICE_STATUSES).optional(),\n    documentType: z.enum(DOCUMENT_TYPES).optional(),\n    billRunId: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    testRun: queryBoolean,\n    search: z.string().trim().max(100).optional(),\n    // Spec B: computed overdue (B-D6) and due-date window.\n    overdue: queryBoolean,\n    dueFrom: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/).optional(),\n    dueTo: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/).optional(),\n  })\n  .passthrough()\n\nexport type BillingInvoiceListQuery = z.infer<typeof billingInvoiceListQuerySchema>\n\nconst numberMaskSchema = z\n  .string()\n  .trim()\n  .superRefine((mask, ctx) => {\n    for (const code of validateMask(mask)) {\n      ctx.addIssue({ code: z.ZodIssueCode.custom, message: code })\n    }\n  })\n\nconst moneyString = z.coerce.number().finite().nonnegative()\n\n/** Trimmed optional text; '' \u2192 null (clears the field). */\nfunction optionalText(max: number) {\n  return z\n    .string()\n    .trim()\n    .max(max)\n    .transform((value) => (value === '' ? null : value))\n    .nullable()\n    .optional()\n}\n\n// Seller address: same shape (and country rule) as the buyer's invoice address.\nconst sellerAddressSchema = invoiceAddressSchema\n\nexport const billingSettingsUpdateSchema = scopedSchema.extend({\n  lowBalanceThresholdDefault: moneyString.optional(),\n  nearLimitBufferDefault: moneyString.optional(),\n  statementEnabled: z.boolean().optional(),\n  topupTaxRate: z.coerce.number().finite().min(0).max(100).optional(),\n  topupProvider: z.string().trim().min(1).max(64).optional(),\n  numberMasks: z\n    .object(Object.fromEntries(DOCUMENT_SERIES.map((series) => [series, numberMaskSchema.optional()])) as Record<\n      (typeof DOCUMENT_SERIES)[number],\n      z.ZodOptional<typeof numberMaskSchema>\n    >)\n    .strict()\n    .optional(),\n  // Seller / payment / document fields (Spec B). Empty string clears.\n  legalName: optionalText(255),\n  sellerAddress: sellerAddressSchema.nullable().optional(),\n  taxId: optionalText(64),\n  bankName: optionalText(255),\n  iban: z\n    .string()\n    .transform(normalizeIban)\n    .refine((value) => value === '' || isValidIban(value), { message: 'billing.settings.error.iban_invalid' })\n    .transform((value) => (value === '' ? null : value))\n    .nullable()\n    .optional(),\n  bic: z\n    .string()\n    .trim()\n    .toUpperCase()\n    .refine((value) => value === '' || isValidBic(value), { message: 'billing.settings.error.bic_invalid' })\n    .transform((value) => (value === '' ? null : value))\n    .nullable()\n    .optional(),\n  invoiceFooter: optionalText(2000),\n  logoAttachmentId: z.string().uuid().nullable().optional(),\n  defaultPaymentTermsDays: paymentTermsDaysSchema.optional(),\n  defaultTaxRate: taxRateSchema.optional(),\n  // Spec F (F-D3).\n  prepaidTaxPoint: z.enum(PREPAID_TAX_POINTS).optional(),\n})\n\nexport type BillingSettingsUpdateInput = z.infer<typeof billingSettingsUpdateSchema>\n\n// \u2500\u2500\u2500 Spec C \u2014 payments \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 PAYMENT_STATUSES = [\n  'unmatched',\n  'matched',\n  'partially_allocated',\n  'allocated',\n  'ignored',\n  'converted_to_topup',\n] as const\nexport type PaymentStatus = (typeof PAYMENT_STATUSES)[number]\n\nexport const PAYMENT_SOURCES = ['csv', 'manual', 'gateway'] as const\nexport type PaymentSource = (typeof PAYMENT_SOURCES)[number]\n\nexport const PAYMENT_MATCH_REASONS = [\n  'no_reference',\n  'currency_mismatch',\n  'invoice_already_paid',\n  'prepaid_account',\n  'manual',\n] as const\nexport type PaymentMatchReason = (typeof PAYMENT_MATCH_REASONS)[number]\n\nexport const ALLOCATION_SOURCE_TYPES = ['payment', 'credit_memo'] as const\nexport type AllocationSourceType = (typeof ALLOCATION_SOURCE_TYPES)[number]\n\nexport const ALLOCATED_BY = ['auto', 'credit', 'user', 'gateway'] as const\nexport type AllocatedBy = (typeof ALLOCATED_BY)[number]\n\nconst isoDateString = z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/)\nconst positiveMoney = z.coerce.number().finite().positive()\n\nexport const billingPaymentCreateSchema = scopedSchema.extend({\n  receivedAt: isoDateString,\n  amount: positiveMoney,\n  currencyCode: z.string().trim().toUpperCase().length(3),\n  reference: z.string().trim().max(500).optional(),\n  payerName: z.string().trim().max(255).optional(),\n  payerAccount: z.string().trim().max(64).optional(),\n  // Known account \u2192 status `matched` and credit auto-apply; else `unmatched`.\n  billAccountId: z.string().uuid().optional(),\n})\nexport type BillingPaymentCreateInput = z.infer<typeof billingPaymentCreateSchema>\n\nexport const billingPaymentAssignSchema = scopedSchema.extend({\n  paymentId: z.string().uuid(),\n  billAccountId: z.string().uuid(),\n})\nexport type BillingPaymentAssignInput = z.infer<typeof billingPaymentAssignSchema>\n\nexport const billingPaymentAllocateSchema = scopedSchema.extend({\n  paymentId: z.string().uuid(),\n  allocations: z\n    .array(z.object({ invoiceId: z.string().uuid(), amount: positiveMoney }))\n    .min(1)\n    .max(100),\n})\nexport type BillingPaymentAllocateInput = z.infer<typeof billingPaymentAllocateSchema>\n\nexport const billingAllocationRemoveSchema = scopedSchema.extend({\n  allocationId: z.string().uuid(),\n})\nexport type BillingAllocationRemoveInput = z.infer<typeof billingAllocationRemoveSchema>\n\nexport const billingPaymentIdSchema = scopedSchema.extend({\n  paymentId: z.string().uuid(),\n})\nexport type BillingPaymentIdInput = z.infer<typeof billingPaymentIdSchema>\n\nexport const billingPaymentConvertSchema = scopedSchema.extend({\n  paymentId: z.string().uuid(),\n  billAccountId: z.string().uuid(),\n})\nexport type BillingPaymentConvertInput = z.infer<typeof billingPaymentConvertSchema>\n\n// CSV upload: 2 MB of text, \u2264 5,000 data rows (checked by the parser).\nexport const PAYMENT_IMPORT_MAX_BYTES = 2 * 1024 * 1024\nexport const PAYMENT_IMPORT_MAX_ROWS = 5000\n\nexport const billingPaymentImportSchema = scopedSchema.extend({\n  fileName: z.string().trim().min(1).max(255),\n  content: z.string().max(PAYMENT_IMPORT_MAX_BYTES),\n})\nexport type BillingPaymentImportInput = z.infer<typeof billingPaymentImportSchema>\n\nexport const billingPaymentListQuerySchema = z\n  .object({\n    ...listPaginationBase,\n    id: z.string().uuid().optional(),\n    status: z.enum(PAYMENT_STATUSES).optional(),\n    billAccountId: z.string().uuid().optional(),\n    importId: z.string().uuid().optional(),\n    receivedFrom: isoDateString.optional(),\n    receivedTo: isoDateString.optional(),\n    search: z.string().trim().max(100).optional(),\n  })\n  .passthrough()\nexport type BillingPaymentListQuery = z.infer<typeof billingPaymentListQuerySchema>\n\nexport const billingPaymentImportListQuerySchema = z\n  .object({ ...listPaginationBase, id: z.string().uuid().optional() })\n  .passthrough()\nexport type BillingPaymentImportListQuery = z.infer<typeof billingPaymentImportListQuerySchema>\n\n// \u2500\u2500\u2500 Spec D \u2014 credit / debit memos \u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 MEMO_TYPES = ['credit_memo', 'debit_memo'] as const\nexport type MemoType = (typeof MEMO_TYPES)[number]\n\nconst memoLineSchema = z.object({\n  // Copied from the original (credit prefill). The original line's VAT rate wins.\n  correctsLineId: z.string().uuid().optional(),\n  description: z.string().trim().min(1).max(500),\n  quantity: z.coerce.number().finite().positive(),\n  unitPriceNet: z.coerce.number().finite().nonnegative(),\n  // New lines: omitted \u2192 organization default rate.\n  taxRate: z.coerce.number().finite().min(0).max(100).optional(),\n})\nexport type MemoLineInput = z.infer<typeof memoLineSchema>\n\nexport const billingMemoCreateSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n  type: z.enum(MEMO_TYPES),\n  reason: z.string().trim().min(1, 'billing.memo.error.reason_required').max(1000),\n  // Credit memo without lines = full credit (all original lines). Debit memo\n  // without lines = empty draft (lines are added on the draft).\n  lines: z.array(memoLineSchema).max(200).optional(),\n})\nexport type BillingMemoCreateInput = z.infer<typeof billingMemoCreateSchema>\n\nexport const billingDraftDeleteSchema = scopedSchema.extend({\n  invoiceId: z.string().uuid(),\n})\nexport type BillingDraftDeleteInput = z.infer<typeof billingDraftDeleteSchema>\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/events.js

@@ -27,6 +27,48 @@ const events = [
     category: "lifecycle",
     clientBroadcast: true
   },
+  {
+    id: "billing.invoice.sent",
+    label: "Billing Invoice Sent",
+    entity: "invoice",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  {
+    id: "billing.invoice.send_failed",
+    label: "Billing Invoice Send Failed",
+    entity: "invoice",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  // ─── Payments (Spec C) ───────────────────────────────────────
+  { id: "billing.payment.created", label: "Billing Payment Created", entity: "payment", category: "lifecycle" },
+  { id: "billing.payment.allocated", label: "Billing Payment Allocated", entity: "payment", category: "lifecycle" },
+  { id: "billing.payment.unallocated", label: "Billing Payment Unallocated", entity: "payment", category: "lifecycle" },
+  {
+    id: "billing.payment.converted_to_topup",
+    label: "Billing Payment Converted to Top-up",
+    entity: "payment",
+    category: "lifecycle"
+  },
+  {
+    id: "billing.payment_import.completed",
+    label: "Billing Payment Import Completed",
+    entity: "payment_import",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
+  { id: "billing.invoice.paid", label: "Billing Invoice Paid", entity: "invoice", category: "lifecycle", clientBroadcast: true },
+  // ─── Corrective documents (Spec D) ───────────────────────────
+  { id: "billing.credit_memo.posted", label: "Billing Credit Memo Posted", entity: "credit_memo", category: "lifecycle", clientBroadcast: true },
+  { id: "billing.debit_memo.posted", label: "Billing Debit Memo Posted", entity: "debit_memo", category: "lifecycle", clientBroadcast: true },
+  { id: "billing.invoice.credited", label: "Billing Invoice Credited", entity: "invoice", category: "lifecycle", clientBroadcast: true },
+  {
+    id: "billing.invoice.partially_paid",
+    label: "Billing Invoice Partially Paid",
+    entity: "invoice",
+    category: "lifecycle"
+  },
   {
     id: "billing.invoice.line_posted",
     label: "Billing Invoice Line Posted",
@@ -40,6 +82,14 @@ const events = [
     category: "lifecycle",
     clientBroadcast: true
   },
+  // Spec F — a test / dry run and its test invoices were deleted.
+  {
+    id: "billing.run.deleted",
+    label: "Bill Run Deleted",
+    entity: "bill_run",
+    category: "lifecycle",
+    clientBroadcast: true
+  },
   // ─── Prepaid balance billing (SPEC-002) ──────────────────────
   {
     id: "billing.balance.topped_up",

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 *\n * CRUD events (`billing.<entity>.<action>`) are emitted by the data engine\n * from the commands' `emitCrudSideEffects({ events: { module: 'billing',\n * entity } })`. Only the (entity, action) pairs a command actually emits are\n * declared \u2014 `__tests__/events.test.ts` fails when a command emits one that\n * is missing here (the data engine would log \"Emitting undeclared event\").\n */\nconst events = [\n  // \u2500\u2500\u2500 CRUD (commands/*.ts) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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  { id: 'billing.account.created', label: 'Billing Account Created', entity: 'account', category: 'crud' },\n  { id: 'billing.account.updated', label: 'Billing Account Updated', entity: 'account', category: 'crud' },\n  { id: 'billing.account.deleted', label: 'Billing Account Deleted', entity: 'account', category: 'crud' },\n  { id: 'billing.item.created', label: 'Billing Item Created', entity: 'item', category: 'crud' },\n  { id: 'billing.item.updated', label: 'Billing Item Updated', entity: 'item', category: 'crud' },\n  { id: 'billing.item.deleted', label: 'Billing Item Deleted', entity: 'item', category: 'crud' },\n  {\n    // One per usage upload, on the same high-throughput path as\n    // `billing.usage.rated` \u2014 excluded from workflow triggers for the same\n    // reason (see Open Question #2).\n    id: 'billing.usage.created',\n    label: 'Billing Usage Record Created',\n    entity: 'usage',\n    category: 'crud',\n    excludeFromTriggers: true,\n  },\n  { id: 'billing.transaction.created', label: 'Billing Balance Transaction Created', entity: 'transaction', category: 'crud' },\n  { id: 'billing.topup.created', label: 'Billing Top-up Created', entity: 'topup', category: 'crud' },\n  // \u2500\u2500\u2500 Lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    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;AAqBnC,MAAM,SAAS;AAAA;AAAA,EAEb,EAAE,IAAI,2BAA2B,OAAO,2BAA2B,QAAQ,WAAW,UAAU,OAAO;AAAA,EACvG,EAAE,IAAI,2BAA2B,OAAO,2BAA2B,QAAQ,WAAW,UAAU,OAAO;AAAA,EACvG,EAAE,IAAI,2BAA2B,OAAO,2BAA2B,QAAQ,WAAW,UAAU,OAAO;AAAA,EACvG,EAAE,IAAI,wBAAwB,OAAO,wBAAwB,QAAQ,QAAQ,UAAU,OAAO;AAAA,EAC9F,EAAE,IAAI,wBAAwB,OAAO,wBAAwB,QAAQ,QAAQ,UAAU,OAAO;AAAA,EAC9F,EAAE,IAAI,wBAAwB,OAAO,wBAAwB,QAAQ,QAAQ,UAAU,OAAO;AAAA,EAC9F;AAAA;AAAA;AAAA;AAAA,IAIE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,qBAAqB;AAAA,EACvB;AAAA,EACA,EAAE,IAAI,+BAA+B,OAAO,uCAAuC,QAAQ,eAAe,UAAU,OAAO;AAAA,EAC3H,EAAE,IAAI,yBAAyB,OAAO,0BAA0B,QAAQ,SAAS,UAAU,OAAO;AAAA;AAAA,EAElG;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;",
+  "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 (series number, issue/due dates assigned, status\n *     `posted` in `billing_invoices`) and after the PDF is frozen. Consumed by\n *     the auto-send subscriber, accounting bridges, analytics.\n *   - `billing.invoice.sent` / `billing.invoice.send_failed` fire once per\n *     email delivery attempt (Spec B), manual or automatic.\n *   - `billing.invoice.line_posted` fires once per line on a posted invoice\n *     so analytics can aggregate without scanning invoice 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 *\n * CRUD events (`billing.<entity>.<action>`) are emitted by the data engine\n * from the commands' `emitCrudSideEffects({ events: { module: 'billing',\n * entity } })`. Only the (entity, action) pairs a command actually emits are\n * declared \u2014 `__tests__/events.test.ts` fails when a command emits one that\n * is missing here (the data engine would log \"Emitting undeclared event\").\n */\nconst events = [\n  // \u2500\u2500\u2500 CRUD (commands/*.ts) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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  { id: 'billing.account.created', label: 'Billing Account Created', entity: 'account', category: 'crud' },\n  { id: 'billing.account.updated', label: 'Billing Account Updated', entity: 'account', category: 'crud' },\n  { id: 'billing.account.deleted', label: 'Billing Account Deleted', entity: 'account', category: 'crud' },\n  { id: 'billing.item.created', label: 'Billing Item Created', entity: 'item', category: 'crud' },\n  { id: 'billing.item.updated', label: 'Billing Item Updated', entity: 'item', category: 'crud' },\n  { id: 'billing.item.deleted', label: 'Billing Item Deleted', entity: 'item', category: 'crud' },\n  {\n    // One per usage upload, on the same high-throughput path as\n    // `billing.usage.rated` \u2014 excluded from workflow triggers for the same\n    // reason (see Open Question #2).\n    id: 'billing.usage.created',\n    label: 'Billing Usage Record Created',\n    entity: 'usage',\n    category: 'crud',\n    excludeFromTriggers: true,\n  },\n  { id: 'billing.transaction.created', label: 'Billing Balance Transaction Created', entity: 'transaction', category: 'crud' },\n  { id: 'billing.topup.created', label: 'Billing Top-up Created', entity: 'topup', category: 'crud' },\n  // \u2500\u2500\u2500 Lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    id: 'billing.invoice.posted',\n    label: 'Billing Invoice Posted',\n    entity: 'invoice',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.invoice.sent',\n    label: 'Billing Invoice Sent',\n    entity: 'invoice',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  {\n    id: 'billing.invoice.send_failed',\n    label: 'Billing Invoice Send Failed',\n    entity: 'invoice',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  // \u2500\u2500\u2500 Payments (Spec C) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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  { id: 'billing.payment.created', label: 'Billing Payment Created', entity: 'payment', category: 'lifecycle' },\n  { id: 'billing.payment.allocated', label: 'Billing Payment Allocated', entity: 'payment', category: 'lifecycle' },\n  { id: 'billing.payment.unallocated', label: 'Billing Payment Unallocated', entity: 'payment', category: 'lifecycle' },\n  {\n    id: 'billing.payment.converted_to_topup',\n    label: 'Billing Payment Converted to Top-up',\n    entity: 'payment',\n    category: 'lifecycle',\n  },\n  {\n    id: 'billing.payment_import.completed',\n    label: 'Billing Payment Import Completed',\n    entity: 'payment_import',\n    category: 'lifecycle',\n    clientBroadcast: true,\n  },\n  { id: 'billing.invoice.paid', label: 'Billing Invoice Paid', entity: 'invoice', category: 'lifecycle', clientBroadcast: true },\n  // \u2500\u2500\u2500 Corrective documents (Spec D) \u2500\u2500\u2500\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  { id: 'billing.credit_memo.posted', label: 'Billing Credit Memo Posted', entity: 'credit_memo', category: 'lifecycle', clientBroadcast: true },\n  { id: 'billing.debit_memo.posted', label: 'Billing Debit Memo Posted', entity: 'debit_memo', category: 'lifecycle', clientBroadcast: true },\n  { id: 'billing.invoice.credited', label: 'Billing Invoice Credited', entity: 'invoice', category: 'lifecycle', clientBroadcast: true },\n  {\n    id: 'billing.invoice.partially_paid',\n    label: 'Billing Invoice Partially Paid',\n    entity: 'invoice',\n    category: 'lifecycle',\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  // Spec F \u2014 a test / dry run and its test invoices were deleted.\n  {\n    id: 'billing.run.deleted',\n    label: 'Bill Run Deleted',\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": "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",
   "names": []
 }