@churnkey/react 0.6.0 → 0.6.1

package/dist/core.d.cts

@@ -0,0 +1,324 @@
+import { Q as PlanOption, s as DirectCustomer, u as DirectSubscription, G as Mode, z as FlowConfig, E as FlowState, T as ReasonConfig, W as ResolvedStep, K as OfferDecision, d as Appearance } from './step-graph-DX8yCqq1.cjs';
+export { A as AcceptedOffer, e as AppearanceVariables, B as BackButtonProps, f as BuiltInOfferConfig, g as BuiltInStep, h as BuiltInStepType, C as CancelFlowProps, c as CloseButtonProps, i as ComponentOverrides, j as ConfirmClassNames, k as ConfirmStep, a as ConfirmStepProps, l as ContactOffer, m as CustomComponents, n as CustomOfferConfig, o as CustomOfferProps, p as CustomStepConfig, q as CustomStepProps, D as DirectAddress, r as DirectCoupon, t as DirectPrice, v as DirectSubscriptionItem, w as DiscountOffer, x as FeedbackClassNames, y as FeedbackStep, F as FeedbackStepProps, M as ModalProps, H as OfferClassNames, I as OfferConfig, J as OfferCopy, L as OfferStep, O as OfferStepProps, P as PauseOffer, N as PlanChangeOffer, R as ReasonButtonProps, U as RebateOffer, V as RedirectOffer, X as Step, Y as StructuralClassNames, Z as SubscriptionStatus, _ as SuccessClassNames, $ as SuccessStep, S as SuccessStepProps, a0 as SurveyClassNames, a1 as SurveyStep, b as SurveyStepProps, a2 as TrialExtensionOffer } from './step-graph-DX8yCqq1.cjs';
+import { CSSProperties } from 'react';
+
+interface SdkConfig {
+    blueprintId: string;
+    steps: SdkStep[];
+    customer: DirectCustomer;
+    subscriptions: DirectSubscription[];
+    settings: SdkSettings;
+    /** Bandit key used for auto-optimization, if it ran. */
+    autoOptimizationKey?: string;
+}
+interface SdkSettings {
+    clickToCancelEnabled: boolean;
+    strictFTCComplianceEnabled: boolean;
+    discountCooldown?: number;
+    pauseCooldown?: number;
+}
+type SdkStep = SdkSurveyStep | SdkOfferStep | SdkFeedbackStep | SdkConfirmStep;
+interface SdkStepBase {
+    guid: string;
+    title?: string;
+    description?: string;
+}
+interface SdkSurveyStep extends SdkStepBase {
+    type: 'survey';
+    reasons: SdkReason[];
+}
+interface SdkOfferStep extends SdkStepBase {
+    type: 'offer';
+    offer: SdkOffer;
+}
+interface SdkFeedbackStep extends SdkStepBase {
+    type: 'feedback';
+    placeholder?: string;
+    required?: boolean;
+    minLength?: number;
+}
+interface SdkConfirmStep extends SdkStepBase {
+    type: 'confirm';
+}
+interface SdkReason {
+    id: string;
+    label: string;
+    freeform?: boolean;
+    offer?: SdkOffer;
+}
+type SdkOffer = SdkDiscountOffer | SdkPauseOffer | SdkPlanChangeOffer | SdkTrialExtensionOffer | SdkRedirectOffer | SdkContactOffer | SdkRebateOffer;
+interface SdkOfferBase {
+    /** Per-offer guid — used for analytics joins between presented and accepted offers. */
+    decisionId?: string;
+    copy: SdkOfferCopy;
+}
+interface SdkDiscountOffer extends SdkOfferBase {
+    type: 'discount';
+    couponId?: string;
+    percentOff?: number;
+    /** Smallest currency unit (cents for USD, etc.). */
+    amountOff?: number;
+    currency?: string;
+    durationInMonths?: number;
+}
+interface SdkPauseOffer extends SdkOfferBase {
+    type: 'pause';
+    months: number;
+    interval: 'month' | 'week';
+    datePicker?: boolean;
+}
+interface SdkPlanChangeOffer extends SdkOfferBase {
+    type: 'plan_change';
+    plans: PlanOption[];
+}
+interface SdkTrialExtensionOffer extends SdkOfferBase {
+    type: 'trial_extension';
+    days: number;
+}
+interface SdkRedirectOffer extends SdkOfferBase {
+    type: 'redirect';
+    url: string;
+    label?: string;
+}
+interface SdkContactOffer extends SdkOfferBase {
+    type: 'contact';
+    url?: string;
+    label?: string;
+}
+interface SdkRebateOffer extends SdkOfferBase {
+    type: 'rebate';
+    /** The rebate amount (pre-tax). The card is refunded this plus any tax charged on it. */
+    amountMinor: number;
+    currency: string;
+    /** Gross amount paid on the target invoice — the "you paid" row. */
+    amountPaidMinor: number;
+    /** amountPaidMinor minus the full refund (rebate plus its tax) — the "your net" row. */
+    netAfterRebateMinor: number;
+    paymentMethodBrand?: string;
+    paymentMethodLast4?: string;
+}
+interface SdkOfferCopy {
+    headline: string;
+    body: string;
+    cta: string;
+    declineCta: string;
+}
+
+interface SessionCredentials {
+    appId: string;
+    customerId: string;
+    subscriptionId?: string;
+    authHash: string;
+    mode: Mode;
+    issuedAt: number;
+}
+/** Decode a session token created by `@churnkey/node`. */
+declare function decodeSessionToken(token: string): SessionCredentials;
+
+type ApiStepType = 'OFFER' | 'SURVEY' | 'CONFIRM' | 'FREEFORM' | 'CUSTOM';
+type ApiOfferType = 'DISCOUNT' | 'PAUSE' | 'PLAN_CHANGE' | 'TRIAL_EXTENSION' | 'CONTACT' | 'REDIRECT' | 'REBATE' | 'CUSTOM';
+type ApiPauseInterval = 'MONTH' | 'WEEK';
+type ApiCouponType = 'PERCENT' | 'AMOUNT';
+type ApiBillingInterval = 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';
+type ApiMode = 'LIVE' | 'TEST' | 'SANDBOX';
+interface StepViewed {
+    stepType: ApiStepType;
+    customStepType?: string;
+    guid?: string;
+    numChoices?: number;
+    start: string;
+    end?: string;
+    duration?: number;
+}
+interface PresentedOffer {
+    guid?: string;
+    offerType?: ApiOfferType;
+    customOfferType?: string;
+    accepted: boolean;
+    presentedAt: string;
+    acceptedAt?: string;
+    declinedAt?: string;
+    [key: string]: unknown;
+}
+interface AcceptedOfferPayload {
+    guid?: string;
+    offerType: ApiOfferType;
+    customOfferType?: string;
+    customOfferResult?: Record<string, unknown>;
+    couponId?: string;
+    couponType?: ApiCouponType;
+    couponAmount?: number;
+    couponDuration?: number;
+    pauseDuration?: number;
+    pauseInterval?: ApiPauseInterval;
+    newPlanId?: string;
+    newPlanPrice?: number;
+    trialExtensionDays?: number;
+    redirectUrl?: string;
+    rebateAmount?: number;
+}
+interface SessionCustomer {
+    id: string;
+    email?: string;
+    subscriptionId?: string;
+    planId?: string;
+    planPrice?: number;
+    currency?: string;
+    billingInterval?: ApiBillingInterval;
+    created?: string;
+    onTrial?: boolean;
+    customAttributes?: Record<string, unknown>;
+}
+interface SessionPayload {
+    blueprintId?: string;
+    surveyId?: string;
+    customer?: SessionCustomer;
+    canceled?: boolean;
+    aborted?: boolean;
+    surveyChoiceId?: string;
+    surveyChoiceValue?: string;
+    /** Free-text from a `freeform: true` reason. The reason's static `label` still travels on `surveyChoiceValue`. */
+    followupResponse?: string;
+    feedback?: string;
+    acceptedOffer?: AcceptedOfferPayload;
+    presentedOffers?: PresentedOffer[];
+    stepsViewed?: StepViewed[];
+    customStepResults?: Record<string, unknown>;
+    mode: ApiMode;
+    provider?: string;
+    embedVersion?: string;
+    clickToCancelEnabled?: boolean;
+    strictFTCComplianceEnabled?: boolean;
+    usedClickToCancel?: boolean;
+    autoOptimizationUsed?: boolean;
+    autoOptimizationKey?: string;
+    discountCooldown?: number;
+    pauseCooldown?: number;
+    discountCooldownApplied?: boolean;
+    pauseCooldownApplied?: boolean;
+}
+declare class ChurnkeyApi {
+    private creds;
+    private baseUrl;
+    constructor(creds: SessionCredentials, baseUrl?: string);
+    private get headers();
+    private orgUrl;
+    private request;
+    fetchConfig(customAttributes?: Record<string, unknown>): Promise<SdkConfig>;
+    applyDiscount(couponId: string, blueprintId?: string): Promise<void>;
+    pause(params: {
+        duration: number;
+        interval: string;
+    }): Promise<void>;
+    cancelSubscription(): Promise<void>;
+    changePlan(planId: string): Promise<void>;
+    extendTrial(days: number, blueprintId?: string): Promise<void>;
+    applyRebate(blueprintId?: string, offerGuid?: string): Promise<void>;
+    createSession(payload: SessionPayload): Promise<void>;
+}
+declare class AnalyticsClient {
+    private appId;
+    private baseUrl;
+    constructor(appId: string, baseUrl?: string);
+    createSession(payload: SessionPayload): Promise<void>;
+}
+
+/**
+ * Format an amount already in the major unit. Uses `narrowSymbol` so output
+ * reads "$29" rather than "US$29", and trims trailing zero fractions so
+ * whole amounts render compactly.
+ */
+declare function formatPrice(amount: number, currency?: string, locale?: string): string;
+declare function calculateDiscountedPrice(originalPrice: number, percentOff: number): number;
+/**
+ * Long-form access period end ("June 14, 2026") for the first subscription's
+ * current period. Returns null for canceled subscriptions, missing periods,
+ * and unparseable dates so Confirm can drop the "access continues until"
+ * notice cleanly instead of rendering "Invalid Date".
+ */
+declare function formatPeriodEnd(subscriptions: DirectSubscription[] | null | undefined, locale?: string): string | null;
+
+declare class CancelFlowMachine {
+    private state;
+    private cachedSnapshot;
+    private callbacks;
+    private graph;
+    private listeners;
+    private apiClient;
+    private analyticsClient;
+    private directCustomer;
+    private directSubscriptions;
+    private customerAttributes;
+    private creds;
+    private config;
+    private blueprintId;
+    private localSteps;
+    private stepsViewed;
+    private presentedOffers;
+    private customStepResults;
+    private configMode;
+    private stepEnteredAt;
+    private aborted;
+    private history;
+    constructor(config: FlowConfig);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => FlowState;
+    get reasons(): ReasonConfig[];
+    get currentStep(): ResolvedStep | undefined;
+    /** The offer on the current step, or null. Always derived — no separate slot to drift. */
+    get currentOffer(): OfferDecision | null;
+    /** Whether `back()` would move anywhere — false on the first step and on success. */
+    get canGoBack(): boolean;
+    /**
+     * First step of a given type. Fine for the common "one step per type" case;
+     * flows with multiple of a type should key on currentStepId instead.
+     */
+    getStepConfig(stepType: string): ResolvedStep | undefined;
+    /** Progress indicator index. Synthetic offers share their survey's slot. */
+    get stepIndex(): number;
+    get totalSteps(): number;
+    selectReason: (id: string) => void;
+    setFollowupResponse: (text: string) => void;
+    next: (result?: Record<string, unknown>) => void;
+    back: () => void;
+    accept: (result?: Record<string, unknown>) => Promise<void>;
+    decline: () => void;
+    setFeedback: (text: string) => void;
+    cancel: () => Promise<void>;
+    close: () => void;
+    destroy(): void;
+    initializeFromConfig(config: SdkConfig, apiClient: ChurnkeyApi, creds: SessionCredentials): void;
+    private isTokenMode;
+    private firstStep;
+    private surveyStep;
+    private buildInitialState;
+    private projectedNextStepId;
+    private transitionTo;
+    private setState;
+    private trackStepEnter;
+    private recordOfferPresented;
+    private markCurrentOfferAccepted;
+    private markCurrentOfferDeclined;
+    private notify;
+    private executeTokenAction;
+    private trackStepView;
+    private finalizeStepView;
+    private buildAcceptedOffer;
+    private enterSuccessStep;
+    private resolveSessionCustomer;
+    private buildBasePayload;
+    private recordAbort;
+    private recordOutcome;
+}
+
+declare const BUILT_IN_STEP_TYPES: readonly string[];
+declare const BUILT_IN_OFFER_TYPES: readonly string[];
+declare function cn(...classes: (string | undefined | null | false)[]): string;
+declare function appearanceToStyle(appearance?: Appearance): CSSProperties | undefined;
+declare const defaultTitles: {
+    readonly survey: "Why are you cancelling?";
+    readonly feedback: "Any other feedback?";
+    readonly confirm: "Confirm cancellation";
+};
+
+export { AnalyticsClient, Appearance, BUILT_IN_OFFER_TYPES, BUILT_IN_STEP_TYPES, CancelFlowMachine, ChurnkeyApi, DirectCustomer, DirectSubscription, FlowConfig, FlowState, Mode, OfferDecision, PlanOption, ReasonConfig, ResolvedStep, type SdkConfig, type SdkConfirmStep, type SdkFeedbackStep, type SdkOffer, type SdkOfferCopy, type SdkOfferStep, type SdkReason, type SdkSettings, type SdkStep, type SdkSurveyStep, type SessionCredentials, type SessionPayload, appearanceToStyle, calculateDiscountedPrice, cn, decodeSessionToken, defaultTitles, formatPeriodEnd, formatPrice };

