@dainamite/cpq 0.2.2

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

@@ -0,0 +1,55 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken, apiRequest } from '@open-mercato/core/helpers/integration/api'
+import { createCompanyFixture } from '@open-mercato/core/helpers/integration/crmFixtures'
+
+/**
+ * TC-CPQ-008: Quotes list + open detail (UI)
+ * Category: CPQ — UI
+ * Priority: High
+ *
+ * Creates a quote via API, then verifies it shows up on the list page and
+ * navigating to the detail URL renders without error.
+ */
+
+const uniq = () => Date.now().toString(36) + Math.random().toString(36).slice(2, 6)
+
+test.describe('TC-CPQ-008: Quotes list (UI)', () => {
+  test('admin opens the quotes list and sees the heading + table headers', async ({ page }) => {
+    await login(page, 'admin')
+    await page.goto('/backend/cpq/quotes', { waitUntil: 'domcontentloaded' })
+
+    // Title now lives inside DataTable as <h2> (CpqListView refactor).
+    await expect(page.getByRole('heading', { name: /CPQ Quotes/i }).first()).toBeVisible({ timeout: 15_000 })
+    await expect(page.getByRole('button', { name: /New Quote/i })).toBeVisible({ timeout: 15_000 })
+
+    // Table renders OR empty state appears. NOTE: cross-org admin scopes were observed during
+    // initial development — admins may see different quote rows depending on the active org context,
+    // so we don't pin to a specific row. UI list-load smoke is the goal here.
+    // Column was renamed "Quote ID" → "Quote Number" when the list started
+    // resolving SalesQuote.quoteNumber server-side (commit 209ca7a).
+    // Use getByText instead of role=columnheader because tanstack-table
+    // wraps headers in a sort-button container, and the accessibility
+    // name on the <th> often doesn't surface the plain header text.
+    const tableHeader = page.getByText(/Quote Number/i)
+    const emptyState = page.getByText(/no quote|empty|create one/i)
+    await expect(tableHeader.or(emptyState).first()).toBeVisible({ timeout: 15_000 })
+  })
+
+  test('quote detail page renders for a known quote id', async ({ page, request }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await createCompanyFixture(request, token, `Acme ${uniq()}`)
+
+    const quoteRes = await apiRequest(request, 'POST', '/api/cpq/quotes', {
+      token,
+      data: { customerId, currencyCode: 'USD' },
+    })
+    const quote = (await quoteRes.json()) as { id: string }
+
+    await login(page, 'admin')
+    await page.goto(`/backend/cpq/quotes/${quote.id}`, { waitUntil: 'domcontentloaded' })
+
+    // Stays on the detail URL (no auth bounce / error redirect).
+    expect(page.url()).toContain(`/backend/cpq/quotes/${quote.id}`)
+  })
+})

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

@@ -0,0 +1,45 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken, apiRequest } from '@open-mercato/core/helpers/integration/api'
+
+/**
+ * TC-CPQ-009: Pricing tables list (UI)
+ * Category: CPQ — UI
+ * Priority: Medium
+ */
+
+const uniq = () => Date.now().toString(36) + Math.random().toString(36).slice(2, 6)
+
+test.describe('TC-CPQ-009: Pricing tables list (UI)', () => {
+  test('renders heading + freshly created table appears in the list', async ({ page, request }) => {
+    const token = await getAuthToken(request, 'admin')
+
+    const code = `PT-${uniq()}`
+    const created = await apiRequest(request, 'POST', '/api/cpq/pricing-tables', {
+      token,
+      data: {
+        code,
+        name: `UI Pricing Table ${code}`,
+        dimensions: [{ key: 'dc', label: 'Datacenter' }],
+        priceColumns: [{ key: 'list', label: 'List' }],
+        currencyCodeList: ['USD'],
+      },
+    })
+    expect(created.ok(), `pricing table POST returned ${created.status()}`).toBeTruthy()
+    const table = (await created.json()) as { id: string }
+
+    try {
+      await login(page, 'admin')
+      await page.goto('/backend/cpq/pricing', { waitUntil: 'domcontentloaded' })
+
+      // Title now lives inside DataTable as <h2> (CpqListView refactor).
+      await expect(page.getByRole('heading', { name: /Pricing Tables/i }).first()).toBeVisible({ timeout: 15_000 })
+      await expect(page.locator('body')).toContainText(code, { timeout: 15_000 })
+    } finally {
+      await apiRequest(request, 'DELETE', '/api/cpq/pricing-tables', {
+        token,
+        data: { id: table.id },
+      }).catch(() => undefined)
+    }
+  })
+})

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

