@shopify/cli-hydrogen 11.1.8 → 11.1.10

package/dist/commands/hydrogen/setup.js

@@ -3,7 +3,7 @@ import { AbortController } from '@shopify/cli-kit/node/abort';
 import { renderTasks } from '@shopify/cli-kit/node/ui';
 import { resolvePath, basename, joinPath } from '@shopify/cli-kit/node/path';
 import { fileExists, glob, copyFile } from '@shopify/cli-kit/node/fs';
-import { overrideFlag, commonFlags, flagsToCamelObject } from '../../lib/flags.js';
+import { commonFlags, overrideFlag, flagsToCamelObject } from '../../lib/flags.js';
 import { renderI18nPrompt, setupI18nStrategy } from '../../lib/setups/i18n/index.js';
 import { getRemixConfig } from '../../lib/remix-config.js';
 import { handleRouteGeneration, generateProjectEntries, handleCliShortcut, renderProjectReady } from '../../lib/onboarding/common.js';
@@ -49,39 +49,37 @@ async function runSetup(options) {
     extraChoices: { none: "Set up later" }
   });
   const i18n = i18nStrategy === "none" ? void 0 : i18nStrategy;
-  const { needsRouteGeneration, setupRoutes } = await handleRouteGeneration(controller);
+  const { setupRoutes } = handleRouteGeneration(controller);
   let routes;
