@bigcommerce/create-catalyst 0.19.0 → 0.21.0

package/dist/index.js

@@ -53,12 +53,12 @@ var __async = (__this, __arguments, generator) => {
 
 // src/index.ts
 import { program } from "@commander-js/extra-typings";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // package.json
 var package_default = {
   name: "@bigcommerce/create-catalyst",
-  version: "0.19.0",
+  version: "0.21.0",
   type: "module",
   bin: "bin/index.cjs",
   files: [
@@ -76,18 +76,23 @@ var package_default = {
     node: ">=20.0.0"
   },
   dependencies: {
-    "@commander-js/extra-typings": "^12.1.0",
+    "@commander-js/extra-typings": "^13.1.0",
     "@iarna/toml": "^2.2.5",
-    "@inquirer/prompts": "^7.2.0",
-    "@segment/analytics-node": "^2.2.0",
-    chalk: "^5.3.0",
-    commander: "^12.1.0",
+    "@inquirer/core": "^10.1.6",
+    "@inquirer/figures": "^1.0.10",
+    "@inquirer/prompts": "^7.2.3",
+    "@inquirer/type": "^3.0.4",
+    "@segment/analytics-node": "^2.2.1",
+    "ansi-escapes": "^7.0.0",
+    chalk: "^5.4.1",
+    commander: "^13.1.0",
     conf: "^13.1.0",
+    "cross-spawn": "^7.0.6",
     dotenv: "^16.4.7",
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.3.0",
     giget: "^1.2.3",
     "lodash.kebabcase": "^4.1.1",
-    nypm: "^0.4.1",
+    nypm: "^0.5.0",
     open: "^10.1.0",
     ora: "^8.1.1",
     semver: "^7.6.3",
@@ -98,32 +103,249 @@ var package_default = {
   devDependencies: {
     "@bigcommerce/eslint-config": "^2.10.0",
     "@bigcommerce/eslint-config-catalyst": "workspace:^",
-    "@swc/core": "^1.10.1",
+    "@swc/core": "^1.10.11",
     "@swc/jest": "^0.2.37",
+    "@types/cross-spawn": "^6.0.6",
     "@types/fs-extra": "^11.0.4",
     "@types/jest": "^29.5.14",
     "@types/lodash.kebabcase": "^4.1.9",
-    "@types/node": "^20.17.10",
+    "@types/node": "^20.17.16",
     "@types/prompts": "^2.4.9",
     "@types/semver": "^7.5.8",
     eslint: "^8.57.1",
     jest: "^29.7.0",
-    msw: "^2.6.9",
+    msw: "^2.7.0",
     prettier: "^3.4.2",
-    tsup: "^8.3.5",
-    typescript: "^5.7.2"
+    tsup: "^8.3.6",
+    typescript: "^5.7.3"
   }
 };
 
 // src/commands/create.ts
 import { Command, Option } from "@commander-js/extra-typings";
 import { input, select } from "@inquirer/prompts";
-import chalk3 from "chalk";
-import { execSync as execSync5 } from "child_process";
+import chalk4 from "chalk";
+import { execSync as execSync3 } from "child_process";
 import { pathExistsSync } from "fs-extra/esm";
 import kebabCase from "lodash.kebabcase";
 import { join as join3 } from "path";
 
+// src/prompts/multi-select/multi-select.ts
+import {
+  createPrompt,
+  isBackspaceKey,
+  isDownKey,
+  isEnterKey,
+  isNumberKey,
+  isSpaceKey,
+  isUpKey,
+  makeTheme,
+  Separator as Separator2,
+  useEffect,
+  useKeypress,
+  useMemo,
+  usePagination,
+  usePrefix,
+  useRef,
+  useState,
+  ValidationError
+} from "@inquirer/core";
+import ansiEscapes from "ansi-escapes";
+
+// src/prompts/multi-select/helpers.ts
+import { Separator } from "@inquirer/core";
+import figures from "@inquirer/figures";
+import chalk from "chalk";
+var selectTheme = {
+  helpMode: "auto",
+  icon: {
+    checked: chalk.green(figures.circleFilled),
+    unchecked: figures.circle,
+    cursor: figures.pointer
+  },
+  style: {
+    description: (text) => chalk.cyan(text),
+    disabledChoice: (text) => chalk.dim(`- ${text}`),
+    renderSelectedChoices: (selectedChoices) => selectedChoices.map((choice) => choice.short).join(", ")
+  }
+};
+var isSelectable = (item) => !Separator.isSeparator(item) && !item.disabled;
+var isChecked = (item) => isSelectable(item) && Boolean(item.checked);
+var toggle = (item) => isSelectable(item) ? __spreadProps(__spreadValues({}, item), { checked: !item.checked }) : item;
+var normalizeChoices = (choices) => choices.map((choice) => {
+  var _a, _b, _c, _d;
+  if (Separator.isSeparator(choice)) {
+    return choice;
+  }
+  if (typeof choice === "string") {
+    return {
+      checked: false,
+      disabled: false,
+      name: choice,
+      short: choice,
+      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+      value: choice
+    };
+  }
+  const name2 = (_a = choice.name) != null ? _a : String(choice.value);
+  return {
+    checked: (_b = choice.checked) != null ? _b : false,
+    description: choice.description,
+    disabled: (_c = choice.disabled) != null ? _c : false,
+    name: name2,
+    short: (_d = choice.short) != null ? _d : name2,
+    value: choice.value
+  };
+});
+
+// src/prompts/multi-select/multi-select.ts
+import { Separator as Separator3 } from "@inquirer/core";
+var multiSelect = createPrompt(
+  (config, done) => {
+    const theme = makeTheme(selectTheme, config.theme);
+    const searchTimeoutRef = useRef();
+    const firstRender = useRef(true);
+    const [items, setItems] = useState(
+      normalizeChoices(config.choices)
+    );
+    const [status, setStatus] = useState("idle");
+    const [errorMsg, setError] = useState();
+    const prefix = usePrefix({ status, theme });
+    const { instructions, loop = true, pageSize = 7, required, validate = () => true } = config;
+    const bounds = useMemo(() => {
+      const first = items.findIndex(isSelectable);
+      const last = items.findLastIndex(isSelectable);
+      if (first === -1) {
+        throw new ValidationError(
+          "[multi select prompt] No selectable choices. All choices are disabled."
+        );
+      }
+      return { first, last };
+    }, [items]);
+    const [showHelpTip, setShowHelpTip] = useState(true);
+    const [active, setActive] = useState(bounds.first);
+    useEffect(
+      () => () => {
+        clearTimeout(searchTimeoutRef.current);
+      },
+      []
+    );
+    useKeypress((key, rl) => __async(void 0, null, function* () {
+      clearTimeout(searchTimeoutRef.current);
+      if (isEnterKey(key)) {
+        const selection = items.filter(isChecked);
+        const isValid = yield validate([...selection]);
+        if (required && !items.some(isChecked)) {
+          setError("At least one choice must be selected");
+        } else if (isValid === true) {
+          setStatus("done");
+          done(selection.map((choice) => choice.value));
+        } else {
+          setError(isValid || "You must select a valid value");
+        }
+      } else if (isUpKey(key) || isDownKey(key)) {
+        rl.clearLine(0);
+        if (loop || isUpKey(key) && active !== bounds.first || isDownKey(key) && active !== bounds.last) {
+          const offset = isUpKey(key) ? -1 : 1;
+          let next = active;
+          do {
+            next = (next + offset + items.length) % items.length;
+          } while (!isSelectable(items[next]));
+          setActive(next);
+        }
+      } else if (isNumberKey(key)) {
+        rl.clearLine(0);
+        const position = Number(key.name) - 1;
+        if (isSelectable(items[position])) {
+          setActive(position);
+        }
+      } else if (isBackspaceKey(key)) {
+        rl.clearLine(0);
+      } else if (isSpaceKey(key)) {
+        rl.clearLine(0);
+        setShowHelpTip(false);
+        const nextItems = items.map((choice, i) => i === active ? toggle(choice) : choice);
+        const selection = nextItems.filter(isChecked);
+        const isValid = yield validate([...selection]);
+        if (isValid === true) {
+          setError(void 0);
+          setItems(nextItems);
+        } else {
+          setError(isValid || "You must select a valid value");
+        }
+      } else {
+        const searchTerm = rl.line.toLowerCase();
+        const matchIndex = items.findIndex(
+          (item) => Separator2.isSeparator(item) || !isSelectable(item) ? false : item.name.toLowerCase().startsWith(searchTerm)
+        );
+        if (matchIndex !== -1) {
+          setActive(matchIndex);
+        }
+        searchTimeoutRef.current = setTimeout(() => {
+          rl.clearLine(0);
+        }, 700);
+      }
+    }));
+    const message = theme.style.message(config.message, status);
+    let helpTipTop = "";
+    let helpTipBottom = "";
+    let description;
+    if (theme.helpMode === "always" || theme.helpMode === "auto" && showHelpTip && (instructions === void 0 || instructions)) {
+      if (typeof instructions === "string") {
+        helpTipTop = instructions;
+      } else {
+        const keys = [
+          `${theme.style.key("space")} to select`,
+          `${theme.style.key("enter")} to proceed`
+        ];
+        helpTipTop = ` (Press ${keys.filter((key) => key !== "").join(", ")})`;
+      }
+      if (items.length > pageSize && (theme.helpMode === "always" || // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      theme.helpMode === "auto" && firstRender.current)) {
+        helpTipBottom = `
+${theme.style.help("(Use arrow keys to reveal more choices)")}`;
+        firstRender.current = false;
+      }
+    }
+    const page = usePagination({
+      items,
+      active,
+      renderItem({ item, isActive }) {
+        if (Separator2.isSeparator(item)) {
+          return ` ${item.separator}`;
+        }
+        if (item.disabled) {
+          return theme.style.disabledChoice(
+            `${item.name} ${typeof item.disabled === "string" ? item.disabled : "(disabled)"}`
+          );
+        }
+        if (isActive) {
+          description = item.description;
+        }
+        const checkbox = item.checked ? theme.icon.checked : theme.icon.unchecked;
+        const color = isActive ? theme.style.highlight : (x) => x;
+        const cursor = isActive ? theme.icon.cursor : ` `;
+        return color(`${cursor}${checkbox} ${item.name}`);
+      },
+      pageSize,
+      loop
+    });
+    if (status === "done") {
+      return `${prefix} ${message} ${theme.style.answer(theme.style.renderSelectedChoices(items.filter(isChecked), items))}`;
+    }
+    const selectedChoices = items.filter(isChecked).length > 0 ? ` (${theme.style.answer(theme.style.renderSelectedChoices(items.filter(isChecked), items))})` : "";
+    const choiceDescription = description ? `
+${theme.style.description(description)}` : ``;
+    let error = "";
+    if (errorMsg) {
+      error = `
+${theme.style.error(errorMsg)}`;
+    }
+    return `${prefix} ${message}${selectedChoices}${helpTipTop}
+${page}${helpTipBottom}${choiceDescription}${error}${ansiEscapes.cursorHide}`;
+  }
+);
+
 // src/utils/user-agent.ts
 import {
   isDevelopment,
@@ -184,7 +406,7 @@ var Https = class {
     return __async(this, arguments, function* (path, opts = {}) {
       const _a = opts, { headers = {} } = _a, rest = __objRest(_a, ["headers"]);
       const options = __spreadValues({
-        headers: __spreadValues(__spreadProps(__spreadValues({}, headers), {
+        headers: __spreadValues(__spreadProps(__spreadValues({}, Object.fromEntries(new Headers(headers))), {
           Accept: "application/json",
           "User-Agent": this.userAgent
         }), this.accessToken && { "X-Auth-Token": this.accessToken })
@@ -216,7 +438,7 @@ var CliApi = class {
       });
     });
   }
-  createChannel(name2, installSampleData = false) {
+  createChannel(name2, storefrontLocale, additionalLocales, installSampleData = false) {
     return __async(this, null, function* () {
       return this.client.fetch("/channels/catalyst", {
         method: "POST",
@@ -227,7 +449,9 @@ var CliApi = class {
             type: installSampleData ? "sample" : "none"
           },
           deployStorefront: true,
-          devOrigin: "http://localhost:3000"
+          devOrigin: "http://localhost:3000",
+          storefrontLanguage: storefrontLocale,
+          additionalLocales
         })
       });
     });
@@ -235,10 +459,10 @@ var CliApi = class {
 };
 
 // src/utils/clone-catalyst.ts
-import { execSync as execSync4 } from "child_process";
+import { execSync as execSync2 } from "child_process";
 
 // src/utils/checkout-ref.ts
-import { execSync } from "node:child_process";
+import { sync as spawnSync } from "cross-spawn";
 
 // src/utils/is-exec-exception.ts
 function isExecException(error) {
@@ -248,11 +472,17 @@ function isExecException(error) {
 // src/utils/checkout-ref.ts
 function checkoutRef(repoDir, ref) {
   try {
-    execSync(`git checkout ${ref}`, {
+    const spawn = spawnSync("git", ["checkout", ref, "--"], {
       cwd: repoDir,
-      stdio: "inherit",
-      encoding: "utf8"
+      encoding: "utf8",
+      // Explicitly set shell to false to avoid shell injection
+      // Don't use shell: true as it's a security risk
+      shell: false
     });
+    const stderr = spawn.stderr.trim();
+    if (spawn.status !== 0 && stderr) {
+      throw new Error(stderr);
+    }
     console.log(`Checked out ref ${ref} successfully.`);
   } catch (error) {
     if (isExecException(error)) {
@@ -262,19 +492,20 @@ function checkoutRef(repoDir, ref) {
       } else {
         console.error(`Error checking out ref '${ref}':`, stderr.trim());
       }
-    }
-    if (error instanceof Error) {
+    } else if (error instanceof Error) {
       console.error(`Error checking out ref '${ref}':`, error.message);
+    } else {
+      console.error(`Unknown error occurred while checking out ref '${ref}'.`);
     }
-    console.error(`Unknown error occurred while checking out ref '${ref}'.`);
+    console.warn(`Falling back to the default branch.`);
   }
 }
 
 // src/utils/has-github-ssh.ts
-import { execSync as execSync2 } from "child_process";
+import { execSync } from "child_process";
 function hasGitHubSSH() {
   try {
-    const output = execSync2("ssh -T git@github.com", {
+    const output = execSync("ssh -T git@github.com", {
       encoding: "utf8",
       stdio: "pipe"
     }).toString();
@@ -293,13 +524,19 @@ function hasGitHubSSH() {
 }
 
 // src/utils/reset-branch-to-ref.ts
-import { execSync as execSync3 } from "node:child_process";
+import { sync as spawnSync2 } from "cross-spawn";
 function resetBranchToRef(projectDir, ghRef) {
-  execSync3(`git reset --hard ${ghRef}`, {
+  const spawn = spawnSync2("git", ["reset", "--hard", ghRef, "--"], {
     cwd: projectDir,
-    stdio: "inherit",
-    encoding: "utf8"
+    encoding: "utf8",
+    // Explicitly set shell to false to avoid shell injection
+    // Don't use shell: true as it's a security risk
+    shell: false
   });
+  const stderr = spawn.stderr.trim();
+  if (spawn.status !== 0 && stderr) {
+    throw new Error(stderr);
+  }
 }
 
 // src/utils/clone-catalyst.ts
@@ -314,16 +551,16 @@ var cloneCatalyst = ({
   console.log(`Cloning ${repository} using ${useSSH ? "SSH" : "HTTPS"}...
 `);
   const cloneCommand = `git clone ${useSSH ? `git@github.com:${repository}` : `https://github.com/${repository}`}.git${projectName ? ` ${projectName}` : ""}`;
-  execSync4(cloneCommand, { stdio: "inherit" });
+  execSync2(cloneCommand, { stdio: "inherit" });
   console.log();
-  execSync4("git remote rename origin upstream", { cwd: projectDir, stdio: "inherit" });
+  execSync2("git remote rename origin upstream", { cwd: projectDir, stdio: "inherit" });
   console.log();
   if (ghRef) {
     if (resetMain) {
-      checkoutRef(projectDir, "main");
+      execSync2("git checkout -b main", { cwd: projectDir, stdio: "inherit" });
       resetBranchToRef(projectDir, ghRef);
-      console.log(`Reset main to ${ghRef} successfully.`);
-      console.log();
+      console.log(`Reset main to ${ghRef} successfully.
+`);
       return;
     }
     checkoutRef(projectDir, ghRef);
@@ -332,7 +569,7 @@ var cloneCatalyst = ({
 };
 
 // src/utils/install-dependencies.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 import { installDependencies as installDeps } from "nypm";
 
 // src/utils/spinner.ts
@@ -351,26 +588,68 @@ var installDependencies = (projectDir) => __async(void 0, null, function* () {
   return spinner(installAllDeps(projectDir), {
     text: `Installing dependencies. This could take a minute...`,
     successText: `Dependencies installed successfully`,
-    failText: (err) => chalk.red(`Failed to install dependencies: ${err.message}`)
+    failText: (err) => chalk2.red(`Failed to install dependencies: ${err.message}`)
   });
 });
 
+// src/utils/localization.ts
+import { z } from "zod";
+var allowedLocales = [
+  "en",
+  "da",
+  "es-AR",
+  "es-CL",
+  "es-CO",
+  "es-MX",
+  "es-PE",
+  "es",
+  "it",
+  "nl",
+  "pl",
+  "pt",
+  "de",
+  "fr",
+  "ja",
+  "no",
+  "pt-BR",
+  "sv"
+];
+var AvailableLocalesSuccessSchema = z.object({
+  data: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+      fallback: z.string().nullable(),
+      is_supported: z.boolean()
+    })
+  )
+});
+var getAvailableLocales = (bc) => __async(void 0, null, function* () {
+  const response = yield bc.fetch("/v3/settings/store/available-locales");
+  if (!response.ok) {
+    throw new Error(
+      `GET /v3/settings/store/available-locales failed: ${response.status} ${response.statusText}`
+    );
+  }
+  return AvailableLocalesSuccessSchema.parse(yield response.json()).data.filter(({ id }) => allowedLocales.includes(id)).map(({ name: name2, id }) => ({ name: `${name2} (${id})`, value: id }));
+});
+
 // src/utils/login.ts
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 import open from "open";
 import { createInterface } from "readline";
 
 // src/utils/auth.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
 // src/utils/parse.ts
-import * as z from "zod";
+import * as z2 from "zod";
 import { fromZodError } from "zod-validation-error";
 var parse = (data, schema) => {
   try {
     return schema.parse(data);
   } catch (error) {
-    if (error instanceof z.ZodError) {
+    if (error instanceof z2.ZodError) {
       console.error(fromZodError(error).toString());
     }
     process.exit(1);
@@ -401,12 +680,12 @@ var Auth = class {
           client_id: this.DEVICE_OAUTH_CLIENT_ID
         })
       });
-      const DeviceCodeSchema = z2.object({
-        device_code: z2.string(),
-        user_code: z2.string(),
-        verification_uri: z2.string(),
-        expires_in: z2.number(),
-        interval: z2.number()
+      const DeviceCodeSchema = z3.object({
+        device_code: z3.string(),
+        user_code: z3.string(),
+        verification_uri: z3.string(),
+        expires_in: z3.number(),
+        interval: z3.number()
       });
       return parse(yield response.json(), DeviceCodeSchema);
     });
@@ -424,11 +703,11 @@ var Auth = class {
       if (response.status !== 200) {
         throw new Error("Device code not yet verified");
       }
-      const DeviceCodeSuccessSchema = z2.object({
-        access_token: z2.string(),
-        store_hash: z2.string(),
-        context: z2.string(),
-        api_uri: z2.string().url()
+      const DeviceCodeSuccessSchema = z3.object({
+        access_token: z3.string(),
+        store_hash: z3.string(),
+        context: z3.string(),
+        api_uri: z3.string().url()
       });
       return parse(yield response.json(), DeviceCodeSuccessSchema);
     });
@@ -542,7 +821,7 @@ function waitForKeyPress(prompt) {
         process.stdin.setRawMode(false);
         process.stdin.pause();
         rl.close();
-        const shouldProceed = data[0] !== 27;
+        const shouldProceed = data[0] === 13 || data[0] === 10;
         process.stdout.write("\n");
         resolve(shouldProceed);
       });
@@ -555,22 +834,16 @@ function login(baseUrl) {
     const auth = new Auth({ baseUrl });
     const deviceCode = yield auth.getDeviceCode();
     console.log(
-      chalk2.cyan("\nPlease visit the following URL to authenticate with your BigCommerce store:")
-    );
-    console.log(chalk2.yellow(`
-${deviceCode.verification_uri}
-`));
-    console.log(chalk2.cyan(`Enter code: `) + chalk2.yellow(`${deviceCode.user_code}
-`));
-    const shouldOpenUrl = yield waitForKeyPress(
-      "Press any key to open the URL in your browser (or ESC to skip)..."
+      chalk3.yellow("\n! First copy your one-time code: ") + chalk3.bold(deviceCode.user_code)
     );
+    console.log(`Press Enter to open ${deviceCode.verification_uri} in your browser...`);
+    const shouldOpenUrl = yield waitForKeyPress("");
     if (shouldOpenUrl) {
       yield open(deviceCode.verification_uri);
     }
     const credentials = yield spinner(
       () => waitForCredentials(auth, deviceCode.device_code, deviceCode.interval),
-      { text: "Waiting for authentication...", successText: "Authentication successful!" }
+      { text: "Waiting for authentication...", successText: "Authentication complete" }
     );
     return {
       storeHash: credentials.store_hash,
@@ -685,11 +958,55 @@ function getPlatformCheckCommand(command) {
   return isWindows2 ? `where.exe ${command}` : `which ${command}`;
 }
 var telemetry = new Telemetry();
-function handleChannelCreation(cliApi) {
+function handleChannelCreation(bc, cliApi) {
   return __async(this, null, function* () {
     const newChannelName = yield input({
       message: "What would you like to name your new channel?"
     });
+    let availableLocales = [];
+    try {
+      availableLocales = yield getAvailableLocales(bc);
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(chalk4.red(error.message));
+      }
+      process.exit(1);
+    }
+    const storefrontLocale = yield select({
+      message: "Which default language would you like to set for your channel?",
+      default: "en",
+      choices: availableLocales,
+      theme: {
+        style: {
+          help: () => chalk4.dim("(Select locale from the list or start typing the name)")
+        }
+      }
+    });
+    const shouldAddAdditionalLocales = yield select({
+      message: "Would you like to add additional languages?",
+      choices: [
+        { name: "Yes", value: true },
+        { name: "No", value: false }
+      ]
+    });
+    let additionalLocales = [];
+    if (shouldAddAdditionalLocales) {
+      additionalLocales = yield multiSelect({
+        choices: availableLocales.filter(({ value }) => value !== storefrontLocale),
+        message: "Which additional languages would you like to add to your channel?",
+        theme: {
+          style: {
+            help: () => chalk4.dim("(Select locale from the list or start typing the name)")
+          }
+        },
+        validate: (selections) => {
+          if (selections.length > 4) {
+            return "You can only select up to 4 additional languages";
+          }
+          return true;
+        }
+      });
+    }
     const shouldInstallSampleData = yield select({
       message: "Would you like to install sample data?",
       choices: [
@@ -697,10 +1014,15 @@ function handleChannelCreation(cliApi) {
         { name: "No", value: false }
       ]
     });
-    const response = yield cliApi.createChannel(newChannelName, shouldInstallSampleData);
+    const response = yield cliApi.createChannel(
+      newChannelName,
+      storefrontLocale,
+      additionalLocales,
+      shouldInstallSampleData
+    );
     if (!response.ok) {
       console.error(
-        chalk3.red(`
+        chalk4.red(`
 POST /channels/catalyst failed: ${response.status} ${response.statusText}
 `)
       );
@@ -708,7 +1030,7 @@ POST /channels/catalyst failed: ${response.status} ${response.statusText}
     }
     const channelData = yield response.json();
     if (!isCreateChannelResponse(channelData)) {
-      console.error(chalk3.red("\nUnexpected response format from create channel endpoint\n"));
+      console.error(chalk4.red("\nUnexpected response format from create channel endpoint\n"));
       process.exit(1);
     }
     return {
@@ -724,7 +1046,7 @@ function handleChannelSelection(bc) {
     const channelsResponse = yield bc.fetch("/v3/channels?available=true&type=storefront");
     if (!channelsResponse.ok) {
       console.error(
-        chalk3.red(
+        chalk4.red(
           `
 GET /v3/channels failed: ${channelsResponse.status} ${channelsResponse.statusText}
 `
@@ -734,7 +1056,7 @@ GET /v3/channels failed: ${channelsResponse.status} ${channelsResponse.statusTex
     }
     const availableChannels = yield channelsResponse.json();
     if (!isChannelsResponse(availableChannels)) {
-      console.error(chalk3.red("\nUnexpected response format from channels endpoint\n"));
+      console.error(chalk4.red("\nUnexpected response format from channels endpoint\n"));
       process.exit(1);
     }
     const existingChannel = yield select({
@@ -762,7 +1084,7 @@ function getChannelInit(cliApi, channelId) {
     const initResponse = yield cliApi.getChannelInit(channelId);
     if (!initResponse.ok) {
       console.error(
-        chalk3.red(
+        chalk4.red(
           `
 GET /channels/${channelId}/init failed: ${initResponse.status} ${initResponse.statusText}
 `
@@ -772,7 +1094,7 @@ GET /channels/${channelId}/init failed: ${initResponse.status} ${initResponse.st
     }
     const initData = yield initResponse.json();
     if (!isInitResponse(initData)) {
-      console.error(chalk3.red("\nUnexpected response format from init endpoint\n"));
+      console.error(chalk4.red("\nUnexpected response format from init endpoint\n"));
       process.exit(1);
     }
     return {
@@ -785,7 +1107,7 @@ function setupProject(options) {
   return __async(this, null, function* () {
     let { projectName, projectDir } = options;
     if (!pathExistsSync(projectDir)) {
-      console.error(chalk3.red(`Error: --projectDir ${projectDir} is not a valid path
+      console.error(chalk4.red(`Error: --projectDir ${projectDir} is not a valid path
 `));
       process.exit(1);
     }
@@ -793,7 +1115,7 @@ function setupProject(options) {
       projectName = kebabCase(projectName);
       projectDir = join3(options.projectDir, projectName);
       if (pathExistsSync(projectDir)) {
-        console.error(chalk3.red(`Error: ${projectDir} already exists
+        console.error(chalk4.red(`Error: ${projectDir} already exists
 `));
         process.exit(1);
       }
@@ -821,20 +1143,24 @@ function setupProject(options) {
 }
 function checkRequiredTools() {
   try {
-    execSync5(getPlatformCheckCommand("git"), { stdio: "ignore" });
+    execSync3(getPlatformCheckCommand("git"), { stdio: "ignore" });
   } catch (e) {
-    console.error(chalk3.red("Error: git is required to create a Catalyst project\n"));
+    console.error(chalk4.red("Error: git is required to create a Catalyst project\n"));
     process.exit(1);
   }
   try {
-    execSync5(getPlatformCheckCommand("pnpm"), { stdio: "ignore" });
+    execSync3(getPlatformCheckCommand("pnpm"), { stdio: "ignore" });
   } catch (e) {
-    console.error(chalk3.red("Error: pnpm is required to create a Catalyst project\n"));
-    console.error(chalk3.yellow("Tip: Enable it by running `corepack enable pnpm`\n"));
+    console.error(chalk4.red("Error: pnpm is required to create a Catalyst project\n"));
+    console.error(chalk4.yellow("Tip: Enable it by running `corepack enable pnpm`\n"));
     process.exit(1);
   }
 }
-var create = new Command("create").description("Command to scaffold and connect a Catalyst storefront to your BigCommerce store").option("--project-name <name>", "Name of your Catalyst project").option("--project-dir <dir>", "Directory in which to create your project", process.cwd()).option("--store-hash <hash>", "BigCommerce store hash").option("--access-token <token>", "BigCommerce access token").option("--channel-id <id>", "BigCommerce channel ID").option("--storefront-token <token>", "BigCommerce storefront token").option("--gh-ref <ref>", "Clone a specific ref from the source repository").option("--reset-main", "Reset the main branch to the gh-ref").option("--repository <repository>", "GitHub repository to clone from", "bigcommerce/catalyst").option("--env <vars...>", "Arbitrary environment variables to set in .env.local").addOption(
+var create = new Command("create").description("Command to scaffold and connect a Catalyst storefront to your BigCommerce store").option("--project-name <name>", "Name of your Catalyst project").option("--project-dir <dir>", "Directory in which to create your project", process.cwd()).option("--store-hash <hash>", "BigCommerce store hash").option("--access-token <token>", "BigCommerce access token").option("--channel-id <id>", "BigCommerce channel ID").option("--storefront-token <token>", "BigCommerce storefront token").option(
+  "--gh-ref <ref>",
+  "Clone a specific ref from the source repository",
+  "@bigcommerce/catalyst-core@latest"
+).option("--reset-main", "Reset the main branch to the gh-ref").option("--repository <repository>", "GitHub repository to clone from", "bigcommerce/catalyst").option("--env <vars...>", "Arbitrary environment variables to set in .env.local").addOption(
   new Option("--bigcommerce-hostname <hostname>", "BigCommerce hostname").default("bigcommerce.com").hideHelp()
 ).addOption(
   new Option("--cli-api-origin <origin>", "Catalyst CLI API origin").default("https://cxm-prd.bigcommerceapp.com").hideHelp()
@@ -884,15 +1210,15 @@ Creating '${projectName}' at '${projectDir}'
       console.log(
         [
           `
-${chalk3.green("Success!")} Created '${projectName}' at '${projectDir}'
+${chalk4.green("Success!")} Created '${projectName}' at '${projectDir}'
 `,
           `Next steps:`,
-          Object.keys(envVars).length > 0 ? chalk3.yellow(`
+          Object.keys(envVars).length > 0 ? chalk4.yellow(`
 - cd ${projectName} && pnpm run dev
 `) : [
-            chalk3.yellow(`
+            chalk4.yellow(`
 - cd ${projectName} && cp .env.example .env.local`),
-            chalk3.yellow(`
+            chalk4.yellow(`
 - Populate .env.local with your BigCommerce API credentials
 `)
           ].join("")
@@ -919,7 +1245,7 @@ ${chalk3.green("Success!")} Created '${projectName}' at '${projectDir}'
         const eligibilityResponse = yield cliApi.checkEligibility();
         if (!eligibilityResponse.ok) {
           console.error(
-            chalk3.red(
+            chalk4.red(
               `
 GET /channels/catalyst/eligibility failed: ${eligibilityResponse.status} ${eligibilityResponse.statusText}
 `
@@ -929,11 +1255,11 @@ GET /channels/catalyst/eligibility failed: ${eligibilityResponse.status} ${eligi
         }
         const eligibilityData = yield eligibilityResponse.json();
         if (!isEligibilityResponse(eligibilityData)) {
-          console.error(chalk3.red("\nUnexpected response format from eligibility endpoint\n"));
+          console.error(chalk4.red("\nUnexpected response format from eligibility endpoint\n"));
           process.exit(1);
         }
         if (!eligibilityData.data.eligible) {
-          console.warn(chalk3.yellow(eligibilityData.data.message));
+          console.warn(chalk4.yellow(eligibilityData.data.message));
         }
         let shouldCreateChannel;
         if (eligibilityData.data.eligible) {
@@ -946,11 +1272,16 @@ GET /channels/catalyst/eligibility failed: ${eligibilityResponse.status} ${eligi
           });
         }
         if (shouldCreateChannel) {
-          const channelData = yield handleChannelCreation(cliApi);
+          const channelData = yield handleChannelCreation(bc, cliApi);
           channelId = channelData.channelId;
           storefrontToken = channelData.storefrontToken;
           envVars = __spreadValues({}, channelData.envVars);
-          console.log(chalk3.green(`Channel created successfully`));
+          console.log(chalk4.green(`Channel created successfully`));
+          console.warn(
+            chalk4.yellow(
+              "\nNote: A preview storefront has been deployed in your BigCommerce control panel. This preview may look different from your local environment as it may be running different code."
+            )
+          );
         }
         if (!shouldCreateChannel) {
           channelId = yield handleChannelSelection(bc);
@@ -993,10 +1324,10 @@ Creating '${projectName}' at '${projectDir}'
   }
   console.log(
     `
-${chalk3.green("Success!")} Created '${projectName}' at '${projectDir}'
+${chalk4.green("Success!")} Created '${projectName}' at '${projectDir}'
 `,
     "\nNext steps:\n",
-    chalk3.yellow(`
+    chalk4.yellow(`
 cd ${projectName} && pnpm run dev
 `)
   );
@@ -1019,7 +1350,7 @@ function isChannelsResponse(response) {
 // src/commands/init.ts
 import { Command as Command2, Option as Option2 } from "@commander-js/extra-typings";
 import { select as select2 } from "@inquirer/prompts";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 function isChannelsResponse2(response) {
   return typeof response === "object" && response !== null && "data" in response && Array.isArray(response.data) && response.data.every(
     (item) => typeof item === "object" && item !== null && "id" in item && "name" in item && "platform" in item
@@ -1063,7 +1394,7 @@ var init = new Command2("init").description("Connect a BigCommerce store with an
   const channelsResponse = yield bc.fetch("/v3/channels?available=true&type=storefront");
   if (!channelsResponse.ok) {
     console.error(
-      chalk4.red(
+      chalk5.red(
         `
 GET /v3/channels failed: ${channelsResponse.status} ${channelsResponse.statusText}
 `
@@ -1073,7 +1404,7 @@ GET /v3/channels failed: ${channelsResponse.status} ${channelsResponse.statusTex
   }
   const availableChannels = yield channelsResponse.json();
   if (!isChannelsResponse2(availableChannels)) {
-    console.error(chalk4.red("\nUnexpected response format from channels endpoint\n"));
+    console.error(chalk5.red("\nUnexpected response format from channels endpoint\n"));
     process.exit(1);
   }
   const existingChannel = yield select2({
@@ -1090,7 +1421,7 @@ GET /v3/channels failed: ${channelsResponse.status} ${channelsResponse.statusTex
   const initResponse = yield cliApi.getChannelInit(channelId);
   if (!initResponse.ok) {
     console.error(
-      chalk4.red(
+      chalk5.red(
         `
 GET /channels/${channelId}/init failed: ${initResponse.status} ${initResponse.statusText}
 `
@@ -1100,7 +1431,7 @@ GET /channels/${channelId}/init failed: ${initResponse.status} ${initResponse.st
   }
   const initData = yield initResponse.json();
   if (!isInitResponse2(initData)) {
-    console.error(chalk4.red("\nUnexpected response format from init endpoint\n"));
+    console.error(chalk5.red("\nUnexpected response format from init endpoint\n"));
     process.exit(1);
   }
   const envVars = __spreadValues({}, initData.data.envVars);
@@ -1115,13 +1446,13 @@ GET /channels/${channelId}/init failed: ${initResponse.status} ${initResponse.st
     Object.assign(envVars, cliEnvVars);
   }
   writeEnv(projectDir, envVars);
-  console.log(chalk4.green(`
+  console.log(chalk5.green(`
 .env.local file created for channel ${existingChannel.name}!
 `));
-  console.log(chalk4.green(`
+  console.log(chalk5.green(`
 Next steps:
 `));
-  console.log(chalk4.yellow(`
+  console.log(chalk5.yellow(`
 pnpm run dev
 `));
 }));
@@ -1134,16 +1465,16 @@ import { outputFileSync as outputFileSync2, writeJsonSync } from "fs-extra/esm";
 import kebabCase2 from "lodash.kebabcase";
 import { coerce, compare } from "semver";
 import { promisify } from "util";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var exec = promisify(execCb);
-var ManifestSchema = z3.object({
-  name: z3.string(),
-  dependencies: z3.object({ add: z3.array(z3.string()) }),
-  devDependencies: z3.object({ add: z3.array(z3.string()) }),
-  environmentVariables: z3.array(z3.string())
+var ManifestSchema = z4.object({
+  name: z4.string(),
+  dependencies: z4.object({ add: z4.array(z4.string()) }),
+  devDependencies: z4.object({ add: z4.array(z4.string()) }),
+  environmentVariables: z4.array(z4.string())
 });
 var integration = new Command3("integration").argument("<integration-name>", "Formatted name of the integration").option("--commit-hash <hash>", "Override integration source branch with a specific commit hash").action((integrationNameRaw, options) => __async(void 0, null, function* () {
-  const integrationName = z3.string().transform(kebabCase2).parse(integrationNameRaw);
+  const integrationName = z4.string().transform(kebabCase2).parse(integrationNameRaw);
   const manifest = {
     name: integrationName,
     dependencies: { add: [] },
@@ -1165,9 +1496,9 @@ var integration = new Command3("integration").argument("<integration-name>", "Fo
     }
     return 0;
   }).reverse();
-  const PackageDependenciesSchema = z3.object({
-    dependencies: z3.object({}).passthrough(),
-    devDependencies: z3.object({}).passthrough()
+  const PackageDependenciesSchema = z4.object({
+    dependencies: z4.object({}).passthrough(),
+    devDependencies: z4.object({}).passthrough()
   });
   const getPackageDeps = (ref) => __async(void 0, null, function* () {
     const { stdout } = yield exec(`git show ${ref}:core/package.json`);
@@ -1203,7 +1534,7 @@ var integration = new Command3("integration").argument("<integration-name>", "Fo
 import { Argument, Command as Command4, Option as Option3 } from "@commander-js/extra-typings";
 
 // src/utils/telemetry/index.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 var telemetry3 = new Telemetry();
 var isEnabled = telemetry3.isEnabled();
 var catalystTelemetry = (options, arg) => {
@@ -1224,7 +1555,7 @@ var catalystTelemetry = (options, arg) => {
   }
   console.log(
     `
-Status: ${chalk5.bold(isEnabled ? chalk5.green("Enabled") : chalk5.red("Disabled"))}`
+Status: ${chalk6.bold(isEnabled ? chalk6.green("Enabled") : chalk6.red("Disabled"))}`
   );
   if (!isEnabled) {
     console.log(
@@ -1277,7 +1608,7 @@ var telemetryPostHook = () => __async(void 0, null, function* () {
 });
 
 // src/index.ts
-console.log(chalk6.cyanBright(`
+console.log(chalk7.cyanBright(`
 \u25E2 ${package_default.name} v${package_default.version}
 `));
 program.name(package_default.name).version(package_default.version).description("A command line tool to create a new Catalyst project.").addCommand(create, { isDefault: true }).addCommand(init).addCommand(integration).addCommand(telemetry4).hook("preAction", telemetryPreHook).hook("postAction", telemetryPostHook);