Save workspace changes

app/Http/Controllers/Api/AiBiographyController.php

@@ -0,0 +1,122 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Jobs\GenerateAiBiographyJob;
+use App\Models\User;
+use App\Services\AiBiography\AiBiographyService;
+use App\Support\UsernamePolicy;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+/**
+ * Creator-facing AI biography endpoints.
+ *
+ * All write routes require the authenticated user to be the profile owner.
+ * Reads are restricted to the authenticated owner (public rendering is handled
+ * via ProfileJourneyController / ProfileApiController payloads).
+ */
+final class AiBiographyController extends Controller
+{
+    public function __construct(private readonly AiBiographyService $biographies)
+    {
+    }
+
+    /**
+     * POST /api/creator/profile/ai-biography/generate
+     * Dispatch an async generation job for the authenticated user.
+     */
+    public function generate(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = Auth::user();
+
+        GenerateAiBiographyJob::dispatch((int) $user->id, false)
+            ->onQueue((string) config('ai_biography.queue', 'default'));
+
+        return response()->json([
+            'message' => 'Biography generation queued.',
+        ], 202);
+    }
+
+    /**
+     * POST /api/creator/profile/ai-biography/regenerate
+     * Force-regenerate (replaces existing non-user-edited biography).
+     */
+    public function regenerate(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = Auth::user();
+
+        GenerateAiBiographyJob::dispatch((int) $user->id, true)
+            ->onQueue((string) config('ai_biography.queue', 'default'));
+
+        return response()->json([
+            'message' => 'Biography regeneration queued.',
+        ], 202);
+    }
+
+    /**
+     * PATCH /api/creator/profile/ai-biography
+     * Creator edits their biography text.
+     */
+    public function update(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'text' => ['required', 'string', 'min:30', 'max:1200'],
+        ]);
+
+        /** @var User $user */
+        $user = Auth::user();
+
+        $this->biographies->updateText($user, $validated['text']);
+
+        return response()->json(['message' => 'Biography updated.']);
+    }
+
+    /**
+     * POST /api/creator/profile/ai-biography/hide
+     */
+    public function hide(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = Auth::user();
+
+        $this->biographies->hide($user);
+
+        return response()->json(['message' => 'Biography hidden.']);
+    }
+
+    /**
+     * POST /api/creator/profile/ai-biography/show
+     */
+    public function show(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = Auth::user();
+
+        $this->biographies->show($user);
+
+        return response()->json(['message' => 'Biography made visible.']);
+    }
+
+    /**
+     * GET /api/creator/profile/ai-biography
+     * Return the authenticated creator's current biography status and metadata.
+     */
+    public function status(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = Auth::user();
+
+        $payload = $this->biographies->creatorStatusPayload($user);
+
+        return response()->json([
+            'data' => $payload,
+        ]);
+    }
+}

app/Http/Controllers/Api/LeaderboardController.php

@@ -39,4 +39,11 @@ final class LeaderboardController extends Controller
             $leaderboards->getLeaderboard(Leaderboard::TYPE_STORY, (string) $request->query('period', 'weekly'))
         );
     }
+
+    public function worlds(Request $request, LeaderboardService $leaderboards): JsonResponse
+    {
+        return response()->json(
+            $leaderboards->getLeaderboard(Leaderboard::TYPE_WORLD, (string) $request->query('period', 'weekly'))
+        );
+    }
 }

