⚡
Thunder
Thunder is an advanced Laravel tool to track user consumption using Cashier's Metered Billing for Stripe.
🤝
Supporting
If you are using one or more Renoki Co. open-source packages in your production apps, in presentation demos, hobby projects, school projects or so, sponsor our work with Github Sponsors.
🚀
Installation
You can install the package via composer:
composer require renoki-co/thunder
This project comes with Cashier, and it's really important to install it before diving in the documentation.
🙌
Usage
Thunder tracks resources quotas for your users via Stripe Metered Billing.
You may only define plans with certain features that are connected to Stripe by IDs, declaring them only once throughout your code.
Reporting the usages is done with the IDs you define instead of unique pricing IDs that are different for each environment your deploy your app in, making it consistent throughout the code.
This way, you can call usage reports just like Cashier's Metered Billing, but instead of using the Stripe IDs, you are using the defined IDs:
use RenokiCo\Thunder\Thunder;
Thunder::plan('Unlimited Plan', 'stripe_product_id', [
Thunder::meteredFeature('Build Minutes', 'build.minutes', 'stripe_build_minutes_price_id'),
Thunder::meteredFeature('Seats', 'seats', 'stripe_seats_price_id'),
]);
$subscription = $user->subscription('main');
Thunder::reportUsageFor('build.minutes', $subscription, 50);
Thunder::reportUsageFor('build.minutes', $subscription, 100);
Thunder::usage('build.minutes', $subscription); // 150
🐛
Testing
vendor/bin/phpunit
🤝
Contributing
Please see CONTRIBUTING for details.
🔒
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
2 Aug 18, 2022
269 Jan 1, 2023
440 Dec 17, 2022
29 Dec 26, 2022
189 Jan 5, 2023
105 Dec 5, 2022
4 Oct 31, 2022
4 Jul 12, 2022
3 Jan 3, 2022
962 Jan 2, 2023
220 Dec 25, 2022
74 May 1, 2022
2 Oct 7, 2022
108 Nov 1, 2022
3 Aug 23, 2022
178 Jan 4, 2023
162 Oct 30, 2022
87 Oct 13, 2022
26 Dec 22, 2022