# BillingWebhookKit Free Sample

This sample shows the structure used by BillingWebhookKit Pro without including production credentials or live provider data.

## Included

- `fixtures/lemon/order-created.sample.json`
- `src/handlers/next-app-router.sample.ts`
- `tests/lemon-signature.sample.test.ts`
- `tests/lemon-contract.sample.test.ts`
- `tests/lemon-idempotency-replay.sample.test.ts`
- `.github/workflows/webhook-checks.sample.yml`
- `docs/webhook-review-report.sample.md`

## How to Use

1. Copy the fixture into your test folder.
2. Keep `test_webhook_secret` as a local-only test value.
3. Adapt the handler to your app's entitlement logic.
4. Run the signature test in CI before changing billing code.
5. Run the contract test to lock event name, object ID, status, customer, currency, and idempotency key derivation.
6. Run the duplicate replay test to confirm one side effect and two duplicate skips.
7. Attach the sample review report to billing-route pull requests after replacing the placeholder fields.

The full Pro Kit adds more Lemon Squeezy lifecycle fixtures, Stripe/Paddle/Polar starter events, additional route handlers, full-library contract and idempotency tests, review checklists, and a production launch checklist.