Foreman » Smart Proxy

For Puppet Server 2.3.0 or higher (Puppet version 4.4+), a new environment_classes API is available that replaces resource_types.

https://docs.puppet.com/puppetserver/2.3/release_notes.html#new-feature-environmentclasses-api
https://docs.puppet.com/puppetserver/2.3/puppet-api/v3/environment_classes.html

In Puppet 4.5 (probably Puppet Server 2.4.0?) the older resource_types API is deprecated:

https://docs.puppet.com/puppet/4.5/reference/release_notes.html#deprecations

There are some features that we can expose in the smart proxy, e.g.

1. typing via default_literal - Foreman already follows the type of the default value in the JSON response (int, hash etc) to set the type of the smart class parameter. resource_types returns everything as a string.
2. reporting of errors - this could be logged on the smart proxy and/or added to the API response
3. clearer caching semantics with etag/matching support