@churnkey/react 0.6.5 → 0.7.1

package/dist/{step-graph-Dee2cFLK.d.cts → step-graph-C7JC8Umv.d.cts}

@@ -1,5 +1,149 @@
 import { ReactNode, ReactElement, ComponentType } from 'react';
 
+/** Both timing variants of a message. Which one renders is decided by the
+ *  flow's effective cancel timing (`FlowState.cancelAtPeriodEnd`). */
+interface TimingVariants {
+    immediate: string;
+    atPeriodEnd: string;
+}
+/**
+ * A message that may differ by cancellation timing. Plain strings render
+ * as-is in both cases; pass the object form when the wording should change
+ * (e.g. "Cancel" vs "Turn off auto-renew").
+ */
+type TimingAware = string | TimingVariants;
+/** Success-screen copy for one accepted offer type. */
+interface SavedOfferCopy {
+    title: string;
+    description: string;
+}
+interface CancelFlowMessages {
+    common: {
+        continue: string;
+        back: string;
+        close: string;
+        done: string;
+        processing: string;
+        tryAgain: string;
+        loading: string;
+        loadError: string;
+        error: string;
+        day: string;
+        days: string;
+        month: string;
+        months: string;
+    };
+    survey: {
+        title: string;
+        followupPlaceholder: string;
+        followupAriaLabel: string;
+    };
+    feedback: {
+        title: string;
+        placeholder: string;
+        /** Used instead of `placeholder` when the step sets `minLength`. Supports `{minLength}`. */
+        placeholderWithMin: string;
+    };
+    confirm: {
+        title: string;
+        lossesLabel: string;
+        cta: TimingAware;
+        goBack: string;
+        /** Shown between the description and the confirm button. Supports
+         *  `{periodEnd}`. The default immediate variant is empty, which
+         *  suppresses the notice for immediate timing; empty OVERRIDE values are
+         *  dropped like any blank override, so to remove the notice entirely
+         *  replace the `Confirm` component or hide it via
+         *  `classNames.periodEndNotice`. */
+        periodEndNotice: TimingAware;
+    };
+    success: {
+        saved: {
+            /** Generic fallback — used for offer types without their own entry
+             *  (contact, redirect, custom types). */
+            title: string;
+            description: string;
+            discount: SavedOfferCopy;
+            pause: SavedOfferCopy & {
+                /** Used instead of `description` when the resume date is known
+                 *  (the built-in pause UI always supplies it). Supports `{resumeDate}`. */
+                resumeDescription: string;
+            };
+            trial_extension: SavedOfferCopy;
+            plan_change: SavedOfferCopy;
+            rebate: SavedOfferCopy;
+        };
+        cancelled: {
+            title: TimingAware;
+            description: TimingAware;
+        };
+    };
+    offer: {
+        limitedTimeEyebrow: string;
+        pauseEyebrow: string;
+        newEndDateLabel: string;
+        currentPlanBadge: string;
+        /** CTA when a plan is selected in a plan-change offer. Supports `{planName}`. */
+        switchToCta: string;
+        /**
+         * Accept-button override per offer type. Defaults are empty: an unset
+         * key falls through to the offer's own `copy.cta` (today a
+         * server-synthesized default like "Accept refund"; authored per-offer
+         * copy, when it exists, keeps winning over an unset key).
+         */
+        acceptCta: {
+            discount: string;
+            pause: string;
+            trial_extension: string;
+            plan_change: string;
+            contact: string;
+            redirect: string;
+            rebate: string;
+        };
+        /** Decline-link override for every offer type. Empty default falls
+         *  through to the offer's own `copy.declineCta`. */
+        declineCta: string;
+        rebate: {
+            paidLabel: string;
+            moneyBackLabel: string;
+            /** Tax parenthetical after the money-back label. Supports `{amount}`. */
+            inclTax: string;
+            netLabel: string;
+        };
+    };
+}
+/**
+ * Recursive partial of the catalog for overrides. Timing-aware fields also
+ * accept a plain string (applies to both timings) or a partial variant pair
+ * (the missing variant keeps the base value).
+ */
+type MessagesPatch<T = CancelFlowMessages> = {
+    [K in keyof T]?: T[K] extends string ? string : T[K] extends TimingAware ? string | Partial<TimingVariants> : MessagesPatch<T[K]>;
+};
+interface I18nConfig {
+    /** UI language. Defaults to the browser language, falling back to `'en'`. */
+    locale?: string;
+    /** Per-locale message overrides, e.g. `{ en: { confirm: { cta: 'Turn off auto-renew' } } }`. */
+    messages?: Record<string, MessagesPatch>;
+}
+declare const defaultMessages: CancelFlowMessages;
+/**
+ * Pick the string for the flow's effective cancel timing. `null` (timing
+ * unknown — local mode) behaves like period-end, matching the default the
+ * cancel action itself uses.
+ */
+declare function selectTiming(value: TimingAware, cancelAtPeriodEnd: boolean | null): string;
+/** Replace `{name}` tokens. Unknown tokens are left in place. */
+declare function formatMessage(template: string, vars: Record<string, string | number>): string;
+/**
+ * Resolve the full catalog for a locale. Layers, lowest to highest: built-in
+ * defaults, then `orgMessages` (dashboard-configured overrides delivered on
+ * the token-mode config), then the config's own per-locale messages — the
+ * developer's overrides always end up on top. Both per-language layers run
+ * through the same locale fallback chain.
+ */
+declare function buildMessages(i18n?: I18nConfig, orgMessages?: Record<string, MessagesPatch>): CancelFlowMessages;
+
 interface DirectAddress {
     line1?: string;
     line2?: string;
@@ -444,10 +588,14 @@ interface ModalProps {
 interface CloseButtonProps {
     onClose: () => void;
     className?: string;
+    /** Accessible label. Defaults to "Close". */
+    label?: string;
 }
 interface BackButtonProps {
     onBack: () => void;
     className?: string;
+    /** Visible label. Defaults to "Back". */
+    label?: string;
 }
 interface SurveyStepProps {
     title: string;
@@ -464,6 +612,8 @@ interface SurveyStepProps {
     onNext: () => void;
     classNames?: SurveyClassNames;
     components?: Partial<ComponentOverrides>;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface OfferStepProps {
     title?: string;
@@ -486,6 +636,8 @@ interface OfferStepProps {
      * implementations can ignore this.
      */
     components?: Partial<ComponentOverrides>;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface FeedbackStepProps {
     title: string;
@@ -499,6 +651,8 @@ interface FeedbackStepProps {
     onChange: (text: string) => void;
     onSubmit: () => void;
     classNames?: FeedbackClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface ConfirmStepProps {
     title: string;
@@ -509,20 +663,33 @@ interface ConfirmStepProps {
     lossesLabel?: string;
     confirmLabel: string;
     goBackLabel: string;
+    /**
+     * Timing-resolved access notice ("Your access continues until June 14, 2026."),
+     * rendered between the loss list and the confirm button. Absent when the
+     * period end is unknown or the resolved message is empty.
+     */
+    periodEndNotice?: string;
     onConfirm: () => Promise<void>;
     onGoBack: () => void;
     isProcessing: boolean;
     classNames?: ConfirmClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface SuccessStepProps {
     outcome: 'saved' | 'cancelled';
     offer?: OfferDecision;
+    /** The accepted offer (consumer-facing shape, incl. any accept result).
+     *  Present when outcome is 'saved'. */
+    acceptedOffer?: AcceptedOffer;
     title: string;
     description?: string;
     customer: DirectCustomer | null;
     subscriptions: DirectSubscription[];
     onClose: () => void;
     classNames?: SuccessClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface ReasonButtonProps {
     reason: ReasonConfig;
@@ -537,10 +704,21 @@ interface FlowState {
     followupResponse: string;
     feedback: string;
     outcome: 'saved' | 'cancelled' | null;
+    /** The offer the customer accepted, set alongside outcome 'saved'. Drives
+     *  per-offer success copy; `null` until then and for cancellations. */
+    acceptedOffer: AcceptedOffer | null;
     isProcessing: boolean;
     error: Error | null;
     customer: DirectCustomer | null;
     subscriptions: DirectSubscription[];
+    /**
+     * Effective cancel timing for this flow: the server-resolved value per
+     * blueprint (token mode), else the developer's `cancelAtPeriodEnd`
+     * declaration (local mode), else `null` — unknown. Drives timing-aware
+     * messages; `null` reads as period-end, matching the default the cancel
+     * action uses.
+     */
+    cancelAtPeriodEnd: boolean | null;
 }
 declare const MODES: readonly ["live", "test", "sandbox"];
 /**
@@ -574,6 +752,22 @@ interface FlowConfig extends FlowCallbacks {
      * this field.
      */
     mode?: Mode;
+    /**
+     * Locale and message overrides for the SDK's own strings (buttons, loading
+     * and confirmation chrome). Flow content — step titles, offer copy — is
+     * authored in the dashboard and localized server-side; override it there or
+     * via `steps`. Read once at mount, like `steps`.
+     */
+    i18n?: I18nConfig;
+    /**
+     * Local-mode declaration of your billing behavior: does cancellation take
+     * effect at the end of the billing period (`true`) or immediately
+     * (`false`)? Drives timing-aware messages and the confirm step's
+     * access-until notice. In token mode this is ignored: the server-resolved
+     * value is authoritative, and if the server omits it the timing is treated
+     * as unknown rather than falling back to this declaration.
+     */
+    cancelAtPeriodEnd?: boolean;
 }
 type OfferCallback = (offer: AcceptedOffer, customer: DirectCustomer | null) => Promise<void> | void;
 type CancelCallback = (customer: DirectCustomer | null) => Promise<void> | void;
@@ -617,6 +811,10 @@ interface CancelFlowProps extends FlowCallbacks {
     apiBaseUrl?: string;
     /** See FlowConfig.mode. Ignored in token mode (the token is authoritative). */
     mode?: Mode;
+    /** See FlowConfig.i18n. */
+    i18n?: I18nConfig;
+    /** See FlowConfig.cancelAtPeriodEnd. Local mode only; the token config wins. */
+    cancelAtPeriodEnd?: boolean;
     appearance?: Appearance;
     classNames?: StructuralClassNames;
     components?: Partial<ComponentOverrides>;
@@ -649,4 +847,4 @@ interface ResolvedStep {
     classNames?: unknown;
 }
 
-export type { SuccessStep as $, AcceptedOffer as A, BackButtonProps as B, CancelFlowProps as C, DirectAddress as D, FlowState as E, FeedbackStepProps as F, Mode as G, OfferClassNames as H, OfferConfig as I, OfferCopy as J, OfferDecision as K, OfferStep as L, ModalProps as M, PlanChangeOffer as N, OfferStepProps as O, PauseOffer as P, PlanOption as Q, ReasonButtonProps as R, SuccessStepProps as S, ReasonConfig as T, RebateOffer as U, RedirectOffer as V, ResolvedStep as W, Step as X, StructuralClassNames as Y, SubscriptionStatus as Z, SuccessClassNames as _, ConfirmStepProps as a, SurveyClassNames as a0, SurveyStep as a1, TrialExtensionOffer as a2, SurveyStepProps as b, CloseButtonProps as c, Appearance as d, AppearanceVariables as e, BuiltInOfferConfig as f, BuiltInStep as g, BuiltInStepType as h, ComponentOverrides as i, ConfirmClassNames as j, ConfirmStep as k, ContactOffer as l, CustomComponents as m, CustomOfferConfig as n, CustomOfferProps as o, CustomStepConfig as p, CustomStepProps as q, DirectCoupon as r, DirectCustomer as s, DirectPrice as t, DirectSubscription as u, DirectSubscriptionItem as v, DiscountOffer as w, FeedbackClassNames as x, FeedbackStep as y, FlowConfig as z };
+export { type Step as $, type AcceptedOffer as A, type BackButtonProps as B, type CancelFlowProps as C, type DirectAddress as D, type FlowConfig as E, type FeedbackStepProps as F, type FlowState as G, type MessagesPatch as H, type I18nConfig as I, type Mode as J, type OfferClassNames as K, type OfferConfig as L, type ModalProps as M, type OfferCopy as N, type OfferStepProps as O, type OfferDecision as P, type OfferStep as Q, type ReasonButtonProps as R, type SuccessStepProps as S, type PauseOffer as T, type PlanChangeOffer as U, type PlanOption as V, type ReasonConfig as W, type RebateOffer as X, type RedirectOffer as Y, type ResolvedStep as Z, type SavedOfferCopy as _, type ConfirmStepProps as a, type StructuralClassNames as a0, type SubscriptionStatus as a1, type SuccessClassNames as a2, type SuccessStep as a3, type SurveyClassNames as a4, type SurveyStep as a5, type TimingAware as a6, type TimingVariants as a7, type TrialExtensionOffer as a8, buildMessages as a9, defaultMessages as aa, formatMessage as ab, selectTiming as ac, type SurveyStepProps as b, type CloseButtonProps as c, type Appearance as d, type AppearanceVariables as e, type BuiltInOfferConfig as f, type BuiltInStep as g, type BuiltInStepType as h, type CancelFlowMessages as i, type ComponentOverrides as j, type ConfirmClassNames as k, type ConfirmStep as l, type ContactOffer as m, type CustomComponents as n, type CustomOfferConfig as o, type CustomOfferProps as p, type CustomStepConfig as q, type CustomStepProps as r, type DirectCoupon as s, type DirectCustomer as t, type DirectPrice as u, type DirectSubscription as v, type DirectSubscriptionItem as w, type DiscountOffer as x, type FeedbackClassNames as y, type FeedbackStep as z };

package/dist/{step-graph-Dee2cFLK.d.ts → step-graph-C7JC8Umv.d.ts}

@@ -1,5 +1,149 @@
 import { ReactNode, ReactElement, ComponentType } from 'react';
 
+/** Both timing variants of a message. Which one renders is decided by the
+ *  flow's effective cancel timing (`FlowState.cancelAtPeriodEnd`). */
+interface TimingVariants {
+    immediate: string;
+    atPeriodEnd: string;
+}
+/**
+ * A message that may differ by cancellation timing. Plain strings render
+ * as-is in both cases; pass the object form when the wording should change
+ * (e.g. "Cancel" vs "Turn off auto-renew").
+ */
+type TimingAware = string | TimingVariants;
+/** Success-screen copy for one accepted offer type. */
+interface SavedOfferCopy {
+    title: string;
+    description: string;
+}
+interface CancelFlowMessages {
+    common: {
+        continue: string;
+        back: string;
+        close: string;
+        done: string;
+        processing: string;
+        tryAgain: string;
+        loading: string;
+        loadError: string;
+        error: string;
+        day: string;
+        days: string;
+        month: string;
+        months: string;
+    };
+    survey: {
+        title: string;
+        followupPlaceholder: string;
+        followupAriaLabel: string;
+    };
+    feedback: {
+        title: string;
+        placeholder: string;
+        /** Used instead of `placeholder` when the step sets `minLength`. Supports `{minLength}`. */
+        placeholderWithMin: string;
+    };
+    confirm: {
+        title: string;
+        lossesLabel: string;
+        cta: TimingAware;
+        goBack: string;
+        /** Shown between the description and the confirm button. Supports
+         *  `{periodEnd}`. The default immediate variant is empty, which
+         *  suppresses the notice for immediate timing; empty OVERRIDE values are
+         *  dropped like any blank override, so to remove the notice entirely
+         *  replace the `Confirm` component or hide it via
+         *  `classNames.periodEndNotice`. */
+        periodEndNotice: TimingAware;
+    };
+    success: {
+        saved: {
+            /** Generic fallback — used for offer types without their own entry
+             *  (contact, redirect, custom types). */
+            title: string;
+            description: string;
+            discount: SavedOfferCopy;
+            pause: SavedOfferCopy & {
+                /** Used instead of `description` when the resume date is known
+                 *  (the built-in pause UI always supplies it). Supports `{resumeDate}`. */
+                resumeDescription: string;
+            };
+            trial_extension: SavedOfferCopy;
+            plan_change: SavedOfferCopy;
+            rebate: SavedOfferCopy;
+        };
+        cancelled: {
+            title: TimingAware;
+            description: TimingAware;
+        };
+    };
+    offer: {
+        limitedTimeEyebrow: string;
+        pauseEyebrow: string;
+        newEndDateLabel: string;
+        currentPlanBadge: string;
+        /** CTA when a plan is selected in a plan-change offer. Supports `{planName}`. */
+        switchToCta: string;
+        /**
+         * Accept-button override per offer type. Defaults are empty: an unset
+         * key falls through to the offer's own `copy.cta` (today a
+         * server-synthesized default like "Accept refund"; authored per-offer
+         * copy, when it exists, keeps winning over an unset key).
+         */
+        acceptCta: {
+            discount: string;
+            pause: string;
+            trial_extension: string;
+            plan_change: string;
+            contact: string;
+            redirect: string;
+            rebate: string;
+        };
+        /** Decline-link override for every offer type. Empty default falls
+         *  through to the offer's own `copy.declineCta`. */
+        declineCta: string;
+        rebate: {
+            paidLabel: string;
+            moneyBackLabel: string;
+            /** Tax parenthetical after the money-back label. Supports `{amount}`. */
+            inclTax: string;
+            netLabel: string;
+        };
+    };
+}
+/**
+ * Recursive partial of the catalog for overrides. Timing-aware fields also
+ * accept a plain string (applies to both timings) or a partial variant pair
+ * (the missing variant keeps the base value).
+ */
+type MessagesPatch<T = CancelFlowMessages> = {
+    [K in keyof T]?: T[K] extends string ? string : T[K] extends TimingAware ? string | Partial<TimingVariants> : MessagesPatch<T[K]>;
+};
+interface I18nConfig {
+    /** UI language. Defaults to the browser language, falling back to `'en'`. */
+    locale?: string;
+    /** Per-locale message overrides, e.g. `{ en: { confirm: { cta: 'Turn off auto-renew' } } }`. */
+    messages?: Record<string, MessagesPatch>;
+}
+declare const defaultMessages: CancelFlowMessages;
+/**
+ * Pick the string for the flow's effective cancel timing. `null` (timing
+ * unknown — local mode) behaves like period-end, matching the default the
+ * cancel action itself uses.
+ */
+declare function selectTiming(value: TimingAware, cancelAtPeriodEnd: boolean | null): string;
+/** Replace `{name}` tokens. Unknown tokens are left in place. */
+declare function formatMessage(template: string, vars: Record<string, string | number>): string;
+/**
+ * Resolve the full catalog for a locale. Layers, lowest to highest: built-in
+ * defaults, then `orgMessages` (dashboard-configured overrides delivered on
+ * the token-mode config), then the config's own per-locale messages — the
+ * developer's overrides always end up on top. Both per-language layers run
+ * through the same locale fallback chain.
+ */
+declare function buildMessages(i18n?: I18nConfig, orgMessages?: Record<string, MessagesPatch>): CancelFlowMessages;
+
 interface DirectAddress {
     line1?: string;
     line2?: string;
@@ -444,10 +588,14 @@ interface ModalProps {
 interface CloseButtonProps {
     onClose: () => void;
     className?: string;
+    /** Accessible label. Defaults to "Close". */
+    label?: string;
 }
 interface BackButtonProps {
     onBack: () => void;
     className?: string;
+    /** Visible label. Defaults to "Back". */
+    label?: string;
 }
 interface SurveyStepProps {
     title: string;
@@ -464,6 +612,8 @@ interface SurveyStepProps {
     onNext: () => void;
     classNames?: SurveyClassNames;
     components?: Partial<ComponentOverrides>;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface OfferStepProps {
     title?: string;
@@ -486,6 +636,8 @@ interface OfferStepProps {
      * implementations can ignore this.
      */
     components?: Partial<ComponentOverrides>;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface FeedbackStepProps {
     title: string;
@@ -499,6 +651,8 @@ interface FeedbackStepProps {
     onChange: (text: string) => void;
     onSubmit: () => void;
     classNames?: FeedbackClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface ConfirmStepProps {
     title: string;
@@ -509,20 +663,33 @@ interface ConfirmStepProps {
     lossesLabel?: string;
     confirmLabel: string;
     goBackLabel: string;
+    /**
+     * Timing-resolved access notice ("Your access continues until June 14, 2026."),
+     * rendered between the loss list and the confirm button. Absent when the
+     * period end is unknown or the resolved message is empty.
+     */
+    periodEndNotice?: string;
     onConfirm: () => Promise<void>;
     onGoBack: () => void;
     isProcessing: boolean;
     classNames?: ConfirmClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface SuccessStepProps {
     outcome: 'saved' | 'cancelled';
     offer?: OfferDecision;
+    /** The accepted offer (consumer-facing shape, incl. any accept result).
+     *  Present when outcome is 'saved'. */
+    acceptedOffer?: AcceptedOffer;
     title: string;
     description?: string;
     customer: DirectCustomer | null;
     subscriptions: DirectSubscription[];
     onClose: () => void;
     classNames?: SuccessClassNames;
+    /** Resolved message catalog. Default components fall back to `defaultMessages` when absent. */
+    messages?: CancelFlowMessages;
 }
 interface ReasonButtonProps {
     reason: ReasonConfig;
@@ -537,10 +704,21 @@ interface FlowState {
     followupResponse: string;
     feedback: string;
     outcome: 'saved' | 'cancelled' | null;
+    /** The offer the customer accepted, set alongside outcome 'saved'. Drives
+     *  per-offer success copy; `null` until then and for cancellations. */
+    acceptedOffer: AcceptedOffer | null;
     isProcessing: boolean;
     error: Error | null;
     customer: DirectCustomer | null;
     subscriptions: DirectSubscription[];
+    /**
+     * Effective cancel timing for this flow: the server-resolved value per
+     * blueprint (token mode), else the developer's `cancelAtPeriodEnd`
+     * declaration (local mode), else `null` — unknown. Drives timing-aware
+     * messages; `null` reads as period-end, matching the default the cancel
+     * action uses.
+     */
+    cancelAtPeriodEnd: boolean | null;
 }
 declare const MODES: readonly ["live", "test", "sandbox"];
 /**
@@ -574,6 +752,22 @@ interface FlowConfig extends FlowCallbacks {
      * this field.
      */
     mode?: Mode;
+    /**
+     * Locale and message overrides for the SDK's own strings (buttons, loading
+     * and confirmation chrome). Flow content — step titles, offer copy — is
+     * authored in the dashboard and localized server-side; override it there or
+     * via `steps`. Read once at mount, like `steps`.
+     */
+    i18n?: I18nConfig;
+    /**
+     * Local-mode declaration of your billing behavior: does cancellation take
+     * effect at the end of the billing period (`true`) or immediately
+     * (`false`)? Drives timing-aware messages and the confirm step's
+     * access-until notice. In token mode this is ignored: the server-resolved
+     * value is authoritative, and if the server omits it the timing is treated
+     * as unknown rather than falling back to this declaration.
+     */
+    cancelAtPeriodEnd?: boolean;
 }
 type OfferCallback = (offer: AcceptedOffer, customer: DirectCustomer | null) => Promise<void> | void;
 type CancelCallback = (customer: DirectCustomer | null) => Promise<void> | void;
@@ -617,6 +811,10 @@ interface CancelFlowProps extends FlowCallbacks {
     apiBaseUrl?: string;
     /** See FlowConfig.mode. Ignored in token mode (the token is authoritative). */
     mode?: Mode;
+    /** See FlowConfig.i18n. */
+    i18n?: I18nConfig;
+    /** See FlowConfig.cancelAtPeriodEnd. Local mode only; the token config wins. */
+    cancelAtPeriodEnd?: boolean;
     appearance?: Appearance;
     classNames?: StructuralClassNames;
     components?: Partial<ComponentOverrides>;
@@ -649,4 +847,4 @@ interface ResolvedStep {
     classNames?: unknown;
 }
 
-export type { SuccessStep as $, AcceptedOffer as A, BackButtonProps as B, CancelFlowProps as C, DirectAddress as D, FlowState as E, FeedbackStepProps as F, Mode as G, OfferClassNames as H, OfferConfig as I, OfferCopy as J, OfferDecision as K, OfferStep as L, ModalProps as M, PlanChangeOffer as N, OfferStepProps as O, PauseOffer as P, PlanOption as Q, ReasonButtonProps as R, SuccessStepProps as S, ReasonConfig as T, RebateOffer as U, RedirectOffer as V, ResolvedStep as W, Step as X, StructuralClassNames as Y, SubscriptionStatus as Z, SuccessClassNames as _, ConfirmStepProps as a, SurveyClassNames as a0, SurveyStep as a1, TrialExtensionOffer as a2, SurveyStepProps as b, CloseButtonProps as c, Appearance as d, AppearanceVariables as e, BuiltInOfferConfig as f, BuiltInStep as g, BuiltInStepType as h, ComponentOverrides as i, ConfirmClassNames as j, ConfirmStep as k, ContactOffer as l, CustomComponents as m, CustomOfferConfig as n, CustomOfferProps as o, CustomStepConfig as p, CustomStepProps as q, DirectCoupon as r, DirectCustomer as s, DirectPrice as t, DirectSubscription as u, DirectSubscriptionItem as v, DiscountOffer as w, FeedbackClassNames as x, FeedbackStep as y, FlowConfig as z };
+export { type Step as $, type AcceptedOffer as A, type BackButtonProps as B, type CancelFlowProps as C, type DirectAddress as D, type FlowConfig as E, type FeedbackStepProps as F, type FlowState as G, type MessagesPatch as H, type I18nConfig as I, type Mode as J, type OfferClassNames as K, type OfferConfig as L, type ModalProps as M, type OfferCopy as N, type OfferStepProps as O, type OfferDecision as P, type OfferStep as Q, type ReasonButtonProps as R, type SuccessStepProps as S, type PauseOffer as T, type PlanChangeOffer as U, type PlanOption as V, type ReasonConfig as W, type RebateOffer as X, type RedirectOffer as Y, type ResolvedStep as Z, type SavedOfferCopy as _, type ConfirmStepProps as a, type StructuralClassNames as a0, type SubscriptionStatus as a1, type SuccessClassNames as a2, type SuccessStep as a3, type SurveyClassNames as a4, type SurveyStep as a5, type TimingAware as a6, type TimingVariants as a7, type TrialExtensionOffer as a8, buildMessages as a9, defaultMessages as aa, formatMessage as ab, selectTiming as ac, type SurveyStepProps as b, type CloseButtonProps as c, type Appearance as d, type AppearanceVariables as e, type BuiltInOfferConfig as f, type BuiltInStep as g, type BuiltInStepType as h, type CancelFlowMessages as i, type ComponentOverrides as j, type ConfirmClassNames as k, type ConfirmStep as l, type ContactOffer as m, type CustomComponents as n, type CustomOfferConfig as o, type CustomOfferProps as p, type CustomStepConfig as q, type CustomStepProps as r, type DirectCoupon as s, type DirectCustomer as t, type DirectPrice as u, type DirectSubscription as v, type DirectSubscriptionItem as w, type DiscountOffer as x, type FeedbackClassNames as y, type FeedbackStep as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@churnkey/react",
-  "version": "0.6.5",
+  "version": "0.7.1",
   "description": "Production-ready cancel flow for React. Drop-in component, headless hook, or full customization. Works standalone or with Churnkey for AI-powered retention.",
   "license": "MIT",
   "repository": {

package/dist/chunk-EYIGZLVT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/format.ts"],"names":[],"mappings":"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","file":"chunk-EYIGZLVT.js","sourcesContent":["import type { DirectSubscription } from './types'\n\n// Currencies whose smallest unit equals one major unit (no fractional part).\n// Stripe and most billing providers store these without an implicit /100.\nconst ZERO_DECIMAL_CURRENCIES: ReadonlySet<string> = new Set([\n  'BIF',\n  'CLP',\n  'DJF',\n  'GNF',\n  'JPY',\n  'KMF',\n  'KRW',\n  'MGA',\n  'PYG',\n  'RWF',\n  'UGX',\n  'VND',\n  'VUV',\n  'XAF',\n  'XOF',\n  'XPF',\n])\n\n// Middle-Eastern currencies that use three fractional digits (1000 divisor).\n// Without this bucket, JOD/KWD amounts would be off by 10x in display.\nconst THREE_DECIMAL_CURRENCIES: ReadonlySet<string> = new Set(['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND'])\n\nexport function isZeroDecimalCurrency(currency: string): boolean {\n  return ZERO_DECIMAL_CURRENCIES.has(currency.toUpperCase())\n}\n\nexport function isThreeDecimalCurrency(currency: string): boolean {\n  return THREE_DECIMAL_CURRENCIES.has(currency.toUpperCase())\n}\n\n/**\n * Smallest-unit divisor for a currency. 1 for zero-decimal (JPY), 1000 for\n * three-decimal (KWD), 100 for everything else. Used to convert provider\n * amounts (which are always in the smallest unit) into the major unit for\n * display.\n */\nexport function getCurrencyDivisor(currency = 'USD'): number {\n  if (isZeroDecimalCurrency(currency)) return 1\n  if (isThreeDecimalCurrency(currency)) return 1000\n  return 100\n}\n\n/**\n * Converts a Direct.Price.amount.value (smallest currency unit) into the\n * major unit used for display.\n */\nexport function convertFromMinorUnits(value: number, currency = 'USD'): number {\n  return value / getCurrencyDivisor(currency)\n}\n\n/**\n * Format an amount already in the major unit. Uses `narrowSymbol` so output\n * reads \"$29\" rather than \"US$29\", and trims trailing zero fractions so\n * whole amounts render compactly.\n */\nexport function formatPrice(amount: number, currency = 'USD', locale?: string): string {\n  try {\n    const formatted = new Intl.NumberFormat(locale, {\n      style: 'currency',\n      currency,\n      currencyDisplay: 'narrowSymbol',\n    }).format(amount)\n    return formatted.replace(/[.,]00$/, '')\n  } catch {\n    return `${currency} ${amount.toFixed(2)}`\n  }\n}\n\n/** Convenience: format a Direct-shape minor-unit amount in one call. */\nexport function formatPriceFromMinor(value: number, currency = 'USD', locale?: string): string {\n  return formatPrice(convertFromMinorUnits(value, currency), currency, locale)\n}\n\nexport function calculateDiscountedPrice(originalPrice: number, percentOff: number): number {\n  return originalPrice * (1 - percentOff / 100)\n}\n\n// ─── Dates ────────────────────────────────────────────────────────────────\n\n/** \"Apr 30, 2026\" — used for resume dates and other full-date contexts. */\nexport function formatShortDate(date: Date, locale?: string): string {\n  return date.toLocaleDateString(locale, { month: 'short', day: 'numeric', year: 'numeric' })\n}\n\n/** \"Apr 30\" — used when the year is implied by context. */\nexport function formatMonthDay(date: Date, locale?: string): string {\n  return date.toLocaleDateString(locale, { month: 'short', day: 'numeric' })\n}\n\n/** \"April 30\" — long month form for prominent date displays. */\nexport function formatMonthDayLong(date: Date, locale?: string): string {\n  return date.toLocaleDateString(locale, { month: 'long', day: 'numeric' })\n}\n\n/**\n * Long-form access period end (\"June 14, 2026\") for the first subscription's\n * current period. Returns null for canceled subscriptions, missing periods,\n * and unparseable dates so Confirm can drop the \"access continues until\"\n * notice cleanly instead of rendering \"Invalid Date\".\n */\nexport function formatPeriodEnd(\n  subscriptions: DirectSubscription[] | null | undefined,\n  locale?: string,\n): string | null {\n  const status = subscriptions?.[0]?.status\n  if (!status || !('currentPeriod' in status) || !status.currentPeriod?.end) return null\n  const end = status.currentPeriod.end\n  const d = end instanceof Date ? end : new Date(end)\n  if (Number.isNaN(d.getTime())) return null\n  return d.toLocaleDateString(locale, { month: 'long', day: 'numeric', year: 'numeric' })\n}\n\n// ─── Discount phrasing ─────────────────────────────────────────────────────\n\n/**\n * Renders the discount as a single human-readable sentence:\n *   \"25% off for 3 months\" / \"$5 off your next renewal\" / \"20% off for life\"\n *\n * Mirrors the embed's couponToString helper so SDK and embed use the same\n * phrasing for the same offer shape.\n */\nexport function discountPhrase(opts: {\n  percentOff?: number\n  /** Smallest currency unit (cents for USD). */\n  amountOff?: number\n  currency?: string\n  duration?: 'once' | 'repeating' | 'forever'\n  durationInMonths?: number\n}): string {\n  const { percentOff, amountOff, currency, duration, durationInMonths } = opts\n  const amount =\n    percentOff != null\n      ? `${percentOff}% off`\n      : amountOff != null\n        ? `${formatPriceFromMinor(amountOff, currency)} off`\n        : 'discount'\n  const tail =\n    duration === 'once'\n      ? 'your next renewal'\n      : duration === 'forever'\n        ? 'for life'\n        : durationInMonths\n          ? `for ${durationInMonths} ${durationInMonths === 1 ? 'month' : 'months'}`\n          : ''\n  return tail ? `${amount} ${tail}` : amount\n}\n"]}