@fleetbase/fleetops-engine 0.6.65 → 0.6.66

package/server/tests/InspectionSubmitterRulesTest.php

@@ -0,0 +1,47 @@
+<?php
+
+use Fleetbase\FleetOps\Support\InspectionSubmitter;
+
+/*
+ * The public link and `POST /v1/inspections` both hand the submitter what
+ * validate() returns, and validate() returns only keys that have a rule: once
+ * an array has nested rules, its other keys are dropped. `value` had no rule of
+ * its own, so every answer reached the submitter empty and a failed check
+ * carrying its photo was refused for having none.
+ *
+ * The rules are checked here rather than run through a validator, which this
+ * package does not install.
+ */
+test('the submitter rules give every key of an answer a rule of its own', function () {
+    $rules = InspectionSubmitter::rules();
+
+    expect($rules)->toHaveKeys([
+        // What the API documents.
+        'answers',
+        'answers.*.field',
+        'answers.*.custom_field',
+        'answers.*.value',
+        'answers.*.value_type',
+        // What the first cut shipped, still accepted.
+        'custom_field_values',
+        'custom_field_values.*.custom_field',
+        'custom_field_values.*.custom_field_uuid',
+        'custom_field_values.*.value',
+        'custom_field_values.*.value_type',
+    ]);
+
+    // Either spelling satisfies the requirement, and so does a flat body.
+    expect($rules['answers'])->toContain('required_without_all:item_results,custom_field_values')
+        ->and($rules['custom_field_values'])->toContain('required_without_all:item_results,answers')
+        ->and($rules['item_results'])->toContain('required_without_all:custom_field_values,answers');
+
+    // An empty answer is still an answer (it clears the field), so the value
+    // is allowed to be null rather than required.
+    expect($rules['custom_field_values.*.value'])->toBe('nullable')
+        ->and($rules['custom_field_values.*.custom_field_uuid'])->toContain('nullable');
+
+    // Every key of a flat item result has a rule too, so none of them is dropped.
+    foreach (['item_key', 'label', 'category', 'status', 'severity', 'passed', 'comments', 'photos'] as $key) {
+        expect($rules)->toHaveKey('item_results.*.' . $key);
+    }
+});

package/server/tests/ObserverContractsTest.php

@@ -744,7 +744,7 @@ test('work order observer creates maintenance resets schedule and dispatches com
             'maintainable_type' => 'fleet-ops:vehicle',
             'maintainable_uuid' => 'vehicle-uuid',
             'type'              => 'scheduled',
-            'status'            => 'done',
+            'status'            => 'completed',
             'priority'          => 'high',
             'performed_by_type' => 'fleet-ops:contact',
             'performed_by_uuid' => 'assignee-uuid',

package/server/tests/QueueJobContractsTest.php

@@ -713,12 +713,11 @@ test('sync fuel provider transactions job passes parsed dates and records failur
         ->and($connection->updates[0])->toMatchArray([
             'status'          => 'error',
             'last_error'      => 'provider failed',
-            'last_sync_state' => [
-                'failed_at' => '2026-05-01T12:00:00+00:00',
-                'message'   => 'provider failed',
-            ],
         ]);
 
+    expect($connection->updates[0])->not->toHaveKey('last_sync_state');
+    expect($job->middleware()[0])->toBeInstanceOf(Illuminate\Queue\Middleware\WithoutOverlapping::class);
+
     Carbon::setTestNow();
 });
 

package/server/tests/RadarRoutesTest.php

