@strapi/cloud-cli 0.0.0-next.ea6e3b80ab37f554da4f8bde08dbfe9b57400d31 → 0.0.0-next.ec9b1b708d4d319f2b8b39d9397bd752d250d541

package/dist/index.js

@@ -35,6 +35,7 @@ const minimatch = require("minimatch");
 const fp = require("lodash/fp");
 const os = require("os");
 const XDGAppPaths = require("xdg-app-paths");
+const lodash = require("lodash");
 const jwksClient = require("jwks-rsa");
 const jwt = require("jsonwebtoken");
 const stringify = require("fast-safe-stringify");
@@ -177,7 +178,7 @@ async function getConfigPath() {
   }
   return configPath;
 }
-async function getLocalConfig() {
+async function getLocalConfig$1() {
   const configPath = await getConfigPath();
   const configFilePath = path__namespace.default.join(configPath, CONFIG_FILENAME);
   await fse__namespace.default.ensureFile(configFilePath);
@@ -193,7 +194,7 @@ async function saveLocalConfig(data) {
   await fse__namespace.default.writeJson(configFilePath, data, { encoding: "utf8", spaces: 2, mode: 384 });
 }
 const name = "@strapi/cloud-cli";
-const version = "5.3.0";
+const version = "5.4.0";
 const description = "Commands to interact with the Strapi Cloud";
 const keywords = [
   "strapi",
@@ -238,7 +239,7 @@ const scripts = {
   watch: "pack-up watch"
 };
 const dependencies = {
-  "@strapi/utils": "workspace:*",
+  "@strapi/utils": "5.4.0",
   axios: "1.7.4",
   chalk: "4.1.2",
   "cli-progress": "3.12.0",
@@ -263,13 +264,14 @@ const devDependencies = {
   "@types/cli-progress": "3.11.5",
   "@types/eventsource": "1.1.15",
   "@types/lodash": "^4.14.191",
-  "eslint-config-custom": "workspace:*",
-  tsconfig: "workspace:*"
+  "eslint-config-custom": "5.4.0",
+  tsconfig: "5.4.0"
 };
 const engines = {
   node: ">=18.0.0 <=22.x.x",
   npm: ">=6.0.0"
 };
+const gitHead = "7d785703f52464577d077c4618cbe68b44f8a9cd";
 const packageJson = {
   name,
   version,
@@ -290,11 +292,12 @@ const packageJson = {
   scripts,
   dependencies,
   devDependencies,
-  engines
+  engines,
+  gitHead
 };
 const VERSION = "v1";
 async function cloudApiFactory({ logger }, token) {
-  const localConfig = await getLocalConfig();
+  const localConfig = await getLocalConfig$1();
   const customHeaders = {
     "x-device-id": localConfig.deviceId,
     "x-app-version": packageJson.version,
@@ -402,6 +405,20 @@ async function cloudApiFactory({ logger }, token) {
         throw error;
       }
     },
+    async listLinkEnvironments({ name: name2 }) {
+      try {
+        const response = await axiosCloudAPI.get(`/projects/${name2}/environments-linkable`);
+        if (response.status !== 200) {
+          throw new Error("Error fetching cloud environments from the server.");
+        }
+        return response;
+      } catch (error) {
+        logger.debug(
+          "🥲 Oops! Couldn't retrieve your project's environments from the server. Please try again."
+        );
+        throw error;
+      }
+    },
     async getProject({ name: name2 }) {
       try {
         const response = await axiosCloudAPI.get(`/projects/${name2}`);
@@ -425,26 +442,43 @@ async function cloudApiFactory({ logger }, token) {
   };
 }
 const LOCAL_SAVE_FILENAME = ".strapi-cloud.json";
+const getFilePath = (directoryPath) => path__namespace.default.join(directoryPath || process.cwd(), LOCAL_SAVE_FILENAME);
 async function save(data, { directoryPath } = {}) {
-  const alreadyInFileData = await retrieve({ directoryPath });
-  const storedData = { ...alreadyInFileData, ...data };
-  const pathToFile = path__namespace.default.join(directoryPath || process.cwd(), LOCAL_SAVE_FILENAME);
+  const pathToFile = getFilePath(directoryPath);
   await fse__namespace.default.ensureDir(path__namespace.default.dirname(pathToFile));
-  await fse__namespace.default.writeJson(pathToFile, storedData, { encoding: "utf8" });
+  await fse__namespace.default.writeJson(pathToFile, data, { encoding: "utf8" });
 }
 async function retrieve({
   directoryPath
 } = {}) {
-  const pathToFile = path__namespace.default.join(directoryPath || process.cwd(), LOCAL_SAVE_FILENAME);
+  const pathToFile = getFilePath(directoryPath);
   const pathExists = await fse__namespace.default.pathExists(pathToFile);
   if (!pathExists) {
     return {};
   }
   return fse__namespace.default.readJSON(pathToFile, { encoding: "utf8" });
 }
+async function patch(patchData, { directoryPath } = {}) {
+  const pathToFile = getFilePath(directoryPath);
+  const existingData = await retrieve({ directoryPath });
+  if (!existingData) {
+    throw new Error("No configuration data found to patch.");
+  }
+  const newData = lodash.merge(existingData, patchData);
+  await fse__namespace.default.writeJson(pathToFile, newData, { encoding: "utf8" });
+}
+async function deleteConfig({ directoryPath } = {}) {
+  const pathToFile = getFilePath(directoryPath);
+  const pathExists = await fse__namespace.default.pathExists(pathToFile);
+  if (pathExists) {
+    await fse__namespace.default.remove(pathToFile);
+  }
+}
 const strapiInfoSave = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   LOCAL_SAVE_FILENAME,
+  deleteConfig,
+  patch,
   retrieve,
   save
 }, Symbol.toStringTag, { value: "Module" }));
@@ -452,7 +486,7 @@ let cliConfig;
 async function tokenServiceFactory({ logger }) {
   const cloudApiService = await cloudApiFactory({ logger });
   async function saveToken(str) {
-    const appConfig = await getLocalConfig();
+    const appConfig = await getLocalConfig$1();
     if (!appConfig) {
       logger.error("There was a problem saving your token. Please try again.");
       return;
@@ -466,7 +500,7 @@ async function tokenServiceFactory({ logger }) {
     }
   }
   async function retrieveToken() {
-    const appConfig = await getLocalConfig();
+    const appConfig = await getLocalConfig$1();
     if (appConfig.token) {
       if (await isTokenValid(appConfig.token)) {
         return appConfig.token;
@@ -528,7 +562,7 @@ async function tokenServiceFactory({ logger }) {
     }
   }
   async function eraseToken() {
-    const appConfig = await getLocalConfig();
+    const appConfig = await getLocalConfig$1();
     if (!appConfig) {
       return;
     }
@@ -974,7 +1008,7 @@ async function createProject$1(ctx, cloudApi, projectInput) {
     throw e;
   }
 }
-const action$5 = async (ctx) => {
+const action$6 = async (ctx) => {
   const { logger } = ctx;
   const { getValidToken, eraseToken } = await tokenServiceFactory(ctx);
   const token = await getValidToken(ctx, promptLogin);
@@ -1103,7 +1137,7 @@ const buildLogsServiceFactory = ({ logger }) => {
     });
   };
 };
-const QUIT_OPTION$1 = "Quit";
+const QUIT_OPTION$2 = "Quit";
 async function promptForEnvironment(environments) {
   const choices = environments.map((env) => ({ name: env, value: env }));
   const { selectedEnvironment } = await inquirer__default.default.prompt([
@@ -1111,7 +1145,7 @@ async function promptForEnvironment(environments) {
       type: "list",
       name: "selectedEnvironment",
       message: "Select the environment to deploy:",
-      choices: [...choices, { name: chalk__default.default.grey(`(${QUIT_OPTION$1})`), value: null }]
+      choices: [...choices, { name: chalk__default.default.grey(`(${QUIT_OPTION$2})`), value: null }]
     }
   ]);
   if (selectedEnvironment === null) {
@@ -1207,11 +1241,11 @@ async function upload(ctx, project, token, maxProjectFileSize) {
     process.exit(1);
   }
 }
-async function getProject$1(ctx) {
+async function getProject(ctx) {
   const { project } = await retrieve();
   if (!project) {
     try {
-      return await action$5(ctx);
+      return await action$6(ctx);
     } catch (e) {
       ctx.logger.error("An error occurred while deploying the project. Please try again later.");
       ctx.logger.debug(e);
@@ -1232,13 +1266,32 @@ async function getConfig({
     return null;
   }
 }
-const action$4 = async (ctx, opts) => {
+function validateEnvironment(ctx, environment, environments) {
+  if (!environments.includes(environment)) {
+    ctx.logger.error(`Environment ${environment} does not exist.`);
+    process.exit(1);
+  }
+}
+async function getTargetEnvironment(ctx, opts, project, environments) {
+  if (opts.env) {
+    validateEnvironment(ctx, opts.env, environments);
+    return opts.env;
+  }
+  if (project.targetEnvironment) {
+    return project.targetEnvironment;
+  }
+  if (environments.length > 1) {
+    return promptForEnvironment(environments);
+  }
+  return environments[0];
+}
+const action$5 = async (ctx, opts) => {
   const { getValidToken } = await tokenServiceFactory(ctx);
   const token = await getValidToken(ctx, promptLogin);
   if (!token) {
     return;
   }
-  const project = await getProject$1(ctx);
+  const project = await getProject(ctx);
   if (!project) {
     return;
   }
@@ -1296,22 +1349,15 @@ Please link your local project to an existing Strapi Cloud project using the ${c
     );
     maxSize = 1e8;
   }
-  let targetEnvironment;
-  if (opts.environment) {
-    if (!environments.includes(opts.environment)) {
-      ctx.logger.error(`Environment ${opts.environment} does not exist.`);
-      return;
-    }
-    targetEnvironment = opts.environment;
-  } else {
-    targetEnvironment = environments.length > 1 ? await promptForEnvironment(environments) : environments[0];
-  }
-  project.targetEnvironment = targetEnvironment;
+  project.targetEnvironment = await getTargetEnvironment(ctx, opts, project, environments);
   const buildId = await upload(ctx, project, token, maxSize);
   if (!buildId) {
     return;
   }
   try {
+    ctx.logger.log(
+      `🚀 Deploying project to ${chalk__default.default.cyan(project.targetEnvironment ?? `production`)} environment...`
+    );
     notificationService(`${apiConfig.apiBaseUrl}/notifications`, token, cliConfig2);
     await buildLogsService(`${apiConfig.apiBaseUrl}/v1/logs/${buildId}`, token, cliConfig2);
     ctx.logger.log(
@@ -1356,17 +1402,16 @@ const runAction = (name2, action2) => (...args) => {
     process.exit(1);
   });
 };
-const command$6 = ({ ctx }) => {
-  return commander.createCommand("cloud:deploy").alias("deploy").description("Deploy a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").option("-e, --environment <name>", "Specify the environment to deploy").action((opts) => runAction("deploy", action$4)(ctx, opts));
+const command$7 = ({ ctx }) => {
+  return commander.createCommand("cloud:deploy").alias("deploy").description("Deploy a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").option("-e, --env <name>", "Specify the environment to deploy").action((opts) => runAction("deploy", action$5)(ctx, opts));
 };
 const deployProject = {
   name: "deploy-project",
   description: "Deploy a Strapi Cloud project",
-  action: action$4,
-  command: command$6
+  action: action$5,
+  command: command$7
 };
-const QUIT_OPTION = "Quit";
-async function getExistingConfig(ctx) {
+async function getLocalConfig(ctx) {
   try {
     return await retrieve();
   } catch (e) {
@@ -1375,6 +1420,21 @@ async function getExistingConfig(ctx) {
     return null;
   }
 }
+async function getLocalProject(ctx) {
+  const localConfig = await getLocalConfig(ctx);
+  if (!localConfig || !localConfig.project) {
+    ctx.logger.warn(
+      `
+We couldn't find a valid local project config.
+Please link your local project to an existing Strapi Cloud project using the ${chalk__default.default.cyan(
+        "link"
+      )} command.`
+    );
+    process.exit(1);
+  }
+  return localConfig.project;
+}
+const QUIT_OPTION$1 = "Quit";
 async function promptForRelink(ctx, cloudApiService, existingConfig) {
   if (existingConfig && existingConfig.project) {
     const { shouldRelink } = await inquirer__default.default.prompt([
@@ -1404,7 +1464,7 @@ async function getProjectsList(ctx, cloudApiService, existingConfig) {
     } = await cloudApiService.listLinkProjects();
     spinner.succeed();
     if (!Array.isArray(projectList)) {
-      ctx.logger.log("We couldn't find any projects available for linking in Strapi Cloud");
+      ctx.logger.log("We couldn't find any projects available for linking in Strapi Cloud.");
       return null;
     }
     const projects = projectList.filter(
@@ -1416,7 +1476,7 @@ async function getProjectsList(ctx, cloudApiService, existingConfig) {
       };
     });
     if (projects.length === 0) {
-      ctx.logger.log("We couldn't find any projects available for linking in Strapi Cloud");
+      ctx.logger.log("We couldn't find any projects available for linking in Strapi Cloud.");
       return null;
     }
     return projects;
@@ -1434,7 +1494,7 @@ async function getUserSelection(ctx, projects) {
         type: "list",
         name: "linkProject",
         message: "Which project do you want to link?",
-        choices: [...projects, { name: chalk__default.default.grey(`(${QUIT_OPTION})`), value: null }]
+        choices: [...projects, { name: chalk__default.default.grey(`(${QUIT_OPTION$1})`), value: null }]
       }
     ]);
     if (!answer.linkProject) {
@@ -1447,7 +1507,7 @@ async function getUserSelection(ctx, projects) {
     return null;
   }
 }
-const action$3 = async (ctx) => {
+const action$4 = async (ctx) => {
   const { getValidToken } = await tokenServiceFactory(ctx);
   const token = await getValidToken(ctx, promptLogin);
   const { logger } = ctx;
@@ -1455,7 +1515,7 @@ const action$3 = async (ctx) => {
     return;
   }
   const cloudApiService = await cloudApiFactory(ctx, token);
-  const existingConfig = await getExistingConfig(ctx);
+  const existingConfig = await getLocalConfig(ctx);
   const shouldRelink = await promptForRelink(ctx, cloudApiService, existingConfig);
   if (!shouldRelink) {
     return;
@@ -1490,7 +1550,9 @@ const action$3 = async (ctx) => {
       return;
     }
     await save({ project: answer.linkProject });
-    logger.log(`Project ${chalk__default.default.cyan(answer.linkProject.displayName)} linked successfully.`);
+    logger.log(
+      ` You have successfully linked your project to ${chalk__default.default.cyan(answer.linkProject.displayName)}. You are now able to deploy your project.`
+    );
     await trackEvent(ctx, cloudApiService, "didLinkProject", {
       projectInternalName: answer.linkProject
     });
@@ -1502,16 +1564,16 @@ const action$3 = async (ctx) => {
     });
   }
 };
-const command$5 = ({ command: command2, ctx }) => {
-  command2.command("cloud:link").alias("link").description("Link a local directory to a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("link", action$3)(ctx));
+const command$6 = ({ command: command2, ctx }) => {
+  command2.command("cloud:link").alias("link").description("Link a local directory to a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("link", action$4)(ctx));
 };
 const link = {
   name: "link-project",
   description: "Link a local directory to a Strapi Cloud project",
-  action: action$3,
-  command: command$5
+  action: action$4,
+  command: command$6
 };
-const command$4 = ({ ctx }) => {
+const command$5 = ({ ctx }) => {
   return commander.createCommand("cloud:login").alias("login").description("Strapi Cloud Login").addHelpText(
     "after",
     "\nAfter running this command, you will be prompted to enter your authentication information."
@@ -1521,10 +1583,10 @@ const login = {
   name: "login",
   description: "Strapi Cloud Login",
   action: loginAction,
-  command: command$4
+  command: command$5
 };
 const openModule = import("open");
-const action$2 = async (ctx) => {
+const action$3 = async (ctx) => {
   const { logger } = ctx;
   const { retrieveToken, eraseToken } = await tokenServiceFactory(ctx);
   const token = await retrieveToken();
@@ -1556,25 +1618,25 @@ const action$2 = async (ctx) => {
   }
   await trackEvent(ctx, cloudApiService, "didLogout", { loginMethod: "cli" });
 };
-const command$3 = ({ ctx }) => {
-  return commander.createCommand("cloud:logout").alias("logout").description("Strapi Cloud Logout").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("logout", action$2)(ctx));
+const command$4 = ({ ctx }) => {
+  return commander.createCommand("cloud:logout").alias("logout").description("Strapi Cloud Logout").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("logout", action$3)(ctx));
 };
 const logout = {
   name: "logout",
   description: "Strapi Cloud Logout",
-  action: action$2,
-  command: command$3
+  action: action$3,
+  command: command$4
 };
-const command$2 = ({ ctx }) => {
-  return commander.createCommand("cloud:create-project").description("Create a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("cloud:create-project", action$5)(ctx));
+const command$3 = ({ ctx }) => {
+  return commander.createCommand("cloud:create-project").description("Create a Strapi Cloud project").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("cloud:create-project", action$6)(ctx));
 };
 const createProject = {
   name: "create-project",
   description: "Create a new project",
-  action: action$5,
-  command: command$2
+  action: action$6,
+  command: command$3
 };
-const action$1 = async (ctx) => {
+const action$2 = async (ctx) => {
   const { getValidToken } = await tokenServiceFactory(ctx);
   const token = await getValidToken(ctx, promptLogin);
   const { logger } = ctx;
@@ -1594,37 +1656,23 @@ const action$1 = async (ctx) => {
     spinner.fail("An error occurred while fetching your projects from Strapi Cloud.");
   }
 };
-const command$1 = ({ command: command2, ctx }) => {
-  command2.command("cloud:projects").alias("projects").description("List Strapi Cloud projects").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("projects", action$1)(ctx));
+const command$2 = ({ command: command2, ctx }) => {
+  command2.command("cloud:projects").alias("projects").description("List Strapi Cloud projects").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("projects", action$2)(ctx));
 };
 const listProjects = {
   name: "list-projects",
   description: "List Strapi Cloud projects",
-  action: action$1,
-  command: command$1
+  action: action$2,
+  command: command$2
 };
-async function getProject(ctx) {
-  const { project } = await retrieve();
-  if (!project) {
-    ctx.logger.warn(
-      `
-We couldn't find a valid local project config.
-Please link your local project to an existing Strapi Cloud project using the ${chalk__default.default.cyan(
-        "link"
-      )} command`
-    );
-    process.exit(1);
-  }
-  return project;
-}
-const action = async (ctx) => {
+const action$1 = async (ctx) => {
   const { getValidToken } = await tokenServiceFactory(ctx);
   const token = await getValidToken(ctx, promptLogin);
   const { logger } = ctx;
   if (!token) {
     return;
   }
-  const project = await getProject(ctx);
+  const project = await getLocalProject(ctx);
   if (!project) {
     ctx.logger.debug(`No valid local project configuration was found.`);
     return;
@@ -1664,7 +1712,7 @@ Please link your local project to an existing Strapi Cloud project using the ${c
 };
 function defineCloudNamespace(command2, ctx) {
   const cloud = command2.command("cloud").description("Manage Strapi Cloud projects");
-  cloud.command("environments").description("Alias for cloud environment list").action(() => runAction("list", action)(ctx));
+  cloud.command("environments").description("Alias for cloud environment list").action(() => runAction("list", action$1)(ctx));
   return cloud;
 }
 let environmentCmd = null;
@@ -1675,13 +1723,127 @@ const initializeEnvironmentCommand = (command2, ctx) => {
   }
   return environmentCmd;
 };
-const command = ({ command: command2, ctx }) => {
+const command$1 = ({ command: command2, ctx }) => {
   const environmentCmd2 = initializeEnvironmentCommand(command2, ctx);
-  environmentCmd2.command("list").description("List Strapi Cloud project environments").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("list", action)(ctx));
+  environmentCmd2.command("list").description("List Strapi Cloud project environments").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("list", action$1)(ctx));
 };
 const listEnvironments = {
   name: "list-environments",
   description: "List Strapi Cloud environments",
+  action: action$1,
+  command: command$1
+};
+const QUIT_OPTION = "Quit";
+const action = async (ctx) => {
+  const { getValidToken } = await tokenServiceFactory(ctx);
+  const token = await getValidToken(ctx, promptLogin);
+  const { logger } = ctx;
+  if (!token) {
+    return;
+  }
+  const project = await getLocalProject(ctx);
+  if (!project) {
+    logger.debug(`No valid local project configuration was found.`);
+    return;
+  }
+  const cloudApiService = await cloudApiFactory(ctx, token);
+  const environments = await getEnvironmentsList(ctx, cloudApiService, project);
+  if (!environments) {
+    logger.debug(`Fetching environments failed.`);
+    return;
+  }
+  if (environments.length === 0) {
+    logger.log(
+      `The only available environment is already linked. You can add a new one from your project settings on the Strapi Cloud dashboard.`
+    );
+    return;
+  }
+  const answer = await promptUserForEnvironment(ctx, environments);
+  if (!answer) {
+    return;
+  }
+  await trackEvent(ctx, cloudApiService, "willLinkEnvironment", {
+    projectName: project.name,
+    environmentName: answer.targetEnvironment
+  });
+  try {
+    await patch({ project: { targetEnvironment: answer.targetEnvironment } });
+  } catch (e) {
+    await trackEvent(ctx, cloudApiService, "didNotLinkEnvironment", {
+      projectName: project.name,
+      environmentName: answer.targetEnvironment
+    });
+    logger.debug("Failed to link environment", e);
+    logger.error(
+      "Failed to link the environment. If this issue persists, try re-linking your project or contact support."
+    );
+    process.exit(1);
+  }
+  logger.log(
+    ` You have successfully linked your project to ${chalk__default.default.cyan(answer.targetEnvironment)}, on ${chalk__default.default.cyan(project.displayName)}. You are now able to deploy your project.`
+  );
+  await trackEvent(ctx, cloudApiService, "didLinkEnvironment", {
+    projectName: project.name,
+    environmentName: answer.targetEnvironment
+  });
+};
+async function promptUserForEnvironment(ctx, environments) {
+  const { logger } = ctx;
+  try {
+    const answer = await inquirer__default.default.prompt([
+      {
+        type: "list",
+        name: "targetEnvironment",
+        message: "Which environment do you want to link?",
+        choices: [...environments, { name: chalk__default.default.grey(`(${QUIT_OPTION})`), value: null }]
+      }
+    ]);
+    if (!answer.targetEnvironment) {
+      return null;
+    }
+    return answer;
+  } catch (e) {
+    logger.debug("Failed to get user input", e);
+    logger.error("An error occurred while trying to get your environment selection.");
+    return null;
+  }
+}
+async function getEnvironmentsList(ctx, cloudApiService, project) {
+  const spinner = ctx.logger.spinner("Fetching environments...\n").start();
+  try {
+    const {
+      data: { data: environmentsList }
+    } = await cloudApiService.listLinkEnvironments({ name: project.name });
+    if (!Array.isArray(environmentsList) || environmentsList.length === 0) {
+      throw new Error("Environments not found in server response");
+    }
+    spinner.succeed();
+    return environmentsList.filter(
+      (environment) => environment.name !== project.targetEnvironment
+    );
+  } catch (e) {
+    if (e.response && e.response.status === 404) {
+      spinner.succeed();
+      ctx.logger.warn(
+        `
+The project associated with this folder does not exist in Strapi Cloud. 
+Please link your local project to an existing Strapi Cloud project using the ${chalk__default.default.cyan(
+          "link"
+        )} command.`
+      );
+    } else {
+      spinner.fail("An error occurred while fetching environments data from Strapi Cloud.");
+      ctx.logger.debug("Failed to list environments", e);
+    }
+  }
+}
+const command = ({ command: command2, ctx }) => {
+  const environmentCmd2 = initializeEnvironmentCommand(command2, ctx);
+  environmentCmd2.command("link").description("Link project to a specific Strapi Cloud project environment").option("-d, --debug", "Enable debugging mode with verbose logs").option("-s, --silent", "Don't log anything").action(() => runAction("link", action)(ctx));
+};
+const linkEnvironment = {
+  name: "link-environment",
+  description: "Link Strapi Cloud environment to a local project",
   action,
   command
 };
@@ -1691,12 +1853,21 @@ const cli = {
   login,
   logout,
   createProject,
+  linkEnvironment,
   listProjects,
   listEnvironments
 };
-const cloudCommands = [deployProject, link, login, logout, listProjects, listEnvironments];
+const cloudCommands = [
+  deployProject,
+  link,
+  login,
+  logout,
+  linkEnvironment,
+  listProjects,
+  listEnvironments
+];
 async function initCloudCLIConfig() {
-  const localConfig = await getLocalConfig();
+  const localConfig = await getLocalConfig$1();
   if (!localConfig.deviceId) {
     localConfig.deviceId = crypto__default.default.randomUUID();
   }