@flopay/react 1.4.17 → 1.4.19

package/README.md

@@ -759,6 +759,24 @@ 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.
 
+If the React host has its own Sentry client, use the re-exported pure filter as
+the host's `beforeSend` callback:
+
+```ts
+import * as Sentry from '@sentry/browser';
+import { dropThirdPartyOnlyError } from '@flopay/react';
+
+Sentry.init({ beforeSend: dropThirdPartyOnlyError });
+```
+
+No Sentry package or configuration is bundled by FloPay. The predicate drops
+only complete exception stacks with no app or `@flopay/*` frame and at least
+one recognised browser-extension URL or Stripe `dahlia/stripe.js` path/module
+marker. Anonymous frames may accompany that marker. Mixed, unrelated,
+incomplete, and anonymous-only errors pass through unchanged. The `in_app`
+flag is ignored because host rewriting may set it to `true` on third-party
+frames.
+
 Inline session creation classifies bounded failures without inspecting raw
 errors: network/CORS/timeouts emit `transport_error`, 5xx responses emit
 `server_error`, and malformed response discriminants emit `invalid_response`.
@@ -767,6 +785,16 @@ Stripe and PayPal SDK load/runtime failures emit `provider_runtime`. Inline
 `validation_rejected` / `payment_declined` outcomes and never carry
 `failureCategory`.
 
+The same classification applies to React-owned saved-payment processing in
+`auto` and `confirm` modes. An ordinary saved-payment `400` decline, a
+structured-field `400`, or a `422` still falls back to the usable full checkout
+and emits `operation.fallback`, but reports only the matching
+`payment_declined` or `validation_rejected` outcome. Genuine server,
+transport, malformed-response, and provider-runtime failures remain
+categorized technical errors. This does not change fallback rendering or
+merchant callback behavior, and no response body, provider payload, session
+value, payment data, or raw error message is added to telemetry.
+
 ### SplitCardFormProps
 
 Key payment-surface props include: