@flopay/react 1.3.4 → 1.4.1

package/README.md

@@ -187,6 +187,13 @@ the entire integration change — no SDK redeploy or consumer code update is
 required. Wallets only render on supported devices regardless of dashboard
 state (Apple Pay on Safari/macOS/iOS, Google Pay on Chrome).
 
+> **Bundler note:** the vendored APM brand logos ship as sibling `.svg` assets
+> under `dist/payment-logos/`, referenced with `new URL('./…', import.meta.url)`
+> so their bytes stay out of the JS bundle (a card-only checkout ships none of
+> them). Your bundler must support asset URLs — Vite, webpack 5, Rollup, Next,
+> and esbuild all do out of the box. Card-only and vault checkouts never render
+> a method tile, so they never request a logo.
+
 In `layout="buttons"`, the **Credit / Debit Card** button always opens the
 inline card form. External wallets and PayPal keep their own lifecycle:
 buyer cancellation silently returns to the payment-method chooser with all
@@ -709,6 +716,24 @@ function PaymentStatus() {
 | `options.currency` | `string?` | ISO 4217 currency code (used when no `clientSecret`) |
 | `options.paymentMethodCreation` | `'manual' \| 'auto'` | How payment methods are created |
 
+### Privacy-safe operational telemetry
+
+`FloPayCheckout` emits the same closed Flo-owned lifecycle/error/performance
+contract as `@flopay/js`, including React render/interactivity and provider
+readiness milestones. Collection is best-effort; merchant callbacks remain
+available with their existing arguments and invocation order. Synchronous
+throws and rejected callback promises are contained and logged only to the
+merchant console; they are not uploaded as `CALLBACK_FAILED`. Set the single
+`telemetry={false}` prop to opt out:
+
+```tsx
+<FloPayCheckout sessionId={sessionId} nonce={nonce} telemetry={false} />
+```
+
+No endpoint, custom tag, user context, message, stack, or metadata can be
+configured. See [`docs/TELEMETRY.md`](../../docs/TELEMETRY.md) for the complete
+privacy and retention contract.
+
 ### CheckoutFormProps
 
 | Prop | Type | Description |