@bunnyapp/components 2.0.0-beta.2 → 2.0.0-beta.3

package/dist/esm/types/src/components/BunnyProvider/BunnyProvider.d.ts

@@ -8,6 +8,12 @@ export type BunnyContextValues = {
 export declare const BunnyContext: import("react").Context<BunnyContextValues>;
 declare function BunnyProvider({ children, queryClient, apiHost, token, onTokenExpired, onUserUnavailable, onInvalidOrMissingAuthorization, suppressUserUnavailableErrorNotification, disableErrorNotifications, appearance, }: {
     children: React.ReactNode;
+    /**
+     * Your own TanStack Query client, if your app already has one. It replaces Bunny's default client
+     * entirely, so Bunny's error notifications and Sentry reporting for failed requests no longer run:
+     * show errors yourself with an `onError` on the client's `MutationCache` / `QueryCache` (or in
+     * `defaultOptions.mutations.onError`). Payment setup errors are still reported to your page's Sentry.
+     */
     queryClient?: QueryClient;
     apiHost: string;
     token?: string;

package/dist/esm/types/src/components/CheckoutShared/components/CheckoutScreen.d.ts

@@ -13,7 +13,7 @@ import { CheckoutQuoteDocument_QuoteFragment } from '../graphql/fragments/Checko
  * document template is configured it goes under the summary: the composed quote before the checkout,
  * and the checked-out quote under the receipt afterwards.
  */
-export default function CheckoutScreen({ style, form, savedPaymentMethods, isFlowReady, showQuoteDocument, quote: pendingQuote, }: {
+export default function CheckoutScreen({ style, form, savedPaymentMethods, isFlowReady, showQuoteDocument, quote: pendingQuote, paymentMethodTypes, }: {
     style?: React.CSSProperties;
     form: ReactNode;
     /** Payment methods already stored on the account, if the flow has one. */
@@ -24,4 +24,6 @@ export default function CheckoutScreen({ style, form, savedPaymentMethods, isFlo
     showQuoteDocument?: boolean;
     /** The quote the flow will check out, if it exists before paying. Its PDF is shown under the summary. */
     quote?: FragmentOf<typeof CheckoutQuoteDocument_QuoteFragment>;
+    /** The Stripe payment method types the flow's SetupIntent is limited to, if it is (see `StripeElements`). */
+    paymentMethodTypes?: readonly string[];
 }): import("react").JSX.Element;

package/dist/esm/types/src/components/CheckoutShared/hooks/useCheckoutFormSubmit.d.ts

@@ -3,8 +3,9 @@ import { CheckoutResult } from '../contexts/CheckoutResultContext';
 /**
  * What submitting the checkout form has in common across the flows, once antd has validated it:
  * layer the consumer's defaults under the entered values (fields that aren't shown still describe
- * the account), run the flow's checkout and publish its result. Errors are toasted by the query
- * client's global handler.
+ * the account), run the flow's checkout and publish its result. Errors are shown by the query
+ * client's own handlers (the default client toasts them), so the flow's `onError` goes on the
+ * `mutate` call: as a `useMutation` option it would replace a consumer client's default `onError`.
  */
 export declare function useCheckoutFormSubmit({ mutationKey, checkout, onError, }: {
     mutationKey: readonly string[];

package/dist/esm/types/src/components/PaymentMethods/components/StripeElements.d.ts

@@ -7,8 +7,14 @@ import { ReactNode } from 'react';
  * Element render before any intent exists. Such a group needs its currency from the start, so Stripe
  * is held back until there is one. Changes to the appearance or currency reach the mounted elements;
  * `fonts` can't change after the group is created, so new fonts remount it.
+ *
+ * Stripe only confirms a SetupIntent that offers payment methods the same way the group does. Without
+ * `paymentMethodTypes` the group uses the Stripe account's automatic payment methods, which is what
+ * the API's intent for an existing account uses too; a flow whose intent lists its types has to pass
+ * the same list here.
  */
-export default function StripeElements({ currency, children }: {
+export default function StripeElements({ currency, paymentMethodTypes, children, }: {
     currency: string | undefined;
+    paymentMethodTypes?: readonly string[];
     children: ReactNode;
 }): import("react").JSX.Element;

package/dist/esm/types/src/components/PaymentMethods/utils/stripeErrors.d.ts

@@ -0,0 +1,17 @@
+import type { StripeError } from '@stripe/stripe-js';
+/** Errors this module already sent to Sentry, so the default query client's handler skips them. */
+export declare const reportedPaymentErrors: WeakSet<object>;
+/**
+ * Reports a failed payment setup to the host page's Sentry, whatever query client is in use: the
+ * client's handler is the consumer's when they pass their own. Validation errors are the customer's
+ * input, shown by the Payment Element itself, so they aren't reported.
+ */
+export declare function reportPaymentError(error: Error, extra: Record<string, unknown>): void;
+/**
+ * Turns a Stripe error into one the customer can read. Card and validation errors already are
+ * ("Your card has been declined."); anything else is a setup problem whose text is meant for
+ * developers, so the customer gets a generic message and the original goes along as `cause`.
+ */
+export declare function toStripeUserError(stripeError: StripeError, extra: Record<string, unknown>): Error & {
+    cause: StripeError;
+};

package/dist/index.d.ts

@@ -2242,6 +2242,12 @@ type RuleProperty = RuleProperty$1;
 
 declare function BunnyProvider({ children, queryClient, apiHost, token, onTokenExpired, onUserUnavailable, onInvalidOrMissingAuthorization, suppressUserUnavailableErrorNotification, disableErrorNotifications, appearance, }: {
     children: React.ReactNode;
+    /**
+     * Your own TanStack Query client, if your app already has one. It replaces Bunny's default client
+     * entirely, so Bunny's error notifications and Sentry reporting for failed requests no longer run:
+     * show errors yourself with an `onError` on the client's `MutationCache` / `QueryCache` (or in
+     * `defaultOptions.mutations.onError`). Payment setup errors are still reported to your page's Sentry.
+     */
     queryClient?: QueryClient;
     apiHost: string;
     token?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunnyapp/components",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.3",
   "description": "Components from the Bunny portal to embed Bunny UI functionality into your application.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/skills/bunny-components/SKILL.md

@@ -133,6 +133,7 @@ token.
 | Result | A subscription on the existing account | A new account and its first subscription |
 | Form defaults | Merged from the account (yours win) | Yours only |
 | `documentTemplateId` | Yes: shows the quote PDF under the summary | No |
+| Payment methods | Every method enabled in the Stripe account, including SEPA Direct Debit | Cards only (also Link), as signup charges immediately; bank debits such as SEPA and ACH settle over days. Customers who need SEPA sign up with a card and switch later, or use Checkout |
 
 `<Signup />` calls the signup mutations that only the
 `signup:read` / `signup:write` scopes cover; a portal session token is