An individual installation of the Slack app.

This interface creates a representation for installations that normalizes the responses from OAuth grant exchanges across auth versions (responses from the Web API methods oauth.v2.access and oauth.access). It describes some of these differences using the AuthVersion generic placeholder type.

This interface also represents both installations which occur on individual Slack workspaces and on Slack enterprise organizations. The IsEnterpriseInstall generic placeholder type is used to describe some of those differences.

This representation is designed to be used both when producing data that should be stored by an InstallationStore, and when consuming data that is fetched from an InstallationStore. Most often, InstallationStore implementations are a database. If you are going to implement an InstallationStore, it's advised that you store as much of the data in these objects as possible so that you can return as much as possible inside fetchInstallation().

A few properties are synthesized with a default value if they are not present when returned from fetchInstallation(). These properties are optional in the interface so that stored installations from previous versions of this library (from before those properties were introduced) continue to work without requiring a breaking change. However the synthesized default values are not always perfect and are based on some assumptions, so this is why it's recommended to store as much of that data as possible in any InstallationStore.

Some of the properties (e.g. team.name) can change between when the installation occurred and when it is fetched from the InstallationStore. This can be seen as a reason not to store those properties. In most workspaces these properties rarely change, and for most Slack apps having a slightly out of date value has no impact. However if your app uses these values in a way where it must be up to date, it's recommended to implement a caching strategy in the InstallationStore to fetch the latest data from the Web API (using methods such as auth.test, teams.info, etc.) as often as it makes sense for your Slack app.

TODO: IsEnterpriseInstall is always false when AuthVersion is v1