Add post-purchase confirmation emails for checkouts and Ultra

[simonhamp]

What

Adds buyer-facing confirmation emails that were previously missing after a successful purchase.

• PurchaseReceipt — sent to the buyer after any plugin / product / bundle checkout completes. Thanks them for supporting NativePHP and open source, notes that a payment receipt arrives separately from Stripe, and links them to their order history where they can access their purchases.
• UltraSubscriptionStarted — sent when an Ultra subscription is created. Same thank-you/support framing, notes the Stripe receipt, and links to the Ultra dashboard (/dashboard/ultra).

Why

Before this change, neither plugin/product checkouts nor Ultra subscriptions sent the buyer any email — they only saw a browser success page. The only sale-related email went to the developer whose plugin sold. These add the missing customer confirmations.

How

• Both notifications implement TransactionalNotification (always delivered, bypassing email-preference suppression) and deliver on the mail + database channels as queued notifications, matching existing conventions (LicenseKeyGenerated, PluginSaleCompleted).
• HandleInvoicePaidJob:
  • PurchaseReceipt is sent to the buyer in processCartPurchase() (current cart flow) and the legacy handleManualInvoice() path.
  • UltraSubscriptionStarted is sent from a new notifyUltraSubscriber() helper invoked in handleSubscriptionCreated(). It resolves the plan from the invoice's plan line item and only fires for the Ultra (Max) tier; unknown price ids are caught and skipped, so Mini/Pro subscriptions send nothing.

Tests

Added three tests to HandleInvoicePaidJobTest:

• Ultra subscription create → sends UltraSubscriptionStarted
• Non-Ultra (Pro) subscription → sends nothing
• Cart purchase → sends PurchaseReceipt to the buyer

All tests in the file pass, along with the related payout/pricing suites.

Note

"Ultra" is internally the Max plan tier, so detection keys off the subscriptions.plans.max.* price ids. Comped Ultra subscriptions (which use the Max comped price) will also receive the welcome email.

🤖 Generated with Claude Code