feat(config-provider): flatten command hierarchy

Restructure config-provider commands to remove the `env` level:

- `clever config-provider` - display help (doc-only)
- `clever config-provider list` - list all configuration providers
- `clever config-provider get <id>` - list environment variables
- `clever config-provider set <id> <name> <value>` - set a variable
- `clever config-provider rm <id> <name>` - remove a variable
- `clever config-provider import <id>` - import variables from stdin
- `clever config-provider open <id>` - open in Console

Closes #1027

Author: hsablonniere

docs/llms-documentation.md

@@ -591,6 +591,127 @@ clever config update [options]
     --name <name>                  Set application name
 ```
 
+## config-provider
+
+**Description:** Manage configuration providers
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider
+```
+
+### config-provider get
+
+**Description:** List environment variables of a configuration provider
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider get <addon-id|config-provider-id|addon-name> [options]
+```
+
+**Arguments**
+```
+addon-id|config-provider-id|addon-name    Add-on ID, real ID (config_xxx) or name (if unambiguous)
+```
+
+**Options**
+```
+-F, --format <format>                     Output format (human, json, shell) (default: human)
+```
+
+### config-provider import
+
+**Description:** Load environment variables from STDIN
+(WARNING: this deletes all current variables and replaces them with the new list loaded from STDIN)
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider import <addon-id|config-provider-id|addon-name> [options]
+```
+
+**Arguments**
+```
+addon-id|config-provider-id|addon-name    Add-on ID, real ID (config_xxx) or name (if unambiguous)
+```
+
+**Options**
+```
+-F, --format <format>                     Input format (name-equals-value, json) (default: name-equals-value)
+```
+
+### config-provider list
+
+**Description:** List configuration providers
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider list [options]
+```
+
+**Options**
+```
+-F, --format <format>    Output format (human, json) (default: human)
+```
+
+### config-provider open
+
+**Description:** Open the configuration provider in Clever Cloud Console
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider open <addon-id|config-provider-id|addon-name>
+```
+
+**Arguments**
+```
+addon-id|config-provider-id|addon-name    Add-on ID, real ID (config_xxx) or name (if unambiguous)
+```
+
+### config-provider rm
+
+**Description:** Remove an environment variable from a configuration provider
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider rm <addon-id|config-provider-id|addon-name> <variable-name>
+```
+
+**Arguments**
+```
+addon-id|config-provider-id|addon-name    Add-on ID, real ID (config_xxx) or name (if unambiguous)
+variable-name                             Name of the environment variable
+```
+
+### config-provider set
+
+**Description:** Add or update an environment variable named <variable-name> with the value <variable-value>
+
+**Since:** unreleased
+
+**Usage**
+```
+clever config-provider set <addon-id|config-provider-id|addon-name> <variable-name> <variable-value>
+```
+
+**Arguments**
+```
+addon-id|config-provider-id|addon-name    Add-on ID, real ID (config_xxx) or name (if unambiguous)
+variable-name                             Name of the environment variable
+variable-value                            Value of the environment variable
+```
+
 ## console
 
 **Description:** Open an application in the Console

src/commands/README.md

@@ -22,6 +22,7 @@ These options are available for all commands:
 |[`clever applications`](./applications/applications.docs.md)|List linked applications|
 |[`clever cancel-deploy`](./cancel-deploy/cancel-deploy.docs.md)|Cancel an ongoing deployment|
 |[`clever config`](./config/config.docs.md)|Display or edit the configuration of your application|
+|[`clever config-provider`](./config-provider/config-provider.docs.md)|Manage configuration providers|
 |[`clever console`](./console/console.docs.md)|Open an application in the Console|
 |[`clever create`](./create/create.docs.md)|Create an application|
 |[`clever curl`](./curl/curl.docs.md)|Query Clever Cloud's API using Clever Tools credentials|

src/commands/config-provider/config-provider.args.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { defineArgument } from '../../lib/define-argument.js';
+
+export const configProviderIdOrNameArg = defineArgument({
+  schema: z.string(),
+  description: 'Add-on ID, real ID (config_xxx) or name (if unambiguous)',
+  placeholder: 'addon-id|config-provider-id|addon-name',
+});

src/commands/config-provider/config-provider.command.js

@@ -0,0 +1,10 @@
+import { defineCommand } from '../../lib/define-command.js';
+
+export const configProviderCommand = defineCommand({
+  description: 'Manage configuration providers',
+  since: 'unreleased',
+  options: {},
+  args: [],
+  // Parent command - no handler, only contains subcommands
+  handler: null,
+});

src/commands/config-provider/config-provider.docs.md

@@ -0,0 +1,109 @@
+# 📖 `clever config-provider` command reference
+
+## ➡️ `clever config-provider` <kbd>Since unreleased</kbd>
+
+Manage configuration providers
+
+```bash
+clever config-provider
+```
+
+## ➡️ `clever config-provider get` <kbd>Since unreleased</kbd>
+
+List environment variables of a configuration provider
+
+```bash
+clever config-provider get <addon-id|config-provider-id|addon-name> [options]
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|config-provider-id|addon-name`|Add-on ID, real ID (config_xxx) or name (if unambiguous)|
+
+### ⚙️ Options
+
+|Name|Description|
+|---|---|
+|`-F`, `--format` `<format>`|Output format (human, json, shell) (default: human)|
+
+## ➡️ `clever config-provider import` <kbd>Since unreleased</kbd>
+
+Load environment variables from STDIN
+(WARNING: this deletes all current variables and replaces them with the new list loaded from STDIN)
+
+```bash
+clever config-provider import <addon-id|config-provider-id|addon-name> [options]
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|config-provider-id|addon-name`|Add-on ID, real ID (config_xxx) or name (if unambiguous)|
+
+### ⚙️ Options
+
+|Name|Description|
+|---|---|
+|`-F`, `--format` `<format>`|Input format (name-equals-value, json) (default: name-equals-value)|
+
+## ➡️ `clever config-provider list` <kbd>Since unreleased</kbd>
+
+List configuration providers
+
+```bash
+clever config-provider list [options]
+```
+
+### ⚙️ Options
+
+|Name|Description|
+|---|---|
+|`-F`, `--format` `<format>`|Output format (human, json) (default: human)|
+
+## ➡️ `clever config-provider open` <kbd>Since unreleased</kbd>
+
+Open the configuration provider in Clever Cloud Console
+
+```bash
+clever config-provider open <addon-id|config-provider-id|addon-name>
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|config-provider-id|addon-name`|Add-on ID, real ID (config_xxx) or name (if unambiguous)|
+
+## ➡️ `clever config-provider rm` <kbd>Since unreleased</kbd>
+
+Remove an environment variable from a configuration provider
+
+```bash
+clever config-provider rm <addon-id|config-provider-id|addon-name> <variable-name>
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|config-provider-id|addon-name`|Add-on ID, real ID (config_xxx) or name (if unambiguous)|
+|`variable-name`|Name of the environment variable|
+
+## ➡️ `clever config-provider set` <kbd>Since unreleased</kbd>
+
+Add or update an environment variable named <variable-name> with the value <variable-value>
+
+```bash
+clever config-provider set <addon-id|config-provider-id|addon-name> <variable-name> <variable-value>
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|config-provider-id|addon-name`|Add-on ID, real ID (config_xxx) or name (if unambiguous)|
+|`variable-name`|Name of the environment variable|
+|`variable-value`|Value of the environment variable|

src/commands/config-provider/config-provider.get.command.js

@@ -0,0 +1,36 @@
+import { getConfigProviderEnv } from '@clevercloud/client/esm/api/v4/addon.js';
+import { toNameEqualsValueString } from '@clevercloud/client/esm/utils/env-vars.js';
+import { defineCommand } from '../../lib/define-command.js';
+import { Logger } from '../../logger.js';
+import { resolveConfigProviderId } from '../../models/config-provider.js';
+import { sendToApi } from '../../models/send-to-api.js';
+import { envFormatOption } from '../global.options.js';
+import { configProviderIdOrNameArg } from './config-provider.args.js';
+
+export const configProviderGetCommand = defineCommand({
+  description: 'List environment variables of a configuration provider',
+  since: 'unreleased',
+  options: {
+    format: envFormatOption,
+  },
+  args: [configProviderIdOrNameArg],
+  async handler(options, addonIdOrRealIdOrName) {
+    const { format } = options;
+    const { realId } = await resolveConfigProviderId(addonIdOrRealIdOrName);
+
+    // API returns an array of { name, value } objects
+    const envVars = await getConfigProviderEnv({ configurationProviderId: realId }).then(sendToApi);
+
+    switch (format) {
+      case 'json':
+        Logger.printJson(envVars);
+        break;
+      case 'shell':
+        Logger.println(toNameEqualsValueString(envVars, { addExports: true }));
+        break;
+      case 'human':
+      default:
+        Logger.println(toNameEqualsValueString(envVars, { addExports: false }));
+    }
+  },
+});

src/commands/config-provider/config-provider.import.command.js

@@ -0,0 +1,40 @@
+import { updateConfigProviderEnv } from '@clevercloud/client/esm/api/v4/addon.js';
+import { z } from 'zod';
+import { defineCommand } from '../../lib/define-command.js';
+import { defineOption } from '../../lib/define-option.js';
+import { Logger } from '../../logger.js';
+import { resolveConfigProviderId } from '../../models/config-provider.js';
+import { sendToApi } from '../../models/send-to-api.js';
+import * as variables from '../../models/variables.js';
+import { configProviderIdOrNameArg } from './config-provider.args.js';
+
+const importFormatOption = defineOption({
+  name: 'format',
+  schema: z.enum(['name-equals-value', 'json']).default('name-equals-value'),
+  description: 'Input format (name-equals-value, json)',
+  aliases: ['F'],
+  placeholder: 'format',
+});
+
+export const configProviderImportCommand = defineCommand({
+  description:
+    'Load environment variables from STDIN\n(WARNING: this deletes all current variables and replaces them with the new list loaded from STDIN)',
+  since: 'unreleased',
+  options: {
+    format: importFormatOption,
+  },
+  args: [configProviderIdOrNameArg],
+  async handler(options, addonIdOrRealIdOrName) {
+    const { format } = options;
+    const { realId } = await resolveConfigProviderId(addonIdOrRealIdOrName);
+
+    // readVariablesFromStdin returns { NAME: "value" } format
+    // but the API expects [{ name, value }] format
+    const envVarsObject = await variables.readVariablesFromStdin(format);
+    const envVarsArray = Object.entries(envVarsObject).map(([name, value]) => ({ name, value }));
+
+    await updateConfigProviderEnv({ configurationProviderId: realId }, envVarsArray).then(sendToApi);
+
+    Logger.println('Environment variables have been set');
+  },
+});

src/commands/config-provider/config-provider.list.command.js

@@ -0,0 +1,45 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { styleText } from '../../lib/style-text.js';
+import { Logger } from '../../logger.js';
+import { findAddonsByAddonProvider } from '../../models/ids-resolver.js';
+import { humanJsonOutputFormatOption } from '../global.options.js';
+
+export const configProviderListCommand = defineCommand({
+  description: 'List configuration providers',
+  since: 'unreleased',
+  options: {
+    format: humanJsonOutputFormatOption,
+  },
+  args: [],
+  async handler(options) {
+    const { format } = options;
+    const deployed = await findAddonsByAddonProvider('config-provider');
+    const providersPerOwner = Object.groupBy(deployed, (provider) => provider.ownerId);
+
+    switch (format) {
+      case 'json':
+        Logger.printJson(providersPerOwner);
+        break;
+      case 'human':
+      default:
+        if (deployed.length === 0) {
+          Logger.println(
+            `No configuration provider found, create one with ${styleText('blue', 'clever addon create config-provider')} command`,
+          );
+          return;
+        }
+
+        Logger.println(`Found ${deployed.length} configuration provider${deployed.length > 1 ? 's' : ''}:`);
+        Logger.println();
+
+        Object.values(providersPerOwner).forEach((providers) => {
+          Logger.println(`${styleText('bold', `${providers[0].ownerId} (${providers[0].ownerName})`)}`);
+          providers.forEach((provider) => {
+            Logger.println(`  ${provider.name} ${styleText('grey', `(${provider.realId})`)}`);
+          });
+          Logger.println();
+        });
+        break;
+    }
+  },
+});