@shopify/cli-hydrogen 5.0.0 → 5.0.2

package/dist/commands/hydrogen/build.d.ts

@@ -6,7 +6,7 @@ declare class Build extends Command {
     static flags: {
         path: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
         sourcemap: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
-        "disable-route-warning": _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        'disable-route-warning': _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
         base: _oclif_core_lib_interfaces_parser_js.OptionFlag<unknown, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
         entry: _oclif_core_lib_interfaces_parser_js.OptionFlag<unknown, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
         target: _oclif_core_lib_interfaces_parser_js.OptionFlag<unknown, _oclif_core_lib_interfaces_parser_js.CustomOptions>;

package/dist/commands/hydrogen/build.js

@@ -1,14 +1,15 @@
-import path from 'path';
 import { Flags } from '@oclif/core';
 import Command from '@shopify/cli-kit/node/base-command';
 import { outputInfo, outputContent, outputToken, outputWarn } from '@shopify/cli-kit/node/output';
-import { rmdir, fileSize, copyFile } from '@shopify/cli-kit/node/fs';
+import { rmdir, fileSize, glob, removeFile, copyFile } from '@shopify/cli-kit/node/fs';
+import { resolvePath, relativePath, joinPath } from '@shopify/cli-kit/node/path';
 import { getPackageManager } from '@shopify/cli-kit/node/node-package-manager';
 import colors from '@shopify/cli-kit/node/colors';
 import { getProjectPaths, getRemixConfig } from '../../lib/config.js';
 import { commonFlags, deprecated, flagsToCamelObject } from '../../lib/flags.js';
 import { checkLockfileStatus } from '../../lib/check-lockfile.js';
 import { findMissingRoutes } from '../../lib/missing-routes.js';
+import { warnOnce } from '../../lib/log.js';
 
 const LOG_WORKER_BUILT = "\u{1F4E6} Worker built";
 class Build extends Command {
@@ -18,10 +19,9 @@ class Build extends Command {
     sourcemap: Flags.boolean({
       description: "Generate sourcemaps for the build.",
       env: "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
-      default: true,
-      allowNo: true
+      default: false
     }),
-    ["disable-route-warning"]: Flags.boolean({
+    "disable-route-warning": Flags.boolean({
       description: "Disable warning about missing standard routes.",
       env: "SHOPIFY_HYDROGEN_FLAG_DISABLE_ROUTE_WARNING"
     }),
@@ -31,13 +31,13 @@ class Build extends Command {
   };
   async run() {
     const { flags } = await this.parse(Build);
-    const directory = flags.path ? path.resolve(flags.path) : process.cwd();
+    const directory = flags.path ? resolvePath(flags.path) : process.cwd();
     await runBuild({ ...flagsToCamelObject(flags), path: directory });
   }
 }
 async function runBuild({
   path: appPath,
-  sourcemap = true,
+  sourcemap = false,
   disableRouteWarning = false
 }) {
   if (!process.env.NODE_ENV) {
@@ -46,23 +46,28 @@ async function runBuild({
   const { root, buildPath, buildPathClient, buildPathWorkerFile, publicPath } = getProjectPaths(appPath);
   await checkLockfileStatus(root);
   console.time(LOG_WORKER_BUILT);
-  const [remixConfig] = await Promise.all([
+  outputInfo(`
+\u{1F3D7}\uFE0F  Building in ${process.env.NODE_ENV} mode...`);
+  const [remixConfig, { build }, { logThrown }, { createFileWatchCache }] = await Promise.all([
     getRemixConfig(root),
+    import('@remix-run/dev/dist/compiler/build.js'),
+    import('@remix-run/dev/dist/compiler/utils/log.js'),
+    import('@remix-run/dev/dist/compiler/fileWatchCache.js'),
     rmdir(buildPath, { force: true })
   ]);
-  outputInfo(`
-\u{1F3D7}\uFE0F  Building in ${process.env.NODE_ENV} mode...`);
-  const { build } = await import('@remix-run/dev/dist/compiler/build.js');
-  const { logCompileFailure } = await import('@remix-run/dev/dist/compiler/onCompileFailure.js');
   await Promise.all([
     copyPublicFiles(publicPath, buildPathClient),
-    build(remixConfig, {
-      mode: process.env.NODE_ENV,
-      sourcemap,
-      onCompileFailure: (failure) => {
-        logCompileFailure(failure);
-        throw Error();
-      }
+    build({
+      config: remixConfig,
+      options: {
+        mode: process.env.NODE_ENV,
+        onWarning: warnOnce,
+        sourcemap
+      },
+      fileWatchCache: createFileWatchCache()
+    }).catch((thrown) => {
+      logThrown(thrown);
+      process.exit(1);
     })
   ]);
   if (process.env.NODE_ENV !== "development") {
@@ -70,7 +75,7 @@ async function runBuild({
     const sizeMB = await fileSize(buildPathWorkerFile) / (1024 * 1024);
     outputInfo(
       outputContent`   ${colors.dim(
-        path.relative(root, buildPathWorkerFile)
+        relativePath(root, buildPathWorkerFile)
       )}  ${outputToken.yellow(sizeMB.toFixed(2))} MB\n`
     );
     if (sizeMB >= 1) {
@@ -79,6 +84,18 @@ async function runBuild({
 `
       );
     }
+    if (sourcemap) {
+      if (process.env.HYDROGEN_ASSET_BASE_URL) {
+        const filepaths = await glob(joinPath(buildPathClient, "**/*.js.map"));
+        for (const filepath of filepaths) {
+          await removeFile(filepath);
+        }
+      } else {
+        outputWarn(
+          "\u{1F6A8} Sourcemaps are enabled in production! Use this only for testing.\n"
+        );
+      }
+    }
   }
   if (!disableRouteWarning) {
     const missingRoutes = findMissingRoutes(remixConfig);

package/dist/commands/hydrogen/dev.d.ts

@@ -8,7 +8,8 @@ declare class Dev extends Command {
         port: _oclif_core_lib_interfaces_parser_js.OptionFlag<number, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
         "codegen-unstable": _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
         "codegen-config-path": _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
-        "disable-virtual-routes": _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        sourcemap: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        'disable-virtual-routes': _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
         shop: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
         debug: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
         host: _oclif_core_lib_interfaces_parser_js.OptionFlag<unknown, _oclif_core_lib_interfaces_parser_js.CustomOptions>;

package/dist/commands/hydrogen/dev.js

@@ -2,9 +2,11 @@ import path from 'path';
 import fs from 'fs/promises';
 import { outputInfo } from '@shopify/cli-kit/node/output';
 import { fileExists } from '@shopify/cli-kit/node/fs';
+import { renderFatalError } from '@shopify/cli-kit/node/ui';
+import colors from '@shopify/cli-kit/node/colors';
 import { copyPublicFiles } from './build.js';
 import { getProjectPaths, getRemixConfig } from '../../lib/config.js';
-import { muteDevLogs } from '../../lib/log.js';
+import { muteDevLogs, warnOnce } from '../../lib/log.js';
 import { commonFlags, deprecated, flagsToCamelObject } from '../../lib/flags.js';
 import Command from '@shopify/cli-kit/node/base-command';
 import { Flags } from '@oclif/core';
@@ -15,7 +17,6 @@ import { spawnCodegenProcess } from '../../lib/codegen.js';
 import { combinedEnvironmentVariables } from '../../lib/combined-environment-variables.js';
 import { getConfig } from '../../lib/shopify-config.js';
 
-const LOG_INITIAL_BUILD = "\n\u{1F3C1} Initial build";
 const LOG_REBUILDING = "\u{1F9F1} Rebuilding...";
 const LOG_REBUILT = "\u{1F680} Rebuilt";
 class Dev extends Command {
@@ -33,7 +34,8 @@ class Dev extends Command {
       required: false,
       dependsOn: ["codegen-unstable"]
     }),
-    ["disable-virtual-routes"]: Flags.boolean({
+    sourcemap: commonFlags.sourcemap,
+    "disable-virtual-routes": Flags.boolean({
       description: "Disable rendering fallback routes when a route file doesn't exist.",
       env: "SHOPIFY_HYDROGEN_FLAG_DISABLE_VIRTUAL_ROUTES",
       default: false
@@ -65,14 +67,14 @@ async function runDev({
   disableVirtualRoutes,
   shop,
   envBranch,
-  debug = false
+  debug = false,
+  sourcemap = true
 }) {
   if (!process.env.NODE_ENV)
     process.env.NODE_ENV = "development";
   muteDevLogs();
   if (debug)
     (await import('node:inspector')).open();
-  console.time(LOG_INITIAL_BUILD);
   const { root, publicPath, buildPathClient, buildPathWorkerFile } = getProjectPaths(appPath);
   const checkingHydrogenVersion = checkHydrogenVersion(root);
   const copyingFiles = copyPublicFiles(publicPath, buildPathClient);
@@ -91,11 +93,18 @@ async function runDev({
     shop,
     envBranch
   }) : void 0;
-  let miniOxygenStarted = false;
+  const [{ watch }, { createFileWatchCache }] = await Promise.all([
+    import('@remix-run/dev/dist/compiler/watch.js'),
+    import('@remix-run/dev/dist/compiler/fileWatchCache.js')
+  ]);
+  let isInitialBuild = true;
+  let initialBuildDurationMs = 0;
+  let initialBuildStartTimeMs = Date.now();
+  let isMiniOxygenStarted = false;
   async function safeStartMiniOxygen() {
-    if (miniOxygenStarted)
+    if (isMiniOxygenStarted)
       return;
-    await startMiniOxygen({
+    const miniOxygen = await startMiniOxygen({
       root,
       port,
       watch: true,
@@ -103,75 +112,100 @@ async function runDev({
       buildPathClient,
       environmentVariables
     });
-    miniOxygenStarted = true;
+    isMiniOxygenStarted = true;
+    miniOxygen.showBanner({
+      headlinePrefix: initialBuildDurationMs > 0 ? `Initial build: ${initialBuildDurationMs}ms
+` : "",
+      extraLines: [
+        colors.dim(
+          `
+View GraphiQL API browser: ${miniOxygen.listeningAt}/graphiql`
+        )
+      ]
+    });
     const showUpgrade = await checkingHydrogenVersion;
     if (showUpgrade)
       showUpgrade();
   }
-  const { watch } = await import('@remix-run/dev/dist/compiler/watch.js');
   const remixConfig = await reloadConfig();
   if (codegen) {
     spawnCodegenProcess({ ...remixConfig, configFilePath: codegenConfigPath });
   }
-  await watch(remixConfig, {
-    reloadConfig,
-    mode: process.env.NODE_ENV,
-    async onInitialBuild() {
-      await copyingFiles;
-      if (!await serverBundleExists()) {
-        const { renderFatalError } = await import('@shopify/cli-kit/node/ui');
-        return renderFatalError({
-          name: "BuildError",
-          type: 0,
-          message: "MiniOxygen cannot start because the server bundle has not been generated.",
-          tryMessage: "This is likely due to an error in your app and Remix is unable to compile. Try fixing the app and MiniOxygen will start."
-        });
-      }
-      console.timeEnd(LOG_INITIAL_BUILD);
-      await safeStartMiniOxygen();
+  const fileWatchCache = createFileWatchCache();
+  await watch(
+    {
+      config: remixConfig,
+      options: {
+        mode: process.env.NODE_ENV,
+        onWarning: warnOnce,
+        sourcemap
+      },
+      fileWatchCache
     },
-    async onFileCreated(file) {
-      const [relative, absolute] = getFilePaths(file);
-      outputInfo(`
+    {
+      reloadConfig,
+      onBuildStart() {
+        if (!isInitialBuild) {
+          console.time(LOG_REBUILT);
+          outputInfo(LOG_REBUILDING);
+        }
+      },
+      async onBuildFinish() {
+        if (isInitialBuild) {
+          await copyingFiles;
+          initialBuildDurationMs = Date.now() - initialBuildStartTimeMs;
+          isInitialBuild = false;
+        } else {
+          console.timeEnd(LOG_REBUILT);
+          if (!isMiniOxygenStarted)
+            console.log("");
+        }
+        if (!isMiniOxygenStarted) {
+          if (!await serverBundleExists()) {
+            return renderFatalError({
+              name: "BuildError",
+              type: 0,
+              message: "MiniOxygen cannot start because the server bundle has not been generated.",
+              tryMessage: "This is likely due to an error in your app and Remix is unable to compile. Try fixing the app and MiniOxygen will start."
+            });
+          }
+          await safeStartMiniOxygen();
+        }
+      },
+      async onFileCreated(file) {
+        const [relative, absolute] = getFilePaths(file);
+        outputInfo(`
 \u{1F4C4} File created: ${relative}`);
-      if (absolute.startsWith(publicPath)) {
-        await copyPublicFiles(
-          absolute,
-          absolute.replace(publicPath, buildPathClient)
-        );
-      }
-    },
-    async onFileChanged(file) {
-      const [relative, absolute] = getFilePaths(file);
-      outputInfo(`
+        if (absolute.startsWith(publicPath)) {
+          await copyPublicFiles(
+            absolute,
+            absolute.replace(publicPath, buildPathClient)
+          );
+        }
+      },
+      async onFileChanged(file) {
+        fileWatchCache.invalidateFile(file);
+        const [relative, absolute] = getFilePaths(file);
+        outputInfo(`
 \u{1F4C4} File changed: ${relative}`);
-      if (absolute.startsWith(publicPath)) {
-        await copyPublicFiles(
-          absolute,
-          absolute.replace(publicPath, buildPathClient)
-        );
-      }
-    },
-    async onFileDeleted(file) {
-      const [relative, absolute] = getFilePaths(file);
-      outputInfo(`
+        if (absolute.startsWith(publicPath)) {
+          await copyPublicFiles(
+            absolute,
+            absolute.replace(publicPath, buildPathClient)
+          );
+        }
+      },
+      async onFileDeleted(file) {
+        fileWatchCache.invalidateFile(file);
+        const [relative, absolute] = getFilePaths(file);
+        outputInfo(`
 \u{1F4C4} File deleted: ${relative}`);
-      if (absolute.startsWith(publicPath)) {
-        await fs.unlink(absolute.replace(publicPath, buildPathClient));
-      }
-    },
-    onRebuildStart() {
-      outputInfo(LOG_REBUILDING);
-      console.time(LOG_REBUILT);
-    },
-    async onRebuildFinish() {
-      console.timeEnd(LOG_REBUILT);
-      if (!miniOxygenStarted && await serverBundleExists()) {
-        console.log("");
-        await safeStartMiniOxygen();
+        if (absolute.startsWith(publicPath)) {
+          await fs.unlink(absolute.replace(publicPath, buildPathClient));
+        }
       }
     }
-  });
+  );
 }
 
 export { Dev as default };

package/dist/commands/hydrogen/link.js

@@ -1,12 +1,17 @@
 import { Flags } from '@oclif/core';
 import Command from '@shopify/cli-kit/node/base-command';
-import { renderConfirmationPrompt, renderWarning, renderSelectPrompt, renderSuccess } from '@shopify/cli-kit/node/ui';
+import { basename } from '@shopify/cli-kit/node/path';
+import { renderConfirmationPrompt, renderWarning, renderSelectPrompt, renderTextPrompt, renderTasks, renderSuccess } from '@shopify/cli-kit/node/ui';
 import { commonFlags } from '../../lib/flags.js';
 import { getHydrogenShop } from '../../lib/shop.js';
 import { getStorefronts } from '../../lib/graphql/admin/link-storefront.js';
+import { createStorefront } from '../../lib/graphql/admin/create-storefront.js';
+import { waitForJob } from '../../lib/graphql/admin/fetch-job.js';
 import { getConfig, setStorefront } from '../../lib/shopify-config.js';
 import { logMissingStorefronts } from '../../lib/missing-storefronts.js';
+import { titleize } from '../../lib/string.js';
 import { getCliCommand } from '../../lib/shell.js';
+import { renderUserErrors, renderError } from '../../lib/user-errors.js';
 
 class Link extends Command {
   static description = "Link a local project to one of your shop's Hydrogen storefronts.";
@@ -24,6 +29,7 @@ class Link extends Command {
     await linkStorefront(flags);
   }
 }
+const CREATE_NEW_STOREFRONT_ID = "NEW_STOREFRONT";
 async function linkStorefront({
   force,
   path,
@@ -47,6 +53,7 @@ async function linkStorefront({
     return;
   }
   let selectedStorefront;
+  let selectCreateNewStorefront = false;
   const cliCommand = await getCliCommand();
   if (flagStorefront) {
     selectedStorefront = storefronts.find(
@@ -77,11 +84,61 @@ async function linkStorefront({
       message: "Choose a Hydrogen storefront to link",
       choices
     });
-    selectedStorefront = storefronts.find(({ id }) => id === storefrontId);
+    if (storefrontId === CREATE_NEW_STOREFRONT_ID) {
+      selectCreateNewStorefront = true;
+    } else {
+      selectedStorefront = storefronts.find(({ id }) => id === storefrontId);
+    }
   }
-  if (!selectedStorefront) {
-    return;
+  if (selectCreateNewStorefront) {
+    const storefront = await createNewStorefront(path, shop);
+    if (!storefront) {
+      return;
+    }
+    selectedStorefront = storefront;
   }
+  if (selectedStorefront) {
+    await linkExistingStorefront(path, selectedStorefront, silent, cliCommand);
+  }
+}
+async function createNewStorefront(path, shop) {
+  const projectDirectory = path && basename(path);
+  const projectName = await renderTextPrompt({
+    message: "What do you want to name the Hydrogen storefront on Shopify?",
+    defaultValue: titleize(projectDirectory) || "Hydrogen Storefront"
+  });
+  let storefront;
+  let jobId;
+  await renderTasks([
+    {
+      title: "Creating storefront",
+      task: async () => {
+        const result = await createStorefront(shop, projectName);
+        storefront = result.storefront;
+        jobId = result.jobId;
+        if (result.userErrors.length > 0) {
+          renderUserErrors(result.userErrors);
+        }
+      }
+    },
+    {
+      title: "Creating API tokens",
+      task: async () => {
+        try {
+          await waitForJob(shop, jobId);
+        } catch (_err) {
+          storefront = void 0;
+          renderError(
+            "Please try again or contact support if the error persists."
+          );
+        }
+      },
+      skip: () => !jobId
+    }
+  ]);
+  return storefront;
+}
+async function linkExistingStorefront(path, selectedStorefront, silent, cliCommand) {
   await setStorefront(path ?? process.cwd(), selectedStorefront);
   if (!silent) {
     renderSuccess({

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

@@ -1,9 +1,12 @@
 import { vi, describe, beforeEach, afterEach, it, expect } from 'vitest';
 import { mockAndCaptureOutput } from '@shopify/cli-kit/node/testing/output';
-import { renderSelectPrompt, renderConfirmationPrompt } from '@shopify/cli-kit/node/ui';
+import { renderSelectPrompt, renderTextPrompt, renderConfirmationPrompt } from '@shopify/cli-kit/node/ui';
 import { adminRequest } from '../../lib/graphql.js';
 import { getStorefronts } from '../../lib/graphql/admin/link-storefront.js';
+import { createStorefront } from '../../lib/graphql/admin/create-storefront.js';
+import { waitForJob } from '../../lib/graphql/admin/fetch-job.js';
 import { getConfig, setStorefront } from '../../lib/shopify-config.js';
+import { renderUserErrors, renderError } from '../../lib/user-errors.js';
 import { linkStorefront } from './link.js';
 
 const SHOP = "my-shop";
@@ -16,12 +19,16 @@ vi.mock("@shopify/cli-kit/node/ui", async () => {
   return {
     ...original,
     renderConfirmationPrompt: vi.fn(),
-    renderSelectPrompt: vi.fn()
+    renderSelectPrompt: vi.fn(),
+    renderTextPrompt: vi.fn()
   };
 });
 vi.mock("../../lib/graphql.js");
 vi.mock("../../lib/shopify-config.js");
 vi.mock("../../lib/graphql/admin/link-storefront.js");
+vi.mock("../../lib/graphql/admin/create-storefront.js");
+vi.mock("../../lib/graphql/admin/fetch-job.js");
+vi.mock("../../lib/user-errors.js");
 vi.mock("../../lib/shop.js", () => ({
   getHydrogenShop: () => SHOP
 }));
@@ -52,28 +59,90 @@ describe("link", () => {
     await linkStorefront({});
     expect(getStorefronts).toHaveBeenCalledWith(SHOP);
   });
-  it("renders a list of choices and forwards the selection to setStorefront", async () => {
-    vi.mocked(renderSelectPrompt).mockResolvedValue(
-      "gid://shopify/HydrogenStorefront/1"
-    );
-    await linkStorefront({ path: "my-path" });
-    expect(setStorefront).toHaveBeenCalledWith(
-      "my-path",
-      expect.objectContaining({
-        id: "gid://shopify/HydrogenStorefront/1",
-        title: "Hydrogen"
-      })
-    );
+  describe("when you want to link an existing Hydrogen storefront", () => {
+    beforeEach(async () => {
+      vi.mocked(renderSelectPrompt).mockResolvedValue(
+        "gid://shopify/HydrogenStorefront/1"
+      );
+    });
+    it("renders a list of choices and forwards the selection to setStorefront", async () => {
+      await linkStorefront({ path: "my-path" });
+      expect(setStorefront).toHaveBeenCalledWith(
+        "my-path",
+        expect.objectContaining({
+          id: "gid://shopify/HydrogenStorefront/1",
+          title: "Hydrogen"
+        })
+      );
+    });
+    it("renders a success message", async () => {
+      await linkStorefront({ path: "my-path" });
+      expect(outputMock.info()).toMatch(/Hydrogen is now linked/g);
+      expect(outputMock.info()).toMatch(
+        /Run `h2 dev` to start your local development server and start building/g
+      );
+    });
   });
-  it("renders a success message", async () => {
-    vi.mocked(renderSelectPrompt).mockResolvedValue(
-      "gid://shopify/HydrogenStorefront/1"
-    );
-    await linkStorefront({ path: "my-path" });
-    expect(outputMock.info()).toMatch(/Hydrogen is now linked/g);
-    expect(outputMock.info()).toMatch(
-      /Run `h2 dev` to start your local development server and start building/g
-    );
+  describe("when you want to link a new Hydrogen storefront", () => {
+    const expectedStorefrontName = "New Storefront";
+    const expectedJobId = "gid://shopify/Job/1";
+    beforeEach(async () => {
+      vi.mocked(renderSelectPrompt).mockResolvedValue("NEW_STOREFRONT");
+      vi.mocked(createStorefront).mockResolvedValue({
+        adminSession: ADMIN_SESSION,
+        storefront: {
+          id: "gid://shopify/HydrogenStorefront/1",
+          title: expectedStorefrontName,
+          productionUrl: "https://example.com"
+        },
+        userErrors: [],
+        jobId: expectedJobId
+      });
+    });
+    it("chooses to create a new storefront given the directory path", async () => {
+      await linkStorefront({ path: "my-path" });
+      expect(renderTextPrompt).toHaveBeenCalledWith({
+        message: expect.stringMatching(/name/i),
+        defaultValue: "My Path"
+      });
+    });
+    it("chooses to create a new storefront without directory path", async () => {
+      await linkStorefront({});
+      expect(renderTextPrompt).toHaveBeenCalledWith({
+        message: expect.stringMatching(/name/i),
+        defaultValue: "Hydrogen Storefront"
+      });
+    });
+    it("handles the successful creation of the storefront on Admin", async () => {
+      await linkStorefront({});
+      expect(waitForJob).toHaveBeenCalledWith(SHOP, expectedJobId);
+      expect(outputMock.info()).toContain(
+        `${expectedStorefrontName} is now linked`
+      );
+    });
+    it("handles the user-errors when creating the storefront on Admin", async () => {
+      const expectedUserErrors = [
+        {
+          code: "INVALID",
+          field: [],
+          message: "Bad thing happend."
+        }
+      ];
+      vi.mocked(createStorefront).mockResolvedValue({
+        adminSession: ADMIN_SESSION,
+        storefront: void 0,
+        userErrors: expectedUserErrors,
+        jobId: void 0
+      });
+      await linkStorefront({});
+      expect(waitForJob).not.toHaveBeenCalled();
+      expect(renderUserErrors).toHaveBeenCalledWith(expectedUserErrors);
+    });
+    it("handles the job errors when creating the storefront on Admin", async () => {
+      vi.mocked(waitForJob).mockRejectedValue(void 0);
+      await linkStorefront({});
+      expect(renderError).toHaveBeenCalled();
+    });
   });
   describe("when there are no Hydrogen storefronts", () => {
     it("renders a message and returns early", async () => {

package/dist/commands/hydrogen/preview.js

@@ -23,12 +23,13 @@ async function runPreview({
     process.env.NODE_ENV = "production";
   muteDevLogs({ workerReload: false });
   const { root, buildPathWorkerFile, buildPathClient } = getProjectPaths(appPath);
-  await startMiniOxygen({
+  const miniOxygen = await startMiniOxygen({
     root,
     port,
     buildPathClient,
     buildPathWorkerFile
   });
+  miniOxygen.showBanner({ mode: "preview" });
 }
 
 export { Preview as default, runPreview };

package/dist/lib/config.d.ts

@@ -1,5 +1,7 @@
 import { ServerMode } from '@remix-run/dev/dist/config/serverModes.js';
+export { ServerMode } from '@remix-run/dev/dist/config/serverModes.js';
 import { RemixConfig } from '@remix-run/dev/dist/config.js';
+export { RemixConfig } from '@remix-run/dev/dist/config.js';
 
 declare function getProjectPaths(appPath?: string, entry?: string): {
     root: string;

package/dist/lib/flags.d.ts

@@ -6,6 +6,7 @@ declare const commonFlags: {
     force: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
     shop: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
     "env-branch": _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
+    sourcemap: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
 };
 declare function flagsToCamelObject(obj: Record<string, any>): any;
 /**

package/dist/lib/flags.js

@@ -29,6 +29,12 @@ const commonFlags = {
     description: "Specify an environment's branch name when using remote environment variables.",
     env: "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
     char: "e"
+  }),
+  sourcemap: Flags.boolean({
+    description: "Generate sourcemaps for the build.",
+    env: "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
+    default: true,
+    allowNo: true
   })
 };
 function flagsToCamelObject(obj) {

package/dist/lib/graphql/admin/create-storefront.d.ts

@@ -0,0 +1,17 @@
+import { AdminSession } from '@shopify/cli-kit/node/session';
+import { UserError } from '../../user-errors.js';
+
+declare const CreateStorefrontMutation = "#graphql\n  mutation CreateStorefront($title: String!) {\n    hydrogenStorefrontCreate(title: $title) {\n      hydrogenStorefront {\n        id\n        title\n        productionUrl\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      jobId\n    }\n  }\n";
+interface HydrogenStorefront {
+    id: string;
+    title: string;
+    productionUrl: string;
+}
+declare function createStorefront(shop: string, title: string): Promise<{
+    adminSession: AdminSession;
+    storefront: HydrogenStorefront | undefined;
+    userErrors: UserError[];
+    jobId: string | undefined;
+}>;
+
+export { CreateStorefrontMutation, createStorefront };

package/dist/lib/graphql/admin/create-storefront.js

@@ -0,0 +1,38 @@
+import { adminRequest } from '../../graphql.js';
+import { getAdminSession } from '../../admin-session.js';
+
+const CreateStorefrontMutation = `#graphql
+  mutation CreateStorefront($title: String!) {
+    hydrogenStorefrontCreate(title: $title) {
+      hydrogenStorefront {
+        id
+        title
+        productionUrl
+      }
+      userErrors {
+        code
+        field
+        message
+      }
+      jobId
+    }
+  }
+`;
+async function createStorefront(shop, title) {
+  const adminSession = await getAdminSession(shop);
+  const { hydrogenStorefrontCreate } = await adminRequest(
+    CreateStorefrontMutation,
+    adminSession,
+    {
+      title
+    }
+  );
+  return {
+    adminSession,
+    storefront: hydrogenStorefrontCreate.hydrogenStorefront,
+    userErrors: hydrogenStorefrontCreate.userErrors,
+    jobId: hydrogenStorefrontCreate.jobId
+  };
+}
+
+export { CreateStorefrontMutation, createStorefront };

package/dist/lib/graphql/admin/fetch-job.d.ts

@@ -0,0 +1,23 @@
+import { AdminSession } from '@shopify/cli-kit/node/session';
+
+declare const FetchJobQuery = "#graphql\n  query FetchJob($id: ID!) {\n    hydrogenStorefrontJob(id: $id) {\n      id\n      done\n      errors {\n        code\n        message\n      }\n    }\n  }\n";
+interface JobError {
+    code: string;
+    message: string | undefined;
+}
+interface JobSchema {
+    hydrogenStorefrontJob: {
+        id: string;
+        done: boolean;
+        errors: JobError[];
+    };
+}
+declare function fetchJob(shop: string, jobId: string): Promise<{
+    adminSession: AdminSession;
+    id: string;
+    done: boolean;
+    errors: JobError[];
+}>;
+declare function waitForJob(shop: string, jobId: string): Promise<void>;
+
+export { FetchJobQuery, JobSchema, fetchJob, waitForJob };

package/dist/lib/graphql/admin/fetch-job.js

@@ -0,0 +1,48 @@
+import { adminRequest } from '../../graphql.js';
+import { getAdminSession } from '../../admin-session.js';
+
+const FetchJobQuery = `#graphql
+  query FetchJob($id: ID!) {
+    hydrogenStorefrontJob(id: $id) {
+      id
+      done
+      errors {
+        code
+        message
+      }
+    }
+  }
+`;
+async function fetchJob(shop, jobId) {
+  const adminSession = await getAdminSession(shop);
+  const { hydrogenStorefrontJob } = await adminRequest(
+    FetchJobQuery,
+    adminSession,
+    {
+      id: jobId
+    }
+  );
+  return {
+    adminSession,
+    id: hydrogenStorefrontJob.id,
+    done: hydrogenStorefrontJob.done,
+    errors: hydrogenStorefrontJob.errors
+  };
+}
+function waitForJob(shop, jobId) {
+  return new Promise((resolve, reject) => {
+    const interval = setInterval(async () => {
+      const job = await fetchJob(shop, jobId);
+      if (job.errors.length > 0) {
+        clearInterval(interval);
+        return reject();
+      }
+      if (job.done) {
+        clearInterval(interval);
+        return resolve();
+      }
+    }, 500);
+  });
+}
+
+export { FetchJobQuery, fetchJob, waitForJob };

package/dist/lib/log.d.ts

@@ -1,5 +1,6 @@
 declare function muteDevLogs({ workerReload }?: {
     workerReload?: boolean;
 }): void;
+declare const warnOnce: (string: string) => void;
 
-export { muteDevLogs };
+export { muteDevLogs, warnOnce };

package/dist/lib/log.js

@@ -16,5 +16,12 @@ function muteDevLogs({ workerReload } = {}) {
     return log(first, ...rest);
   };
 }
+const warnings = /* @__PURE__ */ new Set();
+const warnOnce = (string) => {
+  if (!warnings.has(string)) {
+    console.warn(string);
+    warnings.add(string);
+  }
+};
 
-export { muteDevLogs };
+export { muteDevLogs, warnOnce };

package/dist/lib/mini-oxygen.d.ts

@@ -8,7 +8,15 @@ type MiniOxygenOptions = {
         [key: string]: string;
     };
 };
-declare function startMiniOxygen({ root, port, watch, buildPathWorkerFile, buildPathClient, environmentVariables, }: MiniOxygenOptions): Promise<void>;
+declare function startMiniOxygen({ root, port, watch, buildPathWorkerFile, buildPathClient, environmentVariables, }: MiniOxygenOptions): Promise<{
+    listeningAt: string;
+    port: number;
+    showBanner(options?: {
+        mode?: string;
+        headlinePrefix?: string;
+        extraLines?: string[];
+    }): void;
+}>;
 declare function logResponse(request: Request, response: Response): void;
 
 export { logResponse, startMiniOxygen };

package/dist/lib/mini-oxygen.js

@@ -1,7 +1,8 @@
-import { outputInfo, outputContent, outputToken } from '@shopify/cli-kit/node/output';
+import { outputToken, outputInfo, outputContent } from '@shopify/cli-kit/node/output';
 import { resolvePath } from '@shopify/cli-kit/node/path';
 import { fileExists } from '@shopify/cli-kit/node/fs';
 import colors from '@shopify/cli-kit/node/colors';
+import { renderSuccess } from '@shopify/cli-kit/node/ui';
 
 async function startMiniOxygen({
   root,
@@ -36,12 +37,19 @@ async function startMiniOxygen({
     )
   });
   const listeningAt = `http://localhost:${actualPort}`;
-  outputInfo(
-    outputContent`🚥 MiniOxygen server started at ${outputToken.link(
-      listeningAt,
-      listeningAt
-    )}\n`
-  );
+  return {
+    listeningAt,
+    port: actualPort,
+    showBanner(options) {
+      renderSuccess({
+        headline: `${options?.headlinePrefix ?? ""}MiniOxygen ${options?.mode ?? "development"} server running.`,
+        body: [
+          `View Hydrogen app: ${listeningAt}`,
+          ...options?.extraLines ?? []
+        ]
+      });
+    }
+  };
 }
 function logResponse(request, response) {
   try {

package/dist/lib/string.d.ts

@@ -0,0 +1,3 @@
+declare function titleize(name?: string): string;
+
+export { titleize };

package/dist/lib/string.js

@@ -0,0 +1,7 @@
+function titleize(name = "") {
+  return name.replace(/[\W_]+/g, " ").split(" ").filter((word) => word.length > 0).map(
+    (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+  ).join(" ");
+}
+
+export { titleize };

package/dist/lib/string.test.d.ts

@@ -0,0 +1 @@
+

package/dist/lib/string.test.js

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'vitest';
+import { titleize } from './string.js';
+
+describe("titleize", () => {
+  const TEST_DIRECTORY_NAMES = {
+    "demo-storefront": "Demo Storefront",
+    "nifty \u{1F602} project ": "Nifty Project",
+    "Hello \u{1F602}": "Hello",
+    _____: ""
+  };
+  it("replaces non-alpha-numeric characters with spaces and capitalizes the first letter of every word", () => {
+    for (const [input, expected] of Object.entries(TEST_DIRECTORY_NAMES)) {
+      expect(titleize(input)).toBe(expected);
+    }
+  });
+});

package/dist/lib/user-errors.d.ts

@@ -0,0 +1,9 @@
+interface UserError {
+    code: string | undefined;
+    field: string[];
+    message: string;
+}
+declare function renderUserErrors(userErrors: UserError[]): void;
+declare function renderError(message: string): void;
+
+export { UserError, renderError, renderUserErrors };

package/dist/lib/user-errors.js

@@ -0,0 +1,11 @@
+import { AbortError } from '@shopify/cli-kit/node/error';
+
+function renderUserErrors(userErrors) {
+  const errorMessages = userErrors.map(({ message }) => message).join(", ");
+  renderError(errorMessages);
+}
+function renderError(message) {
+  throw new AbortError(message);
+}
+
+export { renderError, renderUserErrors };

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"5.0.0","commands":{"hydrogen:build":{"id":"hydrogen:build","description":"Builds a Hydrogen storefront for production.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"sourcemap":{"name":"sourcemap","type":"boolean","description":"Generate sourcemaps for the build.","allowNo":true},"disable-route-warning":{"name":"disable-route-warning","type":"boolean","description":"Disable warning about missing standard routes.","allowNo":false},"base":{"name":"base","type":"option","hidden":true,"multiple":false},"entry":{"name":"entry","type":"option","hidden":true,"multiple":false},"target":{"name":"target","type":"option","hidden":true,"multiple":false}},"args":[]},"hydrogen:check":{"id":"hydrogen:check","description":"Returns diagnostic information about a Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[{"name":"resource","description":"The resource to check. Currently only 'routes' is supported.","required":true,"options":["routes"]}]},"hydrogen:codegen-unstable":{"id":"hydrogen:codegen-unstable","description":"Generate types for the Storefront API queries found in your project.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"codegen-config-path":{"name":"codegen-config-path","type":"option","description":"Specify a path to a codegen configuration file. Defaults to `<root>/codegen.ts` if it exists.","required":false,"multiple":false},"force-sfapi-version":{"name":"force-sfapi-version","type":"option","description":"Force generating Storefront API types for a specific version instead of using the one provided in Hydrogen. A token can also be provided with this format: `<version>:<token>`.","hidden":true,"multiple":false},"watch":{"name":"watch","type":"boolean","description":"Watch the project for changes to update types on file save.","required":false,"allowNo":false}},"args":[]},"hydrogen:dev":{"id":"hydrogen:dev","description":"Runs Hydrogen storefront in an Oxygen worker for development.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"port":{"name":"port","type":"option","description":"Port to run the server on.","multiple":false,"default":3000},"codegen-unstable":{"name":"codegen-unstable","type":"boolean","description":"Generate types for the Storefront API queries found in your project. It updates the types on file save.","required":false,"allowNo":false},"codegen-config-path":{"name":"codegen-config-path","type":"option","description":"Specify a path to a codegen configuration file. Defaults to `<root>/codegen.ts` if it exists.","required":false,"multiple":false,"dependsOn":["codegen-unstable"]},"disable-virtual-routes":{"name":"disable-virtual-routes","type":"boolean","description":"Disable rendering fallback routes when a route file doesn't exist.","allowNo":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"debug":{"name":"debug","type":"boolean","description":"Attaches a Node inspector","allowNo":false},"host":{"name":"host","type":"option","hidden":true,"multiple":false},"env-branch":{"name":"env-branch","type":"option","char":"e","description":"Specify an environment's branch name when using remote environment variables.","multiple":false}},"args":[]},"hydrogen:g":{"id":"hydrogen:g","description":"Shortcut for `hydrogen generate`. See `hydrogen generate --help` for more information.","strict":false,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","hidden":true,"aliases":[],"flags":{},"args":[]},"hydrogen:init":{"id":"hydrogen:init","description":"Creates a new Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the new Hydrogen storefront.","multiple":false},"language":{"name":"language","type":"option","description":"Sets the template language to use. One of `js` or `ts`.","multiple":false},"template":{"name":"template","type":"option","description":"Sets the template to use. One of `demo-store` or `hello-world`.","multiple":false},"install-deps":{"name":"install-deps","type":"boolean","description":"Auto install dependencies using the active package manager","allowNo":true}},"args":[]},"hydrogen:link":{"id":"hydrogen:link","description":"Link a local project to one of your shop's Hydrogen storefronts.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"storefront":{"name":"storefront","type":"option","description":"The name of a Hydrogen Storefront (e.g. \"Jane's Apparel\")","multiple":false}},"args":[]},"hydrogen:list":{"id":"hydrogen:list","description":"Returns a list of Hydrogen storefronts available on a given shop.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false}},"args":[]},"hydrogen:preview":{"id":"hydrogen:preview","description":"Runs a Hydrogen storefront in an Oxygen worker for production.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"port":{"name":"port","type":"option","description":"Port to run the server on.","multiple":false,"default":3000}},"args":[]},"hydrogen:shortcut":{"id":"hydrogen:shortcut","description":"Creates a global `h2` shortcut for the Hydrogen CLI","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{},"args":[]},"hydrogen:unlink":{"id":"hydrogen:unlink","description":"Unlink a local project from a Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[]},"hydrogen:env:list":{"id":"hydrogen:env:list","description":"List the environments on your linked Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false}},"args":[]},"hydrogen:env:pull":{"id":"hydrogen:env:pull","description":"Populate your .env with variables from your Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"env-branch":{"name":"env-branch","type":"option","char":"e","description":"Specify an environment's branch name when using remote environment variables.","multiple":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false}},"args":[]},"hydrogen:generate:route":{"id":"hydrogen:generate:route","description":"Generates a standard Shopify route.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"adapter":{"name":"adapter","type":"option","description":"Remix adapter used in the route. The default is `@shopify/remix-oxygen`.","multiple":false},"typescript":{"name":"typescript","type":"boolean","description":"Generate TypeScript files","allowNo":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[{"name":"route","description":"The route to generate. One of home,page,cart,products,collections,policies,robots,sitemap,account,all.","required":true,"options":["home","page","cart","products","collections","policies","robots","sitemap","account","all"]}]},"hydrogen:generate:routes":{"id":"hydrogen:generate:routes","description":"Generates all supported standard shopify routes.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"adapter":{"name":"adapter","type":"option","description":"Remix adapter used in the route. The default is `@shopify/remix-oxygen`.","multiple":false},"typescript":{"name":"typescript","type":"boolean","description":"Generate TypeScript files","allowNo":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[]}}}
+{"version":"5.0.2","commands":{"hydrogen:build":{"id":"hydrogen:build","description":"Builds a Hydrogen storefront for production.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"sourcemap":{"name":"sourcemap","type":"boolean","description":"Generate sourcemaps for the build.","allowNo":false},"disable-route-warning":{"name":"disable-route-warning","type":"boolean","description":"Disable warning about missing standard routes.","allowNo":false},"base":{"name":"base","type":"option","hidden":true,"multiple":false},"entry":{"name":"entry","type":"option","hidden":true,"multiple":false},"target":{"name":"target","type":"option","hidden":true,"multiple":false}},"args":[]},"hydrogen:check":{"id":"hydrogen:check","description":"Returns diagnostic information about a Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[{"name":"resource","description":"The resource to check. Currently only 'routes' is supported.","required":true,"options":["routes"]}]},"hydrogen:codegen-unstable":{"id":"hydrogen:codegen-unstable","description":"Generate types for the Storefront API queries found in your project.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"codegen-config-path":{"name":"codegen-config-path","type":"option","description":"Specify a path to a codegen configuration file. Defaults to `<root>/codegen.ts` if it exists.","required":false,"multiple":false},"force-sfapi-version":{"name":"force-sfapi-version","type":"option","description":"Force generating Storefront API types for a specific version instead of using the one provided in Hydrogen. A token can also be provided with this format: `<version>:<token>`.","hidden":true,"multiple":false},"watch":{"name":"watch","type":"boolean","description":"Watch the project for changes to update types on file save.","required":false,"allowNo":false}},"args":[]},"hydrogen:dev":{"id":"hydrogen:dev","description":"Runs Hydrogen storefront in an Oxygen worker for development.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"port":{"name":"port","type":"option","description":"Port to run the server on.","multiple":false,"default":3000},"codegen-unstable":{"name":"codegen-unstable","type":"boolean","description":"Generate types for the Storefront API queries found in your project. It updates the types on file save.","required":false,"allowNo":false},"codegen-config-path":{"name":"codegen-config-path","type":"option","description":"Specify a path to a codegen configuration file. Defaults to `<root>/codegen.ts` if it exists.","required":false,"multiple":false,"dependsOn":["codegen-unstable"]},"sourcemap":{"name":"sourcemap","type":"boolean","description":"Generate sourcemaps for the build.","allowNo":true},"disable-virtual-routes":{"name":"disable-virtual-routes","type":"boolean","description":"Disable rendering fallback routes when a route file doesn't exist.","allowNo":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"debug":{"name":"debug","type":"boolean","description":"Attaches a Node inspector","allowNo":false},"host":{"name":"host","type":"option","hidden":true,"multiple":false},"env-branch":{"name":"env-branch","type":"option","char":"e","description":"Specify an environment's branch name when using remote environment variables.","multiple":false}},"args":[]},"hydrogen:g":{"id":"hydrogen:g","description":"Shortcut for `hydrogen generate`. See `hydrogen generate --help` for more information.","strict":false,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","hidden":true,"aliases":[],"flags":{},"args":[]},"hydrogen:init":{"id":"hydrogen:init","description":"Creates a new Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the new Hydrogen storefront.","multiple":false},"language":{"name":"language","type":"option","description":"Sets the template language to use. One of `js` or `ts`.","multiple":false},"template":{"name":"template","type":"option","description":"Sets the template to use. One of `demo-store` or `hello-world`.","multiple":false},"install-deps":{"name":"install-deps","type":"boolean","description":"Auto install dependencies using the active package manager","allowNo":true}},"args":[]},"hydrogen:link":{"id":"hydrogen:link","description":"Link a local project to one of your shop's Hydrogen storefronts.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"storefront":{"name":"storefront","type":"option","description":"The name of a Hydrogen Storefront (e.g. \"Jane's Apparel\")","multiple":false}},"args":[]},"hydrogen:list":{"id":"hydrogen:list","description":"Returns a list of Hydrogen storefronts available on a given shop.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false}},"args":[]},"hydrogen:preview":{"id":"hydrogen:preview","description":"Runs a Hydrogen storefront in an Oxygen worker for production.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"port":{"name":"port","type":"option","description":"Port to run the server on.","multiple":false,"default":3000}},"args":[]},"hydrogen:shortcut":{"id":"hydrogen:shortcut","description":"Creates a global `h2` shortcut for the Hydrogen CLI","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{},"args":[]},"hydrogen:unlink":{"id":"hydrogen:unlink","description":"Unlink a local project from a Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[]},"hydrogen:env:list":{"id":"hydrogen:env:list","description":"List the environments on your linked Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false}},"args":[]},"hydrogen:env:pull":{"id":"hydrogen:env:pull","description":"Populate your .env with variables from your Hydrogen storefront.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"env-branch":{"name":"env-branch","type":"option","char":"e","description":"Specify an environment's branch name when using remote environment variables.","multiple":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false},"shop":{"name":"shop","type":"option","char":"s","description":"Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).","multiple":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false}},"args":[]},"hydrogen:generate:route":{"id":"hydrogen:generate:route","description":"Generates a standard Shopify route.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"adapter":{"name":"adapter","type":"option","description":"Remix adapter used in the route. The default is `@shopify/remix-oxygen`.","multiple":false},"typescript":{"name":"typescript","type":"boolean","description":"Generate TypeScript files","allowNo":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[{"name":"route","description":"The route to generate. One of home,page,cart,products,collections,policies,robots,sitemap,account,all.","required":true,"options":["home","page","cart","products","collections","policies","robots","sitemap","account","all"]}]},"hydrogen:generate:routes":{"id":"hydrogen:generate:routes","description":"Generates all supported standard shopify routes.","strict":true,"pluginName":"@shopify/cli-hydrogen","pluginAlias":"@shopify/cli-hydrogen","pluginType":"core","aliases":[],"flags":{"adapter":{"name":"adapter","type":"option","description":"Remix adapter used in the route. The default is `@shopify/remix-oxygen`.","multiple":false},"typescript":{"name":"typescript","type":"boolean","description":"Generate TypeScript files","allowNo":false},"force":{"name":"force","type":"boolean","char":"f","description":"Overwrite the destination directory and files if they already exist.","allowNo":false},"path":{"name":"path","type":"option","description":"The path to the directory of the Hydrogen storefront. The default is the current directory.","multiple":false}},"args":[]}}}

package/package.json

@@ -4,7 +4,7 @@
     "access": "public",
     "@shopify:registry": "https://registry.npmjs.org"
   },
-  "version": "5.0.0",
+  "version": "5.0.2",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -27,14 +27,14 @@
     "vitest": "^0.28.1"
   },
   "peerDependencies": {
-    "@remix-run/react": "^1.15.0",
-    "@shopify/hydrogen-react": "^2023.4.4",
-    "@shopify/remix-oxygen": "^1.1.0"
+    "@remix-run/react": "^1.17.1",
+    "@shopify/hydrogen-react": "^2023.4.5",
+    "@shopify/remix-oxygen": "^1.1.1"
   },
   "dependencies": {
     "@graphql-codegen/cli": "3.3.1",
     "@oclif/core": "2.1.4",
-    "@remix-run/dev": "1.15.0",
+    "@remix-run/dev": "1.17.1",
     "@shopify/cli-kit": "3.46.3",
     "@shopify/hydrogen-codegen": "^0.0.2",
     "@shopify/mini-oxygen": "^1.6.0",