@kerne/react 1.0.0 → 1.1.0

package/dist/{chunk-NFJ2S5VJ.js → chunk-IZMRK3WK.js}

@@ -194,6 +194,11 @@ var defaultLocalization = {
     changePlan: "Change plan",
     current: "Current",
     switchTo: "Switch",
+    switching: "Switching...",
+    switchConfirmTitle: "Switch to {plan}?",
+    switchConfirmBody: "This applies right away, and your next invoice reflects the price difference for the rest of this period.",
+    switchConfirmButton: "Yes, switch",
+    switchConfirmDismiss: "Never mind",
     noPlans: "No other plans are available right now.",
     notOnInterval: "Not available on this interval",
     loadFailed: "Could not load your plan right now.",
@@ -981,6 +986,63 @@ function useChangePlan() {
   );
   return { changePlan, isChanging };
 }
+function usePlanSwitch(subscription, refetchSubscription, options) {
+  const { openCheckout } = useCheckout();
+  const { changePlan } = useChangePlan();
+  const [pending, setPending] = useState(null);
+  const [switching, setSwitching] = useState(false);
+  const [switchError, setSwitchError] = useState(null);
+  const [checkoutPriceId, setCheckoutPriceId] = useState(null);
+  const [checkoutError, setCheckoutError] = useState(null);
+  const successUrl = options?.successUrl;
+  const cancelUrl = options?.cancelUrl;
+  const selectPlan = useCallback2(
+    async (plan, price) => {
+      if (subscription) {
+        setSwitchError(null);
+        setPending({ plan, price });
+        return;
+      }
+      setCheckoutError(null);
+      setCheckoutPriceId(price.id);
+      try {
+        await openCheckout(price.id, { successUrl, cancelUrl });
+      } catch (e) {
+        setCheckoutError(e);
+        setCheckoutPriceId(null);
+      }
+    },
+    [subscription, openCheckout, successUrl, cancelUrl]
+  );
+  const confirmSwitch = useCallback2(async () => {
+    if (!pending || !subscription) return;
+    setSwitching(true);
+    setSwitchError(null);
+    try {
+      await changePlan(subscription.id, pending.price.id);
+      setPending(null);
+      refetchSubscription();
+    } catch (e) {
+      setSwitchError(e);
+    } finally {
+      setSwitching(false);
+    }
+  }, [pending, subscription, changePlan, refetchSubscription]);
+  const dismissSwitch = useCallback2(() => {
+    setPending(null);
+    setSwitchError(null);
+  }, []);
+  return {
+    pending,
+    switching,
+    switchError,
+    checkoutPriceId,
+    checkoutError,
+    selectPlan,
+    confirmSwitch,
+    dismissSwitch
+  };
+}
 function useAccess(featureKey, requested) {
   const client = useClient();
   const [state, setState] = useState({
@@ -1210,6 +1272,7 @@ export {
   usePortal,
   useCancelSubscription,
   useChangePlan,
+  usePlanSwitch,
   useAccess,
   useSubscription,
   usePlans,

package/dist/{chunk-IMZFZ3P5.cjs → chunk-TYNZ2WU7.cjs}

@@ -194,6 +194,11 @@ var defaultLocalization = {
     changePlan: "Change plan",
     current: "Current",
     switchTo: "Switch",
+    switching: "Switching...",
+    switchConfirmTitle: "Switch to {plan}?",
+    switchConfirmBody: "This applies right away, and your next invoice reflects the price difference for the rest of this period.",
+    switchConfirmButton: "Yes, switch",
+    switchConfirmDismiss: "Never mind",
     noPlans: "No other plans are available right now.",
     notOnInterval: "Not available on this interval",
     loadFailed: "Could not load your plan right now.",
@@ -981,6 +986,63 @@ function useChangePlan() {
   );
   return { changePlan, isChanging };
 }
+function usePlanSwitch(subscription, refetchSubscription, options) {
+  const { openCheckout } = useCheckout();
+  const { changePlan } = useChangePlan();
+  const [pending, setPending] = _react.useState.call(void 0, null);
+  const [switching, setSwitching] = _react.useState.call(void 0, false);
+  const [switchError, setSwitchError] = _react.useState.call(void 0, null);
+  const [checkoutPriceId, setCheckoutPriceId] = _react.useState.call(void 0, null);
+  const [checkoutError, setCheckoutError] = _react.useState.call(void 0, null);
+  const successUrl = _optionalChain([options, 'optionalAccess', _23 => _23.successUrl]);
+  const cancelUrl = _optionalChain([options, 'optionalAccess', _24 => _24.cancelUrl]);
+  const selectPlan = _react.useCallback.call(void 0, 
+    async (plan, price) => {
+      if (subscription) {
+        setSwitchError(null);
+        setPending({ plan, price });
+        return;
+      }
+      setCheckoutError(null);
+      setCheckoutPriceId(price.id);
+      try {
+        await openCheckout(price.id, { successUrl, cancelUrl });
+      } catch (e) {
+        setCheckoutError(e);
+        setCheckoutPriceId(null);
+      }
+    },
+    [subscription, openCheckout, successUrl, cancelUrl]
+  );
+  const confirmSwitch = _react.useCallback.call(void 0, async () => {
+    if (!pending || !subscription) return;
+    setSwitching(true);
+    setSwitchError(null);
+    try {
+      await changePlan(subscription.id, pending.price.id);
+      setPending(null);
+      refetchSubscription();
+    } catch (e) {
+      setSwitchError(e);
+    } finally {
+      setSwitching(false);
+    }
+  }, [pending, subscription, changePlan, refetchSubscription]);
+  const dismissSwitch = _react.useCallback.call(void 0, () => {
+    setPending(null);
+    setSwitchError(null);
+  }, []);
+  return {
+    pending,
+    switching,
+    switchError,
+    checkoutPriceId,
+    checkoutError,
+    selectPlan,
+    confirmSwitch,
+    dismissSwitch
+  };
+}
 function useAccess(featureKey, requested) {
   const client = useClient();
   const [state, setState] = _react.useState.call(void 0, {
@@ -1040,8 +1102,8 @@ function useSubscription(productSlug) {
     setState((prev) => ({ ...prev, isLoading: true }));
     fetchOnce({ current: true });
   }, [fetchOnce]);
-  const isActive = _optionalChain([state, 'access', _23 => _23.subscription, 'optionalAccess', _24 => _24.status]) === "ACTIVE" || _optionalChain([state, 'access', _25 => _25.subscription, 'optionalAccess', _26 => _26.status]) === "TRIALING";
-  const planSlug = _optionalChain([state, 'access', _27 => _27.subscription, 'optionalAccess', _28 => _28.plan, 'optionalAccess', _29 => _29.slug]);
+  const isActive = _optionalChain([state, 'access', _25 => _25.subscription, 'optionalAccess', _26 => _26.status]) === "ACTIVE" || _optionalChain([state, 'access', _27 => _27.subscription, 'optionalAccess', _28 => _28.status]) === "TRIALING";
+  const planSlug = _optionalChain([state, 'access', _29 => _29.subscription, 'optionalAccess', _30 => _30.plan, 'optionalAccess', _31 => _31.slug]);
   return {
     ...state,
     isActive,
@@ -1189,9 +1251,9 @@ function useUser() {
     update: updateProfile,
     // Computed properties
     fullName: user ? `${user.first_name || ""} ${user.last_name || ""}`.trim() : null,
-    initials: user ? `${_optionalChain([user, 'access', _30 => _30.first_name, 'optionalAccess', _31 => _31[0]]) || ""}${_optionalChain([user, 'access', _32 => _32.last_name, 'optionalAccess', _33 => _33[0]]) || ""}`.toUpperCase() : null,
-    email: _optionalChain([user, 'optionalAccess', _34 => _34.email]) || null,
-    emailVerified: _optionalChain([user, 'optionalAccess', _35 => _35.email_verified]) || false
+    initials: user ? `${_optionalChain([user, 'access', _32 => _32.first_name, 'optionalAccess', _33 => _33[0]]) || ""}${_optionalChain([user, 'access', _34 => _34.last_name, 'optionalAccess', _35 => _35[0]]) || ""}`.toUpperCase() : null,
+    email: _optionalChain([user, 'optionalAccess', _36 => _36.email]) || null,
+    emailVerified: _optionalChain([user, 'optionalAccess', _37 => _37.email_verified]) || false
   };
 }
 
@@ -1219,4 +1281,5 @@ function useUser() {
 
 
 
-exports.defaultLocalization = defaultLocalization; exports.useLocalization = useLocalization; exports.fill = fill; exports.fillNode = fillNode; exports.useErrorResolver = useErrorResolver; exports.KerneClient = KerneClient; exports.KerneContext = KerneContext; exports.KerneProvider = KerneProvider; exports.useClient = useClient; exports.useAuth = useAuth; exports.useCheckout = useCheckout; exports.usePortal = usePortal; exports.useCancelSubscription = useCancelSubscription; exports.useChangePlan = useChangePlan; exports.useAccess = useAccess; exports.useSubscription = useSubscription; exports.usePlans = usePlans; exports.useAuthConfig = useAuthConfig; exports.useEntitlements = useEntitlements; exports.useUsage = useUsage; exports.useWaitlist = useWaitlist; exports.useInvitation = useInvitation; exports.useUser = useUser;
+
+exports.defaultLocalization = defaultLocalization; exports.useLocalization = useLocalization; exports.fill = fill; exports.fillNode = fillNode; exports.useErrorResolver = useErrorResolver; exports.KerneClient = KerneClient; exports.KerneContext = KerneContext; exports.KerneProvider = KerneProvider; exports.useClient = useClient; exports.useAuth = useAuth; exports.useCheckout = useCheckout; exports.usePortal = usePortal; exports.useCancelSubscription = useCancelSubscription; exports.useChangePlan = useChangePlan; exports.usePlanSwitch = usePlanSwitch; exports.useAccess = useAccess; exports.useSubscription = useSubscription; exports.usePlans = usePlans; exports.useAuthConfig = useAuthConfig; exports.useEntitlements = useEntitlements; exports.useUsage = useUsage; exports.useWaitlist = useWaitlist; exports.useInvitation = useInvitation; exports.useUser = useUser;

package/dist/{i18n-Di5qlnL1.d.cts → i18n-QilNgwqe.d.cts}

@@ -195,6 +195,11 @@ interface KerneLocalization {
         changePlan: string;
         current: string;
         switchTo: string;
+        switching: string;
+        switchConfirmTitle: string;
+        switchConfirmBody: string;
+        switchConfirmButton: string;
+        switchConfirmDismiss: string;
         noPlans: string;
         notOnInterval: string;
         loadFailed: string;

package/dist/{i18n-Di5qlnL1.d.ts → i18n-QilNgwqe.d.ts}

@@ -195,6 +195,11 @@ interface KerneLocalization {
         changePlan: string;
         current: string;
         switchTo: string;
+        switching: string;
+        switchConfirmTitle: string;
+        switchConfirmBody: string;
+        switchConfirmButton: string;
+        switchConfirmDismiss: string;
         noPlans: string;
         notOnInterval: string;
         loadFailed: string;

package/dist/index.cjs

@@ -19,25 +19,26 @@
 
 
 
-var _chunkIMZFZ3P5cjs = require('./chunk-IMZFZ3P5.cjs');
+
+var _chunkTYNZ2WU7cjs = require('./chunk-TYNZ2WU7.cjs');
 
 // src/components.tsx
 var _react = require('react'); var _react2 = _interopRequireDefault(_react);
 var _jsxruntime = require('react/jsx-runtime');
 function Authenticated({ children, fallback = null }) {
-  const { isAuthenticated } = _chunkIMZFZ3P5cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   return isAuthenticated ? children : fallback;
 }
 function Unauthenticated({ children, fallback = null }) {
-  const { isAuthenticated } = _chunkIMZFZ3P5cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   return !isAuthenticated ? children : fallback;
 }
 function AuthLoading({ children }) {
-  const client = _chunkIMZFZ3P5cjs.useClient.call(void 0, );
+  const client = _chunkTYNZ2WU7cjs.useClient.call(void 0, );
   return client.isLoading ? children : null;
 }
 function HasSubscription({ children, fallback = null }) {
-  const client = _chunkIMZFZ3P5cjs.useClient.call(void 0, );
+  const client = _chunkTYNZ2WU7cjs.useClient.call(void 0, );
   const [hasSubscription, setHasSubscription] = _react2.default.useState(null);
   _react2.default.useEffect(() => {
     client.getSubscription().then((sub) => {
@@ -55,7 +56,7 @@ function Access({
   requested,
   fallback = null
 }) {
-  const { allowed, isLoading } = _chunkIMZFZ3P5cjs.useAccess.call(void 0, featureKey, requested);
+  const { allowed, isLoading } = _chunkTYNZ2WU7cjs.useAccess.call(void 0, featureKey, requested);
   if (isLoading) return null;
   return allowed ? children : fallback;
 }
@@ -66,7 +67,7 @@ function Protected({
   authFallback = null,
   billingFallback = null
 }) {
-  const { isAuthenticated } = _chunkIMZFZ3P5cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   if (auth && !isAuthenticated) {
     return authFallback;
   }
@@ -179,4 +180,5 @@ function useKerneError() {
 
 
 
-exports.Access = Access; exports.AuthLoading = AuthLoading; exports.Authenticated = Authenticated; exports.HasSubscription = HasSubscription; exports.KerneClient = _chunkIMZFZ3P5cjs.KerneClient; exports.KerneContext = _chunkIMZFZ3P5cjs.KerneContext; exports.KerneErrorBoundary = KerneErrorBoundary; exports.KerneProvider = _chunkIMZFZ3P5cjs.KerneProvider; exports.Protected = Protected; exports.Unauthenticated = Unauthenticated; exports.defaultLocalization = _chunkIMZFZ3P5cjs.defaultLocalization; exports.useAccess = _chunkIMZFZ3P5cjs.useAccess; exports.useAuth = _chunkIMZFZ3P5cjs.useAuth; exports.useAuthConfig = _chunkIMZFZ3P5cjs.useAuthConfig; exports.useCancelSubscription = _chunkIMZFZ3P5cjs.useCancelSubscription; exports.useChangePlan = _chunkIMZFZ3P5cjs.useChangePlan; exports.useCheckout = _chunkIMZFZ3P5cjs.useCheckout; exports.useClient = _chunkIMZFZ3P5cjs.useClient; exports.useEntitlements = _chunkIMZFZ3P5cjs.useEntitlements; exports.useInvitation = _chunkIMZFZ3P5cjs.useInvitation; exports.useKerneError = useKerneError; exports.usePlans = _chunkIMZFZ3P5cjs.usePlans; exports.usePortal = _chunkIMZFZ3P5cjs.usePortal; exports.useSubscription = _chunkIMZFZ3P5cjs.useSubscription; exports.useUsage = _chunkIMZFZ3P5cjs.useUsage; exports.useUser = _chunkIMZFZ3P5cjs.useUser; exports.useWaitlist = _chunkIMZFZ3P5cjs.useWaitlist;
+
+exports.Access = Access; exports.AuthLoading = AuthLoading; exports.Authenticated = Authenticated; exports.HasSubscription = HasSubscription; exports.KerneClient = _chunkTYNZ2WU7cjs.KerneClient; exports.KerneContext = _chunkTYNZ2WU7cjs.KerneContext; exports.KerneErrorBoundary = KerneErrorBoundary; exports.KerneProvider = _chunkTYNZ2WU7cjs.KerneProvider; exports.Protected = Protected; exports.Unauthenticated = Unauthenticated; exports.defaultLocalization = _chunkTYNZ2WU7cjs.defaultLocalization; exports.useAccess = _chunkTYNZ2WU7cjs.useAccess; exports.useAuth = _chunkTYNZ2WU7cjs.useAuth; exports.useAuthConfig = _chunkTYNZ2WU7cjs.useAuthConfig; exports.useCancelSubscription = _chunkTYNZ2WU7cjs.useCancelSubscription; exports.useChangePlan = _chunkTYNZ2WU7cjs.useChangePlan; exports.useCheckout = _chunkTYNZ2WU7cjs.useCheckout; exports.useClient = _chunkTYNZ2WU7cjs.useClient; exports.useEntitlements = _chunkTYNZ2WU7cjs.useEntitlements; exports.useInvitation = _chunkTYNZ2WU7cjs.useInvitation; exports.useKerneError = useKerneError; exports.usePlanSwitch = _chunkTYNZ2WU7cjs.usePlanSwitch; exports.usePlans = _chunkTYNZ2WU7cjs.usePlans; exports.usePortal = _chunkTYNZ2WU7cjs.usePortal; exports.useSubscription = _chunkTYNZ2WU7cjs.useSubscription; exports.useUsage = _chunkTYNZ2WU7cjs.useUsage; exports.useUser = _chunkTYNZ2WU7cjs.useUser; exports.useWaitlist = _chunkTYNZ2WU7cjs.useWaitlist;

package/dist/index.d.cts

@@ -3,10 +3,10 @@ import React, { ReactNode, Component, ErrorInfo } from 'react';
 import { KerneConfig, JoinWaitlistParams, ValidateTokenResponse, ValidateCodeResponse } from '@kerne/server';
 export { JoinWaitlistParams, ValidateCodeResponse, ValidateTokenResponse, WaitlistEntry } from '@kerne/server';
 import * as _kerne_types from '@kerne/types';
-import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, UsageRecord } from '@kerne/types';
+import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, UsageRecord, PublicPlanPrice } from '@kerne/types';
 export { ActivationContext, AuthConfig, AuthResponse, EntitlementCheck, Entitlements, PublicPlan, Subscription, SubscriptionWithPlan, UsageRecord, User } from '@kerne/types';
-import { D as DeepPartial, K as KerneLocalization } from './i18n-Di5qlnL1.cjs';
-export { d as defaultLocalization } from './i18n-Di5qlnL1.cjs';
+import { D as DeepPartial, K as KerneLocalization } from './i18n-QilNgwqe.cjs';
+export { d as defaultLocalization } from './i18n-QilNgwqe.cjs';
 
 interface KerneReactConfig extends Omit<KerneConfig, 'secretKey'> {
     storage?: Storage;
@@ -344,6 +344,51 @@ declare function useChangePlan(): {
     }) => Promise<SubscriptionWithPlan>;
     isChanging: boolean;
 };
+interface PlanSwitchTarget {
+    plan: PublicPlan;
+    price: PublicPlanPrice;
+}
+/**
+ * The decision every "pick a plan" surface needs, shared so it is only
+ * decided once: an existing subscriber switching plans has to swap in place
+ * (`changePlanPrice`), never start a fresh checkout - Stripe/Polar don't know
+ * about the subscription already on file, so a new checkout session creates
+ * a SECOND, independent one instead of replacing it. The old one stays live
+ * and billed at the provider while Kerne only ever tracks the new one. A
+ * first-time subscriber has nothing to swap, so that case goes straight to
+ * checkout, same as before.
+ *
+ * The switch is staged rather than applied on `selectPlan` alone - it bills
+ * immediately on confirmation (unlike checkout, which only starts billing
+ * once the provider's own page is completed), so the caller's UI gets a
+ * chance to say so before `confirmSwitch()` commits it.
+ *
+ * @param subscription the subject's current subscription, or null - pass
+ * what `useSubscription()` already returned rather than fetching it again
+ * here, so a page showing the current plan and this hook always agree.
+ * @param refetchSubscription called after a successful switch, typically
+ * that same `useSubscription()` call's own `refetch()`.
+ *
+ * @example
+ * ```tsx
+ * const { subscription, refetch } = useSubscription();
+ * const { pending, switching, selectPlan, confirmSwitch, dismissSwitch } =
+ *   usePlanSwitch(subscription, refetch);
+ * ```
+ */
+declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void, options?: {
+    successUrl?: string;
+    cancelUrl?: string;
+}): {
+    pending: PlanSwitchTarget | null;
+    switching: boolean;
+    switchError: unknown;
+    checkoutPriceId: string | null;
+    checkoutError: unknown;
+    selectPlan: (plan: PublicPlan, price: PublicPlanPrice) => Promise<void>;
+    confirmSwitch: () => Promise<void>;
+    dismissSwitch: () => void;
+};
 /**
  * Whether the current scope has access to one feature - the single entry
  * point for a live, per-feature decision. Deliberately not named after what
@@ -691,4 +736,4 @@ declare function useKerneError(): {
     clearError: () => void;
 };
 
-export { Access, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, useCancelSubscription, useChangePlan, useCheckout, useClient, useEntitlements, useInvitation, useKerneError, usePlans, usePortal, useSubscription, useUsage, useUser, useWaitlist };
+export { Access, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, type PlanSwitchTarget, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, useCancelSubscription, useChangePlan, useCheckout, useClient, useEntitlements, useInvitation, useKerneError, usePlanSwitch, usePlans, usePortal, useSubscription, useUsage, useUser, useWaitlist };

package/dist/index.d.ts

@@ -3,10 +3,10 @@ import React, { ReactNode, Component, ErrorInfo } from 'react';
 import { KerneConfig, JoinWaitlistParams, ValidateTokenResponse, ValidateCodeResponse } from '@kerne/server';
 export { JoinWaitlistParams, ValidateCodeResponse, ValidateTokenResponse, WaitlistEntry } from '@kerne/server';
 import * as _kerne_types from '@kerne/types';
-import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, UsageRecord } from '@kerne/types';
+import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, UsageRecord, PublicPlanPrice } from '@kerne/types';
 export { ActivationContext, AuthConfig, AuthResponse, EntitlementCheck, Entitlements, PublicPlan, Subscription, SubscriptionWithPlan, UsageRecord, User } from '@kerne/types';
-import { D as DeepPartial, K as KerneLocalization } from './i18n-Di5qlnL1.js';
-export { d as defaultLocalization } from './i18n-Di5qlnL1.js';
+import { D as DeepPartial, K as KerneLocalization } from './i18n-QilNgwqe.js';
+export { d as defaultLocalization } from './i18n-QilNgwqe.js';
 
 interface KerneReactConfig extends Omit<KerneConfig, 'secretKey'> {
     storage?: Storage;
@@ -344,6 +344,51 @@ declare function useChangePlan(): {
     }) => Promise<SubscriptionWithPlan>;
     isChanging: boolean;
 };
+interface PlanSwitchTarget {
+    plan: PublicPlan;
+    price: PublicPlanPrice;
+}
+/**
+ * The decision every "pick a plan" surface needs, shared so it is only
+ * decided once: an existing subscriber switching plans has to swap in place
+ * (`changePlanPrice`), never start a fresh checkout - Stripe/Polar don't know
+ * about the subscription already on file, so a new checkout session creates
+ * a SECOND, independent one instead of replacing it. The old one stays live
+ * and billed at the provider while Kerne only ever tracks the new one. A
+ * first-time subscriber has nothing to swap, so that case goes straight to
+ * checkout, same as before.
+ *
+ * The switch is staged rather than applied on `selectPlan` alone - it bills
+ * immediately on confirmation (unlike checkout, which only starts billing
+ * once the provider's own page is completed), so the caller's UI gets a
+ * chance to say so before `confirmSwitch()` commits it.
+ *
+ * @param subscription the subject's current subscription, or null - pass
+ * what `useSubscription()` already returned rather than fetching it again
+ * here, so a page showing the current plan and this hook always agree.
+ * @param refetchSubscription called after a successful switch, typically
+ * that same `useSubscription()` call's own `refetch()`.
+ *
+ * @example
+ * ```tsx
+ * const { subscription, refetch } = useSubscription();
+ * const { pending, switching, selectPlan, confirmSwitch, dismissSwitch } =
+ *   usePlanSwitch(subscription, refetch);
+ * ```
+ */
+declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void, options?: {
+    successUrl?: string;
+    cancelUrl?: string;
+}): {
+    pending: PlanSwitchTarget | null;
+    switching: boolean;
+    switchError: unknown;
+    checkoutPriceId: string | null;
+    checkoutError: unknown;
+    selectPlan: (plan: PublicPlan, price: PublicPlanPrice) => Promise<void>;
+    confirmSwitch: () => Promise<void>;
+    dismissSwitch: () => void;
+};
 /**
  * Whether the current scope has access to one feature - the single entry
  * point for a live, per-feature decision. Deliberately not named after what
@@ -691,4 +736,4 @@ declare function useKerneError(): {
     clearError: () => void;
 };
 
-export { Access, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, useCancelSubscription, useChangePlan, useCheckout, useClient, useEntitlements, useInvitation, useKerneError, usePlans, usePortal, useSubscription, useUsage, useUser, useWaitlist };
+export { Access, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, type PlanSwitchTarget, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, useCancelSubscription, useChangePlan, useCheckout, useClient, useEntitlements, useInvitation, useKerneError, usePlanSwitch, usePlans, usePortal, useSubscription, useUsage, useUser, useWaitlist };

package/dist/index.js

@@ -13,13 +13,14 @@ import {
   useClient,
   useEntitlements,
   useInvitation,
+  usePlanSwitch,
   usePlans,
   usePortal,
   useSubscription,
   useUsage,
   useUser,
   useWaitlist
-} from "./chunk-NFJ2S5VJ.js";
+} from "./chunk-IZMRK3WK.js";
 
 // src/components.tsx
 import React from "react";
@@ -173,6 +174,7 @@ export {
   useEntitlements,
   useInvitation,
   useKerneError,
+  usePlanSwitch,
   usePlans,
   usePortal,
   useSubscription,