Skip to content

POC: Add --events-from flag to model event source#1764

Draft
yahanxing-stripe wants to merge 2 commits into
masterfrom
yx/poc-events-from
Draft

POC: Add --events-from flag to model event source#1764
yahanxing-stripe wants to merge 2 commits into
masterfrom
yx/poc-events-from

Conversation

@yahanxing-stripe

Copy link
Copy Markdown
Contributor

Summary

Builds on #1763. Adds --events-from <self|accounts|all> to separate the "where events come from" concern from "where events go to."

  • --events-from self — only direct/platform events
  • --events-from accounts — only connected account events
  • --events-from all — both (default)

--forward-connect-to is kept as syntactic sugar for routing connect events to a different URL.

🤖 Generated with Claude Code

yahanxing-stripe and others added 2 commits July 9, 2026 10:37
This is a v2 breaking change that removes the separate --thin-events,
--forward-thin-to, and --forward-thin-connect-to flags. Instead, the
unified --events flag accepts both snapshot event types (e.g.
charge.captured) and thin event types (e.g. v1.billing.meter.no_meter_found),
auto-detecting the payload style from the event name pattern (v[0-9]+. prefix).

The --forward-to flag now forwards both snapshot and thin events to the
same destination. Internally, events are still split into two channels
(webhooks + v2_events) for the proxy layer.

Key behavior changes:
- `stripe listen` with default --events "*" now opens BOTH websocket
  channels (snapshot + thin)
- `--forward-to` forwards both payload styles to the same URL
- `--forward-connect-to` forwards both payload styles for connect events

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Committed-By-Agent: claude
Adds --events-from <self|accounts|all> to separate the "where events
come from" concern from "where events go". This replaces the pattern of
using --forward-connect-to as the only way to receive connect events.

Examples:
  stripe listen --events-from accounts --forward-to localhost:4242/webhook
  stripe listen --events-from self -e charge.captured --forward-to ...
  stripe listen --events-from all --forward-to ...  (default)

--forward-connect-to is kept as syntactic sugar for routing connect
events to a different URL than direct events.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Committed-By-Agent: claude
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant