crewli/api/app/FormBuilder/Purposes/PurposeRegistry.php

<?php

declare(strict_types=1);

namespace App\FormBuilder\Purposes;

use App\Enums\FormBuilder\FormSubmissionMode;
use App\FormBuilder\Purposes\Exceptions\PurposeNotFoundException;
use Illuminate\Contracts\Config\Repository as ConfigRepository;

final class PurposeRegistry
{
    /** @var array<string, PurposeDefinition>|null */
    private ?array $cache = null;

    public function __construct(private readonly ConfigRepository $config) {}

    /** @return array<string, PurposeDefinition> keyed by slug */
    public function all(): array
    {
        if ($this->cache !== null) {
            return $this->cache;
        }

        /** @var array<string, array<string, mixed>> $raw */
        $raw = (array) $this->config->get('form_builder.purposes', []);

        $definitions = [];
        foreach ($raw as $slug => $attrs) {
            $mode = $attrs['default_submission_mode'] ?? null;
            if (! $mode instanceof FormSubmissionMode) {
                throw new \InvalidArgumentException(
                    "Purpose '{$slug}' has invalid default_submission_mode; expected FormSubmissionMode enum case."
                );
            }

            $definitions[(string) $slug] = new PurposeDefinition(
                slug: (string) $slug,
                label: (string) ($attrs['label'] ?? ''),
                subjectType: (string) ($attrs['subject_type'] ?? ''),
                defaultSubmissionMode: $mode,
                allowsPublicAccess: (bool) ($attrs['allows_public_access'] ?? false),
                requiredBindings: array_values((array) ($attrs['required_bindings'] ?? [])),
            );
        }

        return $this->cache = $definitions;
    }

    public function get(string $slug): PurposeDefinition
    {
        $all = $this->all();
        if (! isset($all[$slug])) {
            throw PurposeNotFoundException::forSlug($slug);
        }

        return $all[$slug];
    }

    public function has(string $slug): bool
    {
        return isset($this->all()[$slug]);
    }

    /** @return list<string> unique sorted list of subject_type aliases */
    public function allSubjectTypes(): array
    {
        $types = array_values(array_unique(array_map(
            static fn (PurposeDefinition $p): string => $p->subjectType,
            $this->all(),
        )));
        sort($types);

        return $types;
    }

    /** @return list<string> slugs with allows_public_access === true */
    public function publicAccessibleSlugs(): array
    {
        return array_values(array_keys(array_filter(
            $this->all(),
            static fn (PurposeDefinition $p): bool => $p->allowsPublicAccess,
        )));
    }
}