@bpinternal/billing-ui 0.19.1 → 0.21.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Appearance } from '@stripe/stripe-js';
 import { billing } from '@botpress/client';
 import { ButtonHTMLAttributes } from 'react';
+import { CancellationReason } from '@bpinternal/const';
 import { ClassValue } from 'clsx';
 import { Client } from '@botpress/client';
 import { ComponentType } from 'react';
@@ -118,6 +119,9 @@ export declare const BILLING_EVENTS: {
     readonly PLAN_UPGRADE_INITIATED: "billing_plan_upgrade_initiated";
     readonly PLAN_DOWNGRADED: "billing_plan_downgraded";
     readonly PLAN_DOWNGRADE_CANCELLED: "billing_plan_downgrade_cancelled";
+    readonly DOWNGRADE_CONFIRM_VIEWED: "billing_downgrade_confirm_viewed";
+    readonly DOWNGRADE_SURVEY_VIEWED: "billing_downgrade_survey_viewed";
+    readonly DOWNGRADE_SURVEY_SUBMITTED: "billing_downgrade_survey_submitted";
     readonly CHECKOUT_STEP_VIEWED: "billing_checkout_step_viewed";
     readonly CHECKOUT_INTERVAL_CHANGED: "billing_checkout_interval_changed";
     readonly PAYMENT_METHOD_SELECTED: "billing_payment_method_selected";
@@ -192,7 +196,13 @@ Pick<Client, 'getWorkspaceMember'> &
 * needs to pass a client exposing them. Omit them and the UsageDashboard
 * hides the per-bot section.
 */
-Partial<Pick<Client, 'breakDownWorkspaceUsageByBot' | 'listBots'>>;
+Partial<Pick<Client, 'breakDownWorkspaceUsageByBot' | 'listBots'>> & {
+    /**
+     * Persists the cancellation survey answers. Not part of the billing engine,
+     * so every host implements it over its own backend
+     */
+    saveCancellationFeedback: (feedback: CancellationFeedback) => Promise<void>;
+};
 
 export declare type BillingColorScheme = 'default' | 'neutral';
 
@@ -327,6 +337,29 @@ export declare type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
 
 export declare const CalendarIcon: ({ size, ...props }: IconProps) => JSX.Element;
 
+/** Answers from the cancellation survey shown before a downgrade. */
+export declare type CancellationFeedback = {
+    reason: CancellationReason;
+    comment?: string;
+    /** Plan being left. */
+    previousPlanId: string;
+    /** Plan being downgraded to. */
+    planId: string;
+};
+
+/** Two-step downgrade flow: what the user loses, then why they're leaving. */
+export declare const CancellationSurveyDialog: ({ open, onOpenChange, planId, onConfirm, loading, planFeatures, }: CancellationSurveyDialogProps) => JSX.Element;
+
+export declare type CancellationSurveyDialogProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Plan the user is downgrading to. */
+    planId: string;
+    onConfirm: (feedback: CancellationFeedback) => void;
+    loading?: boolean;
+    planFeatures?: Partial<Record<PlanKind, PlanFeatureId[]>>;
+};
+
 /** Minimal card-brand badge (saved-card row). Stripe's own UI shows real brand art. */
 export declare const CardBrandBadge: ({ brand }: {
     brand: string;
@@ -1167,6 +1200,9 @@ export declare function usePlans(): UseQueryResult<Plan[], Error>;
 
 export declare const UsersIcon: ({ size, ...props }: IconProps) => JSX.Element;
 
+/** Persists the cancellation survey answers. */
+export declare function useSaveCancellationFeedback(): UseMutationResult<void, Error, CancellationFeedback>;
+
 /** Absolute add-on quantities for the current subscription (0 removes an add-on). */
 export declare function useSetAddons(): UseMutationResult<Subscription, Error, {
     addons: Record<string, number>;