@dainamite/billing 0.17.0

package/dist/modules/billing/commands/items.js

@@ -0,0 +1,317 @@
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import {
+  ensureOrganizationScope,
+  ensureTenantScope
+} from "@open-mercato/shared/lib/commands/scope";
+import {
+  emitCrudSideEffects,
+  requireId
+} from "@open-mercato/shared/lib/commands/helpers";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillingAccount, BillingItem } from "../data/entities.js";
+import { billingEntityIds } from "../data/entityIds.js";
+import { findBySourceRef } from "../lib/idempotency.js";
+import {
+  billingItemBulkCreateSchema,
+  billingItemCreateSchema,
+  billingItemDeleteSchema,
+  billingItemUpdateSchema,
+  validateRateJson
+} from "../data/validators.js";
+const itemIndexer = { entityType: billingEntityIds.item };
+const itemEvents = { module: "billing", entity: "item", persistent: true };
+function getEm(ctx) {
+  return ctx.container.resolve("em").fork();
+}
+function getDataEngine(ctx) {
+  return ctx.container.resolve("dataEngine");
+}
+async function assertAccountInScope(em, params) {
+  const account = await em.findOne(BillingAccount, {
+    id: params.billAccountId,
+    tenantId: params.tenantId,
+    organizationId: params.organizationId,
+    deletedAt: null
+  });
+  if (!account) {
+    throw new CrudHttpError(404, { error: "Billing account not found" });
+  }
+  return account;
+}
+const createItemCommand = {
+  id: "billing.items.create",
+  async execute(rawInput, ctx) {
+    const parsed = billingItemCreateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const account = await assertAccountInScope(em, parsed);
+    if (parsed.sourceRef) {
+      const existing = await findBySourceRef(em, BillingItem, {
+        tenantId: parsed.tenantId,
+        billAccountId: parsed.billAccountId,
+        sourceRef: parsed.sourceRef
+      });
+      if (existing) {
+        return { id: existing.id, deduplicated: true };
+      }
+    }
+    validateRateJson(parsed.type, parsed.rateJson);
+    const now = /* @__PURE__ */ new Date();
+    const entity = em.create(BillingItem, {
+      organizationId: parsed.organizationId,
+      tenantId: parsed.tenantId,
+      billAccountId: account.id,
+      type: parsed.type,
+      billStartDate: parsed.billStartDate,
+      billEndDate: parsed.billEndDate ?? null,
+      description: parsed.description,
+      rateJson: parsed.rateJson,
+      uomCode: parsed.uomCode ?? null,
+      subscriptionId: parsed.subscriptionId ?? null,
+      subscriptionItemId: parsed.subscriptionItemId ?? null,
+      sourceRef: parsed.sourceRef ?? null,
+      // `currency_mismatch` is set by Phase 2 / connectors when the
+      // posted value's currency differs from the account's. Stays
+      // false on create (operator opts in to flagging).
+      currencyMismatch: false,
+      // `billed_to_date` is set by the Bill Run engine on the first
+      // real-run that emits this item. Always null on create.
+      billedToDate: null,
+      isActive: true,
+      createdAt: now,
+      updatedAt: now
+    });
+    em.persist(entity);
+    await em.flush();
+    await emitCrudSideEffects({
+      dataEngine: getDataEngine(ctx),
+      action: "created",
+      entity,
+      identifiers: {
+        id: entity.id,
+        tenantId: entity.tenantId,
+        organizationId: entity.organizationId
+      },
+      indexer: itemIndexer,
+      events: itemEvents
+    });
+    return { id: entity.id, deduplicated: false };
+  }
+};
+const updateItemCommand = {
+  id: "billing.items.update",
+  async execute(rawInput, ctx) {
+    const parsed = billingItemUpdateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const record = await em.findOne(BillingItem, {
+      id: parsed.id,
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      deletedAt: null
+    });
+    if (!record) {
+      throw new CrudHttpError(404, { error: "Billing item not found" });
+    }
+    if (parsed.billStartDate !== void 0) record.billStartDate = parsed.billStartDate;
+    if (parsed.billEndDate !== void 0) record.billEndDate = parsed.billEndDate;
+    if (parsed.description !== void 0) record.description = parsed.description;
+    if (parsed.rateJson !== void 0) {
+      validateRateJson(record.type, parsed.rateJson);
+      record.rateJson = parsed.rateJson;
+    }
+    if (parsed.uomCode !== void 0) record.uomCode = parsed.uomCode;
+    if (parsed.subscriptionId !== void 0) record.subscriptionId = parsed.subscriptionId;
+    if (parsed.subscriptionItemId !== void 0) {
+      record.subscriptionItemId = parsed.subscriptionItemId;
+    }
+    if (parsed.isActive !== void 0) record.isActive = parsed.isActive;
+    record.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    await emitCrudSideEffects({
+      dataEngine: getDataEngine(ctx),
+      action: "updated",
+      entity: record,
+      identifiers: {
+        id: record.id,
+        tenantId: record.tenantId,
+        organizationId: record.organizationId
+      },
+      indexer: itemIndexer,
+      events: itemEvents
+    });
+    return { id: record.id };
+  }
+};
+const deleteItemCommand = {
+  id: "billing.items.delete",
+  async execute(rawInput, ctx) {
+    const parsed = billingItemDeleteSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const id = requireId(parsed);
+    const em = getEm(ctx);
+    const record = await em.findOne(BillingItem, {
+      id,
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      deletedAt: null
+    });
+    if (!record) {
+      throw new CrudHttpError(404, { error: "Billing item not found" });
+    }
+    record.deletedAt = /* @__PURE__ */ new Date();
+    record.updatedAt = record.deletedAt;
+    await em.flush();
+    await emitCrudSideEffects({
+      dataEngine: getDataEngine(ctx),
+      action: "deleted",
+      entity: record,
+      identifiers: {
+        id: record.id,
+        tenantId: record.tenantId,
+        organizationId: record.organizationId
+      },
+      indexer: itemIndexer,
+      events: itemEvents
+    });
+    return { id: record.id };
+  }
+};
+const bulkCreateItemsCommand = {
+  id: "billing.items.bulk_create",
+  async execute(rawInput, ctx) {
+    const parsed = billingItemBulkCreateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const accountIds = Array.from(new Set(parsed.items.map((i) => i.billAccountId)));
+    const accounts = await em.find(BillingAccount, {
+      id: { $in: accountIds },
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      deletedAt: null
+    });
+    const knownAccountIds = new Set(accounts.map((a) => a.id));
+    const missingAccount = accountIds.find((id) => !knownAccountIds.has(id));
+    if (missingAccount) {
+      throw new CrudHttpError(404, {
+        error: "Billing account not found",
+        billAccountId: missingAccount
+      });
+    }
+    const sourceRefs = parsed.items.map((i) => i.sourceRef).filter((ref) => typeof ref === "string" && ref.length > 0);
+    const existingBySourceKey = /* @__PURE__ */ new Map();
+    if (sourceRefs.length > 0) {
+      const existing = await em.find(BillingItem, {
+        tenantId: parsed.tenantId,
+        organizationId: parsed.organizationId,
+        billAccountId: { $in: accountIds },
+        sourceRef: { $in: Array.from(new Set(sourceRefs)) },
+        deletedAt: null
+      });
+      for (const row of existing) {
+        if (row.sourceRef) {
+          existingBySourceKey.set(`${row.billAccountId}::${row.sourceRef}`, row.id);
+        }
+      }
+    }
+    const now = /* @__PURE__ */ new Date();
+    const results = [];
+    const createdEntities = [];
+    const deferredIdLinks = [];
+    const seenInBatch = /* @__PURE__ */ new Set();
+    for (const entry of parsed.items) {
+      const sourceKey = entry.sourceRef ? `${entry.billAccountId}::${entry.sourceRef}` : null;
+      if (sourceKey) {
+        const existingId = existingBySourceKey.get(sourceKey);
+        if (existingId) {
+          results.push({ sourceRef: entry.sourceRef ?? null, id: existingId, deduplicated: true });
+          continue;
+        }
+        if (seenInBatch.has(sourceKey)) {
+          const firstCreated = createdEntities.find(
+            (e) => e.billAccountId === entry.billAccountId && e.sourceRef === entry.sourceRef
+          );
+          const dedupResult = {
+            sourceRef: entry.sourceRef ?? null,
+            id: "",
+            deduplicated: true
+          };
+          results.push(dedupResult);
+          if (firstCreated) deferredIdLinks.push({ result: dedupResult, entity: firstCreated });
+          continue;
+        }
+        seenInBatch.add(sourceKey);
+      }
+      validateRateJson(entry.type, entry.rateJson);
+      const item = em.create(BillingItem, {
+        organizationId: parsed.organizationId,
+        tenantId: parsed.tenantId,
+        billAccountId: entry.billAccountId,
+        type: entry.type,
+        billStartDate: entry.billStartDate,
+        billEndDate: entry.billEndDate ?? null,
+        description: entry.description,
+        rateJson: entry.rateJson,
+        uomCode: entry.uomCode ?? null,
+        subscriptionId: entry.subscriptionId ?? null,
+        subscriptionItemId: entry.subscriptionItemId ?? null,
+        sourceRef: entry.sourceRef ?? null,
+        currencyMismatch: false,
+        billedToDate: null,
+        isActive: true,
+        createdAt: now,
+        updatedAt: now
+      });
+      em.persist(item);
+      createdEntities.push(item);
+      const createdResult = {
+        sourceRef: entry.sourceRef ?? null,
+        id: "",
+        deduplicated: false
+      };
+      results.push(createdResult);
+      deferredIdLinks.push({ result: createdResult, entity: item });
+    }
+    if (createdEntities.length > 0) {
+      await em.flush();
+    }
+    for (const link of deferredIdLinks) {
+      link.result.id = link.entity.id;
+    }
+    const dataEngine = getDataEngine(ctx);
+    for (const item of createdEntities) {
+      await emitCrudSideEffects({
+        dataEngine,
+        action: "created",
+        entity: item,
+        identifiers: {
+          id: item.id,
+          tenantId: item.tenantId,
+          organizationId: item.organizationId
+        },
+        indexer: itemIndexer,
+        events: itemEvents
+      });
+    }
+    return {
+      created: createdEntities.length,
+      deduplicated: results.filter((r) => r.deduplicated).length,
+      items: results
+    };
+  }
+};
+registerCommand(createItemCommand);
+registerCommand(updateItemCommand);
+registerCommand(deleteItemCommand);
+registerCommand(bulkCreateItemsCommand);
+export {
+  bulkCreateItemsCommand,
+  createItemCommand,
+  deleteItemCommand,
+  updateItemCommand
+};
+//# sourceMappingURL=items.js.map

