@dainamite/cpq 0.2.2

package/dist/modules/cpq/services/cpqOrderService.js

@@ -0,0 +1,901 @@
+import { SalesOrder, SalesOrderLine } from "@open-mercato/core/modules/sales/data/entities";
+import {
+  CpqQuoteConfiguration,
+  CpqQuoteLineConfiguration,
+  CpqQuoteTargetSubscription,
+  CpqOrderConfiguration,
+  CpqOrderLineConfiguration,
+  CpqProductOffering,
+  CpqProductSpecification,
+  CpqInventorySubscriptionItem
+} from "../data/entities.js";
+import {
+  CPQ_ORDER_TRANSITIONS
+} from "./types.js";
+import { emitCpqEvent } from "../events.js";
+const CPQ_TO_SALES_ORDER_STATUS = {
+  draft: "draft",
+  pending_activation: "pending",
+  active: "active",
+  cancelled: "cancelled",
+  fulfilled: "fulfilled"
+};
+class DefaultCpqOrderService {
+  constructor(deps) {
+    this.em = deps.em;
+    this.inventoryService = deps.cpqInventoryService;
+    this.numberGenerator = deps.salesDocumentNumberGenerator;
+  }
+  // ─── Convert Quote to Order ─────────────────────────────────
+  async convertQuoteToOrder(quoteId, scope) {
+    const em = this.em;
+    const cpqConfig = await em.findOne(CpqQuoteConfiguration, {
+      id: quoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!cpqConfig) {
+      const byQuoteId = await em.findOne(CpqQuoteConfiguration, {
+        quoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+      if (!byQuoteId) throw new OrderError(404, "Quote not found");
+      return this.convertFromConfig(byQuoteId, scope);
+    }
+    return this.convertFromConfig(cpqConfig, scope);
+  }
+  async convertFromConfig(cpqConfig, scope) {
+    const em = this.em;
+    const blockedStatuses = ["cancelled", "rejected"];
+    if (blockedStatuses.includes(cpqConfig.cpqStatus)) {
+      throw new OrderError(409, `Cannot convert a quote in '${cpqConfig.cpqStatus}' status`);
+    }
+    const existingOrder = await em.findOne(CpqOrderConfiguration, {
+      sourceQuoteId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (existingOrder) {
+      throw new OrderError(
+        409,
+        `Quote has already been converted to order ${existingOrder.orderId}`
+      );
+    }
+    const quoteLines = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (quoteLines.length === 0) {
+      throw new OrderError(422, "Cannot convert a quote with no line items");
+    }
+    const { number: orderNumber } = await this.numberGenerator.generate({
+      kind: "order",
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    const salesOrderId = crypto.randomUUID();
+    const pricingSummary = cpqConfig.pricingSummary;
+    const nrcTotal = Number(pricingSummary?.nrcTotal ?? 0);
+    const mrcTotal = Number(pricingSummary?.mrcTotal ?? 0);
+    const grandTotal = nrcTotal + mrcTotal;
+    const salesOrder = em.create(SalesOrder, {
+      id: salesOrderId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      orderNumber,
+      customerEntityId: cpqConfig.customerId,
+      currencyCode: cpqConfig.currencyCode,
+      status: "draft",
+      subtotalNetAmount: String(grandTotal),
+      subtotalGrossAmount: String(grandTotal),
+      discountTotalAmount: "0",
+      taxTotalAmount: "0",
+      shippingNetAmount: "0",
+      shippingGrossAmount: "0",
+      surchargeTotalAmount: "0",
+      paidTotalAmount: "0",
+      grandTotalNetAmount: String(grandTotal),
+      grandTotalGrossAmount: String(grandTotal),
+      lineItemCount: quoteLines.length,
+      metadata: { sourceQuoteId: cpqConfig.id },
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    em.persist(salesOrder);
+    const cpqOrderConfigId = crypto.randomUUID();
+    const cpqOrderConfig = em.create(CpqOrderConfiguration, {
+      id: cpqOrderConfigId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      orderId: salesOrderId,
+      sourceQuoteId: cpqConfig.id,
+      customerId: cpqConfig.customerId,
+      cpqStatus: "draft",
+      currencyCode: cpqConfig.currencyCode,
+      pricingSummary: {
+        nrcTotal,
+        mrcTotal,
+        currencyCode: cpqConfig.currencyCode
+      }
+    });
+    em.persist(cpqOrderConfig);
+    const quoteLineIdToOrderLineId = /* @__PURE__ */ new Map();
+    for (let i = 0; i < quoteLines.length; i++) {
+      const ql = quoteLines[i];
+      const perInstanceNrc = Number(ql.nrcTotal);
+      const perInstanceMrc = Number(ql.mrcTotal);
+      const unitPriceNet = (perInstanceNrc + perInstanceMrc) / ql.quantity;
+      const totalNet = perInstanceNrc + perInstanceMrc;
+      const orderLineId = crypto.randomUUID();
+      quoteLineIdToOrderLineId.set(ql.quoteLineId, orderLineId);
+      const offeringName = await this.resolveOfferingName(
+        em,
+        ql.offeringId,
+        scope,
+        ql.configuration
+      );
+      const orderLine = em.create(SalesOrderLine, {
+        id: orderLineId,
+        order: salesOrder,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        lineNumber: i + 1,
+        kind: "product",
+        productId: ql.productId ?? null,
+        name: offeringName,
+        quantity: String(ql.quantity),
+        unitPriceNet: String(unitPriceNet),
+        unitPriceGross: String(unitPriceNet),
+        totalNetAmount: String(totalNet),
+        totalGrossAmount: String(totalNet),
+        discountAmount: "0",
+        discountPercent: "0",
+        taxRate: "0",
+        taxAmount: "0",
+        currencyCode: cpqConfig.currencyCode,
+        configuration: {
+          offeringId: ql.offeringId ?? null,
+          action: ql.action,
+          nrcTotal: perInstanceNrc,
+          mrcTotal: perInstanceMrc,
+          parentLineId: ql.parentLineId ?? null
+        },
+        normalizedQuantity: String(ql.quantity),
+        reservedQuantity: "0",
+        fulfilledQuantity: "0",
+        invoicedQuantity: "0",
+        returnedQuantity: "0",
+        createdAt: /* @__PURE__ */ new Date(),
+        updatedAt: /* @__PURE__ */ new Date()
+      });
+      em.persist(orderLine);
+      const orderLineConfig = em.create(CpqOrderLineConfiguration, {
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        orderLineId,
+        orderConfigurationId: cpqOrderConfig.id,
+        offeringId: ql.offeringId ?? null,
+        productId: ql.productId ?? null,
+        specId: ql.specId ?? null,
+        action: ql.action,
+        parentLineId: null,
+        startDate: ql.startDate,
+        termMonths: ql.termMonths ?? null,
+        endDate: ql.endDate,
+        configuration: { ...ql.configuration, offeringName },
+        quantity: ql.quantity,
+        charges: ql.charges ? [...ql.charges] : null,
+        nrcTotal: ql.nrcTotal,
+        mrcTotal: ql.mrcTotal,
+        sourceQuoteLineId: ql.quoteLineId
+      });
+      em.persist(orderLineConfig);
+    }
+    await em.flush();
+    const orderLineConfigs = await em.find(CpqOrderLineConfiguration, {
+      orderConfigurationId: cpqOrderConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    for (const olc of orderLineConfigs) {
+      if (olc.sourceQuoteLineId) {
+        const sourceQl = quoteLines.find((ql) => ql.quoteLineId === olc.sourceQuoteLineId);
+        if (sourceQl?.parentLineId) {
+          const mappedParent = quoteLineIdToOrderLineId.get(sourceQl.parentLineId);
+          if (mappedParent) olc.parentLineId = mappedParent;
+        }
+      }
+    }
+    await em.flush();
+    return this.buildOrderResult(em, cpqOrderConfig, salesOrder, orderLineConfigs, scope);
+  }
+  // ─── Activate Order ─────────────────────────────────────────
+  async activateOrder(orderId, scope) {
+    const em = this.em;
+    const orderConfig = await this.loadOrderConfig(em, orderId, scope);
+    const currentStatus = orderConfig.cpqStatus;
+    if (currentStatus !== "draft" && currentStatus !== "pending_activation") {
+      throw new OrderError(409, `Cannot activate order in '${currentStatus}' status`);
+    }
+    const salesOrder = await this.loadSalesOrder(em, orderConfig.orderId, scope);
+    const orderLines = await em.find(CpqOrderLineConfiguration, {
+      orderConfigurationId: orderConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    const sourceQuote = orderConfig.sourceQuoteId ? await em.findOne(CpqQuoteConfiguration, {
+      id: orderConfig.sourceQuoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    }) : null;
+    const quoteType = sourceQuote?.quoteType ?? "new";
+    const arcEvents = [];
+    if (quoteType === "new") {
+      await this.createInventoryFromOrder(orderConfig, orderLines, scope);
+    } else {
+      arcEvents.push(
+        ...await this.applyArcOrder(orderConfig, sourceQuote, orderLines, scope)
+      );
+    }
+    orderConfig.cpqStatus = "active";
+    orderConfig.activatedAt = /* @__PURE__ */ new Date();
+    salesOrder.status = "active";
+    salesOrder.placedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    for (const fire of arcEvents) {
+      try {
+        await fire();
+      } catch (err) {
+        console.error("[cpq.arc] event emission failed", err);
+      }
+    }
+    return this.buildOrderResult(em, orderConfig, salesOrder, orderLines, scope);
+  }
+  // ─── ARC activation branch (XD-250) ─────────────────────────
+  //
+  // Reads the source quote's targets + lines, then dispatches per target to
+  // cpqInventoryService.apply* primitives. Returns the list of post-commit
+  // event emissions so the caller can fire them outside the activation TX.
+  async applyArcOrder(orderConfig, sourceQuote, orderLines, scope) {
+    const em = this.em;
+    const quoteType = sourceQuote.quoteType;
+    const targets = await em.find(CpqQuoteTargetSubscription, {
+      quoteId: sourceQuote.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (targets.length === 0) {
+      throw new OrderError(
+        409,
+        `ARC quote ${sourceQuote.id} has no target subscriptions to activate`
+      );
+    }
+    const inventory = this.inventoryService;
+    const sourceQuoteLines = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: sourceQuote.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    const linesByTarget = /* @__PURE__ */ new Map();
+    for (const line of sourceQuoteLines) {
+      const key = line.targetSubscriptionId ?? null;
+      const list = linesByTarget.get(key) ?? [];
+      list.push(line);
+      linesByTarget.set(key, list);
+    }
+    const specIds = [
+      ...new Set(sourceQuoteLines.map((l) => l.specId).filter((x) => Boolean(x)))
+    ];
+    const specs = specIds.length > 0 ? await em.find(CpqProductSpecification, {
+      id: { $in: specIds },
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    }) : [];
+    const specMap = new Map(specs.map((s) => [s.id, s]));
+    const events = [];
+    const eventBaseEnvelope = {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      sourceQuoteId: sourceQuote.id,
+      sourceOrderId: orderConfig.id
+    };
+    if (quoteType === "amend") {
+      for (const target of targets) {
+        const lines = linesByTarget.get(target.subscriptionId) ?? [];
+        const result = await inventory.applyAmendment(
+          {
+            subscriptionId: target.subscriptionId,
+            sourceQuoteId: sourceQuote.id,
+            sourceOrderId: orderConfig.id,
+            performedByUserId: null,
+            lineChanges: lines.map((l) => buildArcLineChange(l, specMap))
+          },
+          scope
+        );
+        events.push(
+          () => emitArcEvent("cpq.subscription.amended", result, eventBaseEnvelope)
+        );
+      }
+    } else if (quoteType === "cancel") {
+      for (const target of targets) {
+        const result = await inventory.applyCancel(
+          {
+            subscriptionId: target.subscriptionId,
+            sourceQuoteId: sourceQuote.id,
+            sourceOrderId: orderConfig.id,
+            performedByUserId: null,
+            etfAmount: sourceQuote.arcEtfAmount ?? null,
+            etfCurrency: sourceQuote.arcEtfCurrency ?? null,
+            reasonCode: sourceQuote.arcReasonCode ?? null,
+            reasonText: sourceQuote.arcReasonText ?? null
+          },
+          scope
+        );
+        events.push(
+          () => emitArcEvent("cpq.subscription.cancelled", result, {
+            ...eventBaseEnvelope,
+            etfAmount: sourceQuote.arcEtfAmount ?? null,
+            etfCurrency: sourceQuote.arcEtfCurrency ?? null,
+            reasonCode: sourceQuote.arcReasonCode ?? null,
+            reasonText: sourceQuote.arcReasonText ?? null
+          })
+        );
+      }
+    } else if (quoteType === "renew") {
+      const standalone = targets.filter((t) => t.mergeAction === "standalone");
+      const absorb = targets.filter((t) => t.mergeAction === "absorb");
+      if (standalone.length > 0 && absorb.length === 0) {
+        for (const target of standalone) {
+          if (!target.newTermStart || !target.newTermEnd) {
+            throw new OrderError(
+              409,
+              `Standalone renew target ${target.id} missing newTermStart/newTermEnd`
+            );
+          }
+          const lines = linesByTarget.get(target.subscriptionId) ?? [];
+          const result = await inventory.applyRenewal(
+            {
+              subscriptionId: target.subscriptionId,
+              sourceQuoteId: sourceQuote.id,
+              sourceOrderId: orderConfig.id,
+              performedByUserId: null,
+              term: {
+                newTermStart: target.newTermStart,
+                newTermEnd: target.newTermEnd,
+                newTermMonths: target.newTermMonths ?? null
+              },
+              lineChanges: lines.map((l) => buildArcLineChange(l, specMap))
+            },
+            scope
+          );
+          events.push(
+            () => emitArcEvent("cpq.subscription.renewed", result, {
+              ...eventBaseEnvelope,
+              term: {
+                newTermStart: target.newTermStart.toISOString(),
+                newTermEnd: target.newTermEnd.toISOString()
+              }
+            })
+          );
+        }
+      } else if (absorb.length >= 2 && standalone.length === 0) {
+        if (!sourceQuote.arcMergeNewTermStart || !sourceQuote.arcMergeNewTermEnd) {
+          throw new OrderError(
+            409,
+            `Merge renew quote ${sourceQuote.id} missing arc_merge_new_term_*`
+          );
+        }
+        const mergeLines = linesByTarget.get(null) ?? [];
+        const merge = await inventory.applyMergeRenewal(
+          {
+            sourceIds: absorb.map((t) => t.subscriptionId),
+            sourceQuoteId: sourceQuote.id,
+            sourceOrderId: orderConfig.id,
+            performedByUserId: null,
+            term: {
+              newTermStart: sourceQuote.arcMergeNewTermStart,
+              newTermEnd: sourceQuote.arcMergeNewTermEnd,
+              newTermMonths: sourceQuote.arcMergeNewTermMonths ?? null
+            },
+            mergeMeta: {
+              newSubCode: sourceQuote.arcMergeNewSubCode ?? null,
+              newSubName: sourceQuote.arcMergeNewSubName ?? null
+            },
+            lineChanges: mergeLines.map((l) => buildArcLineChange(l, specMap))
+          },
+          scope
+        );
+        const mergedFromSubscriptionIds = absorb.map((t) => t.subscriptionId);
+        events.push(
+          () => emitMergedEvent(merge, eventBaseEnvelope, mergedFromSubscriptionIds)
+        );
+        for (const sourceLog of merge.sourceChangeLogs) {
+          events.push(
+            () => emitSupersededEvent(sourceLog, merge.mergedSubscription.id, eventBaseEnvelope)
+          );
+        }
+      } else {
+        throw new OrderError(
+          409,
+          `Inconsistent renew targets \u2014 must be either single standalone or \u22652 absorb`
+        );
+      }
+    } else {
+      throw new OrderError(500, `Unknown quote_type '${quoteType}' for ARC activation`);
+    }
+    return events;
+  }
+  // ─── Inventory Creation ─────────────────────────────────────
+  async createInventoryFromOrder(orderConfig, orderLines, scope) {
+    if (orderLines.length === 0) return;
+    const specIds = [...new Set(orderLines.map((l) => l.specId).filter(Boolean))];
+    const specs = specIds.length > 0 ? await this.em.find(CpqProductSpecification, {
+      id: { $in: specIds },
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    }) : [];
+    const specMap = new Map(specs.map((s) => [s.id, s]));
+    const subscriptionLines = orderLines.filter((l) => {
+      const spec = l.specId ? specMap.get(l.specId) : null;
+      return !spec?.isAssetizable;
+    });
+    const assetLines = orderLines.filter((l) => {
+      const spec = l.specId ? specMap.get(l.specId) : null;
+      return spec?.isAssetizable === true;
+    });
+    const hasSubscriptionContent = subscriptionLines.some(
+      (l) => Number(l.mrcTotal) > 0 || Number(l.nrcTotal) > 0
+    );
+    if (!hasSubscriptionContent && assetLines.length === 0) return;
+    const subscriptionName = await this.buildSubscriptionName(orderConfig, orderLines, scope);
+    const lineWithDates = orderLines.find((l) => l.startDate != null) ?? orderLines[0];
+    const lineWithTerm = orderLines.find((l) => l.termMonths != null) ?? orderLines[0];
+    const subscriptionItems = subscriptionLines.map((line) => ({
+      productId: line.productId ?? void 0,
+      offeringId: line.offeringId ?? void 0,
+      specId: line.specId ?? void 0,
+      name: this.getLineName(line),
+      configuration: line.configuration ?? {},
+      charges: line.charges ?? [],
+      mrcAmount: Number(line.mrcTotal),
+      nrcAmount: Number(line.nrcTotal),
+      currencyCode: orderConfig.currencyCode,
+      quantity: line.quantity,
+      sourceQuoteLineId: line.sourceQuoteLineId ?? void 0,
+      sortOrder: orderLines.indexOf(line)
+    }));
+    const subscription = await this.inventoryService.createSubscription(
+      {
+        customerId: orderConfig.customerId,
+        name: subscriptionName,
+        billingCycle: "monthly",
+        currencyCode: orderConfig.currencyCode,
+        startDate: lineWithDates?.startDate?.toISOString?.() ?? void 0,
+        termMonths: lineWithTerm?.termMonths ?? void 0,
+        sourceQuoteId: orderConfig.sourceQuoteId ?? void 0,
+        sourceOrderId: orderConfig.id,
+        items: subscriptionItems.length > 0 ? subscriptionItems : [{ name: subscriptionName, mrcAmount: 0, nrcAmount: 0 }]
+      },
+      scope
+    );
+    const orderLineToSubItem = /* @__PURE__ */ new Map();
+    const allSubItems = await this.em.find(CpqInventorySubscriptionItem, {
+      subscriptionId: subscription.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    }, { orderBy: { sortOrder: "asc" } });
+    for (let i = 0; i < subscriptionLines.length && i < allSubItems.length; i++) {
+      orderLineToSubItem.set(subscriptionLines[i].orderLineId, allSubItems[i].id);
+    }
+    for (let i = 0; i < subscriptionLines.length && i < allSubItems.length; i++) {
+      const orderLine = subscriptionLines[i];
+      if (orderLine.parentLineId) {
+        const parentSubItemId = orderLineToSubItem.get(orderLine.parentLineId);
+        if (parentSubItemId) {
+          allSubItems[i].parentItemId = parentSubItemId;
+        }
+      }
+    }
+    await this.em.flush();
+    for (const line of assetLines) {
+      let subscriptionItemId;
+      if (line.parentLineId) {
+        subscriptionItemId = orderLineToSubItem.get(line.parentLineId) ?? void 0;
+      }
+      await this.inventoryService.createAsset(
+        {
+          customerId: orderConfig.customerId,
+          subscriptionId: subscription.id,
+          subscriptionItemId,
+          productId: line.productId ?? void 0,
+          offeringId: line.offeringId ?? void 0,
+          specId: line.specId ?? void 0,
+          name: this.getLineName(line),
+          assetType: "one_time",
+          currencyCode: orderConfig.currencyCode,
+          purchasePrice: Number(line.nrcTotal),
+          quantity: line.quantity,
+          purchaseDate: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+          configuration: line.configuration ?? {},
+          charges: line.charges ?? [],
+          sourceOrderId: orderConfig.id,
+          sourceQuoteLineId: line.sourceQuoteLineId ?? void 0
+        },
+        scope
+      );
+    }
+  }
+  // ─── Get / List ─────────────────────────────────────────────
+  async getOrder(orderId, scope) {
+    const em = this.em;
+    const orderConfig = await this.loadOrderConfig(em, orderId, scope);
+    const salesOrder = await this.loadSalesOrder(em, orderConfig.orderId, scope);
+    const lines = await em.find(CpqOrderLineConfiguration, {
+      orderConfigurationId: orderConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    return this.buildOrderResult(em, orderConfig, salesOrder, lines, scope);
+  }
+  async listOrders(filters, scope) {
+    const page = Math.max(1, filters.page ?? 1);
+    const pageSize = Math.min(100, Math.max(1, filters.pageSize ?? 50));
+    const offset = (page - 1) * pageSize;
+    const where = {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    };
+    if (filters.customerId) where.customerId = filters.customerId;
+    if (filters.sourceQuoteId) where.sourceQuoteId = filters.sourceQuoteId;
+    if (filters.salesOrderId) where.orderId = filters.salesOrderId;
+    if (filters.currencyCode) where.currencyCode = filters.currencyCode;
+    if (filters.cpqStatus) {
+      where.cpqStatus = Array.isArray(filters.cpqStatus) ? { $in: filters.cpqStatus } : filters.cpqStatus;
+    }
+    const search = filters.search?.trim();
+    if (search) {
+      where.$or = [
+        { orderId: { $ilike: `%${search}%` } },
+        { customerId: { $ilike: `%${search}%` } }
+      ];
+    }
+    const sortField = filters.sortField ?? "createdAt";
+    const sortDir = filters.sortDir === "asc" ? "asc" : "desc";
+    const [configs, total] = await this.em.findAndCount(
+      CpqOrderConfiguration,
+      where,
+      { limit: pageSize, offset, orderBy: { [sortField]: sortDir } }
+    );
+    const orderIds = configs.map((c) => c.orderId);
+    const salesOrders = orderIds.length > 0 ? await this.em.find(SalesOrder, { id: { $in: orderIds } }) : [];
+    const salesOrderMap = new Map(salesOrders.map((o) => [o.id, o]));
+    const items = configs.map((c) => ({
+      ...c,
+      orderNumber: salesOrderMap.get(c.orderId)?.orderNumber ?? null
+    }));
+    return { items, total, page, pageSize, totalPages: Math.ceil(total / pageSize) };
+  }
+  // ─── Status Transition ──────────────────────────────────────
+  async transitionOrderStatus(orderId, targetStatus, scope) {
+    const em = this.em;
+    const orderConfig = await this.loadOrderConfig(em, orderId, scope);
+    const salesOrder = await this.loadSalesOrder(em, orderConfig.orderId, scope);
+    const currentStatus = orderConfig.cpqStatus;
+    const allowed = CPQ_ORDER_TRANSITIONS[currentStatus] ?? [];
+    if (!allowed.includes(targetStatus)) {
+      throw new OrderError(409, `Cannot transition from '${currentStatus}' to '${targetStatus}'`);
+    }
+    if (targetStatus === "active") {
+      return this.activateOrder(orderId, scope);
+    }
+    orderConfig.cpqStatus = targetStatus;
+    salesOrder.status = CPQ_TO_SALES_ORDER_STATUS[targetStatus] ?? targetStatus;
+    await em.flush();
+    const lines = await em.find(CpqOrderLineConfiguration, {
+      orderConfigurationId: orderConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    return this.buildOrderResult(em, orderConfig, salesOrder, lines, scope);
+  }
+  // ─── Helpers ────────────────────────────────────────────────
+  async loadOrderConfig(em, orderId, scope) {
+    let config = await em.findOne(CpqOrderConfiguration, {
+      id: orderId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!config) {
+      config = await em.findOne(CpqOrderConfiguration, {
+        orderId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+    }
+    if (!config) throw new OrderError(404, "Order not found");
+    return config;
+  }
+  async loadSalesOrder(em, orderId, scope) {
+    const order = await em.findOne(SalesOrder, {
+      id: orderId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    if (!order) throw new OrderError(404, "Sales order not found");
+    return order;
+  }
+  async resolveOfferingInfo(em, offeringId, scope, fallbackConfig) {
+    if (offeringId) {
+      const offering = await em.findOne(CpqProductOffering, {
+        id: offeringId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+      if (offering) return { name: offering.name, type: offering.offeringType ?? "simple" };
+    }
+    const cfg = fallbackConfig ?? null;
+    const fallbackName = cfg?._arcMirroredName ?? cfg?.offeringName ?? "Configured Item";
+    return { name: fallbackName, type: null };
+  }
+  async resolveOfferingName(em, offeringId, scope, fallbackConfig) {
+    const info = await this.resolveOfferingInfo(em, offeringId, scope, fallbackConfig);
+    return info.name;
+  }
+  getLineName(line) {
+    const config = line.configuration;
+    return config?._arcMirroredName ?? config?.offeringName ?? config?.name ?? "Configured Item";
+  }
+  async buildSubscriptionName(orderConfig, orderLines, scope) {
+    if (orderLines.length === 1 && orderLines[0].offeringId) {
+      return this.resolveOfferingName(this.em, orderLines[0].offeringId, scope);
+    }
+    const names = [];
+    for (const line of orderLines.slice(0, 3)) {
+      if (line.offeringId) {
+        names.push(await this.resolveOfferingName(this.em, line.offeringId, scope));
+      }
+    }
+    if (names.length > 0) {
+      const suffix = orderLines.length > 3 ? ` (+${orderLines.length - 3} more)` : "";
+      return names.join(", ") + suffix;
+    }
+    return `Order ${orderConfig.orderId.slice(0, 8)}`;
+  }
+  async buildOrderResult(em, orderConfig, salesOrder, lineConfigs, scope) {
+    const lines = [];
+    const arcItemIds = /* @__PURE__ */ new Set();
+    for (const lc of lineConfigs) {
+      const m = lc.configuration?._arcMirroredFromItemId;
+      if (typeof m === "string") arcItemIds.add(m);
+    }
+    const arcItemMap = /* @__PURE__ */ new Map();
+    if (arcItemIds.size > 0) {
+      const items = await em.find(CpqInventorySubscriptionItem, {
+        id: { $in: Array.from(arcItemIds) },
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+      for (const it of items) arcItemMap.set(it.id, it);
+    }
+    for (const lc of lineConfigs) {
+      const offeringInfo = await this.resolveOfferingInfo(
+        em,
+        lc.offeringId,
+        scope,
+        lc.configuration
+      );
+      const arcSource = pickArcSourceFromConfig(lc.configuration, arcItemMap);
+      lines.push({
+        lineId: lc.orderLineId,
+        offeringId: lc.offeringId ?? null,
+        offeringName: offeringInfo.name,
+        offeringType: offeringInfo.type,
+        productId: lc.productId ?? null,
+        specId: lc.specId ?? null,
+        action: lc.action,
+        parentLineId: lc.parentLineId ?? null,
+        quantity: lc.quantity,
+        configuration: lc.configuration ?? {},
+        startDate: lc.startDate?.toISOString() ?? null,
+        termMonths: lc.termMonths ?? null,
+        endDate: lc.endDate?.toISOString() ?? null,
+        nrcTotal: Number(lc.nrcTotal),
+        mrcTotal: Number(lc.mrcTotal),
+        charges: lc.charges ?? [],
+        sourceQuoteLineId: lc.sourceQuoteLineId ?? null,
+        arcSource
+      });
+    }
+    let quoteType = "new";
+    if (orderConfig.sourceQuoteId) {
+      const sourceCfg = await em.findOne(CpqQuoteConfiguration, {
+        id: orderConfig.sourceQuoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId
+      });
+      if (sourceCfg?.quoteType) quoteType = sourceCfg.quoteType;
+    }
+    const pricing = orderConfig.pricingSummary ?? {};
+    return {
+      id: orderConfig.id,
+      orderId: orderConfig.orderId,
+      orderNumber: salesOrder.orderNumber ?? "",
+      customerId: orderConfig.customerId,
+      cpqStatus: orderConfig.cpqStatus,
+      sourceQuoteId: orderConfig.sourceQuoteId ?? null,
+      quoteType,
+      currencyCode: orderConfig.currencyCode,
+      pricingSummary: {
+        nrcTotal: Number(pricing.nrcTotal ?? 0),
+        mrcTotal: Number(pricing.mrcTotal ?? 0),
+        currencyCode: orderConfig.currencyCode
+      },
+      activatedAt: orderConfig.activatedAt?.toISOString() ?? null,
+      createdAt: orderConfig.createdAt.toISOString(),
+      lines
+    };
+  }
+}
+function pickArcSourceFromConfig(cfg, map) {
+  const m = cfg?._arcMirroredFromItemId;
+  if (typeof m !== "string") return null;
+  const item = map.get(m);
+  if (!item) return null;
+  return {
+    subscriptionItemId: item.id,
+    name: item.name,
+    mrcAmount: Number(item.mrcAmount),
+    nrcAmount: Number(item.nrcAmount),
+    quantity: item.quantity
+  };
+}
+class OrderError extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "OrderError";
+  }
+}
+function buildArcLineChange(line, specMap) {
+  const action = line.action;
+  if (action === "add") {
+    const itemInput = {
+      productId: line.productId ?? void 0,
+      offeringId: line.offeringId ?? void 0,
+      specId: line.specId ?? void 0,
+      name: resolveLineName(line, specMap),
+      configuration: line.configuration ?? {},
+      charges: line.charges ?? null,
+      mrcAmount: Number(line.mrcTotal),
+      nrcAmount: Number(line.nrcTotal),
+      quantity: line.quantity,
+      sourceQuoteLineId: line.quoteLineId
+    };
+    return {
+      quoteLineId: line.quoteLineId,
+      action,
+      itemInput,
+      parentQuoteLineId: line.parentLineId ?? null
+    };
+  }
+  if (action === "cancel") {
+    return {
+      quoteLineId: line.quoteLineId,
+      action,
+      sourceSubscriptionItemId: line.sourceSubscriptionItemId ?? null
+    };
+  }
+  return {
+    quoteLineId: line.quoteLineId,
+    action,
+    sourceSubscriptionItemId: line.sourceSubscriptionItemId ?? null,
+    modifyPatch: {
+      configuration: line.configuration ?? void 0,
+      charges: line.charges ?? void 0,
+      mrcAmount: Number(line.mrcTotal),
+      nrcAmount: Number(line.nrcTotal),
+      quantity: line.quantity
+    }
+  };
+}
+function resolveLineName(line, specMap) {
+  const cfg = line.configuration;
+  const cfgName = cfg?._arcMirroredName ?? null;
+  if (cfgName) return cfgName;
+  if (line.specId) {
+    const spec = specMap.get(line.specId);
+    if (spec?.name) return spec.name;
+  }
+  return "Configured Item";
+}
+async function emitArcEvent(eventId, result, envelope) {
+  const sub = result.subscription;
+  await emitCpqEvent(eventId, {
+    subscriptionId: sub.id,
+    customerId: sub.customerId,
+    organizationId: envelope.organizationId,
+    tenantId: envelope.tenantId,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    sourceQuoteId: envelope.sourceQuoteId,
+    sourceOrderId: envelope.sourceOrderId,
+    performedByUserId: null,
+    changeLogId: result.changeLog.id,
+    proration: buildProrationPayload(sub, result.changeLog.beforeSnapshot ?? null),
+    ...envelope.term ? { term: envelope.term } : {},
+    ...envelope.etfAmount !== void 0 ? { etfAmount: envelope.etfAmount } : {},
+    ...envelope.etfCurrency !== void 0 ? { etfCurrency: envelope.etfCurrency } : {},
+    ...envelope.reasonCode !== void 0 ? { reasonCode: envelope.reasonCode } : {},
+    ...envelope.reasonText !== void 0 ? { reasonText: envelope.reasonText } : {}
+  });
+}
+async function emitMergedEvent(merge, envelope, mergedFromSubscriptionIds) {
+  const m = merge.mergedSubscription;
+  await emitCpqEvent("cpq.subscription.merged", {
+    subscriptionId: m.id,
+    customerId: m.customerId,
+    organizationId: envelope.organizationId,
+    tenantId: envelope.tenantId,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    sourceQuoteId: envelope.sourceQuoteId,
+    sourceOrderId: envelope.sourceOrderId,
+    performedByUserId: null,
+    changeLogId: merge.mergeResultChangeLog.id,
+    mergedFromSubscriptionIds,
+    term: {
+      newTermStart: m.currentTermStart?.toISOString() ?? null,
+      newTermEnd: m.currentTermEnd?.toISOString() ?? null,
+      newTermMonths: m.termMonths ?? null
+    },
+    proration: buildProrationPayload(m, null)
+  });
+}
+async function emitSupersededEvent(sourceLog, newMergeSubId, envelope) {
+  await emitCpqEvent("cpq.subscription.superseded", {
+    subscriptionId: sourceLog.subscriptionId,
+    organizationId: envelope.organizationId,
+    tenantId: envelope.tenantId,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    sourceQuoteId: envelope.sourceQuoteId,
+    sourceOrderId: envelope.sourceOrderId,
+    performedByUserId: null,
+    changeLogId: sourceLog.id,
+    mergedIntoSubscriptionId: newMergeSubId
+  });
+}
+function buildProrationPayload(sub, beforeSnapshot) {
+  const oldMrc = beforeSnapshot ? Number(beforeSnapshot.mrcAmount ?? 0) : 0;
+  return {
+    oldMrcAmount: oldMrc,
+    newMrcAmount: Number(sub.mrcAmount),
+    currency: sub.currencyCode,
+    billingCycleStart: null,
+    billingCycleEnd: null,
+    daysElapsedInCycle: null,
+    daysRemainingInCycle: null
+  };
+}
+export {
+  DefaultCpqOrderService,
+  OrderError
+};
+//# sourceMappingURL=cpqOrderService.js.map