@@ -0,0 +1,54 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+
+/**
+ * TC-CPQ-010: Inventory section navigation (UI)
+ * Category: CPQ — UI
+ * Priority: Medium
+ *
+ * Inventory page exposes Subscriptions / Assets tabs. Verifies both
+ * are reachable and the heading is consistent.
+ */
+
+test.describe('TC-CPQ-010: Inventory tabs (UI)', () => {
+  test('admin lands on inventory page and can switch tabs', async ({ page }) => {
+    await login(page, 'admin')
+    await page.goto('/backend/cpq/inventory', { waitUntil: 'domcontentloaded' })
+
+    // Page-level h1 ("Customer Inventory") still exists; tab tables
+    // render their own <h2>. Either heading proves the page loaded.
+    await expect(
+      page.getByRole('heading', { name: /Customer Inventory|CPQ Subscriptions|Subscriptions/i }).first(),
+    ).toBeVisible({ timeout: 10_000 })
+
+    // Tabs (defined in code as { subscriptions, assets })
+    const subsTab = page.getByRole('button', { name: /Subscriptions/i }).first()
+    const assetsTab = page.getByRole('button', { name: /^Assets$/i }).first()
+
+    if (await subsTab.isVisible().catch(() => false)) {
+      await subsTab.click()
+      await expect(page.locator('body')).toContainText(/Subscriptions|No inventory/i, {
+        timeout: 5_000,
+      })
+    }
+
+    if (await assetsTab.isVisible().catch(() => false)) {
+      await assetsTab.click()
+      await expect(page.locator('body')).toContainText(/Assets|No inventory/i, {
+        timeout: 5_000,
+      })
+    }
+  })
+
+  test('subscription detail route does not 500 for a non-existent id (graceful 404 / empty)', async ({ page }) => {
+    await login(page, 'admin')
+    const fakeId = '00000000-0000-4000-8000-000000000000'
+    const res = await page.goto(`/backend/cpq/inventory/subscriptions/${fakeId}`, {
+      waitUntil: 'domcontentloaded',
+    })
+    // Either renders an empty/404-ish state OR the dev page returns 404 — both are acceptable.
+    if (res) {
+      expect([200, 404]).toContain(res.status())
+    }
+  })
+})

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

@@ -0,0 +1,24 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+
+/**
+ * TC-CPQ-011: Orders list page (UI)
+ * Category: CPQ — UI
+ * Priority: Medium
+ *
+ * Smoke test for the orders list — empty state must not crash, headings are
+ * present, and the page loads under admin auth.
+ */
+
+test.describe('TC-CPQ-011: Orders list page (UI)', () => {
+  test('admin can open the orders list', async ({ page }) => {
+    await login(page, 'admin')
+    await page.goto('/backend/cpq/orders', { waitUntil: 'domcontentloaded' })
+
+    // Title now lives inside DataTable as <h2> (CpqListView refactor).
+    await expect(page.getByRole('heading', { name: /CPQ Orders/i }).first()).toBeVisible({ timeout: 15_000 })
+
+    // Page rendered some content — table or empty-state message
+    await expect(page.locator('body')).not.toBeEmpty()
+  })
+})

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

