@dainamite/billing 0.20.0 → 0.22.0

package/dist/modules/billing/api/invoices/remove-line/route.js

@@ -2,10 +2,10 @@ 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 { SalesInvoice } from "@open-mercato/core/modules/sales/data/entities";
 import { billingEntityIds } from "../../../data/entityIds.js";
 import { billingInvoiceRemoveLineSchema } from "../../../data/validators.js";
 import { createBillingCrudOpenApi } from "../../openapi.js";
+import { BillingInvoice } from "../../../data/entities.js";
 const routeMetadata = {
   POST: { requireAuth: true, requireFeatures: ["billing.invoice.edit_draft"] }
 };
@@ -19,7 +19,7 @@ const rawBodySchema = z.object({}).passthrough();
 const crud = makeCrudRoute({
   metadata: routeMetadata,
   orm: {
-    entity: SalesInvoice,
+    entity: BillingInvoice,
     idField: "id",
     orgField: "organizationId",
     tenantField: "tenantId",

package/dist/modules/billing/api/invoices/remove-line/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/billing/api/invoices/remove-line/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 { SalesInvoice } from '@open-mercato/core/modules/sales/data/entities'\nimport { billingEntityIds } from '../../../data/entityIds'\nimport { billingInvoiceRemoveLineSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.invoice.edit_draft'] },\n}\n\nexport const metadata = routeMetadata\n\nconst removeLineResponseSchema = z.object({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n  auditId: z.string().uuid(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: SalesInvoice,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.draftInvoiceEdit,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.invoices.remove_draft_line',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingInvoiceRemoveLineSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        invoiceId: result?.invoiceId ?? null,\n        invoiceLineId: result?.invoiceLineId ?? null,\n        auditId: result?.auditId ?? null,\n      }),\n      status: 200,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingInvoiceLineRemove',\n  pluralName: 'BillingInvoiceLineRemoves',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingInvoiceRemoveLineSchema,\n    responseSchema: removeLineResponseSchema,\n    description:\n      'Removes one line from a draft invoice (hard delete \u2014 the line ' +\n      'never existed as far as future readers are concerned). Writes ' +\n      'a `BillingDraftInvoiceEdit` audit row (action=`line_removed`, ' +\n      '`after_json=null`) carrying the before-snapshot for forensics. ' +\n      'Recomputes invoice totals. Refuses non-draft invoices.',\n  },\n})\n"],
-  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,oBAAoB;AAC7B,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAC/C,SAAS,gCAAgC;AAEzC,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,4BAA4B,EAAE;AAC7E;AAEO,MAAM,WAAW;AAExB,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,EAC3B,eAAe,EAAE,OAAO,EAAE,KAAK;AAAA,EAC/B,SAAS,EAAE,OAAO,EAAE,KAAK;AAC3B,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,EACA,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,+BAA+B,MAAM,MAAM;AAAA,MACpD;AAAA,MACA,UAAU,CAAC,EAAE,OAAO,OAAO;AAAA,QACzB,WAAW,QAAQ,aAAa;AAAA,QAChC,eAAe,QAAQ,iBAAiB;AAAA,QACxC,SAAS,QAAQ,WAAW;AAAA,MAC9B;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;",
+  "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 { billingEntityIds } from '../../../data/entityIds'\nimport { billingInvoiceRemoveLineSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\nimport { BillingInvoice } from '../../../data/entities'\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.invoice.edit_draft'] },\n}\n\nexport const metadata = routeMetadata\n\nconst removeLineResponseSchema = z.object({\n  invoiceId: z.string().uuid(),\n  invoiceLineId: z.string().uuid(),\n  auditId: z.string().uuid(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingInvoice,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.draftInvoiceEdit,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.invoices.remove_draft_line',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingInvoiceRemoveLineSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        invoiceId: result?.invoiceId ?? null,\n        invoiceLineId: result?.invoiceLineId ?? null,\n        auditId: result?.auditId ?? null,\n      }),\n      status: 200,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingInvoiceLineRemove',\n  pluralName: 'BillingInvoiceLineRemoves',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingInvoiceRemoveLineSchema,\n    responseSchema: removeLineResponseSchema,\n    description:\n      'Removes one line from a draft invoice (hard delete \u2014 the line ' +\n      'never existed as far as future readers are concerned). Writes ' +\n      'a `BillingDraftInvoiceEdit` audit row (action=`line_removed`, ' +\n      '`after_json=null`) carrying the before-snapshot for forensics. ' +\n      'Recomputes invoice totals. Refuses non-draft invoices.',\n  },\n})\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAC/C,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAE/B,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,4BAA4B,EAAE;AAC7E;AAEO,MAAM,WAAW;AAExB,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,EAC3B,eAAe,EAAE,OAAO,EAAE,KAAK;AAAA,EAC/B,SAAS,EAAE,OAAO,EAAE,KAAK;AAC3B,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,EACA,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,+BAA+B,MAAM,MAAM;AAAA,MACpD;AAAA,MACA,UAAU,CAAC,EAAE,OAAO,OAAO;AAAA,QACzB,WAAW,QAAQ,aAAa;AAAA,QAChC,eAAe,QAAQ,iBAAiB;AAAA,QACxC,SAAS,QAAQ,WAAW;AAAA,MAC9B;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/invoices/route.js

@@ -1,19 +1,11 @@
 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 { billingInvoiceListQuerySchema } from "../../data/validators.js";
+import { daysOverdueSql, isoDay, overdueSql } from "../../lib/overdue.js";
 const metadata = {
   GET: { requireAuth: true, requireFeatures: ["billing.invoice.view"] }
 };
-const querySchema = z.object({
-  page: z.coerce.number().int().min(1).default(1),
-  pageSize: z.coerce.number().int().min(1).max(100).default(50),
-  status: z.enum(["draft", "posted", "paid", "void"]).optional(),
-  billRunId: z.string().uuid().optional(),
-  billAccountId: z.string().uuid().optional(),
-  testRun: z.coerce.boolean().optional(),
-  search: z.string().optional()
-}).passthrough();
 async function GET(req) {
   try {
     const container = await createRequestContainer();
@@ -29,56 +21,63 @@ async function GET(req) {
       );
     }
     const url = new URL(req.url);
-    const query = querySchema.parse(
-      Object.fromEntries(url.searchParams.entries())
-    );
+    const query = billingInvoiceListQuerySchema.parse(Object.fromEntries(url.searchParams.entries()));
     const em = container.resolve("em").fork();
-    const whereClauses = [
-      "tenant_id = ?",
-      "organization_id = ?",
-      "deleted_at IS NULL",
-      "jsonb_exists(metadata, 'bill_run_id')"
-    ];
+    const whereClauses = ["i.tenant_id = ?", "i.organization_id = ?", "i.deleted_at IS NULL"];
     const params = [auth.tenantId, organizationId];
-    if (query.status) {
-      whereClauses.push("status = ?");
-      params.push(query.status);
+    const filters = [
+      [query.id, "i.id = ?"],
+      [query.status, "i.status = ?"],
+      [query.documentType, "i.document_type = ?"],
+      [query.billRunId, "i.bill_run_id = ?"],
+      [query.billAccountId, "i.bill_account_id = ?"],
+      [query.testRun, "i.test_run = ?"]
+    ];
+    for (const [value, clause] of filters) {
+      if (value === void 0 || value === null || value === "") continue;
+      whereClauses.push(clause);
+      params.push(value);
     }
-    if (query.billRunId) {
-      whereClauses.push("metadata->>'bill_run_id' = ?");
-      params.push(query.billRunId);
+    const today = isoDay(/* @__PURE__ */ new Date());
+    if (query.overdue === true) {
+      whereClauses.push(overdueSql("i"));
+      params.push(today);
+    } else if (query.overdue === false) {
+      whereClauses.push(`NOT COALESCE(${overdueSql("i")}, false)`);
+      params.push(today);
     }
-    if (query.billAccountId) {
-      whereClauses.push("metadata->>'bill_account_id' = ?");
-      params.push(query.billAccountId);
+    if (query.dueFrom) {
+      whereClauses.push("i.due_date >= ?::date");
+      params.push(query.dueFrom);
     }
-    if (typeof query.testRun === "boolean") {
-      if (query.testRun) {
-        whereClauses.push("metadata->>'test_run' = 'true'");
-      } else {
-        whereClauses.push("(metadata->>'test_run' IS NULL OR metadata->>'test_run' != 'true')");
-      }
+    if (query.dueTo) {
+      whereClauses.push("i.due_date <= ?::date");
+      params.push(query.dueTo);
     }
-    if (typeof query.search === "string" && query.search.trim()) {
-      whereClauses.push("invoice_number ILIKE ?");
-      params.push(`%${query.search.trim().replace(/[%_]/g, (m) => `\\${m}`)}%`);
+    if (query.search) {
+      whereClauses.push("i.number ILIKE ?");
+      params.push(`%${query.search.replace(/[%_\\]/g, (m) => `\\${m}`)}%`);
     }
     const whereSql = whereClauses.join(" AND ");
     const countRows = await em.execute(
-      `SELECT COUNT(*)::int AS total FROM sales_invoices WHERE ${whereSql}`,
+      `SELECT COUNT(*)::int AS total FROM billing_invoices i WHERE ${whereSql}`,
       params
     );
     const total = countRows?.[0]?.total ?? 0;
     const offset = (query.page - 1) * query.pageSize;
     const itemRows = await em.execute(
-      `SELECT id, invoice_number, status, currency_code, issue_date, due_date,
-              subtotal_net_amount, grand_total_net_amount, grand_total_gross_amount,
-              paid_total_amount, outstanding_amount, metadata, created_at, updated_at
-       FROM sales_invoices
+      `SELECT i.id, i.number, i.document_type, i.status, i.test_run, i.bill_account_id,
+              a.name AS bill_account_name, i.bill_run_id, i.bill_date, i.period_start, i.period_end,
+              i.issue_date, i.due_date, i.currency_code, i.subtotal_net, i.tax_total, i.total_gross,
+              i.paid_total, i.credited_total, i.outstanding, i.corrects_invoice_id, i.corrects_invoice_number, i.topup_id,
+              ${daysOverdueSql("i")}::int AS days_overdue,
+              i.created_at, i.updated_at
+       FROM billing_invoices i
+       LEFT JOIN billing_accounts a ON a.id = i.bill_account_id AND a.tenant_id = i.tenant_id
        WHERE ${whereSql}
-       ORDER BY created_at DESC
+       ORDER BY i.created_at DESC
        LIMIT ? OFFSET ?`,
-      [...params, query.pageSize, offset]
+      [today, today, ...params, query.pageSize, offset]
     );
     return NextResponse.json({
       items: itemRows,
@@ -96,8 +95,8 @@ const openApi = {
   methods: {
     GET: {
       tags: ["Billing"],
-      summary: "List billing-managed invoices",
-      description: "Returns a paginated list of `core/sales` invoices that the billing engine emitted (matched via `metadata->>'bill_run_id'` presence). Supports status / billRunId / billAccountId / testRun / invoice_number search filters."
+      summary: "List billing documents",
+      description: "Paginated billing documents (invoices, credit / debit memos, top-up receipts) from `billing_invoices`. Filters: status, documentType, billRunId, billAccountId, testRun (`true`/`false`), id, number search, `overdue` (`true`/`false` \u2014 posted or partially paid, past due, outstanding > 0), `dueFrom` / `dueTo` (YYYY-MM-DD). Each row adds `days_overdue`. Fields use billing names: `number`, `document_type`, `total_gross`, `outstanding`, `bill_date`, `period_start/end`, `bill_account_name`, \u2026 (0.21.0 renamed them from the core-sales names \u2014 see MIGRATION.md)."
     }
   }
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/billing/api/invoices/route.ts"],
-  "sourcesContent": ["import { NextResponse } from 'next/server'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\n\n/**\n * `GET /api/billing/invoices`\n *\n * Lists `core/sales` invoices that the billing engine emitted (i.e.\n * carry `metadata.bill_run_id`). Hand-rolled rather than wrapped via\n * `makeCrudRoute` because the filter predicate is a JSONB\n * `metadata->>'bill_run_id' IS NOT NULL` check that doesn't map\n * cleanly onto the factory's `where`-shaped filter API, and the\n * entity itself is owned by `core/sales` \u2014 keeping the surface\n * read-only and hand-rolled avoids surprising the cross-module\n * reviewer.\n *\n * Filters:\n *   - `status` \u2014 draft / posted / paid / void\n *   - `billRunId` \u2014 exact match on `metadata->>'bill_run_id'`\n *   - `billAccountId` \u2014 exact match on `metadata->>'bill_account_id'`\n *   - `testRun=true|false` \u2014 flips the `metadata->>'test_run'` filter\n *   - `search` \u2014 substring on invoice_number\n *\n * Sort: started_at DESC (most recent first). Pagination: standard\n * page / pageSize (capped at 100).\n */\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.invoice.view'] },\n}\n\nconst querySchema = 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    status: z.enum(['draft', 'posted', 'paid', 'void']).optional(),\n    billRunId: z.string().uuid().optional(),\n    billAccountId: z.string().uuid().optional(),\n    testRun: z.coerce.boolean().optional(),\n    search: z.string().optional(),\n  })\n  .passthrough()\n\ntype BillingInvoiceRow = {\n  id: string\n  invoice_number: string\n  status: string | null\n  currency_code: string\n  issue_date: string | null\n  due_date: string | null\n  subtotal_net_amount: string\n  grand_total_net_amount: string\n  grand_total_gross_amount: string\n  paid_total_amount: string\n  outstanding_amount: string\n  metadata: Record<string, unknown> | null\n  created_at: string\n  updated_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) {\n      return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n    }\n    const organizationId = (auth as { orgId?: string }).orgId ?? null\n    if (!organizationId) {\n      return NextResponse.json(\n        { error: 'Organization scope required' },\n        { status: 403 },\n      )\n    }\n\n    const url = new URL(req.url)\n    const query = querySchema.parse(\n      Object.fromEntries(url.searchParams.entries()),\n    )\n\n    const em = (container.resolve('em') as EntityManager).fork()\n\n    // Build the predicate. `jsonb_exists(metadata, 'bill_run_id')` is\n    // the function form of the JSONB `?` \"key exists\" operator \u2014 the\n    // operator form cannot be used here because `em.execute` treats a\n    // literal `?` as a positional parameter placeholder. Keeps us\n    // narrow to billing-managed invoices, never bleeding into invoices\n    // written by other modules.\n    const whereClauses: string[] = [\n      'tenant_id = ?',\n      'organization_id = ?',\n      'deleted_at IS NULL',\n      \"jsonb_exists(metadata, 'bill_run_id')\",\n    ]\n    const params: unknown[] = [auth.tenantId, organizationId]\n\n    if (query.status) {\n      whereClauses.push('status = ?')\n      params.push(query.status)\n    }\n    if (query.billRunId) {\n      whereClauses.push(\"metadata->>'bill_run_id' = ?\")\n      params.push(query.billRunId)\n    }\n    if (query.billAccountId) {\n      whereClauses.push(\"metadata->>'bill_account_id' = ?\")\n      params.push(query.billAccountId)\n    }\n    if (typeof query.testRun === 'boolean') {\n      if (query.testRun) {\n        whereClauses.push(\"metadata->>'test_run' = 'true'\")\n      } else {\n        whereClauses.push(\"(metadata->>'test_run' IS NULL OR metadata->>'test_run' != 'true')\")\n      }\n    }\n    if (typeof query.search === 'string' && query.search.trim()) {\n      whereClauses.push('invoice_number ILIKE ?')\n      params.push(`%${query.search.trim().replace(/[%_]/g, (m) => `\\\\${m}`)}%`)\n    }\n\n    const whereSql = whereClauses.join(' AND ')\n    const countRows = (await em.execute(\n      `SELECT COUNT(*)::int AS total FROM sales_invoices WHERE ${whereSql}`,\n      params,\n    )) as unknown as Array<{ total: number }>\n    const total = countRows?.[0]?.total ?? 0\n\n    const offset = (query.page - 1) * query.pageSize\n    const itemRows = (await em.execute(\n      `SELECT id, invoice_number, status, currency_code, issue_date, due_date,\n              subtotal_net_amount, grand_total_net_amount, grand_total_gross_amount,\n              paid_total_amount, outstanding_amount, metadata, created_at, updated_at\n       FROM sales_invoices\n       WHERE ${whereSql}\n       ORDER BY created_at DESC\n       LIMIT ? OFFSET ?`,\n      [...params, query.pageSize, offset],\n    )) as unknown as BillingInvoiceRow[]\n\n    return NextResponse.json({\n      items: itemRows,\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    console.error('[billing/invoices.GET]', err)\n    return NextResponse.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n\nexport const openApi = {\n  methods: {\n    GET: {\n      tags: ['Billing'],\n      summary: 'List billing-managed invoices',\n      description:\n        'Returns a paginated list of `core/sales` invoices that the ' +\n        'billing engine emitted (matched via `metadata->>\\'bill_run_id\\'` ' +\n        'presence). Supports status / billRunId / billAccountId / testRun ' +\n        '/ invoice_number search filters.',\n    },\n  },\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { NextResponse } from 'next/server'\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 { billingInvoiceListQuerySchema } from '../../data/validators'\nimport { daysOverdueSql, isoDay, overdueSql } from '../../lib/overdue'\n\n/**\n * `GET /api/billing/invoices` \u2014 paginated list of billing documents\n * (Spec 0: billing-owned `billing_invoices`, never core `sales`).\n *\n * Filters (all on indexed columns): `status`, `documentType`, `billRunId`,\n * `billAccountId`, `testRun` (`true` / `false`), `id`, `search` (number).\n * Spec B: `overdue=true` (computed, B-D6 \u2014 see `lib/overdue.ts`), `dueFrom` /\n * `dueTo` (due-date window). Each row carries `bill_account_name` (joined)\n * and `days_overdue` (0 when not overdue).\n *\n * Hand-written SQL instead of the CRUD factory: documents are written by the\n * bill-run engine without query-index side effects, so the factory's\n * query-engine path would not see them. Sort: `created_at DESC`.\n */\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.invoice.view'] },\n}\n\ntype BillingInvoiceRow = {\n  id: string\n  number: string\n  document_type: string\n  status: string\n  test_run: boolean\n  bill_account_id: string\n  bill_account_name: string | null\n  bill_run_id: string | null\n  bill_date: string | null\n  period_start: string | null\n  period_end: string | null\n  issue_date: string | null\n  due_date: string | null\n  currency_code: string\n  subtotal_net: string\n  tax_total: string\n  total_gross: string\n  paid_total: string\n  credited_total: string\n  outstanding: string\n  days_overdue: number\n  corrects_invoice_id: string | null\n  topup_id: string | null\n  created_at: string\n  updated_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) {\n      return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n    }\n    const organizationId = (auth as { orgId?: string }).orgId ?? null\n    if (!organizationId) {\n      return NextResponse.json(\n        { error: 'Organization scope required' },\n        { status: 403 },\n      )\n    }\n\n    const url = new URL(req.url)\n    const query = billingInvoiceListQuerySchema.parse(Object.fromEntries(url.searchParams.entries()))\n\n    const em = (container.resolve('em') as EntityManager).fork()\n\n    const whereClauses: string[] = ['i.tenant_id = ?', 'i.organization_id = ?', 'i.deleted_at IS NULL']\n    const params: unknown[] = [auth.tenantId, organizationId]\n    const filters: Array<[unknown, string]> = [\n      [query.id, 'i.id = ?'],\n      [query.status, 'i.status = ?'],\n      [query.documentType, 'i.document_type = ?'],\n      [query.billRunId, 'i.bill_run_id = ?'],\n      [query.billAccountId, 'i.bill_account_id = ?'],\n      [query.testRun, 'i.test_run = ?'],\n    ]\n    for (const [value, clause] of filters) {\n      if (value === undefined || value === null || value === '') continue\n      whereClauses.push(clause)\n      params.push(value)\n    }\n    const today = isoDay(new Date())\n    if (query.overdue === true) {\n      whereClauses.push(overdueSql('i'))\n      params.push(today)\n    } else if (query.overdue === false) {\n      whereClauses.push(`NOT COALESCE(${overdueSql(\"i\")}, false)`)\n      params.push(today)\n    }\n    if (query.dueFrom) {\n      whereClauses.push('i.due_date >= ?::date')\n      params.push(query.dueFrom)\n    }\n    if (query.dueTo) {\n      whereClauses.push('i.due_date <= ?::date')\n      params.push(query.dueTo)\n    }\n    if (query.search) {\n      whereClauses.push('i.number ILIKE ?')\n      params.push(`%${query.search.replace(/[%_\\\\]/g, (m) => `\\\\${m}`)}%`)\n    }\n\n    const whereSql = whereClauses.join(' AND ')\n    const countRows = (await em.execute(\n      `SELECT COUNT(*)::int AS total FROM billing_invoices i WHERE ${whereSql}`,\n      params,\n    )) as unknown as Array<{ total: number }>\n    const total = countRows?.[0]?.total ?? 0\n\n    const offset = (query.page - 1) * query.pageSize\n    const itemRows = (await em.execute(\n      `SELECT i.id, i.number, i.document_type, i.status, i.test_run, i.bill_account_id,\n              a.name AS bill_account_name, i.bill_run_id, i.bill_date, i.period_start, i.period_end,\n              i.issue_date, i.due_date, i.currency_code, i.subtotal_net, i.tax_total, i.total_gross,\n              i.paid_total, i.credited_total, i.outstanding, i.corrects_invoice_id, i.corrects_invoice_number, i.topup_id,\n              ${daysOverdueSql('i')}::int AS days_overdue,\n              i.created_at, i.updated_at\n       FROM billing_invoices i\n       LEFT JOIN billing_accounts a ON a.id = i.bill_account_id AND a.tenant_id = i.tenant_id\n       WHERE ${whereSql}\n       ORDER BY i.created_at DESC\n       LIMIT ? OFFSET ?`,\n      [today, today, ...params, query.pageSize, offset],\n    )) as unknown as BillingInvoiceRow[]\n\n    return NextResponse.json({\n      items: itemRows,\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    console.error('[billing/invoices.GET]', err)\n    return NextResponse.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n\nexport const openApi = {\n  methods: {\n    GET: {\n      tags: ['Billing'],\n      summary: 'List billing documents',\n      description:\n        'Paginated billing documents (invoices, credit / debit memos, top-up receipts) from ' +\n        '`billing_invoices`. Filters: status, documentType, billRunId, billAccountId, testRun ' +\n        '(`true`/`false`), id, number search, `overdue` (`true`/`false` \u2014 posted or partially paid, ' +\n        'past due, outstanding > 0), `dueFrom` / `dueTo` (YYYY-MM-DD). Each row adds `days_overdue`. ' +\n        'Fields use billing names: `number`, `document_type`, ' +\n        '`total_gross`, `outstanding`, `bill_date`, `period_start/end`, `bill_account_name`, \u2026 ' +\n        '(0.21.0 renamed them from the core-sales names \u2014 see MIGRATION.md).',\n    },\n  },\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/api/items/bulk/route.js

@@ -63,7 +63,7 @@ const openApi = createBillingCrudOpenApi({
   create: {
     schema: billingItemBulkCreateSchema,
     responseSchema: bulkResponseSchema,
-    description: "Batch-creates up to 500 Billing Items under one scope envelope. Idempotent per `sourceRef` (one batched existence check). Returns `{ created, deduplicated, items: [{ sourceRef, id, deduplicated }] }`. Always HTTP 200 \u2014 duplicates are reported in the body, never an error."
+    description: "Batch-creates up to 500 Billing Items under one scope envelope. Idempotent per `sourceRef` (one batched existence check). Returns `{ created, deduplicated, items: [{ sourceRef, id, deduplicated }] }`. Always HTTP 200 \u2014 duplicates are reported in the body, never an error. Entries accept `chargeTiming` / `prorate` (recurring only; defaults `in_advance` / true)."
   }
 });
 export {

package/dist/modules/billing/api/items/bulk/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/billing/api/items/bulk/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 { BillingItem } from '../../../data/entities'\nimport { billingEntityIds } from '../../../data/entityIds'\nimport { billingItemBulkCreateSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\n\n/**\n * `POST /api/billing/items/bulk` \u2014 batch-create Billing Items.\n *\n * One scope envelope, up to 500 item payloads. Idempotent per\n * `source_ref` with a *single* batched existence check, then a\n * single flush. The CPQ connector's subscription-activated /\n * -amended / -renewed subscribers are the primary callers \u2014 bulk\n * collapses what used to be one `billing.items.create` round-trip\n * per charge.\n */\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n}\n\nexport const metadata = routeMetadata\n\nconst bulkResultEntrySchema = z.object({\n  sourceRef: z.string().nullable(),\n  id: z.string().uuid(),\n  deduplicated: z.boolean(),\n})\n\nconst bulkResponseSchema = z.object({\n  created: z.number().int().nonnegative(),\n  deduplicated: z.number().int().nonnegative(),\n  items: z.array(bulkResultEntrySchema),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingItem,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.item,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.items.bulk_create',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemBulkCreateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        created: result?.created ?? 0,\n        deduplicated: result?.deduplicated ?? 0,\n        items: result?.items ?? [],\n      }),\n      status: 200,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingItemBulkCreate',\n  pluralName: 'BillingItemBulkCreates',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingItemBulkCreateSchema,\n    responseSchema: bulkResponseSchema,\n    description:\n      'Batch-creates up to 500 Billing Items under one scope envelope. ' +\n      'Idempotent per `sourceRef` (one batched existence check). ' +\n      'Returns `{ created, deduplicated, items: [{ sourceRef, id, ' +\n      'deduplicated }] }`. Always HTTP 200 \u2014 duplicates are reported ' +\n      'in the body, never an error.',\n  },\n})\n"],
-  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AACjC,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AAazC,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,qBAAqB,EAAE;AACtE;AAEO,MAAM,WAAW;AAExB,MAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,IAAI,EAAE,OAAO,EAAE,KAAK;AAAA,EACpB,cAAc,EAAE,QAAQ;AAC1B,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACtC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,OAAO,EAAE,MAAM,qBAAqB;AACtC,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,EACA,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,SAAS,QAAQ,WAAW;AAAA,QAC5B,cAAc,QAAQ,gBAAgB;AAAA,QACtC,OAAO,QAAQ,SAAS,CAAC;AAAA,MAC3B;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;",
+  "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 { BillingItem } from '../../../data/entities'\nimport { billingEntityIds } from '../../../data/entityIds'\nimport { billingItemBulkCreateSchema } from '../../../data/validators'\nimport { createBillingCrudOpenApi } from '../../openapi'\n\n/**\n * `POST /api/billing/items/bulk` \u2014 batch-create Billing Items.\n *\n * One scope envelope, up to 500 item payloads. Idempotent per\n * `source_ref` with a *single* batched existence check, then a\n * single flush. The CPQ connector's subscription-activated /\n * -amended / -renewed subscribers are the primary callers \u2014 bulk\n * collapses what used to be one `billing.items.create` round-trip\n * per charge.\n */\n\nconst routeMetadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n}\n\nexport const metadata = routeMetadata\n\nconst bulkResultEntrySchema = z.object({\n  sourceRef: z.string().nullable(),\n  id: z.string().uuid(),\n  deduplicated: z.boolean(),\n})\n\nconst bulkResponseSchema = z.object({\n  created: z.number().int().nonnegative(),\n  deduplicated: z.number().int().nonnegative(),\n  items: z.array(bulkResultEntrySchema),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingItem,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: z.object({}).passthrough(),\n    entityId: billingEntityIds.item,\n    fields: ['id'],\n    buildFilters: async () => ({}),\n  },\n  actions: {\n    create: {\n      commandId: 'billing.items.bulk_create',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemBulkCreateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        created: result?.created ?? 0,\n        deduplicated: result?.deduplicated ?? 0,\n        items: result?.items ?? [],\n      }),\n      status: 200,\n    },\n  },\n})\n\nexport const POST = crud.POST\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingItemBulkCreate',\n  pluralName: 'BillingItemBulkCreates',\n  querySchema: z.object({}).passthrough(),\n  listResponseSchema: z.object({ items: z.array(z.unknown()) }),\n  create: {\n    schema: billingItemBulkCreateSchema,\n    responseSchema: bulkResponseSchema,\n    description:\n      'Batch-creates up to 500 Billing Items under one scope envelope. ' +\n      'Idempotent per `sourceRef` (one batched existence check). ' +\n      'Returns `{ created, deduplicated, items: [{ sourceRef, id, ' +\n      'deduplicated }] }`. Always HTTP 200 \u2014 duplicates are reported ' +\n      'in the body, never an error. Entries accept `chargeTiming` / `prorate` ' +\n      '(recurring only; defaults `in_advance` / true).',\n  },\n})\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AACjC,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AAazC,MAAM,gBAAgB;AAAA,EACpB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,qBAAqB,EAAE;AACtE;AAEO,MAAM,WAAW;AAExB,MAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,IAAI,EAAE,OAAO,EAAE,KAAK;AAAA,EACpB,cAAc,EAAE,QAAQ;AAC1B,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACtC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,OAAO,EAAE,MAAM,qBAAqB;AACtC,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,EACA,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,SAAS,QAAQ,WAAW;AAAA,QAC5B,cAAc,QAAQ,gBAAgB;AAAA,QACtC,OAAO,QAAQ,SAAS,CAAC;AAAA,MAC3B;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,EAMJ;AACF,CAAC;",
   "names": []
 }

package/dist/modules/billing/api/items/change-price/route.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { runCommandRoute } from "../../../lib/commandRoute.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["billing.item.manage"] }
+};
+const bodySchema = z.object({
+  id: z.string().uuid(),
+  effectiveDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  unitPrice: z.coerce.number().finite().nonnegative()
+});
+const responseSchema = z.object({ previousItemId: z.string().uuid(), newItemId: z.string().uuid() });
+async function POST(req) {
+  return runCommandRoute(req, {
+    commandId: "billing.items.change_price",
+    bodySchema,
+    resourceKind: "billing.item",
+    resourceId: (body) => body.id,
+    logLabel: "billing/items/change-price.POST"
+  });
+}
+const openApi = {
+  methods: {
+    POST: {
+      tags: ["Billing"],
+      summary: "Change a recurring item's price from a date",
+      description: "Ends the item the day before `effectiveDate` and creates a copy with the new `unitPrice` (on the item price basis) starting on `effectiveDate`. Already-billed days after the change are credited / re-charged by the Bill Run per the item's proration setting, so nothing is billed twice.",
+      requestBody: { schema: bodySchema },
+      responses: [{ status: 200, description: "Both item ids", schema: responseSchema }],
+      errors: [
+        { status: 404, description: "Item not found" },
+        {
+          status: 422,
+          description: "`billing.item.price_change_recurring_only` / `_inactive` / `_before_start` (must be after the start date) / `_after_end`"
+        }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/items/change-price/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/items/change-price/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport { runCommandRoute } from '../../../lib/commandRoute'\n\n/**\n * `POST /api/billing/items/change-price` \u2014 change a recurring item's price\n * from a date on: the item ends the day before `effectiveDate` and a copy with\n * `unitPrice` starts on it (same account, description, timing, proration,\n * VAT, price basis, references and end date). Returns both item ids.\n */\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n}\n\nconst bodySchema = z.object({\n  id: z.string().uuid(),\n  effectiveDate: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/),\n  unitPrice: z.coerce.number().finite().nonnegative(),\n})\n\nconst responseSchema = z.object({ previousItemId: z.string().uuid(), newItemId: z.string().uuid() })\n\nexport async function POST(req: Request) {\n  return runCommandRoute(req, {\n    commandId: 'billing.items.change_price',\n    bodySchema,\n    resourceKind: 'billing.item',\n    resourceId: (body) => body.id,\n    logLabel: 'billing/items/change-price.POST',\n  })\n}\n\nexport const openApi = {\n  methods: {\n    POST: {\n      tags: ['Billing'],\n      summary: \"Change a recurring item's price from a date\",\n      description:\n        'Ends the item the day before `effectiveDate` and creates a copy with the new `unitPrice` (on the item price basis) ' +\n        'starting on `effectiveDate`. Already-billed days after the change are credited / re-charged by the Bill Run per the ' +\n        \"item's proration setting, so nothing is billed twice.\",\n      requestBody: { schema: bodySchema },\n      responses: [{ status: 200, description: 'Both item ids', schema: responseSchema }],\n      errors: [\n        { status: 404, description: 'Item not found' },\n        {\n          status: 422,\n          description:\n            '`billing.item.price_change_recurring_only` / `_inactive` / `_before_start` (must be after the start date) / `_after_end`',\n        },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAClB,SAAS,uBAAuB;AASzB,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,qBAAqB,EAAE;AACtE;AAEA,MAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,IAAI,EAAE,OAAO,EAAE,KAAK;AAAA,EACpB,eAAe,EAAE,OAAO,EAAE,MAAM,qBAAqB;AAAA,EACrD,WAAW,EAAE,OAAO,OAAO,EAAE,OAAO,EAAE,YAAY;AACpD,CAAC;AAED,MAAM,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,GAAG,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAEnG,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,aACE;AAAA,MAGF,aAAa,EAAE,QAAQ,WAAW;AAAA,MAClC,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,iBAAiB,QAAQ,eAAe,CAAC;AAAA,MACjF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,iBAAiB;AAAA,QAC7C;AAAA,UACE,QAAQ;AAAA,UACR,aACE;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -25,6 +25,9 @@ const billingItemListItemSchema = z.object({
   id: z.string().uuid(),
   bill_account_id: z.string().uuid(),
   bill_account_name: z.string().nullable(),
+  /** Spec F (F2): the owning account's currency and mode, for the form. */
+  bill_account_currency: z.string().nullable(),
+  bill_account_mode: z.enum(["postpaid", "prepaid"]).nullable(),
   type: z.string(),
   bill_start_date: z.string(),
   bill_end_date: z.string().nullable(),
@@ -36,6 +39,10 @@ const billingItemListItemSchema = z.object({
   source_ref: z.string().nullable(),
   currency_mismatch: z.boolean(),
   billed_to_date: z.string().nullable(),
+  charge_timing: z.enum(["in_advance", "in_arrears"]),
+  prorate: z.boolean(),
+  tax_rate: z.union([z.string(), z.number()]),
+  price_basis: z.enum(["net", "gross"]),
   is_active: z.boolean(),
   organization_id: z.string().uuid(),
   tenant_id: z.string().uuid(),
@@ -73,6 +80,10 @@ const crud = makeCrudRoute({
       "source_ref",
       "currency_mismatch",
       "billed_to_date",
+      "charge_timing",
+      "prorate",
+      "tax_rate",
+      "price_basis",
       "is_active",
       "organization_id",
       "tenant_id",
@@ -169,7 +180,7 @@ const crud = makeCrudRoute({
   },
   hooks: {
     // Items reference their account by FK id only; the list + detail UI
-    // wants the human-readable account name. One bounded query
+    // wants the account name, currency and mode. One bounded query
     // (≤ pageSize ids) resolves it after the page is fetched.
     afterList: async (payload, ctx) => {
       const items = payload?.items ?? [];
@@ -181,11 +192,12 @@ const crud = makeCrudRoute({
       if (accountIds.length === 0) return;
       const em = ctx.container.resolve("em");
       const accounts = await em.find(BillingAccount, { id: { $in: accountIds } });
-      const nameById = new Map(
-        accounts.map((a) => [String(a.id), a.name])
-      );
+      const byId = new Map(accounts.map((a) => [String(a.id), a]));
       for (const row of items) {
-        row.bill_account_name = nameById.get(String(row.bill_account_id)) ?? null;
+        const account = byId.get(String(row.bill_account_id));
+        row.bill_account_name = account?.name ?? null;
+        row.bill_account_currency = account?.currencyCode ?? null;
+        row.bill_account_mode = account?.billingMode ?? null;
       }
     }
   }
@@ -200,12 +212,12 @@ const openApi = createBillingCrudOpenApi({
   create: {
     schema: billingItemCreateSchema,
     responseSchema: itemCreateResponseSchema,
-    description: "Creates a billing item. Idempotent via `sourceRef`: re-POSTing the same `(tenantId, billAccountId, sourceRef)` returns the existing row with `deduplicated: true` instead of creating a duplicate. The unique index on `(tenant_id, bill_account_id, source_ref)` is the correctness gate."
+    description: "Creates a billing item. Idempotent via `sourceRef`: re-POSTing the same `(tenantId, billAccountId, sourceRef)` returns the existing row with `deduplicated: true` instead of creating a duplicate. The unique index on `(tenant_id, bill_account_id, source_ref)` is the correctness gate. Recurring items accept `chargeTiming` (`in_advance` default | `in_arrears`) and `prorate` (default true); other types reject non-default values (400)."
   },
   update: {
     schema: billingItemUpdateSchema,
     responseSchema: defaultOkResponseSchema,
-    description: "Updates a billing item. `type` and `sourceRef` are immutable \u2014 to change either, soft-delete the item and create a new one."
+    description: "Updates a billing item. `type` and `sourceRef` are immutable \u2014 to change either, soft-delete the item and create a new one. `chargeTiming` / `prorate` may change at any time on recurring items \u2014 billing resumes from `billed_to_date`, so no day is billed twice."
   },
   del: {
     schema: z.object({ id: z.string().uuid() }),

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/billing/api/items/route.ts"],
-  "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 { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingAccount, BillingItem } from '../../data/entities'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  billingItemCreateSchema,\n  billingItemListQuerySchema,\n  billingItemUpdateSchema,\n} from '../../data/validators'\nimport {\n  createBillingCrudOpenApi,\n  createPagedListResponseSchema,\n  defaultOkResponseSchema,\n} from '../openapi'\n\n// \u2500\u2500\u2500 Auth / RBAC \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.item.view'] },\n  POST: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n  PUT: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n  DELETE: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n}\n\nexport const metadata = routeMetadata\n\n// The list endpoint projects raw column names \u2014 snake_case.\nconst billingItemListItemSchema = z.object({\n  id: z.string().uuid(),\n  bill_account_id: z.string().uuid(),\n  bill_account_name: z.string().nullable(),\n  type: z.string(),\n  bill_start_date: z.string(),\n  bill_end_date: z.string().nullable(),\n  description: z.string(),\n  rate_json: z.record(z.string(), z.unknown()),\n  uom_code: z.string().nullable(),\n  subscription_id: z.string().nullable(),\n  subscription_item_id: z.string().nullable(),\n  source_ref: z.string().nullable(),\n  currency_mismatch: z.boolean(),\n  billed_to_date: z.string().nullable(),\n  is_active: z.boolean(),\n  organization_id: z.string().uuid(),\n  tenant_id: z.string().uuid(),\n  created_at: z.string(),\n  updated_at: z.string(),\n})\n\n// Response for create includes `deduplicated` so integrators can tell\n// whether their POST resulted in a new row or hit the idempotency\n// short-circuit on `source_ref`.\nconst itemCreateResponseSchema = z.object({\n  id: z.string().uuid().nullable(),\n  deduplicated: z.boolean(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingItem,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: billingItemListQuerySchema,\n    entityId: billingEntityIds.item,\n    fields: [\n      'id',\n      'bill_account_id',\n      'type',\n      'bill_start_date',\n      'bill_end_date',\n      'description',\n      'rate_json',\n      'uom_code',\n      'subscription_id',\n      'subscription_item_id',\n      'source_ref',\n      'currency_mismatch',\n      'billed_to_date',\n      'is_active',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      createdAt: 'created_at',\n      updatedAt: 'updated_at',\n      billStartDate: 'bill_start_date',\n      billEndDate: 'bill_end_date',\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 item through this filter.\n      if (typeof query.id === 'string' && query.id) {\n        filters.id = { $eq: query.id }\n      }\n      if (typeof query.search === 'string' && query.search.trim()) {\n        const pattern = `%${query.search.trim().replace(/[%_]/g, (m) => `\\\\${m}`)}%`\n        filters.description = { $ilike: pattern }\n      }\n      if (typeof query.billAccountId === 'string' && query.billAccountId) {\n        filters.bill_account_id = { $eq: query.billAccountId }\n      }\n      if (typeof query.type === 'string' && query.type) {\n        filters.type = { $eq: query.type }\n      }\n      if (typeof query.subscriptionId === 'string' && query.subscriptionId) {\n        filters.subscription_id = { $eq: query.subscriptionId }\n      }\n      if (typeof query.isActive === 'boolean') {\n        filters.is_active = { $eq: query.isActive }\n      }\n      // `activeAt=<date>` returns items whose validity window covers\n      // the supplied date (Bill Run engine uses the same predicate\n      // shape internally \u2014 see spec \"Mid-cycle recurring items\").\n      if (query.activeAt instanceof Date) {\n        filters.bill_start_date = { $lte: query.activeAt }\n        filters.$or = [\n          { bill_end_date: null },\n          { bill_end_date: { $gte: query.activeAt } },\n        ]\n      }\n      return filters\n    },\n  },\n  actions: {\n    create: {\n      commandId: 'billing.items.create',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemCreateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        id: result?.id ?? null,\n        deduplicated: Boolean(result?.deduplicated),\n      }),\n      // Idempotent create returns 200 (vs 201). The spec mandates\n      // duplicate POST returns the existing row, never creates a\n      // duplicate \u2014 keeping the success status consistent makes\n      // client-side handling trivial.\n      status: 200,\n    },\n    update: {\n      commandId: 'billing.items.update',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemUpdateSchema.parse(scoped)\n      },\n      response: () => ({ ok: true }),\n    },\n    delete: {\n      commandId: 'billing.items.delete',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        // The factory hands delete a `{ body, query }` envelope \u2014 the\n        // id may arrive in either, depending on the caller.\n        const envelope = (raw ?? {}) as {\n          body?: Record<string, unknown>\n          query?: Record<string, unknown>\n        }\n        const body = envelope.body ?? {}\n        const query = envelope.query ?? {}\n        const scoped = withScopedPayload(body, ctx, translate)\n        const id =\n          (typeof body.id === 'string' && body.id) ||\n          (typeof query.id === 'string' && query.id) ||\n          null\n        if (!id) {\n          throw new Error('id is required')\n        }\n        return {\n          id,\n          tenantId: (scoped as { tenantId?: string }).tenantId,\n          organizationId: (scoped as { organizationId?: string }).organizationId,\n        }\n      },\n      response: () => ({ ok: true }),\n    },\n  },\n  hooks: {\n    // Items reference their account by FK id only; the list + detail UI\n    // wants the human-readable account name. One bounded query\n    // (\u2264 pageSize ids) resolves it after the page is fetched.\n    afterList: async (payload: unknown, ctx: unknown) => {\n      const items = ((payload as { items?: unknown[] } | null)?.items ?? []) as Array<\n        Record<string, unknown>\n      >\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      if (accountIds.length === 0) return\n      const em = (ctx as { container: AwilixContainer }).container.resolve<EntityManager>('em')\n      const accounts = await em.find(BillingAccount, { id: { $in: accountIds } })\n      const nameById = new Map(\n        accounts.map((a) => [String(a.id), a.name] as [string, unknown]),\n      )\n      for (const row of items) {\n        row.bill_account_name = nameById.get(String(row.bill_account_id)) ?? null\n      }\n    },\n  },\n})\n\nconst { POST, PUT, DELETE } = crud\nexport { POST, PUT, DELETE }\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingItem',\n  pluralName: 'BillingItems',\n  querySchema: billingItemListQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billingItemListItemSchema),\n  create: {\n    schema: billingItemCreateSchema,\n    responseSchema: itemCreateResponseSchema,\n    description:\n      'Creates a billing item. Idempotent via `sourceRef`: re-POSTing the same ' +\n      '`(tenantId, billAccountId, sourceRef)` returns the existing row with ' +\n      '`deduplicated: true` instead of creating a duplicate. The unique index ' +\n      'on `(tenant_id, bill_account_id, source_ref)` is the correctness gate.',\n  },\n  update: {\n    schema: billingItemUpdateSchema,\n    responseSchema: defaultOkResponseSchema,\n    description:\n      'Updates a billing item. `type` and `sourceRef` are immutable \u2014 to change ' +\n      'either, soft-delete the item and create a new one.',\n  },\n  del: {\n    schema: z.object({ id: z.string().uuid() }),\n    responseSchema: defaultOkResponseSchema,\n    description: 'Soft-deletes a billing item.',\n  },\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 { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { BillingAccount, BillingItem } from '../../data/entities'\nimport { billingEntityIds } from '../../data/entityIds'\nimport {\n  billingItemCreateSchema,\n  billingItemListQuerySchema,\n  billingItemUpdateSchema,\n} from '../../data/validators'\nimport {\n  createBillingCrudOpenApi,\n  createPagedListResponseSchema,\n  defaultOkResponseSchema,\n} from '../openapi'\n\n// \u2500\u2500\u2500 Auth / RBAC \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.item.view'] },\n  POST: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n  PUT: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n  DELETE: { requireAuth: true, requireFeatures: ['billing.item.manage'] },\n}\n\nexport const metadata = routeMetadata\n\n// The list endpoint projects raw column names \u2014 snake_case.\nconst billingItemListItemSchema = z.object({\n  id: z.string().uuid(),\n  bill_account_id: z.string().uuid(),\n  bill_account_name: z.string().nullable(),\n  /** Spec F (F2): the owning account's currency and mode, for the form. */\n  bill_account_currency: z.string().nullable(),\n  bill_account_mode: z.enum(['postpaid', 'prepaid']).nullable(),\n  type: z.string(),\n  bill_start_date: z.string(),\n  bill_end_date: z.string().nullable(),\n  description: z.string(),\n  rate_json: z.record(z.string(), z.unknown()),\n  uom_code: z.string().nullable(),\n  subscription_id: z.string().nullable(),\n  subscription_item_id: z.string().nullable(),\n  source_ref: z.string().nullable(),\n  currency_mismatch: z.boolean(),\n  billed_to_date: z.string().nullable(),\n  charge_timing: z.enum(['in_advance', 'in_arrears']),\n  prorate: z.boolean(),\n  tax_rate: z.union([z.string(), z.number()]),\n  price_basis: z.enum(['net', 'gross']),\n  is_active: z.boolean(),\n  organization_id: z.string().uuid(),\n  tenant_id: z.string().uuid(),\n  created_at: z.string(),\n  updated_at: z.string(),\n})\n\n// Response for create includes `deduplicated` so integrators can tell\n// whether their POST resulted in a new row or hit the idempotency\n// short-circuit on `source_ref`.\nconst itemCreateResponseSchema = z.object({\n  id: z.string().uuid().nullable(),\n  deduplicated: z.boolean(),\n})\n\nconst rawBodySchema = z.object({}).passthrough()\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: BillingItem,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n    softDeleteField: 'deletedAt',\n  },\n  list: {\n    schema: billingItemListQuerySchema,\n    entityId: billingEntityIds.item,\n    fields: [\n      'id',\n      'bill_account_id',\n      'type',\n      'bill_start_date',\n      'bill_end_date',\n      'description',\n      'rate_json',\n      'uom_code',\n      'subscription_id',\n      'subscription_item_id',\n      'source_ref',\n      'currency_mismatch',\n      'billed_to_date',\n      'charge_timing',\n      'prorate',\n      'tax_rate',\n      'price_basis',\n      'is_active',\n      'organization_id',\n      'tenant_id',\n      'created_at',\n      'updated_at',\n    ],\n    sortFieldMap: {\n      createdAt: 'created_at',\n      updatedAt: 'updated_at',\n      billStartDate: 'bill_start_date',\n      billEndDate: 'bill_end_date',\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 item through this filter.\n      if (typeof query.id === 'string' && query.id) {\n        filters.id = { $eq: query.id }\n      }\n      if (typeof query.search === 'string' && query.search.trim()) {\n        const pattern = `%${query.search.trim().replace(/[%_]/g, (m) => `\\\\${m}`)}%`\n        filters.description = { $ilike: pattern }\n      }\n      if (typeof query.billAccountId === 'string' && query.billAccountId) {\n        filters.bill_account_id = { $eq: query.billAccountId }\n      }\n      if (typeof query.type === 'string' && query.type) {\n        filters.type = { $eq: query.type }\n      }\n      if (typeof query.subscriptionId === 'string' && query.subscriptionId) {\n        filters.subscription_id = { $eq: query.subscriptionId }\n      }\n      if (typeof query.isActive === 'boolean') {\n        filters.is_active = { $eq: query.isActive }\n      }\n      // `activeAt=<date>` returns items whose validity window covers\n      // the supplied date (Bill Run engine uses the same predicate\n      // shape internally \u2014 see spec \"Mid-cycle recurring items\").\n      if (query.activeAt instanceof Date) {\n        filters.bill_start_date = { $lte: query.activeAt }\n        filters.$or = [\n          { bill_end_date: null },\n          { bill_end_date: { $gte: query.activeAt } },\n        ]\n      }\n      return filters\n    },\n  },\n  actions: {\n    create: {\n      commandId: 'billing.items.create',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemCreateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({\n        id: result?.id ?? null,\n        deduplicated: Boolean(result?.deduplicated),\n      }),\n      // Idempotent create returns 200 (vs 201). The spec mandates\n      // duplicate POST returns the existing row, never creates a\n      // duplicate \u2014 keeping the success status consistent makes\n      // client-side handling trivial.\n      status: 200,\n    },\n    update: {\n      commandId: 'billing.items.update',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return billingItemUpdateSchema.parse(scoped)\n      },\n      response: () => ({ ok: true }),\n    },\n    delete: {\n      commandId: 'billing.items.delete',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        // The factory hands delete a `{ body, query }` envelope \u2014 the\n        // id may arrive in either, depending on the caller.\n        const envelope = (raw ?? {}) as {\n          body?: Record<string, unknown>\n          query?: Record<string, unknown>\n        }\n        const body = envelope.body ?? {}\n        const query = envelope.query ?? {}\n        const scoped = withScopedPayload(body, ctx, translate)\n        const id =\n          (typeof body.id === 'string' && body.id) ||\n          (typeof query.id === 'string' && query.id) ||\n          null\n        if (!id) {\n          throw new Error('id is required')\n        }\n        return {\n          id,\n          tenantId: (scoped as { tenantId?: string }).tenantId,\n          organizationId: (scoped as { organizationId?: string }).organizationId,\n        }\n      },\n      response: () => ({ ok: true }),\n    },\n  },\n  hooks: {\n    // Items reference their account by FK id only; the list + detail UI\n    // wants the account name, currency and mode. One bounded query\n    // (\u2264 pageSize ids) resolves it after the page is fetched.\n    afterList: async (payload: unknown, ctx: unknown) => {\n      const items = ((payload as { items?: unknown[] } | null)?.items ?? []) as Array<\n        Record<string, unknown>\n      >\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      if (accountIds.length === 0) return\n      const em = (ctx as { container: AwilixContainer }).container.resolve<EntityManager>('em')\n      const accounts = await em.find(BillingAccount, { id: { $in: accountIds } })\n      const byId = new Map(accounts.map((a) => [String(a.id), a] as const))\n      for (const row of items) {\n        const account = byId.get(String(row.bill_account_id))\n        row.bill_account_name = account?.name ?? null\n        row.bill_account_currency = account?.currencyCode ?? null\n        row.bill_account_mode = account?.billingMode ?? null\n      }\n    },\n  },\n})\n\nconst { POST, PUT, DELETE } = crud\nexport { POST, PUT, DELETE }\nexport const GET = crud.GET\n\nexport const openApi = createBillingCrudOpenApi({\n  resourceName: 'BillingItem',\n  pluralName: 'BillingItems',\n  querySchema: billingItemListQuerySchema,\n  listResponseSchema: createPagedListResponseSchema(billingItemListItemSchema),\n  create: {\n    schema: billingItemCreateSchema,\n    responseSchema: itemCreateResponseSchema,\n    description:\n      'Creates a billing item. Idempotent via `sourceRef`: re-POSTing the same ' +\n      '`(tenantId, billAccountId, sourceRef)` returns the existing row with ' +\n      '`deduplicated: true` instead of creating a duplicate. The unique index ' +\n      'on `(tenant_id, bill_account_id, source_ref)` is the correctness gate. ' +\n      'Recurring items accept `chargeTiming` (`in_advance` default | `in_arrears`) and ' +\n      '`prorate` (default true); other types reject non-default values (400).',\n  },\n  update: {\n    schema: billingItemUpdateSchema,\n    responseSchema: defaultOkResponseSchema,\n    description:\n      'Updates a billing item. `type` and `sourceRef` are immutable \u2014 to change ' +\n      'either, soft-delete the item and create a new one. `chargeTiming` / `prorate` ' +\n      'may change at any time on recurring items \u2014 billing resumes from `billed_to_date`, ' +\n      'so no day is billed twice.',\n  },\n  del: {\n    schema: z.object({ id: z.string().uuid() }),\n    responseSchema: defaultOkResponseSchema,\n    description: 'Soft-deletes a billing item.',\n  },\n})\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/api/payment-imports/[id]/route.js

@@ -0,0 +1,49 @@
+import { NextResponse } from "next/server";
+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";
+const metadata = {
+  GET: { requireAuth: true, requireFeatures: ["billing.payment.view"] }
+};
+async function GET(req, { params }) {
+  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 { id } = await params;
+    const em = container.resolve("em").fork();
+    const rows = await em.execute(
+      `SELECT id, file_name, row_count, counts, errors, user_id, created_at
+         FROM billing_payment_imports
+        WHERE id = ? AND tenant_id = ? AND organization_id = ? AND deleted_at IS NULL`,
+      [id, auth.tenantId, organizationId]
+    );
+    if (!rows?.length) return NextResponse.json({ error: "Import not found" }, { status: 404 });
+    return NextResponse.json({ import: rows[0] });
+  } catch (err) {
+    console.error("[billing/payment-imports/[id].GET]", err);
+    return NextResponse.json({ error: "Internal error" }, { status: 500 });
+  }
+}
+const openApi = {
+  methods: {
+    GET: {
+      tags: ["Billing"],
+      summary: "Get a payment import batch",
+      description: "Counts per outcome and the row errors (line number + message, capped at 200).",
+      responses: [{ status: 200, description: "`{ import }`" }],
+      errors: [{ status: 404, description: "Import not found" }]
+    }
+  }
+};
+export {
+  GET,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/billing/api/payment-imports/[id]/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/billing/api/payment-imports/%5Bid%5D/route.ts"],
+  "sourcesContent": ["import { NextResponse } from 'next/server'\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'\n\n/** `GET /api/billing/payment-imports/[id]` \u2014 one upload batch with its row errors (Spec C). */\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['billing.payment.view'] },\n}\n\nexport async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {\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 { id } = await params\n    const em = (container.resolve('em') as EntityManager).fork()\n    const rows = (await em.execute(\n      `SELECT id, file_name, row_count, counts, errors, user_id, created_at\n         FROM billing_payment_imports\n        WHERE id = ? AND tenant_id = ? AND organization_id = ? AND deleted_at IS NULL`,\n      [id, auth.tenantId, organizationId],\n    )) as unknown as Array<Record<string, unknown>>\n    if (!rows?.length) return NextResponse.json({ error: 'Import not found' }, { status: 404 })\n    return NextResponse.json({ import: rows[0] })\n  } catch (err) {\n    console.error('[billing/payment-imports/[id].GET]', err)\n    return NextResponse.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n\nexport const openApi = {\n  methods: {\n    GET: {\n      tags: ['Billing'],\n      summary: 'Get a payment import batch',\n      description: 'Counts per outcome and the row errors (line number + message, capped at 200).',\n      responses: [{ status: 200, description: '`{ import }`' }],\n      errors: [{ status: 404, description: 'Import not found' }],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAE7B,SAAS,8BAA8B;AACvC,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAIA,MAAM,WAAW;AAAA,EACtB,KAAK,EAAE,aAAa,MAAM,iBAAiB,CAAC,sBAAsB,EAAE;AACtE;AAEA,eAAsB,IAAI,KAAc,EAAE,OAAO,GAAwC;AACvF,MAAI;AACF,UAAM,YAAY,MAAM,uBAAuB;AAC/C,UAAM,OAAO,MAAM,mBAAmB,GAAG;AACzC,QAAI,CAAC,QAAQ,CAAC,KAAK,SAAU,QAAO,aAAa,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;AAChG,UAAM,iBAAiB,4BAA4B,IAAI;AACvD,QAAI,CAAC,eAAgB,QAAO,kCAAkC;AAC9D,UAAM,EAAE,GAAG,IAAI,MAAM;AACrB,UAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC3D,UAAM,OAAQ,MAAM,GAAG;AAAA,MACrB;AAAA;AAAA;AAAA,MAGA,CAAC,IAAI,KAAK,UAAU,cAAc;AAAA,IACpC;AACA,QAAI,CAAC,MAAM,OAAQ,QAAO,aAAa,KAAK,EAAE,OAAO,mBAAmB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAC1F,WAAO,aAAa,KAAK,EAAE,QAAQ,KAAK,CAAC,EAAE,CAAC;AAAA,EAC9C,SAAS,KAAK;AACZ,YAAQ,MAAM,sCAAsC,GAAG;AACvD,WAAO,aAAa,KAAK,EAAE,OAAO,iBAAiB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACvE;AACF;AAEO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,IACP,KAAK;AAAA,MACH,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,MACT,aAAa;AAAA,MACb,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,eAAe,CAAC;AAAA,MACxD,QAAQ,CAAC,EAAE,QAAQ,KAAK,aAAa,mBAAmB,CAAC;AAAA,IAC3D;AAAA,EACF;AACF;",
+  "names": []
+}