update docs

Author: tatomyr

.changeset/tough-apples-attend.md

@@ -2,4 +2,4 @@
 "@redocly/cli": minor
 ---
 
-Added login flow based on [OAuth 2.0 Device authorization flow](https://datatracker.ietf.org/doc/html/rfc8628) that uses Reunite API.
+Added [OAuth 2.0 Device authorization flow](https://datatracker.ietf.org/doc/html/rfc8628) that enables users to authenticate through Reunite API.

docs/commands/index.md

@@ -26,8 +26,8 @@ Linting commands:
 
 Redocly platform commands:
 
-- [`login`](login.md) Login to the Redocly API registry with an access token.
-- [`logout`](logout.md) Clear your stored credentials for the Redocly API registry.
+- [`login`](login.md) Login to the Redocly API registry with an access token or to the Reunite API.
+- [`logout`](logout.md) Clear your stored credentials.
 - [`push`](push.md) Push an API description to the Redocly API registry.
 - [`push-status`](push-status.md) Track an in-progress push operation to Reunite.
 

docs/commands/login.md

@@ -22,15 +22,24 @@ redocly login [--help] [--verbose] [--version]
 redocly login --verbose
 ```
 
+To authenticate using **Reunite** API, use `--next` option.
+
+```bash
+redocly login --next
+```
+
+Please note that login with **Reunite** API does not allow you to use the `push` command.
+
 ## Options
 
-| Option       | Type    | Description                                                                                                                                           |
-| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| --config     | string  | Specify path to the [configuration file](../configuration/index.md).                                                                                  |
-| --help       | boolean | Show help.                                                                                                                                            |
-| --region, -r | string  | Specify which region to use when logging in. Supported values: `us`, `eu`. The `eu` region is limited to enterprise customers. Default value is `us`. |
-| --verbose    | boolean | Display additional output.                                                                                                                            |
-| --version    | boolean | Show version number.                                                                                                                                  |
+| Option                   | Type    | Description                                                                                                                                    |
+| ------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| --config                 | string  | Specify path to the [configuration file](../configuration/index.md).                                                                           |
+| --help                   | boolean | Show help.                                                                                                                                     |
+| --region, --residency -r | string  | Specify residency of the application. Supported values: `us`, `eu`. The `eu` region is limited to enterprise customers. Default value is `us`. |
+| --verbose                | boolean | Display additional output.                                                                                                                     |
+| --version                | boolean | Show version number.                                                                                                                           |
+| --next                   | boolean | Authenticate through Reunite API.                                                                                                              |
 
 ## Examples
 

packages/cli/src/commands/auth.ts

@@ -18,7 +18,7 @@ export function promptClientToken(domain: string) {
 
 export type LoginOptions = {
   verbose?: boolean;
-  region?: Region;
+  region?: string;
   config?: string;
   next?: boolean;
 };
@@ -40,7 +40,7 @@ export async function handleLogin({ argv, config, version }: CommandArgs<LoginOp
   } else {
     try {
       const region = argv.region || config.region;
-      const client = new RedoclyClient(region);
+      const client = new RedoclyClient(region as Region);
       const clientToken = await promptClientToken(client.domain);
       process.stdout.write(gray('\n  Logging in...\n'));
       await client.login(clientToken, argv.verbose);

packages/cli/src/index.ts

@@ -614,7 +614,7 @@ yargs
         region: {
           description: 'Residency of the application. Defaults to US.',
           alias: ['r', 'residency'],
-          choices: regionChoices,
+          type: 'string',
         },
         config: {
           description: 'Path to the config file.',

packages/cli/src/reunite/api/domains.ts

@@ -9,10 +9,10 @@ export function getDomain(): string {
   return process.env.REDOCLY_DOMAIN || REUNITE_URLS.us;
 }
 
-export function getReuniteUrl(residency?: Region) {
+export function getReuniteUrl(residency?: string) {
   if (!residency) residency = 'us';
 
-  let reuniteUrl: string = REUNITE_URLS[residency];
+  let reuniteUrl: string = REUNITE_URLS[residency as Region];
 
   if (!reuniteUrl) {
     reuniteUrl = residency;