@dainamite/billing 0.19.0 → 0.21.0

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

@@ -0,0 +1,114 @@
+import { NextResponse } from "next/server";
+import { z } from "zod";
+import { createRequestContainer } from "@open-mercato/shared/lib/di/container";
+import { getAuthFromRequest } from "@open-mercato/shared/lib/auth/server";
+import {
+  organizationScopeRequiredResponse,
+  resolveActiveOrganizationId
+} from "@open-mercato/shared/lib/auth/organizationScope";
+import { buildQueryParams } from "@open-mercato/shared/lib/crud/query-params";
+import { billingPaymentListQuerySchema } from "../../data/validators.js";
+import { runCommandRoute } from "../../lib/commandRoute.js";
+const metadata = {
+  GET: { requireAuth: true, requireFeatures: ["billing.payment.view"] },
+  POST: { requireAuth: true, requireFeatures: ["billing.payment.manage"] }
+};
+async function GET(req) {
+  try {
+    const container = await createRequestContainer();
+    const auth = await getAuthFromRequest(req);
+    if (!auth || !auth.tenantId) return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+    const organizationId = resolveActiveOrganizationId(auth);
+    if (!organizationId) return organizationScopeRequiredResponse();
+    const query = billingPaymentListQuerySchema.parse(buildQueryParams(new URL(req.url).searchParams));
+    const em = container.resolve("em").fork();
+    const where = ["p.tenant_id = ?", "p.organization_id = ?", "p.deleted_at IS NULL"];
+    const params = [auth.tenantId, organizationId];
+    const filters = [
+      [query.id, "p.id = ?"],
+      [query.status, "p.status = ?"],
+      [query.billAccountId, "p.bill_account_id = ?"],
+      [query.importId, "p.import_id = ?"],
+      [query.receivedFrom, "p.received_at >= ?::date"],
+      [query.receivedTo, "p.received_at <= ?::date"]
+    ];
+    for (const [value, clause] of filters) {
+      if (value === void 0 || value === null || value === "") continue;
+      where.push(clause);
+      params.push(value);
+    }
+    if (query.search) {
+      const like = `%${query.search.replace(/[%_\\]/g, (m) => `\\${m}`)}%`;
+      where.push("(p.reference ILIKE ? OR p.payer_name ILIKE ? OR p.payer_account ILIKE ?)");
+      params.push(like, like, like);
+    }
+    const whereSql = where.join(" AND ");
+    const totalRows = await em.execute(`SELECT COUNT(*)::int AS total FROM billing_payments p WHERE ${whereSql}`, params);
+    const total = totalRows?.[0]?.total ?? 0;
+    const items = await em.execute(
+      `SELECT p.id, p.received_at, p.amount, p.currency_code, p.reference, p.payer_name, p.payer_account, p.source,
+              p.import_id, p.bill_account_id, a.name AS bill_account_name, p.status, p.unallocated_amount,
+              p.match_reason, p.topup_id, p.created_at
+         FROM billing_payments p
+         LEFT JOIN billing_accounts a ON a.id = p.bill_account_id AND a.tenant_id = p.tenant_id
+        WHERE ${whereSql}
+        ORDER BY p.received_at DESC, p.created_at DESC
+        LIMIT ? OFFSET ?`,
+      [...params, query.pageSize, (query.page - 1) * query.pageSize]
+    );
+    return NextResponse.json({
+      items,
+      total,
+      page: query.page,
+      pageSize: query.pageSize,
+      totalPages: total === 0 ? 1 : Math.ceil(total / query.pageSize)
+    });
+  } catch (err) {
+    if (err instanceof z.ZodError) return NextResponse.json({ error: "Invalid query", issues: err.issues }, { status: 400 });
+    console.error("[billing/payments.GET]", err);
+    return NextResponse.json({ error: "Internal error" }, { status: 500 });
+  }
+}
+const createBodySchema = z.object({
+  receivedAt: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  amount: z.coerce.number().positive(),
+  currencyCode: z.string().trim().length(3),
+  reference: z.string().trim().max(500).optional(),
+  payerName: z.string().trim().max(255).optional(),
+  payerAccount: z.string().trim().max(64).optional(),
+  billAccountId: z.string().uuid().optional()
+});
+async function POST(req) {
+  return runCommandRoute(req, {
+    commandId: "billing.payments.create",
+    bodySchema: createBodySchema,
+    resourceKind: "billing.payment",
+    resourceId: () => null,
+    logLabel: "billing/payments.POST"
+  });
+}
+const openApi = {
+  methods: {
+    GET: {
+      tags: ["Billing"],
+      summary: "List billing payments",
+      description: "Payment register (bank CSV lines, manual entries, gateway captures). Filters: status (`unmatched | matched | partially_allocated | allocated | ignored | converted_to_topup`), billAccountId, importId, receivedFrom / receivedTo (YYYY-MM-DD), search (reference, payer). pageSize \u2264 100.",
+      query: billingPaymentListQuerySchema
+    },
+    POST: {
+      tags: ["Billing"],
+      summary: "Record a payment manually",
+      description: "Creates a manual payment. With `billAccountId` it is matched and applied as credit to the account's open invoices (oldest due first); otherwise it stays unmatched.",
+      requestBody: { schema: createBodySchema },
+      responses: [{ status: 200, description: "`{ paymentId, status, unallocatedAmount }`" }],
+      errors: [{ status: 409, description: "`billing.payment.currency_mismatch`" }]
+    }
+  }
+};
+export {
+  GET,
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/billing/api/payments/route.ts"],
+  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\nimport {\n  organizationScopeRequiredResponse,\n  resolveActiveOrganizationId,\n} from '@open-mercato/shared/lib/auth/organizationScope'\nimport { buildQueryParams } from '@open-mercato/shared/lib/crud/query-params'\nimport { billingPaymentListQuerySchema } from '../../data/validators'\nimport { runCommandRoute } from '../../lib/commandRoute'\n\n/**\n * `GET /api/billing/payments` \u2014 the payment register (Spec C), newest first.\n * Filters: status, billAccountId, importId, receivedFrom / receivedTo,\n * search (reference / payer name / payer account). Rows carry the account\n * name (joined). Hand-written SQL like the invoice list.\n *\n * `POST /api/billing/payments` \u2014 manual payment entry (`billing.payments.create`).\n */\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.payment.view'] },\n  POST: { requireAuth: true, requireFeatures: ['billing.payment.manage'] },\n}\n\nexport type BillingPaymentRow = {\n  id: string\n  received_at: string\n  amount: string\n  currency_code: string\n  reference: string | null\n  payer_name: string | null\n  payer_account: string | null\n  source: string\n  import_id: string | null\n  bill_account_id: string | null\n  bill_account_name: string | null\n  status: string\n  unallocated_amount: string\n  match_reason: string | null\n  topup_id: string | null\n  created_at: string\n}\n\nexport async function GET(req: Request) {\n  try {\n    const container = await createRequestContainer()\n    const auth = await getAuthFromRequest(req)\n    if (!auth || !auth.tenantId) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n    const organizationId = resolveActiveOrganizationId(auth)\n    if (!organizationId) return organizationScopeRequiredResponse()\n    const query = billingPaymentListQuerySchema.parse(buildQueryParams(new URL(req.url).searchParams))\n    const em = (container.resolve('em') as EntityManager).fork()\n\n    const where: string[] = ['p.tenant_id = ?', 'p.organization_id = ?', 'p.deleted_at IS NULL']\n    const params: unknown[] = [auth.tenantId, organizationId]\n    const filters: Array<[unknown, string]> = [\n      [query.id, 'p.id = ?'],\n      [query.status, 'p.status = ?'],\n      [query.billAccountId, 'p.bill_account_id = ?'],\n      [query.importId, 'p.import_id = ?'],\n      [query.receivedFrom, 'p.received_at >= ?::date'],\n      [query.receivedTo, 'p.received_at <= ?::date'],\n    ]\n    for (const [value, clause] of filters) {\n      if (value === undefined || value === null || value === '') continue\n      where.push(clause)\n      params.push(value)\n    }\n    if (query.search) {\n      const like = `%${query.search.replace(/[%_\\\\]/g, (m) => `\\\\${m}`)}%`\n      where.push('(p.reference ILIKE ? OR p.payer_name ILIKE ? OR p.payer_account ILIKE ?)')\n      params.push(like, like, like)\n    }\n    const whereSql = where.join(' AND ')\n    const totalRows = (await em.execute(`SELECT COUNT(*)::int AS total FROM billing_payments p WHERE ${whereSql}`, params)) as unknown as Array<{ total: number }>\n    const total = totalRows?.[0]?.total ?? 0\n    const items = (await em.execute(\n      `SELECT p.id, p.received_at, p.amount, p.currency_code, p.reference, p.payer_name, p.payer_account, p.source,\n              p.import_id, p.bill_account_id, a.name AS bill_account_name, p.status, p.unallocated_amount,\n              p.match_reason, p.topup_id, p.created_at\n         FROM billing_payments p\n         LEFT JOIN billing_accounts a ON a.id = p.bill_account_id AND a.tenant_id = p.tenant_id\n        WHERE ${whereSql}\n        ORDER BY p.received_at DESC, p.created_at DESC\n        LIMIT ? OFFSET ?`,\n      [...params, query.pageSize, (query.page - 1) * query.pageSize],\n    )) as unknown as BillingPaymentRow[]\n    return NextResponse.json({\n      items,\n      total,\n      page: query.page,\n      pageSize: query.pageSize,\n      totalPages: total === 0 ? 1 : Math.ceil(total / query.pageSize),\n    })\n  } catch (err) {\n    if (err instanceof z.ZodError) return NextResponse.json({ error: 'Invalid query', issues: err.issues }, { status: 400 })\n    console.error('[billing/payments.GET]', err)\n    return NextResponse.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n\nconst createBodySchema = z.object({\n  receivedAt: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/),\n  amount: z.coerce.number().positive(),\n  currencyCode: z.string().trim().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  billAccountId: z.string().uuid().optional(),\n})\n\nexport async function POST(req: Request) {\n  return runCommandRoute(req, {\n    commandId: 'billing.payments.create',\n    bodySchema: createBodySchema,\n    resourceKind: 'billing.payment',\n    resourceId: () => null,\n    logLabel: 'billing/payments.POST',\n  })\n}\n\nexport const openApi = {\n  methods: {\n    GET: {\n      tags: ['Billing'],\n      summary: 'List billing payments',\n      description:\n        'Payment register (bank CSV lines, manual entries, gateway captures). Filters: status ' +\n        '(`unmatched | matched | partially_allocated | allocated | ignored | converted_to_topup`), billAccountId, ' +\n        'importId, receivedFrom / receivedTo (YYYY-MM-DD), search (reference, payer). pageSize \u2264 100.',\n      query: billingPaymentListQuerySchema,\n    },\n    POST: {\n      tags: ['Billing'],\n      summary: 'Record a payment manually',\n      description:\n        'Creates a manual payment. With `billAccountId` it is matched and applied as credit to the ' +\n        \"account's open invoices (oldest due first); otherwise it stays unmatched.\",\n      requestBody: { schema: createBodySchema },\n      responses: [{ status: 200, description: '`{ paymentId, status, unallocatedAmount }`' }],\n      errors: [{ status: 409, description: '`billing.payment.currency_mismatch`' }],\n    },\n  },\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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, BillRunOutcome } 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(),
@@ -38,7 +58,7 @@ const billRunOutcomeListItemSchema = z.object({
 const crud = makeCrudRoute({
   metadata: routeMetadata,
   orm: {
-    entity: BillRunOutcome,
+    entity: BillingRunOutcome,
     idField: "id",
     orgField: "organizationId",
     tenantField: "tenantId",
@@ -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, BillRunOutcome } 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: BillRunOutcome,\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

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { makeCrudRoute } from "@open-mercato/shared/lib/crud/factory";
 import { withScopedPayload } from "@open-mercato/shared/lib/api/scoped";
 import { resolveTranslations } from "@open-mercato/shared/lib/i18n/server";
-import { BillRun } from "../../../data/entities.js";
+import { BillingRun } from "../../../data/entities.js";
 import { billingEntityIds } from "../../../data/entityIds.js";
 import { billingRunRetryFailedSchema } from "../../../data/validators.js";
 import { createBillingCrudOpenApi } from "../../openapi.js";
@@ -19,7 +19,7 @@ const rawBodySchema = z.object({}).passthrough();
 const crud = makeCrudRoute({
   metadata: routeMetadata,
   orm: {
-    entity: BillRun,
+    entity: BillingRun,
     idField: "id",
     orgField: "organizationId",
     tenantField: "tenantId",
@@ -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 { BillRun } 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: BillRun,\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,eAAe;AACxB,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": []
 }