@@ -0,0 +1,62 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+
+/**
+ * TC-CPQ-012 — Inline "Expiring within N days" picker smoke (UI)
+ *
+ * Commit `0992f60` / `071568d` replaced the retired `/expiring` page with
+ * an inline picker on the main subscriptions list, mounted in the
+ * DataTable title row. This test is a focused smoke check that the
+ * picker is present, defaults to "All subscriptions", and can be opened
+ * to reveal the canonical preset windows (7 / 14 / 30 / 60 / 90 days).
+ *
+ * Heavier data-level coverage (seeded subs, before/after window swap)
+ * lives in TC-CPQ-ARC-005 — this spec stays small so it catches
+ * "picker disappeared" regressions in seconds.
+ */
+// Radix Select.Trigger renders a `<button role="combobox">` whose
+// accessible name comes from the SelectValue children. Looking it up by
+// `getByRole('combobox', { name: /All subscriptions/ })` has been
+// brittle in CI (Radix can render SelectValue before the matching
+// SelectItem mounts in its Portal, leaving the trigger temporarily
+// nameless). The picker is the only combobox visible on the page until
+// the Filters overlay is opened, so `.locator('[role="combobox"]')`
+// is unambiguous *and* doesn't depend on accessibility-name timing.
+const pickerLocator = '[role="combobox"]'
+
+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' })
+
+    // Wait for the inline picker. Visible text content is "All
+    // subscriptions" (default value) once Radix mounts.
+    const picker = page.locator(pickerLocator).first()
+    await expect(picker).toBeVisible({ timeout: 15_000 })
+    await expect(picker).toContainText(/All subscriptions/i, { timeout: 10_000 })
+
+    // 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()
+    for (const days of [7, 14, 30, 60, 90]) {
+      await expect(
+        page.getByRole('option', { name: new RegExp(`Expiring in ${days} days`, 'i') }),
+      ).toBeVisible({ timeout: 5_000 })
+    }
+  })
+
+  test('selecting a window updates the picker label without leaving the page', async ({ page }) => {
+    await login(page, 'admin')
+    await page.goto('/backend/cpq/inventory', { waitUntil: 'domcontentloaded' })
+
+    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()
+
+    // Same URL — the picker writes into the in-page filter state, not a
+    // route param. Picker now reflects the chosen window.
+    expect(page.url()).toContain('/backend/cpq/inventory')
+    await expect(trigger).toContainText(/Expiring in 30 days/i, { timeout: 5_000 })
+  })
+})

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

@@ -0,0 +1,52 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken } from '@open-mercato/core/helpers/integration/api'
+import {
+  seedActiveSubscription,
+  seedCustomer,
+  deleteSubscription,
+  deleteCustomer,
+  hideFloatingOverlays,
+} from './_helpers/cpqArcFixtures'
+
+/**
+ * TC-CPQ-ARC-001 — Amend flow via UI (XD-250)
+ *
+ * Operator opens an active subscription, clicks "Amend", drawer attaches the
+ * source sub as the (sole) target, submits. The quote detail page renders
+ * the ARC summary banner with the attached target.
+ */
+test.describe('TC-CPQ-ARC-001 — Amend flow (UI)', () => {
+  test('opens Amend drawer from subscription detail and the new quote shows the target in the ARC banner', async ({
+    page,
+    request,
+  }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await seedCustomer(request, token)
+    const sub = await seedActiveSubscription(request, token, { customerId })
+
+    try {
+      await login(page, 'admin')
+
+      await page.goto(`/backend/cpq/inventory/subscriptions/${sub.id}`, {
+        waitUntil: 'domcontentloaded',
+      })
+      await hideFloatingOverlays(page)
+
+      // Header buttons render only for active/suspended subs.
+      const amendBtn = page.getByRole('button', { name: /^Amend$/ })
+      await expect(amendBtn).toBeVisible({ timeout: 15_000 })
+
+      await amendBtn.click()
+
+      // After click, startArcQuote() POSTs from-subscription then router.push()es
+      // to /backend/cpq/quotes/[newId]. Poll for an element specific to the
+      // quote detail with the ARC banner — survives Turbopack cold-compile.
+      await expect(page.locator('body')).toContainText(sub.code, { timeout: 15_000 })
+      await expect(page.getByText(/1 target/i).first()).toBeVisible({ timeout: 5_000 })
+    } finally {
+      await deleteSubscription(request, token, sub.id).catch(() => undefined)
+      await deleteCustomer(request, token, customerId).catch(() => undefined)
+    }
+  })
+})

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