package/dist/modules/billing/commands/items.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/commands/items.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { CommandHandler, CommandRuntimeContext } from '@open-mercato/shared/lib/commands/types'\nimport { registerCommand } from '@open-mercato/shared/lib/commands'\nimport {\n  ensureOrganizationScope,\n  ensureTenantScope,\n} from '@open-mercato/shared/lib/commands/scope'\nimport {\n  emitCrudSideEffects,\n  requireId,\n} from '@open-mercato/shared/lib/commands/helpers'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport { BillingAccount, BillingItem } from '../data/entities'\nimport { billingEntityIds } from '../data/entityIds'\nimport { findBySourceRef } from '../lib/idempotency'\nimport {\n  billingItemBulkCreateSchema,\n  billingItemCreateSchema,\n  billingItemDeleteSchema,\n  billingItemUpdateSchema,\n  validateRateJson,\n  type BillingItemBulkCreateInput,\n  type BillingItemCreateInput,\n  type BillingItemDeleteInput,\n  type BillingItemUpdateInput,\n} from '../data/validators'\n\n/**\n * BillingItem writes \u2014 create / update / soft-delete.\n *\n * Create is idempotent via `source_ref`: if the integrator POSTs the\n * same `(tenant_id, bill_account_id, source_ref)` twice, the second\n * call returns the existing item with `deduplicated: true`. The\n * underlying unique index is the correctness gate; this pre-check keeps\n * the happy path single-round-trip and the response body informative.\n */\n\nconst itemIndexer = { entityType: billingEntityIds.item } as const\nconst itemEvents = { module: 'billing', entity: 'item', persistent: true } as const\n\nfunction getEm(ctx: CommandRuntimeContext): EntityManager {\n  return (ctx.container.resolve('em') as EntityManager).fork()\n}\n\nfunction getDataEngine(ctx: CommandRuntimeContext): DataEngine {\n  return ctx.container.resolve('dataEngine') as DataEngine\n}\n\nasync function assertAccountInScope(\n  em: EntityManager,\n  params: { tenantId: string; organizationId: string; billAccountId: string },\n): Promise<BillingAccount> {\n  const account = await em.findOne(BillingAccount, {\n    id: params.billAccountId,\n    tenantId: params.tenantId,\n    organizationId: params.organizationId,\n    deletedAt: null,\n  })\n  if (!account) {\n    throw new CrudHttpError(404, { error: 'Billing account not found' })\n  }\n  return account\n}\n\n// \u2500\u2500\u2500 Create (idempotent) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 createItemCommand: CommandHandler<\n  BillingItemCreateInput,\n  { id: string; deduplicated: boolean }\n> = {\n  id: 'billing.items.create',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingItemCreateSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n    const account = await assertAccountInScope(em, parsed)\n\n    // Idempotency: if `source_ref` provided and matches an existing\n    // (non-deleted) row, return that row. The unique index is the\n    // final correctness gate \u2014 this is the happy-path early return.\n    if (parsed.sourceRef) {\n      const existing = await findBySourceRef(em, BillingItem, {\n        tenantId: parsed.tenantId,\n        billAccountId: parsed.billAccountId,\n        sourceRef: parsed.sourceRef,\n      })\n      if (existing) {\n        return { id: existing.id, deduplicated: true }\n      }\n    }\n\n    // Re-validate the rate_json shape against the resolved type to\n    // future-proof against schema drift between the API surface and\n    // the persistence layer.\n    validateRateJson(parsed.type, parsed.rateJson)\n\n    const now = new Date()\n    const entity = em.create(BillingItem, {\n      organizationId: parsed.organizationId,\n      tenantId: parsed.tenantId,\n      billAccountId: account.id,\n      type: parsed.type,\n      billStartDate: parsed.billStartDate,\n      billEndDate: parsed.billEndDate ?? null,\n      description: parsed.description,\n      rateJson: parsed.rateJson as Record<string, unknown>,\n      uomCode: parsed.uomCode ?? null,\n      subscriptionId: parsed.subscriptionId ?? null,\n      subscriptionItemId: parsed.subscriptionItemId ?? null,\n      sourceRef: parsed.sourceRef ?? null,\n      // `currency_mismatch` is set by Phase 2 / connectors when the\n      // posted value's currency differs from the account's. Stays\n      // false on create (operator opts in to flagging).\n      currencyMismatch: false,\n      // `billed_to_date` is set by the Bill Run engine on the first\n      // real-run that emits this item. Always null on create.\n      billedToDate: null,\n      isActive: true,\n      createdAt: now,\n      updatedAt: now,\n    })\n    em.persist(entity)\n    await em.flush()\n\n    await emitCrudSideEffects({\n      dataEngine: getDataEngine(ctx),\n      action: 'created',\n      entity,\n      identifiers: {\n        id: entity.id,\n        tenantId: entity.tenantId,\n        organizationId: entity.organizationId,\n      },\n      indexer: itemIndexer,\n      events: itemEvents,\n    })\n\n    return { id: entity.id, deduplicated: false }\n  },\n}\n\n// \u2500\u2500\u2500 Update \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 updateItemCommand: CommandHandler<BillingItemUpdateInput, { id: string }> = {\n  id: 'billing.items.update',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingItemUpdateSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n    const record = await em.findOne(BillingItem, {\n      id: parsed.id,\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      deletedAt: null,\n    })\n    if (!record) {\n      throw new CrudHttpError(404, { error: 'Billing item not found' })\n    }\n\n    if (parsed.billStartDate !== undefined) record.billStartDate = parsed.billStartDate\n    if (parsed.billEndDate !== undefined) record.billEndDate = parsed.billEndDate\n    if (parsed.description !== undefined) record.description = parsed.description\n    if (parsed.rateJson !== undefined) {\n      // Re-validate against the current (immutable) type before persist.\n      validateRateJson(record.type as 'one_time' | 'recurring' | 'usage', parsed.rateJson)\n      record.rateJson = parsed.rateJson as Record<string, unknown>\n    }\n    if (parsed.uomCode !== undefined) record.uomCode = parsed.uomCode\n    if (parsed.subscriptionId !== undefined) record.subscriptionId = parsed.subscriptionId\n    if (parsed.subscriptionItemId !== undefined) {\n      record.subscriptionItemId = parsed.subscriptionItemId\n    }\n    if (parsed.isActive !== undefined) record.isActive = parsed.isActive\n\n    record.updatedAt = new Date()\n    await em.flush()\n\n    await emitCrudSideEffects({\n      dataEngine: getDataEngine(ctx),\n      action: 'updated',\n      entity: record,\n      identifiers: {\n        id: record.id,\n        tenantId: record.tenantId,\n        organizationId: record.organizationId,\n      },\n      indexer: itemIndexer,\n      events: itemEvents,\n    })\n\n    return { id: record.id }\n  },\n}\n\n// \u2500\u2500\u2500 Delete (soft) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 deleteItemCommand: CommandHandler<BillingItemDeleteInput, { id: string }> = {\n  id: 'billing.items.delete',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingItemDeleteSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n    const id = requireId(parsed)\n\n    const em = getEm(ctx)\n    const record = await em.findOne(BillingItem, {\n      id,\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      deletedAt: null,\n    })\n    if (!record) {\n      throw new CrudHttpError(404, { error: 'Billing item not found' })\n    }\n\n    record.deletedAt = new Date()\n    record.updatedAt = record.deletedAt\n    await em.flush()\n\n    await emitCrudSideEffects({\n      dataEngine: getDataEngine(ctx),\n      action: 'deleted',\n      entity: record,\n      identifiers: {\n        id: record.id,\n        tenantId: record.tenantId,\n        organizationId: record.organizationId,\n      },\n      indexer: itemIndexer,\n      events: itemEvents,\n    })\n\n    return { id: record.id }\n  },\n}\n\n// \u2500\u2500\u2500 Bulk create (idempotent, batched) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Collapses N `billing.items.create` round-trips into one command.\n// The CPQ connector activating a large subscription is the primary\n// caller \u2014 it used to fire one create per charge.\n//\n// Idempotency is still per-`source_ref` but the existence check is a\n// SINGLE query over all source_refs in the batch, instead of one\n// `findOne` per item. Inserts are one `em.flush()` for the whole\n// batch. So a 200-charge activation goes from ~200 round-trips +\n// 200 flushes to ~3 queries + 1 flush.\n\ntype BulkCreateResultEntry = {\n  sourceRef: string | null\n  id: string\n  deduplicated: boolean\n}\n\nconst bulkCreateItemsCommand: CommandHandler<\n  BillingItemBulkCreateInput,\n  { created: number; deduplicated: number; items: BulkCreateResultEntry[] }\n> = {\n  id: 'billing.items.bulk_create',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingItemBulkCreateSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n\n    // Validate every referenced account exists + is in scope. One\n    // `$in` query for the distinct account ids, not one per item.\n    const accountIds = Array.from(new Set(parsed.items.map((i) => i.billAccountId)))\n    const accounts = await em.find(BillingAccount, {\n      id: { $in: accountIds },\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      deletedAt: null,\n    } as never)\n    const knownAccountIds = new Set(accounts.map((a) => a.id))\n    const missingAccount = accountIds.find((id) => !knownAccountIds.has(id))\n    if (missingAccount) {\n      throw new CrudHttpError(404, {\n        error: 'Billing account not found',\n        billAccountId: missingAccount,\n      })\n    }\n\n    // Batched idempotency check \u2014 one query over every source_ref in\n    // the batch. `source_ref` is unique per `(tenant, bill_account,\n    // source_ref)`, so we key the existing-set on that triple.\n    const sourceRefs = parsed.items\n      .map((i) => i.sourceRef)\n      .filter((ref): ref is string => typeof ref === 'string' && ref.length > 0)\n    const existingBySourceKey = new Map<string, string>()\n    if (sourceRefs.length > 0) {\n      const existing = await em.find(BillingItem, {\n        tenantId: parsed.tenantId,\n        organizationId: parsed.organizationId,\n        billAccountId: { $in: accountIds },\n        sourceRef: { $in: Array.from(new Set(sourceRefs)) },\n        deletedAt: null,\n      } as never)\n      for (const row of existing) {\n        if (row.sourceRef) {\n          existingBySourceKey.set(`${row.billAccountId}::${row.sourceRef}`, row.id)\n        }\n      }\n    }\n\n    const now = new Date()\n    const results: BulkCreateResultEntry[] = []\n    const createdEntities: BillingItem[] = []\n    // Result entries whose `id` is only known after the flush \u2014 the\n    // BillingItem PK is a DB-generated UUID, unassigned until then.\n    // Covers freshly-created rows and in-batch dedup rows that point\n    // at a sibling created earlier in the same payload.\n    const deferredIdLinks: Array<{ result: BulkCreateResultEntry; entity: BillingItem }> = []\n\n    // Track source_refs created within THIS batch so a payload that\n    // repeats the same source_ref twice dedups against itself (the\n    // unique index would otherwise blow up the whole flush).\n    const seenInBatch = new Set<string>()\n\n    for (const entry of parsed.items) {\n      const sourceKey = entry.sourceRef\n        ? `${entry.billAccountId}::${entry.sourceRef}`\n        : null\n\n      if (sourceKey) {\n        const existingId = existingBySourceKey.get(sourceKey)\n        if (existingId) {\n          results.push({ sourceRef: entry.sourceRef ?? null, id: existingId, deduplicated: true })\n          continue\n        }\n        if (seenInBatch.has(sourceKey)) {\n          // Duplicate source_ref inside the same payload \u2014 first wins,\n          // the repeat is reported deduplicated against the first.\n          const firstCreated = createdEntities.find(\n            (e) => e.billAccountId === entry.billAccountId && e.sourceRef === entry.sourceRef,\n          )\n          const dedupResult: BulkCreateResultEntry = {\n            sourceRef: entry.sourceRef ?? null,\n            id: '',\n            deduplicated: true,\n          }\n          results.push(dedupResult)\n          if (firstCreated) deferredIdLinks.push({ result: dedupResult, entity: firstCreated })\n          continue\n        }\n        seenInBatch.add(sourceKey)\n      }\n\n      validateRateJson(entry.type, entry.rateJson)\n      const item = em.create(BillingItem, {\n        organizationId: parsed.organizationId,\n        tenantId: parsed.tenantId,\n        billAccountId: entry.billAccountId,\n        type: entry.type,\n        billStartDate: entry.billStartDate,\n        billEndDate: entry.billEndDate ?? null,\n        description: entry.description,\n        rateJson: entry.rateJson as Record<string, unknown>,\n        uomCode: entry.uomCode ?? null,\n        subscriptionId: entry.subscriptionId ?? null,\n        subscriptionItemId: entry.subscriptionItemId ?? null,\n        sourceRef: entry.sourceRef ?? null,\n        currencyMismatch: false,\n        billedToDate: null,\n        isActive: true,\n        createdAt: now,\n        updatedAt: now,\n      })\n      em.persist(item)\n      createdEntities.push(item)\n      const createdResult: BulkCreateResultEntry = {\n        sourceRef: entry.sourceRef ?? null,\n        id: '',\n        deduplicated: false,\n      }\n      results.push(createdResult)\n      deferredIdLinks.push({ result: createdResult, entity: item })\n    }\n\n    // Single flush for the whole batch.\n    if (createdEntities.length > 0) {\n      await em.flush()\n    }\n\n    // The BillingItem UUID PK is assigned by the flush \u2014 backfill it\n    // into the result entries now that the value exists.\n    for (const link of deferredIdLinks) {\n      link.result.id = link.entity.id\n    }\n\n    // Side effects after the commit. Emitting per-entity keeps the\n    // query-index + event contract identical to single-create \u2014 the\n    // engine / search index can't tell a bulk insert from N singles.\n    const dataEngine = getDataEngine(ctx)\n    for (const item of createdEntities) {\n      await emitCrudSideEffects({\n        dataEngine,\n        action: 'created',\n        entity: item,\n        identifiers: {\n          id: item.id,\n          tenantId: item.tenantId,\n          organizationId: item.organizationId,\n        },\n        indexer: itemIndexer,\n        events: itemEvents,\n      })\n    }\n\n    return {\n      created: createdEntities.length,\n      deduplicated: results.filter((r) => r.deduplicated).length,\n      items: results,\n    }\n  },\n}\n\nregisterCommand(createItemCommand)\nregisterCommand(updateItemCommand)\nregisterCommand(deleteItemCommand)\nregisterCommand(bulkCreateItemsCommand)\n\nexport {\n  createItemCommand,\n  updateItemCommand,\n  deleteItemCommand,\n  bulkCreateItemsCommand,\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/billing/commands/runs.js

