Start planning out packages

[patrickarlt]

@dbouwman @jgravois @noahmulfinger @dmfenton @araedavis I think this repo is getting close to the point where we can start thinking about planning out the other packages that we want. I think we can still do this regardless of the auth decisions in https://github.com/ArcGIS/arcgis-rest-js/issues/5.

I think the first step is audit all of our projects and produce the following:

• A list of all API endpoints we call on server and portal
• All params we use on those endpoints
• How are our codebases currently organized
• What would we like to prioritize for inclusion as a package

I think once we have these audits complete and we know what we are dealing with we can better plan out a sane package organization.

I will add that I want to create a rest-core-types repo so we can share common types and interfaces across the project for things like geometries.

I also want to make rest-geocoding based on https://developers.arcgis.com/rest/geocode/api-reference/overview-world-geocoding-service.htm.

I want to do rest-core-types and rest-geocoding for 2 reasons:

1. Validate that the build/test/docs/lint systems all work properly.
2. Lay out examples for contributing new packages.
3. Verify that the arcgis-request and rest-core-types can both be easily used to create rest-geocoding

[patrickarlt]

Currently here are the following packages:

Name	Desc
rest-request	Implement the basic request method. Expose IAuthenticationManager and IRequestOptions for other packages as well as basic utils.
rest-auth	Implements the IAuthenticationManager interface and provides authentication tools.
rest-common-types	Common TypeScript types an interfaces shared across packages.

I would also propose the following packages mostly to validate that the tooling and patterns will work for future patterns.

• rest-geocoding - provide the following methods:
  • geocode - wrap findAddressCanidates
  • bulkGeocode - wrap geocodeAddresses
  • reverseGeocode - wrap reverseGeocode
  • suggest - wrap suggest
  • geocodeServiceInfo - get the info for a geocode service

[patrickarlt]

rest-auth started in #16.

[patrickarlt]

I'm going to make separate issues to start designing the APIs the following packages:

• arcgis-rest-search
• arcgis-rest-items
• arcgis-rest-sharing
• arcgis-rest-groups
• arcgis-rest-users
• arcgis-rest-applications
• arcgis-rest-feature-layers
• arcgis-rest-routing
• arcgis-rest-geoenrichment

These will probably be assigned to a mix of @tomwayson @dbouwman @araedavis and @noahmulfinger @jgravois and myself.

[jgravois]

planning has begun: #41, #42, #43, #44, #45. #46. #47, #48.