@dainamite/cpq 0.2.2 → 0.3.0

package/dist/modules/cpq/services/types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/cpq/services/types.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\n\n// \u2500\u2500\u2500 Shared types for CPQ Quoting v2 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface TenantScope {\n  organizationId: string\n  tenantId: string\n}\n\nconst DEFAULT_CURRENCY = 'USD'\n\n/**\n * Returns the base currency code for a given tenant scope.\n * Falls back to 'USD' if no base currency is found.\n */\nexport async function getBaseCurrencyCode(\n  em: EntityManager,\n  scope: TenantScope,\n): Promise<string> {\n  try {\n    const { Currency } = await import(\n      '@open-mercato/core/modules/currencies/data/entities'\n    )\n    const base = await em.findOne(Currency, {\n      tenantId: scope.tenantId,\n      organizationId: scope.organizationId,\n      isBase: true,\n      deletedAt: null,\n    })\n    return base?.code ?? DEFAULT_CURRENCY\n  } catch {\n    return DEFAULT_CURRENCY\n  }\n}\n\n// \u2500\u2500\u2500 Quote lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_STATUSES = [\n  'new',\n  'incomplete',\n  'ready',\n  'in_approval',\n  'pre_approved',\n  'approved',\n  'with_customer',\n  'accepted',\n  'rejected',\n  'cancelled',\n] as const\n\nexport type CpqStatus = (typeof CPQ_STATUSES)[number]\n\nexport const TERMINAL_STATUSES: CpqStatus[] = ['accepted', 'rejected', 'cancelled']\n\n// Per product decision: the CPQ status path is operator-driven and can\n// jump between any pair of statuses. Self-transitions are excluded\n// because they're no-ops. ARC-specific guards (`validateArcQuote`,\n// concurrent-ARC checks) still run inside `transitionStatus` and are\n// the real safety net \u2014 this table only enforces the \"no self loop\"\n// invariant.\nexport const ALLOWED_TRANSITIONS: Record<CpqStatus, CpqStatus[]> = Object.fromEntries(\n  CPQ_STATUSES.map((from) => [from, CPQ_STATUSES.filter((to) => to !== from)]),\n) as Record<CpqStatus, CpqStatus[]>\n\n// \u2500\u2500\u2500 Service input/output types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface CreateQuoteInput {\n  customerId: string\n  quoteId?: string                      // Link to existing SalesQuote instead of creating a new one\n  dealId?: string\n  currencyCode?: string\n  quoteContext?: Record<string, string | number | boolean>\n}\n\nexport interface QuoteItemInput {\n  offeringId?: string\n  productId?: string\n  configuration: Record<string, unknown>\n  quantity?: number\n  usageEstimates?: Array<{ chargeCode: string; estimatedQuantity: number }>\n  action?: 'add' | 'modify' | 'cancel'\n  parentLineId?: string\n  startDate?: string\n  termMonths?: number\n  endDate?: string\n  /** XD-250 ARC: target subscription this line acts on. Auto-inherited from\n   * the quote's single attached target when omitted. Required when the ARC\n   * quote has multiple non-merge targets (operator must pick). */\n  targetSubscriptionId?: string | null\n}\n\nexport interface ValidationError {\n  type?: 'attribute' | 'relationship'\n  attribute?: string\n  relationshipType?: string\n  sourceSpec?: string\n  targetSpec?: string\n  message: string\n}\n\n/** XD-250 ARC: snapshot of the source subscription item's *current* state.\n * Surfaced on quote / order lines so the operator can compare \"before\" (this\n * snapshot) vs \"after\" (the line's current configuration). Null for lines\n * that aren't ARC-mirrored (e.g. a fresh `add` line on an amend quote). */\nexport interface ArcLineSource {\n  subscriptionItemId: string\n  name: string\n  mrcAmount: number\n  nrcAmount: number\n  quantity: number\n}\n\nexport interface QuoteLineResult {\n  lineId: string\n  offeringId: string | null\n  offeringName: string\n  offeringType: string | null\n  productId: string | null\n  action: string\n  parentLineId: string | null\n  quantity: number\n  configuration: Record<string, unknown>\n  startDate: string | null\n  termMonths: number | null\n  endDate: string | null\n  nrcTotal: number\n  mrcTotal: number\n  usageEstimates: Array<{ chargeCode: string; estimatedQuantity: number; estimatedTotal: number }> | null\n  usageTotalEstimated: number | null\n  charges: ResolvedCharge[]\n  isConfigured: boolean\n  validationErrors: ValidationError[] | null\n  arcSource: ArcLineSource | null\n  /** XD-250 multi-target ARC: which target subscription this line acts on. */\n  targetSubscriptionId: string | null\n}\n\nexport interface PricingSummary {\n  nrcTotal: number\n  mrcTotal: number\n  usageCharges: Array<{\n    chargeCode: string\n    chargeName: string\n    unitPrice: number\n    note: string | null\n  }>\n  usageTotalEstimated: number | null\n  discountTotal: number\n  surchargeTotal: number\n  currencyCode: string\n}\n\nexport interface QuoteResult {\n  id: string\n  quoteId: string\n  quoteNumber: string\n  customerId: string\n  /** Resolved customer display name (CustomerEntity.displayName). */\n  customerName: string | null\n  cpqStatus: string\n  version: number\n  parentQuoteId: string | null\n  currencyCode: string\n  /**\n   * Set when this quote has been converted to a CPQ order. UI uses this\n   * to lock editing and surface a \"Go to order\" entry point instead of\n   * the Convert button. Backed by `CpqOrderConfiguration.sourceQuoteId`.\n   */\n  convertedOrderId: string | null\n  validationResult: {\n    valid: boolean\n    errors: ValidationError[]\n  }\n  pricingSummary: PricingSummary\n  lines: QuoteLineResult[]\n}\n\n// \u2500\u2500\u2500 Resolved charge (extended for v2) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface RuleAdjustment {\n  ruleCode: string\n  ruleName: string\n  ruleType: string\n  value: number\n  unitPriceBefore: number\n  unitPriceAfter: number\n  delta: number\n}\n\nexport interface TierBreakdown {\n  tiers: Array<{\n    tier: number\n    from: number\n    to: number\n    pricePerUnit: number\n    quantity: number\n    subtotal: number\n  }>\n}\n\nexport interface ResolvedCharge {\n  chargeCode: string\n  chargeName: string\n  chargeType: 'nrc' | 'mrc' | 'usage'\n  pricingMethod: 'flat' | 'tiered' | 'per_unit'\n  unitPrice: number\n  quantity: number | null\n  totalPrice: number | null\n  currencyCode: string\n  breakdown?: TierBreakdown | null\n  note?: string | null\n  adjustments?: RuleAdjustment[] | null\n}\n\n// \u2500\u2500\u2500 Inventory status constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const INVENTORY_SUBSCRIPTION_STATUSES = [\n  'pending',\n  'active',\n  'suspended',\n  'terminated',\n  'expired',\n  'superseded',\n] as const\nexport type InventorySubscriptionStatus = (typeof INVENTORY_SUBSCRIPTION_STATUSES)[number]\n\nexport const INVENTORY_SUBSCRIPTION_TRANSITIONS: Record<InventorySubscriptionStatus, InventorySubscriptionStatus[]> = {\n  pending: ['active', 'terminated'],\n  active: ['suspended', 'terminated', 'expired', 'superseded'],\n  suspended: ['active', 'terminated', 'superseded'],\n  terminated: [],\n  expired: [],\n  superseded: [],\n}\n\nexport const INVENTORY_SUBSCRIPTION_ITEM_STATUSES = [\n  'pending',\n  'active',\n  'suspended',\n  'terminated',\n  'expired',\n  'superseded',\n] as const\nexport type InventorySubscriptionItemStatus = (typeof INVENTORY_SUBSCRIPTION_ITEM_STATUSES)[number]\n\nexport const INVENTORY_ASSET_STATUSES = ['pending', 'delivered', 'active', 'returned', 'cancelled'] as const\nexport type InventoryAssetStatus = (typeof INVENTORY_ASSET_STATUSES)[number]\n\nexport const INVENTORY_ASSET_TRANSITIONS: Record<InventoryAssetStatus, InventoryAssetStatus[]> = {\n  pending: ['delivered', 'active', 'cancelled'],\n  delivered: ['active', 'returned'],\n  active: ['returned'],\n  returned: [],\n  cancelled: [],\n}\n\n// \u2500\u2500\u2500 Order status constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_ORDER_STATUSES = ['draft', 'pending_activation', 'active', 'cancelled', 'fulfilled'] as const\nexport type CpqOrderStatus = (typeof CPQ_ORDER_STATUSES)[number]\n\nexport const CPQ_ORDER_TRANSITIONS: Record<CpqOrderStatus, CpqOrderStatus[]> = {\n  draft: ['pending_activation', 'active', 'cancelled'],\n  pending_activation: ['active', 'cancelled'],\n  active: ['fulfilled', 'cancelled'],\n  cancelled: [],\n  fulfilled: [],\n}\n\n// \u2500\u2500\u2500 ARC (Amend / Renew / Cancel) constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_QUOTE_TYPES = ['new', 'amend', 'renew', 'cancel'] as const\nexport type CpqQuoteType = (typeof CPQ_QUOTE_TYPES)[number]\n\nexport const ARC_QUOTE_TYPES: ReadonlyArray<Exclude<CpqQuoteType, 'new'>> = ['amend', 'renew', 'cancel']\n\nexport const CHANGE_LOG_TYPES = [\n  'created',\n  'amend',\n  'renew',\n  'cancel',\n  'merge-result',\n  'merge-source',\n] as const\nexport type ChangeLogType = (typeof CHANGE_LOG_TYPES)[number]\n\nexport const MERGE_ACTIONS = ['standalone', 'absorb'] as const\nexport type MergeAction = (typeof MERGE_ACTIONS)[number]\n\nexport const ARC_REASON_CODES = [\n  'upgrade',\n  'downgrade',\n  'config-change',\n  'price-adjustment',\n  'term-extension',\n  'term-reduction',\n  'consolidation',\n  'customer-request',\n  'non-payment',\n  'contract-breach',\n  'other',\n] as const\nexport type ArcReasonCode = (typeof ARC_REASON_CODES)[number]\n"],
-  "mappings": "AASA,MAAM,mBAAmB;AAMzB,eAAsB,oBACpB,IACA,OACiB;AACjB,MAAI;AACF,UAAM,EAAE,SAAS,IAAI,MAAM,OACzB,qDACF;AACA,UAAM,OAAO,MAAM,GAAG,QAAQ,UAAU;AAAA,MACtC,UAAU,MAAM;AAAA,MAChB,gBAAgB,MAAM;AAAA,MACtB,QAAQ;AAAA,MACR,WAAW;AAAA,IACb,CAAC;AACD,WAAO,MAAM,QAAQ;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAIO,MAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,oBAAiC,CAAC,YAAY,YAAY,WAAW;AAQ3E,MAAM,sBAAsD,OAAO;AAAA,EACxE,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,OAAO,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;AAC7E;AA0JO,MAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,qCAAyG;AAAA,EACpH,SAAS,CAAC,UAAU,YAAY;AAAA,EAChC,QAAQ,CAAC,aAAa,cAAc,WAAW,YAAY;AAAA,EAC3D,WAAW,CAAC,UAAU,cAAc,YAAY;AAAA,EAChD,YAAY,CAAC;AAAA,EACb,SAAS,CAAC;AAAA,EACV,YAAY,CAAC;AACf;AAEO,MAAM,uCAAuC;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,2BAA2B,CAAC,WAAW,aAAa,UAAU,YAAY,WAAW;AAG3F,MAAM,8BAAoF;AAAA,EAC/F,SAAS,CAAC,aAAa,UAAU,WAAW;AAAA,EAC5C,WAAW,CAAC,UAAU,UAAU;AAAA,EAChC,QAAQ,CAAC,UAAU;AAAA,EACnB,UAAU,CAAC;AAAA,EACX,WAAW,CAAC;AACd;AAIO,MAAM,qBAAqB,CAAC,SAAS,sBAAsB,UAAU,aAAa,WAAW;AAG7F,MAAM,wBAAkE;AAAA,EAC7E,OAAO,CAAC,sBAAsB,UAAU,WAAW;AAAA,EACnD,oBAAoB,CAAC,UAAU,WAAW;AAAA,EAC1C,QAAQ,CAAC,aAAa,WAAW;AAAA,EACjC,WAAW,CAAC;AAAA,EACZ,WAAW,CAAC;AACd;AAIO,MAAM,kBAAkB,CAAC,OAAO,SAAS,SAAS,QAAQ;AAG1D,MAAM,kBAA+D,CAAC,SAAS,SAAS,QAAQ;AAEhG,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,gBAAgB,CAAC,cAAc,QAAQ;AAG7C,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\n// Charge model / pricing source live in the data layer (no ORM/DI coupling).\nimport type { ChargeModel } from '../data/charge-pricing'\n\n// \u2500\u2500\u2500 Shared types for CPQ Quoting v2 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface TenantScope {\n  organizationId: string\n  tenantId: string\n}\n\nconst DEFAULT_CURRENCY = 'USD'\n\n/**\n * Returns the base currency code for a given tenant scope.\n * Falls back to 'USD' if no base currency is found.\n */\nexport async function getBaseCurrencyCode(\n  em: EntityManager,\n  scope: TenantScope,\n): Promise<string> {\n  try {\n    const { Currency } = await import(\n      '@open-mercato/core/modules/currencies/data/entities'\n    )\n    const base = await em.findOne(Currency, {\n      tenantId: scope.tenantId,\n      organizationId: scope.organizationId,\n      isBase: true,\n      deletedAt: null,\n    })\n    return base?.code ?? DEFAULT_CURRENCY\n  } catch {\n    return DEFAULT_CURRENCY\n  }\n}\n\n// \u2500\u2500\u2500 Quote lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_STATUSES = [\n  'new',\n  'incomplete',\n  'ready',\n  'in_approval',\n  'pre_approved',\n  'approved',\n  'with_customer',\n  'accepted',\n  'rejected',\n  'cancelled',\n] as const\n\nexport type CpqStatus = (typeof CPQ_STATUSES)[number]\n\nexport const TERMINAL_STATUSES: CpqStatus[] = ['accepted', 'rejected', 'cancelled']\n\n// Per product decision: the CPQ status path is operator-driven and can\n// jump between any pair of statuses. Self-transitions are excluded\n// because they're no-ops. ARC-specific guards (`validateArcQuote`,\n// concurrent-ARC checks) still run inside `transitionStatus` and are\n// the real safety net \u2014 this table only enforces the \"no self loop\"\n// invariant.\nexport const ALLOWED_TRANSITIONS: Record<CpqStatus, CpqStatus[]> = Object.fromEntries(\n  CPQ_STATUSES.map((from) => [from, CPQ_STATUSES.filter((to) => to !== from)]),\n) as Record<CpqStatus, CpqStatus[]>\n\n// \u2500\u2500\u2500 Service input/output types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface CreateQuoteInput {\n  customerId: string\n  quoteId?: string                      // Link to existing SalesQuote instead of creating a new one\n  dealId?: string\n  currencyCode?: string\n  quoteContext?: Record<string, string | number | boolean>\n}\n\nexport interface QuoteItemInput {\n  offeringId?: string\n  productId?: string\n  configuration: Record<string, unknown>\n  quantity?: number\n  usageEstimates?: Array<{ chargeCode: string; estimatedQuantity: number }>\n  action?: 'add' | 'modify' | 'cancel'\n  parentLineId?: string\n  startDate?: string\n  termMonths?: number\n  endDate?: string\n  /** XD-250 ARC: target subscription this line acts on. Auto-inherited from\n   * the quote's single attached target when omitted. Required when the ARC\n   * quote has multiple non-merge targets (operator must pick). */\n  targetSubscriptionId?: string | null\n}\n\nexport interface ValidationError {\n  type?: 'attribute' | 'relationship'\n  attribute?: string\n  relationshipType?: string\n  sourceSpec?: string\n  targetSpec?: string\n  message: string\n}\n\n/** XD-250 ARC: snapshot of the source subscription item's *current* state.\n * Surfaced on quote / order lines so the operator can compare \"before\" (this\n * snapshot) vs \"after\" (the line's current configuration). Null for lines\n * that aren't ARC-mirrored (e.g. a fresh `add` line on an amend quote). */\nexport interface ArcLineSource {\n  subscriptionItemId: string\n  name: string\n  mrcAmount: number\n  nrcAmount: number\n  quantity: number\n}\n\nexport interface QuoteLineResult {\n  lineId: string\n  offeringId: string | null\n  offeringName: string\n  offeringType: string | null\n  productId: string | null\n  action: string\n  parentLineId: string | null\n  quantity: number\n  configuration: Record<string, unknown>\n  startDate: string | null\n  termMonths: number | null\n  endDate: string | null\n  nrcTotal: number\n  mrcTotal: number\n  usageEstimates: Array<{ chargeCode: string; estimatedQuantity: number; estimatedTotal: number }> | null\n  usageTotalEstimated: number | null\n  charges: ResolvedCharge[]\n  isConfigured: boolean\n  validationErrors: ValidationError[] | null\n  arcSource: ArcLineSource | null\n  /** XD-250 multi-target ARC: which target subscription this line acts on. */\n  targetSubscriptionId: string | null\n}\n\nexport interface PricingSummary {\n  nrcTotal: number\n  mrcTotal: number\n  usageCharges: Array<{\n    chargeCode: string\n    chargeName: string\n    unitPrice: number\n    note: string | null\n  }>\n  usageTotalEstimated: number | null\n  discountTotal: number\n  surchargeTotal: number\n  currencyCode: string\n}\n\nexport interface QuoteResult {\n  id: string\n  quoteId: string\n  quoteNumber: string\n  customerId: string\n  /** Resolved customer display name (CustomerEntity.displayName). */\n  customerName: string | null\n  cpqStatus: string\n  version: number\n  parentQuoteId: string | null\n  currencyCode: string\n  /**\n   * Set when this quote has been converted to a CPQ order. UI uses this\n   * to lock editing and surface a \"Go to order\" entry point instead of\n   * the Convert button. Backed by `CpqOrderConfiguration.sourceQuoteId`.\n   */\n  convertedOrderId: string | null\n  validationResult: {\n    valid: boolean\n    errors: ValidationError[]\n  }\n  pricingSummary: PricingSummary\n  lines: QuoteLineResult[]\n}\n\n// \u2500\u2500\u2500 Resolved charge (extended for v2) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface RuleAdjustment {\n  ruleCode: string\n  ruleName: string\n  ruleType: string\n  value: number\n  unitPriceBefore: number\n  unitPriceAfter: number\n  delta: number\n}\n\nexport interface TierBreakdown {\n  tiers: Array<{\n    tier: number\n    from: number\n    to: number\n    pricePerUnit: number\n    quantity: number\n    subtotal: number\n  }>\n}\n\nexport interface ResolvedCharge {\n  chargeCode: string\n  chargeName: string\n  chargeType: 'nrc' | 'mrc' | 'usage'\n  // Display axis \u2014 the charge model (flat | per_unit | volume | tiered).\n  pricingMethod: ChargeModel\n  unitPrice: number\n  quantity: number | null\n  totalPrice: number | null\n  currencyCode: string\n  breakdown?: TierBreakdown | null\n  note?: string | null\n  adjustments?: RuleAdjustment[] | null\n}\n\n// \u2500\u2500\u2500 Inventory status constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const INVENTORY_SUBSCRIPTION_STATUSES = [\n  'pending',\n  'active',\n  'suspended',\n  'terminated',\n  'expired',\n  'superseded',\n] as const\nexport type InventorySubscriptionStatus = (typeof INVENTORY_SUBSCRIPTION_STATUSES)[number]\n\nexport const INVENTORY_SUBSCRIPTION_TRANSITIONS: Record<InventorySubscriptionStatus, InventorySubscriptionStatus[]> = {\n  pending: ['active', 'terminated'],\n  active: ['suspended', 'terminated', 'expired', 'superseded'],\n  suspended: ['active', 'terminated', 'superseded'],\n  terminated: [],\n  expired: [],\n  superseded: [],\n}\n\nexport const INVENTORY_SUBSCRIPTION_ITEM_STATUSES = [\n  'pending',\n  'active',\n  'suspended',\n  'terminated',\n  'expired',\n  'superseded',\n] as const\nexport type InventorySubscriptionItemStatus = (typeof INVENTORY_SUBSCRIPTION_ITEM_STATUSES)[number]\n\nexport const INVENTORY_ASSET_STATUSES = ['pending', 'delivered', 'active', 'returned', 'cancelled'] as const\nexport type InventoryAssetStatus = (typeof INVENTORY_ASSET_STATUSES)[number]\n\nexport const INVENTORY_ASSET_TRANSITIONS: Record<InventoryAssetStatus, InventoryAssetStatus[]> = {\n  pending: ['delivered', 'active', 'cancelled'],\n  delivered: ['active', 'returned'],\n  active: ['returned'],\n  returned: [],\n  cancelled: [],\n}\n\n// \u2500\u2500\u2500 Order status constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_ORDER_STATUSES = ['draft', 'pending_activation', 'active', 'cancelled', 'fulfilled'] as const\nexport type CpqOrderStatus = (typeof CPQ_ORDER_STATUSES)[number]\n\nexport const CPQ_ORDER_TRANSITIONS: Record<CpqOrderStatus, CpqOrderStatus[]> = {\n  draft: ['pending_activation', 'active', 'cancelled'],\n  pending_activation: ['active', 'cancelled'],\n  active: ['fulfilled', 'cancelled'],\n  cancelled: [],\n  fulfilled: [],\n}\n\n// \u2500\u2500\u2500 ARC (Amend / Renew / Cancel) constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const CPQ_QUOTE_TYPES = ['new', 'amend', 'renew', 'cancel'] as const\nexport type CpqQuoteType = (typeof CPQ_QUOTE_TYPES)[number]\n\nexport const ARC_QUOTE_TYPES: ReadonlyArray<Exclude<CpqQuoteType, 'new'>> = ['amend', 'renew', 'cancel']\n\nexport const CHANGE_LOG_TYPES = [\n  'created',\n  'amend',\n  'renew',\n  'cancel',\n  'merge-result',\n  'merge-source',\n] as const\nexport type ChangeLogType = (typeof CHANGE_LOG_TYPES)[number]\n\nexport const MERGE_ACTIONS = ['standalone', 'absorb'] as const\nexport type MergeAction = (typeof MERGE_ACTIONS)[number]\n\nexport const ARC_REASON_CODES = [\n  'upgrade',\n  'downgrade',\n  'config-change',\n  'price-adjustment',\n  'term-extension',\n  'term-reduction',\n  'consolidation',\n  'customer-request',\n  'non-payment',\n  'contract-breach',\n  'other',\n] as const\nexport type ArcReasonCode = (typeof ARC_REASON_CODES)[number]\n"],
+  "mappings": "AAWA,MAAM,mBAAmB;AAMzB,eAAsB,oBACpB,IACA,OACiB;AACjB,MAAI;AACF,UAAM,EAAE,SAAS,IAAI,MAAM,OACzB,qDACF;AACA,UAAM,OAAO,MAAM,GAAG,QAAQ,UAAU;AAAA,MACtC,UAAU,MAAM;AAAA,MAChB,gBAAgB,MAAM;AAAA,MACtB,QAAQ;AAAA,MACR,WAAW;AAAA,IACb,CAAC;AACD,WAAO,MAAM,QAAQ;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAIO,MAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,oBAAiC,CAAC,YAAY,YAAY,WAAW;AAQ3E,MAAM,sBAAsD,OAAO;AAAA,EACxE,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,OAAO,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;AAC7E;AA2JO,MAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,qCAAyG;AAAA,EACpH,SAAS,CAAC,UAAU,YAAY;AAAA,EAChC,QAAQ,CAAC,aAAa,cAAc,WAAW,YAAY;AAAA,EAC3D,WAAW,CAAC,UAAU,cAAc,YAAY;AAAA,EAChD,YAAY,CAAC;AAAA,EACb,SAAS,CAAC;AAAA,EACV,YAAY,CAAC;AACf;AAEO,MAAM,uCAAuC;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,2BAA2B,CAAC,WAAW,aAAa,UAAU,YAAY,WAAW;AAG3F,MAAM,8BAAoF;AAAA,EAC/F,SAAS,CAAC,aAAa,UAAU,WAAW;AAAA,EAC5C,WAAW,CAAC,UAAU,UAAU;AAAA,EAChC,QAAQ,CAAC,UAAU;AAAA,EACnB,UAAU,CAAC;AAAA,EACX,WAAW,CAAC;AACd;AAIO,MAAM,qBAAqB,CAAC,SAAS,sBAAsB,UAAU,aAAa,WAAW;AAG7F,MAAM,wBAAkE;AAAA,EAC7E,OAAO,CAAC,sBAAsB,UAAU,WAAW;AAAA,EACnD,oBAAoB,CAAC,UAAU,WAAW;AAAA,EAC1C,QAAQ,CAAC,aAAa,WAAW;AAAA,EACjC,WAAW,CAAC;AAAA,EACZ,WAAW,CAAC;AACd;AAIO,MAAM,kBAAkB,CAAC,OAAO,SAAS,SAAS,QAAQ;AAG1D,MAAM,kBAA+D,CAAC,SAAS,SAAS,QAAQ;AAEhG,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,gBAAgB,CAAC,cAAc,QAAQ;AAG7C,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dainamite/cpq",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Dainamite CPQ — Configure, Price, Quote engine for Open Mercato (configurable products, multi-charge pricing tables, guided quoting, customer inventory, orders).",
   "type": "module",
   "main": "./dist/modules/cpq/index.js",
