@taskforcehq/taskforce 0.3.304 → 0.3.306

package/dist/components/views/PlansPage.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useLocation, useNavigate } from 'react-router-dom';
 import { User } from 'lucide-react';
@@ -7,21 +7,31 @@ import { PlanComparisonPage } from './PlanComparisonPage';
 import { AppShellHeader } from './AppShellHeader';
 import { resolveTaskforceCloudEnvironmentFromBaseUrl } from '../../config/cloudEnvironment';
 import { ACCOUNT_PROFILE_SUMMARY_PATH, invalidateAccountProfileSummaryCache, loadAccountProfileSummaryCached } from '../../utils/accountProfileSummaryCache';
+import { isCommercialEntitlementActive, resolveCommercialLifecyclePresentation } from '../../utils/commercialLifecyclePresentation';
 const TRANSIENT_CHECKOUT_QUERY_CLEAR_DELAY_MS = 1600;
-const ACTIVE_ENTITLEMENT_STATES = new Set(['active', 'trialing', 'grace']);
-const GATE_MESSAGES = {
-    planSelectionRequired: 'Choose a plan to continue.',
-    checkoutPending: 'Complete checkout to continue.',
-    misconfigured: 'Onboarding policy is misconfigured. Contact support or a system administrator.',
-    missingEntitlement: 'No entitlement is linked to this account.'
-};
-const BILLING_CONFLICT_MESSAGES = {
-    CHECKOUT_SESSION_EXPIRED: 'Your previous checkout expired. Choose a plan to continue.',
-    CHECKOUT_SESSION_SUPERSEDED: 'A newer checkout replaced your previous checkout. Choose a plan to continue.'
-};
+const CHECKOUT_CONFIRM_INITIAL_RETRY_DELAYS_MS = [0, 500, 1000, 2000];
+const CHECKOUT_CONFIRM_RETRY_INTERVAL_MS = 5000;
+const CHECKOUT_CONFIRM_MAX_AUTO_RETRY_MS = 45000;
+const HIDDEN_GATE_MESSAGE = 'Choose a plan to continue.';
+function shouldRetryCheckoutConfirmation(statusCode, errorCode) {
+    if (statusCode === 401) {
+        return true;
+    }
+    const normalizedErrorCode = String(errorCode || '').trim().toUpperCase();
+    return normalizedErrorCode === 'CHECKOUT_SESSION_INCOMPLETE'
+        || normalizedErrorCode === 'CHECKOUT_PLAN_VERSION_UNRESOLVED';
+}
 function parseInterval(raw) {
     return raw === 'year' ? 'year' : 'month';
 }
+function normalizeIntervalValue(raw) {
+    const normalized = String(raw || '').trim().toLowerCase();
+    if (normalized === 'year')
+        return 'year';
+    if (normalized === 'month')
+        return 'month';
+    return null;
+}
 function normalizeApiBaseUrl(raw) {
     const trimmed = String(raw || '').trim();
     if (!trimmed)
@@ -43,15 +53,19 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
     const location = useLocation();
     const [accountProfileSummary, setAccountProfileSummary] = useState(null);
     const [actionBusy, setActionBusy] = useState(false);
+    const [continueActionBusy, setContinueActionBusy] = useState(false);
     const [feedback, setFeedback] = useState(null);
     const checkoutStartRan = useRef(false);
+    const checkoutSuccessSettledRef = useRef(null);
     const transientQueryClearTimeoutRef = useRef(null);
+    const onContinueToTaskforceRef = useRef(onContinueToTaskforce);
     const query = useMemo(() => new URLSearchParams(location.search), [location.search]);
     const checkoutState = String(query.get('checkout') || '').trim().toLowerCase();
     const gateState = String(query.get('gate') || '').trim().toLowerCase();
     const queryPlanId = String(query.get('planId') || '').trim();
     const queryPlanVersionId = String(query.get('planVersionId') || '').trim();
     const queryInterval = parseInterval(query.get('interval'));
+    const queryIntervalValue = normalizeIntervalValue(query.get('interval'));
     const querySessionId = String(query.get('session_id') || '').trim();
     const normalizedApiBaseUrl = useMemo(() => normalizeApiBaseUrl(apiBaseUrl), [apiBaseUrl]);
     const normalizedConnectedEnvironmentSource = useMemo(() => normalizeApiBaseUrl(connectedEnvironmentSource), [connectedEnvironmentSource]);
@@ -82,39 +96,15 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         const nextQuery = params.toString();
         navigate(`/${nextQuery ? `?${nextQuery}` : ''}${location.hash || ''}`);
     }, [location.hash, location.search, navigate]);