@@ -0,0 +1,65 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken } from '@open-mercato/core/helpers/integration/api'
+import {
+  seedActiveSubscription,
+  seedCustomer,
+  deleteSubscription,
+  deleteCustomer,
+  hideFloatingOverlays,
+} from './_helpers/cpqArcFixtures'
+
+/**
+ * TC-CPQ-ARC-002 — Multi-target Amend (UI) (XD-250)
+ *
+ * Operator starts an Amend quote on subscription A, opens the "Modify
+ * subscription" drawer, attaches subscription B as a 2nd target. The ARC
+ * banner then shows "2 targets".
+ */
+test.describe('TC-CPQ-ARC-002 — Multi-target Amend (UI)', () => {
+  test('attaching a 2nd target via the drawer shows "2 targets" in the ARC banner', async ({
+    page,
+    request,
+  }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await seedCustomer(request, token)
+    const subA = await seedActiveSubscription(request, token, { customerId, name: 'Sub A' })
+    const subB = await seedActiveSubscription(request, token, { customerId, name: 'Sub B' })
+
+    try {
+      await login(page, 'admin')
+
+      // Open Amend on sub A — quote pre-filled with A as the target.
+      await page.goto(`/backend/cpq/inventory/subscriptions/${subA.id}`, {
+        waitUntil: 'domcontentloaded',
+      })
+      await hideFloatingOverlays(page)
+      await page.getByRole('button', { name: /^Amend$/ }).click()
+      await expect(page.locator('body')).toContainText(subA.code, { timeout: 15_000 })
+      await hideFloatingOverlays(page)
+
+      // Open the configurator drawer.
+      await page.getByRole('button', { name: /Modify subscription/i }).click()
+      await hideFloatingOverlays(page)
+      const drawer = page.getByRole('dialog')
+
+      // Drawer opens at "pick-targets" because quote_type is already 'amend'.
+      // Pre-existing target (subA) is checked; subB row is unchecked. Tick subB.
+      const subBLabel = drawer.locator('label', { hasText: subB.code }).first()
+      await expect(subBLabel).toBeVisible({ timeout: 10_000 })
+      await subBLabel.locator('input[type="checkbox"]').check()
+
+      // Drawer step machine: Next → review → Submit.
+      await drawer.getByRole('button', { name: /^Next$/ }).click()
+      await drawer.getByRole('button', { name: /^Submit$/ }).click()
+
+      // After submit, drawer reaches 'done'. Close returns to host quote page.
+      await drawer.getByRole('button', { name: /^Close$/ }).click()
+      await expect(page.getByText(/2 targets/i)).toBeVisible({ timeout: 10_000 })
+    } finally {
+      await deleteSubscription(request, token, subA.id).catch(() => undefined)
+      await deleteSubscription(request, token, subB.id).catch(() => undefined)
+      await deleteCustomer(request, token, customerId).catch(() => undefined)
+    }
+  })
+})

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

@@ -0,0 +1,107 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken } from '@open-mercato/core/helpers/integration/api'
+import {
+  seedActiveSubscription,
+  seedCustomer,
+  deleteSubscription,
+  deleteCustomer,
+  hideFloatingOverlays,
+} from './_helpers/cpqArcFixtures'
+
+/**
+ * TC-CPQ-ARC-003 — Merge renewal (UI) (XD-250)
+ *
+ * Operator starts a Renew quote on subscription A (becomes the first target,
+ * standalone). They open the drawer, attach 2 more subs (B + C). The drawer
+ * automatically flips to merge mode. They fill in the new contract term,
+ * submit. Banner shows "Merging into a new contract" + 3 targets.
+ */
+test.describe('TC-CPQ-ARC-003 — Merge renewal (UI)', () => {
+  test('attaching ≥2 renew targets enters merge mode and the banner shows the merge marker', async ({
+    page,
+    request,
+  }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await seedCustomer(request, token)
+    const subA = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Sub Alpha',
+      billingCycle: 'monthly',
+    })
+    const subB = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Sub Bravo',
+      billingCycle: 'monthly',
+    })
+    const subC = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Sub Charlie',
+      billingCycle: 'monthly',
+    })
+
+    try {
+      await login(page, 'admin')
+
+      // Start a Renew quote on subA.
+      await page.goto(`/backend/cpq/inventory/subscriptions/${subA.id}`, {
+        waitUntil: 'domcontentloaded',
+      })
+      await hideFloatingOverlays(page)
+      await page.getByRole('button', { name: /^Renew$/ }).click()
+      await expect(page.locator('body')).toContainText(subA.code, { timeout: 15_000 })
+      await hideFloatingOverlays(page)
+
+      // Open drawer, attach subB + subC. The drawer auto-flips to merge mode
+      // when 2+ renew targets are picked.
+      await page.getByRole('button', { name: /Modify subscription/i }).click()
+      await hideFloatingOverlays(page)
+      const drawer = page.getByRole('dialog')
+
+      const subBLabel = drawer.locator('label', { hasText: subB.code }).first()
+      await expect(subBLabel).toBeVisible({ timeout: 10_000 })
+      await subBLabel.locator('input[type="checkbox"]').check()
+
+      const subCLabel = drawer.locator('label', { hasText: subC.code }).first()
+      await subCLabel.locator('input[type="checkbox"]').check()
+
+      // Merge banner inside drawer pick-targets step.
+      await expect(
+        drawer.getByText(/Merging \d+ contracts into a new one/i),
+      ).toBeVisible({ timeout: 5_000 })
+
+      // Next → config-renew (merge form).
+      await drawer.getByRole('button', { name: /^Next$/ }).click()
+
+      // Fill quote-level merge term.
+      const startDate = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000)
+        .toISOString()
+        .split('T')[0]
+      const endDate = new Date(Date.now() + 395 * 24 * 60 * 60 * 1000)
+        .toISOString()
+        .split('T')[0]
+
+      // Drawer renders 3 date/number inputs labelled Start / End / Months for
+      // the merge form. Scope to drawer to avoid any other date inputs on the
+      // host page.
+      const dateInputs = drawer.locator('input[type="date"]')
+      await dateInputs.nth(0).fill(startDate)
+      await dateInputs.nth(1).fill(endDate)
+
+      await drawer.getByRole('button', { name: /^Next$/ }).click()
+      await drawer.getByRole('button', { name: /^Submit$/ }).click()
+      await drawer.getByRole('button', { name: /^Close$/ }).click()
+
+      // Host page banner now reflects merge mode + 3 targets.
+      await expect(page.getByText(/3 targets/i)).toBeVisible({ timeout: 10_000 })
+      await expect(page.getByText(/Merging into a new contract/i)).toBeVisible({
+        timeout: 5_000,
+      })
+    } finally {
+      await deleteSubscription(request, token, subA.id).catch(() => undefined)
+      await deleteSubscription(request, token, subB.id).catch(() => undefined)
+      await deleteSubscription(request, token, subC.id).catch(() => undefined)
+      await deleteCustomer(request, token, customerId).catch(() => undefined)
+    }
+  })
+})

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