@@ -16,6 +16,9 @@
     "watch": "node watch.mjs",
     "typecheck": "tsc --noEmit"
   },
+  "dependencies": {
+    "xlsx": "^0.18.0"
+  },
   "devDependencies": {
     "chokidar": "^4.0.3"
   },
@@ -132,7 +135,6 @@
     "next": "^16.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "xlsx": "^0.18.0",
     "zod": "^4.0.0"
   },
   "publishConfig": {

package/src/modules/cpq/__integration__/TC-CPQ-012.spec.ts

@@ -1,4 +1,4 @@
-import { test, expect } from '@playwright/test'
+import { test, expect, type Locator } from '@playwright/test'
 import { login } from '@open-mercato/core/helpers/integration/auth'
 
 /**
@@ -24,7 +24,31 @@ import { login } from '@open-mercato/core/helpers/integration/auth'
 // is unambiguous *and* doesn't depend on accessibility-name timing.
 const pickerLocator = '[role="combobox"]'
 
+/**
+ * Open the Radix Select and wait until its options have mounted.
+ *
+ * The single `trigger.click()` was the flake source in CI: Radix can
+ * swallow the first click (the trigger isn't interactive yet on a slow
+ * cold render) or open-then-close the menu under load, so the option list
+ * never mounts and the following `toBeVisible` times out. Retrying the open
+ * until a known option is visible makes the step deterministic.
+ */
+async function openExpiringPicker(trigger: Locator, probe: Locator): Promise<void> {
+  // The inner timeout (4s) is comfortably longer than a normal option mount,
+  // so a menu that's merely slow to paint isn't mistaken for "didn't open"
+  // and re-clicked shut — the only re-click happens when the prior click was
+  // swallowed and the menu is actually closed. The 12s budget stays well
+  // under the 20s global test timeout so a genuine failure surfaces here
+  // (with a useful message) rather than as an opaque test timeout. No
+  // per-test timeout override (integration-tests SKILL.md).
+  await expect(async () => {
+    await trigger.click()
+    await expect(probe).toBeVisible({ timeout: 4_000 })
+  }).toPass({ timeout: 12_000 })
+}
+
 test.describe('TC-CPQ-012: Inline expiring picker (UI)', () => {
+
   test('picker renders in title row with the 5 preset windows', async ({ page }) => {
     await login(page, 'admin')
     await page.goto('/backend/cpq/inventory', { waitUntil: 'domcontentloaded' })
@@ -37,7 +61,7 @@ test.describe('TC-CPQ-012: Inline expiring picker (UI)', () => {
 
     // Open the dropdown and verify the 5 canonical preset windows are
     // listed in the same order the operator's renewal-watch UX expects.
-    await picker.click()
+    await openExpiringPicker(picker, page.getByRole('option', { name: /Expiring in 30 days/i }))
     for (const days of [7, 14, 30, 60, 90]) {
       await expect(
         page.getByRole('option', { name: new RegExp(`Expiring in ${days} days`, 'i') }),
@@ -51,8 +75,14 @@ test.describe('TC-CPQ-012: Inline expiring picker (UI)', () => {
 
     const trigger = page.locator(pickerLocator).first()
     await expect(trigger).toBeVisible({ timeout: 15_000 })
-    await trigger.click()
-    await page.getByRole('option', { name: /Expiring in 30 days/i }).click()
+
+    // Open the menu deterministically (retries the click until the option
+    // mounts — see `openExpiringPicker`), then force the click to bypass
+    // Radix's portal positioning layer that the default actionability check
+    // treats as obscuring the option; Radix's own onSelect still fires.
+    const option = page.getByRole('option', { name: /Expiring in 30 days/i })
+    await openExpiringPicker(trigger, option)
+    await option.click({ force: true })
 
     // Same URL — the picker writes into the in-page filter state, not a
     // route param. Picker now reflects the chosen window.

package/src/modules/cpq/__tests__/package-isolation.test.ts

@@ -21,9 +21,14 @@ import { metadata } from '../index'
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..')
 
-// Must mirror peerDependencies in packages/cpq/package.json (plus relatives + node builtins).
-// Adding a prefix here without adding it to peerDependencies = silent runtime failure for
-// consumers that don't happen to have the dep transitively.
+// Must mirror peerDependencies + dependencies in packages/cpq/package.json
+// (plus relative paths + node builtins). Adding a prefix here without adding
+// it to one of those two = silent runtime failure for consumers that don't
+// happen to have the dep transitively. Sibling framework packages
+// (@open-mercato/*, react, mikro-orm, etc.) MUST stay as peerDependencies so
+// yarn keeps a single shared instance; CPQ-internal leaf libs (xlsx) live in
+// dependencies so a fresh `yarn add @dainamite/cpq` scaffold pulls them in
+// without manual setup (XD-289).
 const ALLOWED_IMPORT_PREFIXES = [
   './',
   '../',

package/src/modules/cpq/api/product-attributes/__tests__/serializeAttribute.test.ts

@@ -0,0 +1,62 @@
+import { serializeAttribute } from '../route'
+import type { CpqProductAttribute } from '../../../data/entities'
+
+/**
+ * XD-292 regression: the create (POST) and update (PUT) responses used to omit
+ * `resolutionTime` (and several other fields), so a freshly created design-time
+ * attribute rendered as "run" in the spec detail table until a page refresh.
+ * serializeAttribute is now the single source of truth for the API shape, so
+ * these assertions guard every method that returns it.
+ */
+function makeAttribute(overrides: Partial<CpqProductAttribute> = {}): CpqProductAttribute {
+  const now = new Date('2026-06-01T00:00:00.000Z')
+  return {
+    id: 'attr-1',
+    productId: 'prod-1',
+    specId: 'spec-1',
+    code: 'platform-subscription-tier',
+    name: 'Platform Subscription Tier',
+    attributeType: 'select',
+    resolutionTime: 'design_time',
+    options: [{ value: 'a' }],
+    constraints: null,
+    referenceEntity: null,
+    referenceFilter: null,
+    dependsOn: { attributeCode: 'foo' },
+    defaultValue: 'a',
+    helpText: 'pick a tier',
+    sortOrder: 0,
+    isRequired: true,
+    isActive: true,
+    createdAt: now,
+    updatedAt: now,
+    ...overrides,
+  } as CpqProductAttribute
+}
+
+describe('serializeAttribute', () => {
+  it('includes resolutionTime so design-time attributes do not render as "run"', () => {
+    const out = serializeAttribute(makeAttribute({ resolutionTime: 'design_time' }))
+    expect(out.resolutionTime).toBe('design_time')
+  })
+
+  it('preserves run_time resolution', () => {
+    const out = serializeAttribute(makeAttribute({ resolutionTime: 'run_time' }))
+    expect(out.resolutionTime).toBe('run_time')
+  })
+
+  it('exposes every field the spec detail UI reads', () => {
+    const out = serializeAttribute(makeAttribute())
+    // The fields that were previously missing from POST/PUT responses.
+    expect(out).toMatchObject({
+      id: 'attr-1',
+      specId: 'spec-1',
+      resolutionTime: 'design_time',
+      referenceEntity: null,
+      referenceFilter: null,
+      dependsOn: { attributeCode: 'foo' },
+      defaultValue: 'a',
+      helpText: 'pick a tier',
+    })
+  })
+})

package/src/modules/cpq/api/product-attributes/route.ts

@@ -11,6 +11,37 @@ export const metadata = {
   DELETE: { requireAuth: true, requireFeatures: ['cpq.products.manage'] },
 }
 
+/**
+ * Single source of truth for the attribute API shape. GET, POST and PUT MUST
+ * all return this exact projection so the client never sees a partial record.
+ * Omitting fields here (notably `resolutionTime`) caused XD-292: a freshly
+ * created design-time attribute rendered as "run" until a page refresh, since
+ * the create response lacked the field the table reads.
+ */
+export function serializeAttribute(item: CpqProductAttribute) {
+  return {
+    id: item.id,
+    productId: item.productId,
+    specId: item.specId,
+    code: item.code,
+    name: item.name,
+    attributeType: item.attributeType,
+    resolutionTime: item.resolutionTime,
+    options: item.options,
+    constraints: item.constraints,
+    referenceEntity: item.referenceEntity,
+    referenceFilter: item.referenceFilter,
+    dependsOn: item.dependsOn,
+    defaultValue: item.defaultValue,
+    helpText: item.helpText,
+    sortOrder: item.sortOrder,
+    isRequired: item.isRequired,
+    isActive: item.isActive,
+    createdAt: item.createdAt,
+    updatedAt: item.updatedAt,
+  }
+}
+
 export async function GET(req: Request) {
   try {
     const ctx = await resolveCpqRouteContext(req)
@@ -35,27 +66,7 @@ export async function GET(req: Request) {
     })
 
     return NextResponse.json({
-      items: items.map((item) => ({
-        id: item.id,
-        productId: item.productId,
-        specId: item.specId,
-        code: item.code,
-        name: item.name,
-        attributeType: item.attributeType,
-        resolutionTime: item.resolutionTime,
-        options: item.options,
-        constraints: item.constraints,
-        referenceEntity: item.referenceEntity,
-        referenceFilter: item.referenceFilter,
-        dependsOn: item.dependsOn,
-        defaultValue: item.defaultValue,
-        helpText: item.helpText,
-        sortOrder: item.sortOrder,
-        isRequired: item.isRequired,
-        isActive: item.isActive,
-        createdAt: item.createdAt,
-        updatedAt: item.updatedAt,
-      })),
+      items: items.map(serializeAttribute),
       total,
       page,
       pageSize,
@@ -88,23 +99,7 @@ export async function POST(req: Request) {
     const entity = ctx.em.create(CpqProductAttribute, { ...body, productId, ...scope })
     await ctx.em.flush()
 
-    return NextResponse.json(
-      {
-        id: entity.id,
-        productId: entity.productId,
-        code: entity.code,
-        name: entity.name,
-        attributeType: entity.attributeType,
-        options: entity.options,
-        constraints: entity.constraints,
-        sortOrder: entity.sortOrder,
-        isRequired: entity.isRequired,
-        isActive: entity.isActive,
-        createdAt: entity.createdAt,
-        updatedAt: entity.updatedAt,
-      },
-      { status: 201 },
-    )
+    return NextResponse.json(serializeAttribute(entity), { status: 201 })
   } catch (err) {
     if (err instanceof z.ZodError) {
       return NextResponse.json({ error: 'Validation error', details: err.issues }, { status: 400 })
@@ -129,20 +124,7 @@ export async function PUT(req: Request) {
     ctx.em.assign(entity, updates)
     await ctx.em.flush()
 
-    return NextResponse.json({
-      id: entity.id,
-      productId: entity.productId,
-      code: entity.code,
-      name: entity.name,
-      attributeType: entity.attributeType,
-      options: entity.options,
-      constraints: entity.constraints,
-      sortOrder: entity.sortOrder,
-      isRequired: entity.isRequired,
-      isActive: entity.isActive,
-      createdAt: entity.createdAt,
-      updatedAt: entity.updatedAt,
-    })
+    return NextResponse.json(serializeAttribute(entity))
   } catch (err) {
     if (err instanceof z.ZodError) {
       return NextResponse.json({ error: 'Validation error', details: err.issues }, { status: 400 })

package/src/modules/cpq/api/product-charges/route.ts

@@ -3,6 +3,7 @@ import { z } from 'zod'
 import { resolveCpqRouteContext } from '../context'
 import { CpqProductCharge, CpqProductOffering, CpqProductSpecification } from '../../data/entities'
 import { cpqProductChargeCreateSchema, cpqProductChargeUpdateSchema } from '../../data/validators'
+import { normalizeChargePricing } from '../../data/charge-pricing'
 
 export const metadata = {
   GET: { requireAuth: true, requireFeatures: ['cpq.products.view'] },
@@ -43,6 +44,7 @@ export async function GET(req: Request) {
         name: item.name,
         description: item.description,
         chargeType: item.chargeType,
+        chargeModel: item.chargeModel,
         pricingMethod: item.pricingMethod,
         pricingTableId: item.pricingTableId,
         priceColumnKey: item.priceColumnKey,
@@ -87,7 +89,10 @@ export async function POST(req: Request) {
       return NextResponse.json({ error: 'productId or offeringId with valid offering required' }, { status: 400 })
     }
 
-    const entity = ctx.em.create(CpqProductCharge, { ...body, productId, ...scope })
+    // Persist the canonical split shape regardless of whether the client sent
+    // the new fields or a legacy combined pricingMethod.
+    const { model, source } = normalizeChargePricing(body)
+    const entity = ctx.em.create(CpqProductCharge, { ...body, chargeModel: model, pricingMethod: source, productId, ...scope })
     await ctx.em.flush()
 
     return NextResponse.json(
@@ -97,6 +102,7 @@ export async function POST(req: Request) {
         code: entity.code,
         name: entity.name,
         chargeType: entity.chargeType,
+        chargeModel: entity.chargeModel,
         pricingMethod: entity.pricingMethod,
         pricingTableId: entity.pricingTableId,
         priceColumnKey: entity.priceColumnKey,
@@ -130,7 +136,21 @@ export async function PUT(req: Request) {
     const entity = await ctx.em.findOne(CpqProductCharge, { id, ...scope })
     if (!entity) return NextResponse.json({ error: 'Not found' }, { status: 404 })
 
-    ctx.em.assign(entity, updates)
+    // Re-derive the canonical split shape when pricing fields are being changed,
+    // and clear the opposite axis' fields so a partial PATCH can't leave a
+    // stale pricingTableId on a fixed charge (or a stale fixedPrice on a table
+    // charge) that the patch-only validator never sees.
+    const normalizedUpdates =
+      updates.pricingMethod !== undefined || updates.chargeModel !== undefined
+        ? (() => {
+            const { model, source } = normalizeChargePricing({ ...entity, ...updates })
+            const sideCleared = source === 'fixed'
+              ? { pricingTableId: null, priceColumnKey: null }
+              : { fixedPrice: null }
+            return { ...updates, chargeModel: model, pricingMethod: source, ...sideCleared }
+          })()
+        : updates
+    ctx.em.assign(entity, normalizedUpdates)
     await ctx.em.flush()
 
     return NextResponse.json({
@@ -139,6 +159,7 @@ export async function PUT(req: Request) {
       code: entity.code,
       name: entity.name,
       chargeType: entity.chargeType,
+      chargeModel: entity.chargeModel,
       pricingMethod: entity.pricingMethod,
       pricingTableId: entity.pricingTableId,
       priceColumnKey: entity.priceColumnKey,

package/src/modules/cpq/api/product-offerings/route.ts

@@ -91,6 +91,7 @@ export async function GET(req: Request) {
           name: c.name,
           description: c.description,
           chargeType: c.chargeType,
+          chargeModel: c.chargeModel,
           pricingMethod: c.pricingMethod,
           pricingTableId: c.pricingTableId,
           priceColumnKey: c.priceColumnKey,
@@ -165,6 +166,7 @@ export async function GET(req: Request) {
           name: c.name,
           description: c.description,
           chargeType: c.chargeType,
+          chargeModel: c.chargeModel,
           pricingMethod: c.pricingMethod,
           pricingTableId: c.pricingTableId,
           priceColumnKey: c.priceColumnKey,