@@ -0,0 +1,123 @@
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import {
+  ensureOrganizationScope,
+  ensureTenantScope
+} from "@open-mercato/shared/lib/commands/scope";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillRun, BillRunOutcome } from "../data/entities.js";
+import {
+  billingRunRetryFailedSchema,
+  billingRunTriggerSchema
+} from "../data/validators.js";
+import { runBillRun } from "../lib/billRunEngine.js";
+import { TenantLockBusyError } from "../lib/tenantLock.js";
+function getEm(ctx) {
+  return ctx.container.resolve("em").fork();
+}
+function getContainer(ctx) {
+  return ctx.container;
+}
+function asLockBusyError(err) {
+  return err instanceof TenantLockBusyError;
+}
+const triggerRunCommand = {
+  id: "billing.runs.trigger",
+  async execute(rawInput, ctx) {
+    const parsed = billingRunTriggerSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const asOfDate = parsed.asOfDate ?? /* @__PURE__ */ new Date();
+    try {
+      const { billRun, outcomes } = await runBillRun(em, getContainer(ctx), {
+        tenantId: parsed.tenantId,
+        organizationId: parsed.organizationId,
+        asOfDate,
+        triggeredBy: "manual",
+        mode: parsed.mode,
+        scopedAccountIds: parsed.scopedAccountIds,
+        catchUp: parsed.catchUp
+      });
+      return {
+        billRunId: billRun.id,
+        status: billRun.status,
+        outcomesCount: outcomes.length
+      };
+    } catch (err) {
+      if (asLockBusyError(err)) {
+        throw new CrudHttpError(409, {
+          error: "Another Bill Run is already in progress for this tenant",
+          code: "billing.run.lock_busy",
+          tenantId: err.tenantId,
+          lockName: err.lockName
+        });
+      }
+      throw err;
+    }
+  }
+};
+const retryFailedCommand = {
+  id: "billing.runs.retry_failed",
+  async execute(rawInput, ctx) {
+    const parsed = billingRunRetryFailedSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const parentRun = await em.findOne(BillRun, {
+      id: parsed.billRunId,
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      deletedAt: null
+    });
+    if (!parentRun) {
+      throw new CrudHttpError(404, { error: "Parent Bill Run not found" });
+    }
+    const failedOutcomes = await em.find(BillRunOutcome, {
+      billRunId: parentRun.id,
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      status: "failed"
+    });
+    if (failedOutcomes.length === 0) {
+      throw new CrudHttpError(409, {
+        error: "Parent run has no failed outcomes to retry",
+        code: "billing.run.nothing_to_retry"
+      });
+    }
+    const scopedAccountIds = Array.from(new Set(failedOutcomes.map((o) => o.billAccountId)));
+    try {
+      const { billRun, outcomes } = await runBillRun(em, getContainer(ctx), {
+        tenantId: parsed.tenantId,
+        organizationId: parsed.organizationId,
+        asOfDate: parentRun.asOfDate,
+        triggeredBy: "manual",
+        mode: parsed.mode,
+        scopedAccountIds,
+        parentRunId: parentRun.id,
+        catchUp: parentRun.catchUp
+      });
+      return {
+        billRunId: billRun.id,
+        status: billRun.status,
+        outcomesCount: outcomes.length
+      };
+    } catch (err) {
+      if (asLockBusyError(err)) {
+        throw new CrudHttpError(409, {
+          error: "Another Bill Run is already in progress for this tenant",
+          code: "billing.run.lock_busy",
+          tenantId: err.tenantId,
+          lockName: err.lockName
+        });
+      }
+      throw err;
+    }
+  }
+};
+registerCommand(triggerRunCommand);
+registerCommand(retryFailedCommand);
+export {
+  retryFailedCommand,
+  triggerRunCommand
+};
+//# sourceMappingURL=runs.js.map

