@dainamite/billing 0.17.0

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

@@ -0,0 +1,224 @@
+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 { BillingAccount, BillingItem } from "../../data/entities.js";
+import { billingEntityIds } from "../../data/entityIds.js";
+import {
+  billingItemCreateSchema,
+  billingItemListQuerySchema,
+  billingItemUpdateSchema
+} from "../../data/validators.js";
+import {
+  createBillingCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultOkResponseSchema
+} from "../openapi.js";
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ["billing.item.view"] },
+  POST: { requireAuth: true, requireFeatures: ["billing.item.manage"] },
+  PUT: { requireAuth: true, requireFeatures: ["billing.item.manage"] },
+  DELETE: { requireAuth: true, requireFeatures: ["billing.item.manage"] }
+};
+const metadata = routeMetadata;
+const billingItemListItemSchema = z.object({
+  id: z.string().uuid(),
+  bill_account_id: z.string().uuid(),
+  bill_account_name: z.string().nullable(),
+  type: z.string(),
+  bill_start_date: z.string(),
+  bill_end_date: z.string().nullable(),
+  description: z.string(),
+  rate_json: z.record(z.string(), z.unknown()),
+  uom_code: z.string().nullable(),
+  subscription_id: z.string().nullable(),
+  subscription_item_id: z.string().nullable(),
+  source_ref: z.string().nullable(),
+  currency_mismatch: z.boolean(),
+  billed_to_date: z.string().nullable(),
+  is_active: z.boolean(),
+  organization_id: z.string().uuid(),
+  tenant_id: z.string().uuid(),
+  created_at: z.string(),
+  updated_at: z.string()
+});
+const itemCreateResponseSchema = z.object({
+  id: z.string().uuid().nullable(),
+  deduplicated: z.boolean()
+});
+const rawBodySchema = z.object({}).passthrough();
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: BillingItem,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId",
+    softDeleteField: "deletedAt"
+  },
+  list: {
+    schema: billingItemListQuerySchema,
+    entityId: billingEntityIds.item,
+    fields: [
+      "id",
+      "bill_account_id",
+      "type",
+      "bill_start_date",
+      "bill_end_date",
+      "description",
+      "rate_json",
+      "uom_code",
+      "subscription_id",
+      "subscription_item_id",
+      "source_ref",
+      "currency_mismatch",
+      "billed_to_date",
+      "is_active",
+      "organization_id",
+      "tenant_id",
+      "created_at",
+      "updated_at"
+    ],
+    sortFieldMap: {
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+      billStartDate: "bill_start_date",
+      billEndDate: "bill_end_date"
+    },
+    buildFilters: async (query) => {
+      const filters = {};
+      if (typeof query.id === "string" && query.id) {
+        filters.id = { $eq: query.id };
+      }
+      if (typeof query.search === "string" && query.search.trim()) {
+        const pattern = `%${query.search.trim().replace(/[%_]/g, (m) => `\\${m}`)}%`;
+        filters.description = { $ilike: pattern };
+      }
+      if (typeof query.billAccountId === "string" && query.billAccountId) {
+        filters.bill_account_id = { $eq: query.billAccountId };
+      }
+      if (typeof query.type === "string" && query.type) {
+        filters.type = { $eq: query.type };
+      }
+      if (typeof query.subscriptionId === "string" && query.subscriptionId) {
+        filters.subscription_id = { $eq: query.subscriptionId };
+      }
+      if (typeof query.isActive === "boolean") {
+        filters.is_active = { $eq: query.isActive };
+      }
+      if (query.activeAt instanceof Date) {
+        filters.bill_start_date = { $lte: query.activeAt };
+        filters.$or = [
+          { bill_end_date: null },
+          { bill_end_date: { $gte: query.activeAt } }
+        ];
+      }
+      return filters;
+    }
+  },
+  actions: {
+    create: {
+      commandId: "billing.items.create",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return billingItemCreateSchema.parse(scoped);
+      },
+      response: ({ result }) => ({
+        id: result?.id ?? null,
+        deduplicated: Boolean(result?.deduplicated)
+      }),
+      // Idempotent create returns 200 (vs 201). The spec mandates
+      // duplicate POST returns the existing row, never creates a
+      // duplicate — keeping the success status consistent makes
+      // client-side handling trivial.
+      status: 200
+    },
+    update: {
+      commandId: "billing.items.update",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return billingItemUpdateSchema.parse(scoped);
+      },
+      response: () => ({ ok: true })
+    },
+    delete: {
+      commandId: "billing.items.delete",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const envelope = raw ?? {};
+        const body = envelope.body ?? {};
+        const query = envelope.query ?? {};
+        const scoped = withScopedPayload(body, ctx, translate);
+        const id = typeof body.id === "string" && body.id || typeof query.id === "string" && query.id || null;
+        if (!id) {
+          throw new Error("id is required");
+        }
+        return {
+          id,
+          tenantId: scoped.tenantId,
+          organizationId: scoped.organizationId
+        };
+      },
+      response: () => ({ ok: true })
+    }
+  },
+  hooks: {
+    // Items reference their account by FK id only; the list + detail UI
+    // wants the human-readable account name. One bounded query
+    // (≤ pageSize ids) resolves it after the page is fetched.
+    afterList: async (payload, ctx) => {
+      const items = payload?.items ?? [];
+      const accountIds = Array.from(
+        new Set(
+          items.map((row) => row.bill_account_id).filter((v) => typeof v === "string" && v.length > 0)
+        )
+      );
+      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])
+      );
+      for (const row of items) {
+        row.bill_account_name = nameById.get(String(row.bill_account_id)) ?? null;
+      }
+    }
+  }
+});
+const { POST, PUT, DELETE } = crud;
+const GET = crud.GET;
+const openApi = createBillingCrudOpenApi({
+  resourceName: "BillingItem",
+  pluralName: "BillingItems",
+  querySchema: billingItemListQuerySchema,
+  listResponseSchema: createPagedListResponseSchema(billingItemListItemSchema),
+  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."
+  },
+  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."
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: "Soft-deletes a billing item."
+  }
+});
+export {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

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

@@ -0,0 +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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",
+  "names": []
+}

package/dist/modules/billing/api/openapi.js

@@ -0,0 +1,25 @@
+import {
+  createCrudOpenApiFactory,
+  createPagedListResponseSchema as createSharedPagedListResponseSchema,
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema
+} from "@open-mercato/shared/lib/openapi/crud";
+const buildBillingCrudOpenApi = createCrudOpenApiFactory({
+  defaultTag: "Billing",
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema,
+  makeListDescription: ({ pluralLower }) => `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`
+});
+function createBillingCrudOpenApi(options) {
+  return buildBillingCrudOpenApi(options);
+}
+function createPagedListResponseSchema(itemSchema) {
+  return createSharedPagedListResponseSchema(itemSchema, { paginationMetaOptional: true });
+}
+export {
+  createBillingCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema
+};
+//# sourceMappingURL=openapi.js.map

package/dist/modules/billing/api/openapi.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/api/openapi.ts"],
+  "sourcesContent": ["import {\n  createCrudOpenApiFactory,\n  createPagedListResponseSchema as createSharedPagedListResponseSchema,\n  defaultCreateResponseSchema,\n  defaultOkResponseSchema,\n  type CrudOpenApiOptions,\n} from '@open-mercato/shared/lib/openapi/crud'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi/types'\nimport type { ZodTypeAny } from 'zod'\n\n/**\n * Billing CRUD OpenAPI factory. Every billing API route imports this\n * and calls it with the resource's `create` / `update` / `del` schemas\n * \u2014 the framework picks up the resulting `openApi` export and merges\n * it into the global API documentation bundle.\n */\nconst buildBillingCrudOpenApi = createCrudOpenApiFactory({\n  defaultTag: 'Billing',\n  defaultCreateResponseSchema,\n  defaultOkResponseSchema,\n  makeListDescription: ({ pluralLower }) =>\n    `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`,\n})\n\nexport function createBillingCrudOpenApi(options: CrudOpenApiOptions): OpenApiRouteDoc {\n  return buildBillingCrudOpenApi(options)\n}\n\nexport function createPagedListResponseSchema(itemSchema: ZodTypeAny) {\n  return createSharedPagedListResponseSchema(itemSchema, { paginationMetaOptional: true })\n}\n\nexport { defaultCreateResponseSchema, defaultOkResponseSchema }\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA,iCAAiC;AAAA,EACjC;AAAA,EACA;AAAA,OAEK;AAUP,MAAM,0BAA0B,yBAAyB;AAAA,EACvD,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA,qBAAqB,CAAC,EAAE,YAAY,MAClC,qCAAqC,WAAW;AACpD,CAAC;AAEM,SAAS,yBAAyB,SAA8C;AACrF,SAAO,wBAAwB,OAAO;AACxC;AAEO,SAAS,8BAA8B,YAAwB;AACpE,SAAO,oCAAoC,YAAY,EAAE,wBAAwB,KAAK,CAAC;AACzF;",
+  "names": []
+}

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

@@ -0,0 +1,122 @@
+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 { billingEntityIds } from "../../data/entityIds.js";
+import {
+  BILL_RUN_OUTCOME_STATUSES
+} from "../../data/validators.js";
+import { createBillingCrudOpenApi, createPagedListResponseSchema } from "../openapi.js";
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ["billing.run.view"] }
+};
+const metadata = routeMetadata;
+const listQuerySchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  pageSize: z.coerce.number().int().min(1).max(100).default(50),
+  sortField: z.string().optional(),
+  sortDir: z.enum(["asc", "desc"]).optional(),
+  billRunId: z.string().uuid().optional(),
+  billAccountId: z.string().uuid().optional(),
+  status: z.enum(BILL_RUN_OUTCOME_STATUSES).optional()
+}).passthrough();
+const billRunOutcomeListItemSchema = z.object({
+  id: z.string().uuid(),
+  billRunId: z.string().uuid(),
+  billAccountId: z.string().uuid(),
+  status: z.string(),
+  errorMessage: z.string().nullable(),
+  warnings: z.record(z.string(), z.unknown()).nullable(),
+  draftInvoiceId: z.string().uuid().nullable(),
+  bill_account_name: z.string().nullable(),
+  invoice_number: z.string().nullable(),
+  organizationId: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: BillRunOutcome,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId",
+    softDeleteField: "deletedAt"
+  },
+  list: {
+    schema: listQuerySchema,
+    entityId: billingEntityIds.runOutcome,
+    fields: [
+      "id",
+      "bill_run_id",
+      "bill_account_id",
+      "status",
+      "error_message",
+      "warnings",
+      "draft_invoice_id",
+      "organization_id",
+      "tenant_id",
+      "created_at",
+      "updated_at"
+    ],
+    sortFieldMap: {
+      createdAt: "created_at"
+    },
+    buildFilters: async (query) => {
+      const filters = {};
+      if (typeof query.billRunId === "string") filters.bill_run_id = { $eq: query.billRunId };
+      if (typeof query.billAccountId === "string") {
+        filters.bill_account_id = { $eq: query.billAccountId };
+      }
+      if (typeof query.status === "string") filters.status = { $eq: query.status };
+      return filters;
+    }
+  },
+  hooks: {
+    // Outcomes reference account + draft invoice by FK id only. The
+    // run detail UI wants names — resolve both in two bounded queries.
+    afterList: async (payload, ctx) => {
+      const items = payload?.items ?? [];
+      if (items.length === 0) return;
+      const em = ctx.container.resolve("em");
+      const accountIds = Array.from(
+        new Set(
+          items.map((row) => row.bill_account_id).filter((v) => typeof v === "string" && v.length > 0)
+        )
+      );
+      const invoiceIds = Array.from(
+        new Set(
+          items.map((row) => row.draft_invoice_id).filter((v) => typeof v === "string" && v.length > 0)
+        )
+      );
+      const [accounts, invoices] = await Promise.all([
+        accountIds.length ? em.find(BillingAccount, { id: { $in: accountIds } }) : [],
+        invoiceIds.length ? em.find(SalesInvoice, { id: { $in: invoiceIds } }) : []
+      ]);
+      const accountName = new Map(
+        accounts.map((a) => [String(a.id), a.name])
+      );
+      const invoiceNumber = new Map(
+        invoices.map((i) => [String(i.id), i.invoiceNumber])
+      );
+      for (const row of items) {
+        row.bill_account_name = accountName.get(String(row.bill_account_id)) ?? null;
+        row.invoice_number = typeof row.draft_invoice_id === "string" ? invoiceNumber.get(row.draft_invoice_id) ?? null : null;
+      }
+    }
+  }
+});
+const GET = crud.GET;
+const openApi = createBillingCrudOpenApi({
+  resourceName: "BillRunOutcome",
+  pluralName: "BillRunOutcomes",
+  querySchema: listQuerySchema,
+  listResponseSchema: createPagedListResponseSchema(billRunOutcomeListItemSchema)
+});
+export {
+  GET,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

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

@@ -0,0 +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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",
+  "names": []
+}

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

@@ -0,0 +1,70 @@
+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 { billingEntityIds } from "../../../data/entityIds.js";
+import { billingRunRetryFailedSchema } from "../../../data/validators.js";
+import { createBillingCrudOpenApi } from "../../openapi.js";
+const routeMetadata = {
+  POST: { requireAuth: true, requireFeatures: ["billing.run.trigger"] }
+};
+const metadata = routeMetadata;
+const retryResponseSchema = z.object({
+  billRunId: z.string().uuid(),
+  status: z.string(),
+  outcomesCount: z.number().int().nonnegative()
+});
+const rawBodySchema = z.object({}).passthrough();
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: BillRun,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId",
+    softDeleteField: "deletedAt"
+  },
+  // No `list` — POST-only route. Keep a stub so the factory type-checks.
+  list: {
+    schema: z.object({}).passthrough(),
+    entityId: billingEntityIds.run,
+    fields: ["id"],
+    buildFilters: async () => ({})
+  },
+  actions: {
+    create: {
+      commandId: "billing.runs.retry_failed",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return billingRunRetryFailedSchema.parse(scoped);
+      },
+      response: ({ result }) => ({
+        billRunId: result?.billRunId ?? null,
+        status: result?.status ?? null,
+        outcomesCount: result?.outcomesCount ?? 0
+      }),
+      status: 201
+    }
+  }
+});
+const POST = crud.POST;
+const openApi = createBillingCrudOpenApi({
+  resourceName: "BillRunRetry",
+  pluralName: "BillRunRetries",
+  querySchema: z.object({}).passthrough(),
+  listResponseSchema: z.object({ items: z.array(z.unknown()) }),
+  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."
+  }
+});
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

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

@@ -0,0 +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;",
+  "names": []
+}