@dainamite/billing 0.20.0 → 0.22.0

package/dist/modules/billing/api/payments/unallocate/route.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { runCommandRoute } from "../../../lib/commandRoute.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["billing.payment.manage"] }
+};
+const bodySchema = z.object({ allocationId: z.string().uuid() });
+async function POST(req) {
+  return runCommandRoute(req, {
+    commandId: "billing.payments.unallocate",
+    bodySchema,
+    resourceKind: "billing.payment",
+    resourceId: (body) => body.allocationId,
+    logLabel: "billing/payments/unallocate.POST"
+  });
+}
+const openApi = {
+  methods: {
+    POST: {
+      tags: ["Billing"],
+      summary: "Remove an allocation",
+      description: "Un-allocates a payment or credit memo allocation (soft delete, history kept). The source's unallocated amount is restored and the invoice recomputed.",
+      requestBody: { schema: bodySchema },
+      responses: [{ status: 200, description: "Updated payment state" }],
+      errors: [
+        { status: 404, description: "Allocation not found" }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/payments/unallocate/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/payments/unallocate/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport { runCommandRoute } from '../../../lib/commandRoute'\n\n/** `POST /api/billing/payments/unallocate` \u2014 remove an allocation (Spec C). */\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.payment.manage'] },\n}\n\nconst bodySchema = z.object({ allocationId: z.string().uuid() })\n\nexport async function POST(req: Request) {\n  return runCommandRoute(req, {\n    commandId: 'billing.payments.unallocate',\n    bodySchema,\n    resourceKind: 'billing.payment',\n    resourceId: (body) => body.allocationId,\n    logLabel: 'billing/payments/unallocate.POST',\n  })\n}\n\nexport const openApi = {\n  methods: {\n    POST: {\n      tags: ['Billing'],\n      summary: 'Remove an allocation',\n      description: 'Un-allocates a payment or credit memo allocation (soft delete, history kept). The source\\'s unallocated amount is restored and the invoice recomputed.',\n      requestBody: { schema: bodySchema },\n      responses: [{ status: 200, description: 'Updated payment state' }],\n      errors: [\n        { status: 404, description: 'Allocation not found' },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AAIzB,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,wBAAwB,EAAE;AACzE;AAEA,MAAM,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAE/D,eAAsB,KAAK,KAAc;AACvC,SAAO,gBAAgB,KAAK;AAAA,IAC1B,WAAW;AAAA,IACX;AAAA,IACA,cAAc;AAAA,IACd,YAAY,CAAC,SAAS,KAAK;AAAA,IAC3B,UAAU;AAAA,EACZ,CAAC;AACH;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,QAAQ,WAAW;AAAA,MAClC,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,wBAAwB,CAAC;AAAA,MACjE,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,uBAAuB;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/billing/api/payments/unassign/route.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { runCommandRoute } from "../../../lib/commandRoute.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["billing.payment.manage"] }
+};
+const bodySchema = z.object({ paymentId: z.string().uuid() });
+async function POST(req) {
+  return runCommandRoute(req, {
+    commandId: "billing.payments.unassign",
+    bodySchema,
+    resourceKind: "billing.payment",
+    resourceId: (body) => body.paymentId,
+    logLabel: "billing/payments/unassign.POST"
+  });
+}
+const openApi = {
+  methods: {
+    POST: {
+      tags: ["Billing"],
+      summary: "Unassign a payment",
+      description: "Reverses an assignment of a matched payment that has no allocations (status \u2192 unmatched).",
+      requestBody: { schema: bodySchema },
+      responses: [{ status: 200, description: "Updated payment state" }],
+      errors: [
+        { status: 409, description: "`billing.payment.has_allocations` \u2014 un-allocate first" }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/payments/unassign/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/payments/unassign/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport { runCommandRoute } from '../../../lib/commandRoute'\n\n/** `POST /api/billing/payments/unassign` \u2014 unassign a payment (Spec C). */\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.payment.manage'] },\n}\n\nconst bodySchema = z.object({ paymentId: z.string().uuid() })\n\nexport async function POST(req: Request) {\n  return runCommandRoute(req, {\n    commandId: 'billing.payments.unassign',\n    bodySchema,\n    resourceKind: 'billing.payment',\n    resourceId: (body) => body.paymentId,\n    logLabel: 'billing/payments/unassign.POST',\n  })\n}\n\nexport const openApi = {\n  methods: {\n    POST: {\n      tags: ['Billing'],\n      summary: 'Unassign a payment',\n      description: 'Reverses an assignment of a matched payment that has no allocations (status \u2192 unmatched).',\n      requestBody: { schema: bodySchema },\n      responses: [{ status: 200, description: 'Updated payment state' }],\n      errors: [\n        { status: 409, description: '`billing.payment.has_allocations` \u2014 un-allocate first' },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AAIzB,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,wBAAwB,EAAE;AACzE;AAEA,MAAM,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAE5D,eAAsB,KAAK,KAAc;AACvC,SAAO,gBAAgB,KAAK;AAAA,IAC1B,WAAW;AAAA,IACX;AAAA,IACA,cAAc;AAAA,IACd,YAAY,CAAC,SAAS,KAAK;AAAA,IAC3B,UAAU;AAAA,EACZ,CAAC;AACH;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,QAAQ,WAAW;AAAA,MAClC,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,wBAAwB,CAAC;AAAA,MACjE,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,6DAAwD;AAAA,MACtF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/billing/api/run-outcomes/route.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import { SalesInvoice } from "@open-mercato/core/modules/sales/data/entities";
 import { makeCrudRoute } from "@open-mercato/shared/lib/crud/factory";
-import { BillingAccount, BillingRunOutcome } from "../../data/entities.js";
+import { BillingAccount, BillingRun, BillingRunOutcome, BillingInvoice } from "../../data/entities.js";
+import { toIsoDate } from "../../lib/dateOnly.js";
 import { billingEntityIds } from "../../data/entityIds.js";
 import {
   BILL_RUN_OUTCOME_STATUSES
@@ -28,8 +28,28 @@ const billRunOutcomeListItemSchema = z.object({
   errorMessage: z.string().nullable(),
   warnings: z.record(z.string(), z.unknown()).nullable(),
   draftInvoiceId: z.string().uuid().nullable(),
+  // Spec A: one entry per bill date processed for the account (catch-up).
+  cycles: z.array(
+    z.object({
+      bill_date: z.string(),
+      period_start: z.string().nullable(),
+      period_end: z.string().nullable(),
+      // Spec F: `charged` = prepaid charges debited from the balance.
+      status: z.enum(["invoiced", "charged", "previewed", "empty", "skipped_existing"]),
+      line_count: z.number(),
+      total_net: z.string(),
+      invoice_id: z.string().uuid().nullable(),
+      invoice_number: z.string().nullable(),
+      // Spec F (prepaid): what left the balance, and the period's statement.
+      total_debit: z.string().optional(),
+      statement_id: z.string().uuid().nullable().optional()
+    })
+  ).nullable(),
   bill_account_name: z.string().nullable(),
   invoice_number: z.string().nullable(),
+  /** Spec F: mode and as-of date of the run this outcome belongs to. */
+  run_mode: z.enum(["real", "test", "dry"]).nullable(),
+  run_as_of_date: z.string().nullable(),
   organizationId: z.string().uuid(),
   tenantId: z.string().uuid(),
   createdAt: z.string(),
@@ -55,6 +75,7 @@ const crud = makeCrudRoute({
       "error_message",
       "warnings",
       "draft_invoice_id",
+      "cycles",
       "organization_id",
       "tenant_id",
       "created_at",
@@ -85,24 +106,40 @@ const crud = makeCrudRoute({
           items.map((row) => row.bill_account_id).filter((v) => typeof v === "string" && v.length > 0)
         )
       );
+      const cycleInvoiceIds = (row) => Array.isArray(row.cycles) ? row.cycles.map((cycle) => cycle?.invoice_id) : [];
       const invoiceIds = Array.from(
         new Set(
-          items.map((row) => row.draft_invoice_id).filter((v) => typeof v === "string" && v.length > 0)
+          items.flatMap((row) => [row.draft_invoice_id, ...cycleInvoiceIds(row)]).filter((v) => typeof v === "string" && v.length > 0)
         )
       );
-      const [accounts, invoices] = await Promise.all([
+      const runIds = Array.from(
+        new Set(items.map((row) => row.bill_run_id).filter((v) => typeof v === "string" && v.length > 0))
+      );
+      const [accounts, invoices, runs] = await Promise.all([
         accountIds.length ? em.find(BillingAccount, { id: { $in: accountIds } }) : [],
-        invoiceIds.length ? em.find(SalesInvoice, { id: { $in: invoiceIds } }) : []
+        invoiceIds.length ? em.find(BillingInvoice, { id: { $in: invoiceIds } }) : [],
+        // Spec F: the run's mode and as-of date (account Bill runs tab).
+        runIds.length ? em.find(BillingRun, { id: { $in: runIds } }) : []
       ]);
+      const runById = new Map(runs.map((run) => [String(run.id), run]));
       const accountName = new Map(
         accounts.map((a) => [String(a.id), a.name])
       );
       const invoiceNumber = new Map(
-        invoices.map((i) => [String(i.id), i.invoiceNumber])
+        invoices.map((i) => [String(i.id), i.number])
       );
       for (const row of items) {
         row.bill_account_name = accountName.get(String(row.bill_account_id)) ?? null;
+        const run = runById.get(String(row.bill_run_id));
+        row.run_mode = run ? run.dryRun ? "dry" : run.testMode ? "test" : "real" : null;
+        row.run_as_of_date = run?.asOfDate ? toIsoDate(run.asOfDate) : null;
         row.invoice_number = typeof row.draft_invoice_id === "string" ? invoiceNumber.get(row.draft_invoice_id) ?? null : null;
+        if (Array.isArray(row.cycles)) {
+          row.cycles = row.cycles.map((cycle) => ({
+            ...cycle,
+            invoice_number: typeof cycle?.invoice_id === "string" ? invoiceNumber.get(cycle.invoice_id) ?? null : null
+          }));
+        }
       }
     }
   }

package/dist/modules/billing/api/run-outcomes/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/billing/api/run-outcomes/route.ts"],
-  "sourcesContent": ["import { z } from 'zod'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { SalesInvoice } from '@open-mercato/core/modules/sales/data/entities'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { BillingAccount, BillingRunOutcome } from '../../data/entities'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  BILL_RUN_OUTCOME_STATUSES,\n} from '../../data/validators'\nimport { createBillingCrudOpenApi, createPagedListResponseSchema } from '../openapi'\n\n/**\n * `GET /api/billing/run-outcomes` \u2014 list per-account outcomes,\n * typically filtered by `billRunId` to populate the \"show me what\n * happened in this run\" detail panel.\n *\n * Read-only; outcomes are written by the engine itself, never by API\n * clients.\n */\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.run.view'] },\n}\n\nexport const metadata = routeMetadata\n\nconst listQuerySchema = z\n  .object({\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    billRunId: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    status: z.enum(BILL_RUN_OUTCOME_STATUSES).optional(),\n  })\n  .passthrough()\n\nconst billRunOutcomeListItemSchema = z.object({\n  id: z.string().uuid(),\n  billRunId: z.string().uuid(),\n  billAccountId: z.string().uuid(),\n  status: z.string(),\n  errorMessage: z.string().nullable(),\n  warnings: z.record(z.string(), z.unknown()).nullable(),\n  draftInvoiceId: z.string().uuid().nullable(),\n  bill_account_name: z.string().nullable(),\n  invoice_number: z.string().nullable(),\n  organizationId: z.string().uuid(),\n  tenantId: z.string().uuid(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n})\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRunOutcome,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: listQuerySchema,\n    entityId: billingEntityIds.runOutcome,\n    fields: [\n      'id',\n      'bill_run_id',\n      'bill_account_id',\n      'status',\n      'error_message',\n      'warnings',\n      'draft_invoice_id',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      createdAt: 'created_at',\n    },\n    buildFilters: async (query) => {\n      const filters: Record<string, unknown> = {}\n      if (typeof query.billRunId === 'string') filters.bill_run_id = { $eq: query.billRunId }\n      if (typeof query.billAccountId === 'string') {\n        filters.bill_account_id = { $eq: query.billAccountId }\n      }\n      if (typeof query.status === 'string') filters.status = { $eq: query.status }\n      return filters\n    },\n  },\n  hooks: {\n    // Outcomes reference account + draft invoice by FK id only. The\n    // run detail UI wants names \u2014 resolve both in two bounded queries.\n    afterList: async (payload: unknown, ctx: unknown) => {\n      const items = ((payload as { items?: unknown[] } | null)?.items ?? []) as Array<\n        Record<string, unknown>\n      >\n      if (items.length === 0) return\n      const em = (ctx as { container: AwilixContainer }).container.resolve<EntityManager>('em')\n      const accountIds = Array.from(\n        new Set(\n          items\n            .map((row) => row.bill_account_id)\n            .filter((v): v is string => typeof v === 'string' && v.length > 0),\n        ),\n      )\n      const invoiceIds = Array.from(\n        new Set(\n          items\n            .map((row) => row.draft_invoice_id)\n            .filter((v): v is string => typeof v === 'string' && v.length > 0),\n        ),\n      )\n      const [accounts, invoices] = await Promise.all([\n        accountIds.length\n          ? em.find(BillingAccount, { id: { $in: accountIds } })\n          : [],\n        invoiceIds.length\n          ? em.find(SalesInvoice, { id: { $in: invoiceIds } })\n          : [],\n      ])\n      const accountName = new Map(\n        accounts.map((a) => [String(a.id), a.name] as [string, unknown]),\n      )\n      const invoiceNumber = new Map(\n        invoices.map((i) => [String(i.id), i.invoiceNumber] as [string, unknown]),\n      )\n      for (const row of items) {\n        row.bill_account_name = accountName.get(String(row.bill_account_id)) ?? null\n        row.invoice_number =\n          typeof row.draft_invoice_id === 'string'\n            ? invoiceNumber.get(row.draft_invoice_id) ?? null\n            : null\n      }\n    },\n  },\n})\n\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRunOutcome',\n  pluralName: 'BillRunOutcomes',\n  querySchema: listQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billRunOutcomeListItemSchema),\n})\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { z } from 'zod'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { BillingAccount, BillingRun, BillingRunOutcome, BillingInvoice } from '../../data/entities'\nimport { toIsoDate } from '../../lib/dateOnly'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  BILL_RUN_OUTCOME_STATUSES,\n} from '../../data/validators'\nimport { createBillingCrudOpenApi, createPagedListResponseSchema } from '../openapi'\n\n/**\n * `GET /api/billing/run-outcomes` \u2014 list per-account outcomes,\n * typically filtered by `billRunId` to populate the \"show me what\n * happened in this run\" detail panel.\n *\n * Read-only; outcomes are written by the engine itself, never by API\n * clients.\n */\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.run.view'] },\n}\n\nexport const metadata = routeMetadata\n\nconst listQuerySchema = z\n  .object({\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    billRunId: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    status: z.enum(BILL_RUN_OUTCOME_STATUSES).optional(),\n  })\n  .passthrough()\n\nconst billRunOutcomeListItemSchema = z.object({\n  id: z.string().uuid(),\n  billRunId: z.string().uuid(),\n  billAccountId: z.string().uuid(),\n  status: z.string(),\n  errorMessage: z.string().nullable(),\n  warnings: z.record(z.string(), z.unknown()).nullable(),\n  draftInvoiceId: z.string().uuid().nullable(),\n  // Spec A: one entry per bill date processed for the account (catch-up).\n  cycles: z\n    .array(\n      z.object({\n        bill_date: z.string(),\n        period_start: z.string().nullable(),\n        period_end: z.string().nullable(),\n        // Spec F: `charged` = prepaid charges debited from the balance.\n        status: z.enum(['invoiced', 'charged', 'previewed', 'empty', 'skipped_existing']),\n        line_count: z.number(),\n        total_net: z.string(),\n        invoice_id: z.string().uuid().nullable(),\n        invoice_number: z.string().nullable(),\n        // Spec F (prepaid): what left the balance, and the period's statement.\n        total_debit: z.string().optional(),\n        statement_id: z.string().uuid().nullable().optional(),\n      }),\n    )\n    .nullable(),\n  bill_account_name: z.string().nullable(),\n  invoice_number: z.string().nullable(),\n  /** Spec F: mode and as-of date of the run this outcome belongs to. */\n  run_mode: z.enum(['real', 'test', 'dry']).nullable(),\n  run_as_of_date: z.string().nullable(),\n  organizationId: z.string().uuid(),\n  tenantId: z.string().uuid(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n})\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRunOutcome,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: listQuerySchema,\n    entityId: billingEntityIds.runOutcome,\n    fields: [\n      'id',\n      'bill_run_id',\n      'bill_account_id',\n      'status',\n      'error_message',\n      'warnings',\n      'draft_invoice_id',\n      'cycles',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      createdAt: 'created_at',\n    },\n    buildFilters: async (query) => {\n      const filters: Record<string, unknown> = {}\n      if (typeof query.billRunId === 'string') filters.bill_run_id = { $eq: query.billRunId }\n      if (typeof query.billAccountId === 'string') {\n        filters.bill_account_id = { $eq: query.billAccountId }\n      }\n      if (typeof query.status === 'string') filters.status = { $eq: query.status }\n      return filters\n    },\n  },\n  hooks: {\n    // Outcomes reference account + draft invoice by FK id only. The\n    // run detail UI wants names \u2014 resolve both in two bounded queries.\n    afterList: async (payload: unknown, ctx: unknown) => {\n      const items = ((payload as { items?: unknown[] } | null)?.items ?? []) as Array<\n        Record<string, unknown>\n      >\n      if (items.length === 0) return\n      const em = (ctx as { container: AwilixContainer }).container.resolve<EntityManager>('em')\n      const accountIds = Array.from(\n        new Set(\n          items\n            .map((row) => row.bill_account_id)\n            .filter((v): v is string => typeof v === 'string' && v.length > 0),\n        ),\n      )\n      const cycleInvoiceIds = (row: Record<string, unknown>): unknown[] =>\n        Array.isArray(row.cycles)\n          ? (row.cycles as Array<Record<string, unknown>>).map((cycle) => cycle?.invoice_id)\n          : []\n      const invoiceIds = Array.from(\n        new Set(\n          items\n            .flatMap((row) => [row.draft_invoice_id, ...cycleInvoiceIds(row)])\n            .filter((v): v is string => typeof v === 'string' && v.length > 0),\n        ),\n      )\n      const runIds = Array.from(\n        new Set(items.map((row) => row.bill_run_id).filter((v): v is string => typeof v === 'string' && v.length > 0)),\n      )\n      const [accounts, invoices, runs] = await Promise.all([\n        accountIds.length\n          ? em.find(BillingAccount, { id: { $in: accountIds } })\n          : [],\n        invoiceIds.length\n          ? em.find(BillingInvoice, { id: { $in: invoiceIds } })\n          : [],\n        // Spec F: the run's mode and as-of date (account Bill runs tab).\n        runIds.length ? em.find(BillingRun, { id: { $in: runIds } }) : [],\n      ])\n      const runById = new Map(runs.map((run) => [String(run.id), run] as const))\n      const accountName = new Map(\n        accounts.map((a) => [String(a.id), a.name] as [string, unknown]),\n      )\n      const invoiceNumber = new Map(\n        invoices.map((i) => [String(i.id), i.number] as [string, unknown]),\n      )\n      for (const row of items) {\n        row.bill_account_name = accountName.get(String(row.bill_account_id)) ?? null\n        const run = runById.get(String(row.bill_run_id))\n        row.run_mode = run ? (run.dryRun ? 'dry' : run.testMode ? 'test' : 'real') : null\n        row.run_as_of_date = run?.asOfDate ? toIsoDate(run.asOfDate) : null\n        row.invoice_number =\n          typeof row.draft_invoice_id === 'string'\n            ? invoiceNumber.get(row.draft_invoice_id) ?? null\n            : null\n        if (Array.isArray(row.cycles)) {\n          row.cycles = (row.cycles as Array<Record<string, unknown>>).map((cycle) => ({\n            ...cycle,\n            invoice_number:\n              typeof cycle?.invoice_id === 'string' ? invoiceNumber.get(cycle.invoice_id) ?? null : null,\n          }))\n        }\n      }\n    },\n  },\n})\n\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRunOutcome',\n  pluralName: 'BillRunOutcomes',\n  querySchema: listQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billRunOutcomeListItemSchema),\n})\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/api/runs/[id]/post-drafts/route.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { readRequestBody, runCommandRoute } from "../../../../lib/commandRoute.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["billing.invoice.post"] }
+};
+const paramsSchema = z.object({ id: z.string().uuid() });
+const bodySchema = z.object({
+  afterInvoiceId: z.string().uuid().optional(),
+  limit: z.coerce.number().int().min(1).max(100).optional()
+});
+const responseSchema = z.object({
+  posted: z.number().int().nonnegative(),
+  failed: z.array(
+    z.object({ invoiceId: z.string().uuid(), number: z.string(), error: z.string(), code: z.string().nullable() })
+  ),
+  nextCursor: z.string().uuid().nullable(),
+  remaining: z.number().int().nonnegative(),
+  stoppedReason: z.string().nullable()
+});
+async function POST(req, { params }) {
+  const parsedParams = paramsSchema.safeParse(await params);
+  if (!parsedParams.success) {
+    return Response.json({ error: "Invalid Bill Run id", code: "billing.request.invalid" }, { status: 400 });
+  }
+  const billRunId = parsedParams.data.id;
+  return runCommandRoute(
+    req,
+    {
+      commandId: "billing.runs.post_drafts",
+      bodySchema,
+      resourceKind: "billing.bill_run",
+      resourceId: () => billRunId,
+      toInput: (body, scope) => ({ ...body, ...scope, billRunId }),
+      logLabel: "billing/runs/[id]/post-drafts.POST"
+    },
+    await readRequestBody(req)
+  );
+}
+const openApi = {
+  methods: {
+    POST: {
+      tags: ["Billing"],
+      summary: "Post a real Bill Run's draft invoices (batched)",
+      description: "Posts up to `limit` (default 25, max 100) draft invoices of a real Bill Run, ascending by id. Pass `nextCursor` back as `afterInvoiceId` until `remaining` is 0. Per-invoice failures are listed in `failed`; incomplete seller settings stop the batch (`stoppedReason: billing.settings.incomplete`).",
+      pathParams: paramsSchema,
+      requestBody: { schema: bodySchema },
+      responses: [{ status: 200, description: "Batch result", schema: responseSchema }],
+      errors: [
+        { status: 404, description: "`billing.run.not_found`" },
+        { status: 409, description: "`billing.run.running`" },
+        { status: 422, description: "`billing.run.not_real`" }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/runs/[id]/post-drafts/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/billing/api/runs/%5Bid%5D/post-drafts/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport { readRequestBody, runCommandRoute } from '../../../../lib/commandRoute'\n\n/**\n * `POST /api/billing/runs/{id}/post-drafts` \u2014 post the draft invoices of a\n * REAL Bill Run, one bounded batch per call (ascending id). Call again with\n * `afterInvoiceId = nextCursor` until `remaining` is 0. Each invoice is posted\n * through `billing.invoices.post`; failures are reported per invoice and do\n * not stop the batch, except incomplete seller settings (`stoppedReason`).\n */\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.invoice.post'] },\n}\n\nconst paramsSchema = z.object({ id: z.string().uuid() })\nconst bodySchema = z.object({\n  afterInvoiceId: z.string().uuid().optional(),\n  limit: z.coerce.number().int().min(1).max(100).optional(),\n})\n\nconst responseSchema = z.object({\n  posted: z.number().int().nonnegative(),\n  failed: z.array(\n    z.object({ invoiceId: z.string().uuid(), number: z.string(), error: z.string(), code: z.string().nullable() }),\n  ),\n  nextCursor: z.string().uuid().nullable(),\n  remaining: z.number().int().nonnegative(),\n  stoppedReason: z.string().nullable(),\n})\n\nexport async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {\n  const parsedParams = paramsSchema.safeParse(await params)\n  if (!parsedParams.success) {\n    return Response.json({ error: 'Invalid Bill Run id', code: 'billing.request.invalid' }, { status: 400 })\n  }\n  const billRunId = parsedParams.data.id\n  return runCommandRoute(\n    req,\n    {\n      commandId: 'billing.runs.post_drafts',\n      bodySchema,\n      resourceKind: 'billing.bill_run',\n      resourceId: () => billRunId,\n      toInput: (body, scope) => ({ ...body, ...scope, billRunId }),\n      logLabel: 'billing/runs/[id]/post-drafts.POST',\n    },\n    await readRequestBody(req),\n  )\n}\n\nexport const openApi = {\n  methods: {\n    POST: {\n      tags: ['Billing'],\n      summary: \"Post a real Bill Run's draft invoices (batched)\",\n      description:\n        'Posts up to `limit` (default 25, max 100) draft invoices of a real Bill Run, ascending by id. ' +\n        'Pass `nextCursor` back as `afterInvoiceId` until `remaining` is 0. Per-invoice failures are listed in ' +\n        '`failed`; incomplete seller settings stop the batch (`stoppedReason: billing.settings.incomplete`).',\n      pathParams: paramsSchema,\n      requestBody: { schema: bodySchema },\n      responses: [{ status: 200, description: 'Batch result', schema: responseSchema }],\n      errors: [\n        { status: 404, description: '`billing.run.not_found`' },\n        { status: 409, description: '`billing.run.running`' },\n        { status: 422, description: '`billing.run.not_real`' },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,iBAAiB,uBAAuB;AAU1C,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,sBAAsB,EAAE;AACvE;AAEA,MAAM,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACvD,MAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA,EAC3C,OAAO,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAC1D,CAAC;AAED,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACrC,QAAQ,EAAE;AAAA,IACR,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,GAAG,QAAQ,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,EAC/G;AAAA,EACA,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA,EACvC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACxC,eAAe,EAAE,OAAO,EAAE,SAAS;AACrC,CAAC;AAED,eAAsB,KAAK,KAAc,EAAE,OAAO,GAAwC;AACxF,QAAM,eAAe,aAAa,UAAU,MAAM,MAAM;AACxD,MAAI,CAAC,aAAa,SAAS;AACzB,WAAO,SAAS,KAAK,EAAE,OAAO,uBAAuB,MAAM,0BAA0B,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACzG;AACA,QAAM,YAAY,aAAa,KAAK;AACpC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX;AAAA,MACA,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,MAClB,SAAS,CAAC,MAAM,WAAW,EAAE,GAAG,MAAM,GAAG,OAAO,UAAU;AAAA,MAC1D,UAAU;AAAA,IACZ;AAAA,IACA,MAAM,gBAAgB,GAAG;AAAA,EAC3B;AACF;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aACE;AAAA,MAGF,YAAY;AAAA,MACZ,aAAa,EAAE,QAAQ,WAAW;AAAA,MAClC,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,eAAe,CAAC;AAAA,MAChF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,0BAA0B;AAAA,QACtD,EAAE,QAAQ,KAAK,aAAa,wBAAwB;AAAA,QACpD,EAAE,QAAQ,KAAK,aAAa,yBAAyB;AAAA,MACvD;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/billing/api/runs/[id]/route.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { runCommandRoute } from "../../../lib/commandRoute.js";
+const metadata = {
+  DELETE: { requireAuth: true, requireFeatures: ["billing.run.delete"] }
+};
+const paramsSchema = z.object({ id: z.string().uuid() });
+const emptyBodySchema = z.object({}).passthrough();
+const deleteResponseSchema = z.object({
+  ok: z.literal(true),
+  invoicesRemoved: z.number().int().nonnegative()
+});
+async function DELETE(req, { params }) {
+  const parsedParams = paramsSchema.safeParse(await params);
+  if (!parsedParams.success) {
+    return Response.json({ error: "Invalid Bill Run id", code: "billing.request.invalid" }, { status: 400 });
+  }
+  const billRunId = parsedParams.data.id;
+  return runCommandRoute(
+    req,
+    {
+      commandId: "billing.runs.delete",
+      bodySchema: emptyBodySchema,
+      resourceKind: "billing.bill_run",
+      resourceId: () => billRunId,
+      operation: "delete",
+      toInput: (_body, scope) => ({ ...scope, billRunId }),
+      logLabel: "billing/runs/[id].DELETE"
+    },
+    {}
+  );
+}
+const openApi = {
+  methods: {
+    DELETE: {
+      tags: ["Billing"],
+      summary: "Delete a test or dry Bill Run",
+      description: "Hard-deletes a test or dry-run Bill Run, its outcomes and the test invoices it wrote (with lines and draft-edit audit rows). Retry runs that point at it keep existing with their parent link cleared. Real runs are never deleted.",
+      pathParams: paramsSchema,
+      responses: [{ status: 200, description: "Deleted", schema: deleteResponseSchema }],
+      errors: [
+        { status: 404, description: "`billing.run.not_found`" },
+        { status: 409, description: "`billing.run.running`" },
+        { status: 422, description: "`billing.run.delete_real_forbidden`" }
+      ]
+    }
+  }
+};
+export {
+  DELETE,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/runs/[id]/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/runs/%5Bid%5D/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport { runCommandRoute } from '../../../lib/commandRoute'\n\n/**\n * `DELETE /api/billing/runs/{id}` \u2014 delete a TEST or DRY Bill Run with its\n * test invoices and outcomes (Spec F, F-D1). Real runs are refused (422).\n */\n\nexport const metadata = {\n  DELETE: { requireAuth: true, requireFeatures: ['billing.run.delete'] },\n}\n\nconst paramsSchema = z.object({ id: z.string().uuid() })\nconst emptyBodySchema = z.object({}).passthrough()\n\nconst deleteResponseSchema = z.object({\n  ok: z.literal(true),\n  invoicesRemoved: z.number().int().nonnegative(),\n})\n\nexport async function DELETE(req: Request, { params }: { params: Promise<{ id: string }> }) {\n  const parsedParams = paramsSchema.safeParse(await params)\n  if (!parsedParams.success) {\n    return Response.json({ error: 'Invalid Bill Run id', code: 'billing.request.invalid' }, { status: 400 })\n  }\n  const billRunId = parsedParams.data.id\n  return runCommandRoute(\n    req,\n    {\n      commandId: 'billing.runs.delete',\n      bodySchema: emptyBodySchema,\n      resourceKind: 'billing.bill_run',\n      resourceId: () => billRunId,\n      operation: 'delete',\n      toInput: (_body, scope) => ({ ...scope, billRunId }),\n      logLabel: 'billing/runs/[id].DELETE',\n    },\n    {},\n  )\n}\n\nexport const openApi = {\n  methods: {\n    DELETE: {\n      tags: ['Billing'],\n      summary: 'Delete a test or dry Bill Run',\n      description:\n        'Hard-deletes a test or dry-run Bill Run, its outcomes and the test invoices it wrote (with lines and draft-edit audit rows). ' +\n        'Retry runs that point at it keep existing with their parent link cleared. Real runs are never deleted.',\n      pathParams: paramsSchema,\n      responses: [{ status: 200, description: 'Deleted', schema: deleteResponseSchema }],\n      errors: [\n        { status: 404, description: '`billing.run.not_found`' },\n        { status: 409, description: '`billing.run.running`' },\n        { status: 422, description: '`billing.run.delete_real_forbidden`' },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AAOzB,MAAM,WAAW;AAAA,EACtB,QAAQ,EAAE,aAAa,MAAM,iBAAiB,CAAC,oBAAoB,EAAE;AACvE;AAEA,MAAM,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACvD,MAAM,kBAAkB,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAEjD,MAAM,uBAAuB,EAAE,OAAO;AAAA,EACpC,IAAI,EAAE,QAAQ,IAAI;AAAA,EAClB,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAChD,CAAC;AAED,eAAsB,OAAO,KAAc,EAAE,OAAO,GAAwC;AAC1F,QAAM,eAAe,aAAa,UAAU,MAAM,MAAM;AACxD,MAAI,CAAC,aAAa,SAAS;AACzB,WAAO,SAAS,KAAK,EAAE,OAAO,uBAAuB,MAAM,0BAA0B,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACzG;AACA,QAAM,YAAY,aAAa,KAAK;AACpC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,MAClB,WAAW;AAAA,MACX,SAAS,CAAC,OAAO,WAAW,EAAE,GAAG,OAAO,UAAU;AAAA,MAClD,UAAU;AAAA,IACZ;AAAA,IACA,CAAC;AAAA,EACH;AACF;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,QAAQ;AAAA,MACN,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aACE;AAAA,MAEF,YAAY;AAAA,MACZ,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,WAAW,QAAQ,qBAAqB,CAAC;AAAA,MACjF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,0BAA0B;AAAA,QACtD,EAAE,QAAQ,KAAK,aAAa,wBAAwB;AAAA,QACpD,EAAE,QAAQ,KAAK,aAAa,sCAAsC;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/billing/api/runs/retry-failed/route.js

@@ -59,7 +59,7 @@ const openApi = createBillingCrudOpenApi({
   create: {
     schema: billingRunRetryFailedSchema,
     responseSchema: retryResponseSchema,
-    description: "Re-runs the failed accounts of an earlier Bill Run. The new run inherits the parent run's `asOfDate` and `catchUp` flag; its `parent_run_id` points back at the source. Returns 409 if there are no failed outcomes or if another run is in flight."
+    description: "Re-runs the failed accounts of an earlier Bill Run. The new run inherits the parent run's `asOfDate` (and, like every run, bills all due cycles up to it); its `parent_run_id` points back at the source. Returns 409 if there are no failed outcomes or if another run is in flight."
   }
 });
 export {

package/dist/modules/billing/api/runs/retry-failed/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/billing/api/runs/retry-failed/route.ts"],
-  "sourcesContent": ["import { z } from 'zod'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingRun } from '../../../data/entities'\nimport { billingEntityIds } from '../../../data/entityIds'\nimport { billingRunRetryFailedSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\n\n/**\n * `POST /api/billing/runs/retry-failed`\n *\n * Creates a new Bill Run scoped to the failed-account ids from a parent\n * run, with `parent_run_id` set on the new run so the retry chain is\n * traceable. Returns the new run's id + status + outcomes count.\n *\n * Implemented as a \"create-only\" `makeCrudRoute` so the framework's\n * RBAC + OpenAPI + command-bus plumbing stays consistent with the rest\n * of the billing surface. The list/get half of the factory is never\n * exercised on this URL \u2014 only POST is exported.\n */\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.run.trigger'] },\n}\n\nexport const metadata = routeMetadata\n\nconst retryResponseSchema = z.object({\n  billRunId: z.string().uuid(),\n  status: z.string(),\n  outcomesCount: z.number().int().nonnegative(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRun,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  // No `list` \u2014 POST-only route. Keep a stub so the factory type-checks.\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.run,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.runs.retry_failed',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingRunRetryFailedSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        billRunId: result?.billRunId ?? null,\n        status: result?.status ?? null,\n        outcomesCount: result?.outcomesCount ?? 0,\n      }),\n      status: 201,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRunRetry',\n  pluralName: 'BillRunRetries',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingRunRetryFailedSchema,\n    responseSchema: retryResponseSchema,\n    description:\n      'Re-runs the failed accounts of an earlier Bill Run. The new run ' +\n      'inherits the parent run\\'s `asOfDate` and `catchUp` flag; its ' +\n      '`parent_run_id` points back at the source. Returns 409 if there ' +\n      'are no failed outcomes or if another run is in flight.',\n  },\n})\n"],
-  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AACjC,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AAezC,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,qBAAqB,EAAE;AACtE;AAEO,MAAM,WAAW;AAExB,MAAM,sBAAsB,EAAE,OAAO;AAAA,EACnC,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,EAC3B,QAAQ,EAAE,OAAO;AAAA,EACjB,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAC9C,CAAC;AAED,MAAM,gBAAgB,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAE/C,MAAM,OAAO,cAAc;AAAA,EACzB,UAAU;AAAA,EACV,KAAK;AAAA,IACH,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,UAAU;AAAA,IACV,aAAa;AAAA,IACb,iBAAiB;AAAA,EACnB;AAAA;AAAA,EAEA,MAAM;AAAA,IACJ,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAAA,IACjC,UAAU,iBAAiB;AAAA,IAC3B,QAAQ,CAAC,IAAI;AAAA,IACb,cAAc,aAAa,CAAC;AAAA,EAC9B;AAAA,EACA,SAAS;AAAA,IACP,QAAQ;AAAA,MACN,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,UAAU,OAAO,EAAE,KAAK,IAAI,MAAM;AAChC,cAAM,EAAE,UAAU,IAAI,MAAM,oBAAoB;AAChD,cAAM,SAAS,kBAAkB,OAAO,CAAC,GAAG,KAAK,SAAS;AAC1D,eAAO,4BAA4B,MAAM,MAAM;AAAA,MACjD;AAAA,MACA,UAAU,CAAC,EAAE,OAAO,OAAO;AAAA,QACzB,WAAW,QAAQ,aAAa;AAAA,QAChC,QAAQ,QAAQ,UAAU;AAAA,QAC1B,eAAe,QAAQ,iBAAiB;AAAA,MAC1C;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAEM,MAAM,OAAO,KAAK;AAElB,MAAM,UAAU,yBAAyB;AAAA,EAC9C,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAAA,EACtC,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;AAAA,EAC5D,QAAQ;AAAA,IACN,QAAQ;AAAA,IACR,gBAAgB;AAAA,IAChB,aACE;AAAA,EAIJ;AACF,CAAC;",
+  "sourcesContent": ["import { z } from 'zod'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingRun } from '../../../data/entities'\nimport { billingEntityIds } from '../../../data/entityIds'\nimport { billingRunRetryFailedSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\n\n/**\n * `POST /api/billing/runs/retry-failed`\n *\n * Creates a new Bill Run scoped to the failed-account ids from a parent\n * run, with `parent_run_id` set on the new run so the retry chain is\n * traceable. Returns the new run's id + status + outcomes count.\n *\n * Implemented as a \"create-only\" `makeCrudRoute` so the framework's\n * RBAC + OpenAPI + command-bus plumbing stays consistent with the rest\n * of the billing surface. The list/get half of the factory is never\n * exercised on this URL \u2014 only POST is exported.\n */\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.run.trigger'] },\n}\n\nexport const metadata = routeMetadata\n\nconst retryResponseSchema = z.object({\n  billRunId: z.string().uuid(),\n  status: z.string(),\n  outcomesCount: z.number().int().nonnegative(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRun,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  // No `list` \u2014 POST-only route. Keep a stub so the factory type-checks.\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.run,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.runs.retry_failed',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingRunRetryFailedSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        billRunId: result?.billRunId ?? null,\n        status: result?.status ?? null,\n        outcomesCount: result?.outcomesCount ?? 0,\n      }),\n      status: 201,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRunRetry',\n  pluralName: 'BillRunRetries',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingRunRetryFailedSchema,\n    responseSchema: retryResponseSchema,\n    description:\n      'Re-runs the failed accounts of an earlier Bill Run. The new run ' +\n      'inherits the parent run\\'s `asOfDate` (and, like every run, bills all due ' +\n      'cycles up to it); its ' +\n      '`parent_run_id` points back at the source. Returns 409 if there ' +\n      'are no failed outcomes or if another run is in flight.',\n  },\n})\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AACjC,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AAezC,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,qBAAqB,EAAE;AACtE;AAEO,MAAM,WAAW;AAExB,MAAM,sBAAsB,EAAE,OAAO;AAAA,EACnC,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,EAC3B,QAAQ,EAAE,OAAO;AAAA,EACjB,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAC9C,CAAC;AAED,MAAM,gBAAgB,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAE/C,MAAM,OAAO,cAAc;AAAA,EACzB,UAAU;AAAA,EACV,KAAK;AAAA,IACH,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,UAAU;AAAA,IACV,aAAa;AAAA,IACb,iBAAiB;AAAA,EACnB;AAAA;AAAA,EAEA,MAAM;AAAA,IACJ,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAAA,IACjC,UAAU,iBAAiB;AAAA,IAC3B,QAAQ,CAAC,IAAI;AAAA,IACb,cAAc,aAAa,CAAC;AAAA,EAC9B;AAAA,EACA,SAAS;AAAA,IACP,QAAQ;AAAA,MACN,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,UAAU,OAAO,EAAE,KAAK,IAAI,MAAM;AAChC,cAAM,EAAE,UAAU,IAAI,MAAM,oBAAoB;AAChD,cAAM,SAAS,kBAAkB,OAAO,CAAC,GAAG,KAAK,SAAS;AAC1D,eAAO,4BAA4B,MAAM,MAAM;AAAA,MACjD;AAAA,MACA,UAAU,CAAC,EAAE,OAAO,OAAO;AAAA,QACzB,WAAW,QAAQ,aAAa;AAAA,QAChC,QAAQ,QAAQ,UAAU;AAAA,QAC1B,eAAe,QAAQ,iBAAiB;AAAA,MAC1C;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAEM,MAAM,OAAO,KAAK;AAElB,MAAM,UAAU,yBAAyB;AAAA,EAC9C,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY;AAAA,EACtC,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;AAAA,EAC5D,QAAQ;AAAA,IACN,QAAQ;AAAA,IACR,gBAAgB;AAAA,IAChB,aACE;AAAA,EAKJ;AACF,CAAC;",
   "names": []
 }

package/dist/modules/billing/api/runs/route.js

@@ -20,7 +20,6 @@ const billRunListItemSchema = z.object({
   parent_run_id: z.string().uuid().nullable(),
   dry_run: z.boolean(),
   test_mode: z.boolean(),
-  catch_up: z.boolean(),
   scoped_account_ids: z.array(z.string().uuid()).nullable(),
   as_of_date: z.string(),
   started_at: z.string().nullable(),
@@ -56,7 +55,6 @@ const crud = makeCrudRoute({
       "parent_run_id",
       "dry_run",
       "test_mode",
-      "catch_up",
       "scoped_account_ids",
       "as_of_date",
       "started_at",
@@ -85,6 +83,14 @@ const crud = makeCrudRoute({
       if (typeof query.status === "string") filters.status = { $eq: query.status };
       if (typeof query.triggeredBy === "string") filters.triggered_by = { $eq: query.triggeredBy };
       if (typeof query.parentRunId === "string") filters.parent_run_id = { $eq: query.parentRunId };
+      if (query.mode === "real") {
+        filters.dry_run = { $eq: false };
+        filters.test_mode = { $eq: false };
+      } else if (query.mode === "test") {
+        filters.test_mode = { $eq: true };
+      } else if (query.mode === "dry") {
+        filters.dry_run = { $eq: true };
+      }
       if (query.asOfDateFrom instanceof Date) {
         filters.as_of_date = Object.assign(
           filters.as_of_date ?? {},
@@ -131,7 +137,7 @@ const openApi = createBillingCrudOpenApi({
   create: {
     schema: billingRunTriggerSchema,
     responseSchema: triggerResponseSchema,
-    description: "Triggers a Bill Run. `mode=real` (default) persists drafts and advances state; `mode=test` persists test-flagged drafts without advancing state; `mode=dry` computes everything in memory and persists nothing. Returns HTTP 409 (`billing.run.lock_busy`) when another run is in flight for the same tenant."
+    description: "Triggers a Bill Run. Every run bills **all due cycles** up to `asOfDate` \u2014 one draft invoice per bill date (no catch-up flag; a legacy `catchUp` field is ignored). `mode=real` (default) persists drafts and advances state; `mode=test` persists test-flagged drafts for every cycle without advancing state; `mode=dry` simulates every cycle in memory and persists nothing. Per-cycle results are on each outcome's `cycles`. Returns HTTP 409 (`billing.run.lock_busy`) when another run is in flight for the same tenant."
   }
 });
 export {

package/dist/modules/billing/api/runs/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/billing/api/runs/route.ts"],
-  "sourcesContent": ["import { z } from 'zod'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingRun } from '../../data/entities'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  billingRunListQuerySchema,\n  billingRunTriggerSchema,\n} from '../../data/validators'\nimport { createBillingCrudOpenApi, createPagedListResponseSchema } from '../openapi'\n\n/**\n * `/api/billing/runs` \u2014 GET (history list) + POST (manual trigger).\n *\n * The triggered-by enum gate:\n *   - `trigger` feature is required for `real` mode (which mutates\n *     production state).\n *   - `dry_run` feature alone is enough for `mode=dry` (finance auditor\n *     persona). The route-level RBAC check on POST requires `trigger`,\n *     so dry-run callers must hold both `dry_run` AND `trigger` here \u2014\n *     a deliberate tightening over what the spec persona table suggests.\n *\n *   If we ever want auditors to drive dry-runs without holding `trigger`,\n *   we split into two routes (POST `/runs` for real, POST `/runs/dry` for\n *   dry). Postponed until an operator actually asks.\n */\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.run.view'] },\n  POST: { requireAuth: true, requireFeatures: ['billing.run.trigger'] },\n}\n\nexport const metadata = routeMetadata\n\n// The list endpoint projects raw column names \u2014 snake_case.\nconst billRunListItemSchema = z.object({\n  id: z.string().uuid(),\n  triggered_by: z.string(),\n  parent_run_id: z.string().uuid().nullable(),\n  dry_run: z.boolean(),\n  test_mode: z.boolean(),\n  catch_up: z.boolean(),\n  scoped_account_ids: z.array(z.string().uuid()).nullable(),\n  as_of_date: z.string(),\n  started_at: z.string().nullable(),\n  finished_at: z.string().nullable(),\n  status: z.string(),\n  summary: z.record(z.string(), z.unknown()).nullable(),\n  organization_id: z.string().uuid(),\n  tenant_id: z.string().uuid(),\n  created_at: z.string(),\n  updated_at: z.string(),\n})\n\nconst triggerResponseSchema = z.object({\n  billRunId: z.string().uuid(),\n  status: z.string(),\n  outcomesCount: z.number().int().nonnegative(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRun,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: billingRunListQuerySchema,\n    entityId: billingEntityIds.run,\n    fields: [\n      'id',\n      'triggered_by',\n      'parent_run_id',\n      'dry_run',\n      'test_mode',\n      'catch_up',\n      'scoped_account_ids',\n      'as_of_date',\n      'started_at',\n      'finished_at',\n      'status',\n      'summary',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      startedAt: 'started_at',\n      finishedAt: 'finished_at',\n      asOfDate: 'as_of_date',\n      createdAt: 'created_at',\n    },\n    buildFilters: async (query) => {\n      const filters: Record<string, unknown> = {}\n      // `?id=<uuid>` narrows the list to one row \u2014 the detail page\n      // reads a single Bill Run through this filter.\n      if (typeof query.id === 'string' && query.id) {\n        filters.id = { $eq: query.id }\n      }\n      // Run ids are UUIDs \u2014 search matches a pasted id exactly.\n      if (typeof query.search === 'string' && /^[0-9a-fA-F-]{36}$/.test(query.search.trim())) {\n        filters.id = { $eq: query.search.trim() }\n      }\n      if (typeof query.status === 'string') filters.status = { $eq: query.status }\n      if (typeof query.triggeredBy === 'string') filters.triggered_by = { $eq: query.triggeredBy }\n      if (typeof query.parentRunId === 'string') filters.parent_run_id = { $eq: query.parentRunId }\n      if (query.asOfDateFrom instanceof Date) {\n        filters.as_of_date = Object.assign(\n          (filters.as_of_date as Record<string, unknown>) ?? {},\n          { $gte: query.asOfDateFrom },\n        )\n      }\n      if (query.asOfDateTo instanceof Date) {\n        filters.as_of_date = Object.assign(\n          (filters.as_of_date as Record<string, unknown>) ?? {},\n          { $lte: query.asOfDateTo },\n        )\n      }\n      return filters\n    },\n  },\n  actions: {\n    create: {\n      commandId: 'billing.runs.trigger',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingRunTriggerSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        billRunId: result?.billRunId ?? null,\n        status: result?.status ?? null,\n        outcomesCount: result?.outcomesCount ?? 0,\n      }),\n      status: 201,\n    },\n    // Runs are append-only \u2014 no update / delete on this surface. A\n    // failed run is corrected by triggering a `retry-failed` (separate\n    // route).\n  },\n})\n\nconst { POST } = crud\nexport { POST }\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRun',\n  pluralName: 'BillRuns',\n  querySchema: billingRunListQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billRunListItemSchema),\n  create: {\n    schema: billingRunTriggerSchema,\n    responseSchema: triggerResponseSchema,\n    description:\n      'Triggers a Bill Run. `mode=real` (default) persists drafts and ' +\n      'advances state; `mode=test` persists test-flagged drafts without ' +\n      'advancing state; `mode=dry` computes everything in memory and ' +\n      'persists nothing. Returns HTTP 409 (`billing.run.lock_busy`) when ' +\n      'another run is in flight for the same tenant.',\n  },\n})\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { z } from 'zod'\nimport { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingRun } from '../../data/entities'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  billingRunListQuerySchema,\n  billingRunTriggerSchema,\n} from '../../data/validators'\nimport { createBillingCrudOpenApi, createPagedListResponseSchema } from '../openapi'\n\n/**\n * `/api/billing/runs` \u2014 GET (history list) + POST (manual trigger).\n *\n * The triggered-by enum gate:\n *   - `trigger` feature is required for `real` mode (which mutates\n *     production state).\n *   - `dry_run` feature alone is enough for `mode=dry` (finance auditor\n *     persona). The route-level RBAC check on POST requires `trigger`,\n *     so dry-run callers must hold both `dry_run` AND `trigger` here \u2014\n *     a deliberate tightening over what the spec persona table suggests.\n *\n *   If we ever want auditors to drive dry-runs without holding `trigger`,\n *   we split into two routes (POST `/runs` for real, POST `/runs/dry` for\n *   dry). Postponed until an operator actually asks.\n */\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.run.view'] },\n  POST: { requireAuth: true, requireFeatures: ['billing.run.trigger'] },\n}\n\nexport const metadata = routeMetadata\n\n// The list endpoint projects raw column names \u2014 snake_case.\nconst billRunListItemSchema = z.object({\n  id: z.string().uuid(),\n  triggered_by: z.string(),\n  parent_run_id: z.string().uuid().nullable(),\n  dry_run: z.boolean(),\n  test_mode: z.boolean(),\n  scoped_account_ids: z.array(z.string().uuid()).nullable(),\n  as_of_date: z.string(),\n  started_at: z.string().nullable(),\n  finished_at: z.string().nullable(),\n  status: z.string(),\n  summary: z.record(z.string(), z.unknown()).nullable(),\n  organization_id: z.string().uuid(),\n  tenant_id: z.string().uuid(),\n  created_at: z.string(),\n  updated_at: z.string(),\n})\n\nconst triggerResponseSchema = z.object({\n  billRunId: z.string().uuid(),\n  status: z.string(),\n  outcomesCount: z.number().int().nonnegative(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingRun,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: billingRunListQuerySchema,\n    entityId: billingEntityIds.run,\n    fields: [\n      'id',\n      'triggered_by',\n      'parent_run_id',\n      'dry_run',\n      'test_mode',\n      'scoped_account_ids',\n      'as_of_date',\n      'started_at',\n      'finished_at',\n      'status',\n      'summary',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      startedAt: 'started_at',\n      finishedAt: 'finished_at',\n      asOfDate: 'as_of_date',\n      createdAt: 'created_at',\n    },\n    buildFilters: async (query) => {\n      const filters: Record<string, unknown> = {}\n      // `?id=<uuid>` narrows the list to one row \u2014 the detail page\n      // reads a single Bill Run through this filter.\n      if (typeof query.id === 'string' && query.id) {\n        filters.id = { $eq: query.id }\n      }\n      // Run ids are UUIDs \u2014 search matches a pasted id exactly.\n      if (typeof query.search === 'string' && /^[0-9a-fA-F-]{36}$/.test(query.search.trim())) {\n        filters.id = { $eq: query.search.trim() }\n      }\n      if (typeof query.status === 'string') filters.status = { $eq: query.status }\n      if (typeof query.triggeredBy === 'string') filters.triggered_by = { $eq: query.triggeredBy }\n      if (typeof query.parentRunId === 'string') filters.parent_run_id = { $eq: query.parentRunId }\n      if (query.mode === 'real') {\n        filters.dry_run = { $eq: false }\n        filters.test_mode = { $eq: false }\n      } else if (query.mode === 'test') {\n        filters.test_mode = { $eq: true }\n      } else if (query.mode === 'dry') {\n        filters.dry_run = { $eq: true }\n      }\n      if (query.asOfDateFrom instanceof Date) {\n        filters.as_of_date = Object.assign(\n          (filters.as_of_date as Record<string, unknown>) ?? {},\n          { $gte: query.asOfDateFrom },\n        )\n      }\n      if (query.asOfDateTo instanceof Date) {\n        filters.as_of_date = Object.assign(\n          (filters.as_of_date as Record<string, unknown>) ?? {},\n          { $lte: query.asOfDateTo },\n        )\n      }\n      return filters\n    },\n  },\n  actions: {\n    create: {\n      commandId: 'billing.runs.trigger',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingRunTriggerSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        billRunId: result?.billRunId ?? null,\n        status: result?.status ?? null,\n        outcomesCount: result?.outcomesCount ?? 0,\n      }),\n      status: 201,\n    },\n    // Runs are append-only \u2014 no update / delete on this surface. A\n    // failed run is corrected by triggering a `retry-failed` (separate\n    // route).\n  },\n})\n\nconst { POST } = crud\nexport { POST }\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillRun',\n  pluralName: 'BillRuns',\n  querySchema: billingRunListQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billRunListItemSchema),\n  create: {\n    schema: billingRunTriggerSchema,\n    responseSchema: triggerResponseSchema,\n    description:\n      'Triggers a Bill Run. Every run bills **all due cycles** up to `asOfDate` \u2014 one ' +\n      'draft invoice per bill date (no catch-up flag; a legacy `catchUp` field is ignored). ' +\n      '`mode=real` (default) persists drafts and advances state; `mode=test` persists ' +\n      'test-flagged drafts for every cycle without advancing state; `mode=dry` simulates ' +\n      'every cycle in memory and persists nothing. Per-cycle results are on each outcome\\'s ' +\n      '`cycles`. Returns HTTP 409 (`billing.run.lock_busy`) when another run is in flight ' +\n      'for the same tenant.',\n  },\n})\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/api/settings/number-preview/route.js

@@ -0,0 +1,42 @@
+import { NextResponse } from "next/server";
+import { z } from "zod";
+import { getAuthFromRequest } from "@open-mercato/shared/lib/auth/server";
+import { DOCUMENT_SERIES, renderNumber, sequenceScopeKey, validateMask } from "../../../lib/numbering.js";
+const metadata = {
+  GET: { requireAuth: true, requireFeatures: ["billing.settings.view"] }
+};
+const querySchema = z.object({ mask: z.string().max(200), series: z.enum(DOCUMENT_SERIES).optional() });
+async function GET(req) {
+  const auth = await getAuthFromRequest(req);
+  if (!auth || !auth.tenantId) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+  const parsed = querySchema.safeParse(Object.fromEntries(new URL(req.url).searchParams.entries()));
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Invalid query" }, { status: 400 });
+  }
+  const errors = validateMask(parsed.data.mask);
+  if (errors.length > 0) return NextResponse.json({ valid: false, errors });
+  const today = /* @__PURE__ */ new Date();
+  return NextResponse.json({
+    valid: true,
+    errors: [],
+    example: renderNumber(parsed.data.mask, { seq: 1, issueDate: today }),
+    scopeKey: sequenceScopeKey(parsed.data.mask, today)
+  });
+}
+const openApi = {
+  methods: {
+    GET: {
+      tags: ["Billing"],
+      summary: "Preview a document number mask",
+      description: "Validates a number mask and returns an example number for today and its counter scope."
+    }
+  }
+};
+export {
+  GET,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/settings/number-preview/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/settings/number-preview/route.ts"],
+  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\nimport { DOCUMENT_SERIES, renderNumber, sequenceScopeKey, validateMask } from '../../../lib/numbering'\n\n/**\n * `GET /api/billing/settings/number-preview?mask=\u2026` \u2014 validates a number\n * mask and renders an example for today (sequence 1) plus the counter scope\n * it would use. Pure: no sequence is read or claimed.\n */\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.settings.view'] },\n}\n\nconst querySchema = z.object({ mask: z.string().max(200), series: z.enum(DOCUMENT_SERIES).optional() })\n\nexport async function GET(req: Request) {\n  const auth = await getAuthFromRequest(req)\n  if (!auth || !auth.tenantId) {\n    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n  }\n  const parsed = querySchema.safeParse(Object.fromEntries(new URL(req.url).searchParams.entries()))\n  if (!parsed.success) {\n    return NextResponse.json({ error: 'Invalid query' }, { status: 400 })\n  }\n  const errors = validateMask(parsed.data.mask)\n  if (errors.length > 0) return NextResponse.json({ valid: false, errors })\n  const today = new Date()\n  return NextResponse.json({\n    valid: true,\n    errors: [],\n    example: renderNumber(parsed.data.mask, { seq: 1, issueDate: today }),\n    scopeKey: sequenceScopeKey(parsed.data.mask, today),\n  })\n}\n\nexport const openApi = {\n  methods: {\n    GET: {\n      tags: ['Billing'],\n      summary: 'Preview a document number mask',\n      description: 'Validates a number mask and returns an example number for today and its counter scope.',\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAClB,SAAS,0BAA0B;AACnC,SAAS,iBAAiB,cAAc,kBAAkB,oBAAoB;AAQvE,MAAM,WAAW;AAAA,EACtB,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,uBAAuB,EAAE;AACvE;AAEA,MAAM,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,GAAG,QAAQ,EAAE,KAAK,eAAe,EAAE,SAAS,EAAE,CAAC;AAEtG,eAAsB,IAAI,KAAc;AACtC,QAAM,OAAO,MAAM,mBAAmB,GAAG;AACzC,MAAI,CAAC,QAAQ,CAAC,KAAK,UAAU;AAC3B,WAAO,aAAa,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACrE;AACA,QAAM,SAAS,YAAY,UAAU,OAAO,YAAY,IAAI,IAAI,IAAI,GAAG,EAAE,aAAa,QAAQ,CAAC,CAAC;AAChG,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO,aAAa,KAAK,EAAE,OAAO,gBAAgB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACtE;AACA,QAAM,SAAS,aAAa,OAAO,KAAK,IAAI;AAC5C,MAAI,OAAO,SAAS,EAAG,QAAO,aAAa,KAAK,EAAE,OAAO,OAAO,OAAO,CAAC;AACxE,QAAM,QAAQ,oBAAI,KAAK;AACvB,SAAO,aAAa,KAAK;AAAA,IACvB,OAAO;AAAA,IACP,QAAQ,CAAC;AAAA,IACT,SAAS,aAAa,OAAO,KAAK,MAAM,EAAE,KAAK,GAAG,WAAW,MAAM,CAAC;AAAA,IACpE,UAAU,iBAAiB,OAAO,KAAK,MAAM,KAAK;AAAA,EACpD,CAAC;AACH;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,KAAK;AAAA,MACH,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,EACF;AACF;",
+  "names": []
+}