3.0.1

Author: purplecabbage

README.md

@@ -72,6 +72,10 @@ $ aio auth --help
 * [`aio auth ctx`](#aio-auth-ctx)
 * [`aio auth login`](#aio-auth-login)
 * [`aio auth logout`](#aio-auth-logout)
+* [`aio context`](#aio-context)
+* [`aio ctx`](#aio-ctx)
+* [`aio login`](#aio-login)
+* [`aio logout`](#aio-logout)
 
 ## `aio auth`
 
@@ -140,7 +144,7 @@ EXAMPLES
     }
 ```
 
-_See code: [src/commands/auth/index.js](https://github.com/adobe/aio-cli-plugin-auth/blob/3.0.0/src/commands/auth/index.js)_
+_See code: [src/commands/auth/index.js](https://github.com/adobe/aio-cli-plugin-auth/blob/3.0.1/src/commands/auth/index.js)_
 
 ## `aio auth ctx`
 
@@ -281,6 +285,197 @@ DESCRIPTION
 
   command will just do nothing.
 
+ALIASES
+  $ aio logout
+```
+
+## `aio context`
+
+Manage Adobe IMS contexts.
+
+```
+USAGE
+  $ aio context [--debug <value>] [-v] [-l | -g] [-c <value>] [--list | --value | -s <value> | ]
+
+FLAGS
+  -c, --ctx=<value>  Name of the Adobe IMS context to use. Default is the current Adobe IMS context
+  -g, --global       global config
+  -l, --local        local config
+  -s, --set=<value>  Sets the name of the current local Adobe IMS context
+  -v, --verbose      Verbose output
+  --debug=<value>    Debug level output
+  --list             Names of the Adobe IMS contexts as an array
+  --value            Prints named or current Adobe IMS context data
+
+DESCRIPTION
+  Manage Adobe IMS contexts.
+
+  The following options exist for this command:
+
+  * List the names of the configured Adobe IMS contexts
+
+  * Print the name of the current Adobe IMS context
+
+  * Set the name of the current Adobe IMS context
+
+  * Print the configuration of the current or a named Adobe IMS context
+
+  Currently it is not possible to update the Adobe Adobe IMS context configuration
+
+  using this command. Use the "aio config" commands for this.
+
+  e.g. aio config:set ims.contexts.your_context.your_context_key "your_context_value"
+
+  Please note, that the following IMS context label names is reserved: `cli`
+
+  and should not be used as an IMS context name.
+
+  Also note that the current context can only be set locally.
+
+ALIASES
+  $ aio ctx
+  $ aio context
+```
+
+## `aio ctx`
+
+Manage Adobe IMS contexts.
+
+```
+USAGE
+  $ aio ctx [--debug <value>] [-v] [-l | -g] [-c <value>] [--list | --value | -s <value> | ]
+
+FLAGS
+  -c, --ctx=<value>  Name of the Adobe IMS context to use. Default is the current Adobe IMS context
+  -g, --global       global config
+  -l, --local        local config
+  -s, --set=<value>  Sets the name of the current local Adobe IMS context
+  -v, --verbose      Verbose output
+  --debug=<value>    Debug level output
+  --list             Names of the Adobe IMS contexts as an array
+  --value            Prints named or current Adobe IMS context data
+
+DESCRIPTION
+  Manage Adobe IMS contexts.
+
+  The following options exist for this command:
+
+  * List the names of the configured Adobe IMS contexts
+
+  * Print the name of the current Adobe IMS context
+
+  * Set the name of the current Adobe IMS context
+
+  * Print the configuration of the current or a named Adobe IMS context
+
+  Currently it is not possible to update the Adobe Adobe IMS context configuration
+
+  using this command. Use the "aio config" commands for this.
+
+  e.g. aio config:set ims.contexts.your_context.your_context_key "your_context_value"
+
+  Please note, that the following IMS context label names is reserved: `cli`
+
+  and should not be used as an IMS context name.
+
+  Also note that the current context can only be set locally.
+
+ALIASES
+  $ aio ctx
+  $ aio context
+```
+
+## `aio login`
+
+Log in with a certain Adobe IMS context and returns the access token.
+
+```
+USAGE
+  $ aio login [--debug <value>] [-v] [-l | -g] [-c <value>] [-f] [-d] [-b] [-o]
+
+FLAGS
+  -b, --bare         print access token only
+  -c, --ctx=<value>  Name of the Adobe IMS context to use. Default is the current Adobe IMS context
+  -d, --decode       Decode and display access token data
+  -f, --force        Force logging in. This causes a forced logout on the context first and makes sure to not use any
+                     cached data when calling the plugin.
+  -g, --global       global config
+  -l, --local        local config
+  -o, --[no-]open    Open the default browser to complete the login
+  -v, --verbose      Verbose output
+  --debug=<value>    Debug level output
+
+DESCRIPTION
+  Log in with a certain Adobe IMS context and returns the access token.
+
+  If the Adobe IMS context already has a valid access token set (valid meaning
+
+  at least 10 minutes before expiry), that token is returned.
+
+  Otherwise, if the Adobe IMS context has a valid refresh token set (valid
+
+  meaning at least 10 minutes before expiry) that refresh token is
+
+  exchanged for an access token before returning the access token.
+
+  Lastly, if the Adobe IMS context properties are supported by one of the
+
+  Adobe IMS login plugins, that login plugin is called to guide through
+
+  the IMS login process.
+
+  The currently supported Adobe IMS login plugins are:
+
+  * aio-lib-ims-jwt for JWT token based login supporting
+
+  Adobe I/O Console service integrations.
+
+  * aio-lib-ims-oauth for browser based OAuth2 login. This
+
+  plugin will launch the default browser to guide the user through the
+
+  login process. The plugin itself will *never* see the user's
+
+  password but only receive the authorization token after the
+
+  user has authenticated with Adobe IMS.
+
+ALIASES
+  $ aio login
+```
+
+## `aio logout`
+
+Log out the current or a named Adobe IMS context.
+
+```
+USAGE
+  $ aio logout [--debug <value>] [-v] [-l | -g] [-c <value>] [-f]
+
+FLAGS
+  -c, --ctx=<value>  Name of the Adobe IMS context to use. Default is the current Adobe IMS context
+  -f, --force        Invalidate the refresh token as well as all access tokens.
+                     Otherwise only the access token is invalidated. For Adobe IMS
+                     contexts not supporting refresh tokens, this flag has no
+                     effect.
+  -g, --global       global config
+  -l, --local        local config
+  -v, --verbose      Verbose output
+  --debug=<value>    Debug level output
+
+DESCRIPTION
+  Log out the current or a named Adobe IMS context.
+
+  This command can be called multiple times on the same Adobe IMS context with
+
+  out causing any errors. The assumption is that after calling this command
+
+  without an error, the Adobe IMS context's access and refresh tokens have been
+
+  invalidated and removed from persistent storage. Repeatedly calling this
+
+  command will just do nothing.
+
 ALIASES
   $ aio logout
 ```

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adobe/aio-cli-plugin-auth",
   "description": "The IMS plugin to aio supports managing tokens for IMS such as login, logout, and retrieving and using tokens.",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "author": "Adobe",
   "bugs": "https://github.com/adobe/aio-cli-plugin-auth/issues",
   "dependencies": {