Skip to content

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.

feat(traffic): add traffic analytics DTOs

Aditya Tripathib4a5236e4e65
diff --git a/app/Data/Traffic/TrafficBreakdownData.php b/app/Data/Traffic/TrafficBreakdownData.php
new file mode 100644
index 0000000000..a98e5323a4
--- /dev/null
+++ b/app/Data/Traffic/TrafficBreakdownData.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Data\Traffic;
+
+use Spatie\LaravelData\Data;
+
+class TrafficBreakdownData extends Data
+{
+ public function __construct(
+ public string $value,
+ public int $requests,
+ public int $bytesOut,
+ ) {}
+
+ public static function fromSentinel(array $row): self
+ {
+ return new self(
+ value: (string) data_get($row, 'value', ''),
+ requests: (int) data_get($row, 'requests', 0),
+ bytesOut: (int) data_get($row, 'bytes_out', 0),
+ );
+ }
+}
diff --git a/app/Data/Traffic/TrafficOverviewData.php b/app/Data/Traffic/TrafficOverviewData.php
new file mode 100644
index 0000000000..2e48294cf4
--- /dev/null
+++ b/app/Data/Traffic/TrafficOverviewData.php
@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Data\Traffic;
+
+use Spatie\LaravelData\Data;
+
+class TrafficOverviewData extends Data
+{
+ public function __construct(
+ public int $requests,
+ public int $bytesIn,
+ public int $bytesOut,
+ public int $s2xx,
+ public int $s3xx,
+ public int $s4xx,
+ public int $s5xx,
+ public float $latencyP50,
+ public float $latencyP95,
+ public float $latencyP99,
+ public int $uniqueVisitors,
+ ) {}
+
+ public static function fromSentinel(array $json): self
+ {
+ return new self(
+ requests: (int) data_get($json, 'requests', 0),
+ bytesIn: (int) data_get($json, 'bytes_in', 0),
+ bytesOut: (int) data_get($json, 'bytes_out', 0),
+ s2xx: (int) data_get($json, 'status.s2xx', 0),
+ s3xx: (int) data_get($json, 'status.s3xx', 0),
+ s4xx: (int) data_get($json, 'status.s4xx', 0),
+ s5xx: (int) data_get($json, 'status.s5xx', 0),
+ latencyP50: (float) data_get($json, 'latency.p50', 0.0),
+ latencyP95: (float) data_get($json, 'latency.p95', 0.0),
+ latencyP99: (float) data_get($json, 'latency.p99', 0.0),
+ uniqueVisitors: (int) data_get($json, 'unique_visitors', 0),
+ );
+ }
+
+ public static function zero(): self
+ {
+ return new self(0, 0, 0, 0, 0, 0, 0, 0.0, 0.0, 0.0, 0);
+ }
+}
diff --git a/app/Data/Traffic/TrafficPathData.php b/app/Data/Traffic/TrafficPathData.php
new file mode 100644
index 0000000000..6716d7a193
--- /dev/null
+++ b/app/Data/Traffic/TrafficPathData.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Data\Traffic;
+
+use Spatie\LaravelData\Data;
+
+class TrafficPathData extends Data
+{
+ public function __construct(
+ public string $path,
+ public int $requests,
+ public int $bytesOut,
+ public float $p50,
+ public float $p95,
+ ) {}
+
+ public static function fromSentinel(array $row): self
+ {
+ return new self(
+ path: (string) data_get($row, 'path', ''),
+ requests: (int) data_get($row, 'requests', 0),
+ bytesOut: (int) data_get($row, 'bytes_out', 0),
+ p50: (float) data_get($row, 'p50', 0.0),
+ p95: (float) data_get($row, 'p95', 0.0),
+ );
+ }
+}
diff --git a/tests/Feature/TrafficAnalytics/TrafficDataTest.php b/tests/Feature/TrafficAnalytics/TrafficDataTest.php
new file mode 100644
index 0000000000..b5554a7888
--- /dev/null
+++ b/tests/Feature/TrafficAnalytics/TrafficDataTest.php
@@ -0,0 +1,21 @@
+<?php
+
+use App\Data\Traffic\TrafficOverviewData;
+
+it('maps a sentinel overview payload into a DTO', function () {
+ $json = [
+ 'requests' => 10, 'bytes_in' => 100, 'bytes_out' => 200,
+ 'status' => ['s2xx' => 8, 's3xx' => 1, 's4xx' => 1, 's5xx' => 0],
+ 'latency' => ['p50' => 12.5, 'p95' => 40.0, 'p99' => 90.0],
+ 'unique_visitors' => 5,
+ ];
+ $dto = TrafficOverviewData::fromSentinel($json);
+ expect($dto->requests)->toBe(10);
+ expect($dto->s4xx)->toBe(1);
+ expect($dto->latencyP95)->toBe(40.0);
+ expect($dto->uniqueVisitors)->toBe(5);
+});
+
+it('produces a zeroed overview', function () {
+ expect(TrafficOverviewData::zero()->requests)->toBe(0);
+});