Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.
TypeScript aeoai-agentai-searchanswer-engine-optimizationbrand-monitoringchatgptclaudecopilotdockergeminigeogoogle-ai-overviewsgrokmcpnextjsopen-sourceperplexityseosupabasetypescript
feat(web): open the plan dialog from the remaining areas' actions, and from every way to add a brand, while the plan has ended (#1612)
Cihanb9f2ae5adee7
diff --git a/web/messages/en.json b/web/messages/en.jsonindex 9c787cbd3..1b21f96de 100644--- a/web/messages/en.json+++ b/web/messages/en.json@@ -178,8 +178,76 @@"addImages": "Adding images needs a plan","buildBrief": "Building the brief needs a plan","editBrief": "Editing the brief needs a plan",+ "changeShoppingPath": "Changing the shopping path needs a plan","editRules": "Changing rules needs a plan",- "saveInput": "Saving your input needs a plan"+ "saveInput": "Saving your input needs a plan",+ "runAudit": "Running an audit needs a plan",+ "auditPages": "Auditing pages needs a plan",+ "pinPages": "Pinning pages needs a plan",+ "unpinPages": "Unpinning pages needs a plan",+ "excludePages": "Excluding pages needs a plan",+ "restorePages": "Restoring pages needs a plan",+ "deleteAudits": "Deleting an audit needs a plan",+ "saveAuditSettings": "Saving the audit settings needs a plan",+ "checkSiteTrust": "Checking site trust again needs a plan",+ "startGettingStarted": "Starting Getting started needs a plan",+ "skipGettingStarted": "Skipping Getting started needs a plan",+ "skipSteps": "Skipping a step needs a plan",+ "changeActionStatus": "Changing an action's status needs a plan",+ "deleteActions": "Deleting actions needs a plan",+ "assignActions": "Assigning actions needs a plan",+ "setDueDate": "Setting a due date needs a plan",+ "changeTaskStatus": "Changing a task's status needs a plan",+ "addTasks": "Adding tasks needs a plan",+ "editTasks": "Editing tasks needs a plan",+ "deleteTasks": "Deleting tasks needs a plan",+ "sendTasks": "Sending tasks needs a plan",+ "checkTasks": "Checking a task needs a plan",+ "regenerateTasks": "Regenerating tasks needs a plan",+ "approveTasks": "Approving tasks needs a plan",+ "dismissTasks": "Dismissing tasks needs a plan",+ "changeSignalStatus": "Changing a signal's status needs a plan",+ "editKpis": "Editing KPIs needs a plan",+ "removeKpis": "Removing KPIs needs a plan",+ "correctSentiment": "Correcting sentiment needs a plan",+ "connectBotLogs": "Connecting bot logs needs a plan",+ "connectIntegrations": "Connecting an integration needs a plan",+ "mapProperties": "Choosing a property needs a plan",+ "setProductFeed": "Changing the product feed setting needs a plan",+ "generateReports": "Generating reports needs a plan",+ "deleteReports": "Deleting reports needs a plan",+ "startChat": "Starting a chat needs a plan",+ "sendChat": "Chatting with the agent needs a plan",+ "addBrands": "Adding brands needs a plan",+ "saveBrandSettings": "Saving brand settings needs a plan",+ "saveDomains": "Saving domains needs a plan",+ "changeShoppingMode": "Changing the shopping mode needs a plan",+ "pauseBrands": "Pausing a brand needs a plan",+ "resumeBrands": "Resuming a brand needs a plan",+ "changeConversions": "Changing conversion tracking needs a plan",+ "reviewBrandFacts": "Reviewing brand facts needs a plan",+ "readBrandFacts": "Reading brand facts again needs a plan",+ "renameOrganization": "Renaming the organization needs a plan",+ "inviteMembers": "Inviting members needs a plan",+ "resendInvitations": "Resending invitations needs a plan",+ "changeRoles": "Changing roles needs a plan",+ "saveAiKeys": "Saving an AI key needs a plan",+ "switchAiProvider": "Switching Chat's AI provider needs a plan",+ "addCatalogSources": "Adding catalog sources needs a plan",+ "syncCatalog": "Syncing the catalog needs a plan",+ "removeCatalogSources": "Removing catalog sources needs a plan",+ "connectStores": "Connecting a store needs a plan",+ "updateStoreSignIn": "Updating a store's sign-in needs a plan",+ "changeCategoryPages": "Changing a category's page needs a plan",+ "connectCms": "Connecting your CMS needs a plan",+ "saveCmsSettings": "Saving the CMS settings needs a plan",+ "saveNotifications": "Saving notification settings needs a plan",+ "addAuthors": "Adding authors needs a plan",+ "editAuthors": "Editing authors needs a plan",+ "removeAuthors": "Removing authors needs a plan",+ "setDefaultAuthor": "Setting a default author needs a plan",+ "setByline": "Changing the byline setting needs a plan",+ "changeContentSettings": "Changing content settings needs a plan"}},"common": {@@ -364,6 +432,7 @@"presets": {"setUp": "We set up these KPIs for you. Each aims 20% above its last 30 days, or starts from a default where there's no data yet. Change or remove them any time.","preview": "Suggested KPIs. Each aims 20% above its last 30 days, or starts from a default where there's no data yet. They're saved the first time an admin or manager opens this tab.",+ "previewReadOnly": "Suggested KPIs. Each aims 20% above its last 30 days, or starts from a default where there's no data yet. They're saved the first time an admin or manager opens this tab on an active plan.","dismiss": "Dismiss"}},diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.test.tsxindex 32b52d00a..8d968be23 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import type { Brand } from '@/types';import type { ActionItem } from '@/lib/actions/action-center';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';import {buildGettingStarted,type GettingStartedFacts,@@ -136,8 +137,17 @@ let root: Root;const exportButton = () =>[...container.querySelectorAll('button')].find((b) => b.textContent === 'exportCsv')!;-async function render() {- await act(async () => root.render(<ActionCenterActionsPage />));+const openUpgrade = vi.fn();+async function render(isLocked = false) {+ await act(async () =>+ root.render(+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ActionCenterActionsPage />+ </UpgradeDialogContext.Provider>,+ ),+ );}beforeEach(() => {@@ -376,6 +386,35 @@ describe('starting and skipping Getting started', () => {expect(buttonNamed('start.button')).toBeDefined();});+ // next-intl is mocked: the upgrade dialog's label is its key.+ it('starts and skips nothing on a read-only workspace: each opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ getGettingStarted.mockResolvedValue(started({ startedAt: null }));+ await render(true);+ await act(async () => buttonNamed('start.button')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('startGettingStarted');+ expect(startGettingStarted).not.toHaveBeenCalled();++ act(() => root.unmount());+ root = createRoot(container);+ getGettingStarted.mockResolvedValue(started());+ await render(true);+ await act(async () => buttonNamed('skip.button')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('skipGettingStarted');+ expect(pageText()).not.toContain('skip.body');+ expect(skipGettingStarted).not.toHaveBeenCalled();+ });++ it("doesn't ask on a read-only workspace whether to run it for a new brand: Start waits", async () => {+ openUpgrade.mockReset();+ getGettingStarted.mockResolvedValue(started({ confirmedAt: null }));+ await render(true);+ expect(pageText()).not.toContain('secondBrand.title');+ await act(async () => buttonNamed('start.button')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('startGettingStarted');+ expect(startGettingStarted).not.toHaveBeenCalled();+ });+it('asks a manager whether to run it for a brand added beside others', async () => {getGettingStarted.mockResolvedValueOnce(started({ confirmedAt: null }))diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.tsxindex 69068b791..8452627cb 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/actions/page.tsx@@ -18,6 +18,7 @@ import {} from 'lucide-react';import { useBrandStore } from '@/stores/use-brand-store';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import type { Brand } from '@/types';import {deleteAction,@@ -513,6 +514,11 @@ function ActionsContent({ brand }: { brand: Brand }) {// and the brand's setup is incomplete, or after a skip.const [confirmingSkip, setConfirmingSkip] = useState(false);const [switching, setSwitching] = useState(false);+ // A read-only workspace (plan not active): Start and Skip open the upgrade+ // dialog instead (Skip without its question), and a new brand's question+ // doesn't open by itself: Start stays in the header for it.+ const { guard, isLocked } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// The new brand's question, once answered or closed, stays closed for// this visit, even when the answer couldn't be saved or read back: it// never traps anyone on the page.@@ -550,17 +556,23 @@ function ActionsContent({ brand }: { brand: Brand }) {variant="outline"size="sm"disabled={switching}- onClick={() => setConfirmingSkip(true)}+ onClick={guard(() => setConfirmingSkip(true), { action: tActions('skipGettingStarted') })}>{tStarted('skip.button')}</Button>) : // A new brand's question, once closed, leaves Start in its place.- (gettingStarted.asking ? askClosed : gettingStarted.needsSetup || gettingStarted.skipped) ? (+ (+ gettingStarted.asking+ ? askClosed || isLocked+ : gettingStarted.needsSetup || gettingStarted.skipped+ ) ? (<div className="flex flex-col items-end gap-1"><Buttonsize="sm"disabled={switching}- onClick={() => start((s) => tStarted('start.started', { count: s?.done ?? 0 }))}+ onClick={guard(() => start((s) => tStarted('start.started', { count: s?.done ?? 0 })), {+ action: tActions('startGettingStarted'),+ })}><Sparkles className="h-3.5 w-3.5" />{tStarted('start.button')}@@ -601,7 +613,7 @@ function ActionsContent({ brand }: { brand: Brand }) {{/* A brand added beside others asks before running it. */}<Dialog- open={canManage && Boolean(gettingStarted?.asking) && !askClosed}+ open={canManage && Boolean(gettingStarted?.asking) && !askClosed && !isLocked}onOpenChange={(open) => {if (!open) setAskClosed(true);}}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.test.tsxindex 5d3d0f163..f8760169d 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.test.tsx@@ -2,6 +2,7 @@ import { act, StrictMode } from 'react';import { createRoot } from 'react-dom/client';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import type { Brand } from '@/types';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';(globalThis as typeof globalThis & {@@ -32,16 +33,17 @@ vi.mock('@/stores/use-brand-store', () => ({selector({ getActiveBrand: () => brand }),}));-const { getKpiSnapshots, seedKpiPresets, getKpiPresetPreview } = vi.hoisted(() => ({+const { getKpiSnapshots, seedKpiPresets, getKpiPresetPreview, removeKpi } = vi.hoisted(() => ({getKpiSnapshots: vi.fn(),seedKpiPresets: vi.fn(),getKpiPresetPreview: vi.fn(),+ removeKpi: vi.fn(),}));vi.mock('@/lib/actions/kpis', () => ({getKpiSnapshots,seedKpiPresets,getKpiPresetPreview,- removeKpi: vi.fn(),+ removeKpi,}));let canManage = true;@@ -99,12 +101,19 @@ const snapshot = (key: string) => ({status: 'on_track',});-async function renderPage() {+const openUpgrade = vi.fn();+async function renderPage(isLocked = false) {const container = document.createElement('div');document.body.append(container);const root = createRoot(container);await act(async () => {- root.render(<ActionCenterKpisPage />);+ root.render(+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ActionCenterKpisPage />+ </UpgradeDialogContext.Provider>,+ );});return { container, root };}@@ -139,6 +148,7 @@ describe('the ready-made KPIs', () => {expect(seedKpiPresets).not.toHaveBeenCalled();expect(container.textContent).toContain('presets.preview');+ expect(container.textContent).not.toContain('presets.previewReadOnly');expect(container.textContent).not.toContain('editKpis');expect(container.textContent).not.toContain('addKpi');const props = KpiTable.mock.calls.at(-1)?.[0] as { onEdit?: unknown; kpis: unknown[] };@@ -147,6 +157,33 @@ describe('the ready-made KPIs', () => {await act(async () => root.unmount());});+ // next-intl is mocked: the upgrade dialog's label is its key.+ it('saves nothing on a read-only workspace: the set shows unsaved, as to a member', async () => {+ getKpiSnapshots.mockResolvedValue({ configured: false, kpis: [], everSetUp: false });+ getKpiPresetPreview.mockResolvedValue([snapshot('mentions')]);+ const { container, root } = await renderPage(true);+ expect(seedKpiPresets).not.toHaveBeenCalled();+ // Not "saved the first time an admin opens this tab": an admin just did.+ expect(container.textContent).toContain('presets.previewReadOnly');+ await act(async () => root.unmount());+ });++ it('edits and removes nothing on a read-only workspace: the upgrade dialog instead', async () => {+ openUpgrade.mockReset();+ getKpiSnapshots.mockResolvedValue({ configured: true, kpis: [snapshot('mentions')] });+ const { container, root } = await renderPage(true);+ const edit = [...container.querySelectorAll('button')].find(+ (b) => b.textContent === 'editKpis',+ )!;+ await act(async () => edit.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('editKpis');+ const props = KpiTable.mock.calls.at(-1)?.[0] as { onRemove: (key: string) => void };+ await act(async () => props.onRemove('mentions'));+ expect(openUpgrade).toHaveBeenLastCalledWith('removeKpis');+ expect(removeKpi).not.toHaveBeenCalled();+ await act(async () => root.unmount());+ });+it('leaves the empty state to a brand whose KPIs were all removed', async () => {getKpiSnapshots.mockResolvedValue({ configured: false, kpis: [], everSetUp: true });const { container, root } = await renderPage();diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.tsxindex 8aeb82fa6..b76b61e12 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/kpis/page.tsx@@ -5,6 +5,7 @@ import { useTranslations } from 'next-intl';import { toast } from 'sonner';import { AlertCircle, ListFilter, Plus, Settings2, Sparkles, Target, X } from 'lucide-react';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { useBrandStore } from '@/stores/use-brand-store';import type { Brand } from '@/types';import {@@ -75,6 +76,11 @@ function KpisContent({ brand }: { brand: Brand }) {const tCategories = useTranslations('actionCenter.categories');const { canManage } = useUserRole();+ // A read-only workspace (plan not active): Edit, Add and Remove open the+ // upgrade dialog instead, and a brand that never had a KPI is shown the+ // ready-made set unsaved, as a member is.+ const { guard, isLocked } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [result, setResult] = useState<KpiSnapshotsResult | null>(null);// A brand that never had a KPI opens on the ready-made set: saved for an// admin or manager (and said so once), shown unsaved to everyone else.@@ -94,10 +100,13 @@ function KpisContent({ brand }: { brand: Brand }) {return { dayFrom: utcDay(days - 1), dayTo: utcDay() };}, [datePreset]);- const openDrawer = (key: KpiKey | null = null) => {- setEditKey(key);- setIsDrawerOpen(true);- };+ const openDrawer = guard(+ (key: KpiKey | null = null) => {+ setEditKey(key);+ setIsDrawerOpen(true);+ },+ { action: tActions('editKpis') },+ );const load = useCallback(async () => {setIsLoading(true);@@ -106,7 +115,7 @@ function KpisContent({ brand }: { brand: Brand }) {let next = await getKpiSnapshots(brand.id, window);let unsaved: KpiSnapshot[] | null = null;if (!next.configured && next.everSetUp === false) {- if (canManage) {+ if (canManage && !isLocked) {// Once per brand (00163): a failed setup leaves the empty state.// Read again either way: a colleague may have set it up meanwhile.// Only a setup that happened says so: a second read racing it (as@@ -125,7 +134,7 @@ function KpisContent({ brand }: { brand: Brand }) {} finally {setIsLoading(false);}- }, [brand.id, window, canManage]);+ }, [brand.id, window, canManage, isLocked]);useEffect(() => {void load();@@ -229,7 +238,11 @@ function KpisContent({ brand }: { brand: Brand }) {{(justSetUp || previewing) && (<div className="flex items-start gap-3 rounded-lg border bg-muted/40 px-4 py-3 text-sm"><Sparkles className="mt-0.5 h-4 w-4 shrink-0 text-muted-foreground" aria-hidden />- <p className="flex-1">{previewing ? t('presets.preview') : t('presets.setUp')}</p>+ <p className="flex-1">+ {previewing+ ? t(isLocked ? 'presets.previewReadOnly' : 'presets.preview')+ : t('presets.setUp')}+ </p>{justSetUp && (<buttontype="button"@@ -331,7 +344,11 @@ function KpisContent({ brand }: { brand: Brand }) {<KpiTablekpis={visible}onEdit={previewing ? undefined : (key) => openDrawer(key)}- onRemove={previewing ? undefined : (key) => void handleRemove(key)}+ onRemove={+ previewing+ ? undefined+ : guard((key: KpiKey) => void handleRemove(key), { action: tActions('removeKpis') })+ }busyKey={busyKey}/>) : kpis.length > 0 ? (diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.test.tsxindex 39e563438..724ed69e1 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../../messages/en.json';import { parseTaskDetails } from '@/lib/action-center/task-details';import type { TaskReview } from '@/lib/actions/action-task-reviews';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** Needs review (AC-010): an admin or a manager fills what an agent's task@@ -67,12 +68,17 @@ const review: TaskReview = {let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();-async function render() {+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <ActionCenterReviewPage />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ActionCenterReviewPage />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -204,6 +210,18 @@ describe('Needs review', () => {expect(container.textContent).toContain('Nothing waits for review');});+ it('approves and dismisses nothing on a read-only workspace: the upgrade dialog instead', async () => {+ await render(true);+ act(() => button('Edit')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Approving tasks needs a plan');+ expect(button('Approve')).toBeUndefined();+ act(() => button('Dismiss')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Dismissing tasks needs a plan');+ expect(container.textContent).not.toContain("Dismiss this task? It won't reach the action.");+ expect(approveTaskReview).not.toHaveBeenCalled();+ expect(dismissTaskReview).not.toHaveBeenCalled();+ });+it('reads nothing for someone who is not an admin or a manager', async () => {canManage = false;await render();diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.tsxindex f994701be..7b96546a0 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/review/page.tsx@@ -6,6 +6,7 @@ import { toast } from 'sonner';import { ArrowUpRight } from 'lucide-react';import { Link } from '@/i18n/navigation';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { useBrandStore } from '@/stores/use-brand-store';import {approveTaskReview,@@ -56,6 +57,10 @@ function ReviewContent({ brandId }: { brandId: string }) {const [editing, setEditing] = useState<string | null>(null);const [dismissing, setDismissing] = useState<string | null>(null);const [busy, setBusy] = useState<string | null>(null);+ // A read-only workspace (plan not active): Edit (which approves) and Dismiss+ // open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async () => {try {@@ -188,7 +193,7 @@ function ReviewContent({ brandId }: { brandId: string }) {<TaskDetailViewdetails={review.details}disabled={busy !== null}- onEdit={() => setEditing(review.id)}+ onEdit={guard(() => setEditing(review.id), { action: tActions('approveTasks') })}/>)}{editing !== review.id && (@@ -223,7 +228,9 @@ function ReviewContent({ brandId }: { brandId: string }) {variant="ghost"size="sm"disabled={busy !== null}- onClick={() => setDismissing(review.id)}+ onClick={guard(() => setDismissing(review.id), {+ action: tActions('dismissTasks'),+ })}className="h-7 text-xs text-muted-foreground">{t('dismiss')}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/action-center/signals/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/action-center/signals/page.tsxindex 796361adb..3681fb603 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/action-center/signals/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/action-center/signals/page.tsx@@ -58,6 +58,7 @@ import { readUrlChoice, readUrlParam, writeUrlParams } from '@/lib/url-state';import type { KpiTrendPoint } from '@/lib/actions/kpis';import { signalChangeTone, signedPercent, type SignalMetric } from '@/lib/signals/metrics';import { HeaderWithAiUsage } from '@/components/ai-usage/ai-usage-meter';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';const SIGNAL_EXPORT_HEADERS = ['title',@@ -125,6 +126,10 @@ export default function ActionCenterSignalsPage() {function SignalsContent({ brand }: { brand: Brand }) {const t = useTranslations('actionCenter.signalsPage');+ // A read-only workspace (plan not active): a signal's status, from its row,+ // group or drawer, opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const common = useTranslations('common');const tTexts = useTranslations('actionCenter.signalTexts');const tCategories = useTranslations('actionCenter.signalCategories');@@ -585,7 +590,10 @@ function SignalsContent({ brand }: { brand: Brand }) {<SignalTablegroups={groups}onSelect={selectSignal}- onStatusChange={(targets, next) => void handleStatusChange(targets, next)}+ onStatusChange={guard(+ (targets: Signal[], next: SignalStatus) => void handleStatusChange(targets, next),+ { action: tActions('changeSignalStatus') },+ )}busyIds={busyIds}selectedId={selected?.id ?? null}/>@@ -604,7 +612,10 @@ function SignalsContent({ brand }: { brand: Brand }) {onOpenChange={(open) => {if (!open) selectSignal(null);}}- onStatusChange={(signal, next) => void handleStatusChange([signal], next)}+ onStatusChange={guard(+ (signal: Signal, next: SignalStatus) => void handleStatusChange([signal], next),+ { action: tActions('changeSignalStatus') },+ )}isBusy={selected ? busyIds.has(selected.id) : false}/></div>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/agent/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/agent/page.test.tsxnew file mode 100644index 000000000..dfbf3edcf--- /dev/null+++ b/web/src/app/[locale]/(dashboard)/dashboard/agent/page.test.tsx@@ -0,0 +1,157 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Chat on a read-only workspace (plan not active): New chat and sending open+ * the upgrade dialog, named, and send nothing. The conversations still list+ * and open, and deleting one stays open, as its route does.+ */++const chat = vi.hoisted(() => ({+ sendMessage: vi.fn(),+ setMessages: vi.fn(),+ stop: vi.fn(),+ clearError: vi.fn(),+}));+vi.mock('@ai-sdk/react', () => ({+ useChat: () => ({ messages: [], status: 'ready', error: undefined, ...chat }),+}));+vi.mock('ai', () => ({ DefaultChatTransport: class {} }));+vi.mock('next/dynamic', () => ({ default: () => () => null }));+vi.mock('@/hooks/use-feature-gate', () => ({+ useFeatureGate: () => ({ canUse: () => true, requiredPlanFor: () => 'Starter', isCloud: false }),+}));+vi.mock('@/stores/use-brand-store', () => ({+ useBrandStore: (select: (state: unknown) => unknown) => select({ activeBrandId: 'b1' }),+}));+vi.mock('@/i18n/navigation', () => ({+ Link: ({ href, children }: { href: string; children?: React.ReactNode }) => (+ <a href={href}>{children}</a>+ ),+}));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { default: AgentPage } = await import('./page');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();+const fetchMock = vi.fn();+const originalScrollIntoView = Element.prototype.scrollIntoView;++const json = (body: unknown) =>+ new Response(JSON.stringify(body), { headers: { 'Content-Type': 'application/json' } });++beforeEach(() => {+ vi.clearAllMocks();+ fetchMock.mockImplementation(async (url: string) =>+ url === '/api/agent/conversations'+ ? json({+ conversations: [+ {+ id: 'c1',+ title: 'Pricing questions',+ brand_id: 'b1',+ created_at: '2026-10-27',+ updated_at: '2026-10-27',+ },+ ],+ })+ : json({ messages: [] }),+ );+ vi.stubGlobal('fetch', fetchMock);+ Element.prototype.scrollIntoView = vi.fn();+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+ vi.unstubAllGlobals();+ Element.prototype.scrollIntoView = originalScrollIntoView;+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AgentPage />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const button = (text: string) =>+ [...container.querySelectorAll('button')].find((b) => b.textContent?.trim() === text)!;+const remove = () =>+ container.querySelector<HTMLButtonElement>('button[aria-label="Delete conversation"]')!;+const writes = () => fetchMock.mock.calls.filter(([, init]) => init?.method);++async function send(text: string) {+ const input = container.querySelector('textarea')!;+ await act(async () => {+ Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')!.set!.call(input, text);+ input.dispatchEvent(new Event('input', { bubbles: true }));+ });+ await act(async () => {+ container+ .querySelector('form')!+ .dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));+ });+}++describe('Chat on a read-only workspace', () => {+ it('starts and sends nothing: each opens the upgrade dialog', async () => {+ await render(true);+ expect(container.textContent).toContain('Pricing questions');++ await act(async () => button('New chat').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Starting a chat needs a plan');+ await send('How do we rank?');+ expect(openUpgrade).toHaveBeenLastCalledWith('Chatting with the agent needs a plan');++ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(document.querySelector('[role="dialog"]')).toBeNull();+ expect(chat.sendMessage).not.toHaveBeenCalled();+ expect(writes()).toEqual([]);+ });++ it.each([true, false])(+ 'asks before deleting a conversation, read-only or not (locked: %s)',+ async (isLocked) => {+ await render(isLocked);+ await act(async () => remove().click());+ expect(document.querySelector('[role="dialog"]')?.textContent).toContain(+ 'Delete conversation',+ );+ expect(openUpgrade).not.toHaveBeenCalled();+ },+ );++ it('still deletes a conversation on a read-only workspace, after its confirm', async () => {+ await render(true);+ await act(async () => remove().click());+ const dialog = document.querySelector('[role="dialog"]')!;+ const confirm = [...dialog.querySelectorAll('button')].find(+ (b) => b.textContent?.trim() === 'Delete',+ )!;+ await act(async () => confirm.click());+ expect(writes()).toEqual([['/api/agent/conversations/c1', { method: 'DELETE' }]]);+ expect(container.textContent).not.toContain('Pricing questions');+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/agent/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/agent/page.tsxindex 3ceb8d284..6ca7f8ae0 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/agent/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/agent/page.tsx@@ -154,6 +154,7 @@ function AgentChat(props: {const [pendingConfirm, setPendingConfirm] = useState<string | null>(null);// A chat turn is an action: a read-only workspace gets the upgrade dialog.const { isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Ref mirrors activeId for prepareSendMessagesRequest. Reading the// state directly from the transport closure gives us a stale snapshot —@@ -269,7 +270,7 @@ function AgentChat(props: {async function newChat() {if (isLocked) {- openUpgrade();+ openUpgrade(tActions('startChat'));return;}const res = await fetch('/api/agent/conversations', {@@ -315,7 +316,7 @@ function AgentChat(props: {const text = input.trim();if (!text || status !== 'ready') return;if (isLocked) {- openUpgrade();+ openUpgrade(tActions('sendChat'));return;}@@ -397,6 +398,8 @@ function AgentChat(props: {type="button"onClick={(e) => {e.stopPropagation();+ // Open in read-only too: deleting a conversation costs nothing+ // and the API (#1613) and the FAQ keep it open.setPendingConfirm(c.id);}}className="opacity-0 group-hover:opacity-100 text-muted-foreground hover:text-destructive transition-opacity"diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/[id]/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/[id]/page.tsxindex 3166ede56..c3b6b05b7 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/[id]/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/[id]/page.tsx@@ -21,6 +21,7 @@ import {import { getAudit, runAudit, deleteAudit, type AuditResult } from '@/lib/actions/audits';import { AuditReport } from '@/components/audit/audit-report';import { HeaderWithAiUsage } from '@/components/ai-usage/ai-usage-meter';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';export default function AuditDetailPage() {const params = useParams();@@ -28,6 +29,10 @@ export default function AuditDetailPage() {const t = useTranslations('audit');const router = useRouter();const tFailed = t('failed');+ // A read-only workspace (plan not active): Re-audit and Delete open the+ // upgrade dialog instead (Delete without its confirm).+ const { guard, isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [audit, setAudit] = useState<AuditResult | null>(null);const [loading, setLoading] = useState(true);@@ -153,7 +158,7 @@ export default function AuditDetailPage() {size="icon"className="h-8 w-8 text-muted-foreground hover:text-foreground"disabled={rerunning}- onClick={handleRefresh}+ onClick={guard(handleRefresh, { action: tActions('runAudit') })}aria-label={t('reaudit')}>{rerunning ? (@@ -162,7 +167,13 @@ export default function AuditDetailPage() {<RefreshCw className="h-3.5 w-3.5" />)}</Button>- <Dialog>+ <Dialog+ onOpenChange={(open, details) => {+ if (!open || !isLocked) return;+ details.cancel();+ openUpgrade(tActions('deleteAudits'));+ }}+ ><DialogTriggerrender={<Buttondiff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.test.tsxindex 0d800800a..666e5f43e 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';import type { AuditedPage, AuditTemplate } from '@/lib/actions/audits';import { AuditPagesTable, groupPagesByTemplate, pageLabel } from './_pages-table';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';(globalThis as typeof globalThis & {@@ -65,6 +66,7 @@ let root: Root;const onLoadMore = vi.fn();const onDeleteRun = vi.fn();const onSelect = vi.fn();+const openUpgrade = vi.fn();function render(pages: AuditedPage[],@@ -73,24 +75,29 @@ function render(selected = new Set<string>(),toolbar = null as React.ReactNode,templates = null as AuditTemplate[] | null,+ isLocked = false,} = {},) {act(() => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <AuditPagesTable- pages={pages}- total={total}- primaryHost="acme.com"- loadingMore={false}- onLoadMore={onLoadMore}- onDeleteRun={onDeleteRun}- selected={selected}- onSelect={onSelect}- headerAction={<button type="button">Export all</button>}- toolbar={toolbar}- templates={templates}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AuditPagesTable+ pages={pages}+ total={total}+ primaryHost="acme.com"+ loadingMore={false}+ onLoadMore={onLoadMore}+ onDeleteRun={onDeleteRun}+ selected={selected}+ onSelect={onSelect}+ headerAction={<button type="button">Export all</button>}+ toolbar={toolbar}+ templates={templates}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -175,6 +182,26 @@ describe('AuditPagesTable', () => {expect(document.getElementById(arrow.getAttribute('aria-controls')!)).toBeNull();});+ it('deletes no run on a read-only workspace: the upgrade dialog opens, not the confirm', () => {+ render([page()], 1, { isLocked: true });+ act(() => (container.querySelector('button[aria-expanded]') as HTMLButtonElement).click());+ const remove = container.querySelector<HTMLButtonElement>('button[aria-label="Delete audit"]')!;+ act(() => remove.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Deleting an audit needs a plan');+ expect(document.querySelector('[role="dialog"]')).toBeNull();+ expect(onDeleteRun).not.toHaveBeenCalled();+ });++ it('asks before deleting a run on an active plan', () => {+ render([page()]);+ act(() => (container.querySelector('button[aria-expanded]') as HTMLButtonElement).click());+ act(() =>+ container.querySelector<HTMLButtonElement>('button[aria-label="Delete audit"]')!.click(),+ );+ expect(document.querySelector('[role="dialog"]')).not.toBeNull();+ expect(openUpgrade).not.toHaveBeenCalled();+ });+it('says how many older audits the history leaves out', () => {render([page({ runCount: 53 })]);act(() => (container.querySelector('button[aria-expanded]') as HTMLButtonElement).click());diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.tsxindex af458c04c..63ec27cdf 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_pages-table.tsx@@ -30,6 +30,7 @@ import { pct, scoreColor } from '@/components/audit/audit-report';import type { AuditedPage, AuditedPageStatus, AuditRun, AuditTemplate } from '@/lib/actions/audits';import { formatDate, formatDateTime, formatNumber } from '@/lib/format';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** The shown pages by template (SA-007's Group by template): the templates in@@ -112,6 +113,9 @@ function StatusPill({ status }: { status: AuditedPageStatus }) {function HistoryRun({ run, onDelete }: { run: AuditRun; onDelete: (id: string) => void }) {const t = useTranslations('audit');+ // A read-only workspace (plan not active): the upgrade dialog instead of the confirm.+ const { isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');return (<li className="flex items-center gap-3 px-3 py-1.5 text-sm"><span className="w-48 shrink-0 text-muted-foreground">{formatDateTime(run.createdAt)}</span>@@ -126,7 +130,13 @@ function HistoryRun({ run, onDelete }: { run: AuditRun; onDelete: (id: string) =<Link href={`/dashboard/audit/${run.id}`} className="text-primary hover:underline">{t('pages.viewReport')}</Link>- <Dialog>+ <Dialog+ onOpenChange={(open, details) => {+ if (!open || !isLocked) return;+ details.cancel();+ openUpgrade(tActions('deleteAudits'));+ }}+ ><DialogTriggerrender={<Buttondiff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.test.tsxindex 7184a93fd..42568acf6 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';import type { AuditAutoStatus, AuditSettings, AutoAuditRun } from '@/lib/actions/audits';import { AuditSettingsDialog, parsePatterns } from './_settings-dialog';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';(globalThis as typeof globalThis & {@@ -35,6 +36,7 @@ let container: HTMLDivElement;let root: Root;const onSaved = vi.fn();const onOpenChange = vi.fn();+const openUpgrade = vi.fn();/** A billing month from Sep 22 to Oct 22 whose last run (day 28, Oct 19) is done. */const schedule = (enabled = true): AuditAutoStatus => ({@@ -71,20 +73,25 @@ const latestRun: AutoAuditRun = {async function render(canManage = true,timing?: { schedule: AuditAutoStatus; latestRun: AutoAuditRun | null },+ isLocked = false,) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <AuditSettingsDialog- brandId={BRAND}- open- onOpenChange={onOpenChange}- canManage={canManage}- onSaved={onSaved}- schedule={timing?.schedule}- latestRun={timing?.latestRun}- now={new Date('2026-10-19T12:00:00Z')}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AuditSettingsDialog+ brandId={BRAND}+ open+ onOpenChange={onOpenChange}+ canManage={canManage}+ onSaved={onSaved}+ schedule={timing?.schedule}+ latestRun={timing?.latestRun}+ now={new Date('2026-10-19T12:00:00Z')}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -155,6 +162,19 @@ describe('AuditSettingsDialog', () => {expect(onOpenChange).toHaveBeenCalledWith(false);});+ it('opens to read on a read-only workspace; Save and Unpin open the upgrade dialog', async () => {+ await render(true, undefined, true);+ const [auto] = dialog().querySelectorAll('[role="checkbox"]');+ act(() => (auto as HTMLElement).click());+ await act(async () => button('Save').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Saving the audit settings needs a plan');+ await act(async () => button('Unpin').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Unpinning pages needs a plan');+ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(actions.saveAuditSettings).not.toHaveBeenCalled();+ expect(actions.setOpportunityPrefs).not.toHaveBeenCalled();+ });+it("shows the server's message when a pattern is refused", async () => {actions.saveAuditSettings.mockRejectedValue(new Error('"careers" isn\'t a page path. Start it with /, as in /legal/*.'),diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.tsxindex 439614c20..56524a0ec 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_settings-dialog.tsx@@ -26,6 +26,7 @@ import {type AutoAuditRun,} from '@/lib/actions/audits';import { nextAutoRun } from '@/lib/audit-auto-runs';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { formatMonthDay, formatNumber } from '@/lib/format';/** One pattern per line, blank lines dropped. */@@ -83,6 +84,10 @@ export function AuditSettingsDialog({now?: Date;}) {const t = useTranslations('audit.settings');+ // A read-only workspace (plan not active): the settings open to read; Save+ // and Unpin open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [settings, setSettings] = useState<AuditSettings | null>(null);const [autoAudit, setAutoAudit] = useState(false);const [emailAfterRun, setEmailAfterRun] = useState(false);@@ -258,7 +263,9 @@ export function AuditSettingsDialog({<Buttonvariant="ghost"size="sm"- onClick={() => handleUnpin(page.url)}+ onClick={guard(() => void handleUnpin(page.url), {+ action: tActions('unpinPages'),+ })}disabled={unpinning !== null}>{unpinning === page.url && (@@ -282,7 +289,10 @@ export function AuditSettingsDialog({<Button variant="outline" onClick={() => onOpenChange(false)}>{t('cancel')}</Button>- <Button onClick={handleSave} disabled={!canManage || !changed || saving}>+ <Button+ onClick={guard(handleSave, { action: tActions('saveAuditSettings') })}+ disabled={!canManage || !changed || saving}+ >{saving && <Loader2 className="h-4 w-4 animate-spin" />}{t('save')}</Button>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.test.tsxindex 6a8d787b1..6c65ffff2 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';import type { SiteTrust } from '@/lib/content/site-trust';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const getSiteTrust = vi.fn();vi.mock('@/lib/actions/audits', () => ({@@ -37,19 +38,25 @@ const TRUST: SiteTrust = {let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();beforeEach(() => {getSiteTrust.mockReset().mockResolvedValue(TRUST);+ openUpgrade.mockReset();container = document.createElement('div');root = createRoot(container);});afterEach(() => act(() => root.unmount()));-async function render(now?: Date) {+async function render(now?: Date, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC" now={now}>- <SiteTrustCard brandId="b1" />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <SiteTrustCard brandId="b1" />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -132,6 +139,25 @@ describe('SiteTrustCard', () => {}});+ it('reads nothing again on a read-only workspace: no partial re-read, Check again opens the upgrade dialog', async () => {+ vi.useFakeTimers({ toFake: ['Date', 'setInterval', 'clearInterval'] });+ try {+ vi.setSystemTime(new Date('2026-10-23T12:04:00.000Z'));+ getSiteTrust.mockResolvedValue({ ...TRUST, complete: false });+ await render(undefined, true);+ expect(getSiteTrust).toHaveBeenCalledTimes(1);++ await act(async () => vi.advanceTimersByTime(6 * 60 * 1000));+ expect(getSiteTrust).toHaveBeenCalledTimes(1);+ expect(checkAgain().disabled).toBe(false);+ await act(async () => checkAgain().click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Checking site trust again needs a plan');+ expect(getSiteTrust).toHaveBeenCalledTimes(1);+ } finally {+ vi.useRealTimers();+ }+ });+it('asks for authors first when there are none', async () => {getSiteTrust.mockResolvedValue({...TRUST,diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.tsxindex 8b452c82a..dcad1506c 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/_site-trust-card.tsx@@ -14,6 +14,7 @@ import {type SiteTrustCheck,} from '@/lib/content/site-trust';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Site trust (Content Editor Quality spec §8, CE-043): the brand's five@@ -27,6 +28,11 @@ export function SiteTrustCard({ brandId }: { brandId: string }) {const [trust, setTrust] = useState<SiteTrust | null>(null);const [failed, setFailed] = useState(false);const [checking, setChecking] = useState(false);+ // A read-only workspace (plan not active): Check again reads the site+ // again, a cost; it opens the upgrade dialog instead, and a partial read+ // isn't read again on its own.+ const { guard, isLocked } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async (refresh: boolean) => {@@ -53,11 +59,11 @@ export function SiteTrustCard({ brandId }: { brandId: string }) {const recheckAt = trust ? Date.parse(trust.checkedAt) + SITE_TRUST_RECHECK_MS : 0;const tooSoon = !!trust && now.getTime() < recheckAt;// A partial read (the site didn't answer all of it) is read again once- // that wait is over, as its rows say.+ // that wait is over, as its rows say; not while the workspace is read-only.const partial = trust?.complete === false;useEffect(() => {- if (partial && !tooSoon) void load(false);- }, [partial, tooSoon, load]);+ if (partial && !tooSoon && !isLocked) void load(false);+ }, [partial, tooSoon, isLocked, load]);// Quality's "Fix in Site Audit" lands here (#site-trust): once the card has// its read, and the cards above have theirs, it scrolls into view once.@@ -83,7 +89,7 @@ export function SiteTrustCard({ brandId }: { brandId: string }) {className="shrink-0"disabled={checking || !trust || tooSoon}aria-describedby={tooSoon ? 'site-trust-recheck' : undefined}- onClick={() => void load(true)}+ onClick={guard(() => void load(true), { action: tActions('checkSiteTrust') })}>{checking && <LoadingDots className="mr-1.5" />}{t('checkAgain')}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/page.test.tsxnew file mode 100644index 000000000..d079d7cd6--- /dev/null+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/page.test.tsx@@ -0,0 +1,144 @@+import { act, type ReactNode } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Site Audit on a read-only workspace (plan not active): Run audit, by its+ * button or Enter in the address, opens the upgrade dialog instead of+ * starting an audit. On an active plan it starts one and opens it.+ */++const audits = vi.hoisted(() => ({+ runAudit: vi.fn(),+ runAuditsBulk: vi.fn(),+ getAuditPages: vi.fn(),+ getAuditHub: vi.fn(),+ getAuditHubExtras: vi.fn(),+ setOpportunityPrefs: vi.fn(),+ getAuditSettings: vi.fn(),+ getAuditTemplates: vi.fn(),+ saveAuditSettings: vi.fn(),+ deleteAudit: vi.fn(),+}));+vi.mock('@/lib/actions/audits', () => audits);+const brandState = vi.hoisted(() => ({+ activeBrandId: 'b1',+ brands: [{ id: 'b1', name: 'Acme', domains: [{ domain: 'acme.com', isPrimary: true }] }],+}));+vi.mock('@/stores/use-brand-store', () => ({+ useBrandStore: Object.assign((select: (state: unknown) => unknown) => select(brandState), {+ getState: () => brandState,+ }),+}));+vi.mock('@/hooks/use-user-role', () => ({ useUserRole: () => ({ canManage: true }) }));+const push = vi.hoisted(() => vi.fn());+vi.mock('@/i18n/navigation', () => ({ useRouter: () => ({ push }) }));+vi.mock('next/navigation', () => ({ useSearchParams: () => new URLSearchParams() }));+vi.mock('@/components/ai-usage/ai-usage-meter', () => ({+ HeaderWithAiUsage: ({ children }: { children: ReactNode }) => <div>{children}</div>,+}));+// The page's cards and lists have tests of their own; here they stay out of the way.+vi.mock('./_site-trust-card', () => ({ SiteTrustCard: () => null }));+vi.mock('./_charts', () => ({ ScoreTrendChart: () => null }));+vi.mock('./_pages-table', () => ({ AuditPagesTable: () => null }));+vi.mock('./_bulk-bar', () => ({ AuditBulkBar: () => null, ExportMenu: () => null }));+vi.mock('./_overview-cards', () => ({ AuditOverviewCards: () => null }));+vi.mock('./_opportunities-table', () => ({+ OpportunitiesTable: () => null,+ opportunityAuditUrls: () => [],+}));+vi.mock('./_settings-dialog', () => ({ AuditSettingsDialog: () => null }));+vi.mock('./_auto-run-notice', () => ({ AutoRunNotice: () => null }));+vi.mock('./_summary-strip', () => ({ AuditSummaryStrip: () => null }));+vi.mock('./_quota-meter', () => ({ EmptyPoolMessage: () => null }));+vi.mock('./_use-pages-export', () => ({+ usePagesExport: () => ({ exporting: false, exportAll: vi.fn(), exportPages: vi.fn() }),+}));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { default: SiteAuditPage } = await import('./page');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ audits.getAuditHub.mockResolvedValue({+ pages: { pages: [], total: 0, primaryHost: 'acme.com' },+ quota: { used: 0, limit: 10, remaining: 10 },+ trend: null,+ overview: null,+ });+ audits.getAuditHubExtras.mockResolvedValue({+ opportunities: { opportunities: [], excluded: [] },+ latestRun: null,+ });+ audits.runAudit.mockResolvedValue({ id: 'a1' });+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <SiteAuditPage />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const runButton = () =>+ [...container.querySelectorAll('button')].find((b) => b.textContent === 'Run Audit')!;+const pressEnter = () =>+ act(async () => {+ container+ .querySelector('input[aria-label="Website URL"]')!+ .dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));+ });++describe('SiteAuditPage Run audit', () => {+ it('starts no audit on a read-only workspace: the button and Enter open the upgrade dialog', async () => {+ await render(true);+ await act(async () => runButton().click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Running an audit needs a plan');+ await pressEnter();+ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(openUpgrade).toHaveBeenLastCalledWith('Running an audit needs a plan');+ expect(audits.runAudit).not.toHaveBeenCalled();+ expect(push).not.toHaveBeenCalled();+ });++ it('starts an audit on the button on an active plan, and opens it', async () => {+ await render(false);+ await act(async () => runButton().click());+ expect(audits.runAudit).toHaveBeenCalledExactlyOnceWith('b1', 'https://acme.com');+ expect(push).toHaveBeenCalledWith('/dashboard/audit/a1');+ expect(openUpgrade).not.toHaveBeenCalled();+ });++ it('starts an audit on Enter on an active plan', async () => {+ await render(false);+ await pressEnter();+ expect(audits.runAudit).toHaveBeenCalledExactlyOnceWith('b1', 'https://acme.com');+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/audit/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/audit/page.tsxindex 1dffa900b..cf31e9407 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/audit/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/audit/page.tsx@@ -26,6 +26,7 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs';import { qualityPhase } from '@/lib/content/quality';import { useBrandStore } from '@/stores/use-brand-store';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {runAudit,runAuditsBulk,@@ -93,6 +94,11 @@ export default function SiteAuditPage() {const router = useRouter();const activeBrandId = useBrandStore((s) => s.activeBrandId);const { canManage } = useUserRole();+ // A read-only workspace (plan not active): Run audit, the bulk bars' Audit,+ // Pin, Exclude and Restore, and deleting a run open the upgrade dialog+ // instead; the settings open to read, and their Save asks too.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Prefill the URL with the active brand's primary domain (read once at init).const [url, setUrl] = useState(() => {@@ -271,26 +277,29 @@ export default function SiteAuditPage() {(pct(dailyPoints[0].totalScore) ?? 0): null;- const handleRun = async () => {- if (!activeBrandId) {- toast.error(t('noBrand'));- return;- }- if (!url.trim()) {- toast.error(t('urlRequired'));- return;- }- setRunning(true);- try {- // POST returns immediately with a running row; navigate to its detail- // page, which polls until the audit completes.- const started = await runAudit(activeBrandId, url.trim());- router.push(`/dashboard/audit/${started.id}`);- } catch (err) {- toast.error(err instanceof Error ? err.message : t('failed'));- setRunning(false);- }- };+ const handleRun = guard(+ async () => {+ if (!activeBrandId) {+ toast.error(t('noBrand'));+ return;+ }+ if (!url.trim()) {+ toast.error(t('urlRequired'));+ return;+ }+ setRunning(true);+ try {+ // POST returns immediately with a running row; navigate to its detail+ // page, which polls until the audit completes.+ const started = await runAudit(activeBrandId, url.trim());+ router.push(`/dashboard/audit/${started.id}`);+ } catch (err) {+ toast.error(err instanceof Error ? err.message : t('failed'));+ setRunning(false);+ }+ },+ { action: tActions('runAudit') },+ );// Append the next page of the Pages list. Dedupe by page: a page audited// since the first read moves to the top and shifts offsets by one.@@ -814,7 +823,9 @@ export default function SiteAuditPage() {staleDays={opps.staleDays}selected={oppSelected}onSelect={handleOppSelect}- onRestore={(urls) => void handleRestore(urls)}+ onRestore={guard((urls: string[]) => void handleRestore(urls), {+ action: tActions('restorePages'),+ })}toolbar={selectedOpps.length > 0 && (<AuditBulkBar@@ -823,7 +834,7 @@ export default function SiteAuditPage() {quota={quota}starting={startingBulk}auditLabel={t('opportunities.auditSelected')}- onAudit={handleAuditOpps}+ onAudit={guard(handleAuditOpps, { action: tActions('auditPages') })}onClear={() => setOppSelected(new Set())}><Button@@ -831,7 +842,9 @@ export default function SiteAuditPage() {size="sm"className="h-7 gap-1.5 text-xs"disabled={selectedOppUrls.length === 0}- onClick={() => void handlePin()}+ onClick={guard(() => void handlePin(), {+ action: tActions(allPinned ? 'unpinPages' : 'pinPages'),+ })}><Pin className="h-3 w-3" />{allPinned ? t('opportunities.unpin') : t('opportunities.pin')}@@ -840,7 +853,9 @@ export default function SiteAuditPage() {variant="outline"size="sm"className="h-7 gap-1.5 text-xs"- onClick={() => void handleExclude()}+ onClick={guard(() => void handleExclude(), {+ action: tActions('excludePages'),+ })}><EyeOff className="h-3 w-3" />{t('opportunities.exclude')}@@ -891,7 +906,7 @@ export default function SiteAuditPage() {count={selectedPages.length}quota={quota}starting={startingBulk}- onAudit={handleBulkReaudit}+ onAudit={guard(handleBulkReaudit, { action: tActions('auditPages') })}onExport={(format) => exportPages(selectedPages, format)}onClear={() => setSelected(new Set())}/>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.test.tsxindex 7cbb63e7a..76a4c6a80 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../../../messages/en.json';import type { BrandFact, BrandFactsRead } from '@/lib/content/brand-facts';import { BrandFactsTab } from './_brand-facts-tab';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const getBrandFacts = vi.fn();const readBrandFactsAgain = vi.fn();@@ -97,11 +98,16 @@ const READ: BrandFactsRead = {let container: HTMLDivElement;let root: Root;-const render = async () => {+const openUpgrade = vi.fn();+const render = async (isLocked = false) => {await act(async () =>root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <BrandFactsTab brandId="b1" />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <BrandFactsTab brandId="b1" />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,),);@@ -176,6 +182,15 @@ describe('BrandFactsTab', () => {expect(approved.textContent).not.toContain('$59 per month');});+ it('reviews nothing on a read-only workspace: Approve opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ await render(true);+ await act(async () => button('Approve', section('To approve (1)'))!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Reviewing brand facts needs a plan');+ expect(setBrandFactStatus).not.toHaveBeenCalled();+ expect(section('To approve (1)')).toBeDefined();+ });+it('reads the list again when a review fails (a read removed the fact meanwhile)', async () => {await render();setBrandFactStatus.mockResolvedValue({ error: 'failed' });diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.tsxindex b288805fa..dd11da325 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_brand-facts-tab.tsx@@ -16,6 +16,7 @@ import {type FactStatus,} from '@/lib/content/brand-facts';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Brand settings › Brand facts (Quality spec §10, CE-047): the facts the API@@ -35,6 +36,10 @@ export function BrandFactsTab({ brandId }: { brandId: string }) {const [reading, setReading] = useState(false);const [busy, setBusy] = useState<string | null>(null);const ids = useId();+ // A read-only workspace (plan not active): Approve, Reject and Read again+ // (it reads the site) open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');useEffect(() => {let cancelled = false;@@ -177,7 +182,9 @@ export function BrandFactsTab({ brandId }: { brandId: string }) {className="h-7"disabled={busy !== null || reading}aria-label={t('approveFact', { fact: valueOf(fact) })}- onClick={() => void review(fact, 'approved')}+ onClick={guard(() => void review(fact, 'approved'), {+ action: tActions('reviewBrandFacts'),+ })}>{t('approve')}</Button>@@ -189,7 +196,9 @@ export function BrandFactsTab({ brandId }: { brandId: string }) {className="h-7"disabled={busy !== null || reading}aria-label={t('rejectFact', { fact: valueOf(fact) })}- onClick={() => void review(fact, 'rejected')}+ onClick={guard(() => void review(fact, 'rejected'), {+ action: tActions('reviewBrandFacts'),+ })}>{t('reject')}</Button>@@ -253,7 +262,7 @@ export function BrandFactsTab({ brandId }: { brandId: string }) {variant="outline"disabled={!canReadAgain}title={canReadAgain ? undefined : t('readAgainSoon')}- onClick={() => void readAgain()}+ onClick={guard(() => void readAgain(), { action: tActions('readBrandFacts') })}>{reading && <LoadingDots />}{t('readAgain')}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.test.tsxindex 49b3f378a..1a35899cb 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../../../messages/en.json';import type { Brand } from '@/types';import { ConversionsCard } from './_conversions-card';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const updateBrand = vi.hoisted(() => vi.fn());vi.mock('@/lib/actions/brand', () => ({@@ -42,6 +43,7 @@ const brand = (over: Partial<Brand> = {}): Brand => ({let container: HTMLDivElement;let root: Root;const onUpdate = vi.fn();+const openUpgrade = vi.fn();beforeEach(() => {container = document.createElement('div');@@ -59,11 +61,15 @@ afterEach(() => {container.remove();});-async function render(over: Partial<Brand> = {}) {+async function render(over: Partial<Brand> = {}, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <ConversionsCard brand={brand(over)} onUpdate={onUpdate} />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ConversionsCard brand={brand(over)} onUpdate={onUpdate} />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -117,6 +123,17 @@ describe('ConversionsCard', () => {expect(container.textContent).toContain("What it can't see");});+ it('turns nothing on on a read-only workspace: the box opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ await render({}, true);+ await click(checkbox());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith(+ 'Changing conversion tracking needs a plan',+ );+ expect(updateBrand).not.toHaveBeenCalled();+ expect(codes()).toEqual([]);+ });+it('turns back what it couldn’t save, and says so', async () => {vi.spyOn(console, 'error').mockImplementation(() => {});updateBrand.mockRejectedValue(new Error('offline'));diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.tsxindex ff298492e..bffeb19bb 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/_conversions-card.tsx@@ -18,6 +18,7 @@ import {} from '@/components/ui/select';import { getPublicApiBaseUrl } from '@/config/api';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { updateBrand } from '@/lib/actions/brand';import {CONSENT_CALL,@@ -115,6 +116,10 @@ export function ConversionsCard({setConsent(brand.conversionsConsent ?? 'wait');}const [saving, setSaving] = useState(false);+ // A read-only workspace (plan not active): the box and the consent mode+ // open the upgrade dialog instead; the code to copy stays.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [showPixel, setShowPixel] = useState(siteTypeOf(brand) === 'ecommerce');const apiUrl = getPublicApiBaseUrl();const tag = trackingSnippetTag(apiUrl, brand.trackingCode, consent);@@ -168,7 +173,9 @@ export function ConversionsCard({id="conversions-on"checked={enabled}disabled={saving || !canManage}- onCheckedChange={(v) => void toggle(v === true)}+ onCheckedChange={guard((v: boolean) => void toggle(v === true), {+ action: tActions('changeConversions'),+ })}/><div className="min-w-0 space-y-1"><Label htmlFor="conversions-on" className="font-medium">@@ -188,9 +195,12 @@ export function ConversionsCard({items={consentItems}value={consent}disabled={saving || !canManage}- onValueChange={(v) => {- if (isConversionsConsent(v)) void pickConsent(v);- }}+ onValueChange={guard(+ (v: string | null) => {+ if (isConversionsConsent(v)) void pickConsent(v);+ },+ { action: tActions('changeConversions') },+ )}><SelectTrigger id="conversions-consent" className="w-full sm:w-96"><SelectValue />diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.test.tsxindex 0c7434974..56abfac09 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.test.tsx@@ -3,6 +3,7 @@ import { act } from 'react';import { createRoot } from 'react-dom/client';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import type { Brand } from '@/types';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';(globalThis as typeof globalThis & {@@ -68,9 +69,11 @@ vi.mock('@/hooks/use-feature-gate', () => ({const setBrandShoppingMode = vi.hoisted(() => vi.fn());const updateBrand = vi.hoisted(() => vi.fn());+const deleteBrand = vi.hoisted(() => vi.fn());+const setBrandActive = vi.hoisted(() => vi.fn());vi.mock('@/lib/actions/brand', () => ({- deleteBrand: vi.fn(),- setBrandActive: vi.fn(),+ deleteBrand,+ setBrandActive,setBrandShoppingMode,updateBrand,}));@@ -80,8 +83,9 @@ vi.mock('@/lib/actions/brand-domain', () => ({}));const getCompetitors = vi.hoisted(() => vi.fn());+const addCompetitor = vi.hoisted(() => vi.fn());vi.mock('@/lib/actions/competitor', () => ({- addCompetitor: vi.fn(),+ addCompetitor,deleteCompetitor: vi.fn(),getCompetitors: (...args: unknown[]) => getCompetitors(...args),}));@@ -385,3 +389,94 @@ describe('Brand facts tab (Quality CE-047)', () => {expect(container.querySelector('[data-testid="brand-facts"]')).toBeNull();});});++// A read-only workspace (plan not active): the settings show; every change+// opens the upgrade dialog, named (next-intl is mocked: the label's key).+describe('brand settings on a read-only workspace', () => {+ beforeEach(() => getCompetitors.mockResolvedValue([]));+ const openUpgrade = vi.fn();++ async function render(isLocked: boolean) {+ const container = document.createElement('div');+ document.body.append(container);+ const root = createRoot(container);+ await act(async () => {+ root.render(+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <Suspense>+ <BrandSettingsPage params={Promise.resolve({ id: brand.id })} />+ </Suspense>+ </UpgradeDialogContext.Provider>,+ );+ });+ const button = (name: string) =>+ [...container.querySelectorAll<HTMLElement>('button')].find(+ (b) => b.textContent?.trim() === name,+ )!;+ const openTab = async (name: string) => {+ const tab = [...container.querySelectorAll<HTMLElement>('[role="tab"]')].find(+ (el) => el.textContent?.trim() === name,+ )!;+ await act(async () => {+ tab.dispatchEvent(new MouseEvent('pointerdown', { bubbles: true }));+ tab.click();+ });+ };+ const type = async (input: HTMLInputElement, value: string) => {+ await act(async () => {+ Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')!.set!.call(+ input,+ value,+ );+ input.dispatchEvent(new Event('input', { bubbles: true }));+ });+ };+ const panel = () => container.querySelector<HTMLElement>('[role="tabpanel"]:not([hidden])')!;+ return { container, root, button, openTab, type, panel };+ }++ it('saves, pauses and adds nothing, each opening the upgrade dialog, but deletes', async () => {+ openUpgrade.mockReset();+ deleteBrand.mockResolvedValue({ deleted: true });+ const { container, root, button, openTab, type, panel } = await render(true);++ await act(async () => button('settings.saveChanges').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('saveBrandSettings');+ await act(async () => (container.querySelector('#shopping-mode') as HTMLElement).click());+ expect(openUpgrade).toHaveBeenLastCalledWith('changeShoppingMode');+ await act(async () => button('Pause tracking').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('pauseBrands');++ await openTab('Competitors');+ await type(+ panel().querySelector<HTMLInputElement>('input[placeholder="Competitor name"]')!,+ 'Rival',+ );+ await act(async () => button('Add').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('addCompetitors');++ await openTab('settings.dangerTab');+ await type(panel().querySelector<HTMLInputElement>('input')!, 'Acme');+ await act(async () => button('settings.deleteButton').click());+ expect(deleteBrand).toHaveBeenCalledOnce();++ expect(openUpgrade).toHaveBeenCalledTimes(4);+ expect(updateBrand).not.toHaveBeenCalled();+ expect(setBrandShoppingMode).not.toHaveBeenCalled();+ expect(setBrandActive).not.toHaveBeenCalled();+ expect(addCompetitor).not.toHaveBeenCalled();+ await act(async () => root.unmount());+ });++ it('pauses the brand on an active plan', async () => {+ openUpgrade.mockReset();+ setBrandActive.mockResolvedValue(undefined);+ const { root, button } = await render(false);+ await act(async () => button('Pause tracking').click());+ expect(setBrandActive).toHaveBeenCalledWith(brand.id, false);+ expect(openUpgrade).not.toHaveBeenCalled();+ await act(async () => root.unmount());+ });+});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.tsxindex d3967baa2..7226811f4 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/[id]/settings/page.tsx@@ -48,6 +48,7 @@ import {import { Checkbox } from '@/components/ui/checkbox';import { useUserRole } from '@/hooks/use-user-role';import { useFeatureGate } from '@/hooks/use-feature-gate';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {Dialog,DialogContent,@@ -180,6 +181,10 @@ function GeneralTab({}) {const t = useTranslations('brands');const { canManage } = useUserRole();+ // A read-only workspace (plan not active): the settings show; Save opens+ // the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [name, setName] = useState(brand.name);const [logoUrl, setLogoUrl] = useState(brand.logoUrl ?? '');const [industry, setIndustry] = useState(brand.industry ?? '');@@ -371,7 +376,11 @@ function GeneralTab({</div>)}- <Button onClick={handleSave} disabled={isSaving || !name.trim()} className="gap-2">+ <Button+ onClick={guard(handleSave, { action: tActions('saveBrandSettings') })}+ disabled={isSaving || !name.trim()}+ className="gap-2"+ >{isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <Save className="h-4 w-4" />}{t('settings.saveChanges')}</Button>@@ -402,6 +411,9 @@ function ShoppingModeCard({const tracked = canUse('shopping_analytics');const [enabled, setEnabled] = useState(brand.shoppingModeEnabled);const [saving, setSaving] = useState(false);+ // A read-only workspace (plan not active): the box opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');async function handleToggle(next: boolean) {if (!canManage) return;@@ -439,7 +451,9 @@ function ShoppingModeCard({id="shopping-mode"checked={enabled}disabled={saving || !canManage}- onCheckedChange={(v) => handleToggle(v === true)}+ onCheckedChange={guard((v: boolean) => void handleToggle(v === true), {+ action: tActions('changeShoppingMode'),+ })}/><div className="space-y-1"><Label htmlFor="shopping-mode" className="font-medium">@@ -480,6 +494,11 @@ function PauseBrandCard({const { canAdmin } = useUserRole();const paused = !brand.isActive;const [saving, setSaving] = useState(false);+ // A read-only workspace (plan not active): Pause and Resume open the+ // upgrade dialog instead. Nothing runs for it meanwhile: there is no cost+ // for Pause to stop.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');async function handleToggle(nextActive: boolean) {if (!canAdmin) return;@@ -525,7 +544,9 @@ function PauseBrandCard({<Buttonvariant={paused ? 'default' : 'outline'}disabled={saving || !canAdmin}- onClick={() => handleToggle(paused)}+ onClick={guard(() => void handleToggle(paused), {+ action: tActions(paused ? 'resumeBrands' : 'pauseBrands'),+ })}className="gap-2">{saving ? (@@ -557,6 +578,9 @@ function DomainsTab({}) {const t = useTranslations('brands');const { canManage } = useUserRole();+ // A read-only workspace (plan not active): Save opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [domains, setDomains] = useState<BrandDomain[]>(brand.domains);const [isSaving, setIsSaving] = useState(false);const [newDomain, setNewDomain] = useState('');@@ -699,7 +723,7 @@ function DomainsTab({</div><Button- onClick={handleSave}+ onClick={guard(handleSave, { action: tActions('saveDomains') })}disabled={isSaving || domains.length === 0}className="gap-2">@@ -720,6 +744,10 @@ function DomainsTab({function CompetitorsTab({ brandId }: { brandId: string }) {const t = useTranslations('brands');const { canManage } = useUserRole();+ // A read-only workspace (plan not active): Add and Remove (before its+ // confirm) open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [competitors, setCompetitors] = useState<Competitor[]>([]);const [isLoading, setIsLoading] = useState(true);const [isAdding, setIsAdding] = useState(false);@@ -770,6 +798,7 @@ function CompetitorsTab({ brandId }: { brandId: string }) {setIsAdding(false);}};+ const submitAdd = guard(handleAdd, { action: tActions('addCompetitors') });const handleDelete = async (id: string) => {try {@@ -831,7 +860,9 @@ function CompetitorsTab({ brandId }: { brandId: string }) {variant="ghost"size="icon"className="h-7 w-7 shrink-0 text-destructive hover:text-destructive"- onClick={() => setDeletingId(c.id)}+ onClick={guard(() => setDeletingId(c.id), {+ action: tActions('deleteCompetitors'),+ })}aria-label="Delete competitor"><Trash2 className="h-3.5 w-3.5" />@@ -876,19 +907,19 @@ function CompetitorsTab({ brandId }: { brandId: string }) {placeholder="Competitor name"value={newName}onChange={(e) => setNewName(e.target.value)}- onKeyDown={(e) => e.key === 'Enter' && newName.trim() && handleAdd()}+ onKeyDown={(e) => e.key === 'Enter' && newName.trim() && submitAdd()}className="flex-1"/><Inputplaceholder="domain.com"value={newDomain}onChange={(e) => setNewDomain(e.target.value)}- onKeyDown={(e) => e.key === 'Enter' && newName.trim() && handleAdd()}+ onKeyDown={(e) => e.key === 'Enter' && newName.trim() && submitAdd()}className="w-40"/><Buttonvariant="outline"- onClick={handleAdd}+ onClick={submitAdd}disabled={isAdding || !newName.trim()}className="gap-1.5 shrink-0">@@ -1059,6 +1090,8 @@ function DangerTab({const { canAdmin } = useUserRole();const [confirmValue, setConfirmValue] = useState('');const [isDeleting, setIsDeleting] = useState(false);+ // Delete stays open on a read-only workspace (plan not active): it only+ // removes what the person gave us (Ansvisor, 2026-10-27).const canDelete = confirmValue === brand.name;diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/_brands-client.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/_brands-client.tsxindex a39d6a3fd..26a8bcdc2 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/_brands-client.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/_brands-client.tsx@@ -2,10 +2,10 @@import { useEffect } from 'react';import { useTranslations } from 'next-intl';-import { Link } from '@/i18n/navigation';import { useBrandStore } from '@/stores/use-brand-store';import { useUserRole } from '@/hooks/use-user-role';import { BrandCard } from '@/components/dashboard/brand-card';+import { AddBrandLink } from '@/components/dashboard/add-brand-link';import { Button } from '@/components/ui/button';import type { Brand } from '@/types';import { Building2, Plus } from 'lucide-react';@@ -46,12 +46,12 @@ function EmptyState() {<h2 className="text-lg font-semibold">{t('noBrands')}</h2><p className="mt-1 max-w-sm text-sm text-muted-foreground">{t('noBrandsDescription')}</p>{canManage && (- <Link href="/dashboard/brands/new" className="mt-6">+ <AddBrandLink className="mt-6"><Button className="gap-2"><Plus className="h-4 w-4" />{t('addBrand')}</Button>- </Link>+ </AddBrandLink>)}</div>);diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.test.tsxnew file mode 100644index 000000000..7f582a096--- /dev/null+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.test.tsx@@ -0,0 +1,131 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * A new brand on a read-only workspace (plan not active), also when the page+ * is opened directly: the second step's Continue, which creates the brand,+ * opens the upgrade dialog and creates nothing. On an active plan it creates+ * the brand.+ */++const brandActions = vi.hoisted(() => ({+ createBrand: vi.fn(),+ markBrandAsEcommerce: vi.fn(),+ updateBrand: vi.fn(),+}));+vi.mock('@/lib/actions/brand', () => brandActions);+vi.mock('@/lib/actions/brand-domain', () => ({ syncDomains: vi.fn() }));+vi.mock('@/lib/actions/topic', () => ({ createTopics: vi.fn() }));+vi.mock('@/lib/actions/prompt', () => ({ getPromptCapacity: vi.fn(), savePromptSet: vi.fn() }));+vi.mock('@/lib/actions/competitor', () => ({ addCompetitor: vi.fn() }));+vi.mock('@/lib/actions/tracking', () => ({ triggerTrackingCheck: vi.fn() }));+vi.mock('@/lib/actions/volumes', () => ({ bootstrapBrandVolumes: vi.fn() }));+const suggestTopics = vi.hoisted(() => vi.fn());+vi.mock('@/lib/ai-brand-setup', async (importOriginal) => ({+ ...(await importOriginal<typeof import('@/lib/ai-brand-setup')>()),+ suggestTopics,+ generatePromptsFromTopics: vi.fn(),+ suggestCompetitors: vi.fn(),+}));+// The org's row: no plan read here, the user and their organization only.+const single = async () => ({ data: { organization_id: 'org-1' } });+vi.mock('@/lib/supabase/client', () => ({+ createClient: () => ({+ auth: { getUser: async () => ({ data: { user: { id: 'u1' } } }) },+ from: () => ({ select: () => ({ eq: () => ({ single }) }) }),+ }),+}));+vi.mock('@/components/providers/plan-provider', () => ({+ usePlanContext: () => ({ allowedModelIds: null }),+}));+const store = vi.hoisted(() => ({+ addBrand: vi.fn(),+ setActiveBrand: vi.fn(),+ updateBrand: vi.fn(),+}));+vi.mock('@/stores/use-brand-store', () => ({ useBrandStore: () => store }));+vi.mock('@/i18n/navigation', () => ({ useRouter: () => ({ push: vi.fn() }) }));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { default: NewBrandPage } = await import('./page');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ brandActions.createBrand.mockResolvedValue({+ brand: { id: 'b1', name: 'Acme', domains: [{ domain: 'acme.com', isPrimary: true }] },+ });+ suggestTopics.mockResolvedValue({ topics: [] });+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <NewBrandPage />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++async function type(id: string, value: string) {+ const input = container.querySelector<HTMLInputElement>(`#${id}`)!;+ await act(async () => {+ Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')!.set!.call(input, value);+ input.dispatchEvent(new Event('input', { bubbles: true }));+ });+}+const clickContinue = () =>+ act(async () =>+ [...container.querySelectorAll('button')].find((b) => b.textContent === 'Continue')!.click(),+ );++/** Fills the first step and goes on to the second, which creates the brand. */+async function reachCreate() {+ await type('brandName', 'Acme');+ await type('website', 'acme.com');+ await clickContinue();+}++describe('the new brand page', () => {+ it('creates no brand on a read-only workspace: Continue opens the upgrade dialog', async () => {+ await render(true);+ await reachCreate();+ await clickContinue();+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding brands needs a plan');+ expect(brandActions.createBrand).not.toHaveBeenCalled();+ expect(suggestTopics).not.toHaveBeenCalled();+ });++ it('creates the brand on an active plan', async () => {+ await render(false);+ await reachCreate();+ await clickContinue();+ expect(brandActions.createBrand).toHaveBeenCalledWith(+ expect.objectContaining({ organizationId: 'org-1', name: 'Acme' }),+ );+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.tsxindex 6cff3b136..3afed7993 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/new/page.tsx@@ -1,6 +1,7 @@'use client';import { useState, useEffect, useRef } from 'react';+import { useTranslations } from 'next-intl';import { useRouter } from '@/i18n/navigation';import { createClient } from '@/lib/supabase/client';import { createBrand, markBrandAsEcommerce, updateBrand } from '@/lib/actions/brand';@@ -13,6 +14,7 @@ import { addCompetitorChoice, mergeCompetitorSuggestions } from '@/lib/competitoimport { triggerTrackingCheck } from '@/lib/actions/tracking';import { bootstrapBrandVolumes } from '@/lib/actions/volumes';import { usePlanContext } from '@/components/providers/plan-provider';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { getFaviconUrl } from '@/lib/favicon';import { useBrandStore } from '@/stores/use-brand-store';import {@@ -234,6 +236,10 @@ const TOTAL_STEPS = 5;export default function NewBrandPage() {const router = useRouter();const { addBrand, setActiveBrand, updateBrand: updateBrandInStore } = useBrandStore();+ // A read-only workspace (plan not active), also when this page is opened+ // directly: the brand isn't created, the upgrade dialog opens instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [step, setStep] = useState(1);const [isLoading, setIsLoading] = useState(false);@@ -908,7 +914,11 @@ export default function NewBrandPage() {</Select></div>- <Button className="w-full" onClick={handleCreateBrand} disabled={isLoading}>+ <Button+ className="w-full"+ onClick={guard(handleCreateBrand, { action: tActions('addBrands') })}+ disabled={isLoading}+ >{isLoading ? (<><Loader2 className="mr-2 h-4 w-4 animate-spin" />diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/page.test.tsxindex 1c9532301..4711c7c48 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/page.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/page.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const profile = vi.hoisted(() => ({ organization_id: 'org-1', role: 'admin' }));vi.mock('@/lib/supabase/server', () => ({@@ -21,8 +22,10 @@ vi.mock('@/config/plans', () => ({isCloud: () => cloud.on,}));vi.mock('@/i18n/navigation', () => ({- Link: ({ href, children }: { href: string; children?: React.ReactNode }) => (- <a href={href}>{children}</a>+ Link: ({ href, children, ...rest }: { href: string; children?: React.ReactNode }) => (+ <a href={href} {...rest}>+ {children}+ </a>),}));// The list and the menu beside the button have their own tests.@@ -38,13 +41,18 @@ import BrandsPage from './page';let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();-async function render() {+async function render(isLocked = false) {const ui = await BrandsPage();await act(async () =>root.render(<NextIntlClientProvider locale="en" messages={messages}>- {ui}+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ {ui}+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,),);@@ -73,6 +81,36 @@ describe('the brands page', () => {expect(links()).toEqual(['/dashboard/brands/new']);});+ it('adds no brand on a read-only workspace: Add Brand opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ await render(true);+ const add = container.querySelector<HTMLAnchorElement>('a[href="/dashboard/brands/new"]')!;+ const click = new MouseEvent('click', { bubbles: true, cancelable: true });+ await act(async () => add.dispatchEvent(click));+ expect(click.defaultPrevented).toBe(true);+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding brands needs a plan');+ });++ it('follows Add Brand on an active plan', async () => {+ openUpgrade.mockReset();+ await render();+ const add = container.querySelector<HTMLAnchorElement>('a[href="/dashboard/brands/new"]')!;+ // jsdom can't follow a link: whether the page let the click through is+ // read once it has bubbled past React's handler, then the link is stopped.+ let prevented: boolean | undefined;+ const seen = (e: Event) => {+ prevented = e.defaultPrevented;+ e.preventDefault();+ };+ document.addEventListener('click', seen);+ await act(async () =>+ add.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true })),+ );+ document.removeEventListener('click', seen);+ expect(prevented).toBe(false);+ expect(openUpgrade).not.toHaveBeenCalled();+ });+it.each(['analyst', 'agency_partner'])('offers no Add Brand to an %s', async (role) => {profile.role = role;await render();@@ -92,4 +130,18 @@ describe('the brands page', () => {await render();expect(links()).toEqual([]);});++ it("opens the upgrade dialog from Add Brand at the plan's limit on a read-only workspace", async () => {+ openUpgrade.mockReset();+ brands.list = [{ id: 'b1' }, { id: 'b2' }];+ cloud.on = true;+ await render(true);+ const add = container.querySelector<HTMLAnchorElement>(+ 'a[href="/dashboard/settings?tab=billing"]',+ )!;+ const click = new MouseEvent('click', { bubbles: true, cancelable: true });+ await act(async () => add.dispatchEvent(click));+ expect(click.defaultPrevented).toBe(true);+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding brands needs a plan');+ });});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/brands/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/brands/page.tsxindex 4dcf81a4b..7f729d1af 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/brands/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/brands/page.tsx@@ -1,11 +1,11 @@import { useTranslations } from 'next-intl';-import { Link } from '@/i18n/navigation';import { createClient } from '@/lib/supabase/server';import { getBrands } from '@/lib/actions/brand';import { getPlan, isCloud as checkIsCloud } from '@/config/plans';import { getOrgPlan } from '@/lib/guards/plan-guard';import { BrandsClient } from './_brands-client';import { WorkspaceSettingsMenu } from '@/components/layout/workspace-settings-menu';+import { AddBrandLink } from '@/components/dashboard/add-brand-link';import { Button } from '@/components/ui/button';import { Crown, Plus } from 'lucide-react';import { HeaderWithAiUsage } from '@/components/ai-usage/ai-usage-meter';@@ -31,19 +31,19 @@ function BrandsHeader({<div className="flex items-center gap-2"><WorkspaceSettingsMenu />{!canManage ? null : canAddBrand ? (- <Link href="/dashboard/brands/new">+ <AddBrandLink><Button className="gap-2"><Plus className="h-4 w-4" />{t('addBrand')}</Button>- </Link>+ </AddBrandLink>) : needsUpgrade ? (- <Link href="/dashboard/settings?tab=billing">+ <AddBrandLink href="/dashboard/settings?tab=billing"><Button variant="outline" className="gap-2"><Crown className="h-4 w-4" />{t('addBrand')}</Button>- </Link>+ </AddBrandLink>) : null}</div></div>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.test.tsxindex 67299c617..fc1cccb73 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../../../messages/en.json';import type { ShoppingChoices, ShoppingPath } from '@/lib/content/shopping-path';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const getDraftShoppingPath = vi.fn();const buildDraftShoppingPath = vi.fn();@@ -74,17 +75,23 @@ let root: Root;// The path as saved: each save writes the choices and a new savedAt, as the action does.let stored: ShoppingPath;let saves: number;+const openUpgrade = vi.fn();-async function render(onPathChange?: () => void) {+/** `isLocked`: a read-only workspace (plan not active). */+async function render(onPathChange?: () => void, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <ShoppingPathSection- draftId="d1"- brandId="b1"- pageType="buying_guide"- onPathChange={onPathChange}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ShoppingPathSection+ draftId="d1"+ brandId="b1"+ pageType="buying_guide"+ onPathChange={onPathChange}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -113,6 +120,7 @@ beforeEach(() => {});searchCatalogProducts.mockReset().mockResolvedValue([]);toast.error.mockReset();+ openUpgrade.mockReset();container = document.createElement('div');document.body.appendChild(container);root = createRoot(container);@@ -385,4 +393,38 @@ describe('ShoppingPathSection', () => {expect(getDraftShoppingPath).toHaveBeenCalledTimes(2);expect(container.textContent).toContain('Summit GTX Boot');});++ it('shows the path on a read-only workspace, and each change or pick opens the upgrade dialog', async () => {+ const onPathChange = vi.fn();+ await render(onPathChange, true);+ expect(container.textContent).toContain('Summit GTX Boot');+ const clicks = [+ 'Lock Summit GTX Boot',+ 'Swap Summit GTX Boot for another product',+ 'Remove Ridge Light Hiker from the page',+ 'Pick again',+ 'Add product',+ ];+ for (const label of clicks) {+ await act(async () => button(label)!.click());+ }+ expect(openUpgrade).toHaveBeenCalledTimes(clicks.length);+ expect(openUpgrade).toHaveBeenCalledWith('Changing the shopping path needs a plan');+ expect(saveDraftShoppingPath).not.toHaveBeenCalled();+ expect(buildDraftShoppingPath).not.toHaveBeenCalled();+ expect(onPathChange).not.toHaveBeenCalled();+ // Nothing changed on the page, and Add product's search stays closed.+ expect(button('Lock Summit GTX Boot')!.getAttribute('aria-pressed')).toBe('false');+ expect(container.textContent).toContain('Ridge Light Hiker');+ expect(container.querySelector('input[type="search"]')).toBeNull();++ // Nor is a first pick made.+ act(() => root.unmount());+ root = createRoot(container);+ getDraftShoppingPath.mockResolvedValue({ path: null });+ await render(undefined, true);+ await act(async () => button('Pick from the catalog')!.click());+ expect(openUpgrade).toHaveBeenCalledTimes(clicks.length + 1);+ expect(buildDraftShoppingPath).not.toHaveBeenCalled();+ });});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.tsx b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.tsxindex 9cfc27bd1..f8f113010 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_shopping-path.tsx@@ -7,6 +7,7 @@ import { Lock, LockOpen, Plus, RefreshCw, ShoppingBag } from 'lucide-react';import { Button } from '@/components/ui/button';import { Input } from '@/components/ui/input';import { LoadingDots } from '@/components/ui/loading-dots';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {buildDraftShoppingPath,getDraftShoppingPath,@@ -52,6 +53,8 @@ const PICK_AGAIN: readonly (NoPathReason | null)[] = [null, 'no_match', 'other']* builds it anew, their choices kept. Shown for a page type that takes one* on an e-commerce brand. `onPathChange` follows each change saved or* built, and one found made meanwhile: the Shopping rules read it again.+ * On a read-only workspace (plan not active) the path shows, and each+ * change or new pick opens the upgrade dialog instead.*/export function ShoppingPathSection({draftId,@@ -71,6 +74,9 @@ export function ShoppingPathSection({const [query, setQuery] = useState('');// The catalog's products for what's typed; 'failed' when the search failed.const [hits, setHits] = useState<CatalogProductHit[] | 'failed' | null>(null);+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');+ const needsPlan = { action: tActions('changeShoppingPath') };const load = useCallback(async () => {setState({ status: 'loading' });@@ -141,7 +147,7 @@ export function ShoppingPathSection({* is saved when there's one. The saved change is shown whether the build* then works or not.*/- const build = async (change?: { from: ShoppingPath; next: ShoppingPath }) => {+ const build = guard(async (change?: { from: ShoppingPath; next: ShoppingPath }) => {setBusy('build');try {if (change) {@@ -166,10 +172,10 @@ export function ShoppingPathSection({} finally {setBusy(null);}- };+ }, needsPlan);/** Saves a change made here (a lock, a removal), shown at once; put back when it fails. */- const save = async (from: ShoppingPath, next: ShoppingPath) => {+ const save = guard(async (from: ShoppingPath, next: ShoppingPath) => {const before = state;setState({ status: 'ready', path: next, none: null });setBusy('save');@@ -183,7 +189,7 @@ export function ShoppingPathSection({} finally {setBusy(null);}- };+ }, needsPlan);const header = (path: ShoppingPath | null) => (<div className="flex items-center gap-2">@@ -286,10 +292,10 @@ export function ShoppingPathSection({className="h-7 gap-1 px-2 text-xs"aria-expanded={adding}disabled={busy !== null}- onClick={() => {+ onClick={guard(() => {setAdding(!adding);setQuery('');- }}+ }, needsPlan)}><Plus className="h-3.5 w-3.5" aria-hidden="true" />{t('add')}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_toolbar.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_toolbar.test.tsxindex ba7c02a56..625d1ba59 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_toolbar.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/content/editor/[draftId]/_toolbar.test.tsx@@ -6,6 +6,7 @@ import { CharacterCount } from '@tiptap/extensions';import { NextIntlClientProvider } from 'next-intl';import { afterEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';vi.mock('@/lib/actions/shopping-path', () => ({searchProductsForBlock: vi.fn(),@@ -50,13 +51,16 @@ describe('onEmptyLine', () => {describe('EditorToolbar', () => {let container: HTMLElement;let root: Root;+ const openUpgrade = vi.fn();afterEach(() => {+ openUpgrade.mockReset();act(() => root.unmount());container.remove();document.body.replaceChildren();});- async function render(productsBrandId: string | null) {+ /** `isLocked`: a read-only workspace (plan not active). */+ async function render(productsBrandId: string | null, isLocked = false) {editor = new Editor({extensions: [StarterKit, CharacterCount],content: '<h1>Title</h1><p>Text</p>',@@ -67,15 +71,19 @@ describe('EditorToolbar', () => {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <EditorToolbar- editor={editor!}- target={3000}- lengthWarning={false}- htmlView={false}- onToggleHtml={() => {}}- onAttach={() => {}}- productsBrandId={productsBrandId}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <EditorToolbar+ editor={editor!}+ target={3000}+ lengthWarning={false}+ htmlView={false}+ onToggleHtml={() => {}}+ onAttach={() => {}}+ productsBrandId={productsBrandId}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -97,4 +105,11 @@ describe('EditorToolbar', () => {await act(async () => products()!.click());expect(document.body.textContent).toContain('Add products');});++ it('opens the upgrade dialog from it on a read-only workspace, and adds nothing', async () => {+ await render('b1', true);+ await act(async () => products()!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Editing the page needs a plan');+ expect(document.body.textContent).not.toContain('Add products');+ });});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_mentions-tab.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_mentions-tab.test.tsxindex 7e5ac5840..b0b51cc17 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_mentions-tab.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_mentions-tab.test.tsx@@ -7,6 +7,7 @@ import { DEFAULT_MENTIONS_FILTERS } from '@/lib/mentions-filters';import { DEFAULT_MENTIONS_TABLE, type MentionRow, type MentionsList } from '@/lib/mentions-list';import type { Competitor } from '@/types';import { MentionsListTab } from './_mentions-tab';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const listMentions = vi.fn();const getMentionResponse = vi.fn();@@ -85,12 +86,17 @@ const competitors: Competitor[] = [let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();-function render(node: React.ReactNode) {+function render(node: React.ReactNode, isLocked = false) {act(() => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- {node}+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ {node}+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -276,6 +282,26 @@ describe('MentionsListTab', () => {expect(container.textContent).not.toContain('selected');});+ it('sends nothing on a read-only workspace: Send to Action Center opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ listMentions.mockResolvedValue(list());+ render(tab(), true);+ await settle();+ const boxes = [...container.querySelectorAll('button[role="checkbox"]')] as HTMLElement[];+ act(() => boxes[1].click());+ const send = [...container.querySelectorAll('button')].find(+ (b) => b.textContent === 'Send to Action Center',+ ) as HTMLElement;+ await act(async () => {+ send.click();+ await vi.advanceTimersByTimeAsync(0);+ });+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Sending actions needs a plan');+ expect(sendMentionsToActionCenter).not.toHaveBeenCalled();+ // Nothing went: the selection stays.+ expect(container.textContent).toContain('1 answer selected');+ });+it("exports the ticked answers under the table's controls", async () => {window.history.replaceState(null, '', '/dashboard/mentions?tab=mentions&sentiment=negative');listMentions.mockResolvedValue(list());diff --git a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_sentiment-correction.tsx b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_sentiment-correction.tsxindex 3fed849f3..c685fa8aa 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_sentiment-correction.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_sentiment-correction.tsx@@ -13,6 +13,7 @@ import {type SentimentOverride,} from '@/lib/mentions-list';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';const NOTE_MAX = 500;@@ -41,6 +42,9 @@ export function SentimentCorrection({const [choice, setChoice] = useState<MentionSentiment | null>(row.sentiment);const [note, setNote] = useState('');const [saving, setSaving] = useState(false);+ // A read-only workspace (plan not active): the upgrade dialog instead of the form.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const save = async () => {if (!choice) return;@@ -97,10 +101,13 @@ export function SentimentCorrection({variant="link"size="sm"className="h-auto px-0 text-xs"- onClick={() => {- setChoice(row.sentiment);- setOpen(true);- }}+ onClick={guard(+ () => {+ setChoice(row.sentiment);+ setOpen(true);+ },+ { action: tActions('correctSentiment') },+ )}>{t('open')}</Button>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_use-mention-actions.ts b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_use-mention-actions.tsindex 2976c9c29..1a41b9acf 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/mentions/_use-mention-actions.ts+++ b/web/src/app/[locale]/(dashboard)/dashboard/mentions/_use-mention-actions.ts@@ -4,6 +4,7 @@ import { useCallback, useState } from 'react';import { useTranslations } from 'next-intl';import { toast } from 'sonner';import { useFailureToast } from '@/hooks/use-failure-toast';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { useRouter } from '@/i18n/navigation';import { getGenerationJobStatus, suggestContentForPrompt } from '@/lib/actions/content';import { sendMentionsToActionCenter } from '@/lib/actions/mentions';@@ -17,12 +18,15 @@ const SUGGEST_CALLS = { start: suggestContentForPrompt, getStatus: getGeneration* The Mentions tab's actions (MS-08), shared by the response drawer and the* table's selection bar: send answers to the Action Center as one action,* and suggest content for an answer's prompt. Each reports how it went in a- * toast that opens what it made.+ * toast that opens what it made. On a read-only workspace (plan not active)+ * both open the upgrade dialog instead.*/export function useMentionActions(brandId: string) {const t = useTranslations('mentions.actions');const router = useRouter();const failureToast = useFailureToast();+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [sending, setSending] = useState(false);const [suggesting, setSuggesting] = useState<string | null>(null);@@ -126,5 +130,10 @@ export function useMentionActions(brandId: string) {[failureToast, router, t],);- return { send, sending, suggest, suggesting };+ return {+ send: guard(send, { action: tActions('sendAction') }),+ sending,+ suggest: guard(suggest, { action: tActions('suggestContent') }),+ suggesting,+ };}diff --git a/web/src/app/[locale]/(dashboard)/dashboard/reports/page.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/reports/page.test.tsxnew file mode 100644index 000000000..02c02e2b0--- /dev/null+++ b/web/src/app/[locale]/(dashboard)/dashboard/reports/page.test.tsx@@ -0,0 +1,105 @@+import { act, type ReactNode } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Reports on a read-only workspace (plan not active): the reports list and+ * open; Generate Report and Delete (before its confirm) open the upgrade+ * dialog instead.+ */++const reports = vi.hoisted(() => ({+ getReports: vi.fn(),+ createReport: vi.fn(),+ deleteReport: vi.fn(),+}));+vi.mock('@/lib/actions/reports', () => reports);+const brand = { id: 'b1', name: 'Acme', shoppingModeEnabled: false };+vi.mock('@/stores/use-brand-store', () => ({+ useBrandStore: (select: (state: unknown) => unknown) =>+ select({ activeBrandId: 'b1', brands: [brand] }),+}));+const push = vi.hoisted(() => vi.fn());+vi.mock('@/i18n/navigation', () => ({ useRouter: () => ({ push }) }));+vi.mock('@/components/ai-usage/ai-usage-meter', () => ({+ HeaderWithAiUsage: ({ children }: { children: ReactNode }) => <div>{children}</div>,+}));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { default: ReportsPage } = await import('./page');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ reports.getReports.mockResolvedValue([+ {+ id: 'r1',+ brandId: 'b1',+ title: 'October review',+ template: 'executive_summary',+ dateFrom: '2026-10-01T00:00:00Z',+ dateTo: '2026-10-27T00:00:00Z',+ createdAt: '2026-10-27T00:00:00Z',+ },+ ]);+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ReportsPage />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const generate = () =>+ [...container.querySelectorAll('button')].find((b) => b.textContent === 'Generate Report')!;+// The row's last button: the bin.+const remove = () => [...container.querySelectorAll('tbody button')].at(-1) as HTMLButtonElement;+const dialog = () => document.querySelector('[role="dialog"]');++describe('Reports', () => {+ it('generates and deletes nothing on a read-only workspace: the upgrade dialog instead', async () => {+ await render(true);+ expect(container.textContent).toContain('October review');+ await act(async () => generate().click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Generating reports needs a plan');+ await act(async () => remove().click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Deleting reports needs a plan');+ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(dialog()).toBeNull();+ expect(reports.createReport).not.toHaveBeenCalled();+ expect(reports.deleteReport).not.toHaveBeenCalled();+ });++ it('opens Generate Report on an active plan', async () => {+ await render(false);+ await act(async () => generate().click());+ expect(dialog()).not.toBeNull();+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/app/[locale]/(dashboard)/dashboard/reports/page.tsx b/web/src/app/[locale]/(dashboard)/dashboard/reports/page.tsxindex 0189cbd95..2e5d3c037 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/reports/page.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/reports/page.tsx@@ -5,6 +5,7 @@ import { useRouter } from '@/i18n/navigation';import { useTranslations } from 'next-intl';import { toast } from 'sonner';import { useBrandStore } from '@/stores/use-brand-store';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { createReport, getReports, deleteReport, type ReportListItem } from '@/lib/actions/reports';import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';import { Button } from '@/components/ui/button';@@ -66,6 +67,10 @@ function getDateRange(preset: DatePreset, custom: { from: string; to: string })export default function ReportsPage() {const t = useTranslations('reports');const tc = useTranslations('common');+ // A read-only workspace (plan not active): Generate report and Delete open+ // the upgrade dialog instead; reading and downloading reports stay open.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const router = useRouter();const activeBrandId = useBrandStore((s) => s.activeBrandId);const brands = useBrandStore((s) => s.brands);@@ -115,10 +120,13 @@ export default function ReportsPage() {});};- const openDialog = () => {- setReportBrandId(activeBrandId);- setDialogOpen(true);- };+ const openDialog = guard(+ () => {+ setReportBrandId(activeBrandId);+ setDialogOpen(true);+ },+ { action: tActions('generateReports') },+ );const load = useCallback(async () => {if (!activeBrandId) return;@@ -256,7 +264,9 @@ export default function ReportsPage() {variant="ghost"className="text-muted-foreground hover:text-destructive"disabled={deletingId === report.id}- onClick={() => setPendingConfirm(report.id)}+ onClick={guard(() => setPendingConfirm(report.id), {+ action: tActions('deleteReports'),+ })}>{deletingId === report.id ? (<Loader2 className="h-4 w-4 animate-spin" />diff --git a/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.test.tsxindex e21bed362..e8759f841 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';import { OpenAiIndexCard } from './openai_index_card';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/** #1281: ChatGPT in the US, OpenAI's product index and the verified seller flag. */@@ -12,8 +13,10 @@ import { OpenAiIndexCard } from './openai_index_card';let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();beforeEach(() => {+ openUpgrade.mockReset();container = document.createElement('div');document.body.appendChild(container);root = createRoot(container);@@ -24,11 +27,15 @@ afterEach(() => {container.remove();});-function render(node: React.ReactNode) {+function render(node: React.ReactNode, isLocked = false) {act(() => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- {node}+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ {node}+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -125,6 +132,27 @@ describe('OpenAiIndexCard', () => {);});+ it('saves nothing on a read-only workspace: the box opens the upgrade dialog', async () => {+ const change = vi.fn();+ render(+ <OpenAiIndexCard+ read={{ directFeed: false, ownCards: 0 }}+ loading={false}+ canManage+ onDirectFeedChange={change}+ />,+ true,+ );+ await act(async () => {+ box().click();+ });+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith(+ 'Changing the product feed setting needs a plan',+ );+ expect(change).not.toHaveBeenCalled();+ expect(box().getAttribute('aria-checked')).toBe('false');+ });+it('says so when the read failed', () => {expect(render(<OpenAiIndexCard read={null} loading={false} canManage onDirectFeedChange={noop} />),diff --git a/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.tsx b/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.tsxindex 4b81d5a8f..1b851d610 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/shopping/openai_index_card.tsx@@ -11,6 +11,7 @@ import {type OpenAiIndexStatus,} from '@/lib/shopping/openai-index';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';const STATUS_TONE: Record<OpenAiIndexStatus, string> = {direct_feed: 'bg-emerald-50 text-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-300',@@ -40,14 +41,21 @@ export function OpenAiIndexCard({const [saving, setSaving] = useState(false);const [failed, setFailed] = useState(false);const status = read ? openAiIndexStatus(read) : null;+ // A read-only workspace (plan not active): the box opens the upgrade dialog+ // instead, and stays as it was.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');- const changeFeed = (on: boolean) => {- setSaving(true);- setFailed(false);- onDirectFeedChange(on)- .catch(() => setFailed(true))- .finally(() => setSaving(false));- };+ const changeFeed = guard(+ (on: boolean) => {+ setSaving(true);+ setFailed(false);+ onDirectFeedChange(on)+ .catch(() => setFailed(true))+ .finally(() => setSaving(false));+ },+ { action: tActions('setProductFeed') },+ );return (<Card>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.test.tsxindex b85c49b17..ab70b1228 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';import type { BotConnections, NewBotConnection } from '@/lib/actions/ai-bots';/**@@ -68,11 +69,16 @@ afterEach(() => {document.body.innerHTML = '';});-async function render(canConnect = true) {+const openUpgrade = vi.fn();+async function render(canConnect = true, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <BotsSource brandId="b1" canConnect={canConnect} />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <BotsSource brandId="b1" canConnect={canConnect} />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -128,6 +134,15 @@ describe('BotsSource', () => {expect(getBotConnections).toHaveBeenCalledTimes(2);});+ it('makes no connection on a read-only workspace: Create connection opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ await render(true, true);+ await act(async () => button('Connect')!.click());+ await act(async () => button('Create connection')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Connecting bot logs needs a plan');+ expect(createBotConnection).not.toHaveBeenCalled();+ });+// gkhngyk on #1225: a failed read after the create took the dialog down.it('keeps the settings with the secret when the read after a create fails', async () => {await render();diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.tsxindex 7840631e3..f284621b7 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_bots-connect.tsx@@ -33,6 +33,7 @@ import {} from '@/lib/actions/ai-bots';import { SourceCard } from './_source-card';import { getBotConnections } from '@/lib/traffic-reads';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';const KINDS: BotConnectionKind[] = ['cloudflare_worker', 'cloudflare_logpush', 'vercel_drain'];@@ -158,6 +159,10 @@ export function BotsDialog({const [created, setCreated] = useState<NewBotConnection | null>(null);const [revoking, setRevoking] = useState<string | null>(null);const [confirming, setConfirming] = useState<string | null>(null);+ // A read-only workspace (plan not active): a new connection opens the+ // upgrade dialog instead; revoking one stays open (it ends an access).+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const close = (next: boolean) => {if (!next) {@@ -167,17 +172,20 @@ export function BotsDialog({onOpenChange(next);};- const create = async () => {- setCreating(true);- const result = await createBotConnection(brandId, kind);- setCreating(false);- if ('error' in result) {- toast.error(result.code === 'plan_limit' ? t('planLimit') : result.error);- return;- }- setCreated(result);- onChanged();- };+ const create = guard(+ async () => {+ setCreating(true);+ const result = await createBotConnection(brandId, kind);+ setCreating(false);+ if ('error' in result) {+ toast.error(result.code === 'plan_limit' ? t('planLimit') : result.error);+ return;+ }+ setCreated(result);+ onChanged();+ },+ { action: tActions('connectBotLogs') },+ );const revoke = async (id: string) => {setRevoking(id);diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_google-section.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_google-section.tsxindex b2e5d19b9..64355081b 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_google-section.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_google-section.tsx@@ -29,6 +29,7 @@ import { NeedsTag, SourceUnavailable } from './_source-gate';import { UntrackedQueriesCard } from './_untracked-queries';import { getTrafficGooglePages } from '@/lib/traffic-reads';import { useRangeReady } from './_range-ready';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/** CTR as the table shows it: "3.1%". */function ctr(clicks: number, impressions: number): string {@@ -96,6 +97,10 @@ export function GoogleSection({// The page whose suggested prompts are open; each opening starts afresh.const [promptsFor, setPromptsFor] = useState<string | null>(null);const [promptsOpened, setPromptsOpened] = useState(0);+ // A read-only workspace (plan not active): Add prompts (its dialog asks the+ // AI as it opens) opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const gscReady = source === null || googleSourceStatus(source) === 'connected';@@ -191,10 +196,13 @@ export function GoogleSection({variant="outline"className="h-7 text-xs"title={t('taking.addPromptsTip')}- onClick={() => {- setPromptsFor(row.page);- setPromptsOpened((n) => n + 1);- }}+ onClick={guard(+ () => {+ setPromptsFor(row.page);+ setPromptsOpened((n) => n + 1);+ },+ { action: tActions('suggestPrompts') },+ )}>{t('taking.addPrompts')}</Button>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.test.tsxindex cbd45a7e8..4ee20e7e1 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';import type {TrafficBrokenLink,TrafficDateWindow,@@ -136,24 +137,30 @@ afterEach(() => {container.remove();});+const openUpgrade = vi.fn();async function render({domain = 'acme-coffee.example.com',analyticsMissing = false,-}: { domain?: string; analyticsMissing?: boolean } = {}) {+ isLocked = false,+}: { domain?: string; analyticsMissing?: boolean; isLocked?: boolean } = {}) {// Each list's own Excel / CSV, told apart by name.const exportButton = (name: string) => <span data-testid="export">{name}</span>;await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <PagesCard- brandId={BRAND}- dateWindow={WEEK}- rangeLabel="Last 7 days"- domain={domain}- analyticsMissing={analyticsMissing}- actions={exportButton('pages by status')}- brokenActions={exportButton('redirect list')}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <PagesCard+ brandId={BRAND}+ dateWindow={WEEK}+ rangeLabel="Last 7 days"+ domain={domain}+ analyticsMissing={analyticsMissing}+ actions={exportButton('pages by status')}+ brokenActions={exportButton('redirect list')}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -212,6 +219,25 @@ describe('PagesCard', () => {expect(push).toHaveBeenCalledWith('/dashboard/audit/audit-1');});+ it('audits, suggests and sends nothing on a read-only workspace: the upgrade dialog instead', async () => {+ openUpgrade.mockReset();+ getTrafficPages.mockResolvedValue(+ pages([page({ citations: 6 }), page({ page: '/about', valueRank: 2 })]),+ );+ await render({ isLocked: true });+ await act(async () => button('Add prompts').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Suggesting prompts needs a plan');+ expect(dialog()).toBeNull();+ await act(async () => button('Audit page').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Running an audit needs a plan');+ await act(async () => button('Send to Action Center').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Sending actions needs a plan');+ expect(openUpgrade).toHaveBeenCalledTimes(3);+ expect(runAudit).not.toHaveBeenCalled();+ expect(sendTrafficPagesToActionCenter).not.toHaveBeenCalled();+ expect(push).not.toHaveBeenCalled();+ });+it("can't audit without the brand's domain", async () => {getTrafficPages.mockResolvedValue(pages([page({ citations: 6 })]));await render({ domain: '' });diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.tsxindex 0e22cea84..f0a3db820 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_pages-card.tsx@@ -42,6 +42,7 @@ import { PAGE_ACTION_MAX, auditBlock, usePageActions } from './_use-page-actionsimport { PagePromptsDialog } from './_page-prompts-dialog';import { getTrafficPages } from '@/lib/traffic-reads';import { useRangeReady } from './_range-ready';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Pages: which answers send visitors (AT-006, spec §3.5, "the@@ -201,6 +202,10 @@ export function PagesCard({const [limit, setLimit] = useState(PAGE_SIZE);const [auditing, setAuditing] = useState<string | null>(null);const pageActions = usePageActions(brandId, dateWindow);+ // A read-only workspace (plan not active): Audit page, and Add prompts (its+ // dialog asks the AI as it opens), open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// The page whose suggested prompts are open (part B2); each opening starts// afresh, and tracking some reads the list again for its prompt counts.const [promptsFor, setPromptsFor] = useState<string | null>(null);@@ -268,17 +273,20 @@ export function PagesCard({variant="outline"className="h-7 gap-1.5 text-xs"disabled={!domain || auditing !== null}- onClick={() => void auditPage(page)}+ onClick={guard(() => void auditPage(page), { action: tActions('runAudit') })}>{auditing === page && <Loader2 className="h-3 w-3 animate-spin" />}{t('auditPage')}</Button>);- const openPrompts = (page: string) => {- setPromptsFor(page);- setPromptsOpened((n) => n + 1);- };+ const openPrompts = guard(+ (page: string) => {+ setPromptsFor(page);+ setPromptsOpened((n) => n + 1);+ },+ { action: tActions('suggestPrompts') },+ );const addPromptsButton = (page: string) => (<Button size="sm" variant="outline" className="h-7 text-xs" onClick={() => openPrompts(page)}>diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.test.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.test.tsxindex fac3a5a6c..0606c53d6 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.test.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';import type { TrafficDateWindow, TrafficUntrackedQueries } from '@/lib/actions/traffic';/**@@ -69,17 +70,22 @@ afterEach(() => {});const onTracked = vi.fn();+const openUpgrade = vi.fn();-async function render(canTrack = true) {+async function render(canTrack = true, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <UntrackedQueriesCard- brandId="b1"- dateWindow={WEEK}- canTrack={canTrack}- onTracked={onTracked}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <UntrackedQueriesCard+ brandId="b1"+ dateWindow={WEEK}+ canTrack={canTrack}+ onTracked={onTracked}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -118,6 +124,14 @@ describe('UntrackedQueriesCard', () => {expect(onTracked).toHaveBeenCalledTimes(1);});+ it('tracks nothing on a read-only workspace: Track opens the upgrade dialog', async () => {+ openUpgrade.mockReset();+ await render(true, true);+ await act(async () => button('Track')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Tracking prompts needs a plan');+ expect(trackPagePrompts).not.toHaveBeenCalled();+ });+it('tracks as many as the slots allow, and says when the plan ran out', async () => {getLocationQuota.mockResolvedValue({ maxPrompts: 50, used: 48 });trackPagePrompts.mockResolvedValue({ promptIds: ['n1'], error: 'limit', code: 'plan_limit' });diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.tsx b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.tsxindex 28591f905..d7d79563a 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.tsx+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_untracked-queries.tsx@@ -23,6 +23,7 @@ import { type TrafficDateWindow, type TrafficUntrackedQueries } from '@/lib/actiimport { formatTrafficBucketDate } from './_charts';import { getUntrackedGoogleQueries } from '@/lib/traffic-reads';import { useRangeReady } from './_range-ready';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Prompt slots left on the plan: null when the plan has no cap, or it@@ -57,6 +58,10 @@ export function UntrackedQueriesCard({actions?: ReactNode;}) {const t = useTranslations('traffic.google.untracked');+ // A read-only workspace (plan not active): Track and Track all open the+ // upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Tracking reads the list again: the tracked queries leave it.const [reloads, setReloads] = useState(0);const key = `${brandId}|${dateWindow.dateFrom ?? ''}|${dateWindow.dateTo ?? ''}|${reloads}`;@@ -104,28 +109,31 @@ export function UntrackedQueriesCard({const slotsLeft = current ? (quota?.slotsLeft ?? null) : null;const busy = tracking.size > 0;- const track = async (queries: string[]) => {- setTracking(new Set(queries));- const outcome = await trackPagePrompts(- brandId,- null,- queries.map((text) => ({ text, topic: '' })),- ).catch((err: Error) => ({ promptIds: [] as string[], error: err.message, code: undefined }));- setTracking(new Set());- const tracked = outcome.promptIds.length;- if (tracked > 0) toast.success(t('tracked', { count: tracked }));- if (outcome.error) {- toast.error(- outcome.code === 'plan_limit'- ? t('planLimit', { count: queries.length - tracked })- : outcome.error,- );- }- if (tracked > 0) {- setReloads((n) => n + 1);- onTracked?.();- }- };+ const track = guard(+ async (queries: string[]) => {+ setTracking(new Set(queries));+ const outcome = await trackPagePrompts(+ brandId,+ null,+ queries.map((text) => ({ text, topic: '' })),+ ).catch((err: Error) => ({ promptIds: [] as string[], error: err.message, code: undefined }));+ setTracking(new Set());+ const tracked = outcome.promptIds.length;+ if (tracked > 0) toast.success(t('tracked', { count: tracked }));+ if (outcome.error) {+ toast.error(+ outcome.code === 'plan_limit'+ ? t('planLimit', { count: queries.length - tracked })+ : outcome.error,+ );+ }+ if (tracked > 0) {+ setReloads((n) => n + 1);+ onTracked?.();+ }+ },+ { action: tActions('trackPrompts') },+ );const trackTitle = !canTrack ? t('trackNotAllowed') : slotsLeft === 0 ? t('noSlots') : undefined;const trackable = canTrack && slotsLeft !== 0 && !busy;diff --git a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_use-page-actions.ts b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_use-page-actions.tsindex 600700a2e..5b4c5a910 100644--- a/web/src/app/[locale]/(dashboard)/dashboard/traffic/_use-page-actions.ts+++ b/web/src/app/[locale]/(dashboard)/dashboard/traffic/_use-page-actions.ts@@ -3,6 +3,7 @@import { useCallback, useEffect, useState } from 'react';import { useTranslations } from 'next-intl';import { useFailureToast } from '@/hooks/use-failure-toast';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { toast } from 'sonner';import { useRouter } from '@/i18n/navigation';import { getAuditQuota, runAuditsBulk, type AuditQuota } from '@/lib/actions/audits';@@ -25,12 +26,15 @@ const SUGGEST_CALLS = { start: generateOpportunitiesOnDemand, getStatus: getGene* footer: send pages to the Action Center as one action, audit several* pages at once within the month's audits, and suggest content for a page* (part B3, one of the month's content suggestions). Each reports how it went- * in a toast that opens what it made.+ * in a toast that opens what it made. On a read-only workspace (plan not+ * active) each opens the upgrade dialog instead.*/export function usePageActions(brandId: string, dateWindow: TrafficDateWindow) {const t = useTranslations('traffic.pageList.actions');const failureToast = useFailureToast();const router = useRouter();+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [sending, setSending] = useState(false);const [auditing, setAuditing] = useState(false);// The page whose content suggestion is being written.@@ -187,7 +191,15 @@ export function usePageActions(brandId: string, dateWindow: TrafficDateWindow) {[brandId, failureToast, router, t],);- return { send, sending, auditMany, auditing, quota, suggestContent, suggesting };+ return {+ send: guard(send, { action: tActions('sendAction') }),+ sending,+ auditMany: guard(auditMany, { action: tActions('auditPages') }),+ auditing,+ quota,+ suggestContent: guard(suggestContent, { action: tActions('suggestContent') }),+ suggesting,+ };}/**diff --git a/web/src/app/[locale]/(dashboard)/layout.tsx b/web/src/app/[locale]/(dashboard)/layout.tsxindex f12308da9..d0c036668 100644--- a/web/src/app/[locale]/(dashboard)/layout.tsx+++ b/web/src/app/[locale]/(dashboard)/layout.tsx@@ -107,7 +107,6 @@ export default async function DashboardLayout({ children }: { children: React.Re<><AuthProvider user={user} /><BrandLoader brands={brands} />- <GettingStartedPageOpened /><PlanProviderplanId={planId}allowedModelIds={allowedModelIds}@@ -116,6 +115,8 @@ export default async function DashboardLayout({ children }: { children: React.Re><RoleProvider role={role}><UpgradeDialogProvider adminName={adminName} organizationId={profile.organization_id}>+ {/* Inside the provider: it records nothing while the workspace is read-only. */}+ <GettingStartedPageOpened /><MenuAccessProvider hidden={menu.hidden} canManageMenus={menu.canManageMenus}><AiUsageProvider><div className="flex h-screen overflow-hidden">diff --git a/web/src/components/action-center/action-drawer.test.tsx b/web/src/components/action-center/action-drawer.test.tsxindex 27bed143e..a7e21cb93 100644--- a/web/src/components/action-center/action-drawer.test.tsx+++ b/web/src/components/action-center/action-drawer.test.tsx@@ -4,9 +4,10 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import type { ActionItem } from '@/lib/actions/action-center';import type { Signal } from '@/lib/signals/map';-import { promptVolumeEstimate } from '@/lib/volume-estimate';import { parseTaskDetails } from '@/lib/action-center/task-details';+import { promptVolumeEstimate } from '@/lib/volume-estimate';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** Status, assignee and due date sit right under the drawer's header, ahead of@@ -28,6 +29,7 @@ const server = vi.hoisted(() => ({const toast = vi.hoisted(() => ({ success: vi.fn(), error: vi.fn(), warning: vi.fn() }));const push = vi.hoisted(() => vi.fn());const drafts = vi.hoisted(() => ({ getActionDrafts: vi.fn(), startDraftFromAction: vi.fn() }));+const taskCheck = vi.hoisted(() => ({ checkActionTask: vi.fn() }));vi.mock('@/i18n/navigation', () => ({useRouter: () => ({ push }),Link: ({ href, children, ...rest }: { href: string; children: React.ReactNode }) => (@@ -38,6 +40,7 @@ vi.mock('@/i18n/navigation', () => ({}));vi.mock('@/lib/actions/action-center', () => server);vi.mock('@/lib/actions/content-drafts', () => drafts);+vi.mock('@/lib/actions/action-task-check', () => taskCheck);vi.mock('sonner', () => ({ toast }));const { ActionDrawer } = await import('./action-drawer');@@ -70,6 +73,7 @@ let container: HTMLDivElement;let root: Root;const onChanged = vi.fn();const onPatched = vi.fn();+const openUpgrade = vi.fn();const emptyDetail = { tasks: [], signals: [], events: [], kpis: [], positionOutcome: null };@@ -88,18 +92,22 @@ afterEach(() => {container.remove();});-async function renderDrawer(shown: ActionItem = action) {+async function renderDrawer(shown: ActionItem = action, isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <ActionDrawer- brandId="b1"- action={shown}- members={[]}- onOpenChange={() => {}}- onChanged={onChanged}- onPatched={onPatched}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ActionDrawer+ brandId="b1"+ action={shown}+ members={[]}+ onOpenChange={() => {}}+ onChanged={onChanged}+ onPatched={onPatched}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -245,6 +253,25 @@ describe('ActionDrawer', () => {expect(onChanged).toHaveBeenCalledTimes(1);});+ it('changes nothing on a read-only workspace: the due date and Add task open the upgrade dialog', async () => {+ await renderDrawer(action, true);+ enter('2026-11-18');+ expect(openUpgrade).toHaveBeenLastCalledWith('Setting a due date needs a plan');+ expect(dueDate().value).toBe('2026-11-01');+ await settle();+ expect(server.setActionDueDate).not.toHaveBeenCalled();++ const button = (name: string) =>+ [...document.querySelectorAll<HTMLButtonElement>('button')].find(+ (b) => b.textContent?.trim() === name || b.textContent?.startsWith(`${name} (`),+ )!;+ await act(async () => button('Tasks').click());+ await act(async () => button('Add task').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Adding tasks needs a plan');+ expect(document.querySelector('input[aria-label="Add task"]')).toBeNull();+ expect(server.addTask).not.toHaveBeenCalled();+ });+it("passes a new task's count to the list without reading it again", async () => {await renderDrawer();const button = (name: string) =>@@ -367,6 +394,19 @@ describe('ActionDrawer', () => {expect(push).toHaveBeenCalledWith('/dashboard/content/editor/d-new');});+ it('starts no draft on a read-only workspace: Optimize page opens the upgrade dialog', async () => {+ server.getActionDetail.mockResolvedValue({+ ...emptyDetail,+ tasks: [task('t1', 'optimize_content', 'Optimize the page')],+ });+ await renderDrawer({ ...action, payload: { pages: [PRICING] } }, true);+ await openTask('Optimize the page');+ await act(async () => button('Optimize page')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Optimizing content needs a plan');+ expect(drafts.startDraftFromAction).not.toHaveBeenCalled();+ expect(push).not.toHaveBeenCalled();+ });+it('opens the draft already written, and lists each page when the action names several', async () => {server.getActionDetail.mockResolvedValue({...emptyDetail,@@ -424,3 +464,51 @@ describe('ActionDrawer', () => {});});});++describe('ActionDrawer Check now (AC-010)', () => {+ const checked = {+ id: 't1',+ position: 1,+ status: 'todo',+ taskKey: null,+ title: 'Let AI crawlers in',+ titleParams: {},+ dependsOn: [],+ // A written task is checked on its page when it carries its change (#1683).+ details: parseTaskDetails({+ url: 'https://acme.example/pricing',+ check: 'auto',+ change: { before: 'Disallow: /', after: 'Allow: /' },+ }),+ };+ const button = (name: string) =>+ [...document.querySelectorAll<HTMLButtonElement>('button')].find(+ (b) => b.textContent?.trim() === name || b.textContent?.startsWith(`${name} (`),+ );+ const openTask = async () => {+ await act(async () => button('Tasks')!.click());+ await act(async () => button('1. Let AI crawlers in')!.click());+ };++ it('checks a task on its page now', async () => {+ server.getActionDetail.mockResolvedValue({ ...emptyDetail, tasks: [checked] });+ taskCheck.checkActionTask.mockResolvedValue({+ checked: { at: '2026-10-27T12:00:00Z', passed: true, missing: [] },+ reason: null,+ });+ await renderDrawer();+ await openTask();+ await act(async () => button('Check now')!.click());+ expect(taskCheck.checkActionTask).toHaveBeenCalledExactlyOnceWith('t1');+ expect(openUpgrade).not.toHaveBeenCalled();+ });++ it('checks nothing on a read-only workspace: Check now opens the upgrade dialog', async () => {+ server.getActionDetail.mockResolvedValue({ ...emptyDetail, tasks: [checked] });+ await renderDrawer(action, true);+ await openTask();+ await act(async () => button('Check now')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Checking a task needs a plan');+ expect(taskCheck.checkActionTask).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/action-center/action-drawer.tsx b/web/src/components/action-center/action-drawer.tsxindex 0eb996f93..20a0f9443 100644--- a/web/src/components/action-center/action-drawer.tsx+++ b/web/src/components/action-center/action-drawer.tsx@@ -6,6 +6,7 @@ import { useRouter } from '@/i18n/navigation';import { toast } from 'sonner';import { ChevronRight, Plus, Trash2 } from 'lucide-react';import { RemovedNote } from '@/components/action-center/removed-note';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { Badge } from '@/components/ui/badge';import { Button } from '@/components/ui/button';import { Input } from '@/components/ui/input';@@ -155,6 +156,11 @@ export function ActionDrawer({const [detail, setDetail] = useState<ActionDetail | null>(null);const [isBusy, setIsBusy] = useState(false);const tSend = useTranslations('actionCenter.actionsPage.drawer.send');+ // A read-only workspace (plan not active): the status, assignee and due+ // date, and the Tasks tab's changes, sends and drafts, open the upgrade+ // dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Check now (AC-010): the task being checked, and the card's words.const tTaskCard = useTranslations('actionCenter.actionsPage.drawer.task');const missingText = useMissingText();@@ -482,14 +488,16 @@ export function ActionDrawer({</Label><Selectvalue={action.status}- onValueChange={(value) =>- // Dismissing asks why first (learning A5).- value === 'dismissed'- ? setDismissing(true)- : void changeField({ status: value as ActionStatus }, () =>- updateActionStatus(brandId, action.id, value as ActionStatus),- )- }+ onValueChange={guard(+ (value: string | null) =>+ // Dismissing asks why first (learning A5).+ value === 'dismissed'+ ? setDismissing(true)+ : void changeField({ status: value as ActionStatus }, () =>+ updateActionStatus(brandId, action.id, value as ActionStatus),+ ),+ { action: tActions('changeActionStatus') },+ )}items={ACTION_STATUSES.map((status) => ({value: status,label: t(`status.${status}`),@@ -513,12 +521,15 @@ export function ActionDrawer({</Label><Selectvalue={action.assignee?.id ?? 'unassigned'}- onValueChange={(value) => {- const assigneeId = value === 'unassigned' ? null : value;- void changeField({ assignee: pickedAssignee(assigneeId, members) }, () =>- assignAction(brandId, action.id, assigneeId),- );- }}+ onValueChange={guard(+ (value: string | null) => {+ const assigneeId = value === 'unassigned' ? null : value;+ void changeField({ assignee: pickedAssignee(assigneeId, members) }, () =>+ assignAction(brandId, action.id, assigneeId),+ );+ },+ { action: tActions('assignActions') },+ )}items={[{ value: 'unassigned', label: t('filters.unassigned') },...members.map((member) => ({@@ -551,15 +562,18 @@ export function ActionDrawer({min={DUE_DATE_MIN}max={DUE_DATE_MAX}value={dueDraft ?? action.dueDate ?? ''}- onChange={(e) => {- const { value, validity } = e.target;- setDueDraft(value);- clearTimeout(dueTimer.current);- // Cleared, or a whole date in range: saved once it settles.- if (validity.valid) {- dueTimer.current = setTimeout(() => commitDueDate(value), DUE_DATE_SETTLE_MS);- }- }}+ onChange={guard(+ (e: React.ChangeEvent<HTMLInputElement>) => {+ const { value, validity } = e.target;+ setDueDraft(value);+ clearTimeout(dueTimer.current);+ // Cleared, or a whole date in range: saved once it settles.+ if (validity.valid) {+ dueTimer.current = setTimeout(() => commitDueDate(value), DUE_DATE_SETTLE_MS);+ }+ },+ { action: tActions('setDueDate') },+ )}onBlur={(e) => {if (dueDraft === null) return;// Leaving the field saves what it holds now; a half-typed or@@ -725,7 +739,11 @@ export function ActionDrawer({method,pages: method === 'optimize' ? actionPages(action.payload) : [],drafts,- onStart: (page) => void startDraft(task.id, page),+ onStart: guard((page: string | null) => void startDraft(task.id, page), {+ action: tActions(+ method === 'optimize' ? 'optimizeContent' : 'createContent',+ ),+ }),}: undefined;return (@@ -749,13 +767,22 @@ export function ActionDrawer({// A content task, unless the action itself came from Content.content: task.details?.type === 'content' && !opportunityId,webhook: webhookReady,- onSend: (to) => void sendTask(task.id, taskText(task, tTasks), to),+ onSend: guard(+ (to: 'content' | 'webhook') =>+ void sendTask(task.id, taskText(task, tTasks), to),+ { action: tActions('sendTasks') },+ ),}}// An open task the API checks on its page (AC-010).check={(task.status === 'todo' || task.status === 'in_progress') &&pageCheckable(task, action.kind)- ? { onCheck: () => void checkTask(task.id), busy: checking === task.id }+ ? {+ onCheck: guard(() => void checkTask(task.id), {+ action: tActions('checkTasks'),+ }),+ busy: checking === task.id,+ }: undefined}draftWork={draftWork}@@ -916,6 +943,10 @@ function TaskRow({// without a reason cannot be told apart from an abandoned task later.const [skipDraft, setSkipDraft] = useState<string | null>(null);const locked = disabled || editing || skipDraft !== null;+ // A read-only workspace (plan not active): a status, Delete and Edit open+ // the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');return (<div className="rounded-md border">@@ -953,11 +984,14 @@ function TaskRow({</div><Selectvalue={task.status}- onValueChange={(value) => {- const next = value as TaskStatus;- if (next === 'skipped') setSkipDraft('');- else onStatusChange(next);- }}+ onValueChange={guard(+ (value: string | null) => {+ const next = value as TaskStatus;+ if (next === 'skipped') setSkipDraft('');+ else onStatusChange(next);+ },+ { action: tActions('changeTaskStatus') },+ )}disabled={locked}items={TASK_STATUSES.map((status) => ({ value: status, label: statusLabel(status) }))}>@@ -977,7 +1011,7 @@ function TaskRow({variant="ghost"size="icon"disabled={locked}- onClick={onDelete}+ onClick={guard(onDelete, { action: tActions('deleteTasks') })}aria-label={t('drawer.deleteTask')}className="h-7 w-7 shrink-0 text-muted-foreground hover:text-destructive">@@ -1004,7 +1038,7 @@ function TaskRow({<TaskDetailViewdetails={details}disabled={disabled || skipDraft !== null}- onEdit={() => setEditing(true)}+ onEdit={guard(() => setEditing(true), { action: tActions('editTasks') })}send={send}check={check}draftWork={draftWork}@@ -1078,6 +1112,9 @@ function AddTaskForm({onAdd: (title: string) => void;}) {const [draft, setDraft] = useState<string | null>(null);+ // A read-only workspace (plan not active): the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');if (draft === null) {return (@@ -1086,7 +1123,7 @@ function AddTaskForm({variant="outline"size="sm"disabled={disabled}- onClick={() => setDraft('')}+ onClick={guard(() => setDraft(''), { action: tActions('addTasks') })}className="mt-3 h-8 w-full text-xs"><Plus className="mr-1.5 h-3.5 w-3.5" />diff --git a/web/src/components/action-center/action-table.test.tsx b/web/src/components/action-center/action-table.test.tsxindex 92c9f03ee..427394ff7 100644--- a/web/src/components/action-center/action-table.test.tsx+++ b/web/src/components/action-center/action-table.test.tsx@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';import type { ActionItem } from '@/lib/actions/action-center';import { ActionTable } from './action-table';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =true;@@ -35,19 +36,24 @@ let root: Root;const onSelect = vi.fn();const onStatusChange = vi.fn();const onDelete = vi.fn();+const openUpgrade = vi.fn();-function render(props: Partial<React.ComponentProps<typeof ActionTable>> = {}) {+function render(props: Partial<React.ComponentProps<typeof ActionTable>> = {}, isLocked = false) {act(() => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <ActionTable- actions={[action]}- onSelect={onSelect}- onStatusChange={onStatusChange}- onDelete={onDelete}- canDelete- {...props}- />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ActionTable+ actions={[action]}+ onSelect={onSelect}+ onStatusChange={onStatusChange}+ onDelete={onDelete}+ canDelete+ {...props}+ />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -132,6 +138,17 @@ describe('ActionTable row menu', () => {expect(onSelect).not.toHaveBeenCalled();});+ it('changes and deletes nothing on a read-only workspace: the upgrade dialog instead', async () => {+ render({}, true);+ await act(async () => (await openMenu())[1].click());+ expect(openUpgrade).toHaveBeenLastCalledWith("Changing an action's status needs a plan");+ await act(async () => (await openMenu())[3].click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Deleting actions needs a plan');+ expect(document.querySelector('[role="dialog"]')).toBeNull();+ expect(onStatusChange).not.toHaveBeenCalled();+ expect(onDelete).not.toHaveBeenCalled();+ });+it("keeps Delete off for members who can't delete", async () => {render({ canDelete: false });const items = await openMenu();diff --git a/web/src/components/action-center/action-table.tsx b/web/src/components/action-center/action-table.tsxindex 6f445a1ec..c99eedb23 100644--- a/web/src/components/action-center/action-table.tsx+++ b/web/src/components/action-center/action-table.tsx@@ -64,6 +64,7 @@ import {import type { PriorityLevel } from '@/lib/action-center/priority';import { formatRelative } from '@/lib/format-relative';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';type IconComponent = React.ComponentType<{ className?: string }>;@@ -230,6 +231,10 @@ function ActionMenu({}) {const t = useTranslations('actionCenter.actionsPage');const [confirming, setConfirming] = useState(false);+ // A read-only workspace (plan not active): a status, and Delete (before its+ // confirm), open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Dismissing asks why first (learning A5).const [dismissing, setDismissing] = useState(false);return (@@ -252,9 +257,11 @@ function ActionMenu({<DropdownMenuItemkey={status}disabled={action.status === status}- onClick={() =>- status === 'dismissed' ? setDismissing(true) : onStatusChange(action, status)- }+ onClick={guard(+ () =>+ status === 'dismissed' ? setDismissing(true) : onStatusChange(action, status),+ { action: tActions('changeActionStatus') },+ )}><Icon className="h-4 w-4" />{t(`rowMenu.${status}`)}@@ -265,7 +272,7 @@ function ActionMenu({variant="destructive"disabled={!canDelete}title={canDelete ? undefined : t('rowMenu.deleteNotAllowed')}- onClick={() => setConfirming(true)}+ onClick={guard(() => setConfirming(true), { action: tActions('deleteActions') })}><Trash2 className="h-4 w-4" />{t('rowMenu.delete')}diff --git a/web/src/components/action-center/kpi-framework-drawer.tsx b/web/src/components/action-center/kpi-framework-drawer.tsxindex d9f242e88..ea98c0948 100644--- a/web/src/components/action-center/kpi-framework-drawer.tsx+++ b/web/src/components/action-center/kpi-framework-drawer.tsx@@ -44,6 +44,7 @@ import {} from '@/lib/kpis/registry';import { scaleTargetToWindow } from '@/lib/kpis/status';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';const TEMPLATE_ICONS: Record<KpiTemplateKey, React.ComponentType<{ className?: string }>> = {ai_search_visibility: BarChart3,@@ -116,6 +117,9 @@ export function KpiFrameworkDrawer({}) {const t = useTranslations('actionCenter.drawer');const tRegistry = useTranslations('actionCenter.registry');+ // A read-only workspace (plan not active): Save & Apply opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [isLoading, setIsLoading] = useState(false);const [isSaving, setIsSaving] = useState(false);@@ -211,19 +215,22 @@ export function KpiFrameworkDrawer({setTimeframe(next);};- const handleSave = async () => {- setIsSaving(true);- try {- await saveKpiFramework(brandId, timeframe, entries);- onOpenChange(false);- onSaved();- toast.success(t('saved'));- } catch {- toast.error(t('saveFailed'));- } finally {- setIsSaving(false);- }- };+ const handleSave = guard(+ async () => {+ setIsSaving(true);+ try {+ await saveKpiFramework(brandId, timeframe, entries);+ onOpenChange(false);+ onSaved();+ toast.success(t('saved'));+ } catch {+ toast.error(t('saveFailed'));+ } finally {+ setIsSaving(false);+ }+ },+ { action: tActions('editKpis') },+ );return (<Sheet open={open} onOpenChange={onOpenChange}>diff --git a/web/src/components/action-center/regenerate-tasks.test.tsx b/web/src/components/action-center/regenerate-tasks.test.tsxindex 19bbb857d..362f7cbcf 100644--- a/web/src/components/action-center/regenerate-tasks.test.tsx+++ b/web/src/components/action-center/regenerate-tasks.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const { toast, regenerate } = vi.hoisted(() => ({toast: { success: vi.fn(), error: vi.fn() },@@ -25,12 +26,17 @@ const { RegenerateTasks } = await import('./regenerate-tasks');let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();-function render(node: React.ReactNode) {+function render(node: React.ReactNode, isLocked = false) {act(() => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- {node}+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ {node}+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -80,6 +86,18 @@ describe('RegenerateTasks', () => {expect(onBusyChange.mock.calls).toEqual([[true], [false]]);});+ it('writes nothing on a read-only workspace: the upgrade dialog instead of the question', () => {+ openUpgrade.mockReset();+ render(+ <RegenerateTasks actionId="a1" disabled={false} onBusyChange={vi.fn()} onDone={vi.fn()} />,+ true,+ );+ act(() => button('Regenerate tasks').click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Regenerating tasks needs a plan');+ expect(container.textContent).not.toContain('Done, under-way and hand-added tasks stay.');+ expect(regenerate).not.toHaveBeenCalled();+ });+it('says how many wait in Needs review (AC-010)', async () => {regenerate.mockResolvedValueOnce({ written: 1, kept: 0, reviews: 2 });render(diff --git a/web/src/components/action-center/regenerate-tasks.tsx b/web/src/components/action-center/regenerate-tasks.tsxindex d33314865..23a57d272 100644--- a/web/src/components/action-center/regenerate-tasks.tsx+++ b/web/src/components/action-center/regenerate-tasks.tsx@@ -6,6 +6,7 @@ import { toast } from 'sonner';import { Loader2, RefreshCw } from 'lucide-react';import { Button } from '@/components/ui/button';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { regenerateActionTasks } from '@/lib/actions/action-task-writer';/** Whether this deployment writes tasks (AC-004); the server has its own switch. */@@ -48,6 +49,9 @@ export function RegenerateTasks({const { canManage } = useUserRole();const [confirming, setConfirming] = useState(false);const [busy, setBusy] = useState(false);+ // A read-only workspace (plan not active): the upgrade dialog instead of the question.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const run = async () => {setBusy(true);@@ -123,7 +127,7 @@ export function RegenerateTasks({variant="outline"size="sm"disabled={disabled}- onClick={() => setConfirming(true)}+ onClick={guard(() => setConfirming(true), { action: tActions('regenerateTasks') })}className="mt-2 h-8 w-full text-xs"><RefreshCw className="mr-1.5 h-3.5 w-3.5" />diff --git a/web/src/components/citations/add-competitor-button.test.tsx b/web/src/components/citations/add-competitor-button.test.tsxnew file mode 100644index 000000000..0a35abe4f--- /dev/null+++ b/web/src/components/citations/add-competitor-button.test.tsx@@ -0,0 +1,81 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Citations' "Add as competitor" on a read-only workspace (plan not active):+ * the upgrade dialog opens instead of its own, and nothing is added.+ */++const addCompetitor = vi.hoisted(() => vi.fn());+vi.mock('@/lib/actions/competitor', () => ({ addCompetitor }));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { AddCompetitorButton } = await import('./add-competitor-button');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();+const onAdded = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ addCompetitor.mockResolvedValue({ id: 'c1' });+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AddCompetitorButton brandId="b1" domain="rival.com" onAdded={onAdded} />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const open = () =>+ act(async () =>+ container+ .querySelector<HTMLButtonElement>('button[aria-label="Add rival.com as competitor"]')!+ .click(),+ );++describe('AddCompetitorButton', () => {+ it('adds nothing on a read-only workspace: the upgrade dialog opens instead', async () => {+ await render(true);+ await open();+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding competitors needs a plan');+ expect(document.querySelector('[role="dialog"]')).toBeNull();+ expect(addCompetitor).not.toHaveBeenCalled();+ });++ it('asks for the name, then adds it, on an active plan', async () => {+ await render(false);+ await open();+ const add = [...document.querySelectorAll<HTMLButtonElement>('[role="dialog"] button')].find(+ (b) => b.textContent?.trim() === 'Add',+ )!;+ await act(async () => add.click());+ expect(addCompetitor).toHaveBeenCalledWith('b1', { name: 'Rival', domain: 'rival.com' });+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/citations/add-competitor-button.tsx b/web/src/components/citations/add-competitor-button.tsxindex aabcdf5ef..c9ba366c8 100644--- a/web/src/components/citations/add-competitor-button.tsx+++ b/web/src/components/citations/add-competitor-button.tsx@@ -7,6 +7,7 @@*/import { useId, useState } from 'react';+import { useTranslations } from 'next-intl';import { toast } from 'sonner';import { Loader2, Plus } from 'lucide-react';import { Button } from '@/components/ui/button';@@ -21,6 +22,7 @@ import {DialogTitle,} from '@/components/ui/dialog';import { addCompetitor } from '@/lib/actions/competitor';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/** Turn a domain into a first-guess competitor name, e.g. caranddriver.com → "Caranddriver". */export function deriveCompetitorName(domain: string): string {@@ -48,11 +50,17 @@ export function AddCompetitorButton({const [name, setName] = useState('');const [saving, setSaving] = useState(false);const nameId = useId();+ // A read-only workspace (plan not active): the upgrade dialog instead of this one.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');- function openDialog() {- setName(deriveCompetitorName(domain));- setOpen(true);- }+ const openDialog = guard(+ () => {+ setName(deriveCompetitorName(domain));+ setOpen(true);+ },+ { action: tActions('addCompetitors') },+ );async function handleAdd() {const trimmed = name.trim();diff --git a/web/src/components/dashboard/add-brand-link.test.tsx b/web/src/components/dashboard/add-brand-link.test.tsxnew file mode 100644index 000000000..af22da481--- /dev/null+++ b/web/src/components/dashboard/add-brand-link.test.tsx@@ -0,0 +1,108 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * The links to a new brand that AddBrandLink makes: the brands page's empty+ * state and the dashboard's "No brands yet". On a read-only workspace (plan+ * not active) they open the upgrade dialog instead of the new brand's page.+ */++vi.mock('@/i18n/navigation', () => ({+ usePathname: () => '/dashboard/content',+ Link: ({ href, children, ...rest }: { href: string; children?: React.ReactNode }) => (+ <a href={href} {...rest}>+ {children}+ </a>+ ),+}));+const store = vi.hoisted(() => ({+ brands: [] as unknown[],+ activeBrandId: null,+ setActiveBrand: vi.fn(),+ setBrands: vi.fn(),+}));+vi.mock('@/stores/use-brand-store', () => ({+ useBrandStore: (select?: (state: typeof store) => unknown) => (select ? select(store) : store),+}));+vi.mock('@/hooks/use-user-role', () => ({ useUserRole: () => ({ canManage: true }) }));++const { BrandsClient } = await import('@/app/[locale]/(dashboard)/dashboard/brands/_brands-client');+const { BrandGuard } = await import('@/components/providers/brand-guard');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+});++async function render(ui: React.ReactNode, isLocked: boolean) {+ await act(async () =>+ root.render(+ <NextIntlClientProvider locale="en" messages={messages}>+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ {ui}+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ ),+ );+}++/** Clicks the new brand's link; true when the page let it through. */+async function followAddBrand() {+ const link = container.querySelector<HTMLAnchorElement>('a[href="/dashboard/brands/new"]')!;+ // Read once the click has bubbled past React's handler; jsdom can't follow it.+ let followed = false;+ const seen = (e: Event) => {+ followed = !e.defaultPrevented;+ e.preventDefault();+ };+ document.addEventListener('click', seen);+ await act(async () =>+ link.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true })),+ );+ document.removeEventListener('click', seen);+ return followed;+}++describe.each([+ ['the brands page with no brand', () => <BrandsClient brands={[]} />],+ [+ "the dashboard's No brands yet",+ () => (+ <BrandGuard>+ <p>page</p>+ </BrandGuard>+ ),+ ],+])('Add Brand on %s', (_name, ui) => {+ it('opens the upgrade dialog, not the new brand page, on a read-only workspace', async () => {+ await render(ui(), true);+ expect(await followAddBrand()).toBe(false);+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding brands needs a plan');+ });++ it('goes to the new brand page on an active plan', async () => {+ await render(ui(), false);+ expect(await followAddBrand()).toBe(true);+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/dashboard/add-brand-link.tsx b/web/src/components/dashboard/add-brand-link.tsxnew file mode 100644index 000000000..aa5cf6e87--- /dev/null+++ b/web/src/components/dashboard/add-brand-link.tsx@@ -0,0 +1,37 @@+'use client';++import type { ReactNode } from 'react';+import { useTranslations } from 'next-intl';+import { Link } from '@/i18n/navigation';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';++/**+ * The link to a new brand (/dashboard/brands/new), or to Billing at the+ * plan's brand limit. On a read-only workspace (plan not active) it opens the+ * upgrade dialog instead of the page.+ */+export function AddBrandLink({+ href = '/dashboard/brands/new',+ className,+ children,+}: {+ href?: string;+ className?: string;+ children: ReactNode;+}) {+ const { isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');+ return (+ <Link+ href={href}+ className={className}+ onClick={(e) => {+ if (!isLocked) return;+ e.preventDefault();+ openUpgrade(tActions('addBrands'));+ }}+ >+ {children}+ </Link>+ );+}diff --git a/web/src/components/getting-started/page-opened.test.tsx b/web/src/components/getting-started/page-opened.test.tsxindex 02bb76a5a..c1c552ec3 100644--- a/web/src/components/getting-started/page-opened.test.tsx+++ b/web/src/components/getting-started/page-opened.test.tsx@@ -26,6 +26,7 @@ vi.mock('@/stores/use-brand-store', () => ({vi.mock('@/lib/actions/getting-started', () => ({ markGettingStartedPageOpened }));const { GettingStartedPageOpened } = await import('./page-opened');+const { UpgradeDialogContext } = await import('@/components/providers/upgrade-gate');// An in-memory localStorage: the test environment has none.const store = new Map<string, string>();@@ -42,8 +43,16 @@ Object.defineProperty(window, 'localStorage', {let container: HTMLDivElement;let root: Root;-async function render() {- await act(async () => root.render(<GettingStartedPageOpened />));+async function render(isLocked = false) {+ await act(async () =>+ root.render(+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade: vi.fn() }}+ >+ <GettingStartedPageOpened />+ </UpgradeDialogContext.Provider>,+ ),+ );}beforeEach(() => {@@ -78,6 +87,11 @@ describe('GettingStartedPageOpened', () => {expect(localStorage.getItem('aeo:getting-started:b1:mentions')).toBeNull();});+ it('records nothing while the workspace is read-only (plan not active): it writes', async () => {+ await render(true);+ expect(markGettingStartedPageOpened).not.toHaveBeenCalled();+ });+it('leaves other pages, and a missing brand, alone', async () => {nav.pathname = '/dashboard/action-center/actions';await render();diff --git a/web/src/components/getting-started/page-opened.tsx b/web/src/components/getting-started/page-opened.tsxindex 40e3296b2..f72af3af0 100644--- a/web/src/components/getting-started/page-opened.tsx+++ b/web/src/components/getting-started/page-opened.tsx@@ -5,21 +5,24 @@ import { usePathname } from '@/i18n/navigation';import { useBrandStore } from '@/stores/use-brand-store';import { markGettingStartedPageOpened } from '@/lib/actions/getting-started';import { pageOpenedStep } from '@/lib/getting-started/steps';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Getting started's explore steps ("See where you stand in Brand Visibility" and* the like) are done when their page is opened. Mounted once in the* dashboard layout, so it counts the page however it was reached: the step's* button, the sidebar or a link. Each brand and step is sent until the- * server records it, then remembered in this browser.+ * server records it, then remembered in this browser. Not sent while the+ * workspace is read-only (plan not active): it writes.*/export function GettingStartedPageOpened() {const pathname = usePathname();const brandId = useBrandStore((s) => s.activeBrandId);+ const { isLocked } = useUpgradeGate();useEffect(() => {const step = pageOpenedStep(pathname);- if (!step || !brandId) return;+ if (!step || !brandId || isLocked) return;const key = `aeo:getting-started:${brandId}:${step}`;try {if (localStorage.getItem(key)) return;@@ -38,7 +41,7 @@ export function GettingStartedPageOpened() {.catch(() => {// A database without 00196, or offline: the step stays open.});- }, [pathname, brandId]);+ }, [pathname, brandId, isLocked]);return null;}diff --git a/web/src/components/getting-started/step-card.test.tsx b/web/src/components/getting-started/step-card.test.tsxindex a54355071..02ac7835a 100644--- a/web/src/components/getting-started/step-card.test.tsx+++ b/web/src/components/getting-started/step-card.test.tsx@@ -36,6 +36,7 @@ vi.mock('sonner', () => ({ toast }));vi.mock('@/lib/actions/getting-started', () => ({ skipGettingStartedStep }));const { GettingStartedStepCard } = await import('./step-card');+const { UpgradeDialogContext } = await import('@/components/providers/upgrade-gate');const step = (over: Partial<GettingStartedStep> = {}): GettingStartedStep => ({key: 'mentions',@@ -52,19 +53,24 @@ let root: Root;const onClose = vi.fn();const onChanged = vi.fn();const onReady = vi.fn();+const openUpgrade = vi.fn();-async function render(s: GettingStartedStep, { canManage = true } = {}) {+async function render(s: GettingStartedStep, { canManage = true, isLocked = false } = {}) {await act(async () =>root.render(- <GettingStartedStepCard- brandId="b1"- step={s}- members={[]}- canManage={canManage}- onClose={onClose}- onChanged={onChanged}- onReady={onReady}- />,+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <GettingStartedStepCard+ brandId="b1"+ step={s}+ members={[]}+ canManage={canManage}+ onClose={onClose}+ onChanged={onChanged}+ onReady={onReady}+ />+ </UpgradeDialogContext.Provider>,),);}@@ -132,6 +138,16 @@ describe('GettingStartedStepCard', () => {expect(onChanged).toHaveBeenCalled();});+ it('skips nothing on a read-only workspace: Skip opens the upgrade dialog, not the question', async () => {+ openUpgrade.mockReset();+ await render(step({ key: 'gsc', stage: 'setup', optional: true }), { isLocked: true });+ await act(async () => button('panel.skip')!.click());+ // next-intl is mocked: the label is its key.+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('skipSteps');+ expect(text()).not.toContain('skipDialog.lessAccurate');+ expect(skipGettingStartedStep).not.toHaveBeenCalled();+ });+it('offers no Skip on a required step or one already skipped', async () => {await render(step());expect(button('panel.skip')).toBeUndefined();diff --git a/web/src/components/getting-started/step-card.tsx b/web/src/components/getting-started/step-card.tsxindex 46401fa63..cc501d794 100644--- a/web/src/components/getting-started/step-card.tsx+++ b/web/src/components/getting-started/step-card.tsx@@ -20,6 +20,7 @@ import { skipGettingStartedStep } from '@/lib/actions/getting-started';import type { TeamMember } from '@/lib/actions/team';import type { GettingStartedStep } from '@/lib/getting-started/steps';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {GETTING_STARTED_CHIP,StepStatusBadge,@@ -60,6 +61,10 @@ export function GettingStartedStepCard({const [opened, setOpened] = useState(false);const [confirmingSkip, setConfirmingSkip] = useState(false);const [skipping, setSkipping] = useState(false);+ // A read-only workspace (plan not active): Skip opens the upgrade dialog+ // instead of its question; opening the step's page stays.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Another step: its own "opened" note.useEffect(() => setOpened(false), [step.key]);@@ -123,7 +128,7 @@ export function GettingStartedStepCard({<Buttonvariant="ghost"disabled={skipping}- onClick={() => setConfirmingSkip(true)}+ onClick={guard(() => setConfirmingSkip(true), { action: tActions('skipSteps') })}className="text-muted-foreground">{t('panel.skip')}diff --git a/web/src/components/layout/brand-switcher.test.tsx b/web/src/components/layout/brand-switcher.test.tsxindex a5bbf3f8b..4b769ab85 100644--- a/web/src/components/layout/brand-switcher.test.tsx+++ b/web/src/components/layout/brand-switcher.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';import { BrandSwitcher } from './brand-switcher';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const push = vi.fn();const nav = vi.hoisted(() => ({ pathname: '/dashboard/content' }));@@ -40,12 +41,17 @@ vi.mock('@/hooks/use-user-role', () => ({ useUserRole: () => role }));let container: HTMLDivElement;let root: Root;const onNavigate = vi.fn();+const openUpgrade = vi.fn();-async function render(collapsed = false) {+async function render(collapsed = false, isLocked = false) {await act(async () =>root.render(<NextIntlClientProvider locale="en" messages={messages}>- <BrandSwitcher collapsed={collapsed} onNavigate={onNavigate} />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <BrandSwitcher collapsed={collapsed} onNavigate={onNavigate} />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,),);@@ -69,6 +75,7 @@ beforeEach(() => {store.activeBrandId = 'b1';push.mockReset();onNavigate.mockReset();+ openUpgrade.mockReset();store.setActiveBrand.mockReset();nav.pathname = '/dashboard/content';role.canManage = true;@@ -132,6 +139,35 @@ describe('BrandSwitcher', () => {expect(push).toHaveBeenCalledWith('/dashboard/brands/new');});+ it('adds no brand on a read-only workspace: Add Brand opens the upgrade dialog', async () => {+ await render(false, true);+ const items = await openMenu();+ await act(async () => items[3].click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Adding brands needs a plan');+ expect(push).not.toHaveBeenCalled();+ // The mobile menu closes first, so the dialog isn't left behind it.+ expect(onNavigate).toHaveBeenCalledOnce();+ expect(onNavigate.mock.invocationCallOrder[0]).toBeLessThan(+ openUpgrade.mock.invocationCallOrder[0],+ );+ // All brands is reading: it stays open.+ await act(async () => (await openMenu())[2].click());+ expect(push).toHaveBeenCalledWith('/dashboard/brands');++ // With no brand yet, the menu is the Add Brand button.+ act(() => root.unmount());+ document.body.replaceChildren(container);+ root = createRoot(container);+ store.brands = [];+ push.mockReset();+ await render(false, true);+ onNavigate.mockReset();+ await act(async () => container.querySelector('button')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Adding brands needs a plan');+ expect(onNavigate).toHaveBeenCalledOnce();+ expect(push).not.toHaveBeenCalled();+ });+// brands: admin/manager insert — the others would hit the wizard's first error.it('offers Add Brand to admins and managers only', async () => {role.canManage = false;diff --git a/web/src/components/layout/brand-switcher.tsx b/web/src/components/layout/brand-switcher.tsxindex d26c8c03c..8363c3c9f 100644--- a/web/src/components/layout/brand-switcher.tsx+++ b/web/src/components/layout/brand-switcher.tsx@@ -6,6 +6,7 @@ import { brandPagePath } from '@/lib/brand-path';import type { Brand } from '@/types';import { useBrandStore } from '@/stores/use-brand-store';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {DropdownMenu,DropdownMenuContent,@@ -47,6 +48,19 @@ export function BrandSwitcher({ collapsed = false, onOpenChange, onNavigate }: BonNavigate?.();router.push(href);};+ // A read-only workspace (plan not active): Add brand opens the upgrade+ // dialog instead of the new brand's page, the mobile menu closed first so+ // the dialog isn't left behind it.+ const { isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');+ const addBrand = () => {+ if (isLocked) {+ onNavigate?.();+ openUpgrade(tActions('addBrands'));+ } else {+ go('/dashboard/brands/new');+ }+ };// On a brand's own page (its settings, prompts or topics), the same page// of the brand picked; elsewhere the page stays.const select = (brandId: string) => {@@ -59,7 +73,7 @@ export function BrandSwitcher({ collapsed = false, onOpenChange, onNavigate }: Bif (!canManage) return null;return (<button- onClick={() => go('/dashboard/brands/new')}+ onClick={addBrand}className={cn('flex w-full items-center gap-2 rounded-md border border-dashed px-2 py-2 text-sm text-muted-foreground transition-colors hover:border-primary hover:text-primary',collapsed && 'justify-center px-0',@@ -128,7 +142,7 @@ export function BrandSwitcher({ collapsed = false, onOpenChange, onNavigate }: B</DropdownMenuItem>{canManage && (<DropdownMenuItem- onClick={() => go('/dashboard/brands/new')}+ onClick={addBrand}className="flex items-center gap-2 text-muted-foreground"><div className="flex h-5 w-5 shrink-0 items-center justify-center rounded-md border">diff --git a/web/src/components/providers/brand-guard.tsx b/web/src/components/providers/brand-guard.tsxindex 0a02d5e1b..8be11322c 100644--- a/web/src/components/providers/brand-guard.tsx+++ b/web/src/components/providers/brand-guard.tsx@@ -6,7 +6,7 @@ import { BrandAvatar } from '@/components/brand-avatar';import { Button } from '@/components/ui/button';import { Card, CardContent } from '@/components/ui/card';import { Skeleton } from '@/components/ui/skeleton';-import { Link } from '@/i18n/navigation';+import { AddBrandLink } from '@/components/dashboard/add-brand-link';import { Building2, Plus, ChevronRight } from 'lucide-react';import { usePathname } from '@/i18n/navigation';@@ -81,12 +81,12 @@ function NoBrandsState() {<p className="mt-2 max-w-sm text-sm text-muted-foreground">Create your first brand to start tracking how AI engines talk about you.</p>- <Link href="/dashboard/brands/new" className="mt-6">+ <AddBrandLink className="mt-6"><Button className="gap-2"><Plus className="h-4 w-4" />Create Brand</Button>- </Link>+ </AddBrandLink></div>);}diff --git a/web/src/components/settings/ai-providers-section.test.tsx b/web/src/components/settings/ai-providers-section.test.tsxindex 2a315bdfa..ea96a549f 100644--- a/web/src/components/settings/ai-providers-section.test.tsx+++ b/web/src/components/settings/ai-providers-section.test.tsx@@ -3,10 +3,13 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** Settings › AI Providers: a row per provider with its saved key, the one* Chat uses, and — for admins — adding, replacing, switching and removing.+ * On a read-only workspace (plan not active) adding, replacing and switching+ * open the upgrade dialog; removing a key stays open.*/const toast = vi.hoisted(() => ({ error: vi.fn(), success: vi.fn() }));@@ -26,6 +29,7 @@ let container: HTMLDivElement;let root: Root;const fetchMock = vi.fn();let saved: unknown[];+const openUpgrade = vi.fn();const json = (body: unknown, status = 200) =>new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });@@ -67,11 +71,15 @@ afterEach(() => {vi.unstubAllGlobals();});-async function render() {+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages}>- <AiProvidersSection />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AiProvidersSection />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -163,6 +171,28 @@ describe('AiProvidersSection', () => {});});+ it('on a read-only workspace, saves and switches nothing, and still removes a key', async () => {+ await render(true);+ act(() => button(row('azure'), 'Add key').click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Saving an AI key needs a plan');+ expect(row('azure').querySelector('form')).toBeNull();+ await act(async () => button(row('openai'), 'Use for Chat').click());+ expect(openUpgrade).toHaveBeenLastCalledWith("Switching Chat's AI provider needs a plan");+ // Only the read went out.+ expect(fetchMock).toHaveBeenCalledTimes(1);++ act(() =>+ (+ row('openai').querySelector('button[aria-label="Remove key: OpenAI"]') as HTMLElement+ ).click(),+ );+ await act(async () => button(document.body, 'Remove').click());+ expect(fetchMock).toHaveBeenCalledWith('/api/settings/ai-providers?provider=openai', {+ method: 'DELETE',+ });+ expect(openUpgrade).toHaveBeenCalledTimes(2);+ });+it('shows members the keys without the buttons that change them', async () => {canAdmin = false;saved = [];diff --git a/web/src/components/settings/ai-providers-section.tsx b/web/src/components/settings/ai-providers-section.tsxindex a5db3517d..8c55049fe 100644--- a/web/src/components/settings/ai-providers-section.tsx+++ b/web/src/components/settings/ai-providers-section.tsx@@ -12,6 +12,7 @@ import { CheckCircle2, Cloud, Loader2, Lock, Route, Sparkles, Trash2 } from 'lucimport { useTranslations } from 'next-intl';import { AIProviderAvatar } from '@/components/ai-provider-avatar';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { formatDate } from '@/lib/format';import {AI_PROVIDERS,@@ -82,6 +83,11 @@ export function AiProvidersSection() {const [confirmRemove, setConfirmRemove] = useState<AiProvider | null>(null);const [removeOpen, setRemoveOpen] = useState(false);const [removing, setRemoving] = useState(false);+ // A read-only workspace (plan not active): Add key, Replace and Use for+ // Chat open the upgrade dialog instead. Removing a key stays open: it takes+ // back the access to the person's own AI account.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const name = (provider: AiProvider) => t(`agent_providers.${provider}.name`);@@ -209,7 +215,9 @@ export function AiProvidersSection() {variant="outline"size="sm"disabled={switching !== null}- onClick={() => void handleUse(provider)}+ onClick={guard(() => void handleUse(provider), {+ action: tActions('switchAiProvider'),+ })}>{switching === provider && (<Loader2 className="mr-2 h-3.5 w-3.5 animate-spin" />@@ -217,7 +225,13 @@ export function AiProvidersSection() {{t('agent_useForChat')}</Button>)}- <Button variant="outline" size="sm" onClick={() => setEditing(provider)}>+ <Button+ variant="outline"+ size="sm"+ onClick={guard(() => setEditing(provider), {+ action: tActions('saveAiKeys'),+ })}+ >{row ? t('agent_replace') : t('agent_addKey')}</Button>{row && (diff --git a/web/src/components/settings/api-keys-section.test.tsx b/web/src/components/settings/api-keys-section.test.tsxnew file mode 100644index 000000000..a94d4f063--- /dev/null+++ b/web/src/components/settings/api-keys-section.test.tsx@@ -0,0 +1,98 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Settings › API keys on a read-only workspace (plan not active): the keys+ * show and both New key and revoking stay open. A key costs nothing, and the+ * MCP surface it opens only reads for such a workspace.+ */++vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { ApiKeysSection } = await import('./api-keys-section');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();+const fetchMock = vi.fn();++const json = (body: unknown, status = 200) =>+ new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });++beforeEach(() => {+ vi.clearAllMocks();+ fetchMock.mockImplementation(async (_url: string, init?: RequestInit) =>+ !init?.method+ ? json({+ keys: [+ {+ id: 'k1',+ name: 'MCP — laptop',+ prefix: 'ak_1234',+ created_at: '2026-10-01T00:00:00Z',+ last_used_at: null,+ revoked_at: null,+ },+ ],+ })+ : json({ ok: true }),+ );+ vi.stubGlobal('fetch', fetchMock);+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+ vi.unstubAllGlobals();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ApiKeysSection />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const button = (text: string) =>+ [...document.body.querySelectorAll('button')].find((b) => b.textContent?.trim() === text);++describe('ApiKeysSection', () => {+ it('creates and revokes keys on a read-only workspace', async () => {+ await render(true);+ expect(container.textContent).toContain('MCP — laptop');+ await act(async () => button('New key')!.click());+ expect(document.querySelector('[role="dialog"]')?.textContent).toContain('New API key');+ await act(async () => button('Cancel')!.click());++ const trash = container.querySelector<HTMLButtonElement>('button.text-destructive')!;+ await act(async () => trash.click());+ await act(async () => button('Revoke')!.click());+ expect(fetchMock).toHaveBeenCalledWith('/api/keys/k1', { method: 'DELETE' });+ expect(openUpgrade).not.toHaveBeenCalled();+ });++ it('opens New key on an active plan', async () => {+ await render(false);+ await act(async () => button('New key')!.click());+ expect(document.querySelector('[role="dialog"]')?.textContent).toContain('New API key');+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/settings/authors-section.test.tsx b/web/src/components/settings/authors-section.test.tsxindex 7c0a46002..f971be8ba 100644--- a/web/src/components/settings/authors-section.test.tsx+++ b/web/src/components/settings/authors-section.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';import type { AuthorsRead } from '@/lib/content/authors';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** Settings › Authors (CE-037): the workspace's real authors; whoever added@@ -81,6 +82,7 @@ function workspace(role: string): AuthorsRead {let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();beforeEach(() => {for (const fn of [...Object.values(actions), toast.success, toast.error]) fn.mockReset();@@ -100,11 +102,15 @@ afterEach(() => {document.body.replaceChildren();});-async function render() {+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <AuthorsSection />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <AuthorsSection />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -325,6 +331,24 @@ describe('AuthorsSection', () => {);});+ it('on a read-only workspace, adds, edits, removes and sets nothing', async () => {+ actions.getContentAuthors.mockResolvedValue(workspace('manager'));+ openUpgrade.mockClear();+ await render(true);+ await click(buttons('Add author')[0]);+ expect(openUpgrade).toHaveBeenLastCalledWith('Adding authors needs a plan');+ await click(row('Cal Freelance').querySelectorAll('button')[0]);+ expect(openUpgrade).toHaveBeenLastCalledWith('Editing authors needs a plan');+ await click(row('Cal Freelance').querySelectorAll('button')[1]);+ expect(openUpgrade).toHaveBeenLastCalledWith('Removing authors needs a plan');+ await click(byline());+ expect(openUpgrade).toHaveBeenLastCalledWith('Changing the byline setting needs a plan');+ expect(openUpgrade).toHaveBeenCalledTimes(4);+ expect(document.querySelector('[role="dialog"]')).toBeNull();+ expect(actions.setBrandByline).not.toHaveBeenCalled();+ expect(actions.deleteContentAuthor).not.toHaveBeenCalled();+ });+it("says so when the authors can't be read", async () => {actions.getContentAuthors.mockResolvedValue(null);await render();diff --git a/web/src/components/settings/authors-section.tsx b/web/src/components/settings/authors-section.tsxindex a992f4bfa..2b0edd143 100644--- a/web/src/components/settings/authors-section.tsx+++ b/web/src/components/settings/authors-section.tsx@@ -44,6 +44,7 @@ import {type ContentAuthor,} from '@/lib/content/authors';import { cn } from '@/lib/utils';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/** The organization byline in a brand's default select: no author. */const ORGANIZATION = 'organization';@@ -70,6 +71,10 @@ export function AuthorsSection() {const [picking, setPicking] = useState<Record<string, string>>({});/** A brand's Add byline to content being saved, likewise. */const [bylining, setBylining] = useState<Record<string, boolean>>({});+ // A read-only workspace (plan not active): Add, Edit, Remove, a default+ // and the byline box open the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async () => {try {@@ -209,17 +214,26 @@ export function AuthorsSection() {</div>{canEdit(author) && (<span className="flex shrink-0 gap-1">- <Button variant="ghost" size="sm" onClick={() => setEditing(author)}>+ <Button+ variant="ghost"+ size="sm"+ onClick={guard(() => setEditing(author), {+ action: tActions('editAuthors'),+ })}+ >{t('edit')}</Button><Buttonvariant="ghost"size="sm"className="text-destructive hover:text-destructive"- onClick={() => {- setRemoving(author);- setRemoveOpen(true);- }}+ onClick={guard(+ () => {+ setRemoving(author);+ setRemoveOpen(true);+ },+ { action: tActions('removeAuthors') },+ )}>{t('remove')}</Button>@@ -229,7 +243,10 @@ export function AuthorsSection() {))}</ul>)}- <Button size="sm" onClick={() => setEditing('new')}>+ <Button+ size="sm"+ onClick={guard(() => setEditing('new'), { action: tActions('addAuthors') })}+ >{t('add')}</Button>@@ -258,11 +275,14 @@ export function AuthorsSection() {items={items}value={defaultOf(brand.id)}disabled={!canSetDefaults || brand.id in picking}- onValueChange={(value) => {- if (value && value !== defaultOf(brand.id)) {- void pickDefault(brand.id, value);- }- }}+ onValueChange={guard(+ (value: string | null) => {+ if (value && value !== defaultOf(brand.id)) {+ void pickDefault(brand.id, value);+ }+ },+ { action: tActions('setDefaultAuthor') },+ )}><SelectTriggersize="sm"@@ -285,9 +305,10 @@ export function AuthorsSection() {checked={bylining[brand.id] ?? !!brand.bylineInContent}aria-describedby={`default-${brand.id}`}disabled={!canSetDefaults || brand.id in bylining}- onCheckedChange={(checked) =>- void toggleByline(brand.id, checked === true)- }+ onCheckedChange={guard(+ (checked: boolean) => void toggleByline(brand.id, checked === true),+ { action: tActions('setByline') },+ )}/>{t('bylineInContent')}</label>diff --git a/web/src/components/settings/catalog-category-pages.test.tsx b/web/src/components/settings/catalog-category-pages.test.tsxindex 3dd59b26a..03df06f71 100644--- a/web/src/components/settings/catalog-category-pages.test.tsx+++ b/web/src/components/settings/catalog-category-pages.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';import type { CategoryPage } from '@/lib/catalog-client';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const listCategoryPages = vi.fn();const setCategoryPage = vi.fn();@@ -37,6 +38,7 @@ const { CatalogCategoryPages, shortAddress } = await import('./catalog-category-let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();const CATEGORIES: CategoryPage[] = [{@@ -56,11 +58,16 @@ const CATEGORIES: CategoryPage[] = [{ name: 'Sleeping Bags', products: 9, inStock: 9, page: null, how: null },];-async function render() {+/** `isLocked`: a read-only workspace (plan not active). */+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <CatalogCategoryPages />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <CatalogCategoryPages />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -94,6 +101,7 @@ beforeEach(() => {resetCategoryPage.mockReset().mockResolvedValue({ ok: true, value: true });toast.error.mockReset();toast.success.mockReset();+ openUpgrade.mockReset();container = document.createElement('div');document.body.appendChild(container);root = createRoot(container);@@ -236,4 +244,33 @@ describe('CatalogCategoryPages', () => {expect(button('Change the page for Rain Jackets')!.disabled).toBe(false);expect(button('Save')).toBeUndefined();});++ it('changes no page on a read-only workspace: Change opens the upgrade dialog', async () => {+ await render(true);+ // The table shows as it is.+ expect(container.textContent).toContain('/collections/hiking-boots');+ await act(async () => button('Change the page for Sleeping Bags')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith("Changing a category's page needs a plan");+ expect(+ container.querySelector('input[aria-label="Page address for Sleeping Bags"]'),+ ).toBeNull();+ expect(setCategoryPage).not.toHaveBeenCalled();+ expect(resetCategoryPage).not.toHaveBeenCalled();+ });++ it('opens the upgrade dialog, not a failure, when the server says the plan has ended', async () => {+ await render();+ await act(async () => button('Change the page for Rain Jackets')!.click());+ setCategoryPage.mockResolvedValueOnce({ ok: false, code: 'subscription' });+ await act(async () => button('No page')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith("Changing a category's page needs a plan");+ expect(toast.error).not.toHaveBeenCalled();++ resetCategoryPage.mockResolvedValueOnce({ ok: false, code: 'subscription' });+ await act(async () => button('Use the match')!.click());+ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(toast.error).not.toHaveBeenCalled();+ // The row stays open, to try again with a plan.+ expect(button('Save')!.disabled).toBe(false);+ });});diff --git a/web/src/components/settings/catalog-category-pages.tsx b/web/src/components/settings/catalog-category-pages.tsxindex 9214ebc8f..9e4fb1bea 100644--- a/web/src/components/settings/catalog-category-pages.tsx+++ b/web/src/components/settings/catalog-category-pages.tsx@@ -9,6 +9,7 @@ import { Button } from '@/components/ui/button';import { Input } from '@/components/ui/input';import { Skeleton } from '@/components/ui/skeleton';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {listCategoryPages,resetCategoryPage,@@ -34,7 +35,8 @@ export function shortAddress(url: string): string {* person, so a buying guide or a comparison links to it. Shown once the* brand's catalog has categories, and under its heading when they can't be* read. Admins and managers change a page, set none, or put it back to the- * match; members see the table.+ * match; members see the table. On a read-only workspace (plan not active)+ * the table shows, and changing a page opens the upgrade dialog instead.** `refreshKey`: changed by the page to read the categories again (the* catalog's sources read again: a feed added or synced, a file uploaded).@@ -43,6 +45,9 @@ export function CatalogCategoryPages({ refreshKey = 0 }: { refreshKey?: number }const t = useTranslations('settings.catalog.categories');const { activeBrandId } = useBrandStore();const { canManage } = useUserRole();+ const { guard, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');+ const needsPlan = { action: tActions('changeCategoryPages') };// The categories as read for a brand: another brand's never show.const [loaded, setLoaded] = useState<{@@ -79,6 +84,11 @@ export function CatalogCategoryPages({ refreshKey = 0 }: { refreshKey?: number }result: { ok: true } | { ok: false; code: CategoryPageError },): Promise<void> => {setBusy(false);+ // The plan ended while the page was open: the server's refusal opens the upgrade dialog.+ if (!result.ok && result.code === 'subscription') {+ openUpgrade(needsPlan.action);+ return;+ }if (!result.ok) {toast.error(t(`errors.${result.code}`));return;@@ -87,14 +97,14 @@ export function CatalogCategoryPages({ refreshKey = 0 }: { refreshKey?: number }setEditing(null);setReads((n) => n + 1);};- const save = async (category: string, value: string | null) => {+ const save = guard(async (category: string, value: string | null) => {setBusy(true);await done(await setCategoryPage(activeBrandId, category, value));- };- const reset = async (category: string) => {+ }, needsPlan);+ const reset = guard(async (category: string) => {setBusy(true);await done(await resetCategoryPage(activeBrandId, category));- };+ }, needsPlan);return (<section aria-labelledby="catalog-category-pages" className="space-y-3 rounded-lg border p-4">@@ -222,10 +232,10 @@ export function CatalogCategoryPages({ refreshKey = 0 }: { refreshKey?: number }variant="outline"disabled={busy}aria-label={t('changeLabel', { category: category.name })}- onClick={() => {+ onClick={guard(() => {setEditing({ brandId: activeBrandId, name: category.name });setUrl(category.page?.url ?? '');- }}+ }, needsPlan)}>{t('change')}</Button>diff --git a/web/src/components/settings/catalog-sources-card.test.tsx b/web/src/components/settings/catalog-sources-card.test.tsxindex f00da93fa..2a95a0321 100644--- a/web/src/components/settings/catalog-sources-card.test.tsx+++ b/web/src/components/settings/catalog-sources-card.test.tsx@@ -4,6 +4,7 @@ import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';import type { CatalogSource } from '@/lib/catalog';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';import type { CatalogSourcesRead } from './catalog-sources-card';const listCatalogSources = vi.fn();@@ -45,6 +46,7 @@ const { CatalogSourcesCard } = await import('./catalog-sources-card');let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();const FEED: CatalogSource = {id: 's1',@@ -117,11 +119,23 @@ const ACME = {],};-async function render(refreshKey?: number, onSources?: (read: CatalogSourcesRead | null) => void) {+async function render({+ isLocked = false,+ refreshKey,+ onSources,+}: {+ isLocked?: boolean;+ refreshKey?: number;+ onSources?: (read: CatalogSourcesRead | null) => void;+} = {}) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <CatalogSourcesCard refreshKey={refreshKey} onSources={onSources} />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <CatalogSourcesCard refreshKey={refreshKey} onSources={onSources} />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -213,6 +227,54 @@ describe('CatalogSourcesCard', () => {expect(listCatalogSources).toHaveBeenCalledTimes(2);});+ it('adds, syncs, uploads and removes nothing on a read-only workspace', async () => {+ const confirm = vi.spyOn(window, 'confirm').mockReturnValue(true);+ openUpgrade.mockClear();+ await render({ isLocked: true });+ const input = container.querySelector<HTMLInputElement>('input[type="url"]')!;+ await type(input, 'https://shop.example/meta.csv');+ await act(async () => {+ container+ .querySelector('form')!+ .dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));+ });+ expect(openUpgrade).toHaveBeenLastCalledWith('Adding catalog sources needs a plan');+ await act(async () => button('Upload a file')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Adding catalog sources needs a plan');+ await act(async () => button('Sync now')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Syncing the catalog needs a plan');+ await act(async () => button('Remove')!.click());+ expect(openUpgrade).toHaveBeenLastCalledWith('Removing catalog sources needs a plan');+ expect(openUpgrade).toHaveBeenCalledTimes(4);+ expect(confirm).not.toHaveBeenCalled();+ expect(addFeedSource).not.toHaveBeenCalled();+ expect(syncCatalogSource).not.toHaveBeenCalled();+ expect(removeCatalogSource).not.toHaveBeenCalled();+ confirm.mockRestore();+ });++ it('still removes a store on a read-only workspace (a disconnect), but not a feed', async () => {+ const confirm = vi.spyOn(window, 'confirm').mockReturnValue(true);+ openUpgrade.mockClear();+ listStoreConnectors.mockResolvedValue({ connectors: [ACME], ready: true, signIns: [] });+ listCatalogSources.mockResolvedValue([FEED, STORE]);+ await render({ isLocked: true });+ const removeIn = (text: string) =>+ [...container.querySelectorAll('li')]+ .find((li) => li.textContent?.includes(text))!+ .querySelector<HTMLButtonElement>('button[aria-label="Remove"]')!;++ await act(async () => removeIn('acme-shop.example').click());+ expect(removeStore).toHaveBeenCalledWith('st1');+ expect(openUpgrade).not.toHaveBeenCalled();++ await act(async () => removeIn('https://shop.example/feed.xml').click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Removing catalog sources needs a plan');+ expect(removeCatalogSource).not.toHaveBeenCalled();+ expect(confirm).toHaveBeenCalledTimes(1);+ confirm.mockRestore();+ });+it("says why a feed couldn't be added, or read", async () => {addFeedSource.mockResolvedValue({ ok: false, code: 'duplicate' });await render();@@ -408,15 +470,15 @@ describe('CatalogSourcesCard', () => {});it('reads the sources again when the page asks (an account added above)', async () => {- await render(0);+ await render({ refreshKey: 0 });expect(listCatalogSources).toHaveBeenCalledTimes(1);- await render(1);+ await render({ refreshKey: 1 });expect(listCatalogSources).toHaveBeenCalledTimes(2);});it('tells the page what it read, for the brand', async () => {const onSources = vi.fn();- await render(0, onSources);+ await render({ refreshKey: 0, onSources });expect(onSources).toHaveBeenLastCalledWith(expect.objectContaining({ brandId: 'b1', sources: [FEED] }),);diff --git a/web/src/components/settings/catalog-sources-card.tsx b/web/src/components/settings/catalog-sources-card.tsxindex ffa3d5179..63ea83a27 100644--- a/web/src/components/settings/catalog-sources-card.tsx+++ b/web/src/components/settings/catalog-sources-card.tsx@@ -57,8 +57,12 @@ export function CatalogSourcesCard({const format = useFormatter();const { activeBrandId, brands } = useBrandStore();const { canManage } = useUserRole();- // A read-only workspace's refusal opens the upgrade dialog, not a toast.- const { openUpgrade } = useUpgradeGate();+ // A read-only workspace's refusal opens the upgrade dialog, not a toast;+ // while it is read-only, adding, syncing, uploading, connecting a store or+ // its sign-in, and removing a feed or upload open it before anything is+ // sent. Removing a store stays open: it disconnects the store.+ const { guard, isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const brand = brands.find((b) => b.id === activeBrandId) ?? null;// The sources as read for a brand, and when ("synced 3 hours ago"): another@@ -147,6 +151,8 @@ export function CatalogSourcesCard({setBusy(null);};+ const addFeed = guard(() => void add(), { action: tActions('addCatalogSources') });+const sync = async (id: string) => {setBusy(id);report(await syncCatalogSource(id));@@ -267,7 +273,10 @@ export function CatalogSourcesCard({size="sm"variant="ghost"disabled={busy !== null}- onClick={() => setSigningIn(signingIn === source.id ? null : source.id)}+ onClick={guard(+ () => setSigningIn(signingIn === source.id ? null : source.id),+ { action: tActions('updateStoreSignIn') },+ )}aria-label={t('stores.update')}aria-expanded={signingIn === source.id}>@@ -279,7 +288,9 @@ export function CatalogSourcesCard({size="sm"variant="ghost"disabled={busy !== null}- onClick={() => sync(source.id)}+ onClick={guard(() => void sync(source.id), {+ action: tActions('syncCatalog'),+ })}aria-label={t('syncNow')}>{busy === source.id ? (@@ -294,7 +305,13 @@ export function CatalogSourcesCard({size="sm"variant="ghost"disabled={busy !== null}- onClick={() => remove(source)}+ onClick={+ isStoreSource(source.kind)+ ? () => void remove(source)+ : guard(() => void remove(source), {+ action: tActions('removeCatalogSources'),+ })+ }aria-label={t('remove')}><Trash2 className="h-4 w-4" />@@ -346,7 +363,7 @@ export function CatalogSourcesCard({className="flex flex-col gap-2 sm:flex-row"onSubmit={(e) => {e.preventDefault();- void add();+ addFeed();}}><Input@@ -376,7 +393,10 @@ export function CatalogSourcesCard({variant="outline"size="sm"disabled={busy !== null}- onClick={() => fileInput.current?.click()}+ onClick={() => {+ if (isLocked) openUpgrade(tActions('addCatalogSources'));+ else fileInput.current?.click();+ }}>{busy === 'upload' ? (<Loader2 className="mr-2 h-4 w-4 animate-spin" />@@ -401,9 +421,13 @@ export function CatalogSourcesCard({size="sm"disabled={busy !== null}aria-expanded={connecting === connector.kind}- onClick={() =>- setConnecting(connecting === connector.kind ? null : connector.kind)- }+ onClick={guard(+ () =>+ setConnecting(+ connecting === connector.kind ? null : connector.kind,+ ),+ { action: tActions('connectStores') },+ )}><Store className="mr-2 h-4 w-4" />{t('stores.connect', { store: connector.label })}diff --git a/web/src/components/settings/content-section.test.tsx b/web/src/components/settings/content-section.test.tsxindex 437971b35..6c7b28e9b 100644--- a/web/src/components/settings/content-section.test.tsx+++ b/web/src/components/settings/content-section.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const getContentSettings = vi.fn();const setBrandQualityHandoff = vi.fn();@@ -22,12 +23,17 @@ const { ContentSection } = await import('./content-section');let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();-async function render() {+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages}>- <ContentSection />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <ContentSection />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -41,6 +47,7 @@ beforeEach(() => {});setBrandQualityHandoff.mockReset().mockResolvedValue(undefined);toast.error.mockReset();+ openUpgrade.mockReset();container = document.createElement('div');root = createRoot(container);});@@ -59,6 +66,14 @@ describe('ContentSection', () => {expect(getContentSettings).toHaveBeenCalledTimes(1);});+ it('saves nothing on a read-only workspace: the box opens the upgrade dialog', async () => {+ await render(true);+ await act(async () => box().click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Changing content settings needs a plan');+ expect(setBrandQualityHandoff).not.toHaveBeenCalled();+ expect(box().getAttribute('aria-checked')).toBe('false');+ });+it('puts it back when the save fails', async () => {setBrandQualityHandoff.mockRejectedValue(new Error('forbidden'));await render();diff --git a/web/src/components/settings/content-section.tsx b/web/src/components/settings/content-section.tsxindex 5d2b4ea55..6a4f2f182 100644--- a/web/src/components/settings/content-section.tsx+++ b/web/src/components/settings/content-section.tsx@@ -11,6 +11,7 @@ import {setBrandQualityHandoff,type ContentSettings,} from '@/lib/actions/content-settings';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Settings › Content (Quality spec §5, CE-051): per brand, Hand off quality@@ -25,6 +26,10 @@ export function ContentSection() {const [failed, setFailed] = useState(false);// A brand's setting being saved: shown at once, put back if it fails.const [saving, setSaving] = useState<Record<string, boolean>>({});+ // A read-only workspace (plan not active): a box opens the upgrade dialog+ // instead, and stays as it was.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async () => {setFailed(false);@@ -104,7 +109,10 @@ export function ContentSection() {checked={saving[brand.id] ?? brand.qualityHandoff}aria-describedby={`content-${brand.id}`}disabled={!read.canManage || brand.id in saving}- onCheckedChange={(checked) => void toggle(brand.id, checked === true)}+ onCheckedChange={guard(+ (checked: boolean) => void toggle(brand.id, checked === true),+ { action: tActions('changeContentSettings') },+ )}/>{t('handOff')}</label>diff --git a/web/src/components/settings/integrations-section.test.tsx b/web/src/components/settings/integrations-section.test.tsxindex 5681c1a40..237298a37 100644--- a/web/src/components/settings/integrations-section.test.tsx+++ b/web/src/components/settings/integrations-section.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/** Each provider's status as the API answers it: an Error is a failed read. */const statuses: Record<string, string | Error> = {};@@ -11,12 +12,8 @@ vi.mock('@/config/plans', async (importOriginal) => ({...(await importOriginal<typeof import('@/config/plans')>()),isCloud: () => cloud.on,}));-vi.mock('@/lib/actions/integrations', () => ({- getIntegrationStatus: async (provider: string) => {- const status = statuses[provider] ?? 'not_connected';- if (status instanceof Error) throw status;- return { status };- },+const integrations = vi.hoisted(() => ({+ getIntegrationStatus: vi.fn(),disconnectIntegration: vi.fn(),getGscProperties: vi.fn(),getGscBrandMappings: vi.fn(),@@ -25,6 +22,7 @@ vi.mock('@/lib/actions/integrations', () => ({getGaBrandMappings: vi.fn(),setBrandGaProperty: vi.fn(),}));+vi.mock('@/lib/actions/integrations', () => integrations);vi.mock('@/hooks/use-integration-connect', () => ({useIntegrationConnect: () => ({ connecting: false, connect: vi.fn() }),}));@@ -58,10 +56,17 @@ const { toast } = await import('sonner');let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();beforeEach(() => {+ vi.clearAllMocks();for (const key of Object.keys(statuses)) delete statuses[key];cloud.on = false;+ integrations.getIntegrationStatus.mockImplementation(async (provider: string) => {+ const status = statuses[provider] ?? 'not_connected';+ if (status instanceof Error) throw status;+ return { status };+ });container = document.createElement('div');document.body.appendChild(container);root = createRoot(container);@@ -69,13 +74,19 @@ beforeEach(() => {afterEach(() => {act(() => root.unmount());container.remove();+ document.body.replaceChildren();});-async function render() {+/** `isLocked`: a read-only workspace (plan not active). */+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <IntegrationsSection />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <IntegrationsSection />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -214,3 +225,69 @@ describe('IntegrationsSection', () => {expect(key()).toBe('2');});});++/** Picks a property for the nth brand row's picker. */+async function pick(row: number, label: string) {+ await act(async () => {+ container.querySelectorAll<HTMLElement>('[role="combobox"]')[row].click();+ });+ // A picker with a value keeps its list mounted: the one just opened is the last.+ const option = [+ ...[...document.querySelectorAll('[role="listbox"]')]+ .at(-1)!+ .querySelectorAll<HTMLElement>('[role="option"]'),+ ].find((o) => o.textContent === label)!;+ await act(async () => {+ option.dispatchEvent(new MouseEvent('mousemove', { bubbles: true }));+ });+ await act(async () => option.click());+}++/**+ * A connected Search Console on a read-only workspace (plan not active): no+ * brand is mapped to a property by itself, and picking one opens the upgrade+ * dialog instead of saving it. On an active plan both save.+ */+describe('IntegrationsSection property mapping', () => {+ beforeEach(() => {+ integrations.getIntegrationStatus.mockImplementation(async (provider: string) => ({+ configured: provider === 'google-search-console',+ status: provider === 'google-search-console' ? 'connected' : 'not_configured',+ }));+ integrations.getGscProperties.mockResolvedValue([+ { siteUrl: 'https://acme.com/', permissionLevel: 'siteOwner' },+ { siteUrl: 'https://other.example/', permissionLevel: 'siteOwner' },+ ]);+ // Acme matches one property by its domain; Beta matches none.+ integrations.getGscBrandMappings.mockResolvedValue([+ { brandId: 'b1', brandName: 'Acme', gscProperty: null, domains: ['acme.com'] },+ { brandId: 'b2', brandName: 'Beta', gscProperty: null, domains: ['beta.test'] },+ ]);+ integrations.setBrandGscProperty.mockResolvedValue(undefined);+ });++ it('maps nothing on a read-only workspace: no auto-match, and a pick opens the upgrade dialog', async () => {+ await render(true);+ expect(container.querySelectorAll('[role="combobox"]')).toHaveLength(2);+ expect(integrations.setBrandGscProperty).not.toHaveBeenCalled();++ await pick(1, 'https://other.example/');+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Choosing a property needs a plan');+ expect(integrations.setBrandGscProperty).not.toHaveBeenCalled();+ });++ it('maps a matching brand by itself and saves a pick on an active plan', async () => {+ await render(false);+ expect(integrations.setBrandGscProperty).toHaveBeenCalledExactlyOnceWith(+ 'b1',+ 'https://acme.com/',+ );++ await pick(1, 'https://other.example/');+ expect(integrations.setBrandGscProperty).toHaveBeenLastCalledWith(+ 'b2',+ 'https://other.example/',+ );+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/settings/integrations-section.tsx b/web/src/components/settings/integrations-section.tsxindex 9773fca3b..93e0e0f2d 100644--- a/web/src/components/settings/integrations-section.tsx+++ b/web/src/components/settings/integrations-section.tsx@@ -45,6 +45,7 @@ import { CatalogCategoryPages } from './catalog-category-pages';import { MerchantCenterAccounts } from './merchant-center-accounts';import { WebflowCard } from './webflow-card';import { useIntegrationConnect } from '@/hooks/use-integration-connect';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';/*** Settings → Integrations (#577, Google Analytics added in #658).@@ -375,6 +376,10 @@ function PropertyMapping({const [loadFailed, setLoadFailed] = useState<string | null>(null);const [savingBrandId, setSavingBrandId] = useState<string | null>(null);const autoMatched = useRef(false);+ // A read-only workspace (plan not active): picking a property opens the+ // upgrade dialog instead, and nothing is matched by itself.+ const { guard, isLocked } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async () => {setLoadFailed(null);@@ -395,7 +400,7 @@ function PropertyMapping({// property. Runs once per mount; a failed save (e.g. member role) just// leaves the brand unmapped for a manual pick by an admin.useEffect(() => {- if (!options || !rows || autoMatched.current) return;+ if (!options || !rows || autoMatched.current || isLocked) return;autoMatched.current = true;(async () => {for (const row of rows) {@@ -413,7 +418,7 @@ function PropertyMapping({}}})();- }, [options, rows, save, sourceName]);+ }, [options, rows, save, sourceName, isLocked]);const handlePick = async (brandId: string, picked: string) => {const value = picked === NONE_VALUE ? null : picked;@@ -475,7 +480,10 @@ function PropertyMapping({<Selectitems={selectItems}value={row.value ?? null}- onValueChange={(v) => handlePick(row.brandId, v ?? NONE_VALUE)}+ onValueChange={guard(+ (v: string | null) => void handlePick(row.brandId, v ?? NONE_VALUE),+ { action: tActions('mapProperties') },+ )}><SelectTrigger className="h-8 w-64 text-xs"><SelectValue placeholder={t('integrations_selectProperty')} />diff --git a/web/src/components/settings/merchant-center-accounts.test.tsx b/web/src/components/settings/merchant-center-accounts.test.tsxindex 6df32fabf..86b21de1d 100644--- a/web/src/components/settings/merchant-center-accounts.test.tsx+++ b/web/src/components/settings/merchant-center-accounts.test.tsx@@ -6,6 +6,7 @@ import messages from '../../../messages/en.json';import type { CatalogSource } from '@/lib/catalog';import type { StoreResult } from '@/lib/catalog-client';import type { CatalogSourcesRead } from './catalog-sources-card';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';const listSignInAccounts = vi.fn();const connectSignInAccount = vi.fn();@@ -75,12 +76,19 @@ const { MerchantCenterAccounts, OWN_ERRORS, accountLabel } =let container: HTMLDivElement;let root: Root;const onConnected = vi.fn();+const openUpgrade = vi.fn();+// A read-only workspace (plan not active) when set.+let isLocked = false;async function render(sources?: CatalogSourcesRead | null) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <MerchantCenterAccounts onConnected={onConnected} sources={sources} />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <MerchantCenterAccounts onConnected={onConnected} sources={sources} />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -132,6 +140,8 @@ beforeEach(() => {});connectSignInAccount.mockReset().mockResolvedValue({ ok: true });onConnected.mockReset();+ openUpgrade.mockReset();+ isLocked = false;toast.error.mockReset();toast.success.mockReset();container = document.createElement('div');@@ -336,4 +346,28 @@ describe('MerchantCenterAccounts', () => {// The catalog card below says this one already.expect(container.textContent).not.toContain('Admins and managers can add and sync sources.');});++ it('adds no account on a read-only workspace: the pick opens the upgrade dialog', async () => {+ isLocked = true;+ await render();+ // The accounts still show.+ expect(options().map((o) => o.textContent)).toEqual(['', 'Acme Outdoor (123)', '456']);+ await pick('123');+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Connecting a store needs a plan');+ expect(select().value).toBe('');+ expect(button('Add account')!.disabled).toBe(true);+ expect(connectSignInAccount).not.toHaveBeenCalled();+ });++ it('opens the upgrade dialog, not a missing message, when the server says the plan has ended', async () => {+ connectSignInAccount.mockResolvedValue({ ok: false, code: 'subscription', message: null });+ await render();+ await pick('123');+ await act(async () => button('Add account')!.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Connecting a store needs a plan');+ expect(toast.error).not.toHaveBeenCalled();+ expect(onConnected).not.toHaveBeenCalled();+ // The pick stays, to add it once there's a plan.+ expect(select().value).toBe('123');+ });});diff --git a/web/src/components/settings/merchant-center-accounts.tsx b/web/src/components/settings/merchant-center-accounts.tsxindex 2c6da91a9..4c3849605 100644--- a/web/src/components/settings/merchant-center-accounts.tsx+++ b/web/src/components/settings/merchant-center-accounts.tsx@@ -14,6 +14,7 @@ import {} from '@/components/ui/select';import { Skeleton } from '@/components/ui/skeleton';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { MERCHANT_CENTER_KIND } from '@/lib/catalog';import {connectSignInAccount,@@ -49,6 +50,8 @@ export function accountLabel(account: SignInAccount): string {* account's products are read into the brand's catalog every day, with the* issues Merchant Center reports for them. The account then shows in* Product catalog, where it is synced or removed. Admins and managers only.+ * On a read-only workspace (plan not active) the accounts show, and picking+ * or adding one opens the upgrade dialog instead.** `sources`: the catalog's sources as its card read them; the accounts the* brand has already are marked in the picker and can't be picked again.@@ -64,6 +67,9 @@ export function MerchantCenterAccounts({const tStores = useTranslations('settings.catalog.stores');const { activeBrandId, brands } = useBrandStore();const { canManage } = useUserRole();+ const { guard, isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');+ const needsPlan = { action: tActions('connectStores') };const brand = brands.find((b) => b.id === activeBrandId) ?? null;// The accounts as read for a brand: another brand's never show.@@ -119,6 +125,11 @@ export function MerchantCenterAccounts({};const add = async () => {+ // A read-only workspace: the upgrade dialog, not the add.+ if (isLocked) {+ openUpgrade(needsPlan.action);+ return;+ }if (!activeBrandId || !brand || !chosen || addingRef.current) return;// The brand and account as clicked: switching brands meanwhile changes neither.const brandId = activeBrandId;@@ -129,6 +140,11 @@ export function MerchantCenterAccounts({const result = await connectSignInAccount(brandId, MERCHANT_CENTER_KIND, account.id);addingRef.current = false;setAdding(null);+ // The plan ended while the page was open: the server's refusal opens the upgrade dialog.+ if (!result.ok && result.code === 'subscription') {+ openUpgrade(needsPlan.action);+ return;+ }if (!result.ok) {toast.error(result.code === 'failed' ? t('addFailed') : errorText(result.code));return;@@ -171,7 +187,10 @@ export function MerchantCenterAccounts({<Selectitems={items}value={chosen?.id ?? null}- onValueChange={(v) => setPicked(v ? { brandId: brand.id, id: v } : null)}+ onValueChange={guard(+ (v: string | null) => setPicked(v ? { brandId: brand.id, id: v } : null),+ needsPlan,+ )}><SelectTrigger className="h-8 w-full text-xs sm:w-80" aria-label={t('pick')}><SelectValue placeholder={t('pick')} />diff --git a/web/src/components/settings/notifications-section.test.tsx b/web/src/components/settings/notifications-section.test.tsxindex 2f2e62f86..b88b151ea 100644--- a/web/src/components/settings/notifications-section.test.tsx+++ b/web/src/components/settings/notifications-section.test.tsx@@ -3,6 +3,7 @@ import { createRoot, type Root } from 'react-dom/client';import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** Settings › Notifications: the AI Traffic weekly digest (AT-013) is turned@@ -23,6 +24,7 @@ const { NotificationsSection } = await import('./notifications-section');const fetchMock = vi.fn();let container: HTMLDivElement;let root: Root;+const openUpgrade = vi.fn();beforeEach(() => {canManage = true;@@ -56,11 +58,15 @@ afterEach(() => {vi.unstubAllGlobals();});-async function render() {+async function render(isLocked = false) {await act(async () => {root.render(<NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">- <NotificationsSection />+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <NotificationsSection />+ </UpgradeDialogContext.Provider></NextIntlClientProvider>,);});@@ -69,6 +75,19 @@ async function render() {const checkbox = () => container.querySelector<HTMLButtonElement>('#traffic-digest-b1')!;describe('NotificationsSection', () => {+ it('saves nothing on a read-only workspace: Save opens the upgrade dialog', async () => {+ openUpgrade.mockClear();+ await render(true);+ const save = [...container.querySelectorAll('button')].find(+ (b) => b.textContent === 'Save changes',+ )!;+ await act(async () => save.click());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith(+ 'Saving notification settings needs a plan',+ );+ expect(fetchMock.mock.calls.some(([, init]) => init?.method === 'PUT')).toBe(false);+ });+it('shows the weekly digest on, and saves it off with the pulse', async () => {await render();expect(container.textContent).toContain('AI Traffic weekly digest');diff --git a/web/src/components/settings/notifications-section.tsx b/web/src/components/settings/notifications-section.tsxindex ca197c8da..744978ebd 100644--- a/web/src/components/settings/notifications-section.tsx+++ b/web/src/components/settings/notifications-section.tsx@@ -18,6 +18,7 @@ import {SelectValue,} from '@/components/ui/select';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { parseRecipients } from '@/lib/pulse-recipients';/**@@ -46,6 +47,9 @@ export function NotificationsSection() {const [invalidRecipients, setInvalidRecipients] = useState<Record<string, string[]>>({});const [loading, setLoading] = useState(true);const [savingBrand, setSavingBrand] = useState<string | null>(null);+ // A read-only workspace (plan not active): Save opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const load = useCallback(async () => {setLoading(true);@@ -199,7 +203,10 @@ export function NotificationsSection() {{canManage && (<Buttonsize="sm"- onClick={() => save(brand.brandId, brand.frequency, brand.trafficDigest)}+ onClick={guard(+ () => void save(brand.brandId, brand.frequency, brand.trafficDigest),+ { action: tActions('saveNotifications') },+ )}disabled={savingBrand !== null}className="gap-2">diff --git a/web/src/components/settings/organization-section.test.tsx b/web/src/components/settings/organization-section.test.tsxnew file mode 100644index 000000000..9c63984d2--- /dev/null+++ b/web/src/components/settings/organization-section.test.tsx@@ -0,0 +1,84 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Settings › Organization: an admin renames the organization; on a+ * read-only workspace (plan not active) Save opens the upgrade dialog.+ */++const org = vi.hoisted(() => ({+ getOrganization: vi.fn(),+ updateOrganizationName: vi.fn(),+}));+vi.mock('@/lib/actions/organization', () => org);+vi.mock('@/hooks/use-user-role', () => ({ useUserRole: () => ({ canAdmin: true }) }));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { OrganizationSection } = await import('./organization-section');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++beforeEach(() => {+ vi.clearAllMocks();+ org.getOrganization.mockResolvedValue({+ name: 'Acme',+ slug: 'acme',+ plan: 'growth',+ memberCount: 2,+ });+ org.updateOrganizationName.mockResolvedValue(undefined);+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+});++async function renameTo(name: string, isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <OrganizationSection />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+ const input = container.querySelector<HTMLInputElement>('#org-name')!;+ await act(async () => {+ Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')!.set!.call(input, name);+ input.dispatchEvent(new Event('input', { bubbles: true }));+ });+ const save = [...container.querySelectorAll('button')].find(+ (b) => b.textContent === 'Save changes',+ )!;+ await act(async () => save.click());+}++describe('OrganizationSection', () => {+ it('renames nothing on a read-only workspace: Save opens the upgrade dialog', async () => {+ await renameTo('Acme Inc', true);+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Renaming the organization needs a plan');+ expect(org.updateOrganizationName).not.toHaveBeenCalled();+ });++ it('renames the organization on an active plan', async () => {+ await renameTo('Acme Inc', false);+ expect(org.updateOrganizationName).toHaveBeenCalledWith('Acme Inc');+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/settings/organization-section.tsx b/web/src/components/settings/organization-section.tsxindex caf7bc6ab..81f967afc 100644--- a/web/src/components/settings/organization-section.tsx+++ b/web/src/components/settings/organization-section.tsx@@ -11,6 +11,7 @@ import { Skeleton } from '@/components/ui/skeleton';import { Separator } from '@/components/ui/separator';import { Loader2, Lock } from 'lucide-react';import { useUserRole } from '@/hooks/use-user-role';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {getOrganization,updateOrganizationName,@@ -39,6 +40,9 @@ export function OrganizationSection() {const [loading, setLoading] = useState(true);const [nameInput, setNameInput] = useState('');const [saving, setSaving] = useState(false);+ // A read-only workspace (plan not active): Save opens the upgrade dialog instead.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const loadOrg = useCallback(async () => {try {@@ -133,7 +137,7 @@ export function OrganizationSection() {{canAdmin ? (<Button- onClick={handleSave}+ onClick={guard(handleSave, { action: tActions('renameOrganization') })}disabled={saving || !nameInput.trim() || nameInput.trim() === org?.name}>{saving && <Loader2 className="mr-2 h-4 w-4 animate-spin" />}diff --git a/web/src/components/settings/team-section.test.tsx b/web/src/components/settings/team-section.test.tsxnew file mode 100644index 000000000..358158895--- /dev/null+++ b/web/src/components/settings/team-section.test.tsx@@ -0,0 +1,166 @@+import { act } from 'react';+import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';++/**+ * Settings › Team on a read-only workspace (plan not active): Invite, a+ * role and Resend open the upgrade dialog instead, and change nothing.+ * Remove and Revoke still work: they end access. On an active plan all work.+ */++const team = vi.hoisted(() => ({+ listMembers: vi.fn(),+ listInvitations: vi.fn(),+ getTeamInfo: vi.fn(),+ updateMemberRole: vi.fn(),+ removeMember: vi.fn(),+ revokeInvitation: vi.fn(),+ resendInvitation: vi.fn(),+ inviteMember: vi.fn(),+}));+vi.mock('@/lib/actions/team', () => team);+vi.mock('@/i18n/navigation', () => ({ useRouter: () => ({ push: vi.fn() }) }));+vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));++const { TeamSection } = await import('./team-section');++(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT =+ true;++let container: HTMLDivElement;+let root: Root;+const openUpgrade = vi.fn();++const ME = {+ userId: 'u1',+ email: '[email protected]',+ fullName: 'Ada Admin',+ avatarUrl: null,+ role: 'admin',+ createdAt: '2026-01-01',+ isCurrentUser: true,+};+const BOB = { ...ME, userId: 'u2', email: '[email protected]', fullName: 'Bob', role: 'analyst' };+BOB.isCurrentUser = false;+const INVITE = {+ id: 'i1',+ email: '[email protected]',+ role: 'analyst',+ status: 'pending',+ invitedBy: 'u1',+ expiresAt: '2099-01-01T00:00:00Z',+ createdAt: '2026-10-01',+ acceptedAt: null,+};++beforeEach(() => {+ vi.clearAllMocks();+ team.listMembers.mockResolvedValue([ME, BOB]);+ team.listInvitations.mockResolvedValue([INVITE]);+ team.getTeamInfo.mockResolvedValue({+ memberCount: 2,+ pendingCount: 1,+ seatsUsed: 3,+ maxTeamMembers: 5,+ canInvite: true,+ planName: 'Growth',+ });+ team.removeMember.mockResolvedValue(undefined);+ team.revokeInvitation.mockResolvedValue(undefined);+ container = document.createElement('div');+ document.body.appendChild(container);+ root = createRoot(container);+});++afterEach(() => {+ act(() => root.unmount());+ container.remove();+ document.body.replaceChildren();+});++async function render(isLocked: boolean) {+ await act(async () => {+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <TeamSection />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ );+ });+}++const byText = (text: string) =>+ [...document.body.querySelectorAll<HTMLElement>('button, [role="menuitem"]')].find(+ (b) => b.textContent?.trim() === text,+ );+const byLabel = (label: string) =>+ document.body.querySelector<HTMLElement>(`button[aria-label="${label}"]`)!;+const click = (el: Element | undefined) =>+ act(async () => {+ (el as HTMLElement).click();+ });+const dialog = () => document.querySelector('[role="dialog"]');++describe('TeamSection on a read-only workspace', () => {+ it('invites and resends nothing: each opens the upgrade dialog', async () => {+ await render(true);+ await click(byText('Invite member'));+ expect(openUpgrade).toHaveBeenLastCalledWith('Inviting members needs a plan');+ expect(dialog()).toBeNull();++ await click(byLabel('Invitation actions'));+ await click(byText('Resend invite'));+ expect(openUpgrade).toHaveBeenLastCalledWith('Resending invitations needs a plan');++ expect(openUpgrade).toHaveBeenCalledTimes(2);+ expect(team.inviteMember).not.toHaveBeenCalled();+ expect(team.resendInvitation).not.toHaveBeenCalled();+ });++ it('still removes a member and revokes an invitation: they end access', async () => {+ await render(true);+ await click(byLabel('Remove team member'));+ expect(dialog()?.textContent).toContain('Remove');+ await click(byText('Remove member'));+ expect(team.removeMember).toHaveBeenCalledWith('u2');++ await click(byLabel('Invitation actions'));+ await click(byText('Revoke'));+ expect(team.revokeInvitation).toHaveBeenCalledWith('i1');+ expect(openUpgrade).not.toHaveBeenCalled();+ });++ it('changes no role: picking one opens the upgrade dialog', async () => {+ await render(true);+ await click(container.querySelector('[role="combobox"]')!);+ const manager = [...document.querySelectorAll<HTMLElement>('[role="option"]')].find(+ (o) => o.textContent === 'Manager',+ )!;+ await act(async () => {+ manager.dispatchEvent(new MouseEvent('mousemove', { bubbles: true }));+ });+ await click(manager);+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Changing roles needs a plan');+ expect(team.updateMemberRole).not.toHaveBeenCalled();+ });++ it('opens Invite and asks before removing on an active plan', async () => {+ await render(false);+ await click(byText('Invite member'));+ expect(dialog()?.textContent).toContain('Invite');+ await act(async () => {+ document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));+ });++ await click(byLabel('Remove team member'));+ await click(byText('Remove member'));+ expect(team.removeMember).toHaveBeenCalledWith('u2');+ expect(openUpgrade).not.toHaveBeenCalled();+ });+});diff --git a/web/src/components/settings/team-section.tsx b/web/src/components/settings/team-section.tsxindex aab22c947..eff26f928 100644--- a/web/src/components/settings/team-section.tsx+++ b/web/src/components/settings/team-section.tsx@@ -53,6 +53,7 @@ import {UserPlus,} from 'lucide-react';import { useRouter } from '@/i18n/navigation';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import { formatDate } from '@/lib/format';import {DropdownMenu,@@ -222,6 +223,10 @@ function MemberRow({const [pendingRole, setPendingRole] = useState<TeamRole | null>(null);const [removing, setRemoving] = useState(false);const [removeDialogOpen, setRemoveDialogOpen] = useState(false);+ // A read-only workspace (plan not active): a role opens the upgrade dialog+ // instead. Remove stays open: it ends a member's access.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const canEdit = isAdmin && !member.isCurrentUser;@@ -277,7 +282,9 @@ function MemberRow({<Selectitems={roleOptions(t)}value={member.role}- onValueChange={(v) => handleRoleChange(v as TeamRole)}+ onValueChange={guard((v: string | null) => void handleRoleChange(v as TeamRole), {+ action: tActions('changeRoles'),+ })}disabled={pendingRole !== null}><SelectTrigger size="sm" className="w-36">@@ -342,6 +349,10 @@ function InvitationRow({}) {const t = useTranslations('settings');const [busy, setBusy] = useState<'revoke' | 'resend' | null>(null);+ // A read-only workspace (plan not active): Resend opens the upgrade dialog+ // instead. Revoke stays open: it ends an invitation's access.+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');async function handleRevoke() {setBusy('revoke');@@ -405,7 +416,9 @@ function InvitationRow({}/><DropdownMenuContent align="end">- <DropdownMenuItem onClick={handleResend}>+ <DropdownMenuItem+ onClick={guard(handleResend, { action: tActions('resendInvitations') })}+ ><RefreshCw className="mr-2 h-4 w-4" />{t('team_resendInvite')}</DropdownMenuItem>@@ -431,6 +444,9 @@ function InviteDialog({ canInvite, onInvited }: { canInvite: boolean; onInvited:const [submitting, setSubmitting] = useState(false);const [inviteLink, setInviteLink] = useState<string | null>(null);const [emailSent, setEmailSent] = useState(true);+ // A read-only workspace (plan not active): the upgrade dialog instead of this one.+ const { isLocked, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');function reset() {setEmail('');@@ -471,7 +487,12 @@ function InviteDialog({ canInvite, onInvited }: { canInvite: boolean; onInvited:return (<Dialogopen={open}- onOpenChange={(o) => {+ onOpenChange={(o, details) => {+ if (o && isLocked) {+ details.cancel();+ openUpgrade(tActions('inviteMembers'));+ return;+ }setOpen(o);if (!o) reset();}}diff --git a/web/src/components/settings/webflow-card.test.tsx b/web/src/components/settings/webflow-card.test.tsxindex 10ceace98..53aad5f01 100644--- a/web/src/components/settings/webflow-card.test.tsx+++ b/web/src/components/settings/webflow-card.test.tsx@@ -26,8 +26,16 @@ const toast = vi.hoisted(() => ({ error: vi.fn(), success: vi.fn() }));vi.mock('sonner', () => ({ toast }));// The read-only workspace's upgrade dialog.const openUpgrade = vi.hoisted(() => vi.fn());+const gate = vi.hoisted(() => ({ isLocked: false }));vi.mock('@/components/providers/upgrade-gate', () => ({- useUpgradeGate: () => ({ isLocked: false, openUpgrade, guard: (fn: () => unknown) => fn }),+ useUpgradeGate: () => ({+ isLocked: gate.isLocked,+ openUpgrade,+ guard:+ <Args extends unknown[]>(fn: (...args: Args) => unknown, options: { action?: string } = {}) =>+ (...args: Args) =>+ gate.isLocked ? openUpgrade(options.action) : fn(...args),+ }),}));const { WebflowCard } = await import('./webflow-card');@@ -105,6 +113,8 @@ async function typeToken(value: string) {beforeEach(() => {role.canManage = true;+ gate.isLocked = false;+ openUpgrade.mockClear();client.readWebflow.mockReset().mockResolvedValue({ ok: true, configured: true, connection: null });@@ -444,6 +454,37 @@ describe('WebflowCard', () => {expect(toast.error).not.toHaveBeenCalled();});+ it('on a read-only workspace, connects and saves nothing, and still disconnects', async () => {+ gate.isLocked = true;+ await render();+ await typeToken('wf-token-123');+ expect(openUpgrade).toHaveBeenLastCalledWith('Connecting your CMS needs a plan');+ expect(client.connectWebflow).not.toHaveBeenCalled();++ client.readWebflow.mockResolvedValue({ ok: true, configured: true, connection: CONNECTED });+ act(() => root.unmount());+ root = createRoot(container);+ await render();+ await click(button('Save'));+ expect(openUpgrade).toHaveBeenLastCalledWith('Saving the CMS settings needs a plan');+ expect(client.saveWebflowSettings).not.toHaveBeenCalled();+ await click(button('Replace token'));+ expect(openUpgrade).toHaveBeenLastCalledWith('Connecting your CMS needs a plan');+ expect(container.querySelector('input[type="password"]')).toBeNull();++ await act(async () => {+ button('Disconnect')!.click();+ });+ const confirm = [...document.body.querySelectorAll('button')].filter(+ (b) => b.textContent === 'Disconnect',+ );+ await act(async () => {+ confirm[confirm.length - 1].click();+ });+ expect(client.disconnectWebflow).toHaveBeenCalledWith('b1');+ expect(openUpgrade).toHaveBeenCalledTimes(3);+ });+it('gives another collection its own suggested map, not the saved one', async () => {client.readWebflow.mockResolvedValue({ ok: true, configured: true, connection: CONNECTED });client.listWebflowCollections.mockResolvedValue({diff --git a/web/src/components/settings/webflow-card.tsx b/web/src/components/settings/webflow-card.tsxindex eb135167a..0a9e18e84 100644--- a/web/src/components/settings/webflow-card.tsx+++ b/web/src/components/settings/webflow-card.tsx@@ -76,8 +76,11 @@ export function WebflowCard() {const t = useTranslations('settings.webflow');const { activeBrandId, brands } = useBrandStore();const { canManage } = useUserRole();- // A read-only workspace's refusal opens the upgrade dialog, not a toast.- const { openUpgrade } = useUpgradeGate();+ // A read-only workspace's refusal opens the upgrade dialog, not a toast;+ // while it is read-only, Replace token opens it at once. Disconnect stays+ // open: it ends an access, it starts nothing.+ const { guard, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const brand = brands.find((b) => b.id === activeBrandId) ?? null;// The connection as read for a brand: another brand's never shows.@@ -182,7 +185,13 @@ export function WebflowCard() {{canManage && connection && (<div className="mt-3 flex flex-wrap items-center gap-2">{!replacing && current?.configured && connection.status === 'connected' && (- <Button variant="outline" size="sm" onClick={() => setReplacingFor(activeBrandId)}>+ <Button+ variant="outline"+ size="sm"+ onClick={guard(() => setReplacingFor(activeBrandId), {+ action: tActions('connectCms'),+ })}+ >{t('replaceToken')}</Button>)}@@ -287,7 +296,9 @@ function TokenForm({onCancel?: () => void;}) {const t = useTranslations('settings.webflow');- const { openUpgrade } = useUpgradeGate();+ // Read-only (plan not active): Connect opens the upgrade dialog before anything is sent.+ const { guard, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');const [token, setToken] = useState('');const [connecting, setConnecting] = useState(false);@@ -316,12 +327,14 @@ function TokenForm({onConnected(result.connection);};+ const connectToken = guard(() => void connect(), { action: tActions('connectCms') });+return (<formclassName="space-y-2"onSubmit={(e) => {e.preventDefault();- if (token.trim() && !connecting) void connect();+ if (token.trim() && !connecting) connectToken();}}><Label htmlFor={`webflow-token-${brandId}`}>{t('tokenLabel')}</Label>@@ -386,7 +399,9 @@ function WebflowMapping({onStale: () => void;}) {const t = useTranslations('settings.webflow');- const { openUpgrade } = useUpgradeGate();+ // Read-only (plan not active): Save opens the upgrade dialog before anything is sent.+ const { guard, openUpgrade } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// The saved settings, for the fields read: a save doesn't read them again.const saved = useRef(connection);useEffect(() => {@@ -637,7 +652,7 @@ function WebflowMapping({<Buttonsize="sm"className="gap-2"- onClick={save}+ onClick={guard(save, { action: tActions('saveCmsSettings') })}disabled={saving || !fields || fieldsNow?.failed || !fields.length || !map.body}>{saving && <Loader2 className="h-3.5 w-3.5 animate-spin" />}diff --git a/web/src/hooks/use-integration-connect.test.tsx b/web/src/hooks/use-integration-connect.test.tsxindex f7b91b329..908096ed0 100644--- a/web/src/hooks/use-integration-connect.test.tsx+++ b/web/src/hooks/use-integration-connect.test.tsx@@ -1,11 +1,15 @@import { act, useEffect } from 'react';import { createRoot, type Root } from 'react-dom/client';+import { NextIntlClientProvider } from 'next-intl';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import messages from '../../messages/en.json';+import { UpgradeDialogContext } from '@/components/providers/upgrade-gate';/*** The OAuth popup flow shared by Settings › Integrations and AI Traffic's* sources strip: open the popup, poll until the account is connected, and- * stop once the caller is gone.+ * stop once the caller is gone. On a read-only workspace (plan not active)+ * it opens the upgrade dialog instead and starts nothing.*/const actions = vi.hoisted(() => ({@@ -22,10 +26,11 @@ const { useIntegrationConnect } = await import('./use-integration-connect');let container: HTMLDivElement;let root: Root;-const harness: { connect?: () => Promise<void> } = {};-const connect = () => harness.connect!();+const harness: { connect?: () => Promise<void> | undefined } = {};+const connect = () => harness.connect!() as Promise<void>;const onStatus = vi.fn();const popup = { closed: false, close: vi.fn() };+const openUpgrade = vi.fn();function Harness() {const { connect: start } = useIntegrationConnect('google-analytics', {@@ -47,9 +52,23 @@ beforeEach(() => {vi.spyOn(window, 'open').mockReturnValue(popup as unknown as Window);container = document.createElement('div');root = createRoot(container);- act(() => root.render(<Harness />));+ render(false);});+function render(isLocked: boolean) {+ act(() =>+ root.render(+ <NextIntlClientProvider locale="en" messages={messages} timeZone="UTC">+ <UpgradeDialogContext.Provider+ value={{ isLocked, reason: 'ended', adminName: null, openUpgrade }}+ >+ <Harness />+ </UpgradeDialogContext.Provider>+ </NextIntlClientProvider>,+ ),+ );+}+afterEach(() => {act(() => root.unmount());vi.useRealTimers();@@ -105,4 +124,12 @@ describe('useIntegrationConnect', () => {// Re-mount for afterEach's unmount.root = createRoot(container);});++ it('opens the upgrade dialog, and no popup, on a read-only workspace', async () => {+ render(true);+ await act(async () => void harness.connect!());+ expect(openUpgrade).toHaveBeenCalledExactlyOnceWith('Connecting an integration needs a plan');+ expect(actions.connectIntegration).not.toHaveBeenCalled();+ expect(window.open).not.toHaveBeenCalled();+ });});diff --git a/web/src/hooks/use-integration-connect.ts b/web/src/hooks/use-integration-connect.tsindex 9221b8cb6..943ef7597 100644--- a/web/src/hooks/use-integration-connect.ts+++ b/web/src/hooks/use-integration-connect.ts@@ -1,7 +1,9 @@'use client';import { useEffect, useRef, useState } from 'react';+import { useTranslations } from 'next-intl';import { toast } from 'sonner';+import { useUpgradeGate } from '@/components/providers/upgrade-gate';import {connectIntegration,getIntegrationStatus,@@ -22,6 +24,8 @@ const CONNECT_POLL_MS = 3000;** `onStatus` hears the outcome: 'connected', or whatever the final check* said once the user closed the popup. An unmounted caller stops polling.+ * On a read-only workspace (plan not active) `connect` opens the upgrade+ * dialog instead.*/export function useIntegrationConnect(provider: IntegrationProvider,@@ -36,6 +40,8 @@ export function useIntegrationConnect(},) {const [connecting, setConnecting] = useState(false);+ const { guard } = useUpgradeGate();+ const tActions = useTranslations('readOnly.actions');// Bumped to stop a poll: a newer attempt, or the caller unmounting.const pollGen = useRef(0);@@ -95,5 +101,5 @@ export function useIntegrationConnect(}};- return { connecting, connect };+ return { connecting, connect: guard(connect, { action: tActions('connectIntegrations') }) };}diff --git a/web/src/lib/catalog-client.test.ts b/web/src/lib/catalog-client.test.tsindex e7e79d2fc..9567dc13e 100644--- a/web/src/lib/catalog-client.test.ts+++ b/web/src/lib/catalog-client.test.ts@@ -301,6 +301,16 @@ describe('category pages (shopping path)', () => {expect(await listCategoryPages('b1')).toEqual({ ok: false, code: 'failed' });});+ it("names a read-only workspace's refusal, for the upgrade dialog", async () => {+ answer(402, { code: 'subscription_inactive', error: 'Choose a plan to make changes.' });+ expect(await setCategoryPage('b1', 'Socks', null)).toEqual({+ ok: false,+ code: 'subscription',+ });+ answer(402, { code: 'subscription_inactive', error: 'Choose a plan to make changes.' });+ expect(await resetCategoryPage('b1', 'Socks')).toEqual({ ok: false, code: 'subscription' });+ });+it('reads an API without the route as no categories, but still fails a save there', async () => {fetchMock.mockResolvedValue(new Response('Cannot GET /api/catalog/categories', { status: 404 }),diff --git a/web/src/lib/catalog-client.ts b/web/src/lib/catalog-client.tsindex d4b0fe908..a06c44da8 100644--- a/web/src/lib/catalog-client.ts+++ b/web/src/lib/catalog-client.ts@@ -343,6 +343,8 @@ export type CategoryPageError =| 'session'| 'workspace'| 'busy'+ /** A read-only workspace (plan not active): the upgrade dialog, not a message. */+ | 'subscription'| 'failed';const CATEGORY_KNOWN: readonly CategoryPageError[] = [@@ -386,7 +388,12 @@ async function categoryCall<T>(return {ok: false,code:- general === 'session' || general === 'workspace' || general === 'busy' ? general : 'failed',+ general === 'session' ||+ general === 'workspace' ||+ general === 'busy' ||+ general === 'subscription'+ ? general+ : 'failed',};} catch (err) {console.error('Failed to reach the catalog API:', err);