package/dist/core.d.ts

@@ -0,0 +1,324 @@
+import { Q as PlanOption, s as DirectCustomer, u as DirectSubscription, G as Mode, z as FlowConfig, E as FlowState, T as ReasonConfig, W as ResolvedStep, K as OfferDecision, d as Appearance } from './step-graph-DX8yCqq1.js';
+export { A as AcceptedOffer, e as AppearanceVariables, B as BackButtonProps, f as BuiltInOfferConfig, g as BuiltInStep, h as BuiltInStepType, C as CancelFlowProps, c as CloseButtonProps, i as ComponentOverrides, j as ConfirmClassNames, k as ConfirmStep, a as ConfirmStepProps, l as ContactOffer, m as CustomComponents, n as CustomOfferConfig, o as CustomOfferProps, p as CustomStepConfig, q as CustomStepProps, D as DirectAddress, r as DirectCoupon, t as DirectPrice, v as DirectSubscriptionItem, w as DiscountOffer, x as FeedbackClassNames, y as FeedbackStep, F as FeedbackStepProps, M as ModalProps, H as OfferClassNames, I as OfferConfig, J as OfferCopy, L as OfferStep, O as OfferStepProps, P as PauseOffer, N as PlanChangeOffer, R as ReasonButtonProps, U as RebateOffer, V as RedirectOffer, X as Step, Y as StructuralClassNames, Z as SubscriptionStatus, _ as SuccessClassNames, $ as SuccessStep, S as SuccessStepProps, a0 as SurveyClassNames, a1 as SurveyStep, b as SurveyStepProps, a2 as TrialExtensionOffer } from './step-graph-DX8yCqq1.js';
+import { CSSProperties } from 'react';
+
+interface SdkConfig {
+    blueprintId: string;
+    steps: SdkStep[];
+    customer: DirectCustomer;
+    subscriptions: DirectSubscription[];
+    settings: SdkSettings;
+    /** Bandit key used for auto-optimization, if it ran. */
+    autoOptimizationKey?: string;
+}
+interface SdkSettings {
+    clickToCancelEnabled: boolean;
+    strictFTCComplianceEnabled: boolean;
+    discountCooldown?: number;
+    pauseCooldown?: number;
+}
+type SdkStep = SdkSurveyStep | SdkOfferStep | SdkFeedbackStep | SdkConfirmStep;
+interface SdkStepBase {
+    guid: string;
+    title?: string;
+    description?: string;
+}
+interface SdkSurveyStep extends SdkStepBase {
+    type: 'survey';
+    reasons: SdkReason[];
+}
+interface SdkOfferStep extends SdkStepBase {
+    type: 'offer';
+    offer: SdkOffer;
+}
+interface SdkFeedbackStep extends SdkStepBase {
+    type: 'feedback';
+    placeholder?: string;
+    required?: boolean;
+    minLength?: number;
+}
+interface SdkConfirmStep extends SdkStepBase {
+    type: 'confirm';
+}
+interface SdkReason {
+    id: string;
+    label: string;
+    freeform?: boolean;
+    offer?: SdkOffer;
+}
+type SdkOffer = SdkDiscountOffer | SdkPauseOffer | SdkPlanChangeOffer | SdkTrialExtensionOffer | SdkRedirectOffer | SdkContactOffer | SdkRebateOffer;
+interface SdkOfferBase {
+    /** Per-offer guid — used for analytics joins between presented and accepted offers. */
+    decisionId?: string;
+    copy: SdkOfferCopy;
+}
+interface SdkDiscountOffer extends SdkOfferBase {
+    type: 'discount';
+    couponId?: string;
+    percentOff?: number;
+    /** Smallest currency unit (cents for USD, etc.). */
+    amountOff?: number;
+    currency?: string;
+    durationInMonths?: number;
+}
+interface SdkPauseOffer extends SdkOfferBase {
+    type: 'pause';
+    months: number;
+    interval: 'month' | 'week';
+    datePicker?: boolean;
+}
+interface SdkPlanChangeOffer extends SdkOfferBase {
+    type: 'plan_change';
+    plans: PlanOption[];
+}
+interface SdkTrialExtensionOffer extends SdkOfferBase {
+    type: 'trial_extension';
+    days: number;
+}
+interface SdkRedirectOffer extends SdkOfferBase {
+    type: 'redirect';
+    url: string;
+    label?: string;
+}
+interface SdkContactOffer extends SdkOfferBase {
+    type: 'contact';
+    url?: string;
+    label?: string;
+}
+interface SdkRebateOffer extends SdkOfferBase {
+    type: 'rebate';
+    /** The rebate amount (pre-tax). The card is refunded this plus any tax charged on it. */
+    amountMinor: number;
+    currency: string;
+    /** Gross amount paid on the target invoice — the "you paid" row. */
+    amountPaidMinor: number;
+    /** amountPaidMinor minus the full refund (rebate plus its tax) — the "your net" row. */
+    netAfterRebateMinor: number;
+    paymentMethodBrand?: string;
+    paymentMethodLast4?: string;
+}
+interface SdkOfferCopy {
+    headline: string;
+    body: string;
+    cta: string;
+    declineCta: string;
+}
+
+interface SessionCredentials {
+    appId: string;
+    customerId: string;
+    subscriptionId?: string;
+    authHash: string;
+    mode: Mode;
+    issuedAt: number;
+}
+/** Decode a session token created by `@churnkey/node`. */
+declare function decodeSessionToken(token: string): SessionCredentials;
+
+type ApiStepType = 'OFFER' | 'SURVEY' | 'CONFIRM' | 'FREEFORM' | 'CUSTOM';
+type ApiOfferType = 'DISCOUNT' | 'PAUSE' | 'PLAN_CHANGE' | 'TRIAL_EXTENSION' | 'CONTACT' | 'REDIRECT' | 'REBATE' | 'CUSTOM';
+type ApiPauseInterval = 'MONTH' | 'WEEK';
+type ApiCouponType = 'PERCENT' | 'AMOUNT';
+type ApiBillingInterval = 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';
+type ApiMode = 'LIVE' | 'TEST' | 'SANDBOX';
+interface StepViewed {
+    stepType: ApiStepType;
+    customStepType?: string;
+    guid?: string;
+    numChoices?: number;
+    start: string;
+    end?: string;
+    duration?: number;
+}
+interface PresentedOffer {
+    guid?: string;
+    offerType?: ApiOfferType;
+    customOfferType?: string;
+    accepted: boolean;
+    presentedAt: string;
+    acceptedAt?: string;
+    declinedAt?: string;
+    [key: string]: unknown;
+}
+interface AcceptedOfferPayload {
+    guid?: string;
+    offerType: ApiOfferType;
+    customOfferType?: string;
+    customOfferResult?: Record<string, unknown>;
+    couponId?: string;
+    couponType?: ApiCouponType;
+    couponAmount?: number;
+    couponDuration?: number;
+    pauseDuration?: number;
+    pauseInterval?: ApiPauseInterval;
+    newPlanId?: string;
+    newPlanPrice?: number;
+    trialExtensionDays?: number;
+    redirectUrl?: string;
+    rebateAmount?: number;
+}
+interface SessionCustomer {
+    id: string;
+    email?: string;
+    subscriptionId?: string;
+    planId?: string;
+    planPrice?: number;
+    currency?: string;
+    billingInterval?: ApiBillingInterval;
+    created?: string;
+    onTrial?: boolean;
+    customAttributes?: Record<string, unknown>;
+}
+interface SessionPayload {
+    blueprintId?: string;
+    surveyId?: string;
+    customer?: SessionCustomer;
+    canceled?: boolean;
+    aborted?: boolean;
+    surveyChoiceId?: string;
+    surveyChoiceValue?: string;
+    /** Free-text from a `freeform: true` reason. The reason's static `label` still travels on `surveyChoiceValue`. */
+    followupResponse?: string;
+    feedback?: string;
+    acceptedOffer?: AcceptedOfferPayload;
+    presentedOffers?: PresentedOffer[];
+    stepsViewed?: StepViewed[];
+    customStepResults?: Record<string, unknown>;
+    mode: ApiMode;
+    provider?: string;
+    embedVersion?: string;
+    clickToCancelEnabled?: boolean;
+    strictFTCComplianceEnabled?: boolean;
+    usedClickToCancel?: boolean;
+    autoOptimizationUsed?: boolean;
+    autoOptimizationKey?: string;
+    discountCooldown?: number;
+    pauseCooldown?: number;
+    discountCooldownApplied?: boolean;
+    pauseCooldownApplied?: boolean;
+}
+declare class ChurnkeyApi {
+    private creds;
+    private baseUrl;
+    constructor(creds: SessionCredentials, baseUrl?: string);
+    private get headers();
+    private orgUrl;
+    private request;
+    fetchConfig(customAttributes?: Record<string, unknown>): Promise<SdkConfig>;
+    applyDiscount(couponId: string, blueprintId?: string): Promise<void>;
+    pause(params: {
+        duration: number;
+        interval: string;
+    }): Promise<void>;
+    cancelSubscription(): Promise<void>;
+    changePlan(planId: string): Promise<void>;
+    extendTrial(days: number, blueprintId?: string): Promise<void>;
+    applyRebate(blueprintId?: string, offerGuid?: string): Promise<void>;
+    createSession(payload: SessionPayload): Promise<void>;
+}
+declare class AnalyticsClient {
+    private appId;
+    private baseUrl;
+    constructor(appId: string, baseUrl?: string);
+    createSession(payload: SessionPayload): Promise<void>;
+}
+
+/**
+ * Format an amount already in the major unit. Uses `narrowSymbol` so output
+ * reads "$29" rather than "US$29", and trims trailing zero fractions so
+ * whole amounts render compactly.
+ */
+declare function formatPrice(amount: number, currency?: string, locale?: string): string;
+declare function calculateDiscountedPrice(originalPrice: number, percentOff: number): number;
+/**
+ * Long-form access period end ("June 14, 2026") for the first subscription's
+ * current period. Returns null for canceled subscriptions, missing periods,
+ * and unparseable dates so Confirm can drop the "access continues until"
+ * notice cleanly instead of rendering "Invalid Date".
+ */
+declare function formatPeriodEnd(subscriptions: DirectSubscription[] | null | undefined, locale?: string): string | null;
+
+declare class CancelFlowMachine {
+    private state;
+    private cachedSnapshot;
+    private callbacks;
+    private graph;
+    private listeners;
+    private apiClient;
+    private analyticsClient;
+    private directCustomer;
+    private directSubscriptions;
+    private customerAttributes;
+    private creds;
+    private config;
+    private blueprintId;
+    private localSteps;
+    private stepsViewed;
+    private presentedOffers;
+    private customStepResults;
+    private configMode;
+    private stepEnteredAt;
+    private aborted;
+    private history;
+    constructor(config: FlowConfig);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => FlowState;
+    get reasons(): ReasonConfig[];
+    get currentStep(): ResolvedStep | undefined;
+    /** The offer on the current step, or null. Always derived — no separate slot to drift. */
+    get currentOffer(): OfferDecision | null;
+    /** Whether `back()` would move anywhere — false on the first step and on success. */
+    get canGoBack(): boolean;
+    /**
+     * First step of a given type. Fine for the common "one step per type" case;
+     * flows with multiple of a type should key on currentStepId instead.
+     */
+    getStepConfig(stepType: string): ResolvedStep | undefined;
+    /** Progress indicator index. Synthetic offers share their survey's slot. */
+    get stepIndex(): number;
+    get totalSteps(): number;
+    selectReason: (id: string) => void;
+    setFollowupResponse: (text: string) => void;
+    next: (result?: Record<string, unknown>) => void;
+    back: () => void;
+    accept: (result?: Record<string, unknown>) => Promise<void>;
+    decline: () => void;
+    setFeedback: (text: string) => void;
+    cancel: () => Promise<void>;
+    close: () => void;
+    destroy(): void;
+    initializeFromConfig(config: SdkConfig, apiClient: ChurnkeyApi, creds: SessionCredentials): void;
+    private isTokenMode;
+    private firstStep;
+    private surveyStep;
+    private buildInitialState;
+    private projectedNextStepId;
+    private transitionTo;
+    private setState;
+    private trackStepEnter;
+    private recordOfferPresented;
+    private markCurrentOfferAccepted;
+    private markCurrentOfferDeclined;
+    private notify;
+    private executeTokenAction;
+    private trackStepView;
+    private finalizeStepView;
+    private buildAcceptedOffer;
+    private enterSuccessStep;
+    private resolveSessionCustomer;
+    private buildBasePayload;
+    private recordAbort;
+    private recordOutcome;
+}
+
+declare const BUILT_IN_STEP_TYPES: readonly string[];
+declare const BUILT_IN_OFFER_TYPES: readonly string[];
+declare function cn(...classes: (string | undefined | null | false)[]): string;
+declare function appearanceToStyle(appearance?: Appearance): CSSProperties | undefined;
+declare const defaultTitles: {
+    readonly survey: "Why are you cancelling?";
+    readonly feedback: "Any other feedback?";
+    readonly confirm: "Confirm cancellation";
+};
+
+export { AnalyticsClient, Appearance, BUILT_IN_OFFER_TYPES, BUILT_IN_STEP_TYPES, CancelFlowMachine, ChurnkeyApi, DirectCustomer, DirectSubscription, FlowConfig, FlowState, Mode, OfferDecision, PlanOption, ReasonConfig, ResolvedStep, type SdkConfig, type SdkConfirmStep, type SdkFeedbackStep, type SdkOffer, type SdkOfferCopy, type SdkOfferStep, type SdkReason, type SdkSettings, type SdkStep, type SdkSurveyStep, type SessionCredentials, type SessionPayload, appearanceToStyle, calculateDiscountedPrice, cn, decodeSessionToken, defaultTitles, formatPeriodEnd, formatPrice };