@@ -0,0 +1,74 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken } from '@open-mercato/core/helpers/integration/api'
+import {
+  seedActiveSubscription,
+  seedCustomer,
+  deleteSubscription,
+  deleteCustomer,
+  hideFloatingOverlays,
+} from './_helpers/cpqArcFixtures'
+
+/**
+ * TC-CPQ-ARC-004 — Cancel quote with reason + ETF (UI) (XD-250)
+ *
+ * Operator opens an active subscription, clicks "Cancel", drawer pre-fills
+ * with the source sub as the cancel target. They open the configurator drawer
+ * to stamp reason + ETF, submit. The ARC banner shows type=cancel.
+ */
+test.describe('TC-CPQ-ARC-004 — Cancel quote (UI)', () => {
+  test('Cancel button creates a cancel quote, drawer stamps reason + ETF, banner shows CANCEL', async ({
+    page,
+    request,
+  }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await seedCustomer(request, token)
+    const sub = await seedActiveSubscription(request, token, { customerId, name: 'To Cancel' })
+
+    try {
+      await login(page, 'admin')
+
+      await page.goto(`/backend/cpq/inventory/subscriptions/${sub.id}`, {
+        waitUntil: 'domcontentloaded',
+      })
+      await hideFloatingOverlays(page)
+      await page.getByRole('button', { name: /^Cancel$/ }).click()
+      await expect(page.locator('body')).toContainText(sub.code, { timeout: 15_000 })
+      await hideFloatingOverlays(page)
+
+      // The new quote has quote_type='cancel'. Banner should show CANCEL.
+      await expect(page.getByText('CANCEL', { exact: false }).first()).toBeVisible({
+        timeout: 10_000,
+      })
+
+      // Open drawer to stamp cancel-meta.
+      await page.getByRole('button', { name: /Modify subscription/i }).click()
+      await hideFloatingOverlays(page)
+
+      // initialType is 'cancel', so drawer skips pick-action and starts at
+      // pick-targets. Sub is already attached. Next → config-cancel.
+      const drawer = page.getByRole('dialog')
+      await drawer.getByRole('button', { name: /^Next$/ }).click()
+
+      // Reason code dropdown — scope to drawer to avoid the global org combobox.
+      await drawer.locator('select').first().selectOption('non-payment')
+
+      // Cancel-meta inputs in drawer order: reasonText, etfAmount, etfCurrency.
+      // We only need to set the ETF amount.
+      const drawerTextInputs = drawer.locator('input[type="text"]')
+      await drawerTextInputs.nth(1).fill('500.00')
+
+      await drawer.getByRole('button', { name: /^Next$/ }).click()
+      await drawer.getByRole('button', { name: /^Submit$/ }).click()
+      await drawer.getByRole('button', { name: /^Close$/ }).click()
+
+      // After submit, the banner still shows CANCEL.
+      await expect(page.getByText('CANCEL', { exact: false }).first()).toBeVisible({
+        timeout: 10_000,
+      })
+    } finally {
+      await deleteSubscription(request, token, sub.id).catch(() => undefined)
+      await deleteCustomer(request, token, customerId).catch(() => undefined)
+    }
+  })
+})

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

