@fleetbase/fleetops-engine 0.6.65 → 0.6.67

package/server/tests/SupportJobAndAiCoverageTest.php

@@ -22,9 +22,10 @@ use Illuminate\Validation\ValidationException;
 
 class FleetOpsSyncTelematicJobFake extends Telematic
 {
-    public bool $refreshed  = false;
-    public bool $saved      = false;
-    public int $saveCount   = 0;
+    public bool $refreshed    = false;
+    public bool $saved        = false;
+    public int $saveCount     = 0;
+    public array $savedStates = [];
 
     public function refresh()
     {
@@ -37,6 +38,7 @@ class FleetOpsSyncTelematicJobFake extends Telematic
     {
         $this->saved = true;
         $this->saveCount++;
+        $this->savedStates[] = ['status' => $this->status, 'meta' => $this->meta];
 
         return true;
     }
@@ -191,7 +193,8 @@ class FleetOpsTelematicSyncRegistryFake extends TelematicProviderRegistry
 
 class FleetOpsTelematicSyncServiceFake extends TelematicService
 {
-    public array $ingested = [];
+    public array $ingested        = [];
+    public ?Closure $beforeIngest = null;
 
     public function __construct(public array $results = [], public array $failFor = [])
     {
@@ -200,6 +203,9 @@ class FleetOpsTelematicSyncServiceFake extends TelematicService
     public function ingestDeviceSnapshot(Telematic $telematic, Fleetbase\FleetOps\Contracts\TelematicProviderInterface $provider, array $payload): array
     {
         $this->ingested[] = $payload;
+        if ($this->beforeIngest) {
+            ($this->beforeIngest)($telematic, $payload, count($this->ingested));
+        }
 
         if (in_array($payload['_id'] ?? $payload['id'] ?? null, $this->failFor, true)) {
             throw ValidationException::withMessages(['device_id' => ['missing provider identity']]);
@@ -610,7 +616,6 @@ test('sync telematic devices job handles paginated inventory enrichment skips an
             ->and($service->ingested)->toHaveCount(6)
             ->and($lock->releaseCount)->toBe(1)
             ->and($telematic->saved)->toBeTrue()
-            ->and($telematic->saveCount)->toBe(2)
             ->and($telematic->status)->toBe('active')
             ->and($telematic->meta)->toMatchArray([
                 'existing'                              => 'kept',
@@ -677,6 +682,98 @@ test('sync telematic devices job handles paginated inventory enrichment skips an
     }
 });
 
+test('manual sync persists fetched pages before ingestion and bounded applied checkpoints', function () {
+    Carbon::setTestNow('2026-07-25 12:00:00 UTC');
+    $originalCache = Cache::getFacadeRoot();
+
+    try {
+        $telematic = new FleetOpsSyncTelematicJobFake();
+        $telematic->setRawAttributes(['uuid' => 'progress-connection', 'provider' => 'safee', 'status' => 'synchronizing', 'meta' => ['last_sync_result' => 'queued', 'unrelated' => 'preserved']], true);
+        $devices  = array_map(fn ($number) => ['_id' => 'unit-' . $number, 'device_id' => 'unit-' . $number], range(1, 52));
+        $provider = new FleetOpsTelematicSyncProviderFake([
+            ['devices' => $devices, 'pagination' => ['allCount' => 52, 'filtersCount' => 52], 'has_more' => false],
+        ]);
+        $service               = new FleetOpsTelematicSyncServiceFake();
+        $observed              = [];
+        $service->beforeIngest = function ($connection, $payload, $number) use (&$observed) {
+            if (in_array($number, [1, 26, 51], true)) {
+                $observed[$number] = end($connection->savedStates);
+            }
+        };
+        $lock = new FleetOpsTelematicSyncLockFake(true);
+        Cache::swap(new FleetOpsTelematicSyncCacheFake($lock));
+
+        (new SyncTelematicDevicesJob($telematic, [], 'progress-job'))->handle(new FleetOpsTelematicSyncRegistryFake($provider), $service);
+
+        expect($observed[1]['status'])->toBe('synchronizing');
+        expect($observed[1]['meta'])->toMatchArray([
+            'last_sync_job_id'        => 'progress-job', 'last_sync_result' => 'running', 'last_sync_phase' => 'ingesting_inventory',
+            'last_sync_fetched_total' => 52, 'last_sync_inventory_total' => 52, 'last_sync_provider_total' => 52,
+            'last_sync_page_count'    => 1, 'last_sync_linked_total' => 0, 'last_sync_progress_at' => '2026-07-25 12:00:00',
+        ]);
+        expect($observed[26]['meta']['last_sync_linked_total'])->toBe(25)
+            ->and($observed[51]['meta']['last_sync_linked_total'])->toBe(50);
+        expect($telematic->meta)->toMatchArray(['last_sync_result' => 'success', 'last_sync_phase' => 'completed', 'last_sync_linked_total' => 52, 'unrelated' => 'preserved']);
+        expect($telematic->saveCount)->toBeLessThan(20);
+        expect($lock->releaseCount)->toBe(1);
+    } finally {
+        Cache::swap($originalCache);
+        Carbon::setTestNow();
+    }
+});
+
+test('manual sync checkpoints elapsed progress and retains partial counters when an item throws a PHP error', function () {
+    Carbon::setTestNow('2026-07-25 12:00:00 UTC');
+    $originalCache = Cache::getFacadeRoot();
+
+    try {
+        $telematic = new FleetOpsSyncTelematicJobFake();
+        $telematic->setRawAttributes(['uuid' => 'partial-connection', 'provider' => 'safee', 'status' => 'synchronizing', 'meta' => ['last_sync_result' => 'queued']], true);
+        $devices  = array_map(fn ($number) => ['_id' => 'unit-' . $number, 'device_id' => 'unit-' . $number], range(1, 3));
+        $provider = new FleetOpsTelematicSyncProviderFake([
+            ['devices' => $devices, 'pagination' => ['allCount' => 3], 'has_more' => false],
+        ]);
+        $service                 = new FleetOpsTelematicSyncServiceFake();
+        $checkpointBeforeFailure = null;
+        $service->beforeIngest   = function ($connection, $payload, $number) use (&$checkpointBeforeFailure) {
+            if ($number === 1) {
+                Carbon::setTestNow('2026-07-25 12:00:06 UTC');
+
+                return;
+            }
+            $checkpointBeforeFailure = end($connection->savedStates)['meta'];
+            throw new TypeError('Invalid normalized unit field');
+        };
+        $lock = new FleetOpsTelematicSyncLockFake(true);
+        Cache::swap(new FleetOpsTelematicSyncCacheFake($lock));
+        $job = new SyncTelematicDevicesJob($telematic, [], 'partial-job');
+
+        expect(fn () => $job->handle(new FleetOpsTelematicSyncRegistryFake($provider), $service))->toThrow(TypeError::class, 'Invalid normalized unit field');
+        expect($checkpointBeforeFailure)->toMatchArray([
+            'last_sync_result'        => 'running', 'last_sync_phase' => 'ingesting_inventory',
+            'last_sync_fetched_total' => 3, 'last_sync_linked_total' => 1, 'last_sync_inventory_linked_total' => 1,
+            'last_sync_page_count'    => 1, 'last_sync_progress_at' => '2026-07-25 12:00:06',
+        ]);
+        expect(end($telematic->savedStates)['meta'])->toMatchArray([
+            'last_sync_result'        => 'failed', 'last_sync_error_type' => 'TypeError',
+            'last_sync_fetched_total' => 3, 'last_sync_inventory_total' => 3,
+            'last_sync_linked_total'  => 1, 'last_sync_inventory_linked_total' => 1,
+            'last_sync_page_count'    => 1, 'last_sync_error' => 'Invalid normalized unit field',
+        ]);
+        expect($telematic->status)->toBe('error')->and($lock->releaseCount)->toBe(1);
+
+        // Queue failure callbacks receive persisted checkpoints, not the handler's local counters.
+        $job->failed(new TimeoutExceededException('Queue timeout'));
+        expect($telematic->meta)->toMatchArray([
+            'last_sync_result'        => 'failed', 'last_sync_failed_reason' => 'job_timeout',
+            'last_sync_fetched_total' => 3, 'last_sync_linked_total' => 1, 'last_sync_page_count' => 1,
+        ]);
+    } finally {
+        Cache::swap($originalCache);
+        Carbon::setTestNow();
+    }
+});
+
 test('sync telematics command filters pollable providers and exits cleanly without work', function () {
     $registry = new TelematicProviderRegistry();
     $registry->register(new TelematicProviderDescriptor([

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")
@@ -1064,9 +1065,9 @@ test('safee endpoint helpers account for identities enrichment and failures', fu
         ]);
 
     $provider->queuePostResponse('/api/v2/vehicle/last-state', [
+        'code'   => 0,
         'result' => [
             ['vehicle' => ['id' => 105], 'status' => 'online'],
-            'ignored',
             ['id' => 106, 'status' => 'offline'],
         ],
     ]);
@@ -1077,15 +1078,13 @@ test('safee endpoint helpers account for identities enrichment and failures', fu
     expect($lastStates['105']['status'])->toBe('online')
         ->and($lastStates['106']['status'])->toBe('offline');
 
+    // Live polling must not report malformed, unrequested or failed batches as an empty fleet.
+    $provider->queuePostResponse('/api/v2/vehicle/last-state', ['code' => 0, 'result' => [['id' => 105], 'ignored']]);
+    expect(fn () => $provider->fetchLastStatesByVehicleForTest([105], $stats))->toThrow(Fleetbase\FleetOps\Exceptions\TelematicProviderException::class, 'invalid list record');
+    $provider->queuePostResponse('/api/v2/vehicle/last-state', ['code' => 0, 'result' => [['id' => 999]]]);
+    expect(fn () => $provider->fetchLastStatesByVehicleForTest([105], $stats))->toThrow(Fleetbase\FleetOps\Exceptions\TelematicProviderException::class, 'unrequested');
     $provider->queuePostException('/api/v2/vehicle/last-state', new RuntimeException('token=abc123 password=secret failed'));
-    $failedStats = ['failures' => []];
-
-    expect($provider->fetchLastStatesByVehicleForTest([107], $failedStats))->toBe([])
-        ->and($failedStats['failures'][0])->toMatchArray([
-            'endpoint'   => '/api/v2/vehicle/last-state',
-            'vehicle_id' => null,
-            'message'    => 'token=[redacted] password=[redacted] failed',
-        ]);
+    expect(fn () => $provider->fetchLastStatesByVehicleForTest([107], $stats))->toThrow(RuntimeException::class);
 
     $provider->queuePostResponse('/api/v2/vehicle/positions', [
         'result' => [
@@ -1151,16 +1150,23 @@ test('safee endpoint helpers account for identities enrichment and failures', fu
 test('safee normalization helpers cover status position sensor and timestamp variants', function () {
     $provider = new FleetOpsSafeeProviderProbe();
 
+    // Enrichment only fills gaps unless its source timestamp is strictly newer than the live state.
     expect($provider->currentTelemetryPayloadForTest([
         '_safee' => [
             'current_state' => ['status' => 'offline', 'speed' => 10],
             'current_info'  => ['speed' => 12, 'odometer' => 500],
         ],
     ]))->toBe([
-        'status'   => 'offline',
-        'speed'    => 12,
+        'speed'    => 10,
         'odometer' => 500,
+        'status'   => 'offline',
     ])
+        ->and($provider->currentTelemetryPayloadForTest([
+            '_safee' => [
+                'current_state' => ['date' => 1782206100, 'speed' => 10],
+                'current_info'  => ['date' => 1782206140, 'speed' => 12],
+            ],
+        ]))->toBe(['date' => 1782206140, 'speed' => 12])
         ->and($provider->currentTelemetryPayloadForTest(['_safee' => ['current_info' => ['speed' => 7]]]))->toBe(['speed' => 7])
         ->and($provider->currentTelemetryPayloadForTest(['_safee' => ['current_state' => ['speed' => 6]]]))->toBe(['speed' => 6])
         ->and($provider->currentTelemetryPayloadForTest(['_safee' => []]))->toBeNull()
@@ -1171,7 +1177,7 @@ test('safee normalization helpers cover status position sensor and timestamp var
         ->and($provider->resolveVehicleNameForTest([], [], 108))->toBe('Safee Vehicle 108')
         ->and($provider->resolveVehicleNameForTest([], [], null))->toBe('Unknown Safee Vehicle')
         ->and($provider->sanitizeProviderMessageForTest('access_token=abc&password=secret client_secret=top'))->toBe('access_token=[redacted]&password=[redacted] client_secret=[redacted]')
-        ->and($provider->extractPositionForTest(['loc' => ['coordinates' => [55.2, 25.2]]]))->toBe(['lat' => 25.2, 'lng' => 55.2])
+        ->and($provider->extractPositionForTest(['loc' => ['coordinates' => [55.2, 25.2]]]))->toBe(['lat' => 25.2, 'lng' => 55.2, 'alt' => null])
         ->and($provider->parseTimestampForTest(null))->toBeNull()
         ->and($provider->parseTimestampForTest(1782206140500))->toBe(Carbon::createFromTimestamp(1782206140.5)->toDateTimeString())
         ->and($provider->parseTimestampForTest('2026-06-23T09:15:40Z'))->toBe('2026-06-23 09:15:40')
@@ -1395,7 +1401,7 @@ test('afaqy sync stores compact device diagnostics and paginates complete units
         ->toContain('= 15;')
         ->toContain('protected int $connectionTestTimeout')
         ->toContain('= 30;')
-        ->toContain('protected int $connectionTestConnectTimeout = 10')
+        ->toContain('protected int $connectionTestConnectTimeout  = 10')
         ->toContain('->timeout($timeout)')
         ->toContain('->connectTimeout($connectTimeout)')
         ->toContain('ConnectionException')
@@ -1412,20 +1418,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 +1438,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 +1476,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 +1499,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 +1527,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 +1538,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 +1614,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 +1629,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 +1663,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/Console/SyncTelematicsCommandTest.php

@@ -1,5 +1,7 @@
 <?php
 
+require_once __DIR__ . '/../../Support/ExampleTelemetryProvider.php';
+
 use Fleetbase\FleetOps\Console\Commands\SyncTelematics;
 use Fleetbase\FleetOps\Contracts\TelematicProviderDescriptor;
 use Fleetbase\FleetOps\Support\Telematics\TelematicProviderRegistry;
@@ -134,3 +136,141 @@ test('sync telematics filters providers by request and webhook flags', function
     expect($command->handle($registry))->toBe(0)
         ->and($command->messages)->toContain(['info', 'No pollable telematics providers found.']);
 });
+
+test('sync telematics command releases its bounded lock and recovers an interrupted lease', function () {
+    fleetopsSyncTelematicsBoot();
+    $originalCache = Illuminate\Support\Facades\Cache::getFacadeRoot();
+    Illuminate\Support\Carbon::setTestNow('2026-09-17 12:00:00 UTC');
+
+    try {
+        $store = new class extends Illuminate\Cache\ArrayStore {
+            public array $requestedLocks = [];
+
+            public function lock($name, $seconds = 0, $owner = null)
+            {
+                $this->requestedLocks[] = [$name, $seconds];
+
+                return parent::lock($name, $seconds, $owner);
+            }
+        };
+        Illuminate\Support\Facades\Cache::swap(new Illuminate\Cache\Repository($store));
+        $command                     = new FleetOpsSyncTelematicsProbe();
+        $command->options['no-lock'] = false;
+        $registry                    = fleetopsSyncTelematicsRegistry([]);
+        expect($command->handle($registry))->toBe(0);
+        expect($store->requestedLocks[0])->toBe(['fleetops:sync-telematics', 120]);
+        expect($store->locks)->toBe([]);
+
+        // Leave a lease behind as if the previous command process had stopped.
+        [$key, $ttl] = $store->requestedLocks[0];
+        expect($store->lock($key, $ttl)->get())->toBeTrue();
+        $command->messages = [];
+        Illuminate\Support\Carbon::setTestNow('2026-09-17 12:01:59 UTC');
+        expect($command->handle($registry))->toBe(0)
+            ->and($command->messages)->toContain(['warn', 'Another telematics sync run appears to be in progress.']);
+
+        $command->messages = [];
+        Illuminate\Support\Carbon::setTestNow('2026-09-17 12:02:01 UTC');
+        expect($command->handle($registry))->toBe(0)
+            ->and($command->messages)->toContain(['info', 'No pollable telematics providers found.']);
+        expect($store->locks)->toBe([]);
+    } finally {
+        Illuminate\Support\Facades\Cache::swap($originalCache);
+        Illuminate\Support\Carbon::setTestNow();
+    }
+});
+
+test('sync telematics reports successful durable and legacy dispatches without counting coalesced polls', function () {
+    $connection = fleetopsSyncTelematicsBoot();
+    $connection->table('telematics')->insert([
+        ['uuid' => 'durable-connection', 'company_uuid' => 'company-1', 'provider' => 'example', 'status' => 'active'],
+        ['uuid' => 'legacy-connection', 'company_uuid' => 'company-1', 'provider' => 'traccar', 'status' => 'active'],
+    ]);
+    $registry = fleetopsSyncTelematicsRegistry([
+        ['key' => 'example', 'label' => 'Example', 'supports_discovery' => true, 'driver_class' => ExampleTelemetryProvider::class, 'metadata' => ['telemetry' => ['durable_ingestion' => true]]],
+        ['key' => 'traccar', 'label' => 'Traccar', 'supports_discovery' => true],
+    ]);
+    $originalCache       = Illuminate\Support\Facades\Cache::getFacadeRoot();
+    $originalCacheConfig = config('cache', []);
+    $dispatcherContract  = Illuminate\Contracts\Bus\Dispatcher::class;
+    $originalDispatcher  = app()->bound($dispatcherContract) ? app($dispatcherContract) : null;
+
+    try {
+        config(['cache.default' => 'array', 'cache.stores.array' => ['driver' => 'array']]);
+        Illuminate\Support\Facades\Cache::swap(new Illuminate\Cache\CacheManager(app()));
+        $dispatcher = new class(app()) extends Illuminate\Bus\Dispatcher {
+            public array $jobs = [];
+
+            public function dispatch($command)
+            {
+                $this->jobs[] = $command;
+
+                return $command;
+            }
+        };
+        app()->instance($dispatcherContract, $dispatcher);
+        $command = new FleetOpsSyncTelematicsProbe();
+
+        expect($command->handle($registry))->toBe(0)
+            ->and($command->messages)->toContain(['info', 'Queued 2 telematics sync job(s).']);
+        expect($dispatcher->jobs)->toHaveCount(1)
+            ->and($dispatcher->jobs[0])->toBeInstanceOf(Fleetbase\FleetOps\Jobs\PollTelematicTelemetry::class)
+            ->and(DispatchRecorder::$dispatched)->toHaveCount(1);
+
+        // The real unique lock suppresses a second durable poll; legacy dispatch remains eligible.
+        $command->messages = [];
+        expect($command->handle($registry))->toBe(0)
+            ->and($command->messages)->toContain(['info', 'Queued 1 telematics sync job(s).']);
+        expect($dispatcher->jobs)->toHaveCount(1)
+            ->and(DispatchRecorder::$dispatched)->toHaveCount(2);
+
+        $command->messages            = [];
+        $command->options['provider'] = ['example'];
+        expect($command->handle($registry))->toBe(0)
+            ->and($command->messages)->toContain(['info', 'Queued 0 telematics sync job(s).']);
+        expect($dispatcher->jobs)->toHaveCount(1);
+    } finally {
+        Illuminate\Support\Facades\Cache::swap($originalCache);
+        config(['cache' => $originalCacheConfig]);
+        if ($originalDispatcher) {
+            app()->instance($dispatcherContract, $originalDispatcher);
+        } else {
+            app()->offsetUnset($dispatcherContract);
+        }
+    }
+});
+
+class PausedBatchTelemetryProvider extends ExampleTelemetryProvider
+{
+    public function telemetryOptions(): array
+    {
+        return ['polling_enabled' => false, 'manual_batch_sync' => true];
+    }
+}
+
+class PausedReconciledTelemetryProvider extends ExampleTelemetryProvider
+{
+    public function telemetryOptions(): array
+    {
+        return ['polling_enabled' => false];
+    }
+}
+
+test('sync telematics pauses batch-only providers instead of queueing legacy syncs that would fail', function () {
+    $connection = fleetopsSyncTelematicsBoot();
+    $connection->table('telematics')->insert([
+        ['uuid' => 'batch-connection', 'company_uuid' => 'company-1', 'provider' => 'batch', 'status' => 'error'],
+        ['uuid' => 'reconciled-connection', 'company_uuid' => 'company-1', 'provider' => 'reconciled', 'status' => 'active'],
+    ]);
+    $registry = fleetopsSyncTelematicsRegistry([
+        ['key' => 'batch', 'label' => 'Batch', 'supports_discovery' => true, 'driver_class' => PausedBatchTelemetryProvider::class, 'metadata' => ['telemetry' => ['durable_ingestion' => true]]],
+        ['key' => 'reconciled', 'label' => 'Reconciled', 'supports_discovery' => true, 'driver_class' => PausedReconciledTelemetryProvider::class, 'metadata' => ['telemetry' => ['durable_ingestion' => true]]],
+    ]);
+    $command = new FleetOpsSyncTelematicsProbe();
+
+    // Providers without batch sync keep their existing legacy reconciliation while polling is paused.
+    expect($command->handle($registry))->toBe(0)
+        ->and(DispatchRecorder::$dispatched)->toHaveCount(1)
+        ->and(DispatchRecorder::$dispatched[0]['arguments'][0]->uuid)->toBe('reconciled-connection')
+        ->and($command->messages)->toContain(['info', 'Queued 1 telematics sync job(s).']);
+});

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();