package/dist/headless.d.cts

@@ -0,0 +1,34 @@
+import { z as FlowConfig, T as ReasonConfig, W as ResolvedStep, K as OfferDecision, s as DirectCustomer, u as DirectSubscription } from './step-graph-DX8yCqq1.cjs';
+import 'react';
+
+declare function useCancelFlow(config: FlowConfig): {
+    isLoading: boolean;
+    loadError: Error | null;
+    retry: () => void;
+    reasons: ReasonConfig[];
+    currentStep: ResolvedStep | undefined;
+    currentOffer: OfferDecision | null;
+    stepIndex: number;
+    totalSteps: number;
+    selectReason: (id: string) => void;
+    setFollowupResponse: (text: string) => void;
+    setFeedback: (text: string) => void;
+    accept: (result?: Record<string, unknown>) => Promise<void>;
+    decline: () => void;
+    cancel: () => Promise<void>;
+    next: (result?: Record<string, unknown>) => void;
+    back: () => void;
+    close: () => void;
+    step: string;
+    currentStepId: string;
+    selectedReason: string | null;
+    followupResponse: string;
+    feedback: string;
+    outcome: "saved" | "cancelled" | null;
+    isProcessing: boolean;
+    error: Error | null;
+    customer: DirectCustomer | null;
+    subscriptions: DirectSubscription[];
+};
+
+export { useCancelFlow };