What's new in v2.0.0?

We heard that ArcGIS REST JS had some new goodies in v2.0.0, so we decided to jump on the bandwagon too.

Very little has changed in @esri/hub.js v2.0.0, but there are a few breaking changes to be aware of.

ArcGIS REST JS packages are now peerDependencies.

@esri/arcgis-rest-request and friends have never been bundled within our code, so now that we're relying on v2.x, we're doing the right thing and listing REST JS packages as peerDependencies in @esri/hub.js.

  "name": "@esri/hub-initiatives",
  "peerDependencies": {
    "@esri/arcgis-rest-request": "^2.0.0"

As a @esri/hub.js developer, you'll need to install pertinent ArcGIS REST JS packages yourself.

  "name": "Your awesome project",
  "dependencies": {
    "@esri/arcgis-rest-request": "^2.0.0",
    "@esri/hub-initiatives": "^2.0.0",


We 'borrowed' all the great new updates in the ArcGIS REST JS documentation.

  • RequestOptions details are now displayed inline on the page for their corresponding method.
  • Required, optional and inherited parameters are now appropriately sorted in tables.
  • Methods, Constants, Types and Interfaces are sorted in the Table of Contents too
  • Text overflow is now handled more appropriately.

Say goodbye to @esri/hub-domains

The sole utility function in our domains package proved so popular we moved it into @esri/hub-common and got rid of @esri/hub-domains entirely.

Old New Package
getHubUrl() @esri/hub-domains
getHubApiUrl @esri/hub-common


We renamed two methods inside @esri/hub-sites awhile back. In v2.0.0, we officially removed the old ones.

Old Method New Method
fetchDomain() getDomain()
fetchDomains() getDomains()


We renamed one method inside @esri/hub-initiatives too.

Old Method New Method
fetchInitiative() getInitiative()


When you're creating a new annotation, now you'll pass an array of features (instead of adds).

// old
addAnnotations({ adds: [] })

// new
addAnnotations({ features: [] })

Breaking Changes for TypeScript developers

The table below lists interfaces and types that have been removed or renamed in the name of consistency and brevity. This also better aligns the names of options and response interfaces with their corresponding function.

Old Interface New Interface
ISearchAnnoRequestOptions ISearchAnnoOptions
IVoteRequestOptions IVoteOptions
IEventRegisterRequestOptions IEventRegisterOptions
IFollowInitiativeRequestOptions IFollowInitiativeOptions

That's it! We didn't move much 🧀 because he heard those pesky ArcGIS REST JS maintainers renamed so many packages.