Feature/project review

app/Actions/Auth/CreateZohoLeadAction.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Actions\Auth;
+
+use Asciisd\ZohoV8\Models\ZohoLead;
+use Illuminate\Support\Facades\Log;
+
+class CreateZohoLeadAction
+{
+    /**
+     * Create a Zoho lead
+     */
+    public function execute(array $data): mixed
+    {
+        try {
+            return ZohoLead::create([
+                'First_Name' => $data['first_name'],
+                'Last_Name' => $data['last_name'],
+                'Email' => $data['email'],
+                'Phone' => $data['phone'],
+                'Lead_Source' => $data['lead_source'],
+            ]);
+        } catch (\Throwable $e) {
+            Log::channel('zoho_sync')->error('ZohoLead creation failed', [
+                'email' => $data['email'] ?? null,
+                'error' => $e->getMessage(),
+            ]);
+
+            return null;
+        }
+    }
+}

app/Actions/Books/GenerateBookDownloadUrl.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Actions\Books;
+
+use App\Models\Book;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Facades\Log;
+
+class GenerateBookDownloadUrl
+{
+    /**
+     * Generate a temporary download URL for a book
+     */
+    public function execute(Book $book, int $minutesValid = 30): ?string
+    {
+        try {
+            // Check if file_src exists
+            if (!$book->file_src) {
+                Log::warning('Book file_src is empty', ['book_id' => $book->id]);
+                return null;
+            }
+
+            $path = $this->extractPath($book->file_src);
+
+            if (!$path) {
+                Log::warning('Could not extract path from file_src', [
+                    'book_id' => $book->id,
+                    'file_src' => $book->file_src
+                ]);
+                return null;
+            }
+
+            return Storage::disk('s3_public')->temporaryUrl(
+                $path,
+                now()->addMinutes($minutesValid)
+            );
+
+        } catch (\Exception $e) {
+            Log::error('Failed to generate book download URL', [
+                'book_id' => $book->id,
+                'error' => $e->getMessage()
+            ]);
+            return null;
+        }
+    }
+
+    /**
+     * Extract path from file_src (supports both JSON and plain string)
+     */
+    private function extractPath(string $fileSrc): ?string
+    {
+        // Try to decode as JSON first
+        $decoded = json_decode($fileSrc);
+
+        if (json_last_error() === JSON_ERROR_NONE && is_object($decoded) && isset($decoded->path)) {
+            return $decoded->path;
+        }
+
+        // If not JSON, treat as plain path
+        return trim($fileSrc) ?: null;
+    }
+}