storyblok 4.0.4 → 4.1.0

package/dist/index.mjs

@@ -7,24 +7,27 @@ import { Command } from 'commander';
 import { readPackageUp } from 'read-package-up';
 import { Spinner } from '@topcli/spinner';
 import { select, password, input } from '@inquirer/prompts';
-import { mkdir, writeFile, readFile as readFile$1, access, readdir } from 'node:fs/promises';
-import { join, parse, resolve } from 'node:path';
-import { exec } from 'node:child_process';
+import fs, { mkdir, writeFile, readFile as readFile$1, access, readdir } from 'node:fs/promises';
+import path, { join, parse, resolve } from 'node:path';
+import { exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import { minimatch } from 'minimatch';
 import { hash } from 'ohash';
 import { compile } from 'json-schema-to-typescript';
 import { readFileSync } from 'node:fs';
+import open from 'open';
+import { Octokit } from 'octokit';
 
 const commands = {
   LOGIN: "login",
   LOGOUT: "logout",
   SIGNUP: "signup",
   USER: "user",
-  COMPONENTS: "Components",
+  COMPONENTS: "components",
   LANGUAGES: "languages",
-  MIGRATIONS: "Migrations",
-  TYPES: "Types"
+  MIGRATIONS: "migrations",
+  TYPES: "types",
+  CREATE: "create"
 };
 const colorPalette = {
   PRIMARY: "#8d60ff",
@@ -36,6 +39,7 @@ const colorPalette = {
   LANGUAGES: "#f5c003",
   MIGRATIONS: "#8CE2FF",
   TYPES: "#3178C6",
+  CREATE: "#ffb3ba",
   GROUPS: "#4ade80",
   TAGS: "#fbbf24",
   PRESETS: "#a855f7"
@@ -54,6 +58,13 @@ const regionsDomain = {
   ca: "api-ca.storyblok.com",
   ap: "api-ap.storyblok.com"
 };
+const appDomains = {
+  eu: "app.storyblok.com",
+  us: "app-us.storyblok.com",
+  cn: "app.storyblokchina.cn",
+  ca: "app-ca.storyblok.com",
+  ap: "app-ap.storyblok.com"
+};
 const regionNames = {
   eu: "Europe",
   us: "United States",
@@ -159,7 +170,9 @@ const API_ACTIONS = {
   update_component_preset: "Failed to update component preset",
   pull_stories: "Failed to pull stories",
   pull_story: "Failed to pull story",
-  update_story: "Failed to update story"
+  update_story: "Failed to update story",
+  create_space: "Failed to create space",
+  fetch_blueprints: "Failed to fetch blueprints from GitHub"
 };
 const API_ERRORS = {
   unauthorized: "The user is not authorized to access the API",
@@ -388,6 +401,9 @@ const toCamelCase = (str) => {
 const capitalize = (str) => {
   return str.charAt(0).toUpperCase() + str.slice(1);
 };
+const toHumanReadable = (str) => {
+  return str.replace(/[-_]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ").replace(/\s+/g, " ").trim();
+};
 function maskToken(token) {
   if (token.length <= 4) {
     return token;
@@ -718,7 +734,7 @@ function session() {
   return sessionInstance;
 }
 
-const program$e = getProgram();
+const program$f = getProgram();
 const allRegionsText = Object.values(regions).join(",");
 const loginStrategy = {
   message: "How would you like to login?",
@@ -735,12 +751,12 @@ const loginStrategy = {
     }
   ]
 };
-program$e.command(commands.LOGIN).description("Login to the Storyblok CLI").option("-t, --token <token>", "Token to login directly without questions, like for CI environments").option(
+program$f.command(commands.LOGIN).description("Login to the Storyblok CLI").option("-t, --token <token>", "Token to login directly without questions, like for CI environments").option(
   "-r, --region <region>",
   `The region you would like to work in. Please keep in mind that the region must match the region of your space. This region flag will be used for the other cli's commands. You can use the values: ${allRegionsText}.`
 ).action(async (options) => {
   konsola.title(` ${commands.LOGIN} `, colorPalette.LOGIN);
-  const verbose = program$e.opts().verbose;
+  const verbose = program$f.opts().verbose;
   const { token, region } = options;
   const { state, updateSession, persistCredentials, initializeSession } = session();
   await initializeSession();
@@ -859,10 +875,10 @@ program$e.command(commands.LOGIN).description("Login to the Storyblok CLI").opti
   konsola.br();
 });
 
-const program$d = getProgram();
-program$d.command(commands.LOGOUT).description("Logout from the Storyblok CLI").action(async () => {
+const program$e = getProgram();
+program$e.command(commands.LOGOUT).description("Logout from the Storyblok CLI").action(async () => {
   konsola.title(` ${commands.LOGOUT} `, colorPalette.LOGOUT);
-  const verbose = program$d.opts().verbose;
+  const verbose = program$e.opts().verbose;
   try {
     const { state, initializeSession } = session();
     await initializeSession();
@@ -910,10 +926,10 @@ async function openSignupInBrowser(url) {
   }
 }
 
-const program$c = getProgram();
-program$c.command(commands.SIGNUP).description("Sign up for Storyblok").action(async () => {
+const program$d = getProgram();
+program$d.command(commands.SIGNUP).description("Sign up for Storyblok").action(async () => {
   konsola.title(` ${commands.SIGNUP} `, colorPalette.SIGNUP);
-  const verbose = program$c.opts().verbose;
+  const verbose = program$d.opts().verbose;
   const { state, initializeSession } = session();
   await initializeSession();
   if (state.isLoggedIn && !state.envLogin) {
@@ -959,8 +975,8 @@ const getUser = async (token, region) => {
   }
 };
 
-const program$b = getProgram();
-program$b.command(commands.USER).description("Get the current user").action(async () => {
+const program$c = getProgram();
+program$c.command(commands.USER).description("Get the current user").action(async () => {
   konsola.title(` ${commands.USER} `, colorPalette.USER);
   const { state, initializeSession } = session();
   await initializeSession();
@@ -985,8 +1001,8 @@ program$b.command(commands.USER).description("Get the current user").action(asyn
   konsola.br();
 });
 
-const program$a = getProgram();
-const componentsCommand = program$a.command("components").alias("comp").description(`Manage your space's block schema`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/components");
+const program$b = getProgram();
+const componentsCommand = program$b.command("components").alias("comp").description(`Manage your space's block schema`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/components");
 
 let instance = null;
 const createMapiClient = (options) => {
@@ -1448,10 +1464,10 @@ async function readConsolidatedFiles(resolvedPath, suffix) {
   };
 }
 
-const program$9 = getProgram();
+const program$a = getProgram();
 componentsCommand.command("pull [componentName]").option("-f, --filename <filename>", "custom name to be used in file(s) name instead of space id").option("--sf, --separate-files", "Argument to create a single file for each component").option("--su, --suffix <suffix>", "suffix to add to the file name (e.g. components.<suffix>.json)").description(`Download your space's components schema as json. Optionally specify a component name to pull a single component.`).action(async (componentName, options) => {
   konsola.title(` ${commands.COMPONENTS} `, colorPalette.COMPONENTS, componentName ? `Pulling component ${componentName}...` : "Pulling components...");
-  const verbose = program$9.opts().verbose;
+  const verbose = program$a.opts().verbose;
   const { space, path } = componentsCommand.opts();
   const { separateFiles, suffix, filename = "components" } = options;
   const { state, initializeSession } = session();
@@ -1568,9 +1584,16 @@ function buildDependencyGraph(context) {
     const node = new ComponentNode(nodeId, component, targetComponent);
     graph.nodes.set(nodeId, node);
   });
+  const componentMap = new Map(spaceState.local.components.map((c) => [c.id, c]));
   spaceState.local.presets.forEach((preset) => {
-    const nodeId = `preset:${preset.name}`;
-    const targetPreset = spaceState.target.presets.get(preset.name);
+    const nodeId = `preset:${preset.id}`;
+    const sourceComponent = componentMap.get(preset.component_id);
+    if (!sourceComponent) {
+      console.warn(`Warning: Preset "${preset.name}" (ID: ${preset.id}) references component ID ${preset.component_id} which is not available in local data. Skipping preset.`);
+      return;
+    }
+    const compositeKey = `${sourceComponent.name}:${preset.name}`;
+    const targetPreset = spaceState.target.presets.get(compositeKey);
     const targetData = targetPreset ? {
       resource: targetPreset,
       id: targetPreset.id
@@ -1600,7 +1623,7 @@ function buildDependencyGraph(context) {
     if (component.preset_id) {
       const preset = spaceState.local.presets.find((p) => p.id === component.preset_id);
       if (preset) {
-        const presetId = `preset:${preset.name}`;
+        const presetId = `preset:${preset.id}`;
         addDependency(componentId, presetId);
       }
     }
@@ -1621,7 +1644,7 @@ function buildDependencyGraph(context) {
     }
   });
   spaceState.local.presets.forEach((preset) => {
-    const presetId = `preset:${preset.name}`;
+    const presetId = `preset:${preset.id}`;
     const component = spaceState.local.components.find((c) => c.id === preset.component_id);
     if (component) {
       const componentId = `component:${component.name}`;
@@ -1948,7 +1971,7 @@ class ComponentNode extends GraphNode {
     if (this.sourceData.preset_id) {
       const preset = this.findPresetById(this.sourceData.preset_id, graph);
       if (preset) {
-        const presetNodeId = `preset:${preset.name}`;
+        const presetNodeId = `preset:${preset.id}`;
         const presetNode = graph.nodes.get(presetNodeId);
         if (presetNode?.targetData) {
           updatedData.preset_id = presetNode.targetData.id;
@@ -2027,7 +2050,7 @@ class PresetNode {
   constructor(preset, targetData) {
     this.sourceData = preset;
     this.targetData = targetData;
-    this.id = `preset:${preset.name}`;
+    this.id = `preset:${preset.id}`;
     this.name = preset.name;
   }
   getName() {
@@ -2465,10 +2488,10 @@ async function pushWithDependencyGraph(space, spaceState, maxConcurrency = 5) {
   return results;
 }
 
-const program$8 = getProgram();
+const program$9 = getProgram();
 componentsCommand.command("push [componentName]").description(`Push your space's components schema as json`).option("-f, --from <from>", "source space id").option("--fi, --filter <filter>", "glob filter to apply to the components before pushing").option("--sf, --separate-files", "Read from separate files instead of consolidated files").option("--su, --suffix <suffix>", "Suffix to add to the component name").action(async (componentName, options) => {
   konsola.title(` ${commands.COMPONENTS} `, colorPalette.COMPONENTS, componentName ? `Pushing component ${componentName}...` : "Pushing components...");
-  const verbose = program$8.opts().verbose;
+  const verbose = program$9.opts().verbose;
   const { space, path } = componentsCommand.opts();
   const { from, filter } = options;
   const { state, initializeSession } = session();
@@ -2527,7 +2550,11 @@ componentsCommand.command("push [componentName]").description(`Push your space's
     }
     if (presets) {
       presets.forEach((preset) => {
-        spaceState.target.presets.set(preset.name, preset);
+        const targetComponent = components?.find((c) => c.id === preset.component_id);
+        if (targetComponent) {
+          const compositeKey = `${targetComponent.name}:${preset.name}`;
+          spaceState.target.presets.set(compositeKey, preset);
+        }
       });
     }
     if (internalTags) {
@@ -2606,11 +2633,11 @@ const saveLanguagesToFile = async (space, internationalizationOptions, options)
   }
 };
 
-const program$7 = getProgram();
-const languagesCommand = program$7.command("languages").alias("lang").description(`Manage your space's languages`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/languages");
+const program$8 = getProgram();
+const languagesCommand = program$8.command("languages").alias("lang").description(`Manage your space's languages`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/languages");
 languagesCommand.command("pull").description(`Download your space's languages schema as json`).option("-f, --filename <filename>", "filename to save the file as <filename>.<suffix>.json").option("--su, --suffix <suffix>", "suffix to add to the file name (e.g. languages.<suffix>.json). By default, the space ID is used.").action(async (options) => {
   konsola.title(` ${commands.LANGUAGES} `, colorPalette.LANGUAGES);
-  const verbose = program$7.opts().verbose;
+  const verbose = program$8.opts().verbose;
   const { space, path } = languagesCommand.opts();
   const { filename = "languages", suffix = options.space } = options;
   const { state, initializeSession } = session();
@@ -2651,8 +2678,8 @@ languagesCommand.command("pull").description(`Download your space's languages sc
   konsola.br();
 });
 
-const program$6 = getProgram();
-const migrationsCommand = program$6.command("migrations").alias("mig").description(`Manage your space's migrations`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/migrations");
+const program$7 = getProgram();
+const migrationsCommand = program$7.command("migrations").alias("mig").description(`Manage your space's migrations`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/migrations");
 
 const getMigrationTemplate = () => {
   return `export default function (block) {
@@ -2680,10 +2707,10 @@ const generateMigration = async (space, path, component, suffix) => {
   }
 };
 
-const program$5 = getProgram();
+const program$6 = getProgram();
 migrationsCommand.command("generate [componentName]").description("Generate a migration file").option("--su, --suffix <suffix>", "suffix to add to the file name (e.g. {component-name}.<suffix>.js)").action(async (componentName, options) => {
   konsola.title(` ${commands.MIGRATIONS} `, colorPalette.MIGRATIONS, componentName ? `Generating migration for component ${componentName}...` : "Generating migrations...");
-  const verbose = program$5.opts().verbose;
+  const verbose = program$6.opts().verbose;
   const { space, path } = migrationsCommand.opts();
   const { suffix } = options;
   if (!componentName) {
@@ -3099,10 +3126,10 @@ const isStoryWithUnpublishedChanges = (story) => {
   return story.published && story.unpublished_changes;
 };
 
-const program$4 = getProgram();
+const program$5 = getProgram();
 migrationsCommand.command("run [componentName]").description("Run migrations").option("--fi, --filter <filter>", "glob filter to apply to the components before pushing").option("-d, --dry-run", "Preview changes without applying them to Storyblok").option("-q, --query <query>", 'Filter stories by content attributes using Storyblok filter query syntax. Example: --query="[highlighted][in]=true"').option("--starts-with <path>", 'Filter stories by path. Example: --starts-with="/en/blog/"').option("--publish <publish>", "Options for publication mode: all | published | published-with-changes").action(async (componentName, options) => {
   konsola.title(` ${commands.MIGRATIONS} `, colorPalette.MIGRATIONS, componentName ? `Running migrations for component ${componentName}...` : "Running migrations...");
-  const verbose = program$4.opts().verbose;
+  const verbose = program$5.opts().verbose;
   const { filter, dryRun = false, query, startsWith, publish } = options;
   const { space, path } = migrationsCommand.opts();
   const { state, initializeSession } = session();
@@ -3256,10 +3283,10 @@ migrationsCommand.command("run [componentName]").description("Run migrations").o
   }
 });
 
-const program$3 = getProgram();
+const program$4 = getProgram();
 migrationsCommand.command("rollback [migrationFile]").description("Rollback a migration").action(async (migrationFile) => {
   konsola.title(` ${commands.MIGRATIONS} `, colorPalette.MIGRATIONS, `Rolling back migration ${chalk.hex(colorPalette.MIGRATIONS)(migrationFile)}...`);
-  const verbose = program$3.opts().verbose;
+  const verbose = program$4.opts().verbose;
   const { space, path } = migrationsCommand.opts();
   const { state, initializeSession } = session();
   await initializeSession();
@@ -3298,8 +3325,8 @@ migrationsCommand.command("rollback [migrationFile]").description("Rollback a mi
   }
 });
 
-const program$2 = getProgram();
-const typesCommand = program$2.command("types").alias("ts").description(`Generate types d.ts for your component schemas`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/types");
+const program$3 = getProgram();
+const typesCommand = program$3.command(commands.TYPES).alias("ts").description(`Generate types d.ts for your component schemas`).option("-s, --space <space>", "space ID").option("-p, --path <path>", "path to save the file. Default is .storyblok/types");
 
 const getAssetJSONSchema = (title) => ({
   $id: "#/asset",
@@ -3998,20 +4025,11 @@ const generateStoryblokTypes = async (options = {}) => {
   }
 };
 
-const program$1 = getProgram();
+const program$2 = getProgram();
 typesCommand.command("generate").description("Generate types d.ts for your component schemas").option("--sf, --separate-files", "").option("--strict", "strict mode, no loose typing").option("--type-prefix <prefix>", "prefix to be prepended to all generated component type names").option("--suffix <suffix>", "Components suffix").option("--custom-fields-parser <path>", "Path to the parser file for Custom Field Types").option("--compiler-options <options>", "path to the compiler options from json-schema-to-typescript").action(async (options) => {
   konsola.title(` ${commands.TYPES} `, colorPalette.TYPES, "Generating types...");
-  const verbose = program$1.opts().verbose;
+  const verbose = program$2.opts().verbose;
   const { space, path } = typesCommand.opts();
-  const { state, initializeSession } = session();
-  await initializeSession();
-  if (!requireAuthentication(state, verbose)) {
-    return;
-  }
-  if (!space) {
-    handleError(new CommandError(`Please provide the space as argument --space YOUR_SPACE_ID.`), verbose);
-    return;
-  }
   const spinner = new Spinner({
     verbose: !isVitest
   });
@@ -4046,7 +4064,264 @@ typesCommand.command("generate").description("Generate types d.ts for your compo
   }
 });
 
-const version = "4.0.4";
+let octokit;
+let lastToken;
+const createOctokit = (token) => {
+  if (!octokit || token !== lastToken) {
+    const options = {
+      request: {
+        fetch
+      }
+    };
+    octokit = new Octokit(options);
+  }
+  return octokit;
+};
+
+const generateProject = async (blueprint, projectName, targetPath = process.cwd()) => {
+  try {
+    const projectPath = path.join(targetPath, projectName);
+    const templateRepo = `storyblok/blueprint-core-${blueprint}`;
+    try {
+      await fs.access(projectPath);
+      const existsError = new Error(`Directory ${projectName} already exists`);
+      existsError.code = "ENOTEMPTY";
+      existsError.path = projectPath;
+      throw new FileSystemError("directory_not_empty", "mkdir", existsError, `Directory ${projectName} already exists`);
+    } catch (error) {
+      const fsError = error;
+      if (fsError.code === "ENOENT") {
+      } else {
+        handleFileSystemError("read", fsError);
+      }
+    }
+    const degitProcess = spawn("npx", ["degit", templateRepo, projectPath], {
+      stdio: "inherit",
+      shell: true
+    });
+    return new Promise((resolve, reject) => {
+      degitProcess.on("close", (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`Failed to clone template. Process exited with code ${code}`));
+        }
+      });
+      degitProcess.on("error", (error) => {
+        reject(new Error(`Failed to spawn degit process: ${error.message}`));
+      });
+    });
+  } catch (error) {
+    handleFileSystemError("read", error);
+  }
+};
+const createEnvFile = async (projectPath, accessToken, additionalVars) => {
+  try {
+    const envPath = path.join(projectPath, ".env");
+    let envContent = `# Storyblok Configuration
+STORYBLOK_DELIVERY_API_TOKEN=${accessToken}
+`;
+    if (additionalVars && Object.keys(additionalVars).length > 0) ;
+    await saveToFile(envPath, envContent);
+  } catch (error) {
+    throw new Error(`Failed to create .env file: ${error.message}`);
+  }
+};
+const generateSpaceUrl = (spaceId, region) => {
+  const domain = appDomains[region];
+  return `https://${domain}/#/me/spaces/${spaceId}/dashboard`;
+};
+const openSpaceInBrowser = async (spaceId, region) => {
+  try {
+    const spaceUrl = generateSpaceUrl(spaceId, region);
+    await open(spaceUrl);
+  } catch (error) {
+    throw new Error(`Failed to open space in browser: ${error.message}`);
+  }
+};
+const extractPortFromTopics = (topics) => {
+  const portTopic = topics.find((topic) => topic.startsWith("port-"));
+  if (portTopic) {
+    const port = portTopic.replace("port-", "");
+    if (/^\d+$/.test(port) && Number.parseInt(port) > 0 && Number.parseInt(port) <= 65535) {
+      return port;
+    }
+  }
+  return "3000";
+};
+const repositoryToBlueprint = (repo) => {
+  const technology = repo.name.replace("blueprint-core-", "");
+  const port = extractPortFromTopics(repo.topics || []);
+  return {
+    name: technology.charAt(0).toUpperCase() + technology.slice(1),
+    value: technology,
+    template: repo.clone_url,
+    location: port ? `https://localhost:${port}/` : "https://localhost:3000/",
+    description: repo.description,
+    updated_at: repo.updated_at
+  };
+};
+const fetchBlueprintRepositories = async () => {
+  try {
+    const octokit = createOctokit();
+    const { data } = await octokit.rest.search.repos({
+      q: "org:storyblok blueprint-core-",
+      sort: "updated",
+      order: "desc",
+      per_page: 100
+    });
+    const blueprints = data.items.filter((repo) => repo.name.startsWith("blueprint-core-")).map(repositoryToBlueprint).sort((a, b) => a.name.localeCompare(b.name));
+    return blueprints;
+  } catch (error) {
+    handleAPIError("fetch_blueprints", error, "Failed to fetch blueprints from GitHub");
+  }
+};
+
+const createSpace = async (space) => {
+  try {
+    const client = mapiClient();
+    const { data } = await client.post("spaces", {
+      body: JSON.stringify(space)
+    });
+    return data.space;
+  } catch (error) {
+    handleAPIError("create_space", error, `Failed to create space ${space.name}`);
+  }
+};
+
+const program$1 = getProgram();
+program$1.command(`${commands.CREATE} [project-path]`).alias("c").description(`Scaffold a new project using Storyblok`).option("-b, --blueprint <blueprint>", "technology starter blueprint").option("--skip-space", "skip space creation").action(async (projectPath, options) => {
+  konsola.title(` ${commands.CREATE} `, colorPalette.CREATE);
+  const verbose = program$1.opts().verbose;
+  const { blueprint } = options;
+  const { state, initializeSession } = session();
+  await initializeSession();
+  if (!requireAuthentication(state, verbose)) {
+    return;
+  }
+  const { password, region } = state;
+  mapiClient({
+    token: password,
+    region
+  });
+  const spinnerBlueprints = new Spinner({
+    verbose: !isVitest
+  });
+  const spinnerSpace = new Spinner({
+    verbose: !isVitest
+  });
+  try {
+    spinnerBlueprints.start("Fetching starter blueprints...");
+    const blueprints = await fetchBlueprintRepositories();
+    spinnerBlueprints.succeed("Starter blueprints fetched successfully");
+    if (!blueprints) {
+      spinnerBlueprints.failed();
+      konsola.warn("No starter blueprints found. Please contact support@storyblok.com");
+      konsola.br();
+      return;
+    }
+    let technologyBlueprint = blueprint;
+    if (blueprint) {
+      const validBlueprints = blueprints;
+      const isValidBlueprint = validBlueprints.find((bp) => bp.value === blueprint);
+      if (!isValidBlueprint) {
+        const validOptions = validBlueprints.map((bp) => bp.value).join(", ");
+        konsola.warn(`Invalid blueprint "${chalk.hex(colorPalette.CREATE)(blueprint)}". Valid options are: ${chalk.hex(colorPalette.CREATE)(validOptions)}`);
+        konsola.br();
+        technologyBlueprint = void 0;
+      }
+    }
+    if (!technologyBlueprint) {
+      technologyBlueprint = await select({
+        message: "Please select the technology you would like to use:",
+        choices: blueprints.map((blueprint2) => ({
+          name: blueprint2.name,
+          value: blueprint2.value
+        }))
+      });
+    }
+    let finalProjectPath = projectPath;
+    if (!projectPath) {
+      finalProjectPath = await input({
+        message: "What is the path for your project?",
+        default: `./my-${technologyBlueprint}-project`,
+        validate: (value) => {
+          if (!value.trim()) {
+            return "Project path is required";
+          }
+          const projectName2 = path.basename(value);
+          if (!/^[\w-]+$/.test(projectName2)) {
+            return "Project name (last part of the path) can only contain letters, numbers, hyphens, and underscores";
+          }
+          return true;
+        }
+      });
+    }
+    const resolvedPath = path.resolve(finalProjectPath);
+    const targetDirectory = path.dirname(resolvedPath);
+    const projectName = path.basename(resolvedPath);
+    konsola.br();
+    konsola.info(`Scaffolding your project using the ${chalk.hex(colorPalette.CREATE)(technologyBlueprint)} blueprint...`);
+    await generateProject(technologyBlueprint, projectName, targetDirectory);
+    konsola.ok(`Project ${chalk.hex(colorPalette.PRIMARY)(projectName)} created successfully in ${chalk.hex(colorPalette.PRIMARY)(finalProjectPath)}`, true);
+    let createdSpace;
+    if (!options.skipSpace) {
+      try {
+        spinnerSpace.start(`Creating space "${toHumanReadable(projectName)}"`);
+        const selectedBlueprint = blueprints.find((bp) => bp.value === technologyBlueprint);
+        const blueprintDomain = selectedBlueprint?.location || "https://localhost:3000/";
+        createdSpace = await createSpace({
+          name: toHumanReadable(projectName),
+          domain: blueprintDomain
+        });
+        spinnerSpace.succeed(`Space "${chalk.hex(colorPalette.PRIMARY)(toHumanReadable(projectName))}" created successfully`);
+      } catch (error) {
+        spinnerSpace.failed();
+        konsola.br();
+        handleError(error, verbose);
+        return;
+      }
+    }
+    if (createdSpace?.first_token) {
+      try {
+        await createEnvFile(resolvedPath, createdSpace.first_token);
+        konsola.ok(`Created .env file with Storyblok access token`, true);
+      } catch (error) {
+        konsola.warn(`Failed to create .env file: ${error.message}`);
+        konsola.info(`You can manually add this token to your .env file: ${createdSpace.first_token}`);
+      }
+    }
+    if (createdSpace?.id) {
+      try {
+        await openSpaceInBrowser(createdSpace.id, region);
+        konsola.info(`Opened space in your browser`);
+      } catch (error) {
+        konsola.warn(`Failed to open browser: ${error.message}`);
+        const spaceUrl = generateSpaceUrl(createdSpace.id, region);
+        konsola.info(`You can manually open your space at: ${chalk.hex(colorPalette.PRIMARY)(spaceUrl)}`);
+      }
+    }
+    konsola.br();
+    konsola.ok(`Your ${chalk.hex(colorPalette.PRIMARY)(technologyBlueprint)} project is ready \u{1F389} !`);
+    if (createdSpace?.first_token) {
+      konsola.ok(`Storyblok space created, preview url and .env configured automatically`);
+    }
+    konsola.br();
+    konsola.info(`Next steps:
+  cd ${finalProjectPath}
+  npm install
+  npm run dev
+`);
+  } catch (error) {
+    spinnerSpace.failed();
+    spinnerBlueprints.failed();
+    konsola.br();
+    handleError(error, verbose);
+  }
+  konsola.br();
+});
+
+const version = "4.1.0";
 const pkg = {
 	version: version};