app/Http/Controllers/Api/ProfileAiBiographyController.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use App\Services\AiBiography\AiBiographyService;
+use App\Support\UsernamePolicy;
+use Illuminate\Http\JsonResponse;
+
+/**
+ * Public read endpoint for a creator's AI biography.
+ *
+ * GET /api/profile/{username}/ai-biography
+ *
+ * Returns null data if no visible biography exists (hidden, failed, or not yet generated).
+ * Never triggers generation — only serves stored text.
+ */
+final class ProfileAiBiographyController extends Controller
+{
+    public function __construct(private readonly AiBiographyService $biographies)
+    {
+    }
+
+    public function show(string $username): JsonResponse
+    {
+        $normalized = UsernamePolicy::normalize($username);
+
+        $user = User::query()
+            ->whereRaw('LOWER(username) = ?', [$normalized])
+            ->where('is_active', true)
+            ->whereNull('deleted_at')
+            ->firstOrFail();
+
+        $payload = $this->biographies->publicPayload($user);
+
+        return response()->json([
+            'data' => $payload,
+            'meta' => [
+                'username'     => (string) $user->username,
+                'generated_at' => now()->toIso8601String(),
+            ],
+        ]);
+    }
+}

app/Http/Controllers/Api/UploadController.php

@@ -43,6 +43,7 @@ use App\Uploads\Exceptions\DraftQuotaException;
 use App\Models\Artwork;
 use App\Models\Group;
 use App\Services\GroupArtworkReviewService;
+use App\Services\Worlds\WorldSubmissionService;
 use Illuminate\Support\Str;
 
 final class UploadController extends Controller
@@ -559,7 +560,7 @@ final class UploadController extends Controller
         ], Response::HTTP_OK);
     }
 
-    public function publish(string $id, Request $request, PublishService $publishService, ArtworkAttributionService $attribution, ArtworkMaturityService $maturity)
+    public function publish(string $id, Request $request, PublishService $publishService, ArtworkAttributionService $attribution, ArtworkMaturityService $maturity, WorldSubmissionService $submissions)
     {
         $user = $request->user();
 
@@ -584,6 +585,9 @@ final class UploadController extends Controller
             'contributor_credits.*.user_id' => ['required', 'integer', 'min:1'],
             'contributor_credits.*.credit_role' => ['nullable', 'string', 'max:80'],
             'contributor_credits.*.is_primary' => ['nullable', 'boolean'],
+            'world_submissions' => ['nullable', 'array', 'max:12'],
+            'world_submissions.*.world_id' => ['required', 'integer', 'exists:worlds,id'],
+            'world_submissions.*.note' => ['nullable', 'string', 'max:1000'],
         ]);
 
         $mode       = $validated['mode'] ?? 'now';
@@ -660,6 +664,7 @@ final class UploadController extends Controller
             $artwork->save();
             $maturity->applyUploaderDeclaration($artwork, (bool) $artwork->is_mature);
             $artwork = $attribution->apply($artwork->fresh(['group.members']), $user, $validated);
+            $submissions->syncForArtwork($artwork->fresh(), $user, (array) ($validated['world_submissions'] ?? []));
 
             if ($mode === 'schedule' && $publishAt) {
                 // Scheduled: store publish_at but don't make public yet
@@ -754,7 +759,7 @@ final class UploadController extends Controller
         }
     }
 
-    public function submitForReview(string $id, Request $request, GroupArtworkReviewService $reviews)
+    public function submitForReview(string $id, Request $request, GroupArtworkReviewService $reviews, WorldSubmissionService $submissions)
     {
         $user = $request->user();
 
@@ -776,6 +781,9 @@ final class UploadController extends Controller
             'contributor_credits.*.user_id' => ['required', 'integer', 'min:1'],
             'contributor_credits.*.credit_role' => ['nullable', 'string', 'max:80'],
             'contributor_credits.*.is_primary' => ['nullable', 'boolean'],
+            'world_submissions' => ['nullable', 'array', 'max:12'],
+            'world_submissions.*.world_id' => ['required', 'integer', 'exists:worlds,id'],
+            'world_submissions.*.note' => ['nullable', 'string', 'max:1000'],
         ]);
 
         if (! ctype_digit($id)) {
@@ -797,6 +805,7 @@ final class UploadController extends Controller
         }
 
         $artwork = $reviews->submit($group, $artwork, $user, $validated);
+        $submissions->syncForArtwork($artwork->fresh(), $user, (array) ($validated['world_submissions'] ?? []));
 
         return response()->json([
             'success' => true,