Skip to content

Beautiful Open-Source Form Builder

4.2 KB
Raw Blame
<?php

namespace App\Http\Controllers;

use App\Http\Resources\FormResource;
use App\Models\Forms\AgentFormDraft;
use App\Models\Workspace;
use App\Service\Forms\AgentFormDraftService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class AgentFormDraftController extends Controller
{
    public const SESSION_HEADER = 'x-agent-draft-session';

    public function preview(Request $request, AgentFormDraft $draft, AgentFormDraftService $drafts): JsonResponse
    {
        $validated = $request->validate(['version' => ['sometimes', 'integer', 'min:1']]);
        // Existing signed snapshot links remain readable after saving the draft.
        // Unversioned links and guest editing capabilities keep their active-only lifecycle.
        $savedSnapshot = isset($validated['version'])
            && $draft->status === AgentFormDraft::STATUS_CLAIMED
            && $draft->expires_at->isFuture();
        abort_unless($draft->isAvailable() || $savedSnapshot, Response::HTTP_NOT_FOUND);

        return response()->json([
            'draft' => $drafts->serialize($drafts->atVersion($draft, isset($validated['version']) ? (int) $validated['version'] : null)),
        ])->header('Cache-Control', 'private, no-store, max-age=0');
    }

    public function consume(Request $request, AgentFormDraftService $drafts): JsonResponse
    {
        $this->assertTrustedFrontend($request);
        $validated = $request->validate([
            'handoff_token' => ['required', 'string', 'size:43'],
        ]);
        $result = $drafts->consumeEditorHandoff($validated['handoff_token']);

        return response()->json([
            'editor_session' => $result['editor_session'],
            'draft' => $drafts->serialize($result['draft']),
        ])->header('Cache-Control', 'private, no-store, max-age=0');
    }

    public function current(Request $request, AgentFormDraftService $drafts): JsonResponse
    {
        $this->assertTrustedFrontend($request);

        return response()->json([
            'draft' => $drafts->serialize($drafts->getForEditor($this->editorSession($request))),
        ])->header('Cache-Control', 'private, no-store, max-age=0');
    }

    public function replace(Request $request, AgentFormDraftService $drafts): JsonResponse
    {
        $this->assertTrustedFrontend($request);
        $validated = $request->validate([
            'expected_version' => ['required', 'integer', 'min:1'],
            'definition' => ['required', 'array'],
        ]);

        $draft = $drafts->replaceFromEditor(
            $this->editorSession($request),
            $validated['expected_version'],
            $validated['definition'],
        );

        return response()->json(['draft' => $drafts->serialize($draft)]);
    }

    public function claim(Request $request, AgentFormDraftService $drafts): JsonResponse
    {
        $this->assertTrustedFrontend($request);
        $validated = $request->validate([
            'expected_version' => ['required', 'integer', 'min:1'],
            'workspace_id' => ['required', 'integer', 'exists:workspaces,id'],
        ]);
        $workspace = Workspace::query()->findOrFail($validated['workspace_id']);
        $claimed = $drafts->claim(
            $this->editorSession($request),
            $validated['expected_version'],
            $workspace,
            $request->user(),
        );

        return response()->json([
            'form' => (new FormResource($claimed['form']))->setCleanings($claimed['cleanings']),
            'cleanings' => $claimed['cleanings'],
            'already_claimed' => $claimed['already_claimed'],
            'editor_url' => front_url('/forms/'.$claimed['form']->slug.'/edit'),
        ]);
    }

    private function assertTrustedFrontend(Request $request): void
    {
        $configuredSecret = (string) config('app.front_api_secret');
        $providedSecret = (string) $request->header('x-api-secret');

        abort_unless(
            $configuredSecret !== '' && hash_equals($configuredSecret, $providedSecret),
            Response::HTTP_FORBIDDEN,
        );
    }

    private function editorSession(Request $request): string
    {
        return (string) $request->header(self::SESSION_HEADER);
    }
}