Skip to content

A free open source IT asset/license management system

4.3 KB
Raw Blame
<?php

namespace App\Http\Transformers;

use App\Helpers\Helper;
use App\Models\LicenseSeat;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Gate;

class LicenseSeatsTransformer
{
    public function transformLicenseSeats(Collection $seats, $total)
    {
        $array = [];

        foreach ($seats as $seat) {
            $array[] = self::transformLicenseSeat($seat);
        }

        return (new DatatablesTransformer)->transformDatatables($array, $total);
    }

    public function transformLicenseSeat(LicenseSeat $seat)
    {
        $array = [
            'id' => (int) $seat->id,
            'license_id' => (int) $seat->license->id,
            'updated_at' => Helper::getFormattedDateObject($seat->updated_at, 'datetime'), // we use updated_at here because the record gets updated when it's checked in or out
            'assigned_user' => $this->transformAssignedUser($seat),
            'assigned_asset' => ($seat->asset) ? [
                'id' => (int) $seat->asset->id,
                'name' => e($seat->asset->present()->fullName),
                'created_at' => Helper::getFormattedDateObject($seat->created_at, 'datetime'),
            ] : null,
            'location' => ($seat->location()) ? [
                'id' => (int) $seat->location()->id,
                'name' => e($seat->location()->display_name),
                'tag_color' => $seat->location()->tag_color ? e($seat->location()->tag_color) : null,
                'created_at' => Helper::getFormattedDateObject($seat->created_at, 'datetime'),
            ] : null,
            'reassignable' => (bool) $seat->license->reassignable,
            'notes' => e($seat->notes),
            'user_can_checkout' => (($seat->assigned_to == '') && ($seat->asset_id == '')),
            'disabled' => $seat->unreassignable_seat || $seat->license->isInactive(),
        ];

        $permissions_array['available_actions'] = [
            'checkout' => Gate::allows('checkout', $seat->license),
            'checkin' => Gate::allows('checkin', $seat->license),
            'clone' => Gate::allows('clone', $seat->license),
            'update' => Gate::allows('update', $seat->license),
            'delete' => Gate::allows('delete', $seat->license),
            'bulk_selectable' => [
                'checkin' => Gate::allows('checkin', $seat->license) && ($seat->assigned_to || $seat->asset_id),
            ],
        ];

        $array += $permissions_array;

        return $array;
    }

    /**
     * Info-disclosure guard: a caller with licenses.view but not
     * users.view used to receive the assigned user's PII (email,
     * department, companies) inline in this block. Denied fallback keeps
     * id / type / name (display_name) because someone with licenses.view
     * legitimately needs to know WHO has the seat. What's stripped is
     * PII. Instance-scoped Gate check so FMCS scoping applies too.
     * The sibling assigned_asset / location blocks stay unguarded because
     * asset name and location name are basic identity, not PII, and
     * someone with licenses.view legitimately needs to know which asset
     * a seat is on and where.
     */
    private function transformAssignedUser(LicenseSeat $seat): ?array
    {
        if (! $seat->user) {
            return null;
        }

        if (Gate::denies('view', $seat->user)) {
            return [
                'id' => (int) $seat->user->id,
                'type' => 'user',
                'name' => e($seat->user->display_name),
            ];
        }

        return [
            'id' => (int) $seat->user->id,
            'name' => e($seat->user->present()->fullName),
            'email' => e($seat->user->email),
            'department' => ($seat->user->department) ? [
                'id' => (int) $seat->user->department->id,
                'name' => e($seat->user->department->name),
                'tag_color' => $seat->user->department->tag_color ? e($seat->user->department->tag_color) : null,
            ] : null,
            'companies' => $seat->user->companies->map(fn ($c) => [
                'id' => (int) $c->id,
                'name' => e($c->name),
                'tag_color' => $c->tag_color ? e($c->tag_color) : null,
            ])->values(),
            'created_at' => Helper::getFormattedDateObject($seat->created_at, 'datetime'),
        ];
    }
}