package/dist/modules/billing/commands/runs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/commands/runs.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport type { CommandHandler, CommandRuntimeContext } from '@open-mercato/shared/lib/commands/types'\nimport { registerCommand } from '@open-mercato/shared/lib/commands'\nimport {\n  ensureOrganizationScope,\n  ensureTenantScope,\n} from '@open-mercato/shared/lib/commands/scope'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { BillRun, BillRunOutcome } from '../data/entities'\nimport {\n  billingRunRetryFailedSchema,\n  billingRunTriggerSchema,\n  type BillingRunRetryFailedInput,\n  type BillingRunTriggerInput,\n} from '../data/validators'\nimport { runBillRun } from '../lib/billRunEngine'\nimport { TenantLockBusyError } from '../lib/tenantLock'\n\n/**\n * Bill Run trigger commands.\n *\n * Both commands wrap `runBillRun(...)` from `lib/billRunEngine`. The\n * lock-busy condition (concurrent run on the same tenant) is mapped to\n * HTTP 409 here so the API surface returns the canonical Conflict\n * response without each route knowing the lock primitive's\n * implementation.\n *\n * `triggeredBy` is intentionally NOT exposed on the input schema \u2014\n * client-driven triggers are always `'manual'`. The scheduler worker\n * (Phase 4) injects `'schedule'` directly through a separate\n * orchestrator path, not through this command.\n */\n\nfunction getEm(ctx: CommandRuntimeContext): EntityManager {\n  return (ctx.container.resolve('em') as EntityManager).fork()\n}\n\nfunction getContainer(ctx: CommandRuntimeContext): AwilixContainer {\n  return ctx.container as AwilixContainer\n}\n\nfunction asLockBusyError(err: unknown): err is TenantLockBusyError {\n  return err instanceof TenantLockBusyError\n}\n\n// \u2500\u2500\u2500 Trigger \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\ntype TriggerResult = {\n  billRunId: string\n  status: string\n  outcomesCount: number\n}\n\nconst triggerRunCommand: CommandHandler<BillingRunTriggerInput, TriggerResult> = {\n  id: 'billing.runs.trigger',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingRunTriggerSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n    const asOfDate = parsed.asOfDate ?? new Date()\n\n    try {\n      const { billRun, outcomes } = await runBillRun(em, getContainer(ctx), {\n        tenantId: parsed.tenantId,\n        organizationId: parsed.organizationId,\n        asOfDate,\n        triggeredBy: 'manual',\n        mode: parsed.mode,\n        scopedAccountIds: parsed.scopedAccountIds,\n        catchUp: parsed.catchUp,\n      })\n      return {\n        billRunId: billRun.id,\n        status: billRun.status,\n        outcomesCount: outcomes.length,\n      }\n    } catch (err) {\n      if (asLockBusyError(err)) {\n        // The route metadata maps `CrudHttpError(409)` to the canonical\n        // 409 Conflict response. The error body carries the\n        // `error_lock_busy` discriminator so clients can distinguish\n        // \"lock busy\" from other 409 conditions.\n        throw new CrudHttpError(409, {\n          error: 'Another Bill Run is already in progress for this tenant',\n          code: 'billing.run.lock_busy',\n          tenantId: err.tenantId,\n          lockName: err.lockName,\n        })\n      }\n      throw err\n    }\n  },\n}\n\n// \u2500\u2500\u2500 Retry failed \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 retryFailedCommand: CommandHandler<BillingRunRetryFailedInput, TriggerResult> = {\n  id: 'billing.runs.retry_failed',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingRunRetryFailedSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n    const parentRun = await em.findOne(BillRun, {\n      id: parsed.billRunId,\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      deletedAt: null,\n    })\n    if (!parentRun) {\n      throw new CrudHttpError(404, { error: 'Parent Bill Run not found' })\n    }\n    const failedOutcomes = await em.find(BillRunOutcome, {\n      billRunId: parentRun.id,\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      status: 'failed',\n    })\n    if (failedOutcomes.length === 0) {\n      throw new CrudHttpError(409, {\n        error: 'Parent run has no failed outcomes to retry',\n        code: 'billing.run.nothing_to_retry',\n      })\n    }\n    const scopedAccountIds = Array.from(new Set(failedOutcomes.map((o) => o.billAccountId)))\n\n    try {\n      const { billRun, outcomes } = await runBillRun(em, getContainer(ctx), {\n        tenantId: parsed.tenantId,\n        organizationId: parsed.organizationId,\n        asOfDate: parentRun.asOfDate,\n        triggeredBy: 'manual',\n        mode: parsed.mode,\n        scopedAccountIds,\n        parentRunId: parentRun.id,\n        catchUp: parentRun.catchUp,\n      })\n      return {\n        billRunId: billRun.id,\n        status: billRun.status,\n        outcomesCount: outcomes.length,\n      }\n    } catch (err) {\n      if (asLockBusyError(err)) {\n        throw new CrudHttpError(409, {\n          error: 'Another Bill Run is already in progress for this tenant',\n          code: 'billing.run.lock_busy',\n          tenantId: err.tenantId,\n          lockName: err.lockName,\n        })\n      }\n      throw err\n    }\n  },\n}\n\nregisterCommand(triggerRunCommand)\nregisterCommand(retryFailedCommand)\n\nexport { triggerRunCommand, retryFailedCommand }\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/billing/commands/usage.js

