@dainamite/cpq 0.2.2

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

@@ -0,0 +1,1867 @@
+import { SalesQuote, SalesQuoteLine } from "@open-mercato/core/modules/sales/data/entities";
+import { CustomerEntity } from "@open-mercato/core/modules/customers/data/entities";
+import {
+  CpqQuoteConfiguration,
+  CpqQuoteLineConfiguration,
+  CpqQuoteTargetSubscription,
+  CpqInventorySubscription,
+  CpqInventorySubscriptionItem,
+  CpqOrderConfiguration,
+  CpqProductOffering,
+  CpqProductSpecification
+} from "../data/entities.js";
+import {
+  ALLOWED_TRANSITIONS,
+  TERMINAL_STATUSES,
+  ARC_QUOTE_TYPES,
+  getBaseCurrencyCode
+} from "./types.js";
+class DefaultCpqQuotingService {
+  constructor(deps) {
+    this.em = deps.em;
+    this.pricingService = deps.cpqPricingService;
+    this.validationService = deps.cpqValidationService;
+    this.productService = deps.cpqProductService;
+    this.numberGenerator = deps.salesDocumentNumberGenerator;
+  }
+  // ─── Create Quote ──────────────────────────────────────────────
+  async createQuote(input, scope) {
+    const em = this.em;
+    const customer = await em.findOne(CustomerEntity, {
+      id: input.customerId,
+      tenantId: scope.tenantId
+    }, { populate: ["personProfile", "companyProfile"] });
+    if (!customer) {
+      throw new QuotingError(404, "Customer not found");
+    }
+    const customerSnapshot = buildCustomerSnapshot(customer);
+    const quoteContext = {
+      ...input.quoteContext ?? {}
+    };
+    if (customer.kind) quoteContext.customer_type = customer.kind;
+    if (customer.companyProfile?.domain) quoteContext.customer_domain = customer.companyProfile.domain;
+    const currencyCode = input.currencyCode ?? await getBaseCurrencyCode(em, scope);
+    let salesQuote;
+    let salesQuoteId;
+    if (input.quoteId) {
+      const existing = await em.findOne(SalesQuote, {
+        id: input.quoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId
+      });
+      if (!existing) throw new QuotingError(404, "Sales quote not found");
+      const existingConfig = await em.findOne(CpqQuoteConfiguration, {
+        quoteId: input.quoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+      if (existingConfig) {
+        const lines = await this.loadLineConfigs(em, existingConfig.id, scope);
+        return this.buildQuoteResult(em, existingConfig, existing, lines);
+      }
+      salesQuote = existing;
+      salesQuoteId = existing.id;
+    } else {
+      salesQuoteId = crypto.randomUUID();
+      const { number: quoteNumber } = await this.numberGenerator.generate({
+        kind: "quote",
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId
+      });
+      salesQuote = em.create(SalesQuote, {
+        id: salesQuoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        quoteNumber,
+        customerEntityId: input.customerId,
+        customerSnapshot,
+        currencyCode,
+        subtotalNetAmount: "0",
+        subtotalGrossAmount: "0",
+        discountTotalAmount: "0",
+        taxTotalAmount: "0",
+        grandTotalNetAmount: "0",
+        grandTotalGrossAmount: "0",
+        lineItemCount: 0,
+        createdAt: /* @__PURE__ */ new Date(),
+        updatedAt: /* @__PURE__ */ new Date()
+      });
+      em.persist(salesQuote);
+    }
+    const cpqConfig = em.create(CpqQuoteConfiguration, {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      quoteId: salesQuoteId,
+      customerId: input.customerId,
+      cpqStatus: "new",
+      version: 1,
+      currencyCode,
+      quoteContext,
+      validationResult: { valid: true, errors: [] },
+      pricingSummary: emptyPricingSummary(currencyCode)
+    });
+    em.persist(cpqConfig);
+    await em.flush();
+    return this.buildQuoteResult(em, cpqConfig, salesQuote, []);
+  }
+  // ─── Add Quote Item ────────────────────────────────────────────
+  async addQuoteItem(quoteId, item, scope) {
+    const em = this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    if (TERMINAL_STATUSES.includes(cpqConfig.cpqStatus)) {
+      throw new QuotingError(409, `Cannot modify quote in '${cpqConfig.cpqStatus}' status`);
+    }
+    const { offering, spec } = await this.resolveOffering(em, item, scope);
+    const mergedConfig = {
+      ...cpqConfig.quoteContext ?? {},
+      ...offering?.designTimeValues ?? {},
+      ...item.configuration
+    };
+    if (item.termMonths) {
+      mergedConfig.term_months = item.termMonths;
+    }
+    let validationErrors = [];
+    if (offering) {
+      const validation = await this.validationService.validateOfferingConfiguration({
+        offeringId: offering.id,
+        configuration: item.configuration,
+        scope
+      });
+      validationErrors = validation.errors;
+    }
+    const charges = await this.pricingService.resolveProductCharges({
+      offeringId: offering?.id,
+      productId: item.productId ?? spec?.productId,
+      configuration: mergedConfig,
+      currencyCode: cpqConfig.currencyCode,
+      ...scope
+    });
+    const quantity = item.quantity ?? 1;
+    const { nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated } = computeLineTotals(charges, quantity, item.usageEstimates);
+    const isBundleOffering = offering?.offeringType === "bundle";
+    const isConfigured = validationErrors.length === 0 && (charges.length > 0 || isBundleOffering);
+    const endDate = computeEndDate(item.startDate, item.termMonths, item.endDate);
+    const existingLines = await em.find(SalesQuoteLine, {
+      quote: salesQuote,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    const lineNumber = existingLines.length + 1;
+    const perInstanceNrc = charges.filter((c) => c.chargeType === "nrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+    const perInstanceMrc = charges.filter((c) => c.chargeType === "mrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+    const unitPriceNet = perInstanceNrc + perInstanceMrc;
+    const totalNetAmount = unitPriceNet * quantity;
+    const quoteLineId = crypto.randomUUID();
+    const quoteLine = em.create(SalesQuoteLine, {
+      id: quoteLineId,
+      quote: salesQuote,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      lineNumber,
+      kind: "product",
+      productId: spec?.productId ?? item.productId ?? null,
+      name: offering?.name ?? spec?.name ?? "Configured Item",
+      quantity: String(quantity),
+      unitPriceNet: String(unitPriceNet),
+      unitPriceGross: String(unitPriceNet),
+      totalNetAmount: String(totalNetAmount),
+      totalGrossAmount: String(totalNetAmount),
+      discountAmount: "0",
+      discountPercent: "0",
+      taxRate: "0",
+      taxAmount: "0",
+      currencyCode: cpqConfig.currencyCode,
+      configuration: {
+        offeringId: offering?.id ?? null,
+        offeringCode: offering?.code ?? null,
+        action: item.action ?? "add",
+        nrcTotal: Number(nrcTotal),
+        mrcTotal: Number(mrcTotal),
+        parentLineId: item.parentLineId ?? null
+      },
+      normalizedQuantity: String(quantity),
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    em.persist(quoteLine);
+    const arcTargetSubscriptionId = await resolveArcLineTargetSubscriptionId(
+      em,
+      cpqConfig,
+      scope,
+      item.targetSubscriptionId ?? void 0
+    );
+    const lineConfig = em.create(CpqQuoteLineConfiguration, {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      quoteLineId: quoteLine.id,
+      quoteConfigurationId: cpqConfig.id,
+      offeringId: offering?.id ?? null,
+      productId: spec?.productId ?? item.productId ?? null,
+      specId: spec?.id ?? null,
+      action: item.action ?? "add",
+      parentLineId: item.parentLineId ?? null,
+      startDate: item.startDate ? new Date(item.startDate) : null,
+      termMonths: item.termMonths ?? null,
+      endDate: endDate ? new Date(endDate) : null,
+      configuration: item.configuration,
+      quantity,
+      charges,
+      nrcTotal: String(nrcTotal),
+      mrcTotal: String(mrcTotal),
+      usageEstimates: usageEstimates ?? null,
+      usageTotalEstimated: usageTotalEstimated != null ? String(usageTotalEstimated) : null,
+      validationErrors: validationErrors.length > 0 ? validationErrors : null,
+      isConfigured,
+      targetSubscriptionId: arcTargetSubscriptionId
+    });
+    em.persist(lineConfig);
+    await em.flush();
+    return this.recalculateInternal(em, cpqConfig, salesQuote, scope, true);
+  }
+  // ─── Update Quote Item ─────────────────────────────────────────
+  async updateQuoteItem(quoteId, lineId, update, scope) {
+    const em = this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    if (TERMINAL_STATUSES.includes(cpqConfig.cpqStatus)) {
+      throw new QuotingError(409, `Cannot modify quote in '${cpqConfig.cpqStatus}' status`);
+    }
+    const lineConfig = await em.findOne(CpqQuoteLineConfiguration, {
+      quoteLineId: lineId,
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!lineConfig) throw new QuotingError(404, "Quote line not found");
+    const quoteLine = await em.findOne(SalesQuoteLine, {
+      id: lineId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!quoteLine) throw new QuotingError(404, "Quote line not found");
+    let offering = null;
+    if (lineConfig.offeringId) {
+      offering = await em.findOne(CpqProductOffering, {
+        id: lineConfig.offeringId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+    }
+    const mergedConfig = {
+      ...cpqConfig.quoteContext ?? {},
+      ...offering?.designTimeValues ?? {},
+      ...update.configuration
+    };
+    if (update.termMonths) {
+      mergedConfig.term_months = update.termMonths;
+    }
+    let validationErrors = [];
+    if (lineConfig.offeringId) {
+      const validation = await this.validationService.validateOfferingConfiguration({
+        offeringId: lineConfig.offeringId,
+        configuration: update.configuration,
+        scope
+      });
+      validationErrors = validation.errors;
+    }
+    const existingCfg = lineConfig.configuration;
+    const arcMarkers = {};
+    if (existingCfg?._arcMirroredFromItemId !== void 0) {
+      arcMarkers._arcMirroredFromItemId = existingCfg._arcMirroredFromItemId;
+    }
+    if (existingCfg?._arcMirroredName !== void 0) {
+      arcMarkers._arcMirroredName = existingCfg._arcMirroredName;
+    }
+    update.configuration = { ...update.configuration, ...arcMarkers };
+    mergedConfig._arcMirroredFromItemId = arcMarkers._arcMirroredFromItemId;
+    mergedConfig._arcMirroredName = arcMarkers._arcMirroredName;
+    const isArcMirrored = !!arcMarkers._arcMirroredFromItemId;
+    let charges;
+    if (lineConfig.offeringId || lineConfig.productId) {
+      charges = await this.pricingService.resolveProductCharges({
+        offeringId: lineConfig.offeringId ?? void 0,
+        productId: lineConfig.productId ?? void 0,
+        configuration: mergedConfig,
+        currencyCode: cpqConfig.currencyCode,
+        ...scope
+      });
+    } else {
+      charges = lineConfig.charges ?? [];
+    }
+    const quantity = update.quantity ?? lineConfig.quantity;
+    const { nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated } = computeLineTotals(charges, quantity, update.usageEstimates);
+    const isBundleOffering = offering?.offeringType === "bundle";
+    const isConfigured = validationErrors.length === 0 && (charges.length > 0 || isBundleOffering || isArcMirrored);
+    const endDate = computeEndDate(update.startDate ?? lineConfig.startDate?.toISOString(), update.termMonths ?? lineConfig.termMonths ?? void 0, update.endDate);
+    em.assign(lineConfig, {
+      configuration: update.configuration,
+      quantity,
+      charges,
+      nrcTotal: String(nrcTotal),
+      mrcTotal: String(mrcTotal),
+      usageEstimates: usageEstimates ?? null,
+      usageTotalEstimated: usageTotalEstimated != null ? String(usageTotalEstimated) : null,
+      validationErrors: validationErrors.length > 0 ? validationErrors : null,
+      isConfigured,
+      startDate: update.startDate ? new Date(update.startDate) : lineConfig.startDate,
+      termMonths: update.termMonths ?? lineConfig.termMonths,
+      endDate: endDate ? new Date(endDate) : lineConfig.endDate
+    });
+    const perInstanceNrc = charges.filter((c) => c.chargeType === "nrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+    const perInstanceMrc = charges.filter((c) => c.chargeType === "mrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+    const unitPriceNet = perInstanceNrc + perInstanceMrc;
+    em.assign(quoteLine, {
+      quantity: String(quantity),
+      unitPriceNet: String(unitPriceNet),
+      unitPriceGross: String(unitPriceNet),
+      totalNetAmount: String(unitPriceNet * quantity),
+      totalGrossAmount: String(unitPriceNet * quantity),
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    await em.flush();
+    return this.recalculateInternal(em, cpqConfig, salesQuote, scope, true);
+  }
+  // ─── Remove Quote Item ─────────────────────────────────────────
+  async removeQuoteItem(quoteId, lineId, scope) {
+    const em = this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    if (TERMINAL_STATUSES.includes(cpqConfig.cpqStatus)) {
+      throw new QuotingError(409, `Cannot modify quote in '${cpqConfig.cpqStatus}' status`);
+    }
+    const lineConfig = await em.findOne(CpqQuoteLineConfiguration, {
+      quoteLineId: lineId,
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!lineConfig) throw new QuotingError(404, "Quote line not found");
+    const now = /* @__PURE__ */ new Date();
+    lineConfig.deletedAt = now;
+    const children = await em.find(CpqQuoteLineConfiguration, {
+      parentLineId: lineId,
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    for (const child of children) {
+      child.deletedAt = now;
+      const childSalesLine = await em.findOne(SalesQuoteLine, {
+        id: child.quoteLineId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId
+      });
+      if (childSalesLine) childSalesLine.deletedAt = now;
+    }
+    const salesLine = await em.findOne(SalesQuoteLine, {
+      id: lineId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    if (salesLine) salesLine.deletedAt = now;
+    await em.flush();
+    return this.recalculateInternal(em, cpqConfig, salesQuote, scope, true);
+  }
+  // ─── Get Quote (read from DB, no recalculation) ────────────────
+  async getQuote(quoteId, scope) {
+    const em = this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    const lineConfigs = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    return this.buildQuoteResult(em, cpqConfig, salesQuote, lineConfigs);
+  }
+  // ─── Recalculate ───────────────────────────────────────────────
+  async recalculate(quoteId, options, scope) {
+    const em = options.save ? this.em.fork() : this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    return this.recalculateInternal(em, cpqConfig, salesQuote, scope, options.save);
+  }
+  // ─── Clone Quote ───────────────────────────────────────────────
+  async cloneQuote(quoteId, scope) {
+    const em = this.em;
+    const original = await this.loadCpqConfig(em, quoteId, scope);
+    const originalQuote = await this.loadSalesQuote(em, original.quoteId, scope);
+    const { number: quoteNumber } = await this.numberGenerator.generate({
+      kind: "quote",
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    const newSalesQuoteId = crypto.randomUUID();
+    const newSalesQuote = em.create(SalesQuote, {
+      id: newSalesQuoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      quoteNumber,
+      customerEntityId: originalQuote.customerEntityId,
+      customerSnapshot: originalQuote.customerSnapshot,
+      currencyCode: original.currencyCode,
+      subtotalNetAmount: "0",
+      subtotalGrossAmount: "0",
+      discountTotalAmount: "0",
+      taxTotalAmount: "0",
+      grandTotalNetAmount: "0",
+      grandTotalGrossAmount: "0",
+      lineItemCount: 0,
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    em.persist(newSalesQuote);
+    const newCpqConfig = em.create(CpqQuoteConfiguration, {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      quoteId: newSalesQuoteId,
+      customerId: original.customerId,
+      cpqStatus: "new",
+      version: original.version + 1,
+      parentQuoteId: original.id,
+      currencyCode: original.currencyCode,
+      quoteContext: original.quoteContext ? { ...original.quoteContext } : null,
+      validationResult: { valid: true, errors: [] },
+      pricingSummary: emptyPricingSummary(original.currencyCode)
+    });
+    em.persist(newCpqConfig);
+    const originalLines = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: original.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    const lineIdMap = /* @__PURE__ */ new Map();
+    for (const origLine of originalLines) {
+      const origSalesLine = await em.findOne(SalesQuoteLine, {
+        id: origLine.quoteLineId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId
+      });
+      const newSalesLineId = crypto.randomUUID();
+      const newSalesLine = em.create(SalesQuoteLine, {
+        id: newSalesLineId,
+        quote: newSalesQuote,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        lineNumber: origSalesLine?.lineNumber ?? 1,
+        kind: origSalesLine?.kind ?? "product",
+        productId: origSalesLine?.productId ?? null,
+        name: origSalesLine?.name ?? null,
+        quantity: origSalesLine?.quantity ?? "1",
+        unitPriceNet: origSalesLine?.unitPriceNet ?? "0",
+        unitPriceGross: origSalesLine?.unitPriceGross ?? "0",
+        totalNetAmount: origSalesLine?.totalNetAmount ?? "0",
+        totalGrossAmount: origSalesLine?.totalGrossAmount ?? "0",
+        discountAmount: origSalesLine?.discountAmount ?? "0",
+        discountPercent: origSalesLine?.discountPercent ?? "0",
+        taxRate: origSalesLine?.taxRate ?? "0",
+        taxAmount: origSalesLine?.taxAmount ?? "0",
+        currencyCode: origSalesLine?.currencyCode ?? original.currencyCode,
+        configuration: origSalesLine?.configuration ?? null,
+        normalizedQuantity: origSalesLine?.normalizedQuantity ?? "0",
+        createdAt: /* @__PURE__ */ new Date(),
+        updatedAt: /* @__PURE__ */ new Date()
+      });
+      em.persist(newSalesLine);
+      lineIdMap.set(origLine.quoteLineId, newSalesLine.id);
+      const newLineConfig = em.create(CpqQuoteLineConfiguration, {
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        quoteLineId: newSalesLine.id,
+        quoteConfigurationId: newCpqConfig.id,
+        offeringId: origLine.offeringId,
+        productId: origLine.productId,
+        specId: origLine.specId,
+        action: origLine.action,
+        parentLineId: null,
+        // Will be resolved after all lines are created
+        startDate: origLine.startDate,
+        termMonths: origLine.termMonths,
+        endDate: origLine.endDate,
+        configuration: { ...origLine.configuration },
+        quantity: origLine.quantity,
+        charges: origLine.charges ? [...origLine.charges] : null,
+        nrcTotal: origLine.nrcTotal,
+        mrcTotal: origLine.mrcTotal,
+        usageEstimates: origLine.usageEstimates,
+        usageTotalEstimated: origLine.usageTotalEstimated,
+        validationErrors: origLine.validationErrors,
+        isConfigured: origLine.isConfigured
+      });
+      em.persist(newLineConfig);
+    }
+    const newLines = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: newCpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    for (const origLine of originalLines) {
+      if (origLine.parentLineId) {
+        const newParentLineId = lineIdMap.get(origLine.parentLineId);
+        const newLine = newLines.find((l) => l.quoteLineId === lineIdMap.get(origLine.quoteLineId));
+        if (newLine && newParentLineId) {
+          newLine.parentLineId = newParentLineId;
+        }
+      }
+    }
+    await em.flush();
+    return this.recalculateInternal(em, newCpqConfig, newSalesQuote, scope, true);
+  }
+  // ─── Transition Status ─────────────────────────────────────────
+  async transitionStatus(quoteId, targetStatus, scope) {
+    const em = this.em;
+    const cpqConfig = await this.loadCpqConfig(em, quoteId, scope);
+    const salesQuote = await this.loadSalesQuote(em, cpqConfig.quoteId, scope);
+    const currentStatus = cpqConfig.cpqStatus;
+    const allowed = ALLOWED_TRANSITIONS[currentStatus] ?? [];
+    if (!allowed.includes(targetStatus)) {
+      throw new QuotingError(409, `Cannot transition from '${currentStatus}' to '${targetStatus}'`);
+    }
+    const isSubmitForApproval = targetStatus === "in_approval" || targetStatus === "pre_approved" || targetStatus === "with_customer";
+    const quoteType = cpqConfig.quoteType ?? "new";
+    if (isSubmitForApproval && quoteType !== "new") {
+      const validation = await this.validateArcQuote(quoteId, scope);
+      if (!validation.ok) {
+        throw new QuotingError(
+          422,
+          `ARC quote validation failed: ${validation.errors.join("; ")}`
+        );
+      }
+    }
+    cpqConfig.cpqStatus = targetStatus;
+    await em.flush();
+    const lines = await this.loadLineConfigs(em, cpqConfig.id, scope);
+    return this.buildQuoteResult(em, cpqConfig, salesQuote, lines);
+  }
+  // ─── Internal: Recalculate ─────────────────────────────────────
+  async recalculateInternal(em, cpqConfig, salesQuote, scope, save) {
+    const lineConfigs = await em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    let allValid = true;
+    const allErrors = [];
+    const computedLines = [];
+    for (const lineConfig of lineConfigs) {
+      let offering = null;
+      if (lineConfig.offeringId) {
+        offering = await em.findOne(CpqProductOffering, {
+          id: lineConfig.offeringId,
+          organizationId: scope.organizationId,
+          tenantId: scope.tenantId,
+          deletedAt: null
+        });
+      }
+      const mergedConfig = {
+        ...cpqConfig.quoteContext ?? {},
+        ...offering?.designTimeValues ?? {},
+        ...lineConfig.configuration
+      };
+      if (lineConfig.termMonths) {
+        mergedConfig.term_months = lineConfig.termMonths;
+      }
+      let validationErrors = [];
+      if (lineConfig.offeringId) {
+        const validation = await this.validationService.validateOfferingConfiguration({
+          offeringId: lineConfig.offeringId,
+          configuration: lineConfig.configuration,
+          scope
+        });
+        validationErrors = validation.errors;
+      }
+      const cfgRecord = lineConfig.configuration;
+      const isArcMirrored = !!cfgRecord?._arcMirroredFromItemId;
+      let charges;
+      if (lineConfig.offeringId || lineConfig.productId) {
+        charges = await this.pricingService.resolveProductCharges({
+          offeringId: lineConfig.offeringId ?? void 0,
+          productId: lineConfig.productId ?? void 0,
+          configuration: mergedConfig,
+          currencyCode: cpqConfig.currencyCode,
+          ...scope
+        });
+      } else {
+        charges = lineConfig.charges ?? [];
+      }
+      const { nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated } = computeLineTotals(
+        charges,
+        lineConfig.quantity,
+        lineConfig.usageEstimates?.map((e) => ({ chargeCode: e.chargeCode, estimatedQuantity: e.estimatedQuantity }))
+      );
+      const isBundleOffering = offering?.offeringType === "bundle";
+      const isConfigured = validationErrors.length === 0 && (charges.length > 0 || isBundleOffering || isArcMirrored);
+      if (!isConfigured) allValid = false;
+      allErrors.push(...validationErrors);
+      computedLines.push({ lineConfig, charges, nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated, validationErrors, isConfigured });
+      if (save) {
+        em.assign(lineConfig, {
+          charges,
+          nrcTotal: String(nrcTotal),
+          mrcTotal: String(mrcTotal),
+          usageEstimates: usageEstimates ?? null,
+          usageTotalEstimated: usageTotalEstimated != null ? String(usageTotalEstimated) : null,
+          validationErrors: validationErrors.length > 0 ? validationErrors : null,
+          isConfigured
+        });
+        const salesLine = await em.findOne(SalesQuoteLine, {
+          id: lineConfig.quoteLineId,
+          organizationId: scope.organizationId,
+          tenantId: scope.tenantId
+        });
+        if (salesLine) {
+          const perInstanceNrc = charges.filter((c) => c.chargeType === "nrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+          const perInstanceMrc = charges.filter((c) => c.chargeType === "mrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+          const unitPriceNet = perInstanceNrc + perInstanceMrc;
+          em.assign(salesLine, {
+            quantity: String(lineConfig.quantity),
+            unitPriceNet: String(unitPriceNet),
+            unitPriceGross: String(unitPriceNet),
+            totalNetAmount: String(unitPriceNet * lineConfig.quantity),
+            totalGrossAmount: String(unitPriceNet * lineConfig.quantity),
+            updatedAt: /* @__PURE__ */ new Date()
+          });
+        }
+      }
+    }
+    const relationshipErrors = await this.validationService.validateRelationships({
+      lines: lineConfigs.map((l) => ({
+        lineId: l.quoteLineId,
+        specId: l.specId ?? null,
+        parentLineId: l.parentLineId ?? null
+      })),
+      scope
+    });
+    allErrors.push(...relationshipErrors);
+    if (relationshipErrors.length > 0) allValid = false;
+    let cpqStatus;
+    if (lineConfigs.length === 0) {
+      cpqStatus = "new";
+    } else if (!allValid) {
+      cpqStatus = "incomplete";
+    } else {
+      cpqStatus = "ready";
+    }
+    const autoManagedStatuses = ["new", "incomplete", "ready"];
+    if (autoManagedStatuses.includes(cpqConfig.cpqStatus)) {
+      cpqConfig.cpqStatus = cpqStatus;
+    }
+    const pricingSummary = computePricingSummaryFromComputed(computedLines, cpqConfig.currencyCode);
+    const validationResult = { valid: allValid, errors: allErrors };
+    if (save) {
+      cpqConfig.validationResult = validationResult;
+      cpqConfig.pricingSummary = pricingSummary;
+      const grandTotal = pricingSummary.nrcTotal + pricingSummary.mrcTotal;
+      em.assign(salesQuote, {
+        subtotalNetAmount: String(grandTotal),
+        subtotalGrossAmount: String(grandTotal),
+        grandTotalNetAmount: String(grandTotal),
+        grandTotalGrossAmount: String(grandTotal),
+        lineItemCount: lineConfigs.length,
+        updatedAt: /* @__PURE__ */ new Date()
+      });
+      await em.flush();
+    }
+    return this.buildQuoteResultFromComputed(em, cpqConfig, salesQuote, computedLines, validationResult, pricingSummary);
+  }
+  // ─── Helpers ───────────────────────────────────────────────────
+  async loadCpqConfig(em, quoteId, scope) {
+    let config = await em.findOne(CpqQuoteConfiguration, {
+      id: quoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (!config) {
+      config = await em.findOne(CpqQuoteConfiguration, {
+        quoteId,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+    }
+    if (!config) throw new QuotingError(404, "Quote not found");
+    return config;
+  }
+  async loadSalesQuote(em, quoteId, scope) {
+    const quote = await em.findOne(SalesQuote, {
+      id: quoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId
+    });
+    if (!quote) throw new QuotingError(404, "Sales quote not found");
+    return quote;
+  }
+  async loadLineConfigs(em, cpqConfigId, scope) {
+    return em.find(CpqQuoteLineConfiguration, {
+      quoteConfigurationId: cpqConfigId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+  }
+  async resolveOffering(em, item, scope) {
+    const dbScope = { organizationId: scope.organizationId, tenantId: scope.tenantId, deletedAt: null };
+    if (item.offeringId) {
+      const offering = await em.findOne(CpqProductOffering, { id: item.offeringId, ...dbScope });
+      if (!offering) throw new QuotingError(404, `Offering ${item.offeringId} not found`);
+      const spec = await em.findOne(CpqProductSpecification, { id: offering.specId, ...dbScope });
+      return { offering, spec };
+    }
+    if (item.productId) {
+      const spec = await em.findOne(CpqProductSpecification, { productId: item.productId, ...dbScope });
+      return { offering: null, spec };
+    }
+    throw new QuotingError(400, "Either offeringId or productId is required");
+  }
+  async buildQuoteResult(em, cpqConfig, salesQuote, lineConfigs, validationResult, pricingSummary) {
+    const lines = [];
+    const arcSourceMap = await loadArcSourceMap(em, lineConfigs, cpqConfig);
+    for (const lc of lineConfigs) {
+      let offeringName = null;
+      let offeringType = null;
+      if (lc.offeringId) {
+        const offering = await em.findOne(CpqProductOffering, {
+          id: lc.offeringId,
+          organizationId: cpqConfig.organizationId,
+          tenantId: cpqConfig.tenantId
+        });
+        if (offering) {
+          offeringName = offering.name;
+          offeringType = offering.offeringType ?? "simple";
+        }
+      }
+      if (!offeringName) {
+        const cfg = lc.configuration;
+        offeringName = cfg?._arcMirroredName ?? cfg?.offeringName ?? "Configured Item";
+      }
+      lines.push({
+        lineId: lc.quoteLineId,
+        offeringId: lc.offeringId ?? null,
+        offeringName,
+        offeringType,
+        productId: lc.productId ?? 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),
+        usageEstimates: lc.usageEstimates ?? null,
+        usageTotalEstimated: lc.usageTotalEstimated != null ? Number(lc.usageTotalEstimated) : null,
+        charges: lc.charges ?? [],
+        isConfigured: lc.isConfigured,
+        validationErrors: lc.validationErrors ?? null,
+        arcSource: pickArcSource(lc, arcSourceMap),
+        targetSubscriptionId: lc.targetSubscriptionId ?? null
+      });
+    }
+    const finalValidation = validationResult ?? cpqConfig.validationResult ?? { valid: true, errors: [] };
+    const finalPricing = pricingSummary ?? computePricingSummary(lineConfigs, cpqConfig.currencyCode);
+    const { customerName, convertedOrderId } = await resolveQuoteSideData(em, cpqConfig);
+    return {
+      id: cpqConfig.id,
+      quoteId: cpqConfig.quoteId,
+      quoteNumber: salesQuote.quoteNumber ?? "",
+      customerId: cpqConfig.customerId,
+      customerName,
+      cpqStatus: cpqConfig.cpqStatus,
+      version: cpqConfig.version,
+      parentQuoteId: cpqConfig.parentQuoteId ?? null,
+      currencyCode: cpqConfig.currencyCode,
+      convertedOrderId,
+      validationResult: finalValidation,
+      pricingSummary: finalPricing,
+      lines
+    };
+  }
+  /**
+   * Build quote result from freshly computed line data instead of (potentially stale) entity fields.
+   * Used by recalculateInternal to ensure both save:true and save:false return current prices.
+   */
+  async buildQuoteResultFromComputed(em, cpqConfig, salesQuote, computedLines, validationResult, pricingSummary) {
+    const lines = [];
+    const arcSourceMap = await loadArcSourceMap(
+      em,
+      computedLines.map((c) => c.lineConfig),
+      cpqConfig
+    );
+    for (const { lineConfig: lc, charges, nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated, validationErrors, isConfigured } of computedLines) {
+      let offeringName = null;
+      let offeringType = null;
+      if (lc.offeringId) {
+        const offering = await em.findOne(CpqProductOffering, {
+          id: lc.offeringId,
+          organizationId: cpqConfig.organizationId,
+          tenantId: cpqConfig.tenantId
+        });
+        if (offering) {
+          offeringName = offering.name;
+          offeringType = offering.offeringType ?? "simple";
+        }
+      }
+      if (!offeringName) {
+        const cfg = lc.configuration;
+        offeringName = cfg?._arcMirroredName ?? cfg?.offeringName ?? "Configured Item";
+      }
+      lines.push({
+        lineId: lc.quoteLineId,
+        offeringId: lc.offeringId ?? null,
+        offeringName,
+        offeringType,
+        productId: lc.productId ?? 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,
+        mrcTotal,
+        usageEstimates,
+        usageTotalEstimated,
+        charges,
+        isConfigured,
+        validationErrors: validationErrors.length > 0 ? validationErrors : null,
+        arcSource: pickArcSource(lc, arcSourceMap),
+        targetSubscriptionId: lc.targetSubscriptionId ?? null
+      });
+    }
+    const { customerName, convertedOrderId } = await resolveQuoteSideData(em, cpqConfig);
+    return {
+      id: cpqConfig.id,
+      quoteId: cpqConfig.quoteId,
+      quoteNumber: salesQuote.quoteNumber ?? "",
+      customerId: cpqConfig.customerId,
+      customerName,
+      cpqStatus: cpqConfig.cpqStatus,
+      version: cpqConfig.version,
+      parentQuoteId: cpqConfig.parentQuoteId ?? null,
+      currencyCode: cpqConfig.currencyCode,
+      convertedOrderId,
+      validationResult,
+      pricingSummary,
+      lines
+    };
+  }
+}
+async function resolveQuoteSideData(em, cpqConfig) {
+  const scope = {
+    organizationId: cpqConfig.organizationId,
+    tenantId: cpqConfig.tenantId
+  };
+  const [customer, existingOrder] = await Promise.all([
+    em.findOne(CustomerEntity, { id: cpqConfig.customerId, ...scope }),
+    em.findOne(
+      CpqOrderConfiguration,
+      { sourceQuoteId: cpqConfig.id, ...scope, deletedAt: null },
+      { fields: ["id", "orderId"] }
+    )
+  ]);
+  return {
+    customerName: customer?.displayName ?? null,
+    convertedOrderId: existingOrder?.orderId ?? null
+  };
+}
+function buildCustomerSnapshot(customer) {
+  return {
+    customer: {
+      id: customer.id,
+      kind: customer.kind,
+      displayName: customer.displayName,
+      primaryEmail: customer.primaryEmail ?? null,
+      primaryPhone: customer.primaryPhone ?? null,
+      personProfile: customer.personProfile ? {
+        id: customer.personProfile.id,
+        firstName: customer.personProfile.firstName ?? null,
+        lastName: customer.personProfile.lastName ?? null,
+        preferredName: customer.personProfile.preferredName ?? null
+      } : null,
+      companyProfile: customer.companyProfile ? {
+        id: customer.companyProfile.id,
+        legalName: customer.companyProfile.legalName ?? null,
+        brandName: customer.companyProfile.brandName ?? null,
+        domain: customer.companyProfile.domain ?? null,
+        websiteUrl: customer.companyProfile.websiteUrl ?? null
+      } : null
+    },
+    contact: null
+  };
+}
+function computeLineTotals(charges, quantity, usageEstimateInputs) {
+  const nrcPerInstance = charges.filter((c) => c.chargeType === "nrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+  const mrcPerInstance = charges.filter((c) => c.chargeType === "mrc").reduce((s, c) => s + (c.totalPrice ?? 0), 0);
+  const nrcTotal = nrcPerInstance * quantity;
+  const mrcTotal = mrcPerInstance * quantity;
+  let usageEstimates = null;
+  let usageTotalEstimated = null;
+  if (usageEstimateInputs && usageEstimateInputs.length > 0) {
+    const usageCharges = charges.filter((c) => c.chargeType === "usage");
+    usageEstimates = usageEstimateInputs.map((est) => {
+      const charge = usageCharges.find((c) => c.chargeCode === est.chargeCode);
+      const estimatedTotal = (charge?.unitPrice ?? 0) * est.estimatedQuantity;
+      return {
+        chargeCode: est.chargeCode,
+        estimatedQuantity: est.estimatedQuantity,
+        estimatedTotal
+      };
+    });
+    usageTotalEstimated = usageEstimates.reduce((s, e) => s + e.estimatedTotal, 0) * quantity;
+  }
+  return { nrcTotal, mrcTotal, usageEstimates, usageTotalEstimated };
+}
+function computeEndDate(startDate, termMonths, endDate) {
+  if (endDate) return endDate;
+  if (startDate && termMonths) {
+    const start = new Date(startDate);
+    start.setMonth(start.getMonth() + termMonths);
+    return start.toISOString().split("T")[0];
+  }
+  return null;
+}
+function aggregateAdjustmentTotals(allCharges) {
+  let discountTotal = 0;
+  let surchargeTotal = 0;
+  for (const charge of allCharges) {
+    if (!charge.adjustments) continue;
+    for (const adj of charge.adjustments) {
+      if (adj.delta < 0) {
+        discountTotal += Math.abs(adj.delta) * (charge.quantity ?? 1);
+      } else if (adj.delta > 0) {
+        surchargeTotal += adj.delta * (charge.quantity ?? 1);
+      }
+    }
+  }
+  return { discountTotal, surchargeTotal };
+}
+function computePricingSummary(lineConfigs, currencyCode) {
+  let nrcTotal = 0;
+  let mrcTotal = 0;
+  let usageTotalEstimated = null;
+  const usageCharges = [];
+  const allCharges = [];
+  for (const lc of lineConfigs) {
+    nrcTotal += Number(lc.nrcTotal);
+    mrcTotal += Number(lc.mrcTotal);
+    if (lc.usageTotalEstimated != null) {
+      usageTotalEstimated = (usageTotalEstimated ?? 0) + Number(lc.usageTotalEstimated);
+    }
+    const charges = lc.charges ?? [];
+    allCharges.push(...charges);
+    for (const charge of charges) {
+      if (charge.chargeType === "usage") {
+        usageCharges.push({
+          chargeCode: charge.chargeCode,
+          chargeName: charge.chargeName,
+          unitPrice: charge.unitPrice,
+          note: charge.note ?? null
+        });
+      }
+    }
+  }
+  const { discountTotal, surchargeTotal } = aggregateAdjustmentTotals(allCharges);
+  return {
+    nrcTotal,
+    mrcTotal,
+    usageCharges,
+    usageTotalEstimated,
+    discountTotal,
+    surchargeTotal,
+    currencyCode
+  };
+}
+function computePricingSummaryFromComputed(computedLines, currencyCode) {
+  let nrcTotal = 0;
+  let mrcTotal = 0;
+  let usageTotalEstimated = null;
+  const usageCharges = [];
+  const allCharges = [];
+  for (const { charges, nrcTotal: lineNrc, mrcTotal: lineMrc, usageTotalEstimated: lineUsageEst } of computedLines) {
+    nrcTotal += lineNrc;
+    mrcTotal += lineMrc;
+    if (lineUsageEst != null) {
+      usageTotalEstimated = (usageTotalEstimated ?? 0) + lineUsageEst;
+    }
+    allCharges.push(...charges);
+    for (const charge of charges) {
+      if (charge.chargeType === "usage") {
+        usageCharges.push({
+          chargeCode: charge.chargeCode,
+          chargeName: charge.chargeName,
+          unitPrice: charge.unitPrice,
+          note: charge.note ?? null
+        });
+      }
+    }
+  }
+  const { discountTotal, surchargeTotal } = aggregateAdjustmentTotals(allCharges);
+  return {
+    nrcTotal,
+    mrcTotal,
+    usageCharges,
+    usageTotalEstimated,
+    discountTotal,
+    surchargeTotal,
+    currencyCode
+  };
+}
+function emptyPricingSummary(currencyCode) {
+  return {
+    nrcTotal: 0,
+    mrcTotal: 0,
+    usageCharges: [],
+    usageTotalEstimated: null,
+    discountTotal: 0,
+    surchargeTotal: 0,
+    currencyCode
+  };
+}
+class QuotingError extends Error {
+  constructor(status, message, cpqStatus, details) {
+    super(message);
+    this.status = status;
+    this.cpqStatus = cpqStatus;
+    this.details = details;
+    this.name = "QuotingError";
+  }
+}
+const EDITABLE_QUOTE_STATUSES = /* @__PURE__ */ new Set([
+  "new",
+  "incomplete",
+  "ready"
+]);
+function ensureEditable(cpqConfig) {
+  if (!EDITABLE_QUOTE_STATUSES.has(cpqConfig.cpqStatus)) {
+    throw new QuotingError(
+      409,
+      `Cannot modify ARC attachments \u2014 quote is in '${cpqConfig.cpqStatus}' status`
+    );
+  }
+}
+function toDateOrNull(value) {
+  if (value == null) return null;
+  return value instanceof Date ? value : new Date(value);
+}
+function toIsoOrNull(value) {
+  if (value == null) return null;
+  if (value instanceof Date) return value.toISOString();
+  return String(value);
+}
+DefaultCpqQuotingService.prototype.setQuoteType = async function(quoteId, type, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  if (cpqConfig.quoteType === type) {
+  } else if (cpqConfig.quoteType !== "new") {
+    throw new QuotingError(409, `Quote type is immutable (current: '${cpqConfig.quoteType}')`);
+  } else if (type === "new") {
+    throw new QuotingError(400, `Cannot transition quote type back to 'new'`);
+  } else {
+    cpqConfig.quoteType = type;
+    await em.flush();
+  }
+  const salesQuote = await loadSalesQuoteStrict(em, cpqConfig.quoteId, scope);
+  const lines = await loadLines(em, cpqConfig.id, scope);
+  return this.buildQuoteResult(em, cpqConfig, salesQuote, lines);
+};
+DefaultCpqQuotingService.prototype.createQuoteFromSubscription = async function(input, scope) {
+  const em = this.em;
+  const sub = await em.findOne(CpqInventorySubscription, {
+    id: input.subscriptionId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (!sub) throw new QuotingError(404, "Subscription not found");
+  if (sub.status !== "active" && sub.status !== "suspended") {
+    throw new QuotingError(
+      409,
+      `Subscription must be active or suspended (current: '${sub.status}')`
+    );
+  }
+  await ensureNoConcurrentArcQuote(em, sub.id, scope);
+  const items = await em.find(CpqInventorySubscriptionItem, {
+    subscriptionId: sub.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null,
+    status: { $nin: ["terminated", "expired", "superseded"] }
+  });
+  const numberGenerator = this.numberGenerator;
+  const { number: quoteNumber } = await numberGenerator.generate({
+    kind: "quote",
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId
+  });
+  const salesQuoteId = crypto.randomUUID();
+  const salesQuote = em.create(SalesQuote, {
+    id: salesQuoteId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    quoteNumber,
+    customerEntityId: sub.customerId,
+    currencyCode: sub.currencyCode,
+    subtotalNetAmount: "0",
+    subtotalGrossAmount: "0",
+    discountTotalAmount: "0",
+    taxTotalAmount: "0",
+    grandTotalNetAmount: "0",
+    grandTotalGrossAmount: "0",
+    lineItemCount: 0,
+    createdAt: /* @__PURE__ */ new Date(),
+    updatedAt: /* @__PURE__ */ new Date()
+  });
+  em.persist(salesQuote);
+  const cpqConfigId = crypto.randomUUID();
+  const cpqConfig = em.create(CpqQuoteConfiguration, {
+    id: cpqConfigId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    quoteId: salesQuoteId,
+    customerId: sub.customerId,
+    cpqStatus: "new",
+    version: 1,
+    currencyCode: sub.currencyCode,
+    quoteType: input.type,
+    quoteContext: { arcSourceSubscriptionId: sub.id },
+    validationResult: { valid: true, errors: [] },
+    pricingSummary: emptyArcPricingSummary(sub.currencyCode)
+  });
+  em.persist(cpqConfig);
+  const renewDefaults = input.type === "renew" ? buildRenewDefaults(sub, input.renewTerm) : null;
+  const target = em.create(CpqQuoteTargetSubscription, {
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    quoteId: cpqConfig.id,
+    subscriptionId: sub.id,
+    quoteType: input.type,
+    mergeAction: input.type === "renew" ? "standalone" : null,
+    newTermStart: renewDefaults?.start ?? null,
+    newTermEnd: renewDefaults?.end ?? null,
+    newTermMonths: renewDefaults?.months ?? null
+  });
+  em.persist(target);
+  await mirrorTargetSubscriptionItems(em, cpqConfig, sub, salesQuote, input.type, scope);
+  await em.flush();
+  return { quoteId: salesQuoteId, cpqConfigId: cpqConfig.id };
+};
+DefaultCpqQuotingService.prototype.listTargetSubscriptions = async function(quoteId, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  const targets = await em.find(CpqQuoteTargetSubscription, {
+    quoteId: cpqConfig.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (targets.length === 0) return [];
+  const subs = await em.find(CpqInventorySubscription, {
+    id: { $in: targets.map((t) => t.subscriptionId) },
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  const subMap = new Map(subs.map((s) => [s.id, s]));
+  return targets.map((t) => {
+    const s = subMap.get(t.subscriptionId);
+    return {
+      id: t.id,
+      subscriptionId: t.subscriptionId,
+      quoteType: t.quoteType,
+      mergeAction: t.mergeAction ?? null,
+      newTermStart: toIsoOrNull(t.newTermStart),
+      newTermEnd: toIsoOrNull(t.newTermEnd),
+      newTermMonths: t.newTermMonths ?? null,
+      subscription: s ? {
+        code: s.code,
+        name: s.name,
+        status: s.status,
+        customerId: s.customerId,
+        currencyCode: s.currencyCode,
+        billingCycle: s.billingCycle,
+        currentTermStart: toIsoOrNull(s.currentTermStart),
+        currentTermEnd: toIsoOrNull(s.currentTermEnd),
+        termMonths: s.termMonths ?? null,
+        mrcAmount: Number(s.mrcAmount)
+      } : null
+    };
+  });
+};
+DefaultCpqQuotingService.prototype.attachTargetSubscription = async function(quoteId, input, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  if (cpqConfig.quoteType === "new") {
+    throw new QuotingError(409, `Cannot attach a target subscription \u2014 quote_type is 'new'`);
+  }
+  if (cpqConfig.quoteType !== input.quoteType) {
+    throw new QuotingError(
+      400,
+      `Quote type mismatch: quote is '${cpqConfig.quoteType}', payload says '${input.quoteType}'`
+    );
+  }
+  const existing = await em.findOne(CpqQuoteTargetSubscription, {
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null,
+    quoteId: cpqConfig.id,
+    subscriptionId: input.subscriptionId
+  });
+  if (existing) {
+    return mapTargetView(em, existing, scope);
+  }
+  const sub = await em.findOne(CpqInventorySubscription, {
+    id: input.subscriptionId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (!sub) throw new QuotingError(404, "Subscription not found");
+  if (sub.status !== "active" && sub.status !== "suspended") {
+    throw new QuotingError(
+      409,
+      `Subscription must be active or suspended (current: '${sub.status}')`
+    );
+  }
+  if (sub.customerId !== cpqConfig.customerId) {
+    throw new QuotingError(400, "Subscription customer must match quote customer");
+  }
+  if (sub.currencyCode !== cpqConfig.currencyCode) {
+    throw new QuotingError(400, "Subscription currency must match quote currency");
+  }
+  const otherTargets = await em.find(CpqQuoteTargetSubscription, {
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null,
+    quoteId: cpqConfig.id
+  });
+  if (input.quoteType === "renew" && otherTargets.length > 0) {
+    const otherSubs = await em.find(CpqInventorySubscription, {
+      id: { $in: otherTargets.map((t) => t.subscriptionId) },
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    for (const o of otherSubs) {
+      if (o.billingCycle !== sub.billingCycle) {
+        throw new QuotingError(
+          400,
+          "Merge targets must share the same billing cycle"
+        );
+      }
+    }
+  }
+  await ensureNoConcurrentArcQuote(em, input.subscriptionId, scope, cpqConfig.id);
+  const target = em.create(CpqQuoteTargetSubscription, {
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    quoteId: cpqConfig.id,
+    subscriptionId: input.subscriptionId,
+    quoteType: input.quoteType,
+    mergeAction: input.quoteType === "renew" ? input.mergeAction ?? (otherTargets.length === 0 ? "standalone" : "absorb") : null,
+    newTermStart: toDateOrNull(input.newTermStart),
+    newTermEnd: toDateOrNull(input.newTermEnd),
+    newTermMonths: input.newTermMonths ?? null
+  });
+  em.persist(target);
+  await em.flush();
+  let renewMergeJustEntered = false;
+  if (input.quoteType === "renew") {
+    const allTargets = await em.find(CpqQuoteTargetSubscription, {
+      quoteId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+    if (allTargets.length >= 2) {
+      const wasStandalone = allTargets.some((t) => t.mergeAction === "standalone");
+      for (const t of allTargets) {
+        t.mergeAction = "absorb";
+        t.newTermStart = null;
+        t.newTermEnd = null;
+        t.newTermMonths = null;
+      }
+      await em.flush();
+      renewMergeJustEntered = wasStandalone;
+    }
+  }
+  const salesQuote = await em.findOne(SalesQuote, {
+    id: cpqConfig.quoteId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId
+  });
+  if (salesQuote) {
+    const isRenewMerge = input.quoteType === "renew" && otherTargets.length > 0;
+    await mirrorTargetSubscriptionItems(
+      em,
+      cpqConfig,
+      sub,
+      salesQuote,
+      input.quoteType,
+      scope,
+      { mergeMode: isRenewMerge }
+    );
+    if (renewMergeJustEntered) {
+      const existingLines = await em.find(CpqQuoteLineConfiguration, {
+        quoteConfigurationId: cpqConfig.id,
+        organizationId: scope.organizationId,
+        tenantId: scope.tenantId,
+        deletedAt: null
+      });
+      for (const lc of existingLines) {
+        if (lc.targetSubscriptionId !== null) lc.targetSubscriptionId = null;
+      }
+    }
+    await em.flush();
+  }
+  return mapTargetView(em, target, scope);
+};
+DefaultCpqQuotingService.prototype.detachTargetSubscription = async function(quoteId, targetId, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  const target = await em.findOne(CpqQuoteTargetSubscription, {
+    id: targetId,
+    quoteId: cpqConfig.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (!target) throw new QuotingError(404, "Target subscription not found");
+  const lines = await em.find(CpqQuoteLineConfiguration, {
+    quoteConfigurationId: cpqConfig.id,
+    targetSubscriptionId: target.subscriptionId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  const now = /* @__PURE__ */ new Date();
+  for (const line of lines) {
+    line.deletedAt = now;
+    const salesLine = await em.findOne(SalesQuoteLine, { id: line.quoteLineId });
+    if (salesLine) salesLine.deletedAt = now;
+  }
+  target.deletedAt = now;
+  if (target.quoteType === "renew") {
+    const remaining = await em.find(CpqQuoteTargetSubscription, {
+      quoteId: cpqConfig.id,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null,
+      id: { $ne: target.id }
+    });
+    if (remaining.length === 1) {
+      remaining[0].mergeAction = "standalone";
+    }
+  }
+  await em.flush();
+  return { ok: true };
+};
+DefaultCpqQuotingService.prototype.updateTargetSubscription = async function(quoteId, targetId, patch, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  const target = await em.findOne(CpqQuoteTargetSubscription, {
+    id: targetId,
+    quoteId: cpqConfig.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (!target) throw new QuotingError(404, "Target subscription not found");
+  if (target.quoteType !== "renew") {
+    throw new QuotingError(
+      409,
+      `Cannot update target on a '${target.quoteType}' quote \u2014 only renew targets carry term/merge fields`
+    );
+  }
+  if (patch.mergeAction !== void 0) target.mergeAction = patch.mergeAction;
+  if (patch.newTermStart !== void 0) target.newTermStart = toDateOrNull(patch.newTermStart);
+  if (patch.newTermEnd !== void 0) target.newTermEnd = toDateOrNull(patch.newTermEnd);
+  if (patch.newTermMonths !== void 0) target.newTermMonths = patch.newTermMonths ?? null;
+  await em.flush();
+  return mapTargetView(em, target, scope);
+};
+DefaultCpqQuotingService.prototype.setCancelMeta = async function(quoteId, meta, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  if (cpqConfig.quoteType !== "cancel") {
+    throw new QuotingError(
+      409,
+      `Cancel meta can only be set on a cancel quote (current: '${cpqConfig.quoteType}')`
+    );
+  }
+  cpqConfig.arcReasonCode = meta.reasonCode;
+  cpqConfig.arcReasonText = meta.reasonText ?? null;
+  cpqConfig.arcEtfAmount = meta.etfAmount != null ? String(meta.etfAmount) : null;
+  cpqConfig.arcEtfCurrency = meta.etfCurrency ?? cpqConfig.currencyCode;
+  await em.flush();
+  const salesQuote = await loadSalesQuoteStrict(em, cpqConfig.quoteId, scope);
+  const lines = await loadLines(em, cpqConfig.id, scope);
+  return this.buildQuoteResult(em, cpqConfig, salesQuote, lines);
+};
+DefaultCpqQuotingService.prototype.setMergeMeta = async function(quoteId, meta, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  ensureEditable(cpqConfig);
+  if (cpqConfig.quoteType !== "renew") {
+    throw new QuotingError(
+      409,
+      `Merge meta can only be set on a renew quote (current: '${cpqConfig.quoteType}')`
+    );
+  }
+  cpqConfig.arcMergeNewTermStart = toDateOrNull(meta.newTermStart);
+  cpqConfig.arcMergeNewTermEnd = toDateOrNull(meta.newTermEnd);
+  cpqConfig.arcMergeNewTermMonths = meta.newTermMonths ?? null;
+  cpqConfig.arcMergeNewSubCode = meta.newSubCode ?? null;
+  cpqConfig.arcMergeNewSubName = meta.newSubName ?? null;
+  await em.flush();
+  const salesQuote = await loadSalesQuoteStrict(em, cpqConfig.quoteId, scope);
+  const lines = await loadLines(em, cpqConfig.id, scope);
+  return this.buildQuoteResult(em, cpqConfig, salesQuote, lines);
+};
+DefaultCpqQuotingService.prototype.validateArcQuote = async function(quoteId, scope) {
+  const em = this.em;
+  const cpqConfig = await loadCpqConfigStrict(em, quoteId, scope);
+  const errors = [];
+  if (cpqConfig.quoteType === "new") {
+    return { ok: true, errors: [] };
+  }
+  if (!ARC_QUOTE_TYPES.includes(cpqConfig.quoteType)) {
+    errors.push(`Unknown quote type '${cpqConfig.quoteType}'`);
+    return { ok: false, errors };
+  }
+  const targets = await em.find(CpqQuoteTargetSubscription, {
+    quoteId: cpqConfig.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (targets.length === 0) {
+    errors.push(`ARC quote requires at least one target subscription`);
+    return { ok: false, errors };
+  }
+  const subs = await em.find(CpqInventorySubscription, {
+    id: { $in: targets.map((t) => t.subscriptionId) },
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  const subMap = new Map(subs.map((s) => [s.id, s]));
+  for (const t of targets) {
+    const s = subMap.get(t.subscriptionId);
+    if (!s) {
+      errors.push(`Target subscription ${t.subscriptionId} not found`);
+      continue;
+    }
+    if (s.status !== "active" && s.status !== "suspended") {
+      errors.push(
+        `Target subscription ${s.code} must be active or suspended (current: '${s.status}')`
+      );
+    }
+    if (s.customerId !== cpqConfig.customerId) {
+      errors.push(`Target subscription ${s.code} belongs to a different customer`);
+    }
+    if (s.currencyCode !== cpqConfig.currencyCode) {
+      errors.push(`Target subscription ${s.code} has currency mismatch`);
+    }
+  }
+  if (cpqConfig.quoteType === "renew") {
+    const standaloneCount = targets.filter((t) => t.mergeAction === "standalone").length;
+    const absorbCount = targets.filter((t) => t.mergeAction === "absorb").length;
+    if (targets.length === 1) {
+      if (standaloneCount !== 1) {
+        errors.push(`Single-target renew must have merge_action='standalone'`);
+      }
+      const t = targets[0];
+      if (!t.newTermStart || !t.newTermEnd) {
+        errors.push(`Standalone renew target must have newTermStart and newTermEnd`);
+      } else if (t.newTermStart >= t.newTermEnd) {
+        errors.push(`newTermStart must be earlier than newTermEnd`);
+      }
+    } else {
+      if (absorbCount !== targets.length) {
+        errors.push(`Multi-target renew (merge) requires every target merge_action='absorb'`);
+      }
+      if (!cpqConfig.arcMergeNewTermStart || !cpqConfig.arcMergeNewTermEnd) {
+        errors.push(`Merge renew requires quote-level arc_merge_new_term_start and arc_merge_new_term_end`);
+      } else if (cpqConfig.arcMergeNewTermStart >= cpqConfig.arcMergeNewTermEnd) {
+        errors.push(`arc_merge_new_term_start must be earlier than arc_merge_new_term_end`);
+      }
+      const cycles = new Set(
+        targets.map((t) => subMap.get(t.subscriptionId)?.billingCycle).filter(Boolean)
+      );
+      if (cycles.size > 1) {
+        errors.push(`Merge targets must share the same billing cycle`);
+      }
+    }
+  }
+  if (cpqConfig.quoteType === "cancel") {
+    if (!cpqConfig.arcReasonCode) {
+      errors.push(`Cancel quote requires arc_reason_code (call /cancel-meta first)`);
+    }
+  }
+  const lines = await loadLines(em, cpqConfig.id, scope);
+  const targetSubIds = new Set(targets.map((t) => t.subscriptionId));
+  const isMerge = cpqConfig.quoteType === "renew" && targets.length >= 2 && targets.every((t) => t.mergeAction === "absorb");
+  for (const line of lines) {
+    if (cpqConfig.quoteType === "amend" || cpqConfig.quoteType === "cancel") {
+      if (!line.targetSubscriptionId) {
+        errors.push(`Quote line ${line.quoteLineId} missing target_subscription_id`);
+      } else if (!targetSubIds.has(line.targetSubscriptionId)) {
+        errors.push(
+          `Quote line ${line.quoteLineId} target_subscription_id does not match any attached target`
+        );
+      }
+    } else if (cpqConfig.quoteType === "renew") {
+      if (isMerge) {
+        if (line.targetSubscriptionId) {
+          errors.push(
+            `Merge-renew line ${line.quoteLineId} must have null target_subscription_id`
+          );
+        }
+      } else {
+        if (!line.targetSubscriptionId || !targetSubIds.has(line.targetSubscriptionId)) {
+          errors.push(
+            `Standalone renew line ${line.quoteLineId} must target the renewing subscription`
+          );
+        }
+      }
+    }
+    if ((line.action === "cancel" || line.action === "modify") && cpqConfig.quoteType !== "cancel" && !line.sourceSubscriptionItemId) {
+      errors.push(
+        `Quote line ${line.quoteLineId} action='${line.action}' requires source_subscription_item_id`
+      );
+    }
+  }
+  for (const t of targets) {
+    await ensureNoConcurrentArcQuoteForValidation(em, t.subscriptionId, scope, cpqConfig.id, errors);
+  }
+  return { ok: errors.length === 0, errors };
+};
+async function loadCpqConfigStrict(em, quoteId, scope) {
+  let config = await em.findOne(CpqQuoteConfiguration, {
+    id: quoteId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (!config) {
+    config = await em.findOne(CpqQuoteConfiguration, {
+      quoteId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    });
+  }
+  if (!config) throw new QuotingError(404, "Quote not found");
+  return config;
+}
+async function loadSalesQuoteStrict(em, quoteId, scope) {
+  const quote = await em.findOne(SalesQuote, {
+    id: quoteId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId
+  });
+  if (!quote) throw new QuotingError(404, "Sales quote not found");
+  return quote;
+}
+async function loadLines(em, cpqConfigId, scope) {
+  return em.find(CpqQuoteLineConfiguration, {
+    quoteConfigurationId: cpqConfigId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+}
+async function ensureNoConcurrentArcQuote(em, subscriptionId, scope, excludeQuoteConfigId) {
+  const conflicting = await em.find(CpqQuoteTargetSubscription, {
+    subscriptionId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (conflicting.length === 0) return;
+  const cfgIds = conflicting.map((c) => c.quoteId);
+  const cfgs = await em.find(CpqQuoteConfiguration, {
+    id: { $in: cfgIds },
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  for (const cfg of cfgs) {
+    if (excludeQuoteConfigId && cfg.id === excludeQuoteConfigId) continue;
+    if (!TERMINAL_STATUSES.includes(cfg.cpqStatus)) {
+      throw new QuotingError(
+        409,
+        `Subscription has another ARC quote in progress (quoteId=${cfg.quoteId})`,
+        void 0,
+        // Surface the conflicting quote id so the UI can offer "Open the
+        // existing quote" instead of just showing a dead-end alert. Use
+        // `quoteId` (the SalesQuote UUID, what the URL bar shows after the
+        // first Amend) — not `cfg.id` (the CpqQuoteConfiguration UUID) —
+        // so the redirect URL matches the URL the operator would see on a
+        // fresh first-time create, and so the test assertion can compare
+        // the two with `toContain`.
+        { existingQuoteId: cfg.quoteId, existingQuoteStatus: cfg.cpqStatus }
+      );
+    }
+  }
+}
+async function ensureNoConcurrentArcQuoteForValidation(em, subscriptionId, scope, excludeQuoteConfigId, errors) {
+  try {
+    await ensureNoConcurrentArcQuote(em, subscriptionId, scope, excludeQuoteConfigId);
+  } catch (err) {
+    if (err instanceof QuotingError) errors.push(err.message);
+    else throw err;
+  }
+}
+async function mapTargetView(em, target, scope) {
+  const sub = await em.findOne(CpqInventorySubscription, {
+    id: target.subscriptionId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  return {
+    id: target.id,
+    subscriptionId: target.subscriptionId,
+    quoteType: target.quoteType,
+    mergeAction: target.mergeAction ?? null,
+    newTermStart: toIsoOrNull(target.newTermStart),
+    newTermEnd: toIsoOrNull(target.newTermEnd),
+    newTermMonths: target.newTermMonths ?? null,
+    subscription: sub ? {
+      code: sub.code,
+      name: sub.name,
+      status: sub.status,
+      customerId: sub.customerId,
+      currencyCode: sub.currencyCode,
+      billingCycle: sub.billingCycle,
+      currentTermStart: toIsoOrNull(sub.currentTermStart),
+      currentTermEnd: toIsoOrNull(sub.currentTermEnd),
+      termMonths: sub.termMonths ?? null,
+      mrcAmount: Number(sub.mrcAmount)
+    } : null
+  };
+}
+function emptyArcPricingSummary(currencyCode) {
+  return {
+    nrcTotal: 0,
+    mrcTotal: 0,
+    usageCharges: [],
+    usageTotalEstimated: null,
+    discountTotal: 0,
+    surchargeTotal: 0,
+    currencyCode
+  };
+}
+async function loadArcSourceMap(em, lineConfigs, scope) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const lc of lineConfigs) {
+    const fromMarker = lc.configuration?._arcMirroredFromItemId;
+    if (typeof fromMarker === "string") ids.add(fromMarker);
+    if (lc.sourceSubscriptionItemId) ids.add(lc.sourceSubscriptionItemId);
+  }
+  if (ids.size === 0) return /* @__PURE__ */ new Map();
+  const items = await em.find(CpqInventorySubscriptionItem, {
+    id: { $in: Array.from(ids) },
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  return new Map(items.map((it) => [it.id, it]));
+}
+function pickArcSource(lc, map) {
+  const fromMarker = lc.configuration?._arcMirroredFromItemId;
+  const id = (typeof fromMarker === "string" ? fromMarker : null) ?? lc.sourceSubscriptionItemId ?? null;
+  if (!id) return null;
+  const item = map.get(id);
+  if (!item) return null;
+  return {
+    subscriptionItemId: item.id,
+    name: item.name,
+    mrcAmount: Number(item.mrcAmount),
+    nrcAmount: Number(item.nrcAmount),
+    quantity: item.quantity
+  };
+}
+function buildRenewDefaults(sub, override) {
+  if (override) {
+    const start2 = toDateOrNull(override.newTermStart);
+    const end2 = toDateOrNull(override.newTermEnd);
+    const months2 = override.newTermMonths ?? null;
+    if (start2 && end2 && months2 != null) return { start: start2, end: end2, months: months2 };
+  }
+  const months = sub.termMonths ?? 12;
+  const start = sub.currentTermEnd ? new Date(sub.currentTermEnd) : /* @__PURE__ */ new Date();
+  const end = new Date(start);
+  end.setMonth(end.getMonth() + months);
+  return { start, end, months };
+}
+async function mirrorTargetSubscriptionItems(em, cpqConfig, sub, salesQuote, quoteType, scope, options) {
+  const items = await em.find(CpqInventorySubscriptionItem, {
+    subscriptionId: sub.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null,
+    status: { $nin: ["terminated", "expired", "superseded"] }
+  });
+  if (items.length === 0) return;
+  const existingLines = await em.find(SalesQuoteLine, {
+    quote: salesQuote,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  let nextLineNumber = existingLines.length + 1;
+  const subItemIdToSalesLineId = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    subItemIdToSalesLineId.set(item.id, crypto.randomUUID());
+  }
+  const lineAction = quoteType === "cancel" ? "cancel" : "modify";
+  for (const item of items) {
+    const salesLineId = subItemIdToSalesLineId.get(item.id);
+    const parentLineId = item.parentItemId ? subItemIdToSalesLineId.get(item.parentItemId) ?? null : null;
+    const salesLine = em.create(SalesQuoteLine, {
+      id: salesLineId,
+      quote: salesQuote,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      lineNumber: nextLineNumber++,
+      kind: "product",
+      productId: item.productId ?? null,
+      name: item.name,
+      quantity: String(item.quantity),
+      unitPriceNet: "0",
+      unitPriceGross: "0",
+      totalNetAmount: "0",
+      totalGrossAmount: "0",
+      discountAmount: "0",
+      discountPercent: "0",
+      taxRate: "0",
+      taxAmount: "0",
+      currencyCode: sub.currencyCode,
+      configuration: item.configuration ?? null,
+      normalizedQuantity: "0",
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    em.persist(salesLine);
+    const lineConfig = em.create(CpqQuoteLineConfiguration, {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      quoteLineId: salesLineId,
+      quoteConfigurationId: cpqConfig.id,
+      offeringId: item.offeringId ?? null,
+      productId: item.productId ?? null,
+      specId: item.specId ?? null,
+      action: lineAction,
+      parentLineId,
+      startDate: null,
+      termMonths: null,
+      endDate: null,
+      configuration: {
+        ...item.configuration,
+        _arcMirroredFromItemId: item.id,
+        _arcMirroredName: item.name
+      },
+      quantity: item.quantity,
+      charges: pickArcMirrorCharges(item, sub.currencyCode),
+      nrcTotal: String(item.nrcAmount ?? 0),
+      mrcTotal: String(item.mrcAmount),
+      isConfigured: true,
+      // XD-250 spec: merge-renew lines must have null `target_subscription_id`
+      // (the source subs are absorbed into a brand-new sub at activation, so
+      // there's no existing item to bind the line to). For amend / cancel /
+      // standalone-renew, bind to the source sub so per-target validation /
+      // groupings work.
+      targetSubscriptionId: options?.mergeMode ? null : sub.id,
+      sourceSubscriptionItemId: item.id
+    });
+    em.persist(lineConfig);
+  }
+}
+async function resolveArcLineTargetSubscriptionId(em, cpqConfig, scope, explicit) {
+  const quoteType = cpqConfig.quoteType ?? "new";
+  if (quoteType === "new") return null;
+  const targets = await em.find(CpqQuoteTargetSubscription, {
+    quoteId: cpqConfig.id,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    deletedAt: null
+  });
+  if (targets.length === 0) return null;
+  const isMerge = quoteType === "renew" && targets.length >= 2 && targets.every((t) => t.mergeAction === "absorb");
+  if (isMerge) return null;
+  if (explicit) {
+    if (!targets.some((t) => t.subscriptionId === explicit)) {
+      throw new QuotingError(
+        422,
+        `targetSubscriptionId '${explicit}' is not attached to this quote`
+      );
+    }
+    return explicit;
+  }
+  if (targets.length === 1) return targets[0].subscriptionId;
+  throw new QuotingError(
+    422,
+    `Quote has ${targets.length} attached targets \u2014 specify targetSubscriptionId on the line`
+  );
+}
+function pickArcMirrorCharges(item, currencyCode) {
+  const existing = item.charges ?? null;
+  if (existing && existing.length > 0) return [...existing];
+  const sourceQty = Math.max(1, Number(item.quantity) || 1);
+  const mrc = Number(item.mrcAmount) || 0;
+  const nrc = Number(item.nrcAmount ?? 0) || 0;
+  const synth = [];
+  if (mrc > 0) {
+    const perInstance = mrc / sourceQty;
+    synth.push({
+      chargeCode: "mrc",
+      chargeName: "Monthly Recurring",
+      chargeType: "mrc",
+      pricingMethod: "flat",
+      unitPrice: perInstance,
+      quantity: 1,
+      totalPrice: perInstance,
+      currencyCode
+    });
+  }
+  if (nrc > 0) {
+    const perInstance = nrc / sourceQty;
+    synth.push({
+      chargeCode: "nrc",
+      chargeName: "Non-Recurring",
+      chargeType: "nrc",
+      pricingMethod: "flat",
+      unitPrice: perInstance,
+      quantity: 1,
+      totalPrice: perInstance,
+      currencyCode
+    });
+  }
+  return synth.length > 0 ? synth : null;
+}
+export {
+  DefaultCpqQuotingService,
+  QuotingError
+};
+//# sourceMappingURL=cpqQuotingService.js.map