Handle Stripe errors, unknown price IDs, and malformed docs URLs gracefully

- Wrap Stripe Connect account creation in try-catch to show user-friendly error instead of 500
- Catch unknown Stripe price IDs in OrderSuccess and report instead of crashing
- Catch UrlGenerationException in docs catch-all route for malformed page values like ${NC}

Author: shanerbaner82

app/Http/Controllers/DeveloperOnboardingController.php

@@ -32,11 +32,11 @@ public function start(Request $request): RedirectResponse
         $user = $request->user();
         $developerAccount = $user->developerAccount;
 
-        if (! $developerAccount) {
-            $developerAccount = $this->stripeConnectService->createConnectAccount($user);
-        }
-
         try {
+            if (! $developerAccount) {
+                $developerAccount = $this->stripeConnectService->createConnectAccount($user);
+            }
+
             $onboardingUrl = $this->stripeConnectService->createOnboardingLink($developerAccount);
 
             return redirect($onboardingUrl);

app/Livewire/OrderSuccess.php

@@ -59,7 +59,14 @@ public function loadData(): void
             return;
         }
 
-        $this->subscription = Subscription::fromStripePriceId($subscriptionItem->stripe_price);
+        try {
+            $this->subscription = Subscription::fromStripePriceId($subscriptionItem->stripe_price);
+        } catch (\RuntimeException $e) {
+            report($e);
+
+            return;
+        }
+
         $this->email = $subscriptionRecord->user->email;
         $this->licenseKey = License::query()
             ->whereBelongsTo($subscriptionItem)

routes/web.php

@@ -220,11 +220,19 @@
         }
     }
 
-    return to_route('docs.show', [
-        'platform' => $platform,
-        'version' => $version,
-        'page' => $page,
-    ]);
+    try {
+        return to_route('docs.show', [
+            'platform' => $platform,
+            'version' => $version,
+            'page' => $page,
+        ]);
+    } catch (\Illuminate\Routing\Exceptions\UrlGenerationException) {
+        return to_route('docs.show', [
+            'platform' => $platform,
+            'version' => $version,
+            'page' => 'introduction',
+        ]);
+    }
 })->name('docs')->where('page', '.*');
 
 Route::get('order/{checkoutSessionId}', App\Livewire\OrderSuccess::class)->name('order.success');