Lesstime/src/Mcp/Tool/Serializer.php

<?php

declare(strict_types=1);

namespace App\Mcp\Tool;

use App\Entity\ClientTicket;
use App\Entity\Project;
use App\Entity\Task;
use App\Entity\TaskDocument;
use App\Entity\TaskEffort;
use App\Entity\TaskGroup;
use App\Entity\TaskPriority;
use App\Entity\TaskStatus;
use App\Entity\TaskTag;
use App\Entity\TimeEntry;
use App\Entity\User;
use Doctrine\Common\Collections\Collection;

/**
 * Shared serialization helpers for MCP tools.
 *
 * Keeps JSON output consistent across all tools.
 */
final class Serializer
{
    /**
     * @return array{id: ?int, code: ?string, name: ?string}
     */
    public static function projectRef(Project $project): array
    {
        return [
            'id'   => $project->getId(),
            'code' => $project->getCode(),
            'name' => $project->getName(),
        ];
    }

    /**
     * @return array<string, mixed>
     */
    public static function project(Project $project): array
    {
        return [
            'id'          => $project->getId(),
            'code'        => $project->getCode(),
            'name'        => $project->getName(),
            'description' => $project->getDescription(),
            'color'       => $project->getColor(),
            'client'      => $project->getClient() ? [
                'id'   => $project->getClient()->getId(),
                'name' => $project->getClient()->getName(),
            ] : null,
            'archived' => $project->isArchived(),
        ];
    }

    /**
     * @return null|array{id: ?int, label: ?string, color: ?string}
     */
    public static function status(?TaskStatus $status): ?array
    {
        if (null === $status) {
            return null;
        }

        return [
            'id'    => $status->getId(),
            'label' => $status->getLabel(),
            'color' => $status->getColor(),
        ];
    }

    /**
     * @return null|array{id: ?int, label: ?string, color: ?string, isFinal: bool}
     */
    public static function statusFull(?TaskStatus $status): ?array
    {
        if (null === $status) {
            return null;
        }

        return [
            'id'      => $status->getId(),
            'label'   => $status->getLabel(),
            'color'   => $status->getColor(),
            'isFinal' => $status->getIsFinal(),
        ];
    }

    /**
     * @return null|array{id: ?int, label: ?string, color: ?string}
     */
    public static function priority(?TaskPriority $priority): ?array
    {
        if (null === $priority) {
            return null;
        }

        return [
            'id'    => $priority->getId(),
            'label' => $priority->getLabel(),
            'color' => $priority->getColor(),
        ];
    }

    /**
     * @return null|array{id: ?int, label: ?string}
     */
    public static function effort(?TaskEffort $effort): ?array
    {
        if (null === $effort) {
            return null;
        }

        return [
            'id'    => $effort->getId(),
            'label' => $effort->getLabel(),
        ];
    }

    /**
     * @return null|array{id: ?int, username: ?string}
     */
    public static function user(?User $user): ?array
    {
        if (null === $user) {
            return null;
        }

        return [
            'id'       => $user->getId(),
            'username' => $user->getUsername(),
        ];
    }

    /**
     * @param Collection<int, User> $users
     *
     * @return list<array{id: ?int, username: ?string}>
     */
    public static function users(Collection $users): array
    {
        return $users->map(fn (User $u) => [
            'id'       => $u->getId(),
            'username' => $u->getUsername(),
        ])->toArray();
    }

    /**
     * @return null|array{id: ?int, title: ?string, color: ?string}
     */
    public static function group(?TaskGroup $group): ?array
    {
        if (null === $group) {
            return null;
        }

        return [
            'id'    => $group->getId(),
            'title' => $group->getTitle(),
            'color' => $group->getColor(),
        ];
    }

    /**
     * @return null|array{id: ?int, title: ?string}
     */
    public static function groupRef(?TaskGroup $group): ?array
    {
        if (null === $group) {
            return null;
        }

        return [
            'id'    => $group->getId(),
            'title' => $group->getTitle(),
        ];
    }

    /**
     * Full group serialization for MCP group tools (includes description, project, archived).
     *
     * @return array<string, mixed>
     */
    public static function groupFull(TaskGroup $group): array
    {
        return [
            'id'          => $group->getId(),
            'title'       => $group->getTitle(),
            'description' => $group->getDescription(),
            'color'       => $group->getColor(),
            'project'     => self::projectRef($group->getProject()),
            'archived'    => $group->isArchived(),
        ];
    }

    /**
     * @param Collection<int, TaskTag> $tags
     *
     * @return list<array{id: ?int, label: ?string}>
     */
    public static function tags(Collection $tags): array
    {
        return $tags->map(fn (TaskTag $t) => [
            'id'    => $t->getId(),
            'label' => $t->getLabel(),
        ])->toArray();
    }

    /**
     * @param Collection<int, TaskTag> $tags
     *
     * @return list<array{id: ?int, label: ?string, color: ?string}>
     */
    public static function tagsWithColor(Collection $tags): array
    {
        return $tags->map(fn (TaskTag $t) => [
            'id'    => $t->getId(),
            'label' => $t->getLabel(),
            'color' => $t->getColor(),
        ])->toArray();
    }

    /**
     * Compute duration in minutes between two timestamps, or null if still active.
     */
    public static function durationMinutes(TimeEntry $entry): ?int
    {
        $started = $entry->getStartedAt();
        $stopped = $entry->getStoppedAt();

        if (null === $stopped || null === $started) {
            return null;
        }

        return (int) round(($stopped->getTimestamp() - $started->getTimestamp()) / 60);
    }

    /**
     * @return null|array{id: ?int, number: ?int, title: ?string}
     */
    public static function taskRef(?Task $task): ?array
    {
        if (null === $task) {
            return null;
        }

        return [
            'id'     => $task->getId(),
            'number' => $task->getNumber(),
            'title'  => $task->getTitle(),
        ];
    }

    /**
     * @return null|array{id: ?int, number: ?int, title: ?string}
     */
    public static function clientTicketRef(?ClientTicket $ticket): ?array
    {
        if (null === $ticket) {
            return null;
        }

        return [
            'id'     => $ticket->getId(),
            'number' => $ticket->getNumber(),
            'title'  => $ticket->getTitle(),
        ];
    }

    /**
     * @return array<string, mixed>
     */
    public static function timeEntry(TimeEntry $entry): array
    {
        return [
            'id'           => $entry->getId(),
            'title'        => $entry->getTitle(),
            'description'  => $entry->getDescription(),
            'startedAt'    => $entry->getStartedAt()?->format('c'),
            'stoppedAt'    => $entry->getStoppedAt()?->format('c'),
            'duration'     => self::durationMinutes($entry),
            'user'         => self::user($entry->getUser()),
            'project'      => $entry->getProject() ? self::projectRef($entry->getProject()) : null,
            'task'         => self::taskRef($entry->getTask()),
            'clientTicket' => self::clientTicketRef($entry->getClientTicket()),
            'tags'         => self::tags($entry->getTags()),
        ];
    }

    /**
     * @param Collection<int, TaskDocument> $documents
     *
     * @return list<array<string, mixed>>
     */
    public static function documents(Collection $documents): array
    {
        return $documents->map(fn (TaskDocument $doc) => [
            'id'           => $doc->getId(),
            'originalName' => $doc->getOriginalName(),
            'mimeType'     => $doc->getMimeType(),
            'size'         => $doc->getSize(),
            'createdAt'    => $doc->getCreatedAt()?->format('c'),
            'uploadedBy'   => self::user($doc->getUploadedBy()),
        ])->toArray();
    }
}