@kerne/react 0.1.3 → 1.1.0

package/dist/index.cjs

@@ -17,25 +17,28 @@
 
 
 
-var _chunk7U3QBMA7cjs = require('./chunk-7U3QBMA7.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 } = _chunk7U3QBMA7cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   return isAuthenticated ? children : fallback;
 }
 function Unauthenticated({ children, fallback = null }) {
-  const { isAuthenticated } = _chunk7U3QBMA7cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   return !isAuthenticated ? children : fallback;
 }
 function AuthLoading({ children }) {
-  const client = _chunk7U3QBMA7cjs.useClient.call(void 0, );
+  const client = _chunkTYNZ2WU7cjs.useClient.call(void 0, );
   return client.isLoading ? children : null;
 }
 function HasSubscription({ children, fallback = null }) {
-  const client = _chunk7U3QBMA7cjs.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) => {
@@ -47,22 +50,14 @@ function HasSubscription({ children, fallback = null }) {
   if (hasSubscription === null) return null;
   return hasSubscription ? children : fallback;
 }
-function Allows({
+function Access({
   children,
   featureKey,
-  minimum,
+  requested,
   fallback = null
 }) {
-  const client = _chunk7U3QBMA7cjs.useClient.call(void 0, );
-  const [allowed, setAllowed] = _react2.default.useState(null);
-  _react2.default.useEffect(() => {
-    client.allows(featureKey, minimum).then((result) => {
-      setAllowed(result);
-    }).catch(() => {
-      setAllowed(false);
-    });
-  }, [client, featureKey, minimum]);
-  if (allowed === null) return null;
+  const { allowed, isLoading } = _chunkTYNZ2WU7cjs.useAccess.call(void 0, featureKey, requested);
+  if (isLoading) return null;
   return allowed ? children : fallback;
 }
 function Protected({
@@ -72,12 +67,12 @@ function Protected({
   authFallback = null,
   billingFallback = null
 }) {
-  const { isAuthenticated } = _chunk7U3QBMA7cjs.useAuth.call(void 0, );
+  const { isAuthenticated } = _chunkTYNZ2WU7cjs.useAuth.call(void 0, );
   if (auth && !isAuthenticated) {
     return authFallback;
   }
   if (featureKey) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Allows, { featureKey, fallback: billingFallback, children });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Access, { featureKey, fallback: billingFallback, children });
   }
   return children;
 }
@@ -183,4 +178,7 @@ function useKerneError() {
 
 
 
-exports.Allows = Allows; exports.AuthLoading = AuthLoading; exports.Authenticated = Authenticated; exports.HasSubscription = HasSubscription; exports.KerneClient = _chunk7U3QBMA7cjs.KerneClient; exports.KerneContext = _chunk7U3QBMA7cjs.KerneContext; exports.KerneErrorBoundary = KerneErrorBoundary; exports.KerneProvider = _chunk7U3QBMA7cjs.KerneProvider; exports.Protected = Protected; exports.Unauthenticated = Unauthenticated; exports.defaultLocalization = _chunk7U3QBMA7cjs.defaultLocalization; exports.useAccess = _chunk7U3QBMA7cjs.useAccess; exports.useAuth = _chunk7U3QBMA7cjs.useAuth; exports.useAuthConfig = _chunk7U3QBMA7cjs.useAuthConfig; exports.useCheckout = _chunk7U3QBMA7cjs.useCheckout; exports.useClient = _chunk7U3QBMA7cjs.useClient; exports.useEntitlements = _chunk7U3QBMA7cjs.useEntitlements; exports.useInvitation = _chunk7U3QBMA7cjs.useInvitation; exports.useKerneError = useKerneError; exports.usePlans = _chunk7U3QBMA7cjs.usePlans; exports.usePortal = _chunk7U3QBMA7cjs.usePortal; exports.useSubscription = _chunk7U3QBMA7cjs.useSubscription; exports.useUsage = _chunk7U3QBMA7cjs.useUsage; exports.useUser = _chunk7U3QBMA7cjs.useUser; exports.useWaitlist = _chunk7U3QBMA7cjs.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, 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-BWTT1DWD.cjs';
-export { d as defaultLocalization } from './i18n-BWTT1DWD.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;
@@ -160,7 +160,7 @@ declare class KerneClient {
      * caught everything and returned `false`) - a 401/500 must not be
      * indistinguishable from a real denial, that's exactly what let the
      * `has_access`/`allowed` mismatch below ship unnoticed. Callers that want
-     * a fail-closed boolean regardless of the reason (e.g. `<Allows>`)
+     * a fail-closed boolean regardless of the reason (e.g. `<Access>`)
      * catch around this themselves.
      */
     allows(featureKey: string, requested?: number): Promise<boolean>;
@@ -177,6 +177,12 @@ declare class KerneClient {
     createPortal(returnUrl?: string): Promise<string>;
     openPortal(returnUrl?: string): Promise<void>;
     getSubscription(productSlug?: string): Promise<SubscriptionWithPlan | null>;
+    /** `immediately: true` ends it now; otherwise cancels at period end (API default). */
+    cancelSubscription(subscriptionId: string, immediately?: boolean): Promise<Subscription>;
+    /** Swaps the plan/price, effective immediately - deferring a downgrade isn't supported yet. */
+    changeSubscriptionPlan(subscriptionId: string, planPriceId: string, options?: {
+        prorationBehavior?: 'none' | 'create_prorations';
+    }): Promise<SubscriptionWithPlan>;
     /** Public pricing data - omit `productIdOrSlug` for the tenant's default product. */
     getPlans(productIdOrSlug?: string): Promise<PublicPlan[]>;
     /** Every entitlement for the current user in one call - for a "your plan" screen. */
@@ -317,6 +323,72 @@ declare function usePortal(): {
     createPortal: (returnUrl?: string) => Promise<string>;
     openPortal: (returnUrl?: string) => Promise<void>;
 };
+/**
+ * Cancels or changes the current scope's own subscription - JWT-scoped like every other hook
+ * here, so this can only ever act on the caller's own subscription (see `SubscriptionCard`).
+ *
+ * @example
+ * ```tsx
+ * const { cancelSubscription, isCanceling } = useCancelSubscription();
+ * <button onClick={() => cancelSubscription(subscriptionId)}>Cancel</button>
+ * ```
+ */
+declare function useCancelSubscription(): {
+    cancelSubscription: (subscriptionId: string, immediately?: boolean) => Promise<_kerne_types.Subscription>;
+    isCanceling: boolean;
+};
+/** Changes the current scope's own subscription to a different plan/price, effective immediately. */
+declare function useChangePlan(): {
+    changePlan: (subscriptionId: string, planPriceId: string, options?: {
+        prorationBehavior?: "none" | "create_prorations";
+    }) => 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
@@ -359,6 +431,7 @@ declare function useAccess(featureKey: string, requested?: number): {
 declare function useSubscription(productSlug?: string): {
     isActive: boolean;
     planSlug: string | undefined;
+    refetch: () => void;
     subscription: SubscriptionWithPlan | null;
     isLoading: boolean;
     error: Error | null;
@@ -552,24 +625,35 @@ interface EntitlementGuardProps {
      * `UpgradePrompt`, so the whole entitlement surface reads alike.
      */
     featureKey: string;
-    /** Minimum value required (for limit features) */
-    minimum?: number;
+    /**
+     * Units the gated action is about to consume - checked before it runs, not
+     * after. A QUOTA feature with 3 remaining still passes a plain `<Access>`
+     * (>0 left), but fails `requested={5}` up front, so a batch action can be
+     * blocked before the user commits to it instead of after a partial
+     * `consume()` fails mid-way. Omit for a plain yes/no gate.
+     */
+    requested?: number;
     /** Fallback content when entitlement is not met */
     fallback?: ReactNode;
 }
 /**
- * Renders children only when the scope is entitled to a capability. Checks the
- * entitlement itself, never a plan name - a plan can be renamed or restructured
- * without breaking every place that gated on its slug.
+ * Renders children only when the subject is entitled to a capability - and,
+ * with `requested`, entitled to that many units of it right now. Checks the
+ * entitlement itself, never a plan name - a plan can be renamed or
+ * restructured without breaking every place that gated on its slug.
  *
  * @example
  * ```tsx
- * <Allows featureKey="advanced_analytics" fallback={<UpgradePrompt featureKey="advanced_analytics" />}>
+ * <Access featureKey="advanced_analytics" fallback={<UpgradePrompt featureKey="advanced_analytics" />}>
  *   <AnalyticsDashboard />
- * </Allows>
+ * </Access>
+ *
+ * <Access featureKey="ai_credits" requested={5} fallback={<UpgradePrompt reason="Not enough credits for batch processing" />}>
+ *   <BatchProcessButton count={5} />
+ * </Access>
  * ```
  */
-declare function Allows({ children, featureKey, minimum, fallback, }: EntitlementGuardProps): ReactNode;
+declare function Access({ children, featureKey, requested, fallback, }: EntitlementGuardProps): ReactNode;
 interface ProtectedProps {
     children: ReactNode;
     /** Require authentication */
@@ -652,4 +736,4 @@ declare function useKerneError(): {
     clearError: () => void;
 };
 
-export { Allows, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, 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, 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-BWTT1DWD.js';
-export { d as defaultLocalization } from './i18n-BWTT1DWD.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;
@@ -160,7 +160,7 @@ declare class KerneClient {
      * caught everything and returned `false`) - a 401/500 must not be
      * indistinguishable from a real denial, that's exactly what let the
      * `has_access`/`allowed` mismatch below ship unnoticed. Callers that want
-     * a fail-closed boolean regardless of the reason (e.g. `<Allows>`)
+     * a fail-closed boolean regardless of the reason (e.g. `<Access>`)
      * catch around this themselves.
      */
     allows(featureKey: string, requested?: number): Promise<boolean>;
@@ -177,6 +177,12 @@ declare class KerneClient {
     createPortal(returnUrl?: string): Promise<string>;
     openPortal(returnUrl?: string): Promise<void>;
     getSubscription(productSlug?: string): Promise<SubscriptionWithPlan | null>;
+    /** `immediately: true` ends it now; otherwise cancels at period end (API default). */
+    cancelSubscription(subscriptionId: string, immediately?: boolean): Promise<Subscription>;
+    /** Swaps the plan/price, effective immediately - deferring a downgrade isn't supported yet. */
+    changeSubscriptionPlan(subscriptionId: string, planPriceId: string, options?: {
+        prorationBehavior?: 'none' | 'create_prorations';
+    }): Promise<SubscriptionWithPlan>;
     /** Public pricing data - omit `productIdOrSlug` for the tenant's default product. */
     getPlans(productIdOrSlug?: string): Promise<PublicPlan[]>;
     /** Every entitlement for the current user in one call - for a "your plan" screen. */
@@ -317,6 +323,72 @@ declare function usePortal(): {
     createPortal: (returnUrl?: string) => Promise<string>;
     openPortal: (returnUrl?: string) => Promise<void>;
 };
+/**
+ * Cancels or changes the current scope's own subscription - JWT-scoped like every other hook
+ * here, so this can only ever act on the caller's own subscription (see `SubscriptionCard`).
+ *
+ * @example
+ * ```tsx
+ * const { cancelSubscription, isCanceling } = useCancelSubscription();
+ * <button onClick={() => cancelSubscription(subscriptionId)}>Cancel</button>
+ * ```
+ */
+declare function useCancelSubscription(): {
+    cancelSubscription: (subscriptionId: string, immediately?: boolean) => Promise<_kerne_types.Subscription>;
+    isCanceling: boolean;
+};
+/** Changes the current scope's own subscription to a different plan/price, effective immediately. */
+declare function useChangePlan(): {
+    changePlan: (subscriptionId: string, planPriceId: string, options?: {
+        prorationBehavior?: "none" | "create_prorations";
+    }) => 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
@@ -359,6 +431,7 @@ declare function useAccess(featureKey: string, requested?: number): {
 declare function useSubscription(productSlug?: string): {
     isActive: boolean;
     planSlug: string | undefined;
+    refetch: () => void;
     subscription: SubscriptionWithPlan | null;
     isLoading: boolean;
     error: Error | null;
@@ -552,24 +625,35 @@ interface EntitlementGuardProps {
      * `UpgradePrompt`, so the whole entitlement surface reads alike.
      */
     featureKey: string;
-    /** Minimum value required (for limit features) */
-    minimum?: number;
+    /**
+     * Units the gated action is about to consume - checked before it runs, not
+     * after. A QUOTA feature with 3 remaining still passes a plain `<Access>`
+     * (>0 left), but fails `requested={5}` up front, so a batch action can be
+     * blocked before the user commits to it instead of after a partial
+     * `consume()` fails mid-way. Omit for a plain yes/no gate.
+     */
+    requested?: number;
     /** Fallback content when entitlement is not met */
     fallback?: ReactNode;
 }
 /**
- * Renders children only when the scope is entitled to a capability. Checks the
- * entitlement itself, never a plan name - a plan can be renamed or restructured
- * without breaking every place that gated on its slug.
+ * Renders children only when the subject is entitled to a capability - and,
+ * with `requested`, entitled to that many units of it right now. Checks the
+ * entitlement itself, never a plan name - a plan can be renamed or
+ * restructured without breaking every place that gated on its slug.
  *
  * @example
  * ```tsx
- * <Allows featureKey="advanced_analytics" fallback={<UpgradePrompt featureKey="advanced_analytics" />}>
+ * <Access featureKey="advanced_analytics" fallback={<UpgradePrompt featureKey="advanced_analytics" />}>
  *   <AnalyticsDashboard />
- * </Allows>
+ * </Access>
+ *
+ * <Access featureKey="ai_credits" requested={5} fallback={<UpgradePrompt reason="Not enough credits for batch processing" />}>
+ *   <BatchProcessButton count={5} />
+ * </Access>
  * ```
  */
-declare function Allows({ children, featureKey, minimum, fallback, }: EntitlementGuardProps): ReactNode;
+declare function Access({ children, featureKey, requested, fallback, }: EntitlementGuardProps): ReactNode;
 interface ProtectedProps {
     children: ReactNode;
     /** Require authentication */
@@ -652,4 +736,4 @@ declare function useKerneError(): {
     clearError: () => void;
 };
 
-export { Allows, AuthLoading, Authenticated, HasSubscription, KerneClient, KerneContext, type KerneError, KerneErrorBoundary, KerneLocalization, KerneProvider, type KerneProviderProps, type KerneReactConfig, Protected, Unauthenticated, useAccess, useAuth, useAuthConfig, 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

@@ -7,17 +7,20 @@ import {
   useAccess,
   useAuth,
   useAuthConfig,
+  useCancelSubscription,
+  useChangePlan,
   useCheckout,
   useClient,
   useEntitlements,
   useInvitation,
+  usePlanSwitch,
   usePlans,
   usePortal,
   useSubscription,
   useUsage,
   useUser,
   useWaitlist
-} from "./chunk-F6NV76OR.js";
+} from "./chunk-IZMRK3WK.js";
 
 // src/components.tsx
 import React from "react";
@@ -47,22 +50,14 @@ function HasSubscription({ children, fallback = null }) {
   if (hasSubscription === null) return null;
   return hasSubscription ? children : fallback;
 }
-function Allows({
+function Access({
   children,
   featureKey,
-  minimum,
+  requested,
   fallback = null
 }) {
-  const client = useClient();
-  const [allowed, setAllowed] = React.useState(null);
-  React.useEffect(() => {
-    client.allows(featureKey, minimum).then((result) => {
-      setAllowed(result);
-    }).catch(() => {
-      setAllowed(false);
-    });
-  }, [client, featureKey, minimum]);
-  if (allowed === null) return null;
+  const { allowed, isLoading } = useAccess(featureKey, requested);
+  if (isLoading) return null;
   return allowed ? children : fallback;
 }
 function Protected({
@@ -77,7 +72,7 @@ function Protected({
     return authFallback;
   }
   if (featureKey) {
-    return /* @__PURE__ */ jsx(Allows, { featureKey, fallback: billingFallback, children });
+    return /* @__PURE__ */ jsx(Access, { featureKey, fallback: billingFallback, children });
   }
   return children;
 }
@@ -158,7 +153,7 @@ function useKerneError() {
   };
 }
 export {
-  Allows,
+  Access,
   AuthLoading,
   Authenticated,
   HasSubscription,
@@ -172,11 +167,14 @@ export {
   useAccess,
   useAuth,
   useAuthConfig,
+  useCancelSubscription,
+  useChangePlan,
   useCheckout,
   useClient,
   useEntitlements,
   useInvitation,
   useKerneError,
+  usePlanSwitch,
   usePlans,
   usePortal,
   useSubscription,