@@ -0,0 +1,35 @@
+<?php
+
+test('radar routes are registered beside the hubs', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)
+        ->toContain("['prefix' => 'radar']")
+        ->toContain("\$router->get('items', 'RadarController@items');")
+        ->toContain("\$router->get('summary', 'RadarController@summary');")
+        ->toContain("\$router->get('briefing', 'RadarController@briefing');")
+        ->toContain("\$router->get('agenda', 'RadarController@agenda');")
+        ->toContain("\$router->get('handovers/{key}', 'RadarController@handoverSuggest');")
+        ->toContain("\$router->post('shifts/{id}/extend', 'RadarController@extendShift');")
+        ->toContain("\$router->post('items/bulk', 'RadarController@bulk');")
+        ->toContain("\$router->post('items/{key}/acknowledge', 'RadarController@acknowledge');")
+        ->toContain("\$router->post('items/{key}/snooze', 'RadarController@snooze');")
+        ->toContain("\$router->post('items/{key}/wake', 'RadarController@wake');")
+        ->toContain("\$router->post('items/{key}/assign', 'RadarController@assign');")
+        ->toContain("\$router->post('items/{key}/plan', 'RadarController@plan');")
+        ->toContain("\$router->post('items/{key}/resolve', 'RadarController@resolve');")
+        ->toContain("\$router->post('notices', 'RadarController@storeNotice');")
+        ->toContain("\$router->delete('notices/{id}', 'RadarController@destroyNotice');");
+
+    // The bulk route is declared before the keyed routes so `items/bulk`
+    // is never read as a key called "bulk".
+    expect(strpos($routes, 'items/bulk'))->toBeLessThan(strpos($routes, 'items/{key}/acknowledge'));
+});
+
+test('radar controller exposes every routed action', function () {
+    $controller = new ReflectionClass(Fleetbase\FleetOps\Http\Controllers\Internal\v1\RadarController::class);
+
+    foreach (['items', 'summary', 'briefing', 'agenda', 'handoverSuggest', 'extendShift', 'bulk', 'acknowledge', 'snooze', 'wake', 'assign', 'plan', 'resolve', 'storeNotice', 'destroyNotice'] as $method) {
+        expect($controller->hasMethod($method))->toBeTrue("RadarController@{$method} is routed but missing");
+    }
+});

package/server/tests/ReportSchemaContractsTest.php

@@ -219,6 +219,9 @@ test('fleetops report schema registers every table with columns computed columns
         'contacts',
         'vendors',
         'fuel_reports',
+        'work_orders',
+        'maintenances',
+        'inspection_submissions',
     ]);
 
     $orders = $tables['orders'];
