feat(frontend): implement Top Functions endpoint in Profiler module

src/Handler/Router/Router.php

@@ -130,6 +130,69 @@ public static function new(string|object $classOrObject): self
             : self::newStatic($classOrObject);
     }
 
+    /**
+     * Convert query parameter to the specified type.
+     */
+    public static function convertQueryParam(
+        \ReflectionParameter $param,
+        array $params,
+    ): mixed {
+        $name = $param->getName();
+        $type = $param->getType();
+
+        $queryName = $queryParam->name ?? $name;
+        if (!isset($params[$queryName])) {
+            $param->isDefaultValueAvailable() or throw new \InvalidArgumentException(\sprintf(
+                'Query parameter `%s` is required.',
+                $queryName,
+            ));
+
+            return $param->getDefaultValue();
+        }
+
+        $value = $params[$queryName];
+        if ($type === null) {
+            return $value;
+        }
+
+        foreach (($type instanceof \ReflectionUnionType ? $type->getTypes() : [$type]) as $t) {
+            $typeString = \ltrim($t?->getName() ?? '', '?');
+            switch (true) {
+                case $typeString === 'mixed':
+                    return $value;
+                case $typeString === 'array':
+                    return (array) $value;
+                case $typeString === 'int':
+                    return (int) (\is_array($value)
+                        ? throw new \InvalidArgumentException(
+                            \sprintf(
+                                'Query parameter `%s` must be an integer, array given.',
+                                $queryName,
+                            ),
+                        )
+                        : $value);
+                case $typeString === 'string':
+                    return (string) (\is_array($value)
+                        ? throw new \InvalidArgumentException(
+                            \sprintf(
+                                'Query parameter `%s` must be a string, array given.',
+                                $queryName,
+                            ),
+                        )
+                        : $value);
+                default:
+                    continue 2;
+            }
+        }
+
+        throw new \InvalidArgumentException(\sprintf(
+            'Query parameter `%s` must be of type `%s`, `%s` given.',
+            $queryName,
+            $type,
+            \gettype($value),
+        ));
+    }
+
     /**
      * Find a route for specified method and path.
      *
@@ -180,7 +243,7 @@ public function match(Method $method, string $uri, ?\ReflectionMethod $mock = nu
                         $object,
                         \array_merge($args, \is_array($match) ? $match : []),
                         $get,
-                    )
+                    ),
                 ),
             };
         }
@@ -291,69 +354,6 @@ private static function resolveArguments(
         return $filteredArgs;
     }
 
-    /**
-     * Convert query parameter to the specified type.
-     */
-    public static function convertQueryParam(
-        \ReflectionParameter $param,
-        array $params,
-    ): mixed {
-        $name = $param->getName();
-        $type = $param->getType();
-
-        $queryName = $queryParam->name ?? $name;
-        if (!isset($params[$queryName])) {
-            $param->isDefaultValueAvailable() or throw new \InvalidArgumentException(\sprintf(
-                'Query parameter `%s` is required.',
-                $queryName,
-            ));
-
-            return $param->getDefaultValue();
-        }
-
-        $value = $params[$queryName];
-        if ($type === null) {
-            return $value;
-        }
-
-        foreach (($type instanceof \ReflectionUnionType ? $type->getTypes() : [$type]) as $t) {
-            $typeString = \ltrim($t?->getName() ?? '', '?');
-            switch (true) {
-                case $typeString === 'mixed':
-                    return $value;
-                case $typeString === 'array':
-                    return (array) $value;
-                case $typeString === 'int':
-                    return (int) (\is_array($value)
-                        ? throw new \InvalidArgumentException(
-                            \sprintf(
-                                'Query parameter `%s` must be an integer, array given.',
-                                $queryName,
-                            )
-                        )
-                        : $value);
-                case $typeString === 'string':
-                    return (string) (\is_array($value)
-                        ? throw new \InvalidArgumentException(
-                            \sprintf(
-                                'Query parameter `%s` must be a string, array given.',
-                                $queryName,
-                            )
-                        )
-                        : $value);
-                default:
-                    continue 2;
-            }
-        }
-
-        throw new \InvalidArgumentException(\sprintf(
-            'Query parameter `%s` must be of type `%s`, `%s` given.',
-            $queryName,
-            $type,
-            \gettype($value),
-        ));
-    }
-
     private static function doNothing(mixed ...$args): array
     {
         return $args;

src/Module/Frontend/Http/Router.php

@@ -8,7 +8,6 @@
 use Buggregator\Trap\Handler\Router\Method;
 use Buggregator\Trap\Handler\Router\Router as CommonRouter;
 use Buggregator\Trap\Logger;
-use Buggregator\Trap\Module\Frontend\EventStorage;
 use Buggregator\Trap\Module\Frontend\Service;
 use Buggregator\Trap\Support\Json;
 use Nyholm\Psr7\Response;

src/Module/Frontend/Module/Profiler/ApiController.php

@@ -16,7 +16,9 @@
 trait ApiController
 {
     private readonly Mapper $mapper;
+
     private readonly Logger $logger;
+
     private readonly EventStorage $eventsStorage;
 
     #[RegexpRoute(Method::Get, '#^api/profiler/(?<uuid>[a-f0-9-]++)/top$#i')]
@@ -27,7 +29,7 @@ trait ApiController
             [
                 'uuid' => '0190402f-7eb2-7287-82a8-897a0091f58e',
                 'metric' => 'excl_wt',
-            ]
+            ],
         ),
     ]
     public function profilerTop(string $uuid, #[QueryParam] string $metric = ''): Message\TopFunctions
@@ -47,7 +49,7 @@ public function profilerTop(string $uuid, #[QueryParam] string $metric = ''): Me
         AssertSuccess(
             Method::Get,
             'api/profiler/0190402f-7eb2-7287-82a8-897a0091f58e/call-graph',
-            ['uuid' => '0190402f-7eb2-7287-82a8-897a0091f58e']
+            ['uuid' => '0190402f-7eb2-7287-82a8-897a0091f58e'],
         ),
     ]
     public function profilerCallGraph(string $uuid): Message\CallGraph
@@ -65,7 +67,7 @@ public function profilerCallGraph(string $uuid): Message\CallGraph
         AssertSuccess(
             Method::Get,
             'api/profiler/0190402f-7eb2-7287-82a8-897a0091f58e/flame-chart',
-            ['uuid' => '0190402f-7eb2-7287-82a8-897a0091f58e']
+            ['uuid' => '0190402f-7eb2-7287-82a8-897a0091f58e'],
         ),
     ]
     public function profilerFlameChart(string $uuid): Message\FlameChart

