billing-simulator

Stripe subscription lifecycle events are triggered against a local Supabase instance to exercise Edge Functions and validate resulting database state. This confirms that checkout and subscription updates correctly modify user licenses and organization slots.

To validate entitlement updates after a billing webhook, check the user_license_subscriptions, organization_slots, and organization_members tables in Supabase. The validation script confirms these database records correctly reflect the simulated subscription changes.

Yes, you need Stripe CLI, Supabase CLI, and Deno installed to run the webhook trigger and entitlement validation scripts. These tools provide the local environment necessary to simulate events and verify the Supabase database state.

The trigger-webhook.sh script simulates Stripe events like checkout.session.completed and customer.subscription.* updates. It sends these webhooks to your local Supabase instance to test how your Edge Functions handle subscription lifecycle changes.

The validate-entitlements.ts script checks the Supabase database to ensure user_license_subscriptions, organization_slots, and organization_members accurately reflect the simulated Stripe subscription events. It provides end-to-end verification of your billing webhook logic.