@@ -0,0 +1,88 @@
+import { registerCommand } from "@open-mercato/shared/lib/commands";
+import {
+  ensureOrganizationScope,
+  ensureTenantScope
+} from "@open-mercato/shared/lib/commands/scope";
+import { emitCrudSideEffects } from "@open-mercato/shared/lib/commands/helpers";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillingAccount, BillingAccountUsage } from "../data/entities.js";
+import { billingEntityIds } from "../data/entityIds.js";
+import { findBySourceRef } from "../lib/idempotency.js";
+import {
+  billingUsageCreateSchema
+} from "../data/validators.js";
+const usageIndexer = { entityType: billingEntityIds.usage };
+const usageEvents = { module: "billing", entity: "usage", persistent: true };
+function getEm(ctx) {
+  return ctx.container.resolve("em").fork();
+}
+function getDataEngine(ctx) {
+  return ctx.container.resolve("dataEngine");
+}
+const createUsageCommand = {
+  id: "billing.usage.create",
+  async execute(rawInput, ctx) {
+    const parsed = billingUsageCreateSchema.parse(rawInput);
+    ensureTenantScope(ctx, parsed.tenantId);
+    ensureOrganizationScope(ctx, parsed.organizationId);
+    const em = getEm(ctx);
+    const account = await em.findOne(BillingAccount, {
+      id: parsed.billAccountId,
+      tenantId: parsed.tenantId,
+      organizationId: parsed.organizationId,
+      deletedAt: null
+    });
+    if (!account) {
+      throw new CrudHttpError(404, { error: "Billing account not found" });
+    }
+    if (parsed.sourceRef) {
+      const existing = await findBySourceRef(em, BillingAccountUsage, {
+        tenantId: parsed.tenantId,
+        billAccountId: parsed.billAccountId,
+        sourceRef: parsed.sourceRef
+      });
+      if (existing) {
+        return { id: existing.id, deduplicated: true };
+      }
+    }
+    const now = /* @__PURE__ */ new Date();
+    const entity = em.create(BillingAccountUsage, {
+      organizationId: parsed.organizationId,
+      tenantId: parsed.tenantId,
+      billAccountId: parsed.billAccountId,
+      uomCode: parsed.uomCode,
+      // numeric(18,4) — MikroORM stores numeric columns as string in app
+      // code. JSON arrives as number; coerce here so the persisted shape
+      // matches what later reads expect.
+      quantity: parsed.quantity.toFixed(4),
+      periodStart: parsed.periodStart,
+      periodEnd: parsed.periodEnd,
+      lineDescription: parsed.lineDescription ?? null,
+      sourceRef: parsed.sourceRef ?? null,
+      ratedInBillRunId: null,
+      isActive: true,
+      createdAt: now,
+      updatedAt: now
+    });
+    em.persist(entity);
+    await em.flush();
+    await emitCrudSideEffects({
+      dataEngine: getDataEngine(ctx),
+      action: "created",
+      entity,
+      identifiers: {
+        id: entity.id,
+        tenantId: entity.tenantId,
+        organizationId: entity.organizationId
+      },
+      indexer: usageIndexer,
+      events: usageEvents
+    });
+    return { id: entity.id, deduplicated: false };
+  }
+};
+registerCommand(createUsageCommand);
+export {
+  createUsageCommand
+};
+//# sourceMappingURL=usage.js.map

