breadcrumb-the-shire/lib/Repository/Access/RoleRepository.php

<?php

namespace MintyPHP\Repository\Access;

use MintyPHP\DB;
use MintyPHP\Repository\Support\RepoQuery;
use MintyPHP\Repository\Support\RepositoryArrayHelper;

/** Reads and writes role records with pagination, search, and code uniqueness checks. */
class RoleRepository implements RoleRepositoryInterface
{
    public function list(): array
    {
        $rows = DB::select(
            'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles order by id desc'
        );
        return RepositoryArrayHelper::unwrapList($rows, 'roles');
    }

    public function listActive(): array
    {
        $rows = DB::select(
            'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles where active = 1 order by description asc'
        );
        return RepositoryArrayHelper::unwrapList($rows, 'roles');
    }

    public function listByIds(array $roleIds): array
    {
        $roleIds = RepositoryArrayHelper::sanitizePositiveIds($roleIds);
        if (!$roleIds) {
            return [];
        }

        $placeholders = implode(',', array_fill(0, count($roleIds), '?'));
        $rows = DB::select(
            'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles where id in (' . $placeholders . ')',
            ...array_map('strval', $roleIds)
        );
        return RepositoryArrayHelper::unwrapList($rows, 'roles');
    }

    public function listIds(): array
    {
        $rows = DB::select('select id from roles');

        return RepositoryArrayHelper::extractIds($rows, 'roles');
    }

    public function listActiveIds(): array
    {
        $rows = DB::select('select id from roles where active = 1');

        return RepositoryArrayHelper::extractIds($rows, 'roles');
    }

    public function listPaged(array $options): array
    {
        $search = trim((string) ($options['search'] ?? ''));
        $allowedOrder = ['id', 'uuid', 'description', 'code', 'active', 'created', 'modified'];
        [$limit, $offset] = RepoQuery::sanitizeLimitOffset($options);
        [$order, $dir] = RepoQuery::sanitizeOrder($options, $allowedOrder);

        $where = [];
        $params = [];
        RepoQuery::addLikeFilter($where, $params, ['description', 'uuid', 'code'], $search);
        $activeValue = array_key_exists('active', $options) ? $options['active'] : null;
        RepoQuery::addEnumFilter($where, $params, $activeValue, [
            ['aliases' => ['1', 'true', 'active'], 'sql' => 'roles.active = 1'],
            ['aliases' => ['0', 'false', 'inactive'], 'sql' => 'roles.active = 0'],
        ]);

        $whereSql = $where ? (' where ' . implode(' and ', $where)) : '';
        $count = DB::selectValue('select count(*) from roles' . $whereSql, ...$params);
        $total = $count ? (int) $count : 0;

        $query = 'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles' .
            $whereSql .
            sprintf(' order by `%s` %s limit ? offset ?', $order, $dir);

        $queryParams = array_merge($params, [(string) $limit, (string) $offset]);
        $rows = call_user_func_array(['MintyPHP\\DB', 'select'], array_merge([$query], $queryParams));

        return [
            'total' => $total,
            'rows' => RepositoryArrayHelper::unwrapList($rows, 'roles'),
        ];
    }

    public function find(int $id): ?array
    {
        $row = DB::selectOne(
            'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles where id = ? limit 1',
            (string) $id
        );
        return RepositoryArrayHelper::unwrap($row, 'roles');
    }

    public function findByUuid(string $uuid): ?array
    {
        $row = DB::selectOne(
            'select id, uuid, description, code, active, created_by, modified_by, created, modified from roles where uuid = ? limit 1',
            $uuid
        );
        return RepositoryArrayHelper::unwrap($row, 'roles');
    }

    public function existsByCode(string $code, int $excludeId = 0): bool
    {
        $code = trim($code);
        if ($code === '') {
            return false;
        }
        if ($excludeId > 0) {
            $count = DB::selectValue('select count(*) from roles where code = ? and id != ?', $code, (string) $excludeId);
        } else {
            $count = DB::selectValue('select count(*) from roles where code = ?', $code);
        }
        return $count ? ((int) $count > 0) : false;
    }

    public function create(array $data): int|false
    {
        return DB::insert(
            'insert into roles (uuid, description, code, active, created_by, created) values (?,?,?,?,?,NOW())',
            $data['uuid'] ?? RepoQuery::uuidV4(),
            $data['description'],
            $data['code'] ?? null,
            $data['active'] ?? 1,
            $data['created_by'] ?? null
        );
    }

    public function update(int $id, array $data): bool
    {
        $fields = [
            'description' => $data['description'],
            'code' => $data['code'] ?? null,
            'active' => $data['active'] ?? 1,
        ];
        if (array_key_exists('modified_by', $data)) {
            $fields['modified_by'] = $data['modified_by'];
        }

        $setParts = [];
        $params = [];
        foreach ($fields as $field => $value) {
            $setParts[] = sprintf('`%s` = ?', $field);
            $params[] = $value;
        }
        $params[] = (string) $id;

        $query = 'update roles set ' . implode(', ', $setParts) . ' where id = ?';
        $result = DB::update($query, ...$params);
        return $result !== false;
    }

    public function delete(int $id): bool
    {
        $result = DB::delete('delete from roles where id = ?', (string) $id);
        return $result !== false;
    }
}