@kerne/react 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -3,10 +3,10 @@ import React, { ReactNode, Component, ErrorInfo } from 'react';
 import { KerneConfig, ConsumeParams, ReportUsageParams, ReportUsageBatchEvent, BatchUsageResult, 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, UsageRecord, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, PublicPlanPrice } from '@kerne/types';
+import { User, AuthResponse, ActivationContext, AuthConfig, EntitlementCheck, UsageRecord, DriverSelection, SubscriptionWithPlan, Subscription, PublicPlan, Entitlements, PublicPlanPrice } from '@kerne/types';
 export { ActivationContext, AuthConfig, AuthResponse, BatchUsageResult, EntitlementCheck, Entitlements, PublicPlan, Subscription, SubscriptionWithPlan, UsageRecord, User, ValidationFieldError } from '@kerne/types';
-import { D as DeepPartial, K as KerneLocalization } from './i18n-CXEhPK58.js';
-export { d as defaultLocalization } from './i18n-CXEhPK58.js';
+import { D as DeepPartial, K as KerneLocalization, a as KerneAppearance } from './fr-E5mmylSH.js';
+export { d as defaultLocalization, f as fr, m as mergeLocalization } from './fr-E5mmylSH.js';
 
 interface KerneReactConfig extends Omit<KerneConfig, 'secretKey'> {
     storage?: Storage;
@@ -119,14 +119,14 @@ declare class KerneClient {
     /** Soft-deletes (deactivates) the caller's own account, then clears the local session. */
     requestAccountDeletion(): Promise<void>;
     /** Forgot-password flow (logged out) - sends the reset email. */
-    requestPasswordReset(email: string, callbackUrl?: string): Promise<void>;
+    requestPasswordReset(email: string): Promise<void>;
     /** Confirms a password reset with the token from the email. */
     confirmPasswordReset(token: string, password: string): Promise<void>;
     /**
      * Sends a magic-link email (logged out). Anti-enumeration: always resolves,
      * regardless of whether the email is registered.
      */
-    startPasswordless(email: string, callbackUrl?: string, invitation?: {
+    startPasswordless(email: string, invitation?: {
         invitationToken?: string;
         invitationCode?: string;
     }): Promise<void>;
@@ -173,16 +173,10 @@ declare class KerneClient {
     /** Several usage events in one request instead of one call each - kills the manual request staggering. */
     reportUsageBatch(events: Array<Omit<ReportUsageBatchEvent, 'subject'>>): Promise<BatchUsageResult[]>;
     private requireUserId;
-    createCheckout(planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }): Promise<string>;
-    openCheckout(planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }): Promise<void>;
-    createPortal(returnUrl?: string): Promise<string>;
-    openPortal(returnUrl?: string): Promise<void>;
+    createCheckout(planPriceId: string, drivers?: DriverSelection[]): Promise<string>;
+    openCheckout(planPriceId: string, drivers?: DriverSelection[]): Promise<void>;
+    createPortal(): Promise<string>;
+    openPortal(): 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>;
@@ -203,7 +197,7 @@ declare class KerneClient {
     validateInvitationToken(token: string): Promise<ValidateTokenResponse>;
     /** Validate an invitation code before showing the registration form. */
     validateInvitationCode(code: string): Promise<ValidateCodeResponse>;
-    sendVerificationEmail(verificationType?: 'code' | 'link', callbackUrl?: string): Promise<void>;
+    sendVerificationEmail(verificationType?: 'code' | 'link'): Promise<void>;
     verifyEmailWithCode(code: string): Promise<{
         success: boolean;
         needsTokenRefresh: boolean;
@@ -229,8 +223,14 @@ interface KerneProviderProps extends KerneReactConfig {
      * override keeps everything it does not mention.
      */
     localization?: DeepPartial<KerneLocalization>;
+    /**
+     * Appearance for every prebuilt component, set once. A host with its own dark
+     * mode would otherwise pass it to each one and keep them in sync by hand; a
+     * component's own `appearance` still wins, field by field.
+     */
+    appearance?: KerneAppearance;
 }
-declare function KerneProvider({ children, localization, ...config }: KerneProviderProps): react_jsx_runtime.JSX.Element;
+declare function KerneProvider({ children, localization, appearance, ...config }: KerneProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Access the Kerne client instance
@@ -273,14 +273,14 @@ declare function useAuth(): {
         newPassword: string;
     }) => Promise<void>;
     requestAccountDeletion: () => Promise<void>;
-    requestPasswordReset: (email: string, callbackUrl?: string) => Promise<void>;
+    requestPasswordReset: (email: string) => Promise<void>;
     confirmPasswordReset: (token: string, password: string) => Promise<void>;
-    startPasswordless: (email: string, callbackUrl?: string, invitation?: {
+    startPasswordless: (email: string, invitation?: {
         invitationToken?: string;
         invitationCode?: string;
     }) => Promise<void>;
     loginWithMagicLink: (token: string) => Promise<_kerne_types.AuthResponse>;
-    sendVerificationEmail: (verificationType?: "code" | "link", callbackUrl?: string) => Promise<void>;
+    sendVerificationEmail: (verificationType?: "code" | "link") => Promise<void>;
     verifyEmailWithCode: (code: string) => Promise<{
         success: boolean;
         needsTokenRefresh: boolean;
@@ -308,14 +308,8 @@ declare function useAuth(): {
  * ```
  */
 declare function useCheckout(): {
-    createCheckout: (planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }) => Promise<string>;
-    openCheckout: (planPriceId: string, options?: {
-        successUrl?: string;
-        cancelUrl?: string;
-    }) => Promise<void>;
+    createCheckout: (planPriceId: string, drivers?: DriverSelection[]) => Promise<string>;
+    openCheckout: (planPriceId: string, drivers?: DriverSelection[]) => Promise<void>;
 };
 /**
  * Billing portal hook - lets a user manage their subscription/payment method.
@@ -327,8 +321,8 @@ declare function useCheckout(): {
  * ```
  */
 declare function usePortal(): {
-    createPortal: (returnUrl?: string) => Promise<string>;
-    openPortal: (returnUrl?: string) => Promise<void>;
+    createPortal: () => Promise<string>;
+    openPortal: () => Promise<void>;
 };
 /**
  * Cancels or changes the current scope's own subscription - JWT-scoped like every other hook
@@ -383,16 +377,13 @@ interface PlanSwitchTarget {
  *   usePlanSwitch(subscription, refetch);
  * ```
  */
-declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void, options?: {
-    successUrl?: string;
-    cancelUrl?: string;
-}): {
+declare function usePlanSwitch(subscription: SubscriptionWithPlan | null, refetchSubscription: () => void): {
     pending: PlanSwitchTarget | null;
     switching: boolean;
     switchError: unknown;
     checkoutPriceId: string | null;
     checkoutError: unknown;
-    selectPlan: (plan: PublicPlan, price: PublicPlanPrice) => Promise<void>;
+    selectPlan: (plan: PublicPlan, price: PublicPlanPrice, drivers?: DriverSelection[]) => Promise<void>;
     confirmSwitch: () => Promise<void>;
     dismissSwitch: () => void;
 };
@@ -475,9 +466,13 @@ declare function useAuthConfig(): {
 };
 /**
  * Every entitlement for the current user in one call - for a "your plan"
- * screen. Use `useAccess` instead for a single feature - this response
- * never carries `allowed` (see docs: the list is cached, a stale verdict
- * would be unsafe).
+ * screen. `EntitlementSummary` carries no `allowed` field, on purpose: this
+ * list is a cached snapshot for display ("12/50 calls used"), not a live
+ * verdict. **Never gate access by reading `limit`/`remaining`/`enabled`
+ * yourself** - that silently reimplements override precedence, overage
+ * rules, and the race against concurrent usage that `useAccess()` already
+ * handles server-side. Use `useAccess()` (or `kerne.allows()`/`enforce()`)
+ * for every actual gate, and this hook only to render numbers.
  *
  * @example
  * ```tsx

package/dist/index.js

@@ -4,6 +4,8 @@ import {
   KerneContext,
   KerneProvider,
   defaultLocalization,
+  fr,
+  mergeLocalization,
   useAccess,
   useAuth,
   useAuthConfig,
@@ -21,7 +23,7 @@ import {
   useUsage,
   useUser,
   useWaitlist
-} from "./chunk-IHNWY4ML.js";
+} from "./chunk-ZVL47U4B.js";
 
 // src/components.tsx
 import React from "react";
@@ -81,6 +83,37 @@ function Protected({
 // src/error-boundary.tsx
 import React2, { Component } from "react";
 import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+var STYLE_ELEMENT_ID = "kerne-error-boundary-styles";
+var CSS = `
+.kerne-eb { padding: 24px; text-align: center; color: #16171a; }
+.kerne-eb-title { font-size: 20px; font-weight: 600; letter-spacing: -.01em; margin: 0 0 8px; }
+.kerne-eb-body { color: #6b7280; margin: 0 auto 20px; max-width: 40ch; font-size: 14px; line-height: 1.5; }
+.kerne-eb-code { color: #6f7681; margin: -12px 0 20px; font-size: 12px; }
+.kerne-eb-button {
+  font: inherit; font-size: 14px; font-weight: 500; height: 44px;
+  padding: 0 20px; border-radius: 8px; border: none; cursor: pointer;
+  background: #16171a; color: #fff;
+  transition: background-color .12s ease;
+}
+.kerne-eb-button:hover { background: #2c2e33; }
+.kerne-eb-button:focus-visible { outline: 2px solid #16171a; outline-offset: 2px; }
+@media (prefers-color-scheme: dark) {
+  .kerne-eb { color: #f0f1f3; }
+  .kerne-eb-body { color: #9ba2ad; }
+  .kerne-eb-code { color: #838b96; }
+  .kerne-eb-button { background: #f0f1f3; color: #16181d; }
+  .kerne-eb-button:hover { background: #d8dade; }
+  .kerne-eb-button:focus-visible { outline-color: #f0f1f3; }
+}
+`;
+function ensureErrorBoundaryStylesInjected() {
+  if (typeof document === "undefined") return;
+  if (document.getElementById(STYLE_ELEMENT_ID)) return;
+  const style = document.createElement("style");
+  style.id = STYLE_ELEMENT_ID;
+  style.textContent = CSS;
+  document.head.appendChild(style);
+}
 var KerneErrorBoundary = class extends Component {
   constructor(props) {
     super(props);
@@ -111,28 +144,15 @@ var KerneErrorBoundary = class extends Component {
         }
         return fallback;
       }
-      return /* @__PURE__ */ jsxs("div", { style: { padding: "20px", textAlign: "center" }, children: [
-        /* @__PURE__ */ jsx2("h2", { style: { color: "#dc2626", marginBottom: "10px" }, children: "Something went wrong" }),
-        /* @__PURE__ */ jsx2("p", { style: { color: "#6b7280", marginBottom: "20px" }, children: error.message || "An unexpected error occurred" }),
-        error.code && /* @__PURE__ */ jsxs("p", { style: { color: "#9ca3af", fontSize: "12px", marginBottom: "20px" }, children: [
+      ensureErrorBoundaryStylesInjected();
+      return /* @__PURE__ */ jsxs("div", { className: "kerne-eb", children: [
+        /* @__PURE__ */ jsx2("h2", { className: "kerne-eb-title", children: "Something went wrong" }),
+        /* @__PURE__ */ jsx2("p", { className: "kerne-eb-body", children: error.message || "An unexpected error occurred" }),
+        error.code && /* @__PURE__ */ jsxs("p", { className: "kerne-eb-code", children: [
           "Error code: ",
           error.code
         ] }),
-        /* @__PURE__ */ jsx2(
-          "button",
-          {
-            onClick: this.reset,
-            style: {
-              padding: "10px 20px",
-              backgroundColor: "#3b82f6",
-              color: "white",
-              border: "none",
-              borderRadius: "6px",
-              cursor: "pointer"
-            },
-            children: "Try again"
-          }
-        )
+        /* @__PURE__ */ jsx2("button", { type: "button", className: "kerne-eb-button", onClick: this.reset, children: "Try again" })
       ] });
     }
     return this.props.children;
@@ -165,6 +185,8 @@ export {
   Protected,
   Unauthenticated,
   defaultLocalization,
+  fr,
+  mergeLocalization,
   useAccess,
   useAuth,
   useAuthConfig,