-    const pricingEndpoints = useMemo(() => {
-        const endpoints = [
-            normalizedApiBaseUrl ? `${normalizedApiBaseUrl}/api/taskforce/public/pricing` : '',
-            '/api/taskforce/public/pricing'
-        ].map((value) => String(value || '').trim()).filter((value, index, all) => value && all.indexOf(value) === index);
-        return endpoints;
-    }, [normalizedApiBaseUrl]);
-    const hasResolvedActiveEntitlement = useMemo(() => {
-        const entitlementState = String(accountProfileSummary?.entitlementState || '').trim().toLowerCase();
-        return ACTIVE_ENTITLEMENT_STATES.has(entitlementState);
-    }, [accountProfileSummary?.entitlementState]);
+    const pricingEndpoint = useMemo(() => buildCloudBillingUrl('/api/taskforce/public/pricing'), [buildCloudBillingUrl]);
+    const lifecyclePresentation = useMemo(() => resolveCommercialLifecyclePresentation(accountProfileSummary, gateState), [accountProfileSummary, gateState]);
+    const hasResolvedActiveEntitlement = useMemo(() => lifecyclePresentation.allowReturnToApp, [lifecyclePresentation.allowReturnToApp]);
     const gateMessage = useMemo(() => {
-        if (hasResolvedActiveEntitlement)
+        const message = String(lifecyclePresentation.message || '').trim();
+        if (!message || message === HIDDEN_GATE_MESSAGE)
             return null;
-        const billingConflictCode = String(accountProfileSummary?.billingConflictCode || '').trim().toUpperCase();
-        if (billingConflictCode === 'CHECKOUT_SESSION_EXPIRED')
-            return BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_EXPIRED;
-        if (billingConflictCode === 'CHECKOUT_SESSION_SUPERSEDED')
-            return BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_SUPERSEDED;
-        const summaryMessage = String(accountProfileSummary?.message || '').trim();
-        if (summaryMessage)
-            return summaryMessage;
-        const effectiveGateState = String(accountProfileSummary?.gate || gateState || '').trim().toLowerCase();
-        if (effectiveGateState === 'plan_selection_required')
-            return GATE_MESSAGES.planSelectionRequired;
-        if (effectiveGateState === 'checkout_pending')
-            return GATE_MESSAGES.checkoutPending;
-        if (effectiveGateState === 'misconfigured')
-            return GATE_MESSAGES.misconfigured;
-        if (effectiveGateState === 'missing_entitlement')
-            return GATE_MESSAGES.missingEntitlement;
-        return null;
-    }, [accountProfileSummary?.billingConflictCode, accountProfileSummary?.gate, accountProfileSummary?.message, gateState, hasResolvedActiveEntitlement]);
+        return message;
+    }, [lifecyclePresentation.message]);
     const clearTransientQueryState = useCallback(() => {
         const next = new URLSearchParams(location.search);
         next.delete('checkout');
@@ -135,6 +125,9 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             transientQueryClearTimeoutRef.current = null;
         }, TRANSIENT_CHECKOUT_QUERY_CLEAR_DELAY_MS);
     }, [clearTransientQueryState]);
+    useEffect(() => {
+        onContinueToTaskforceRef.current = onContinueToTaskforce;
+    }, [onContinueToTaskforce]);
     const loadAccountProfileSummary = useCallback(async (options) => {
         const accountProfileSummaryUrl = buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH);
         if (!isAuthenticated) {
@@ -156,31 +149,23 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             return null;
         }
     }, [authUserId, buildCloudBillingUrl, isAuthenticated, onAccountProfileSummaryChange]);