@@ -0,0 +1,86 @@
+import { test, expect } from '@playwright/test'
+import { login } from '@open-mercato/core/helpers/integration/auth'
+import { getAuthToken } from '@open-mercato/core/helpers/integration/api'
+import {
+  seedActiveSubscription,
+  seedCustomer,
+  daysFromNow,
+  deleteSubscription,
+  deleteCustomer,
+  hideFloatingOverlays,
+} from './_helpers/cpqArcFixtures'
+
+/**
+ * TC-CPQ-ARC-005 — Expiring Subscriptions filter (UI) (XD-250)
+ *
+ * The standalone `/expiring` page was retired (commit fa5b899) in favour
+ * of an `expiringWithinDays` filter + saved-perspective workflow on the
+ * main subscriptions list. This test now drives the inline expiring
+ * picker that sits in the title row of the Subscriptions tab.
+ *
+ * Seeds 3 subscriptions with currentTermEnd at +5d / +20d / +60d.
+ * Picking "Expiring in 30 days" shows the first two; switching to "90
+ * days" reveals the third.
+ */
+test.describe('TC-CPQ-ARC-005 — Expiring view filter (UI)', () => {
+  test('30-day window includes only subs with currentTermEnd within the window', async ({
+    page,
+    request,
+  }) => {
+    const token = await getAuthToken(request, 'admin')
+    const customerId = await seedCustomer(request, token)
+    const subSoon = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Expiring Soon',
+      currentTermEnd: daysFromNow(5),
+    })
+    const subSoonish = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Expiring Soonish',
+      currentTermEnd: daysFromNow(20),
+    })
+    const subLater = await seedActiveSubscription(request, token, {
+      customerId,
+      name: 'Expiring Later',
+      currentTermEnd: daysFromNow(60),
+    })
+
+    try {
+      await login(page, 'admin')
+
+      // Land on the Subscriptions tab of the main inventory page.
+      await page.goto('/backend/cpq/inventory', { waitUntil: 'domcontentloaded' })
+      await hideFloatingOverlays(page)
+
+      // All three seeded subs initially visible (no window filter yet).
+      const body = page.locator('body')
+      await expect(body).toContainText(subSoon.code, { timeout: 15_000 })
+
+      // The inline picker is a Radix Select.Trigger with role=combobox.
+      // Accessibility-name matching is brittle (SelectValue can render
+      // before its item mounts), so we target the trigger element
+      // directly and rely on its visible text content for assertions.
+      const picker = page.locator('[role="combobox"]').first()
+      await expect(picker).toBeVisible({ timeout: 15_000 })
+
+      // Open and pick "30 days".
+      await picker.click()
+      await page.getByRole('option', { name: /Expiring in 30 days/i }).click()
+
+      // 30d window → Soon (5d) + Soonish (20d) visible, Later (60d) NOT.
+      await expect(body).toContainText(subSoon.code, { timeout: 15_000 })
+      await expect(body).toContainText(subSoonish.code, { timeout: 5_000 })
+      await expect(body).not.toContainText(subLater.code)
+
+      // Switch to 90 days → all three appear.
+      await picker.click()
+      await page.getByRole('option', { name: /Expiring in 90 days/i }).click()
+      await expect(body).toContainText(subLater.code, { timeout: 10_000 })
+    } finally {
+      await deleteSubscription(request, token, subSoon.id).catch(() => undefined)
+      await deleteSubscription(request, token, subSoonish.id).catch(() => undefined)
+      await deleteSubscription(request, token, subLater.id).catch(() => undefined)
+      await deleteCustomer(request, token, customerId).catch(() => undefined)
+    }
+  })
+})