-  if (needsRouteGeneration) {
-    const templateRoot = await getTemplateAppFile("..");
-    const [typescript, dtsFiles] = await Promise.all([
-      fileExists(joinPath(rootDirectory, "tsconfig.json")),
-      glob("*.d.ts", { cwd: templateRoot })
-    ]);
-    backgroundWorkPromise = backgroundWorkPromise.then(
-      () => Promise.all([
-        ...dtsFiles.map(
-          (filename) => copyFile(
-            joinPath(templateRoot, filename),
-            resolvePath(rootDirectory, filename)
-          )
-        ),
-        // Copy app entries
-        generateProjectEntries({
-          rootDirectory,
-          appDirectory,
-          typescript
-        })
-      ])
-    ).then(async () => {
-      routes = await setupRoutes(rootDirectory, typescript ? "ts" : "js", {
-        i18nStrategy: i18n,
-        // User might have added files before running this command.
-        // We should overwrite them to ensure the routes are set up correctly.
-        // Relies on Git to restore the files if needed.
-        overwriteFileDeps: true
-      });
+  const templateRoot = await getTemplateAppFile("..");
+  const [typescript, dtsFiles] = await Promise.all([
+    fileExists(joinPath(rootDirectory, "tsconfig.json")),
+    glob("*.d.ts", { cwd: templateRoot })
+  ]);
+  backgroundWorkPromise = backgroundWorkPromise.then(
+    () => Promise.all([
+      ...dtsFiles.map(
+        (filename) => copyFile(
+          joinPath(templateRoot, filename),
+          resolvePath(rootDirectory, filename)
+        )
+      ),
+      // Copy app entries
+      generateProjectEntries({
+        rootDirectory,
+        appDirectory,
+        typescript
+      })
+    ])
+  ).then(async () => {
+    routes = await setupRoutes(rootDirectory, typescript ? "ts" : "js", {
+      i18nStrategy: i18n,
+      // User might have added files before running this command.
+      // We should overwrite them to ensure the routes are set up correctly.
+      // Relies on Git to restore the files if needed.
+      overwriteFileDeps: true
     });
-  }
+  });
   if (i18n) {
     backgroundWorkPromise = backgroundWorkPromise.then(
       () => setupI18nStrategy(i18n, { rootDirectory })
@@ -93,7 +91,7 @@ async function runSetup(options) {
     cliCommand,
     options.shortcut
   );
-  if (!i18n && !needsRouteGeneration && !createShortcut) return;
+  if (!i18n && !createShortcut) return;
   if (createShortcut) {
     backgroundWorkPromise = backgroundWorkPromise.then(async () => {
       if (await createShortcut()) {

package/dist/commands/hydrogen/upgrade.js

@@ -859,6 +859,13 @@ async function displayDevUpgradeNotice({
     const { currentVersion, currentDependencies } = await getHydrogenVersion({
       appPath
     });
+    if (currentVersion.startsWith("workspace:")) {
+      renderInfo({
+        headline: "Using monorepo @shopify/hydrogen dependency",
+        body: "This project uses the workspace protocol for @shopify/hydrogen, so upgrade notices are skipped during local monorepo development."
+      });
+      return;
+    }
     const isPrerelease = semver.prerelease(currentVersion);
     if (isPrerelease || /^[a-z]+$/i.test(currentVersion)) {
       return;

package/dist/lib/build.js

@@ -69,12 +69,11 @@ function getSkeletonNodeModules() {
   return joinPath(getSkeletonSourceDir(), "node_modules");
 }
 async function getRepoNodeModules() {
-  const { stdout } = await execAsync("npm root");
-  let nodeModulesPath = stdout.trim();
-  if (!nodeModulesPath && isHydrogenMonorepo) {
-    nodeModulesPath = joinPath(dirname(monorepoPackagesPath), "node_modules");
+  if (isHydrogenMonorepo) {
+    return getSkeletonNodeModules();
   }
-  return nodeModulesPath;
+  const { stdout } = await execAsync("npm root");
+  return stdout.trim();
 }
 
 export { ASSETS_DIR_PREFIX, ASSETS_STARTER_DIR, ASSETS_STARTER_DIR_ROUTES, getAssetsDir, getPkgJsonPath, getRepoNodeModules, getSkeletonNodeModules, getSkeletonSourceDir, getStarterDir, getTemplateAppFile, hydrogenPackagesPath, isHydrogenMonorepo };

package/dist/lib/codegen.js

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { getCodeFormatOptions, formatCode } from './format-code.js';
 import { renderInfo, renderWarning } from '@shopify/cli-kit/node/ui';
-import { relativePath, resolvePath, joinPath, basename } from '@shopify/cli-kit/node/path';
+import { relativePath, joinPath, resolvePath, basename } from '@shopify/cli-kit/node/path';
 import { AbortError } from '@shopify/cli-kit/node/error';
 import { importLocal } from './import-utils.js';
 
@@ -283,7 +283,7 @@ function findGqlProject(schemaFilepath, gqlConfig) {
   );
 }
 async function addHooksToHydrogenOptions(codegenConfig, { rootDirectory }) {
-  const name = Symbol.for("name");
+  const name = /* @__PURE__ */ Symbol.for("name");
   const hydrogenProjectsOptions = Object.values(codegenConfig.generates).filter(
     (value) => {
       const foundPreset = (Array.isArray(value) ? value[0] : value)?.preset;

package/dist/lib/format-code.js

@@ -1,5 +1,5 @@
 import { extname } from '@shopify/cli-kit/node/path';
-import * as prettier from 'prettier';
+import { resolveConfig, format } from 'prettier';
 import * as FS from 'fs/promises';
 import * as Path from 'path';
 
@@ -12,14 +12,14 @@ const DEFAULT_PRETTIER_CONFIG = {
 async function getCodeFormatOptions(filePath = process.cwd()) {
   const pathToUse = (await FS.lstat(filePath)).isFile() ? filePath : Path.resolve(filePath, "prettier.file");
   try {
-    return await prettier.resolveConfig(pathToUse) || DEFAULT_PRETTIER_CONFIG;
+    return await resolveConfig(pathToUse) || DEFAULT_PRETTIER_CONFIG;
   } catch {
     return DEFAULT_PRETTIER_CONFIG;
   }
 }
 async function formatCode(content, config = DEFAULT_PRETTIER_CONFIG, filePath = "") {
   const ext = extname(filePath);
-  return prettier.format(content, {
+  return format(content, {
     // Specify the TypeScript parser for ts/tsx files. Otherwise
     // we need to use the babel parser instead of the default parser,
     // because prettier will print a warning.

package/dist/lib/mini-oxygen/workerd.js

@@ -1,13 +1,13 @@
 import { createRequire } from 'node:module';
 import { resolvePath, dirname } from '@shopify/cli-kit/node/path';
-import { readFile, createFileReadStream } from '@shopify/cli-kit/node/fs';
+import { createFileReadStream, readFile } from '@shopify/cli-kit/node/fs';
 import { renderSuccess } from '@shopify/cli-kit/node/ui';
 import { outputNewline } from '@shopify/cli-kit/node/output';
 import { AbortError } from '@shopify/cli-kit/node/error';
 import colors from '@shopify/cli-kit/node/colors';
 import { handleMiniOxygenImportFail, SUBREQUEST_PROFILER_ENDPOINT, logRequestLine } from './common.js';
 import { TUNNEL_DOMAIN, getUtilityBannerlines, getDebugBannerLine } from '../dev-shared.js';
-import { setConstructors, handleDebugNetworkRequest, createLogRequestEvent, H2O_BINDING_NAME } from '../request-events.js';
+import { setConstructors, handleDebugNetworkRequest, H2O_BINDING_NAME, createLogRequestEvent } from '../request-events.js';
 import { importLocal } from '../import-utils.js';
 
 async function startWorkerdServer({
@@ -28,9 +28,7 @@ async function startWorkerdServer({
   setConstructors({ Response });
   async function handleCustomerAccountSchema() {
     const require2 = createRequire(import.meta.url);
-    const filePath = require2.resolve(
-      "@shopify/hydrogen/customer-account.schema.json"
-    );
+    const filePath = require2.resolve("@shopify/hydrogen/customer-account.schema.json");
     return new Response(createFileReadStream(filePath), {
       headers: { "Content-Type": "application/json" }
     });

package/dist/lib/onboarding/common.js

@@ -1,6 +1,6 @@
 import { symlink, readdir } from 'node:fs/promises';
 import { packageManagerFromUserAgent, installNodeModules } from '@shopify/cli-kit/node/node-package-manager';
-import { renderConfirmationPrompt, renderInfo, renderTextPrompt, renderSelectPrompt, renderWarning, renderSuccess, renderFatalError } from '@shopify/cli-kit/node/ui';
+import { renderConfirmationPrompt, renderInfo, renderTextPrompt, renderSelectPrompt, renderFatalError, renderWarning, renderSuccess } from '@shopify/cli-kit/node/ui';
 import { hyphenate, capitalize } from '@shopify/cli-kit/common/string';
 import { joinPath, resolvePath, basename } from '@shopify/cli-kit/node/path';
 import { initializeGitRepository, addAllToGitFromDirectory, createGitCommit } from '@shopify/cli-kit/node/git';
@@ -15,7 +15,7 @@ import { titleize } from '../string.js';
 import { ALIAS_NAME, createPlatformShortcut } from '../shell.js';
 import { transpileProject } from '../transpile/index.js';
 import { renderCssPrompt, setupCssStrategy, CSS_STRATEGY_NAME_MAP } from '../setups/css/index.js';
-import { renderRoutePrompt, generateRoutes, generateProjectFile } from '../setups/routes/generate.js';
+import { generateRoutes, generateProjectFile } from '../setups/routes/generate.js';
 import { execAsync } from '../process.js';
 import { getStorefronts } from '../graphql/admin/link-storefront.js';
 import { isHydrogenMonorepo, getSkeletonSourceDir, getRepoNodeModules } from '../build.js';
@@ -42,32 +42,25 @@ async function handleI18n(controller, cliCommand, flagI18n) {
     }
   };
 }
-async function handleRouteGeneration(controller, flagRoutes) {
-  const routesToScaffold = flagRoutes === true ? "all" : flagRoutes === false ? [] : await renderRoutePrompt({
-    abortSignal: controller.signal
-  });
-  const needsRouteGeneration = routesToScaffold === "all" || routesToScaffold.length > 0;
+function handleRouteGeneration(controller) {
   return {
-    needsRouteGeneration,
     setupRoutes: async (directory, language, options) => {
-      if (needsRouteGeneration) {
-        const result = await generateRoutes(
-          {
-            routeName: routesToScaffold,
-            directory,
-            force: true,
-            typescript: language === "ts",
-            localePrefix: options?.i18nStrategy === "subfolders" ? "locale" : false,
-            signal: controller.signal,
-            ...options
-          },
-          {
-            rootDirectory: directory,
-            appDirectory: joinPath(directory, "app")
-          }
-        );
-        return result.routeGroups;
-      }
+      const result = await generateRoutes(
+        {
+          routeName: "all",
+          directory,
+          force: true,
+          typescript: language === "ts",
+          localePrefix: options?.i18nStrategy === "subfolders" ? "locale" : false,
+          signal: controller.signal,
+          ...options
+        },
+        {
+          rootDirectory: directory,
+          appDirectory: joinPath(directory, "app")
+        }
+      );
+      return result.routeGroups;
     }
   };
 }

package/dist/lib/onboarding/local.js

@@ -2,8 +2,7 @@ import { cp } from 'node:fs/promises';
 import { writeFile } from '@shopify/cli-kit/node/fs';
 import { relativePath, joinPath } from '@shopify/cli-kit/node/path';
 import { hyphenate } from '@shopify/cli-kit/common/string';
-import colors from '@shopify/cli-kit/node/colors';
-import { renderSelectPrompt, renderSuccess, renderConfirmationPrompt, renderTasks } from '@shopify/cli-kit/node/ui';
+import { renderSelectPrompt, renderSuccess, renderTasks } from '@shopify/cli-kit/node/ui';
 import { handleStorefrontLink, handleProjectLocation, createAbortHandler, generateProjectEntries, handleLanguage, createInitialCommit, handleCssStrategy, commitAll, handleDependencies, handleCliShortcut, handleI18n, handleRouteGeneration, renderProjectReady } from './common.js';
 import { createStorefront } from '../graphql/admin/create-storefront.js';
 import { waitForJob } from '../graphql/admin/fetch-job.js';
@@ -49,7 +48,7 @@ async function setupLocalStarterTemplate(options, controller) {
     {
       force: true,
       recursive: true,
-      filter: (filepath) => !/^(app\/|dist\/|node_modules\/|server\.ts|\.shopify\/)/i.test(
+      filter: (filepath) => !/^(app(\/|$)|dist(\/|$)|node_modules(\/|$)|server\.ts$|\.shopify(\/|$))/i.test(
         relativePath(templateDir, filepath)
       )
     }
@@ -217,65 +216,53 @@ async function setupLocalStarterTemplate(options, controller) {
       ]
     });
   }
-  const continueWithSetup = (options.i18n ?? options.routes) !== void 0 || await renderConfirmationPrompt({
-    message: "Do you want to scaffold routes and core functionality?",
-    confirmationMessage: "Yes, set up now",
-    cancellationMessage: "No, set up later " + colors.dim(`(run \`${setupSummary.cliCommand} setup\`)`),
-    abortSignal: controller.signal
-  });
-  if (continueWithSetup) {
-    const { i18nStrategy, setupI18n } = await handleI18n(
-      controller,
-      setupSummary.cliCommand,
-      options.i18n
-    );
-    const { setupRoutes } = await handleRouteGeneration(
-      controller,
-      options.routes ?? true
-      // TODO: Remove default value when multi-select UI component is available
-    );
-    setupSummary.i18n = i18nStrategy;
-    backgroundWorkPromise = backgroundWorkPromise.then(async () => {
-      await setupI18n({
-        rootDirectory: project.directory,
-        contextCreate: language === "ts" ? "app/lib/context.ts" : "app/lib/context.js"
-      }).then(
-        () => options.git ? commitAll(
-          project.directory,
-          `Setup markets support using ${i18nStrategy}`
-        ) : void 0
-      ).catch((error) => {
-        setupSummary.i18nError = error;
-      });
-      await setupRoutes(project.directory, language, {
-        i18nStrategy,
-        // The init process might have added and modified files. Do not overwrite them.
-        // E.g. CSS imports might have been added to the root.
-        overwriteFileDeps: false
-      }).then(async (routes) => {
-        setupSummary.routes = routes;
-        if (language === "ts" && setupSummary.depsInstalled) {
-          try {
-            await execAsync("npx react-router typegen", {
-              cwd: project.directory
-            });
-          } catch (error) {
-            outputWarn(
-              "Failed to generate React Router types after route generation. You may need to run `npx react-router typegen` manually."
-            );
-          }
-        }
-        if (options.git && routes) {
-          return commitAll(
-            project.directory,
-            `Generate routes for core functionality`
+  const { i18nStrategy, setupI18n } = await handleI18n(
+    controller,
+    setupSummary.cliCommand,
+    options.i18n
+  );
+  const { setupRoutes } = handleRouteGeneration(controller);
+  setupSummary.i18n = i18nStrategy;
+  backgroundWorkPromise = backgroundWorkPromise.then(async () => {
+    await setupI18n({
+      rootDirectory: project.directory,
+      contextCreate: language === "ts" ? "app/lib/context.ts" : "app/lib/context.js"
+    }).then(
+      () => options.git ? commitAll(
+        project.directory,
+        `Setup markets support using ${i18nStrategy}`
+      ) : void 0
+    ).catch((error) => {
+      setupSummary.i18nError = error;
+    });
+    await setupRoutes(project.directory, language, {
+      i18nStrategy,
+      // The init process might have added and modified files. Do not overwrite them.
+      // E.g. CSS imports might have been added to the root.
+      overwriteFileDeps: false
+    }).then(async (routes) => {
+      setupSummary.routes = routes;
+      if (language === "ts" && setupSummary.depsInstalled) {
+        try {
+          await execAsync("npx react-router typegen", {
+            cwd: project.directory
+          });
+        } catch (error) {
+          outputWarn(
+            "Failed to generate React Router types after route generation. You may need to run `npx react-router typegen` manually."
           );
         }
-      }).catch((error) => {
-        setupSummary.routesError = error;
-      });
+      }
+      if (options.git && routes) {
+        return commitAll(
+          project.directory,
+          `Generate routes for core functionality`
+        );
+      }
+    }).catch((error) => {
+      setupSummary.routesError = error;
     });
-  }
+  });
   await renderTasks(tasks);
   if (options.git) {
     await commitAll(project.directory, "Lockfile");

package/dist/lib/template-pack.js

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+import { readFile, writeFile, mkdtemp, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+
+const DEPENDENCY_SECTIONS = [
+  "dependencies",
+  "devDependencies",
+  "peerDependencies",
+  "optionalDependencies"
+];
+function hasReplaceableProtocol(version) {
+  return version.startsWith("workspace:") || version.startsWith("catalog:");
+}
+async function getPackedTemplatePackageJson(sourceTemplateDir) {
+  const tempDir = await mkdtemp(join(tmpdir(), "hydrogen-template-pack-"));
+  try {
+    const rawPackResult = execFileSync(
+      "pnpm",
+      ["pack", "--pack-destination", tempDir, "--json"],
+      {
+        cwd: sourceTemplateDir,
+        encoding: "utf8"
+      }
+    );
+    const parsedResult = JSON.parse(rawPackResult.trim());
+    const packedTarball = Array.isArray(parsedResult) ? parsedResult[0]?.filename : parsedResult.filename;
+    if (!packedTarball) {
+      throw new Error("pnpm pack did not return a tarball filename.");
+    }
+    const packedManifestRaw = execFileSync(
+      "tar",
+      [
+        "-xOf",
+        packedTarball.startsWith("/") ? packedTarball : join(tempDir, packedTarball),
+        "package/package.json"
+      ],
+      { encoding: "utf8" }
+    );
+    return JSON.parse(packedManifestRaw);
+  } finally {
+    await rm(tempDir, { recursive: true, force: true });
+  }
+}
+function replaceWorkspaceProtocolVersionsInPackageJson({
+  packedManifest,
+  targetPackageJson
+}) {
+  for (const section of DEPENDENCY_SECTIONS) {
+    const targetDeps = targetPackageJson[section];
+    if (!targetDeps) continue;
+    for (const [name, version] of Object.entries(targetDeps)) {
+      if (!hasReplaceableProtocol(version)) continue;
+      const packedVersion = packedManifest[section]?.[name];
+      if (!packedVersion) {
+        throw new Error(
+          `Unable to resolve ${name} from ${section} in packed template manifest.`
+        );
+      }
+      targetDeps[name] = packedVersion;
+    }
+  }
+}
+async function replaceWorkspaceProtocolVersions({
+  sourceTemplateDir,
+  targetTemplateDir
+}) {
+  const packedManifest = await getPackedTemplatePackageJson(sourceTemplateDir);
+  const targetPackageJsonPath = join(targetTemplateDir, "package.json");
+  const targetPackageJson = JSON.parse(
+    await readFile(targetPackageJsonPath, "utf8")
+  );
+  replaceWorkspaceProtocolVersionsInPackageJson({
+    packedManifest,
+    targetPackageJson
+  });
+  await writeFile(
+    targetPackageJsonPath,
+    `${JSON.stringify(targetPackageJson, null, 2)}
+`
+  );
+}
+
+export { replaceWorkspaceProtocolVersions };

package/oclif.manifest.json

@@ -1048,13 +1048,6 @@
           "allowNo": true,
           "type": "boolean"
         },
-        "routes": {
-          "description": "Generate routes for all pages.",
-          "env": "SHOPIFY_HYDROGEN_FLAG_ROUTES",
-          "name": "routes",
-          "allowNo": true,
-          "type": "boolean"
-        },
         "git": {
           "description": "Init Git and create initial commits.",
           "env": "SHOPIFY_HYDROGEN_FLAG_GIT",
@@ -1063,7 +1056,7 @@
           "type": "boolean"
         },
         "quickstart": {
-          "description": "Scaffolds a new Hydrogen project with a set of sensible defaults. Equivalent to `shopify hydrogen init --path hydrogen-quickstart --mock-shop --language js --shortcut --routes --markets none`",
+          "description": "Scaffolds a new Hydrogen project with a set of sensible defaults. Equivalent to `shopify hydrogen init --path hydrogen-quickstart --mock-shop --language js --shortcut --markets none`",
           "env": "SHOPIFY_HYDROGEN_FLAG_QUICKSTART",
           "name": "quickstart",
           "allowNo": false,
@@ -1683,5 +1676,5 @@
       ]
     }
   },
-  "version": "11.1.8"
+  "version": "11.1.10"
 }

package/package.json

@@ -4,7 +4,7 @@
     "access": "public",
     "@shopify:registry": "https://registry.npmjs.org"
   },
-  "version": "11.1.8",
+  "version": "11.1.10",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -12,18 +12,12 @@
     "url": "git+https://github.com/Shopify/hydrogen.git",
     "directory": "packages/cli-hydrogen"
   },
-  "scripts": {
-    "build": "tsup && node scripts/build-check.mjs",
-    "dev": "tsup --watch ./src --watch ../../templates/skeleton",
-    "typecheck": "tsc --noEmit",
-    "generate:manifest": "node scripts/generate-manifest.mjs",
-    "test": "cross-env SHOPIFY_UNIT_TEST=1 LANG=en-US.UTF-8 vitest run --test-timeout=60000",
-    "test:watch": "cross-env SHOPIFY_UNIT_TEST=1 LANG=en-US.UTF-8 vitest --test-timeout=60000"
-  },
   "devDependencies": {
     "@react-router/dev": "7.12.0",
     "@types/diff": "^5.0.2",
     "@types/gunzip-maybe": "^1.4.0",
+    "@types/node": "^22",
+    "esbuild": "^0.25.0",
     "@types/prettier": "^2.7.2",
     "@types/source-map-support": "^0.5.10",
     "@types/tar-fs": "^2.0.1",
@@ -46,10 +40,11 @@
     "chokidar": "3.5.3",
     "cli-truncate": "^4.0.0",
     "diff": "^5.1.0",
+    "esbuild": "^0.25.12",
     "get-east-asian-width": "^1.3.0",
     "get-port": "^7.0.0",
     "gunzip-maybe": "^1.4.2",
-    "prettier": "^2.8.4",
+    "prettier": "^3.4.2",
     "semver": "^7.7.1",
     "source-map": "^0.7.4",
     "source-map-support": "^0.5.21",
@@ -61,10 +56,10 @@
   "peerDependencies": {
     "@graphql-codegen/cli": "^5.0.2",
     "@react-router/dev": "7.12.0",
-    "@shopify/hydrogen-codegen": "^0.3.3",
-    "@shopify/mini-oxygen": "^4.0.0",
     "graphql-config": "^5.0.3",
-    "vite": "^5.1.0 || ^6.2.0"
+    "vite": "^5.1.0 || ^6.2.0",
+    "@shopify/hydrogen-codegen": "0.3.3",
+    "@shopify/mini-oxygen": "4.0.1"
   },
   "peerDependenciesMeta": {
     "@graphql-codegen/cli": {
@@ -103,7 +98,7 @@
     "oclif.manifest.json"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": "^20 || ^22 || ^24"
   },
   "oclif": {
     "commands": "dist/commands",
@@ -130,5 +125,13 @@
     "plugins": [
       "@shopify/plugin-cloudflare"
     ]
+  },
+  "scripts": {
+    "build": "tsup && node scripts/build-check.mjs",
+    "dev": "tsup --watch ./src --watch ../../templates/skeleton",
+    "typecheck": "tsc --noEmit",
+    "generate:manifest": "node scripts/generate-manifest.mjs",
+    "test": "cross-env SHOPIFY_UNIT_TEST=1 LANG=en-US.UTF-8 vitest run --test-timeout=60000",
+    "test:watch": "cross-env SHOPIFY_UNIT_TEST=1 LANG=en-US.UTF-8 vitest --test-timeout=60000"
   }
-}
+}