-    const resolveRecoveryMessage = useCallback((summary, fallback) => {
-        const billingConflictCode = String(summary?.billingConflictCode || '').trim().toUpperCase();
-        if (billingConflictCode === 'CHECKOUT_SESSION_EXPIRED')
-            return BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_EXPIRED;
-        if (billingConflictCode === 'CHECKOUT_SESSION_SUPERSEDED')
-            return BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_SUPERSEDED;
-        const summaryMessage = String(summary?.message || '').trim();
-        if (summaryMessage)
-            return summaryMessage;
-        return String(fallback || 'Unable to confirm checkout completion.').trim() || 'Unable to confirm checkout completion.';
-    }, []);
-    const resolveGateFeedbackType = useCallback((message) => {
-        const normalized = String(message || '').trim();
-        if (normalized === GATE_MESSAGES.planSelectionRequired
-            || normalized === GATE_MESSAGES.checkoutPending) {
-            return 'info';
-        }
-        return 'error';
+    const resolveRecoveryMessage = useCallback((summary, fallback, options) => {
+        const normalizedFallback = String(fallback || '').trim();
+        if (options?.preferFallback && normalizedFallback)
+            return normalizedFallback;
+        const message = resolveCommercialLifecyclePresentation(summary, gateState).message;
+        if (message)
+            return message;
+        return normalizedFallback || 'Unable to confirm checkout completion.';
+    }, [gateState]);
+    const shouldAutoContinueAfterActivation = useCallback((summary, fallbackGate) => {
+        return !resolveCommercialLifecyclePresentation(summary, fallbackGate).allowReturnToApp;
     }, []);
-    const startCheckout = useCallback(async (planVersionId, interval) => {
+    const startCheckout = useCallback(async (planVersionId, interval, options) => {
         if (!planVersionId) {
             setFeedback({ type: 'error', message: 'Selected plan is missing a default plan version.' });
             return;
         }
-        const hadActiveEntitlement = hasResolvedActiveEntitlement;
         setActionBusy(true);
         setFeedback(null);
         try {
@@ -201,7 +186,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
                 const summary = await loadAccountProfileSummary({ force: true });
                 const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
-                if (!hadActiveEntitlement && ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
+                if (options?.autoContinueOnActivation === true && isCommercialEntitlementActive(summaryState)) {
                     await onContinueToTaskforce?.();
                 }
                 return;
@@ -211,7 +196,7 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
                 invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
                 const summary = await loadAccountProfileSummary({ force: true });
                 const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
-                if (!hadActiveEntitlement && ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
+                if (options?.autoContinueOnActivation === true && isCommercialEntitlementActive(summaryState)) {
                     await onContinueToTaskforce?.();
                 }
                 return;
@@ -253,14 +238,56 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         finally {
             setActionBusy(false);
         }
-    }, [authUserId, buildCloudBillingUrl, hasResolvedActiveEntitlement, loadAccountProfileSummary, onContinueToTaskforce, runtimeMode]);
-    const confirmCheckoutSession = useCallback(async (sessionId) => {
+    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary, onContinueToTaskforce, runtimeMode]);
+    const confirmCheckoutSession = useCallback(async (sessionId, options) => {
         if (!sessionId) {
             return {
                 confirmed: false,
-                errorMessage: 'Checkout session is missing.'
+                errorMessage: 'Checkout session is missing.',
+                retryable: false
             };
         }
+        const confirmViaSummary = async () => {
+            invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
+            const summary = await loadAccountProfileSummary({ force: true });
+            const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
+            if (!isCommercialEntitlementActive(summaryState)) {
+                return false;
+            }
+            const expectedPlanId = queryPlanId;
+            const expectedPlanVersionId = queryPlanVersionId;
+            const expectedInterval = queryIntervalValue;
+            const currentPlanId = String(summary?.planId || '').trim();
+            const currentPlanVersionId = String(summary?.planVersionId || '').trim();
+            const currentInterval = normalizeIntervalValue(summary?.billingInterval ?? null);
+            const preSummary = options?.preConfirmationSummary ?? null;
+            const preState = String(preSummary?.entitlementState || '').trim().toLowerCase();
+            const preWasActive = isCommercialEntitlementActive(preState);
+            const prePlanId = String(preSummary?.planId || '').trim();
+            const prePlanVersionId = String(preSummary?.planVersionId || '').trim();
+            const preInterval = normalizeIntervalValue(preSummary?.billingInterval ?? null);
+            if (expectedPlanId && currentPlanId && currentPlanId !== expectedPlanId) {
+                return false;
+            }
+            if (expectedPlanVersionId && currentPlanVersionId && currentPlanVersionId !== expectedPlanVersionId) {
+                return false;
+            }
+            if (expectedInterval && currentInterval && currentInterval !== expectedInterval) {
+                return false;
+            }
+            if (preWasActive) {
+                const requestedPlanChanged = Boolean(expectedPlanId) && currentPlanId === expectedPlanId && prePlanId !== currentPlanId;
+                const requestedPlanVersionChanged = Boolean(expectedPlanVersionId) && currentPlanVersionId === expectedPlanVersionId && prePlanVersionId !== currentPlanVersionId;
+                const requestedIntervalChanged = Boolean(expectedInterval) && currentInterval === expectedInterval && preInterval !== currentInterval;
+                if (!requestedPlanChanged && !requestedPlanVersionChanged && !requestedIntervalChanged) {
+                    return false;
+                }
+            }
+            if (options?.autoContinueOnActivation === true) {
+                await onContinueToTaskforceRef.current?.();
+            }
+            return true;
+        };
         try {
             const res = await fetch(buildCloudBillingUrl('/api/taskforce/billing/checkout-session/confirm'), {
                 method: 'POST',
@@ -270,33 +297,37 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             });
             const payload = await res.json().catch(() => ({}));
             if (!res.ok) {
+                const errorCode = String(payload?.code || '').trim();
+                const retryable = shouldRetryCheckoutConfirmation(res.status, errorCode);
+                if (retryable && await confirmViaSummary()) {
+                    return { confirmed: true };
+                }
                 return {
                     confirmed: false,
-                    errorMessage: String(payload?.error || 'Unable to confirm checkout completion.')
+                    errorMessage: String(payload?.error || 'Unable to confirm checkout completion.'),
+                    retryable
                 };
             }
-            invalidateAccountProfileSummaryCache(buildCloudBillingUrl(ACCOUNT_PROFILE_SUMMARY_PATH), { identityKey: authUserId });
-            const summary = await loadAccountProfileSummary({ force: true });
-            const summaryState = String(summary?.entitlementState || '').trim().toLowerCase();
-            if (ACTIVE_ENTITLEMENT_STATES.has(summaryState)) {
-                await onContinueToTaskforce?.();
+            if (await confirmViaSummary()) {
+                return { confirmed: true };
             }
             return { confirmed: true };
         }
         catch {
             return {
                 confirmed: false,
-                errorMessage: 'Unable to confirm checkout completion.'
+                errorMessage: 'Unable to confirm checkout completion.',
+                retryable: true
             };
         }
-    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary, onContinueToTaskforce]);
+    }, [authUserId, buildCloudBillingUrl, loadAccountProfileSummary, queryIntervalValue, queryPlanId, queryPlanVersionId]);
     const openBillingPortal = useCallback(async () => {
         if (!isAuthenticated) {
             navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`);
             return;
         }
         setActionBusy(true);
-        setFeedback(null);
+        setFeedback({ type: 'info', message: 'Opening billing portal...' });
         try {
             const res = await fetch(buildCloudBillingUrl('/api/taskforce/billing/portal-session'), {
                 method: 'POST',
@@ -321,6 +352,17 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             setActionBusy(false);
         }
     }, [buildCloudBillingUrl, isAuthenticated, navigate]);
+    const handleContinueToTaskforce = useCallback(async () => {
+        if (!onContinueToTaskforce || continueActionBusy || continueBusy)
+            return;
+        setContinueActionBusy(true);
+        try {
+            await onContinueToTaskforce();
+        }
+        finally {
+            setContinueActionBusy(false);
+        }
+    }, [continueActionBusy, continueBusy, onContinueToTaskforce]);
     useEffect(() => {
         void loadAccountProfileSummary();
     }, [loadAccountProfileSummary]);
@@ -337,26 +379,115 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         }
     }, []);
     useEffect(() => {
+        if (checkoutState !== 'success') {
+            checkoutSuccessSettledRef.current = null;
+        }
+    }, [checkoutState]);
+    useEffect(() => {
+        let cancelled = false;
+        const pendingRetryTimeouts = new Set();
+        const waitForRetry = async (delayMs) => {
+            if (delayMs <= 0)
+                return;
+            await new Promise((resolve) => {
+                const timeoutId = window.setTimeout(() => {
+                    pendingRetryTimeouts.delete(timeoutId);
+                    resolve();
+                }, delayMs);
+                pendingRetryTimeouts.add(timeoutId);
+            });
+        };
         if (checkoutState === 'success') {
             checkoutStartRan.current = true;
             setFeedback({ type: 'success', message: 'Checkout completed successfully. Finalizing your plan...' });
+            const shouldWaitForAuthBootstrap = !isAuthenticated && !authSessionResolved;
+            if (shouldWaitForAuthBootstrap) {
+                return () => {
+                    cancelled = true;
+                    pendingRetryTimeouts.forEach((timeoutId) => window.clearTimeout(timeoutId));
+                    pendingRetryTimeouts.clear();
+                };
+            }
+            if (!isAuthenticated) {
+                setFeedback({ type: 'error', message: 'Sign in to finish activating your plan.' });
+                return () => {
+                    cancelled = true;
+                    pendingRetryTimeouts.forEach((timeoutId) => window.clearTimeout(timeoutId));
+                    pendingRetryTimeouts.clear();
+                };
+            }
+            const successFlowKey = querySessionId || '__missing_session__';
+            if (checkoutSuccessSettledRef.current === successFlowKey) {
+                return () => {
+                    cancelled = true;
+                    pendingRetryTimeouts.forEach((timeoutId) => window.clearTimeout(timeoutId));
+                    pendingRetryTimeouts.clear();
+                };
+            }
             void (async () => {
-                const confirmation = querySessionId
-                    ? await confirmCheckoutSession(querySessionId)
-                    : { confirmed: false, errorMessage: 'Checkout session is missing.' };
+                const autoConfirmStartedAt = Date.now();
+                const preConfirmationSummary = await loadAccountProfileSummary({ force: true });
+                if (cancelled)
+                    return;
+                let confirmation = querySessionId
+                    ? { confirmed: false, errorMessage: 'Unable to confirm checkout completion.', retryable: true }
+                    : { confirmed: false, errorMessage: 'Checkout session is missing.', retryable: false };
+                let attemptIndex = 0;
+                while (true) {
+                    const delayMs = attemptIndex < CHECKOUT_CONFIRM_INITIAL_RETRY_DELAYS_MS.length
+                        ? CHECKOUT_CONFIRM_INITIAL_RETRY_DELAYS_MS[attemptIndex]
+                        : CHECKOUT_CONFIRM_RETRY_INTERVAL_MS;
+                    attemptIndex += 1;
+                    await waitForRetry(delayMs);
+                    if (cancelled)
+                        return;
+                    confirmation = querySessionId
+                        ? await confirmCheckoutSession(querySessionId, {
+                            autoContinueOnActivation: shouldAutoContinueAfterActivation(preConfirmationSummary, gateState),
+                            preConfirmationSummary
+                        })
+                        : { confirmed: false, errorMessage: 'Checkout session is missing.', retryable: false };
+                    if (cancelled)
+                        return;
+                    if (confirmation.confirmed) {
+                        checkoutSuccessSettledRef.current = successFlowKey;
+                        setFeedback({ type: 'success', message: 'Checkout completed successfully.' });
+                        scheduleTransientQueryClear();
+                        return;
+                    }
+                    if (!confirmation.retryable) {
+                        break;
+                    }
+                    if ((Date.now() - autoConfirmStartedAt) >= CHECKOUT_CONFIRM_MAX_AUTO_RETRY_MS) {
+                        break;
+                    }
+                }
+                if (cancelled)
+                    return;
                 if (!confirmation.confirmed) {
                     const summary = await loadAccountProfileSummary({ force: true });
+                    if (cancelled)
+                        return;
+                    if (!confirmation.retryable) {
+                        checkoutSuccessSettledRef.current = successFlowKey;
+                    }
                     setFeedback({
                         type: 'error',
-                        message: resolveRecoveryMessage(summary, confirmation.errorMessage)
+                        message: resolveRecoveryMessage(summary, confirmation.errorMessage, {
+                            preferFallback: !confirmation.retryable
+                        })
                     });
-                    scheduleTransientQueryClear();
+                    if (!confirmation.retryable) {
+                        scheduleTransientQueryClear();
+                    }
                     return;
                 }
-                setFeedback({ type: 'success', message: 'Checkout completed successfully.' });
-                scheduleTransientQueryClear();
             })();
-            return;
+            return () => {
+                cancelled = true;
+                pendingRetryTimeouts.forEach((timeoutId) => window.clearTimeout(timeoutId));
+                pendingRetryTimeouts.clear();
+            };
         }
         if (checkoutState === 'cancel') {
             void (async () => {
@@ -371,29 +502,31 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
         }
         if ((checkoutState === 'start' || checkoutState === 'free') && isAuthenticated && queryPlanVersionId && !checkoutStartRan.current) {
             checkoutStartRan.current = true;
-            void startCheckout(queryPlanVersionId, queryInterval);
+            void (async () => {
+                const preCheckoutSummary = await loadAccountProfileSummary({ force: true });
+                await startCheckout(queryPlanVersionId, queryInterval, {
+                    autoContinueOnActivation: shouldAutoContinueAfterActivation(preCheckoutSummary, gateState)
+                });
+            })();
+            return;
+        }
+    }, [authSessionResolved, checkoutState, confirmCheckoutSession, gateState, isAuthenticated, loadAccountProfileSummary, queryInterval, queryPlanVersionId, querySessionId, resolveRecoveryMessage, scheduleTransientQueryClear, shouldAutoContinueAfterActivation, startCheckout]);
+    useEffect(() => {
+        if (checkoutState === 'success' || checkoutState === 'cancel' || checkoutState === 'start' || checkoutState === 'free') {
             return;
         }
         if (gateMessage) {
-            setFeedback({ type: resolveGateFeedbackType(gateMessage), message: gateMessage });
+            setFeedback({ type: lifecyclePresentation.statusTone, message: gateMessage });
             return;
         }
         setFeedback((current) => {
             if (!current || current.type !== 'error')
                 return current;
-            if (current.message === GATE_MESSAGES.planSelectionRequired)
-                return null;
-            if (current.message === GATE_MESSAGES.misconfigured)
-                return null;
-            if (current.message === GATE_MESSAGES.missingEntitlement)
-                return null;
-            if (current.message === BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_EXPIRED)
-                return null;
-            if (current.message === BILLING_CONFLICT_MESSAGES.CHECKOUT_SESSION_SUPERSEDED)
+            if (current.message === lifecyclePresentation.message)
                 return null;
             return current;
         });
-    }, [checkoutState, confirmCheckoutSession, gateMessage, isAuthenticated, loadAccountProfileSummary, queryInterval, queryPlanVersionId, querySessionId, resolveGateFeedbackType, resolveRecoveryMessage, scheduleTransientQueryClear, startCheckout]);
+    }, [checkoutState, gateMessage, lifecyclePresentation.message, lifecyclePresentation.statusTone]);
     const handleSelectPlan = useCallback(async (intent) => {
         if (!isAuthenticated) {
             const nextCheckoutState = intent.pricingType === 'free' ? 'free' : 'start';
@@ -414,15 +547,16 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             await openBillingPortal();
             return;
         }
+        const autoContinueOnActivation = shouldAutoContinueAfterActivation(accountProfileSummary, gateState);
         if (intent.pricingType === 'free') {
-            await startCheckout(intent.planVersionId, intent.interval);
+            await startCheckout(intent.planVersionId, intent.interval, { autoContinueOnActivation });
             return;
         }
-        await startCheckout(intent.planVersionId, intent.interval);
-    }, [isAuthenticated, navigate, openBillingPortal, startCheckout]);
+        await startCheckout(intent.planVersionId, intent.interval, { autoContinueOnActivation });
+    }, [accountProfileSummary, gateState, isAuthenticated, navigate, openBillingPortal, shouldAutoContinueAfterActivation, startCheckout]);
     const handleBack = useCallback(() => {
         if (hasResolvedActiveEntitlement && onContinueToTaskforce) {
-            void onContinueToTaskforce();
+            void handleContinueToTaskforce();
             return;
         }
         if (embedded) {
@@ -434,9 +568,8 @@ export function PlansPage({ isAuthenticated, authUserId, runtimeMode, authSessio
             return;
         }
         navigate('/');
-    }, [closeEmbeddedPlansScreen, embedded, hasResolvedActiveEntitlement, navigate, onContinueToTaskforce]);
-    const continueAction = hasResolvedActiveEntitlement && onContinueToTaskforce ? (_jsx("button", { className: styles.navAction, onClick: () => { void onContinueToTaskforce(); }, disabled: continueBusy || actionBusy, children: "Take Me to Taskforce" })) : null;
-    const topActions = embedded ? (_jsxs(_Fragment, { children: [continueAction, isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" }))] })) : (_jsxs(_Fragment, { children: [_jsx("button", { className: styles.navAction, onClick: handleBack, disabled: continueBusy || (isAuthenticated && !hasResolvedActiveEntitlement), children: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : 'Back' }), isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" })), !isAuthenticated && (_jsxs("button", { className: styles.navAction, onClick: () => navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`), children: [_jsx(User, { size: 16, style: { marginRight: '8px', verticalAlign: 'text-bottom' } }), "Sign In"] }))] }));
-    const chrome = embedded ? null : (_jsx(AppShellHeader, { projectName: projectName, currentWorkspaceId: currentWorkspaceId, runtimeMode: runtimeMode === 'cloud' ? 'cloud' : 'local', theme: currentTheme, actions: topActions }));
-    return (_jsx(PlanComparisonPage, { chrome: chrome, heading: "Subscription Plans", subtitle: "Manage your subscription and explore available features. Your current plan is highlighted below.", isAuthenticated: isAuthenticated, authSessionResolved: authSessionResolved, currentPlanId: String(accountProfileSummary?.planId || queryPlanId || '').trim() || null, currentPlanVersionId: String(accountProfileSummary?.planVersionId || queryPlanVersionId || '').trim() || null, currentEntitlementState: String(accountProfileSummary?.entitlementState || '').trim() || null, canManageCurrentPlan: Boolean(accountProfileSummary?.stripeCustomerId), pricingEndpoint: pricingEndpoints[0], statusBanner: feedback, onBack: handleBack, backLabel: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : (embedded ? 'Back to Board' : 'Back to App'), backDisabled: continueBusy || (isAuthenticated && !hasResolvedActiveEntitlement), topActions: embedded ? topActions : null, shellOwnsScroll: shellOwnsScroll, showPageBackButton: !embedded, fallbackPricingSource: fallbackPricingSource, onSelectPlan: handleSelectPlan }));
+    }, [closeEmbeddedPlansScreen, embedded, handleContinueToTaskforce, hasResolvedActiveEntitlement, navigate, onContinueToTaskforce]);
+    const headerActions = embedded ? null : (_jsxs(_Fragment, { children: [_jsx("button", { className: styles.navAction, onClick: handleBack, disabled: continueBusy || continueActionBusy || (isAuthenticated && !hasResolvedActiveEntitlement), children: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : 'Back' }), isAuthenticated && accountProfileSummary?.stripeCustomerId && (_jsx("button", { className: styles.navAction, onClick: () => { void openBillingPortal(); }, disabled: actionBusy, children: "Manage billing" })), !isAuthenticated && (_jsxs("button", { className: styles.navAction, onClick: () => navigate(`/login?mode=login&next=${encodeURIComponent(buildEmbeddedPlansPath())}`), children: [_jsx(User, { size: 16, style: { marginRight: '8px', verticalAlign: 'text-bottom' } }), "Sign In"] }))] }));
+    const chrome = embedded ? null : (_jsx(AppShellHeader, { projectName: projectName, currentWorkspaceId: currentWorkspaceId, runtimeMode: runtimeMode === 'cloud' ? 'cloud' : 'local', theme: currentTheme, actions: headerActions }));
+    return (_jsx(PlanComparisonPage, { chrome: chrome, heading: "Subscription Plans", subtitle: "Manage your subscription and explore available features. Your current plan is highlighted below.", isAuthenticated: isAuthenticated, authSessionResolved: authSessionResolved, currentPlanId: String(accountProfileSummary?.planId || queryPlanId || '').trim() || null, currentPlanVersionId: String(accountProfileSummary?.planVersionId || queryPlanVersionId || '').trim() || null, currentEntitlementState: String(accountProfileSummary?.entitlementState || '').trim() || null, markCurrentPlan: lifecyclePresentation.markCurrentPlan, canManageCurrentPlan: Boolean(accountProfileSummary?.stripeCustomerId), pricingEndpoint: pricingEndpoint, statusBanner: feedback, onBack: handleBack, backLabel: hasResolvedActiveEntitlement ? 'Take Me to Taskforce' : (embedded ? 'Back to Board' : 'Back to App'), backDisabled: continueBusy || continueActionBusy || (isAuthenticated && !hasResolvedActiveEntitlement), topActions: null, shellOwnsScroll: shellOwnsScroll, showPageBackButton: false, showHeaderBarWithChrome: false, currentPlanCardActionMode: "manage", fallbackPricingSource: fallbackPricingSource, onSelectPlan: handleSelectPlan }));
 }