package/dist/modules/billing/commands/usage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/commands/usage.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { CommandHandler, CommandRuntimeContext } from '@open-mercato/shared/lib/commands/types'\nimport { registerCommand } from '@open-mercato/shared/lib/commands'\nimport {\n  ensureOrganizationScope,\n  ensureTenantScope,\n} from '@open-mercato/shared/lib/commands/scope'\nimport { emitCrudSideEffects } from '@open-mercato/shared/lib/commands/helpers'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport { BillingAccount, BillingAccountUsage } from '../data/entities'\nimport { billingEntityIds } from '../data/entityIds'\nimport { findBySourceRef } from '../lib/idempotency'\nimport {\n  billingUsageCreateSchema,\n  type BillingUsageCreateInput,\n} from '../data/validators'\n\n/**\n * Usage ingest \u2014 append-only.\n *\n * Usage records are immutable once persisted. The Bill Run engine\n * (Phase 2) writes `rated_in_bill_run_id` on them but the data itself\n * never changes. There is therefore no update or delete command \u2014 if\n * an external system mis-aggregates and needs to \"correct\" a record,\n * they POST a compensating record (negative quantity is not allowed\n * by the validator; the connector posts a `one_time` Billing Item\n * credit instead, which is the spec's discount/refund model).\n *\n * Create is idempotent via `source_ref` \u2014 same shape as items.\n */\n\nconst usageIndexer = { entityType: billingEntityIds.usage } as const\nconst usageEvents = { module: 'billing', entity: 'usage', persistent: true } as const\n\nfunction getEm(ctx: CommandRuntimeContext): EntityManager {\n  return (ctx.container.resolve('em') as EntityManager).fork()\n}\n\nfunction getDataEngine(ctx: CommandRuntimeContext): DataEngine {\n  return ctx.container.resolve('dataEngine') as DataEngine\n}\n\nconst createUsageCommand: CommandHandler<\n  BillingUsageCreateInput,\n  { id: string; deduplicated: boolean }\n> = {\n  id: 'billing.usage.create',\n\n  async execute(rawInput, ctx) {\n    const parsed = billingUsageCreateSchema.parse(rawInput)\n    ensureTenantScope(ctx, parsed.tenantId)\n    ensureOrganizationScope(ctx, parsed.organizationId)\n\n    const em = getEm(ctx)\n    const account = await em.findOne(BillingAccount, {\n      id: parsed.billAccountId,\n      tenantId: parsed.tenantId,\n      organizationId: parsed.organizationId,\n      deletedAt: null,\n    })\n    if (!account) {\n      throw new CrudHttpError(404, { error: 'Billing account not found' })\n    }\n\n    if (parsed.sourceRef) {\n      const existing = await findBySourceRef(em, BillingAccountUsage, {\n        tenantId: parsed.tenantId,\n        billAccountId: parsed.billAccountId,\n        sourceRef: parsed.sourceRef,\n      })\n      if (existing) {\n        return { id: existing.id, deduplicated: true }\n      }\n    }\n\n    const now = new Date()\n    const entity = em.create(BillingAccountUsage, {\n      organizationId: parsed.organizationId,\n      tenantId: parsed.tenantId,\n      billAccountId: parsed.billAccountId,\n      uomCode: parsed.uomCode,\n      // numeric(18,4) \u2014 MikroORM stores numeric columns as string in app\n      // code. JSON arrives as number; coerce here so the persisted shape\n      // matches what later reads expect.\n      quantity: parsed.quantity.toFixed(4),\n      periodStart: parsed.periodStart,\n      periodEnd: parsed.periodEnd,\n      lineDescription: parsed.lineDescription ?? null,\n      sourceRef: parsed.sourceRef ?? null,\n      ratedInBillRunId: null,\n      isActive: true,\n      createdAt: now,\n      updatedAt: now,\n    })\n    em.persist(entity)\n    await em.flush()\n\n    await emitCrudSideEffects({\n      dataEngine: getDataEngine(ctx),\n      action: 'created',\n      entity,\n      identifiers: {\n        id: entity.id,\n        tenantId: entity.tenantId,\n        organizationId: entity.organizationId,\n      },\n      indexer: usageIndexer,\n      events: usageEvents,\n    })\n\n    return { id: entity.id, deduplicated: false }\n  },\n}\n\nregisterCommand(createUsageCommand)\n\nexport { createUsageCommand }\n"],
+  "mappings": "AAEA,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAE9B,SAAS,gBAAgB,2BAA2B;AACpD,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,OAEK;AAgBP,MAAM,eAAe,EAAE,YAAY,iBAAiB,MAAM;AAC1D,MAAM,cAAc,EAAE,QAAQ,WAAW,QAAQ,SAAS,YAAY,KAAK;AAE3E,SAAS,MAAM,KAA2C;AACxD,SAAQ,IAAI,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC7D;AAEA,SAAS,cAAc,KAAwC;AAC7D,SAAO,IAAI,UAAU,QAAQ,YAAY;AAC3C;AAEA,MAAM,qBAGF;AAAA,EACF,IAAI;AAAA,EAEJ,MAAM,QAAQ,UAAU,KAAK;AAC3B,UAAM,SAAS,yBAAyB,MAAM,QAAQ;AACtD,sBAAkB,KAAK,OAAO,QAAQ;AACtC,4BAAwB,KAAK,OAAO,cAAc;AAElD,UAAM,KAAK,MAAM,GAAG;AACpB,UAAM,UAAU,MAAM,GAAG,QAAQ,gBAAgB;AAAA,MAC/C,IAAI,OAAO;AAAA,MACX,UAAU,OAAO;AAAA,MACjB,gBAAgB,OAAO;AAAA,MACvB,WAAW;AAAA,IACb,CAAC;AACD,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,cAAc,KAAK,EAAE,OAAO,4BAA4B,CAAC;AAAA,IACrE;AAEA,QAAI,OAAO,WAAW;AACpB,YAAM,WAAW,MAAM,gBAAgB,IAAI,qBAAqB;AAAA,QAC9D,UAAU,OAAO;AAAA,QACjB,eAAe,OAAO;AAAA,QACtB,WAAW,OAAO;AAAA,MACpB,CAAC;AACD,UAAI,UAAU;AACZ,eAAO,EAAE,IAAI,SAAS,IAAI,cAAc,KAAK;AAAA,MAC/C;AAAA,IACF;AAEA,UAAM,MAAM,oBAAI,KAAK;AACrB,UAAM,SAAS,GAAG,OAAO,qBAAqB;AAAA,MAC5C,gBAAgB,OAAO;AAAA,MACvB,UAAU,OAAO;AAAA,MACjB,eAAe,OAAO;AAAA,MACtB,SAAS,OAAO;AAAA;AAAA;AAAA;AAAA,MAIhB,UAAU,OAAO,SAAS,QAAQ,CAAC;AAAA,MACnC,aAAa,OAAO;AAAA,MACpB,WAAW,OAAO;AAAA,MAClB,iBAAiB,OAAO,mBAAmB;AAAA,MAC3C,WAAW,OAAO,aAAa;AAAA,MAC/B,kBAAkB;AAAA,MAClB,UAAU;AAAA,MACV,WAAW;AAAA,MACX,WAAW;AAAA,IACb,CAAC;AACD,OAAG,QAAQ,MAAM;AACjB,UAAM,GAAG,MAAM;AAEf,UAAM,oBAAoB;AAAA,MACxB,YAAY,cAAc,GAAG;AAAA,MAC7B,QAAQ;AAAA,MACR;AAAA,MACA,aAAa;AAAA,QACX,IAAI,OAAO;AAAA,QACX,UAAU,OAAO;AAAA,QACjB,gBAAgB,OAAO;AAAA,MACzB;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,IACV,CAAC;AAED,WAAO,EAAE,IAAI,OAAO,IAAI,cAAc,MAAM;AAAA,EAC9C;AACF;AAEA,gBAAgB,kBAAkB;",
+  "names": []
+}