@dainamite/cpq 0.5.0 → 0.6.0

package/src/modules/cpq/backend/cpq/quotes/[id]/_components/priceAdjustmentContext.tsx

@@ -0,0 +1,133 @@
+'use client'
+
+import * as React from 'react'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { Percent, Pencil, Trash2 } from 'lucide-react'
+import { IconButton } from '@open-mercato/ui/primitives/icon-button'
+import { SimpleTooltip } from '@open-mercato/ui/primitives/tooltip'
+import type { AdjustmentAccess, LineEligibilityInput, WaterfallChargeInput } from '../../../../../lib/priceAdjustmentView'
+import { lineAdjustmentBlock } from '../../../../../lib/priceAdjustmentView'
+
+export type AdjustableLine = LineEligibilityInput & { lineId: string; offeringName: string }
+export type AdjustableCharge = WaterfallChargeInput & { chargeCode: string; chargeName: string }
+
+export type PriceAdjustmentUi = {
+  access: AdjustmentAccess
+  quoteType: string
+  cpqStatus: string
+  reasonLabels: Record<string, string>
+  /** Ids of adjustments currently flagged invalid (they keep Delete while locked). */
+  invalidIds: Set<string>
+  canDeleteInvalid: boolean
+  openCharge: (line: AdjustableLine, charge: AdjustableCharge) => void
+  openLine: (line: AdjustableLine) => void
+  edit: (adjustmentId: string) => void
+  remove: (adjustmentId: string) => void
+}
+
+const Context = React.createContext<PriceAdjustmentUi | null>(null)
+export const PriceAdjustmentProvider = Context.Provider
+export const usePriceAdjustmentUi = () => React.useContext(Context)
+
+/** Quote-wide explanation for why adjustments are unavailable; null when editable. */
+export function useAccessReasonText(): string | null {
+  const t = useT()
+  const ui = usePriceAdjustmentUi()
+  if (!ui) return null
+  switch (ui.access.reason) {
+    case null: return null
+    case 'locked':
+      return t('cpq.priceAdjustments.blocked.locked', 'Adjustments are locked in status {status} — move the quote back to Ready to change them')
+        .replace('{status}', ui.cpqStatus)
+    case 'converted': return t('cpq.priceAdjustments.blocked.converted', 'This quote has been converted to an order')
+    case 'no_permission': return t('cpq.priceAdjustments.blocked.permission', 'You do not have permission to adjust prices')
+    case 'disabled': return t('cpq.priceAdjustments.blocked.disabled', 'Manual price adjustments are turned off')
+    default: return t('cpq.priceAdjustments.blocked.loading', 'Loading…')
+  }
+}
+
+/** Disabled-state explanation for one line; null when the action is available. */
+export function useAdjustmentBlockReason(line: AdjustableLine): string | null {
+  const t = useT()
+  const ui = usePriceAdjustmentUi()
+  const accessText = useAccessReasonText()
+  if (!ui) return null
+  const block = lineAdjustmentBlock(line, ui.quoteType)
+  if (block === 'mirror') return t('cpq.priceAdjustments.blocked.mirror', 'Price changes on existing subscription items arrive with a later release')
+  if (block === 'free_form') return t('cpq.priceAdjustments.blocked.freeForm', 'Free-form lines cannot be adjusted')
+  return accessText
+}
+
+/**
+ * Disabled buttons swallow no pointer events, so a native `title` never shows.
+ * Wrap a blocked action in a focusable span that carries the explanation.
+ */
+function BlockedReason({ reason, children }: { reason: string | null; children: React.ReactNode }) {
+  if (!reason) return <>{children}</>
+  return (
+    <SimpleTooltip content={reason} size="sm">
+      <span className="inline-flex cursor-not-allowed" tabIndex={0} aria-label={reason}>{children}</span>
+    </SimpleTooltip>
+  )
+}
+
+/** Per-charge "Adjust price" action. Hidden entirely when the feature is off or not permitted. */
+export function AdjustChargeAction({ line, charge }: { line: AdjustableLine; charge: AdjustableCharge }) {
+  const t = useT()
+  const ui = usePriceAdjustmentUi()
+  const reason = useAdjustmentBlockReason(line)
+  if (!ui || charge.chargeType === 'usage') return null
+  if (ui.access.reason === 'disabled' || ui.access.reason === 'no_permission' || ui.access.reason === 'loading') return null
+  const label = t('cpq.priceAdjustments.adjustPrice', 'Adjust price')
+  return (
+    <BlockedReason reason={reason}>
+      <IconButton
+        variant="ghost" size="xs" aria-label={label} title={reason ? undefined : label} disabled={!!reason}
+        onClick={() => ui.openCharge(line, charge)} data-testid="cpq-adjust-charge"
+      >
+        <Pencil className="h-3.5 w-3.5" />
+      </IconButton>
+    </BlockedReason>
+  )
+}
+
+/** Line-level "Discount line" action. */
+export function DiscountLineAction({ line }: { line: AdjustableLine }) {
+  const t = useT()
+  const ui = usePriceAdjustmentUi()
+  const reason = useAdjustmentBlockReason(line)
+  if (!ui || ui.access.reason === 'disabled' || ui.access.reason === 'no_permission' || ui.access.reason === 'loading') return null
+  const label = t('cpq.priceAdjustments.discountLine', 'Discount line')
+  return (
+    <BlockedReason reason={reason}>
+      <IconButton
+        variant="ghost" size="sm" aria-label={label} title={reason ? undefined : label} disabled={!!reason}
+        onClick={() => ui.openLine(line)} data-testid="cpq-discount-line"
+      >
+        <Percent className="h-4 w-4" />
+      </IconButton>
+    </BlockedReason>
+  )
+}
+
+/** Edit / delete actions on a manual waterfall row or panel row. */
+export function ManualAdjustmentActions({ adjustmentId }: { adjustmentId: string }) {
+  const t = useT()
+  const ui = usePriceAdjustmentUi()
+  if (!ui) return null
+  const editable = ui.access.editable
+  const deletable = editable || (ui.canDeleteInvalid && ui.invalidIds.has(adjustmentId))
+  if (!editable && !deletable) return null
+  return (
+    <span className="inline-flex items-center gap-0.5">
+      {editable && (
+        <IconButton variant="ghost" size="xs" aria-label={t('cpq.priceAdjustments.edit', 'Edit adjustment')} onClick={() => ui.edit(adjustmentId)}>
+          <Pencil className="h-3.5 w-3.5" />
+        </IconButton>
+      )}
+      <IconButton variant="ghost" size="xs" aria-label={t('cpq.priceAdjustments.delete', 'Delete adjustment')} onClick={() => ui.remove(adjustmentId)}>
+        <Trash2 className="h-3.5 w-3.5" />
+      </IconButton>
+    </span>
+  )
+}

