@bpinternal/billing-ui 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -53,7 +53,7 @@ export declare function addonPrice(addon: Addon, plan: Plan, interval: BillingIn
  * Clickable summary of active add-ons (current quantities from the live
  * subscription). Acts as a preview button that opens add-on management.
  */
-export declare const AddonsSummaryCard: ({ onManage, className }: AddonsSummaryCardProps) => JSX.Element;
+export declare const AddonsSummaryCard: ({ onManage, className }: AddonsSummaryCardProps) => JSX.Element | null;
 
 export declare type AddonsSummaryCardProps = {
     /** Opens the manage-add-ons dialog. */
@@ -65,7 +65,7 @@ export declare const AgentsIcon: ({ size, ...props }: IconProps) => JSX.Element;
 
 export declare const ArrowRightIcon: ({ size, ...props }: IconProps) => JSX.Element;
 
-export declare const AutoRechargeDialog: ({ open, onOpenChange, onSuccess, onUpgrade }: AutoRechargeDialogProps) => JSX.Element;
+export declare const AutoRechargeDialog: ({ open, onOpenChange, onSuccess, onUpgrade }: AutoRechargeDialogProps) => JSX.Element | null;
 
 export declare type AutoRechargeDialogProps = {
     open: boolean;
@@ -180,10 +180,17 @@ export declare type BillingChangeEvent = {
  */
 export declare type BillingClient = Pick<billing.Client, 'listPlans' | 'listAddons' | 'getSubscription' | 'previewSubscriptionUpdate' | 'setPlan' | 'setAddons' | 'getPaymentMethod' | 'createPaymentMethodIntent' | 'setPaymentMethod' | 'getCustomer' | 'setCustomer' | 'listInvoices' | 'getBillingReadonly' | 'getWorkspaceUsages' | 'getAutoRechargeSettings' | 'setAutoRechargeSettings'> & 
 /**
-* Per-bot usage breakdown is OPTIONAL: those methods live on the generic
-* `@botpress/client` (not the billing client), so a host that wants the per-bot
-* view passes a client object that also exposes them. Omit them and the
-* UsageDashboard hides the per-bot section. Still type-only — no runtime dep.
+* `getWorkspaceMember` lives on the generic `@botpress/client`, not the
+* billing client, but is REQUIRED here: `useIsAuthorized` depends on it to
+* check the caller's workspace membership. Every host must pass a client
+* object that also exposes it. Still type-only — no runtime dep.
+*/
+Pick<Client, 'getWorkspaceMember'> & 
+/**
+* Per-bot usage breakdown is OPTIONAL: those methods also live on the
+* generic `@botpress/client`, but only a host that wants the per-bot view
+* needs to pass a client exposing them. Omit them and the UsageDashboard
+* hides the per-bot section.
 */
 Partial<Pick<Client, 'breakDownWorkspaceUsageByBot' | 'listBots'>>;
 
@@ -227,6 +234,7 @@ export declare const billingKeys: {
     customer: (scope: string) => readonly ["bpb", string, "customer"];
     invoices: (scope: string) => readonly ["bpb", string, "invoices"];
     readonly: (scope: string) => readonly ["bpb", string, "billing-readonly"];
+    isAuthorized: (scope: string) => readonly ["bpb", string, "is-authorized"];
     autoRecharge: (scope: string) => readonly ["bpb", string, "auto-recharge"];
     usages: (scope: string, period: string) => readonly ["bpb", string, "usages", string];
     bots: (scope: string) => readonly ["bpb", string, "bots"];
@@ -338,7 +346,7 @@ export declare const CheckIcon: ({ size, ...props }: IconProps) => JSX.Element;
  * the subscribe button share the same Stripe context. The SetupIntent itself is only
  * requested from CheckoutBody at Subscribe time, not eagerly on open.
  */
-export declare const CheckoutDialog: ({ open, onOpenChange, planId, interval, onBack, onSuccess }: CheckoutDialogProps) => JSX.Element;
+export declare const CheckoutDialog: ({ open, onOpenChange, planId, interval, onBack, onSuccess }: CheckoutDialogProps) => JSX.Element | null;
 
 export declare type CheckoutDialogProps = {
     open: boolean;
@@ -488,7 +496,7 @@ export declare type Invoice = Awaited<ReturnType<BillingClient['listInvoices']>>
  * Read-only billing history. Lists invoices newest-first with status, amount,
  * period, and a PDF download when Stripe provides one.
  */
-export declare const InvoicesDialog: ({ open, onOpenChange }: InvoicesDialogProps) => JSX.Element;
+export declare const InvoicesDialog: ({ open, onOpenChange }: InvoicesDialogProps) => JSX.Element | null;
 
 export declare type InvoicesDialogProps = {
     open: boolean;
@@ -516,7 +524,7 @@ export declare const LockIcon: ({ size, ...props }: IconProps) => JSX.Element;
  * first), totals computed client-side, committed as absolute quantities via
  * setAddons — 0 removes an add-on. No plan change involved.
  */
-export declare const ManageAddonsDialog: ({ open, onOpenChange, onSuccess, onUpgrade }: ManageAddonsDialogProps) => JSX.Element;
+export declare const ManageAddonsDialog: ({ open, onOpenChange, onSuccess, onUpgrade }: ManageAddonsDialogProps) => JSX.Element | null;
 
 export declare type ManageAddonsDialogProps = {
     open: boolean;
@@ -590,7 +598,7 @@ export declare type PaymentMethodCard = NonNullable<PaymentMethod['card']>;
  * confirmCardSetup (no address required), then persisted; address is saved
  * independently — matching Desk's separation.
  */
-export declare const PaymentMethodDialog: ({ open, onOpenChange, onSuccess }: PaymentMethodDialogProps) => JSX.Element;
+export declare const PaymentMethodDialog: ({ open, onOpenChange, onSuccess }: PaymentMethodDialogProps) => JSX.Element | null;
 
 export declare type PaymentMethodDialogProps = {
     open: boolean;
@@ -725,7 +733,7 @@ export declare const PLAN_ORDER: PlanKind[];
  * renews (paid, self-serve plans only), plus a manage CTA. On legacy billing
  * it deep-links to the Dashboard.
  */
-export declare const PlanBanner: ({ onManage, className }: PlanBannerProps) => JSX.Element;
+export declare const PlanBanner: ({ onManage, className }: PlanBannerProps) => JSX.Element | null;
 
 export declare type PlanBannerProps = {
     /** Opens the plan picker / checkout. */
@@ -758,7 +766,7 @@ export declare function planKind(plan: Pick<Plan, 'name' | 'metadata'>): PlanKin
  * Clickable summary of the current plan — name, interval, price, conversation
  * allowance. Acts as a preview button that opens the plan-management flow.
  */
-export declare const PlanSummaryCard: ({ onManage, className }: PlanSummaryCardProps) => JSX.Element;
+export declare const PlanSummaryCard: ({ onManage, className }: PlanSummaryCardProps) => JSX.Element | null;
 
 export declare type PlanSummaryCardProps = {
     /** Opens the plan picker / checkout. */
@@ -905,7 +913,7 @@ export declare type TaxId = Customer['taxIds'][number];
 
 export declare function toStripeLocale(locale: string): string;
 
-export declare const UpgradePlanDialog: ({ open, onOpenChange, onSelectPlan, recommendedPlanId, defaultInterval, excludePlanIds, planFeatures, featureDescriptions, }: UpgradePlanDialogProps) => JSX.Element;
+export declare const UpgradePlanDialog: ({ open, onOpenChange, onSelectPlan, recommendedPlanId, defaultInterval, excludePlanIds, planFeatures, featureDescriptions, }: UpgradePlanDialogProps) => JSX.Element | null;
 
 export declare type UpgradePlanDialogProps = {
     open: boolean;
@@ -1107,7 +1115,8 @@ export declare function useInvoices(options?: QueryOptions): UseQueryResult<{
     };
 }, Error>;
 
-export declare function useIsAuthorized(): boolean | Error | undefined;
+/** Whether the caller's role (via `getWorkspaceMember`) has `workspace.manageBilling`. */
+export declare function useIsAuthorized(options?: QueryOptions): UseQueryResult<boolean, Error>;
 
 export declare function usePaymentMethod(options?: QueryOptions): UseQueryResult<{
     paymentMethod: PaymentMethod | null;
@@ -1159,6 +1168,9 @@ export declare function useUsageByBot(type: string, options?: QueryOptions & {
     period?: string;
 }): UseQueryResult<BotUsageRow[], Error>;
 
+/** The caller's own workspace membership, as returned by `getWorkspaceMember`. */
+export declare type WorkspaceMember = Awaited<ReturnType<Client['getWorkspaceMember']>>;
+
 export declare type WorkspaceUsages = Awaited<ReturnType<BillingClient['getWorkspaceUsages']>>['quotas'];
 
 export { }