service = new FuelPriceService(new StationTaggingService, new ApiLogger); }); it('fetches and caches an access token', function (): void { Http::fake([ '*/oauth/generate_access_token' => Http::response([ 'data' => [ 'access_token' => 'test-token-abc', 'expires_in' => 3600, ], ]), ]); $token = $this->service->getAccessToken(); expect($token)->toBe('test-token-abc') ->and(Cache::get('fuel_finder_access_token'))->toBe('test-token-abc'); }); it('returns cached token without hitting API', function (): void { Cache::put('fuel_finder_access_token', 'cached-token', 3540); Http::fake(); $token = $this->service->getAccessToken(); expect($token)->toBe('cached-token'); Http::assertNothingSent(); }); it('upserts stations from API batch response', function (): void { $apiStations = [ [ 'node_id' => 'abc123', 'trading_name' => 'Village Garage', 'brand_name' => 'Village Garage', 'is_same_trading_and_brand_name' => true, 'is_motorway_service_station' => false, 'is_supermarket_service_station' => false, 'temporary_closure' => false, 'permanent_closure' => false, 'permanent_closure_date' => null, 'public_phone_number' => null, 'location' => [ 'address_line_1' => '1 High Street', 'address_line_2' => null, 'city' => 'London', 'county' => null, 'country' => 'England', 'postcode' => 'SW1A 1AA', 'latitude' => 51.5, 'longitude' => -0.1, ], 'amenities' => [], 'opening_times' => null, 'fuel_types' => ['E10', 'E5'], ], ]; $this->service->upsertStations($apiStations); $station = Station::find('abc123'); expect($station)->not->toBeNull() ->and($station->trading_name)->toBe('Village Garage') ->and($station->postcode)->toBe('SW1A 1AA') ->and((float) $station->lat)->toBe(51.5) ->and($station->is_supermarket)->toBeFalse(); }); it('tags supermarket stations during upsert', function (): void { $apiStations = [[ 'node_id' => 'tesco1', 'trading_name' => 'TESCO', 'brand_name' => 'TESCO', 'is_same_trading_and_brand_name' => true, 'is_motorway_service_station' => false, 'is_supermarket_service_station' => true, 'temporary_closure' => false, 'permanent_closure' => false, 'permanent_closure_date' => null, 'public_phone_number' => null, 'location' => [ 'address_line_1' => '1 Tesco Way', 'address_line_2' => null, 'city' => 'Bristol', 'county' => null, 'country' => 'England', 'postcode' => 'BS1 1AA', 'latitude' => 51.45, 'longitude' => -2.6, ], 'amenities' => [], 'opening_times' => null, 'fuel_types' => ['E10'], ]]; $this->service->upsertStations($apiStations); expect(Station::find('tesco1')->is_supermarket)->toBeTrue(); }); // --- pollPrices --- it('inserts new price records and upserts current prices on poll', function (): void { Cache::put('fuel_finder_access_token', 'tok', 3540); Http::fake([ '*/pfs/fuel-prices*' => Http::sequence() ->push([ [ 'node_id' => 'sta1', 'fuel_prices' => [ [ 'fuel_type' => 'E10', 'price' => 142.9, 'price_last_updated' => '2026-04-04T10:00:00.000Z', 'price_change_effective_timestamp' => '2026-04-04T10:00:00.000Z', ], ], ], ]) ->push([]), ]); Station::factory()->create(['node_id' => 'sta1']); $inserted = $this->service->pollPrices(); expect($inserted)->toBe(1) ->and(StationPrice::count())->toBe(1) ->and(StationPriceCurrent::where('station_id', 'sta1')->where('fuel_type', 'e10')->value('price_pence'))->toBe(14290); }); it('does not insert a history row when price is unchanged', function (): void { Cache::put('fuel_finder_access_token', 'tok', 3540); Station::factory()->create(['node_id' => 'sta1']); StationPriceCurrent::insert([ 'station_id' => 'sta1', 'fuel_type' => 'e10', 'price_pence' => 14290, 'price_effective_at' => now()->subHour(), 'price_reported_at' => now()->subHour(), 'recorded_at' => now()->subHour(), ]); Http::fake([ '*/pfs/fuel-prices*' => Http::sequence() ->push([ [ 'node_id' => 'sta1', 'fuel_prices' => [ [ 'fuel_type' => 'E10', 'price' => 142.9, 'price_last_updated' => '2026-04-04T10:00:00.000Z', 'price_change_effective_timestamp' => '2026-04-04T10:00:00.000Z', ], ], ], ]) ->push([]), ]); $inserted = $this->service->pollPrices(); expect($inserted)->toBe(0) ->and(StationPrice::count())->toBe(0); }); it('inserts a history row when price has changed', function (): void { Cache::put('fuel_finder_access_token', 'tok', 3540); Station::factory()->create(['node_id' => 'sta1']); StationPriceCurrent::insert([ 'station_id' => 'sta1', 'fuel_type' => 'e10', 'price_pence' => 14290, 'price_effective_at' => now()->subHour(), 'price_reported_at' => now()->subHour(), 'recorded_at' => now()->subHour(), ]); Http::fake([ '*/pfs/fuel-prices*' => Http::sequence() ->push([ [ 'node_id' => 'sta1', 'fuel_prices' => [ [ 'fuel_type' => 'E10', 'price' => 139.9, 'price_last_updated' => '2026-04-04T12:00:00.000Z', 'price_change_effective_timestamp' => '2026-04-04T12:00:00.000Z', ], ], ], ]) ->push([]), ]); $inserted = $this->service->pollPrices(); expect($inserted)->toBe(1) ->and(StationPrice::first()->price_pence)->toBe(13990) ->and(StationPriceCurrent::where('station_id', 'sta1')->value('price_pence'))->toBe(13990); }); it('skips unknown fuel types without error', function (): void { Cache::put('fuel_finder_access_token', 'tok', 3540); Station::factory()->create(['node_id' => 'sta1']); Http::fake([ '*/pfs/fuel-prices*' => Http::sequence() ->push([ [ 'node_id' => 'sta1', 'fuel_prices' => [ [ 'fuel_type' => 'UNKNOWN_FUEL', 'price' => 150.0, 'price_last_updated' => '2026-04-04T10:00:00.000Z', 'price_change_effective_timestamp' => '2026-04-04T10:00:00.000Z', ], ], ], ]) ->push([]), ]); $inserted = $this->service->pollPrices(); expect($inserted)->toBe(0) ->and(StationPrice::count())->toBe(0); }); it('stops pagination when an empty batch is returned', function (): void { Cache::put('fuel_finder_access_token', 'tok', 3540); Http::fake([ '*/pfs/fuel-prices*' => Http::sequence() ->push([]) ->push([['node_id' => 'never', 'fuel_prices' => []]]), ]); $this->service->pollPrices(); Http::assertSentCount(1); });