package/src/modules/cpq/backend/cpq/quotes/[id]/_components/usePriceAdjustments.tsx

@@ -0,0 +1,165 @@
+'use client'
+
+import * as React from 'react'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import { useConfirmDialog } from '@open-mercato/ui/backend/confirm-dialog'
+import { flash } from '@open-mercato/ui/backend/FlashMessages'
+import {
+  ADJUSTMENT_ERROR_FALLBACKS,
+  adjustmentAccess,
+  adjustmentErrorCode,
+  canDeleteInvalidAdjustment,
+  collectAdjustmentErrors,
+  type AdjustmentErrorSourceQuote,
+  type AdjustmentTarget,
+} from '../../../../../lib/priceAdjustmentView'
+import { PriceAdjustmentDialog, type AdjustmentReason, type ExistingAdjustment } from './PriceAdjustmentDialog'
+import type { AdjustableCharge, AdjustableLine, PriceAdjustmentUi } from './priceAdjustmentContext'
+import type { StoredAdjustment } from './PriceAdjustmentsPanel'
+
+type ControllerQuote = {
+  id: string
+  cpqStatus: string
+  currencyCode: string
+  convertedOrderId: string | null
+  pricingRevision?: number
+  adjustmentErrors?: Array<{ adjustmentId: string; code: string }>
+  lines: Array<AdjustableLine & { mrcTotal: number; nrcTotal: number; charges: AdjustableCharge[] }>
+}
+
+type ListResponse = {
+  items: StoredAdjustment[]
+  total: number
+  pricingRevision: number
+  enabled: boolean
+  reasons?: AdjustmentReason[]
+}
+
+type DialogState = {
+  target: AdjustmentTarget
+  targetLabel: string
+  charge?: AdjustableCharge
+  existing?: ExistingAdjustment | null
+}
+
+/**
+ * Owns negotiated-price state for the quote page: the adjustment list,
+ * reason options, the dialog and delete confirmation. Every write returns the
+ * repriced quote, which is handed back through `onQuote`.
+ */
+export function usePriceAdjustments<Q extends ControllerQuote>({ quote, quoteType, canAdjust, onQuote, reloadQuote }: {
+  quote: Q | null
+  quoteType: string
+  canAdjust: boolean
+  onQuote: (quote: Q) => void
+  reloadQuote: () => Promise<void>
+}) {
+  const t = useT()
+  const { confirm, ConfirmDialogElement } = useConfirmDialog()
+  const [list, setList] = React.useState<ListResponse | null>(null)
+  const [dialog, setDialog] = React.useState<DialogState | null>(null)
+  const quoteId = quote?.id ?? null
+  const revision = quote?.pricingRevision ?? 0
+
+  const loadList = React.useCallback(async () => {
+    if (!quoteId) return
+    const call = await apiCall<ListResponse>(`/api/cpq/quotes/${quoteId}/price-adjustments?pageSize=100`)
+    if (call.ok && call.result) setList(call.result)
+    else setList({ items: [], total: 0, pricingRevision: 0, enabled: false })
+  }, [quoteId])
+
+  // Refresh whenever the quote's pricing revision moves (own writes, line edits, recalculation).
+  React.useEffect(() => { void loadList() }, [loadList, revision])
+
+  const reasons = React.useMemo(() => list?.reasons ?? [], [list])
+  const reasonLabels = React.useMemo(() => Object.fromEntries(reasons.map((reason) => [reason.value, reason.label])), [reasons])
+  const errorsById = React.useMemo(() => collectAdjustmentErrors(quote as AdjustmentErrorSourceQuote | null), [quote])
+
+  const accessInput = {
+    enabled: list ? list.enabled : null,
+    canAdjust,
+    cpqStatus: quote?.cpqStatus ?? 'new',
+    convertedOrderId: quote?.convertedOrderId ?? null,
+  }
+  const access = adjustmentAccess(accessInput)
+
+  const remove = React.useCallback(async (adjustmentId: string) => {
+    if (!quoteId) return
+    const ok = await confirm({
+      title: t('cpq.priceAdjustments.deleteConfirm.title', 'Remove this price adjustment?'),
+      text: t('cpq.priceAdjustments.deleteConfirm.text', 'The charge goes back to its standard price.'),
+      confirmText: t('cpq.priceAdjustments.deleteConfirm.confirm', 'Remove'),
+      variant: 'destructive',
+    })
+    if (!ok) return
+    const call = await apiCall<{ quote: Q }>(`/api/cpq/quotes/${quoteId}/price-adjustments/${adjustmentId}?expectedRevision=${revision}`, { method: 'DELETE' })
+    if (call.ok && call.result?.quote) { onQuote(call.result.quote); return }
+    const code = adjustmentErrorCode(call.status, call.result)
+    flash(t(`cpq.priceAdjustments.errors.${code}`, ADJUSTMENT_ERROR_FALLBACKS[code] ?? code), 'error')
+    if (code === 'STALE_REVISION') await reloadQuote()
+  }, [quoteId, revision, confirm, t, onQuote, reloadQuote])
+
+  const ui: PriceAdjustmentUi = {
+    access,
+    quoteType,
+    cpqStatus: accessInput.cpqStatus,
+    reasonLabels,
+    invalidIds: new Set(errorsById.keys()),
+    canDeleteInvalid: canDeleteInvalidAdjustment(accessInput),
+    openCharge: (line, charge) => {
+      const existing = list?.items.find((item) => item.level === 'charge' && item.quoteLineId === line.lineId && item.chargeCode === charge.chargeCode)
+      setDialog({
+        target: { level: 'charge', quoteLineId: line.lineId, chargeCode: charge.chargeCode },
+        targetLabel: `${line.offeringName} · ${charge.chargeName}`,
+        charge,
+        existing: existing ?? null,
+      })
+    },
+    openLine: (line) => {
+      const existing = list?.items.find((item) => item.level === 'line' && item.quoteLineId === line.lineId)
+      setDialog({ target: { level: 'line', quoteLineId: line.lineId }, targetLabel: line.offeringName, existing: existing ?? null })
+    },
+    edit: (adjustmentId) => {
+      const item = list?.items.find((entry) => entry.id === adjustmentId)
+      const line = quote?.lines.find((entry) => entry.lineId === item?.quoteLineId)
+      if (!item || !line) return
+      const charge = item.chargeCode ? line.charges.find((entry) => entry.chargeCode === item.chargeCode) : undefined
+      setDialog({
+        target: item.level === 'charge' && item.chargeCode
+          ? { level: 'charge', quoteLineId: item.quoteLineId, chargeCode: item.chargeCode }
+          : { level: 'line', quoteLineId: item.quoteLineId },
+        targetLabel: charge ? `${line.offeringName} · ${charge.chargeName}` : line.offeringName,
+        charge,
+        existing: item,
+      })
+    },
+    remove: (adjustmentId) => { void remove(adjustmentId) },
+  }
+
+  const dialogElement = quote && dialog ? (
+    <PriceAdjustmentDialog<Q>
+      open
+      quoteId={quote.id}
+      currency={quote.currencyCode}
+      pricingRevision={revision}
+      target={dialog.target}
+      targetLabel={dialog.targetLabel}
+      charge={dialog.charge}
+      existing={dialog.existing}
+      storedAdjustmentIds={list?.items.map((item) => item.id) ?? []}
+      reasons={reasons}
+      onClose={() => setDialog(null)}
+      onSaved={(next) => onQuote(next)}
+      onStale={() => { void reloadQuote() }}
+    />
+  ) : null
+
+  return {
+    ui,
+    items: list?.items ?? [],
+    total: list?.total ?? 0,
+    errorsById,
+    elements: <>{dialogElement}{ConfirmDialogElement}</>,
+  }
+}