@@ -248,7 +251,18 @@ test('fleetops report schema registers every table with columns computed columns
         ->and(fleetOpsReportTableMeta($tables['places'], 'category'))->toBe('Geography')
         ->and(fleetOpsReportTableMeta($tables['contacts'], 'category'))->toBe('CRM')
         ->and(fleetOpsReportTableMeta($tables['vendors'], 'category'))->toBe('CRM')
-        ->and(fleetOpsReportTableMeta($tables['fuel_reports'], 'category'))->toBe('Operations');
+        ->and(fleetOpsReportTableMeta($tables['fuel_reports'], 'category'))->toBe('Operations')
+        ->and(fleetOpsReportTableMeta($tables['work_orders'], 'category'))->toBe('Maintenance')
+        ->and(fleetOpsReportTableName(fleetOpsReportRelationship($tables['work_orders'], 'vehicle_target')))->toBe('vehicles')
+        ->and(fleetOpsReportColumnAggregate(fleetOpsReportColumn($tables['work_orders'], 'total_actual_cost')))->toBe('sum')
+        ->and(fleetOpsReportTableMeta($tables['maintenances'], 'label'))->toBe('Maintenance History')
+        ->and(fleetOpsReportTableName(fleetOpsReportRelationship($tables['maintenances'], 'work_order')))->toBe('work_orders')
+        ->and(fleetOpsReportTableMeta($tables['inspection_submissions'], 'label'))->toBe('Inspections')
+        ->and(fleetOpsReportTableMeta($tables['inspection_submissions'], 'category'))->toBe('Maintenance')
+        ->and(fleetOpsReportColumnFlag(fleetOpsReportColumn($tables['inspection_submissions'], 'result'), 'aggregatable'))->toBeTrue()
+        ->and(fleetOpsReportColumnAggregate(fleetOpsReportColumn($tables['inspection_submissions'], 'total_failed_items')))->toBe('sum')
+        ->and(fleetOpsReportTableName(fleetOpsReportRelationship($tables['inspection_submissions'], 'inspection_form')))->toBe('inspection_forms')
+        ->and(fleetOpsReportTableName(fleetOpsReportRelationship($tables['inspection_submissions'], 'work_order')))->toBe('work_orders');
 });
 
 test('fleetops report schema transformers normalize labels booleans distances and money', function () {

package/server/tests/RouteRegistrationExecutionTest.php

@@ -1,6 +1,35 @@
 <?php
 
 use Illuminate\Support\Facades\Route;
+use Illuminate\Support\Str;
+
+/**
+ * One recorded route, handed back so the route file can chain onto it as it
+ * would onto a real one. `middleware()` is recorded against the route; any
+ * other chained call (`name()`, `where()`) is accepted and ignored, so a chain
+ * the recorder does not model cannot break the whole file.
+ */
+class FleetOpsRecordedRoute
+{
+    public function __construct(private FleetOpsRouteRecorder $recorder, private int $index)
+    {
+    }
+
+    public function middleware(array|string $middleware): self
+    {
+        $this->recorder->routes[$this->index]['middleware'] = array_merge(
+            $this->recorder->routes[$this->index]['middleware'] ?? [],
+            (array) $middleware,
+        );
+
+        return $this;
+    }
+
+    public function __call(string $method, array $arguments): self
+    {
+        return $this;
+    }
+}
 
 class FleetOpsRouteRecorder
 {
@@ -49,47 +78,69 @@ class FleetOpsRouteRecorder
         return $this;
     }
 
-    public function get(string $uri, string|array $action): void
+    public function get(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('GET', $uri, $action);
+        return $this->record('GET', $uri, $action);
     }
 
-    public function post(string $uri, string|array $action): void
+    public function post(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('POST', $uri, $action);
+        return $this->record('POST', $uri, $action);
     }
 
-    public function put(string $uri, string|array $action): void
+    public function put(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('PUT', $uri, $action);
+        return $this->record('PUT', $uri, $action);
     }
 
-    public function patch(string $uri, string|array $action): void
+    public function patch(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('PATCH', $uri, $action);
+        return $this->record('PATCH', $uri, $action);
     }
 
-    public function delete(string $uri, string|array $action): void
+    public function delete(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('DELETE', $uri, $action);
+        return $this->record('DELETE', $uri, $action);
     }
 
-    public function any(string $uri, string|array $action): void
+    public function any(string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record('ANY', $uri, $action);
+        return $this->record('ANY', $uri, $action);
     }
 
-    public function match(array $methods, string $uri, string|array $action): void
+    public function match(array $methods, string $uri, string|array $action): FleetOpsRecordedRoute
     {
-        $this->record(implode('|', array_map('strtoupper', $methods)), $uri, $action);
+        return $this->record(implode('|', array_map('strtoupper', $methods)), $uri, $action);
     }
 
-    public function fleetbaseRoutes(string $resource): void
+    /**
+     * The platform's resource routes, and the extra routes a resource declares
+     * in its callback. The callback is run inside a group prefixed with the
+     * resource, as the platform's macro does, and handed a `$controller` that
+     * names the action the way the macro would, so those routes are recorded
+     * rather than silently skipped.
+     */
+    public function fleetbaseRoutes(string $resource, ?callable $callback = null): FleetOpsRecordedRoute
     {
-        $this->record('FLEETBASE', $resource, 'fleetbaseRoutes');
+        $route = $this->record('FLEETBASE', $resource, 'fleetbaseRoutes');
+
+        if ($callback) {
+            $controllerName = Str::studly(Str::singular($resource)) . 'Controller';
+            $this->group(['prefix' => $resource], function ($router) use ($callback, $controllerName) {
+                $callback($router, fn (string $method) => $controllerName . '@' . $method);
+            });
+        }
+
+        return $route;
+    }
+
+    /** Router methods the recorder does not model are accepted and ignored. */
+    public function __call(string $method, array $arguments): self
+    {
+        return $this;
     }
 
-    private function record(string $method, string $uri, string|array $action): void
+    private function record(string $method, string $uri, string|array $action): FleetOpsRecordedRoute
     {
         $prefixes = array_values(array_filter(array_map(
             fn (array $group) => $group['prefix'] ?? null,
@@ -102,6 +153,8 @@ class FleetOpsRouteRecorder
             'action' => $action,
             'groups' => $this->stack,
         ];
+
+        return new FleetOpsRecordedRoute($this, array_key_last($this->routes));
     }
 }
 
@@ -139,7 +192,37 @@ test('fleetops route file registers public internal analytics metrics and hub ro
         ->toContain('v1/fuel-transactions/{id}/match-vehicle')
         ->toContain('int/v1/fleet-ops/analytics/operations-pulse')
         ->toContain('int/v1/fleet-ops/metrics/{slug}')
-        ->toContain('int/v1/fleet-ops/hubs/resources');
+        ->toContain('int/v1/fleet-ops/hubs/resources')
+        ->toContain('public/inspections/forms/{id}')
+        ->toContain('public/inspections/forms/{id}/submit')
+        ->toContain('public/inspections/forms/{id}/files');
+
+    // A link's PIN can be sent again from the console.
+    $sendPin = array_values(array_filter($recorder->routes, fn (array $route) => str_ends_with($route['uri'], 'inspection-forms/{id}/links/{linkId}/send-pin')));
+    expect($sendPin)->toHaveCount(1)
+        ->and($sendPin[0]['method'])->toBe('POST')
+        ->and($sendPin[0]['action'])->toBe('InspectionFormController@sendPin');
+
+    // Every inspection route answers in JSON, so a refused request is a 422
+    // rather than a redirect: the driver API, the vehicle history and the
+    // console's form and submission routes.
+    $json    = Fleetbase\FleetOps\Http\Middleware\ForceJsonResponse::class;
+    $inGroup = fn (array $route) => in_array($json, array_merge(...array_map(fn ($group) => (array) ($group['middleware'] ?? []), $route['groups'])), true)
+        || in_array($json, (array) ($route['middleware'] ?? []), true);
+    foreach (['InspectionController@findForm', 'InspectionController@submit', 'InspectionController@forVehicle'] as $action) {
+        $route = collect($recorder->routes)->first(fn (array $route) => $route['action'] === $action);
+        expect($route)->not->toBeNull()
+            ->and($inGroup($route))->toBeTrue();
+    }
+    $console = array_filter($recorder->routes, fn (array $route) => str_contains($route['uri'], 'inspection-forms/{id}/generate-link') || str_contains($route['uri'], 'inspection-submissions/{id}/submit'));
+    expect($console)->toHaveCount(2);
+    foreach ($console as $route) {
+        expect($inGroup($route))->toBeTrue();
+    }
+
+    // Uploads through a link have a tighter limit of their own, on top of the group's.
+    $upload = collect($recorder->routes)->firstWhere('uri', 'public/inspections/forms/{id}/files');
+    expect($upload['middleware'] ?? [])->toBe(['throttle:20,1,inspection-upload']);
 });
 
 test('fleetops route file wires route groups with expected middleware and namespaces', function () {
@@ -156,6 +239,14 @@ test('fleetops route file wires route groups with expected middleware and namesp
         'namespace'  => 'Api\v1',
     ]);
 
+    // The public inspection routes answer in JSON whatever the client asks
+    // for, and are rate limited per address.
+    expect($recorder->groups)->toContainEqual([
+        'prefix'     => 'public',
+        'namespace'  => 'Public',
+        'middleware' => [Fleetbase\FleetOps\Http\Middleware\ForceJsonResponse::class, 'throttle:60,1,inspection-public'],
+    ]);
+
     expect($recorder->groups)->toContainEqual([
         'prefix'    => 'int',
         'namespace' => 'Internal',

package/server/tests/Support/AfaqyTestCrypto.php

@@ -0,0 +1,27 @@
+<?php
+
+// Package fixtures use authenticated OpenSSL encryption at the Crypt boundary.
+// Production resolves Laravel's encrypter from the host application.
+function afaqyTestCrypto(): object
+{
+    return new class {
+        public function encryptString(string $value): string
+        {
+            $iv     = random_bytes(12);
+            $cipher = openssl_encrypt($value, 'aes-256-gcm', str_repeat('t', 32), OPENSSL_RAW_DATA, $iv, $tag);
+
+            return base64_encode($iv . $tag . $cipher);
+        }
+
+        public function decryptString(string $value): string
+        {
+            $bytes = base64_decode($value, true);
+            $plain = openssl_decrypt(substr($bytes, 28), 'aes-256-gcm', str_repeat('t', 32), OPENSSL_RAW_DATA, substr($bytes, 0, 12), substr($bytes, 12, 16));
+            if ($plain === false) {
+                throw new RuntimeException('Invalid encrypted fixture.');
+            }
+
+            return $plain;
+        }
+    };
+}

package/server/tests/Support/ExampleTelemetryProvider.php

@@ -0,0 +1,82 @@
+<?php
+
+use Fleetbase\FleetOps\Contracts\TelemetryProviderInterface;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Support\Telematics\Providers\AbstractProvider;
+use Fleetbase\FleetOps\Support\Telematics\Telemetry\Sample;
+
+/** Deliberately uses a protocol unrelated to any bundled vendor. */
+class ExampleTelemetryProvider extends AbstractProvider implements TelemetryProviderInterface
+{
+    public static int $connections = 0;
+    public static array $pages     = [];
+
+    protected function prepareAuthentication(): void
+    {
+    }
+
+    public function connect(Telematic $telematic): void
+    {
+        self::$connections++;
+    }
+
+    public function testConnection(array $credentials): array
+    {
+        return ['success' => true];
+    }
+
+    public function fetchDevices(array $options = []): array
+    {
+        return array_shift(self::$pages);
+    }
+
+    public function fetchDeviceDetails(string $externalId): array
+    {
+        return [];
+    }
+
+    public function normalizeSensor(array $payload): array
+    {
+        return $payload;
+    }
+
+    public function supportsWebhooks(): bool
+    {
+        return true;
+    }
+
+    public function telemetryOptions(): array
+    {
+        return ['polling_enabled' => true, 'webhooks_enabled' => true, 'page_size' => 2, 'stale_engine_on_seconds' => 90];
+    }
+
+    public function telemetryUnits(array $payload): array
+    {
+        $samples = $payload['signals'] ?? (isset($payload['tracker']) ? [$payload] : $payload);
+        foreach ($samples as $sample) {
+            if (!is_array($sample) || !isset($sample['tracker'], $sample['measured'], $sample['point'])) {
+                throw new InvalidArgumentException('Unsupported signal');
+            }
+        }
+
+        return $samples;
+    }
+
+    public function normalizeDevice(array $payload): array
+    {
+        return ['device_id' => $payload['tracker'], 'last_seen_at' => Sample::timestamp($payload['received']), 'meta' => []];
+    }
+
+    public function normalizeEvent(array $payload): array
+    {
+        return ['device_id' => $payload['tracker'], 'event_type' => 'telemetry_update',
+            'occurred_at'   => Sample::timestamp($payload['measured']), 'last_seen_at' => Sample::timestamp($payload['received']),
+            'location'      => ['lat' => $payload['point'][1], 'lng' => $payload['point'][0]], 'ignition' => true,
+            'meta'          => ['telemetry' => ['provider_at' => Sample::timestamp($payload['received'])]]];
+    }
+
+    public function normalizeTelemetrySnapshot(array $payload): array
+    {
+        return ['device' => $this->normalizeDevice($payload), 'event' => $this->normalizeEvent($payload), 'sensors' => []];
+    }
+}

package/server/tests/Support/TelemetryTestEnvironment.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Fleetbase\FleetOps\Jobs {
+    // Advance the polling deadline deterministically without sleeping in tests.
+    function microtime($asFloat = false)
+    {
+        if (!empty($GLOBALS['telemetry_test_clock'])) {
+            return array_shift($GLOBALS['telemetry_test_clock']);
+        }
+
+        return \microtime($asFloat);
+    }
+}
+
+namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1 {
+    // The package test container does not include Foundation HTTP helpers.
+    function abort_unless($condition, $code, $message = '', array $headers = [])
+    {
+        if (!$condition) {
+            throw new \Symfony\Component\HttpKernel\Exception\HttpException($code, $message, null, $headers);
+        }
+    }
+}
+
+namespace Fleetbase\Support {
+    function app($abstract = null, array $parameters = [])
+    {
+        if ($abstract !== null) {
+            return \app($abstract, $parameters);
+        }
+
+        return new class() {
+            public function environment($environments = null)
+            {
+                $environment = \config('app.env', 'production');
+
+                return $environments === null ? $environment : in_array($environment, (array) $environments, true);
+            }
+
+            public function __call($method, $arguments)
+            {
+                return \app()->{$method}(...$arguments);
+            }
+        };
+    }
+
+    function url($path, $parameters = [], $secure = null)
+    {
+        $generator = new \Illuminate\Routing\UrlGenerator(new \Illuminate\Routing\RouteCollection(), \Illuminate\Http\Request::create('https://api.example.test'));
+
+        return $generator->to($path, $parameters, $secure);
+    }
+}

package/server/tests/TelematicsHardeningTest.php

@@ -300,7 +300,8 @@ test('telematics service requires provider identity and stores idempotent event
         ->toContain('$event->createPosition($positionData)')
         ->toContain('updateVehicleTelemetry')
         ->toContain('$vehicle->odometer = $eventData[\'odometer\'];')
-        ->toContain('broadcast(new VehicleLocationChanged')
+        ->toContain('new VehicleLocationChanged')
+        ->toContain('broadcastTelemetry')
         ->toContain("'heading'   => \$eventData['heading'] ?? null")
         ->toContain("'bearing'   => \$eventData['heading'] ?? null")
         ->toContain("'speed'     => \$eventData['speed'] ?? null")
@@ -1412,20 +1413,19 @@ test('afaqy sync stores compact device diagnostics and paginates complete units
         ->toContain("'provider_code'")
         ->toContain("'provider_message'")
         ->toContain("'retry_attempted'")
-        ->toContain('?? 500), 500')
+        ->toContain('?? 1000), 1000')
         ->toContain('if (is_array($filters) && empty($filters))')
         ->toContain('$filters = new \stdClass();')
         ->toContain("'limit'      => \$limit")
         ->toContain("'offset'     => \$offset")
         ->not->toContain("\n            'limit'  => \$limit,\n            'offset' => \$offset,")
         ->toContain("\$this->afaqyPost('/units/lists', [")
-        ->toContain('], true);')
+        ->toContain("'simplify'   => 0")
         ->toContain("http_build_query(['token' => \$this->credentials['token']])")
         ->toContain("\$body = \$tokenInQuery ? \$payload : array_merge(['token' => \$this->credentials['token']], \$payload)")
         ->toContain('$pageOffset  = (int) ($pagination[\'offset\'] ?? $offset);')
         ->toContain('$pageLimit   = (int) ($pagination[\'limit\'] ?? $limit);')
-        ->toContain('$advanceBy   = $resultCount > 0 ? $resultCount : max($pageLimit, count($devices), 1);')
-        ->toContain('$nextCursor  = ($pageOffset + $advanceBy) < $total ? $pageOffset + $advanceBy : null;')
+        ->toContain('AFAQY returned inconsistent pagination; sweep incomplete.')
         ->toContain("'requested_limit'")
         ->toContain("'provider_limit'")
         ->toContain("'provider_result_count'")
@@ -1433,8 +1433,8 @@ test('afaqy sync stores compact device diagnostics and paginates complete units
         ->toContain("'allCount'")
         ->toContain("'filtersCount'")
         ->toContain("'resultCount'")
-        ->toContain("'online'      => \$payload['active'] ?? null")
-        ->toContain("'altitude'   => \$lastUpdate['alt'] ?? null");
+        ->toContain("'online'      => null")
+        ->toContain('normalizeEvent');
 });
 
 test('afaqy sensors normalize stable parent scoped identities and latest values', function () {
@@ -1471,7 +1471,7 @@ test('afaqy sensors normalize stable parent scoped identities and latest values'
         'value'       => 'Open',
         'status'      => 'active',
     ]);
-    expect($open['recorded_at'])->toBe('2026-06-23 09:00:00');
+    expect($open['recorded_at'])->toBe('2026-06-23T09:00:00.000000Z');
     expect(data_get($open, 'meta.provider'))->toBe('afaqy');
     expect(data_get($open, 'meta.unit_id'))->toBe('unit-123');
     expect($closed['internal_id'])->toBe($open['internal_id']);
@@ -1494,7 +1494,7 @@ test('afaqy sensors reject event shaped payloads without scalar sensor values',
 });
 
 test('afaqy provider helpers build authenticated requests and sanitized diagnostics', function () {
-    Carbon::setTestNow(Carbon::parse('2026-06-23 10:00:00'));
+    Carbon::setTestNow(Carbon::parse('2026-06-23T10:00:00.000000Z'));
 
     try {
         $provider = new FleetOpsAfaqyProviderProbe();
@@ -1522,8 +1522,8 @@ test('afaqy provider helpers build authenticated requests and sanitized diagnost
             ->and($provider->providerErrorMessageForTest(['error_description' => 'Description failure']))->toBe('Description failure')
             ->and($provider->providerErrorMessageForTest(['error' => ['not_scalar' => true]]))->toBeNull()
             ->and($provider->parseTimestampForTest(null))->toBeNull()
-            ->and($provider->parseTimestampForTest(1719136800000))->toBe('2024-06-23 10:00:00')
-            ->and($provider->parseTimestampForTest('2026-06-23T09:00:00Z'))->toBe('2026-06-23 09:00:00')
+            ->and($provider->parseTimestampForTest(1719136800000))->toBe('2024-06-23T10:00:00.000000Z')
+            ->and($provider->parseTimestampForTest('2026-06-23T09:00:00Z'))->toBe('2026-06-23T09:00:00.000000Z')
             ->and($provider->compactLastUpdateForTest([
                 'dtt'    => '2026-06-23T09:00:00Z',
                 'lat'    => 25.2,
@@ -1533,7 +1533,7 @@ test('afaqy provider helpers build authenticated requests and sanitized diagnost
                 'alt'    => 12,
                 'params' => ['sat' => 8, 'protocol' => 'wialon'],
             ]))->toMatchArray([
-                'occurred_at' => '2026-06-23 09:00:00',
+                'occurred_at' => '2026-06-23T09:00:00.000000Z',
                 'lat'         => 25.2,
                 'lng'         => 55.2,
                 'speed'       => 64,
@@ -1609,8 +1609,8 @@ test('afaqy normalization covers device event and sensor type variants', functio
         'phone'        => 'sim-123',
         'vin'          => 'vin-123',
         'status'       => 'active',
-        'online'       => true,
-        'last_seen_at' => '2026-06-23 09:00:00',
+        'online'       => null,
+        'last_seen_at' => '2026-06-23T09:00:00.000000Z',
         'location'     => ['lat' => 25.2, 'lng' => 55.2],
     ])
         ->and(data_get($device, 'meta.capabilities'))->toBe([
@@ -1624,8 +1624,8 @@ test('afaqy normalization covers device event and sensor type variants', functio
             'device_id'   => 'unit-123',
             'event_type'  => 'ignition_on',
             'message'     => 'Ignition on',
-            'occurred_at' => '2026-06-23 09:00:00',
-            'online'      => true,
+            'occurred_at' => '2026-06-23T09:00:00.000000Z',
+            'online'      => null,
             'location'    => ['lat' => 25.2, 'lng' => 55.2],
             'speed'       => 64,
             'heading'     => 180,
@@ -1658,7 +1658,7 @@ test('afaqy normalization covers device event and sensor type variants', functio
         'name'        => 'Temperature 1',
         'type'        => 'temperature',
         'value'       => 4.5,
-        'recorded_at' => '2026-06-23 09:10:00',
+        'recorded_at' => '2026-06-23T09:10:00.000000Z',
     ]);
 });
 

package/server/tests/TrailerSupportCoverageTest.php

@@ -141,7 +141,7 @@ function fleetOpsTrailerSupportDatabase(): SQLiteConnection
     });
     $schema->create('custom_fields', function ($table) {
         $table->increments('id');
-        foreach (['uuid', 'company_uuid', 'label', 'name', 'type'] as $column) {
+        foreach (['uuid', 'public_id', 'company_uuid', 'label', 'name', 'type'] as $column) {
             $table->string($column)->nullable();
         }
         $table->timestamps();

package/server/tests/Unit/Http/Resources/ManifestResourceTest.php

@@ -64,7 +64,7 @@ class FleetOpsManifestFake extends Manifest
 }
 
 test('manifest resource publishes what a driver needs to run a route', function () {
-    $request                             = Request::create('/v1/manifests/manifest_public', 'GET');
+    $request                              = Request::create('/v1/manifests/manifest_public', 'GET');
     FleetOpsSupportRequestState::$request = $request;
 
     $manifest = new FleetOpsManifestFake();
@@ -94,7 +94,7 @@ test('manifest resource publishes what a driver needs to run a route', function
 test('manifest resource omits stops when they were not loaded, so a list stays a list', function () {
     // A driver's manifest list on a busy fleet must not drag every stop of
     // every route along with it.
-    $request                             = Request::create('/v1/drivers/driver_public/manifests', 'GET');
+    $request                              = Request::create('/v1/drivers/driver_public/manifests', 'GET');
     FleetOpsSupportRequestState::$request = $request;
 
     $manifest = new FleetOpsManifestFake();
@@ -106,7 +106,7 @@ test('manifest resource omits stops when they were not loaded, so a list stays a
 });
 
 test('manifest stop resource carries the sequence a re-sequence rewrites', function () {
-    $request                             = Request::create('/v1/manifest-stops/stop_public', 'GET');
+    $request                              = Request::create('/v1/manifest-stops/stop_public', 'GET');
     FleetOpsSupportRequestState::$request = $request;
 
     $stop = new ManifestStop();