Optimize academy

app/Services/Academy/AcademyAccessService.php

@@ -344,7 +344,18 @@ final class AcademyAccessService
         $previewImage = $this->promptPreviewImagePayload((string) ($prompt->preview_image ?? ''));
         $documentation = $this->promptDocumentationPayload($prompt->documentation);
         $placeholders = $this->promptPlaceholdersPayload((array) ($prompt->placeholders ?? []));
+        $allFilledExamples = $this->promptFilledExamplesPayload((array) ($prompt->filled_examples ?? []));
+        $filledExamplesTotal = count($allFilledExamples);
+        $hasFullFilledExamplesAccess = (bool) (($viewer?->hasAcademyProAccess() ?? false) || ($viewer?->hasStaffAccess() ?? false));
+        $hasPartialFilledExamplesAccess = (bool) ($viewer?->hasAcademyCreatorAccess() ?? false);
+        $visibleFilledExamples = match (true) {
+            ! $includeFull => [],
+            $hasFullFilledExamplesAccess => $allFilledExamples,
+            $hasPartialFilledExamplesAccess => array_slice($allFilledExamples, 0, 2),
+            default => [],
+        };
         $hasPlaceholderInputs = $this->promptHasPlaceholderInputs((string) $prompt->prompt, $placeholders);
+        $hasFilledExamples = $allFilledExamples !== [];
         $hasHelperPrompts = $this->promptHelperPromptsPayload((array) ($prompt->helper_prompts ?? [])) !== [];
         $hasPromptVariants = $this->promptVariantsPayload((array) ($prompt->prompt_variants ?? [])) !== [];
         $helperPrompts = $authorized && $includeFull
@@ -367,6 +378,12 @@ final class AcademyAccessService
             'documentation' => $documentation,
             'placeholders' => $placeholders,
             'has_placeholder_inputs' => $hasPlaceholderInputs,
+            'filled_examples' => $visibleFilledExamples,
+            'has_filled_examples' => $hasFilledExamples,
+            'filled_examples_total' => $filledExamplesTotal,
+            'can_access_filled_examples' => ($hasFullFilledExamplesAccess || $hasPartialFilledExamplesAccess) && $includeFull,
+            'has_more_filled_examples' => $filledExamplesTotal > count($visibleFilledExamples),
+            'has_full_filled_examples_access' => $hasFullFilledExamplesAccess,
             'has_helper_prompts' => $hasHelperPrompts,
             'has_prompt_variants' => $hasPromptVariants,
             'helper_prompts' => $helperPrompts,
@@ -396,6 +413,47 @@ final class AcademyAccessService
         ];
     }
 
+    /**
+     * @param  array<int, mixed>  $filledExamples
+     * @return array<int, array<string, mixed>>
+     */
+    private function promptFilledExamplesPayload(array $filledExamples): array
+    {
+        return collect($filledExamples)
+            ->filter(static fn ($example): bool => is_array($example))
+            ->map(function (array $example): array {
+                return [
+                    'title' => $this->nullableTrimmedString($example['title'] ?? null),
+                    'description' => $this->nullableTrimmedString($example['description'] ?? null),
+                    'placeholder_values' => collect(is_array($example['placeholder_values'] ?? null) ? $example['placeholder_values'] : [])
+                        ->mapWithKeys(function ($value, $key): array {
+                            $normalizedKey = trim((string) $key);
+
+                            if ($normalizedKey === '') {
+                                return [];
+                            }
+
+                            return [$normalizedKey => $value];
+                        })
+                        ->all(),
+                    'prompt' => trim((string) ($example['prompt'] ?? '')),
+                    'negative_prompt' => $this->nullableTrimmedString($example['negative_prompt'] ?? null),
+                ];
+            })
+            ->filter(function (array $example): bool {
+                return collect([
+                    $example['title'] ?? null,
+                    $example['description'] ?? null,
+                    $example['prompt'] ?? null,
+                    $example['negative_prompt'] ?? null,
+                    $example['placeholder_values'] ?? null,
+                ])->contains(fn ($item): bool => $item !== null && $item !== '' && $item !== []);
+            })
+            ->take(5)
+            ->values()
+            ->all();
+    }
+
     /**
      * @param  mixed  $documentation
      * @return array<string, mixed>

app/Services/Academy/AcademyBillingPlanService.php

@@ -5,8 +5,11 @@ declare(strict_types=1);
 namespace App\Services\Academy;
 
 use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Str;
 use RuntimeException;
+use Stripe\Exception\InvalidRequestException;
+use Stripe\StripeClient;
 
 final class AcademyBillingPlanService
 {
@@ -64,6 +67,7 @@ final class AcademyBillingPlanService
         $plan['stripe_price_id'] = trim((string) ($plan['stripe_price_id'] ?? ''));
         $plan['configured'] = $plan['stripe_price_id'] !== '';
         $plan['price_id_valid'] = $this->isValidPriceId($plan['stripe_price_id']);
+        $plan['remote_price_exists'] = $this->remotePriceExists($plan['stripe_price_id']);
         $plan['price_display'] = $plan['amount'] !== '' ? $plan['amount'].' '.$plan['currency'] : null;
 
         return $plan;
@@ -145,4 +149,86 @@ final class AcademyBillingPlanService
 
         return preg_match('/^price_[A-Za-z0-9]+$/', $priceId) === 1;
     }
-}
+
+    public function remotePriceExists(?string $priceId): ?bool
+    {
+        $priceId = trim((string) $priceId);
+
+        if ($priceId === '') {
+            return false;
+        }
+
+        // Avoid calling Stripe in local/testing environments — assume exists there.
+        if (app()->environment(['local', 'testing'])) {
+            return true;
+        }
+
+        $cacheKey = 'academy.remote_price_exists:'.md5($priceId);
+
+        return Cache::remember($cacheKey, 300, function () use ($priceId): ?bool {
+            try {
+                $secret = $this->stripeSecret();
+
+                if ($secret === null) {
+                    return null;
+                }
+
+                $client = new StripeClient($secret);
+                $price = $client->prices->retrieve($priceId, []);
+
+                // If Stripe returned an object with an id, it exists. Also ensure product exists where possible.
+                if (is_object($price) && ! empty($price->id)) {
+                    return true;
+                }
+
+                return false;
+            } catch (InvalidRequestException $e) {
+                report($e);
+
+                return false;
+            } catch (\Throwable $e) {
+                report($e);
+
+                // Auth, network, or transient Stripe failures should not make
+                // public pricing look fully misconfigured.
+                return null;
+            }
+        });
+    }
+
+    private function stripeSecret(): ?string
+    {
+        foreach ([config('cashier.secret'), env('STRIPE_SECRET')] as $candidate) {
+            if (! is_string($candidate)) {
+                continue;
+            }
+
+            $candidate = trim($candidate);
+
+            if ($candidate !== '') {
+                return $candidate;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @return array<int, string>
+     */
+    public function missingRemotePriceIds(?string $planKey = null): array
+    {
+        if ($planKey !== null) {
+            $plan = $this->plan($planKey);
+
+            return $plan !== null && $this->remotePriceExists($plan['stripe_price_id'] ?? '') === false
+                ? [$this->normalizePlanKey($planKey)]
+                : [];
+        }
+
+        return collect(array_keys($this->plans()))
+            ->filter(fn (string $key): bool => $this->remotePriceExists($this->plan($key)['stripe_price_id'] ?? '') === false)
+            ->values()
+            ->all();
+    }
+}