@shopify/cli-hydrogen 6.0.2 → 7.0.0

package/dist/commands/hydrogen/upgrade.test.js

@@ -0,0 +1,786 @@
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { execa } from 'execa';
+import { vi, beforeEach, beforeAll, afterAll, describe, it, expect } from 'vitest';
+import { inTemporaryDirectory, writeFile, fileExists } from '@shopify/cli-kit/node/fs';
+import { joinPath } from '@shopify/cli-kit/node/path';
+import { renderSelectPrompt, renderConfirmationPrompt, renderTasks } from '@shopify/cli-kit/node/ui';
+import { mockAndCaptureOutput } from '@shopify/cli-kit/node/testing/output';
+import { runUpgrade, getChangelog, getHydrogenVersion, getAvailableUpgrades, buildUpgradeCommandArgs, getAbsoluteVersion, getSelectedRelease, getCummulativeRelease, displayConfirmation, upgradeNodeModules } from './upgrade.js';
+
+vi.mock("../../lib/shell.js");
+vi.mock("@shopify/cli-kit/node/session");
+vi.mock("@shopify/cli-kit/node/ui", async () => {
+  const original = await vi.importActual("@shopify/cli-kit/node/ui");
+  return {
+    ...original,
+    renderTasks: vi.fn(() => Promise.resolve()),
+    renderSelectPrompt: vi.fn(() => Promise.resolve()),
+    renderConfirmationPrompt: vi.fn(() => Promise.resolve(false))
+  };
+});
+const outputMock = mockAndCaptureOutput();
+beforeEach(() => {
+  vi.restoreAllMocks();
+  vi.resetModules();
+  vi.clearAllMocks();
+  outputMock.clear();
+});
+beforeAll(() => {
+  process.env.FORCE_CHANGELOG_SOURCE = "local";
+});
+afterAll(() => {
+  delete process.env.FORCE_CHANGELOG_SOURCE;
+});
+function createOutdatedSkeletonPackageJson() {
+  const require2 = createRequire(import.meta.url);
+  const packageJson = require2(fileURLToPath(
+    new URL("../../../../../templates/skeleton/package.json", import.meta.url)
+  ));
+  if (!packageJson)
+    throw new Error("Could not parse package.json");
+  if (!packageJson?.dependencies)
+    throw new Error("Could not parse package.json dependencies");
+  if (!packageJson?.devDependencies)
+    throw new Error("Could not parse package.json devDependencies");
+  packageJson.dependencies["@shopify/hydrogen"] = "^2023.1.6";
+  packageJson.dependencies["@remix-run/react"] = "1.12.0";
+  packageJson.devDependencies["@shopify/cli-hydrogen"] = "^4.0.8";
+  packageJson.devDependencies["@shopify/remix-oxygen"] = "^1.0.3";
+  packageJson.devDependencies["@remix-run/dev"] = "1.12.0";
+  packageJson.devDependencies["typescript"] = "^4.9.5";
+  return packageJson;
+}
+async function inTemporaryHydrogenRepo(cb, {
+  cleanGitRepo,
+  packageJson
+} = {
+  cleanGitRepo: true,
+  packageJson: null
+}) {
+  return inTemporaryDirectory(async (tmpDir) => {
+    await execa("git", ["init"], { cwd: tmpDir });
+    if (packageJson) {
+      const packageJsonPath = joinPath(tmpDir, "package.json");
+      await writeFile(packageJsonPath, JSON.stringify(packageJson));
+      expect(await fileExists(packageJsonPath)).toBeTruthy();
+    }
+    expect(await fileExists(joinPath(tmpDir, "/.git/config"))).toBeTruthy();
+    if (cleanGitRepo) {
+      await execa("git", ["add", "package.json"], { cwd: tmpDir });
+      if (process.env.NODE_ENV === "test" && process.env.CI) {
+        await execa("git", ["config", "user.email", "test@hydrogen.shop"], {
+          cwd: tmpDir
+        });
+        await execa("git", ["config", "user.name", "Hydrogen Test"], {
+          cwd: tmpDir
+        });
+      }
+      await execa("git", ["commit", "-m", "initial commit"], { cwd: tmpDir });
+    }
+    await cb(tmpDir);
+  });
+}
+describe("upgrade", async () => {
+  const OUTDATED_HYDROGEN_PACKAGE_JSON = createOutdatedSkeletonPackageJson();
+  describe("checkIsGitRepo", () => {
+    it("renders an error message when not in a git repo", async () => {
+      await inTemporaryDirectory(async (appPath) => {
+        await expect(runUpgrade({ appPath })).rejects.toThrowError(
+          "git repository"
+        );
+      });
+    });
+  });
+  describe("checkDirtyGitBranch", () => {
+    it("renders error message if the target git repo is dirty", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          await expect(runUpgrade({ appPath })).rejects.toThrowError("clean git");
+        },
+        { cleanGitRepo: false, packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON }
+      );
+    });
+  });
+  describe("getHydrogenVersion", () => {
+    it("throws if no package.json is found", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          await expect(runUpgrade({ appPath })).rejects.toThrowError(
+            "valid package.json"
+          );
+        },
+        { packageJson: null }
+      );
+    });
+    it("throws if no hydrogen version is found in package.json", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          await expect(runUpgrade({ appPath })).rejects.toThrowError(
+            "version in package.json"
+          );
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: {
+            name: "hello-world",
+            dependencies: {}
+          }
+        }
+      );
+    });
+    it("returns the current hydrogen version from the package.json", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const hydrogen = await getHydrogenVersion({ appPath });
+          expect(hydrogen).toBeDefined();
+          expect(hydrogen.currentVersion).toMatch("^2023.1.6");
+          expect(hydrogen.currentDependencies).toMatchObject({
+            ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+            ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies
+          });
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+    it('exists when run over a prerelease "next" version', async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          await expect(runUpgrade({ appPath })).rejects.toThrowError(
+            "prerelease"
+          );
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: {
+            dependencies: {
+              "@shopify/hydrogen": "0.0.0-next-74ea1db-20231120210149"
+            }
+          }
+        }
+      );
+    });
+  });
+  describe.skip("fetchChangelog", () => {
+    it("fetches the latest changelog from the hydrogen repo", async () => {
+    });
+    it("renders an error message if the changelog could not be fetched", async () => {
+    });
+  });
+  describe("getAvailableUpgrades", async () => {
+    it('renders "already in the latest version" success message if no upgrades are available', async () => {
+      const { releases } = await getChangelog();
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          await runUpgrade({ appPath });
+          expect(outputMock.info()).toMatch(
+            / success.+ latest Hydrogen version/is
+          );
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: {
+            dependencies: {
+              // @ts-expect-error - we know this release version exists
+              "@shopify/hydrogen": releases[0].version
+            }
+          }
+        }
+      );
+    });
+    it("returns available upgrades and uniqueAvailableUpgrades if they exist", async () => {
+      const { releases } = await getChangelog();
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const current = await getHydrogenVersion({ appPath });
+          const availableUpgrades = getAvailableUpgrades({
+            releases,
+            ...current
+          });
+          const uniqueAvailableUpgrades = releases.slice(0, 2).reduce((acc, release) => {
+            if (acc[release.version])
+              return acc;
+            return {
+              ...acc,
+              [release.version]: release
+            };
+          }, {});
+          expect(availableUpgrades).toMatchObject({
+            availableUpgrades: releases.slice(0, 2),
+            uniqueAvailableUpgrades
+          });
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: {
+            dependencies: {
+              // @ts-ignore
+              "@shopify/hydrogen": releases[2].version
+            }
+          }
+        }
+      );
+    });
+  });
+  describe("getSelectedRelease", () => {
+    it("prioritizes a passed target --version over a select prompt if available", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const { releases } = await getChangelog();
+          const current = await getHydrogenVersion({ appPath });
+          expect(current?.currentVersion).toBeDefined();
+          const { availableUpgrades } = getAvailableUpgrades({
+            ...current,
+            releases
+          });
+          await expect(
+            getSelectedRelease({
+              availableUpgrades,
+              // @ts-ignore - we know this release version exists
+              currentVersion: current.currentVersion,
+              // OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies['@shopify/hydrogen'],
+              targetVersion: "2023.7.10"
+            })
+          ).resolves.toMatchObject({
+            version: "2023.7.10"
+          });
+          expect(renderSelectPrompt).not.toHaveBeenCalled();
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+    it("prompts if a passed target --version is not a valid upgradable version", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const { releases } = await getChangelog();
+          const current = await getHydrogenVersion({ appPath });
+          expect(current?.currentVersion).toBeDefined();
+          const { availableUpgrades } = getAvailableUpgrades({
+            ...current,
+            releases
+          });
+          vi.mocked(renderSelectPrompt).mockImplementationOnce(
+            ({ choices }) => Promise.resolve(choices[0]?.value)
+          );
+          await expect(
+            getSelectedRelease({
+              availableUpgrades,
+              currentVersion: current.currentVersion,
+              targetVersion: "2023.1.5"
+              // fails because this version is in the past
+            })
+          ).resolves.toMatchObject(availableUpgrades[0]);
+          expect(renderSelectPrompt).toHaveBeenCalled();
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+    it("prompts to select a release if no target --version is passed", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const { releases } = await getChangelog();
+          const previousRelease = releases[1];
+          const latestRelease = releases[0];
+          const current = await getHydrogenVersion({ appPath });
+          expect(current?.currentVersion).toBeDefined();
+          const { availableUpgrades } = getAvailableUpgrades({
+            ...current,
+            releases
+          });
+          vi.mocked(renderSelectPrompt).mockImplementationOnce(
+            ({ choices }) => Promise.resolve(choices[0]?.value)
+          );
+          await expect(
+            getSelectedRelease({
+              availableUpgrades,
+              currentVersion: previousRelease.version
+            })
+          ).resolves.toMatchObject(availableUpgrades[0]);
+          expect(renderSelectPrompt).toHaveBeenCalledWith({
+            message: expect.stringContaining(previousRelease.version),
+            choices: expect.arrayContaining([
+              {
+                label: expect.stringContaining(latestRelease.version),
+                value: latestRelease
+              }
+            ]),
+            defaultValue: latestRelease
+          });
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+  });
+  describe("getCummulativeRelease", () => {
+    it("returns the correct fixes and features for a release range thats outdated", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const { releases } = await getChangelog();
+          const current = await getHydrogenVersion({ appPath });
+          expect(current?.currentVersion).toBeDefined();
+          const { availableUpgrades } = getAvailableUpgrades({
+            ...current,
+            releases
+          });
+          const selectedRelease = releases.find(
+            (release) => release.version === "2023.4.1"
+          );
+          const { features, fixes } = getCummulativeRelease({
+            availableUpgrades,
+            ...current,
+            // @ts-ignore - we know this release version exists
+            selectedRelease
+          });
+          expect(features).toMatchObject(CUMMLATIVE_RELEASE.features);
+          expect(fixes).toMatchObject(CUMMLATIVE_RELEASE.fixes);
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+  });
+  describe("displayConfirmation", () => {
+    it("renders a confirmation prompt to continue or return to the previous menu", async () => {
+      await inTemporaryHydrogenRepo(
+        async () => {
+          const { releases } = await getChangelog();
+          const selectedRelease = releases.find(
+            (release) => release.version === "2023.10.0"
+          );
+          await expect(
+            displayConfirmation({
+              cumulativeRelease: CUMMLATIVE_RELEASE,
+              selectedRelease
+            })
+          ).resolves.toEqual(false);
+          const info = outputMock.info();
+          expect(info).toMatch("Included in this upgrade");
+          [...CUMMLATIVE_RELEASE.features, ...CUMMLATIVE_RELEASE.fixes].forEach(
+            (feat) => (
+              // Cut the string to avoid matching the banner
+              expect(info).toMatch(feat.title.slice(0, 15))
+            )
+          );
+          expect(renderConfirmationPrompt).toHaveBeenCalledWith({
+            message: `Are you sure you want to upgrade to ${selectedRelease.version}?`,
+            cancellationMessage: `No, choose another version`,
+            defaultValue: true
+          });
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+  });
+  describe("upgradeNodeModules", () => {
+    it("runs the upgrade command task", async () => {
+      await inTemporaryHydrogenRepo(
+        async (appPath) => {
+          const { releases } = await getChangelog();
+          const selectedRelease = releases.find(
+            (release) => release.version === "2023.10.0"
+          );
+          const currentDependencies = {
+            ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+            ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies
+          };
+          await upgradeNodeModules({
+            appPath,
+            selectedRelease,
+            currentDependencies
+          });
+          expect(renderTasks).toHaveBeenCalled();
+        },
+        {
+          cleanGitRepo: true,
+          packageJson: OUTDATED_HYDROGEN_PACKAGE_JSON
+        }
+      );
+    });
+    it("builds the upgrade command args", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies
+      };
+      const result = [
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/remix-oxygen@2.0.0",
+        "@remix-run/react@2.1.0",
+        "@remix-run/dev@2.1.0",
+        "typescript@5.2.2"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(expect.arrayContaining(result));
+    });
+    it("upgrades and syncs up all available Remix deps if they are out-of-date", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "1.3.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "1.2.0",
+        "@remix-run/css-bundle": "1.7.0"
+      };
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0",
+        "typescript@5.2.2",
+        "@remix-run/react@2.1.0",
+        "@remix-run/server-runtime@2.1.0",
+        "@remix-run/dev@2.1.0",
+        "@remix-run/eslint-config@2.1.0",
+        "@remix-run/css-bundle@2.1.0"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(result);
+    });
+    it("upgrades all available Remix deps if they are out-of-date", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "1.8.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "1.8.0",
+        "@remix-run/css-bundle": "1.8.0"
+      };
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0",
+        "typescript@5.2.2",
+        "@remix-run/react@2.1.0",
+        "@remix-run/server-runtime@2.1.0",
+        "@remix-run/dev@2.1.0",
+        "@remix-run/eslint-config@2.1.0",
+        "@remix-run/css-bundle@2.1.0"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(result);
+    });
+    it("does not upgrade Remix deps if they are more up-to-date", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "2.2.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "2.2.0"
+      };
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0",
+        "typescript@5.2.2"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(result);
+    });
+    it("does not install an optional dependency that was not installed", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = Object.create(
+        // @ts-ignore - we know this release version exists
+        releases.find((release) => release.version === "2023.10.0")
+      );
+      selectedRelease.dependenciesMeta = {
+        typescript: {
+          required: false
+        }
+      };
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "2.1.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "2.1.0"
+      };
+      delete currentDependencies["typescript"];
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(result);
+    });
+    it("adds a required dependency that was not installed", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "2.1.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "2.1.0"
+      };
+      delete currentDependencies["typescript"];
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0",
+        `typescript@${getAbsoluteVersion(
+          // @ts-ignore - we know this release version exists
+          selectedRelease.devDependencies.typescript
+        )}`
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(expect.arrayContaining(result));
+    });
+    it("does not upgrade a required dependency that is further up-to-date", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "2.1.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "2.1.0",
+        typescript: "5.3.0"
+        // more up-to-date than that of 2023.10.0
+      };
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/hydrogen@2023.10.0",
+        "@shopify/remix-oxygen@2.0.0"
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(expect.arrayContaining(result));
+    });
+    it("does not upgrade @next dependencies", async () => {
+      const { releases } = await getChangelog();
+      const selectedRelease = releases.find(
+        (release) => release.version === "2023.10.0"
+      );
+      const currentDependencies = {
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.dependencies,
+        "@remix-run/react": "2.1.0",
+        ...OUTDATED_HYDROGEN_PACKAGE_JSON.devDependencies,
+        "@remix-run/dev": "2.1.0",
+        "@shopify/hydrogen": "next"
+      };
+      const result = [
+        "@shopify/cli-hydrogen@6.0.0",
+        "@shopify/remix-oxygen@2.0.0",
+        `typescript@${getAbsoluteVersion(
+          // @ts-ignore - we know this release version exists
+          selectedRelease.devDependencies.typescript
+        )}`
+      ];
+      const args = buildUpgradeCommandArgs({
+        selectedRelease,
+        currentDependencies
+      });
+      expect(args).toEqual(result);
+    });
+  });
+});
+const CUMMLATIVE_RELEASE = {
+  fixes: [
+    {
+      title: "Add a default Powered-By: Shopify-Hydrogen header",
+      pr: "https://github.com/Shopify/hydrogen/pull/872",
+      id: "872",
+      steps: [
+        {
+          title: " It can be disabled by passing poweredByHeader: false in the configuration object of createRequestHandler",
+          code: "YGBgdHMKaW1wb3J0IHtjcmVhdGVSZXF1ZXN0SGFuZGxlcn0gZnJvbSAnQHNob3BpZnkvcmVtaXgtb3h5Z2VuJzsKCmV4cG9ydCBkZWZhdWx0IHsKICBhc3luYyBmZXRjaChyZXF1ZXN0KSB7CiAgICAvLyAuLi4KICAgIGNvbnN0IGhhbmRsZVJlcXVlc3QgPSBjcmVhdGVSZXF1ZXN0SGFuZGxlcih7CiAgICAgIC8vIC4uLiBvdGhlciBwcm9wZXJ0aWVzIGluY2x1ZGVkCiAgICAgIHBvd2VyZWRCeUhlYWRlcjogZmFsc2UsCiAgICB9KTsKICAgIC8vIC4uLgogIH0sCn07CmBgYA",
+          file: "server.ts"
+        }
+      ]
+    },
+    {
+      title: "Updated CLI prompts",
+      pr: "https://github.com/Shopify/hydrogen/pull/733",
+      id: "733",
+      steps: [
+        {
+          title: "Update package.json",
+          code: "YGBgZGlmZgoiZGVwZW5kZW5jaWVzIjogewotICAiQHNob3BpZnkvY2xpIjogIjMueC54IiwKKyAgIkBzaG9waWZ5L2NsaSI6ICIzLjQ1LjAiLAp9CmBgYA==",
+          file: "package.json"
+        }
+      ]
+    },
+    {
+      title: "Added support for the Remix future flags v2_meta, v2_errorBoundary and v2_routeConvention to the generate command",
+      pr: "https://github.com/Shopify/hydrogen/pull/756",
+      id: "756"
+    },
+    {
+      title: "Update virtual route to use Remix V2 route name conventions",
+      pr: "https://github.com/Shopify/hydrogen/pull/792",
+      id: "792"
+    },
+    {
+      title: "Update internal Remix dependencies to 1.15.0",
+      pr: "https://github.com/Shopify/hydrogen/pull/728",
+      id: "728",
+      docs: "https://github.com/remix-run/remix/releases/tag/remix%401.15.0"
+    },
+    {
+      title: "Improve type safety in SEO data generators",
+      pr: "https://github.com/Shopify/hydrogen/pull/763",
+      id: "763"
+    },
+    {
+      title: "Stop hydrating with requestIdleCallback",
+      pr: "https://github.com/Shopify/hydrogen/pull/667",
+      id: "667"
+    },
+    {
+      title: "Fix active cart session event in Live View",
+      pr: "https://github.com/Shopify/hydrogen/pull/614",
+      id: "614",
+      steps: [
+        {
+          title: "Introducing getStorefrontHeaders that collects the required Shopify headers for making a Storefront API call.",
+          code: "YGBgdHMKKyBpbXBvcnQge2dldFN0b3JlZnJvbnRIZWFkZXJzfSBmcm9tICdAc2hvcGlmeS9yZW1peC1veHlnZW4nOwppbXBvcnQge2NyZWF0ZVN0b3JlZnJvbnRDbGllbnQsIHN0b3JlZnJvbnRSZWRpcmVjdH0gZnJvbSAnQHNob3BpZnkvaHlkcm9nZW4nOwoKZXhwb3J0IGRlZmF1bHQgewogIGFzeW5jIGZldGNoKAogICAgcmVxdWVzdDogUmVxdWVzdCwKICAgIGVudjogRW52LAogICAgZXhlY3V0aW9uQ29udGV4dDogRXhlY3V0aW9uQ29udGV4dCwKICApOiBQcm9taXNlPFJlc3BvbnNlPiB7CgogICAgY29uc3Qge3N0b3JlZnJvbnR9ID0gY3JlYXRlU3RvcmVmcm9udENsaWVudCh7CiAgICAgIGNhY2hlLAogICAgICB3YWl0VW50aWwsCi0gICAgIGJ1eWVySXA6IGdldEJ1eWVySXAocmVxdWVzdCksCiAgICAgIGkxOG46IHtsYW5ndWFnZTogJ0VOJywgY291bnRyeTogJ1VTJ30sCiAgICAgIHB1YmxpY1N0b3JlZnJvbnRUb2tlbjogZW52LlBVQkxJQ19TVE9SRUZST05UX0FQSV9UT0tFTiwKICAgICAgcHJpdmF0ZVN0b3JlZnJvbnRUb2tlbjogZW52LlBSSVZBVEVfU1RPUkVGUk9OVF9BUElfVE9LRU4sCiAgICAgIHN0b3JlRG9tYWluOiBgaHR0cHM6Ly8ke2Vudi5QVUJMSUNfU1RPUkVfRE9NQUlOfWAsCiAgICAgIHN0b3JlZnJvbnRBcGlWZXJzaW9uOiBlbnYuUFVCTElDX1NUT1JFRlJPTlRfQVBJX1ZFUlNJT04gfHwgJzIwMjMtMDEnLAogICAgICBzdG9yZWZyb250SWQ6IGVudi5QVUJMSUNfU1RPUkVGUk9OVF9JRCwKLSAgICAgcmVxdWVzdEdyb3VwSWQ6IHJlcXVlc3QuaGVhZGVycy5nZXQoJ3JlcXVlc3QtaWQnKSwKKyAgICAgc3RvcmVmcm9udEhlYWRlcnM6IGdldFN0b3JlZnJvbnRIZWFkZXJzKHJlcXVlc3QpLAogICAgfSk7CmBgYA==",
+          file: "server.ts"
+        }
+      ]
+    }
+  ],
+  features: [
+    {
+      title: "Add command to pull environment variables from a Hydrogen storefront",
+      pr: "https://github.com/Shopify/hydrogen/pull/809",
+      id: "809"
+    },
+    {
+      title: "New --debug flag for the dev command that attaches a Node inspector to the development server",
+      pr: "https://github.com/Shopify/hydrogen/pull/869",
+      id: "869"
+    },
+    {
+      title: "Add new commands for merchants to be able to list and link Hydrogen storefronts",
+      pr: "https://github.com/Shopify/hydrogen/pull/784",
+      id: "784"
+    },
+    {
+      title: "Added parseGid() utility",
+      pr: "https://github.com/Shopify/hydrogen/pull/845",
+      id: "845",
+      steps: [
+        {
+          title: "Example usage",
+          code: "YGBgdHMKaW1wb3J0IHtwYXJzZUdpZH0gZnJvbSAnQHNob3BpZnkvaHlkcm9nZW4tcmVhY3QnOwoKY29uc3Qge2lkLCByZXNvdXJjZX0gPSBwYXJzZUdpZCgnZ2lkOi8vc2hvcGlmeS9PcmRlci8xMjMnKTsKCmNvbnNvbGUubG9nKGlkKTsgLy8gMTIzCmNvbnNvbGUubG9nKHJlc291cmNlKTsgLy8gT3JkZXIKYGBg"
+        }
+      ]
+    },
+    {
+      title: "Added a new shortcut command that creates a global h2 alias for the Hydrogen CLI",
+      pr: "https://github.com/Shopify/hydrogen/pull/679",
+      id: "679",
+      steps: [
+        {
+          title: "Create the h2 alias",
+          code: "YGBgYmFzaApucHggc2hvcGlmeSBoeWRyb2dlbiBzaG9ydGN1dApgYGA="
+        },
+        {
+          title: "After that, you can run commands using the new alias:",
+          code: "YGBgYmFzaApoMiBnZW5lcmF0ZSByb3V0ZSBob21lCmgyIGcgciBob21lICMgU2FtZSBhcyB0aGUgYWJvdmUKaDIgY2hlY2sgcm91dGVzCmBgYA=="
+        }
+      ]
+    },
+    {
+      title: "Add an experimental createWithCache_unstable",
+      info: "This utility creates a function similar to useQuery from Hydrogen v1. Use this utility to query third-party APIs and apply custom cache options",
+      pr: "https://github.com/Shopify/hydrogen/pull/600",
+      id: "600",
+      steps: [
+        {
+          title: "To setup the utility, update your server.ts",
+          file: "server.ts",
+          code: "YGBgdHMKaW1wb3J0IHsKICBjcmVhdGVTdG9yZWZyb250Q2xpZW50LAogIGNyZWF0ZVdpdGhDYWNoZV91bnN0YWJsZSwKICBDYWNoZUxvbmcsCn0gZnJvbSAnQHNob3BpZnkvaHlkcm9nZW4nOwoKLy8gLi4uCgogIGNvbnN0IGNhY2hlID0gYXdhaXQgY2FjaGVzLm9wZW4oJ2h5ZHJvZ2VuJyk7CiAgY29uc3Qgd2l0aENhY2hlID0gY3JlYXRlV2l0aENhY2hlX3Vuc3RhYmxlKHtjYWNoZSwgd2FpdFVudGlsfSk7CgogIC8vIENyZWF0ZSBjdXN0b20gdXRpbGl0aWVzIHRvIHF1ZXJ5IHRoaXJkLXBhcnR5IEFQSXM6CiAgY29uc3QgZmV0Y2hNeUNNUyA9IChxdWVyeSkgPT4gewogICAgLy8gUHJlZml4IHRoZSBjYWNoZSBrZXkgYW5kIG1ha2UgaXQgdW5pcXVlIGJhc2VkIG9uIGFyZ3VtZW50cy4KICAgIHJldHVybiB3aXRoQ2FjaGUoWydteS1jbXMnLCBxdWVyeV0sIENhY2hlTG9uZygpLCAoKSA9PiB7CiAgICAgIGNvbnN0IGNtc0RhdGEgPSBhd2FpdCAoYXdhaXQgZmV0Y2goJ215LWNtcy5jb20vYXBpJywgewogICAgICAgIG1ldGhvZDogJ1BPU1QnLAogICAgICAgIGJvZHk6IHF1ZXJ5CiAgICAgIH0pKS5qc29uKCk7CgogICAgICBjb25zdCBuZXh0UGFnZSA9IChhd2FpdCBmZXRjaCgnbXktY21zLmNvbS9hcGknLCB7CiAgICAgICAgbWV0aG9kOiAnUE9TVCcsCiAgICAgICAgYm9keTogY21zRGF0YTEubmV4dFBhZ2VRdWVyeSwKICAgICAgfSkpLmpzb24oKTsKCiAgICAgIHJldHVybiB7Li4uY21zRGF0YSwgbmV4dFBhZ2V9CiAgICB9KTsKICB9OwoKICBjb25zdCBoYW5kbGVSZXF1ZXN0ID0gY3JlYXRlUmVxdWVzdEhhbmRsZXIoewogICAgYnVpbGQ6IHJlbWl4QnVpbGQsCiAgICBtb2RlOiBwcm9jZXNzLmVudi5OT0RFX0VOViwKICAgIGdldExvYWRDb250ZXh0OiAoKSA9PiAoewogICAgICBzZXNzaW9uLAogICAgICB3YWl0VW50aWwsCiAgICAgIHN0b3JlZnJvbnQsCiAgICAgIGVudiwKICAgICAgZmV0Y2hNeUNNUywKICAgIH0pLAogIH0pOwpgYGA="
+        }
+      ]
+    },
+    {
+      title: "Update Remix to 1.14.0",
+      pr: "https://github.com/Shopify/hydrogen/pull/599",
+      id: "599"
+    },
+    {
+      title: "Added Cache-Control defaults to all the demo store routes",
+      pr: "https://github.com/Shopify/hydrogen/pull/599",
+      id: "599"
+    },
+    {
+      title: "Added new loader API for setting SEO tags within route module",
+      pr: "https://github.com/Shopify/hydrogen/pull/591",
+      id: "591"
+    },
+    {
+      title: "ShopPayButton component now can receive a storeDomain",
+      pr: "https://github.com/Shopify/hydrogen/pull/645",
+      id: "645"
+    },
+    {
+      title: "Added robots option to SEO config that allows users granular control over the robots meta tag.",
+      pr: "https://github.com/Shopify/hydrogen/pull/572",
+      id: "572",
+      steps: [
+        {
+          title: "Example usage",
+          code: "YGBgdHMKZXhwb3J0IGhhbmRsZSA9IHsKICBzZW86IHsKICAgIHJvYm90czogewogICAgICBub0luZGV4OiBmYWxzZSwKICAgICAgbm9Gb2xsb3c6IGZhbHNlLAogICAgfQogIH0KfQpgYGA=",
+          file: "All files that use SEO config"
+        }
+      ]
+    },
+    {
+      title: "Added decoding prop to the SpreadMedia component",
+      pr: "https://github.com/Shopify/hydrogen/pull/642",
+      id: "642"
+    }
+  ]
+};