src/Module/Frontend/Module/Profiler/Mapper.php

@@ -34,7 +34,78 @@ public function frameToEvent(\Buggregator\Trap\Proto\Frame\Profiler $frame): Eve
      */
     public function topFunctions(Event $event): TopFunctions
     {
-        return new TopFunctions();
+        $profile = $event->payload->getProfile();
+
+        // Get top
+        $top = [];
+        foreach ($profile->calls->all as $branch) {
+            // todo: limit with 100 and sort
+            $top[] = TopFunctions\Func::fromEdge($branch->item);
+        }
+
+        // Schema
+        $schema = new TopFunctions\Schema([
+            new TopFunctions\Column(
+                key: 'function',
+                label: 'Function',
+                sortable: false,
+                description: 'Function that was called',
+                values: [new TopFunctions\Value(key: 'function', format: 'string')],
+            ),
+            new TopFunctions\Column(
+                key: 'ct',
+                label: 'CT',
+                sortable: true,
+                description: 'Calls',
+                values: [new TopFunctions\Value(key: 'ct', format: 'number')],
+            ),
+            new TopFunctions\Column(
+                key: 'cpu',
+                label: 'CPU',
+                sortable: true,
+                description: 'CPU time (ms)',
+                values: [
+                    new TopFunctions\Value(key: 'cpu', format: 'ms'),
+                    new TopFunctions\Value(key: 'p_cpu', format: 'percent', type: 'sub'),
+                ],
+            ),
+            new TopFunctions\Column(
+                key: 'wt',
+                label: 'WT',
+                sortable: true,
+                description: 'Wall time (ms)',
+                values: [
+                    new TopFunctions\Value(key: 'wt', format: 'ms'),
+                    new TopFunctions\Value(key: 'p_wt', format: 'percent', type: 'sub'),
+                ],
+            ),
+            new TopFunctions\Column(
+                key: 'mu',
+                label: 'MU',
+                sortable: true,
+                description: 'Memory usage (bytes)',
+                values: [
+                    new TopFunctions\Value(key: 'mu', format: 'bytes'),
+                    new TopFunctions\Value(key: 'p_mu', format: 'percent', type: 'sub'),
+                ],
+            ),
+            new TopFunctions\Column(
+                key: 'pmu',
+                label: 'PMU',
+                sortable: true,
+                description: 'Peak memory usage (bytes)',
+                values: [
+                    new TopFunctions\Value(key: 'pmu', format: 'bytes'),
+                    new TopFunctions\Value(key: 'p_pmu', format: 'percent', type: 'sub'),
+                ],
+            ),
+        ]);
+
+        return new TopFunctions(
+            functions: $top,
+            overallTotals: $profile->peaks,
+            schema: $schema,
+        );
     }
 
     /**

src/Module/Frontend/Module/Profiler/Message/TopFunctions.php

@@ -9,11 +9,21 @@
  */
 final class TopFunctions implements \JsonSerializable
 {
+    /**
+     * @param list<TopFunctions\Func> $functions
+     */
     public function __construct(
+        private readonly array $functions,
+        private readonly \Buggregator\Trap\Module\Profiler\Struct\Peaks $overallTotals,
+        private readonly TopFunctions\Schema $schema,
     ) {}
 
     public function jsonSerialize(): array
     {
-        return [];
+        return [
+            'functions' => $this->functions,
+            'overall_totals' => $this->overallTotals,
+            'schema' => $this->schema,
+        ];
     }
 }

src/Module/Frontend/Module/Profiler/Message/TopFunctions/Column.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Buggregator\Trap\Module\Frontend\Module\Profiler\Message\TopFunctions;
+
+/**
+ * @internal
+ */
+final class Column implements \JsonSerializable
+{
+    /**
+     * @param list<Value> $values
+     */
+    public function __construct(
+        public readonly string $key,
+        public readonly string $label,
+        public readonly bool $sortable,
+        public readonly string $description,
+        public readonly array $values,
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'key' => $this->key,
+            'label' => $this->label,
+            'sortable' => $this->sortable,
+            'description' => $this->description,
+            'values' => $this->values,
+        ];
+    }
+}