@shopify/cli-hydrogen 4.1.1 → 4.2.0

package/dist/lib/combined-environment-variables.test.js

@@ -0,0 +1,111 @@
+import { vi, describe, beforeEach, afterEach, test, expect } from 'vitest';
+import { inTemporaryDirectory, writeFile } from '@shopify/cli-kit/node/fs';
+import { joinPath } from '@shopify/cli-kit/node/path';
+import { mockAndCaptureOutput } from '@shopify/cli-kit/node/testing/output';
+import { combinedEnvironmentVariables } from './combined-environment-variables.js';
+import { pullRemoteEnvironmentVariables } from './pull-environment-variables.js';
+import { getConfig } from './shopify-config.js';
+
+vi.mock("./shopify-config.js");
+vi.mock("./pull-environment-variables.js");
+describe("combinedEnvironmentVariables()", () => {
+  beforeEach(() => {
+    vi.mocked(getConfig).mockResolvedValue({
+      storefront: {
+        id: "gid://shopify/HydrogenStorefront/1",
+        title: "Hydrogen"
+      }
+    });
+    vi.mocked(pullRemoteEnvironmentVariables).mockResolvedValue([
+      {
+        id: "gid://shopify/HydrogenStorefrontEnvironmentVariable/1",
+        key: "PUBLIC_API_TOKEN",
+        value: "abc123",
+        isSecret: false
+      }
+    ]);
+  });
+  afterEach(() => {
+    vi.resetAllMocks();
+    mockAndCaptureOutput().clear();
+  });
+  test("calls pullRemoteEnvironmentVariables", async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      await combinedEnvironmentVariables({
+        envBranch: "main",
+        root: tmpDir,
+        shop: "my-shop"
+      });
+      expect(pullRemoteEnvironmentVariables).toHaveBeenCalledWith({
+        envBranch: "main",
+        root: tmpDir,
+        flagShop: "my-shop",
+        silent: true
+      });
+    });
+  });
+  test("renders a message about injection", async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      const outputMock = mockAndCaptureOutput();
+      await combinedEnvironmentVariables({ root: tmpDir, shop: "my-shop" });
+      expect(outputMock.info()).toMatch(
+        /Injecting environment variables into MiniOxygen/
+      );
+    });
+  });
+  test("lists all of the variables being used", async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      const outputMock = mockAndCaptureOutput();
+      await combinedEnvironmentVariables({ root: tmpDir, shop: "my-shop" });
+      expect(outputMock.info()).toMatch(/Using PUBLIC_API_TOKEN from Hydrogen/);
+    });
+  });
+  describe("when one of the variables is a secret", () => {
+    beforeEach(() => {
+      vi.mocked(pullRemoteEnvironmentVariables).mockResolvedValue([
+        {
+          id: "gid://shopify/HydrogenStorefrontEnvironmentVariable/1",
+          key: "PUBLIC_API_TOKEN",
+          value: "",
+          isSecret: true
+        }
+      ]);
+    });
+    test("uses special messaging to alert the user", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        const outputMock = mockAndCaptureOutput();
+        await combinedEnvironmentVariables({ root: tmpDir, shop: "my-shop" });
+        expect(outputMock.info()).toMatch(
+          /Ignoring PUBLIC_API_TOKEN \(value is marked as secret\)/
+        );
+      });
+    });
+  });
+  describe("when there are local variables", () => {
+    test("includes local variables in the list", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        const filePath = joinPath(tmpDir, ".env");
+        await writeFile(filePath, "LOCAL_TOKEN=1");
+        const outputMock = mockAndCaptureOutput();
+        await combinedEnvironmentVariables({ root: tmpDir });
+        expect(outputMock.info()).toMatch(/Using LOCAL_TOKEN from \.env/);
+      });
+    });
+    describe("and they overwrite remote variables", () => {
+      test("uses special messaging to alert the user", async () => {
+        await inTemporaryDirectory(async (tmpDir) => {
+          const filePath = joinPath(tmpDir, ".env");
+          await writeFile(filePath, "PUBLIC_API_TOKEN=abc");
+          const outputMock = mockAndCaptureOutput();
+          await combinedEnvironmentVariables({ root: tmpDir, shop: "my-shop" });
+          expect(outputMock.info()).toMatch(
+            /Ignoring PUBLIC_API_TOKEN \(overwritten via \.env\)/
+          );
+          expect(outputMock.info()).toMatch(
+            /Using PUBLIC_API_TOKEN from \.env/
+          );
+        });
+      });
+    });
+  });
+});

package/dist/lib/flags.d.ts

@@ -4,6 +4,8 @@ declare const commonFlags: {
     path: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
     port: _oclif_core_lib_interfaces_parser_js.OptionFlag<number, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
     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>;
 };
 declare function flagsToCamelObject(obj: Record<string, any>): any;
 /**

package/dist/lib/flags.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { camelize } from '@shopify/cli-kit/common/string';
 import { renderInfo } from '@shopify/cli-kit/node/ui';
+import { normalizeStoreFqdn } from '@shopify/cli-kit/node/context/fqdn';
 import { colors } from './colors.js';
 
 const commonFlags = {
@@ -17,6 +18,18 @@ const commonFlags = {
     description: "Overwrite the destination directory and files if they already exist.",
     env: "SHOPIFY_HYDROGEN_FLAG_FORCE",
     char: "f"
+  }),
+  shop: Flags.string({
+    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).",
+    env: "SHOPIFY_SHOP",
+    parse: async (input) => normalizeStoreFqdn(input)
+  }),
+  ["env-branch"]: Flags.string({
+    description: "Specify an environment's branch name when using remote environment variables.",
+    env: "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
+    char: "e",
+    hidden: true
   })
 };
 function flagsToCamelObject(obj) {

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

@@ -0,0 +1,11 @@
+declare const LinkStorefrontQuery = "#graphql\n  query LinkStorefront {\n    hydrogenStorefronts {\n      id\n      title\n      productionUrl\n    }\n  }\n";
+interface HydrogenStorefront {
+    id: string;
+    title: string;
+    productionUrl: string;
+}
+interface LinkStorefrontSchema {
+    hydrogenStorefronts: HydrogenStorefront[];
+}
+
+export { LinkStorefrontQuery, LinkStorefrontSchema };

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

@@ -0,0 +1,11 @@
+const LinkStorefrontQuery = `#graphql
+  query LinkStorefront {
+    hydrogenStorefronts {
+      id
+      title
+      productionUrl
+    }
+  }
+`;
+
+export { LinkStorefrontQuery };

package/dist/lib/graphql/admin/list-environments.d.ts

@@ -0,0 +1,20 @@
+declare const ListEnvironmentsQuery = "#graphql\n  query ListStorefronts($id: ID!) {\n    hydrogenStorefront(id: $id) {\n      id\n      productionUrl\n      environments {\n        branch\n        createdAt\n        id\n        name\n        type\n        url\n      }\n    }\n  }\n";
+type EnvironmentType = 'PREVIEW' | 'PRODUCTION' | 'CUSTOM';
+interface Environment {
+    branch: string | null;
+    createdAt: string;
+    id: string;
+    name: string;
+    type: EnvironmentType;
+    url: string | null;
+}
+interface HydrogenStorefront {
+    id: string;
+    environments: Environment[];
+    productionUrl: string;
+}
+interface ListEnvironmentsSchema {
+    hydrogenStorefront: HydrogenStorefront | null;
+}
+
+export { Environment, EnvironmentType, ListEnvironmentsQuery, ListEnvironmentsSchema };

package/dist/lib/graphql/admin/list-environments.js

@@ -0,0 +1,18 @@
+const ListEnvironmentsQuery = `#graphql
+  query ListStorefronts($id: ID!) {
+    hydrogenStorefront(id: $id) {
+      id
+      productionUrl
+      environments {
+        branch
+        createdAt
+        id
+        name
+        type
+        url
+      }
+    }
+  }
+`;
+
+export { ListEnvironmentsQuery };

package/dist/lib/graphql/admin/list-storefronts.d.ts

@@ -0,0 +1,17 @@
+declare const ListStorefrontsQuery = "#graphql\n  query ListStorefronts {\n    hydrogenStorefronts {\n      id\n      title\n      productionUrl\n      currentProductionDeployment {\n        id\n        createdAt\n        commitMessage\n      }\n    }\n  }\n";
+interface Deployment {
+    id: string;
+    createdAt: string;
+    commitMessage: string | null;
+}
+interface HydrogenStorefront {
+    id: string;
+    title: string;
+    productionUrl?: string;
+    currentProductionDeployment: Deployment | null;
+}
+interface ListStorefrontsSchema {
+    hydrogenStorefronts: HydrogenStorefront[];
+}
+
+export { Deployment, ListStorefrontsQuery, ListStorefrontsSchema };

package/dist/lib/graphql/admin/list-storefronts.js

@@ -0,0 +1,16 @@
+const ListStorefrontsQuery = `#graphql
+  query ListStorefronts {
+    hydrogenStorefronts {
+      id
+      title
+      productionUrl
+      currentProductionDeployment {
+        id
+        createdAt
+        commitMessage
+      }
+    }
+  }
+`;
+
+export { ListStorefrontsQuery };

package/dist/lib/graphql/admin/pull-variables.d.ts

@@ -0,0 +1,16 @@
+declare const PullVariablesQuery = "#graphql\n  query PullVariables($id: ID!, $branch: String) {\n    hydrogenStorefront(id: $id) {\n      id\n      environmentVariables(branchName: $branch) {\n        id\n        isSecret\n        key\n        value\n      }\n    }\n  }\n";
+interface EnvironmentVariable {
+    id: string;
+    isSecret: boolean;
+    key: string;
+    value: string;
+}
+interface HydrogenStorefront {
+    id: string;
+    environmentVariables: EnvironmentVariable[];
+}
+interface PullVariablesSchema {
+    hydrogenStorefront: HydrogenStorefront | null;
+}
+
+export { EnvironmentVariable, PullVariablesQuery, PullVariablesSchema };

package/dist/lib/graphql/admin/pull-variables.js

@@ -0,0 +1,15 @@
+const PullVariablesQuery = `#graphql
+  query PullVariables($id: ID!, $branch: String) {
+    hydrogenStorefront(id: $id) {
+      id
+      environmentVariables(branchName: $branch) {
+        id
+        isSecret
+        key
+        value
+      }
+    }
+  }
+`;
+
+export { PullVariablesQuery };

package/dist/lib/graphql.d.ts

@@ -0,0 +1,21 @@
+import { GraphQLVariables } from '@shopify/cli-kit/node/api/graphql';
+import { AdminSession } from '@shopify/cli-kit/node/session';
+
+/**
+ * This is a temporary workaround until cli-kit includes a way to specify
+ * API versions for the Admin API because we need to target the unstable
+ * branch for this early access phase.
+ *
+ * @param query - GraphQL query to execute.
+ * @param session - Shopify admin session including token and Store FQDN.
+ * @param variables - GraphQL variables to pass to the query.
+ * @returns The response of the query of generic type <T>.
+ */
+declare function adminRequest<T>(query: string, session: AdminSession, variables?: GraphQLVariables): Promise<T>;
+/**
+ * @param gid a Global ID to parse (e.g. 'gid://shopify/HydrogenStorefront/1')
+ * @returns the ID of the record (e.g. '1')
+ */
+declare function parseGid(gid: string): string;
+
+export { adminRequest, parseGid };

package/dist/lib/graphql.js

@@ -0,0 +1,18 @@
+import { graphqlRequest } from '@shopify/cli-kit/node/api/graphql';
+import { AbortError } from '@shopify/cli-kit/node/error';
+
+async function adminRequest(query, session, variables) {
+  const api = "Admin";
+  const url = `https://${session.storeFqdn}/admin/api/unstable/graphql.json`;
+  return graphqlRequest({ query, api, url, token: session.token, variables });
+}
+const GID_REGEXP = /gid:\/\/shopify\/\w*\/(\d+)/;
+function parseGid(gid) {
+  const matches = GID_REGEXP.exec(gid);
+  if (matches && matches[1] !== void 0) {
+    return matches[1];
+  }
+  throw new AbortError(`Invalid Global ID: ${gid}`);
+}
+
+export { adminRequest, parseGid };

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

@@ -0,0 +1 @@
+

package/dist/lib/graphql.test.js

@@ -0,0 +1,15 @@
+import { describe, it, expect } from 'vitest';
+import { AbortError } from '@shopify/cli-kit/node/error';
+import { parseGid } from './graphql.js';
+
+describe("parseGid", () => {
+  it("returns an ID", () => {
+    const id = parseGid("gid://shopify/HydrogenStorefront/324");
+    expect(id).toStrictEqual("324");
+  });
+  describe("when the global ID is invalid", () => {
+    it("throws an error", () => {
+      expect(() => parseGid("321asd")).toThrow(AbortError);
+    });
+  });
+});

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

@@ -4,8 +4,11 @@ type MiniOxygenOptions = {
     watch?: boolean;
     buildPathClient: string;
     buildPathWorkerFile: string;
+    environmentVariables?: {
+        [key: string]: string;
+    };
 };
-declare function startMiniOxygen({ root, port, watch, buildPathWorkerFile, buildPathClient, }: MiniOxygenOptions): Promise<void>;
+declare function startMiniOxygen({ root, port, watch, buildPathWorkerFile, buildPathClient, environmentVariables, }: MiniOxygenOptions): Promise<void>;
 declare function logResponse(request: Request, response: Response): void;
 
 export { logResponse, startMiniOxygen };

package/dist/lib/mini-oxygen.js

@@ -8,7 +8,8 @@ async function startMiniOxygen({
   port = 3e3,
   watch = false,
   buildPathWorkerFile,
-  buildPathClient
+  buildPathClient,
+  environmentVariables = {}
 }) {
   const { default: miniOxygen } = await import('@shopify/mini-oxygen');
   const miniOxygenPreview = miniOxygen.default ?? miniOxygen;
@@ -21,8 +22,11 @@ async function startMiniOxygen({
     watch,
     autoReload: watch,
     modules: true,
-    env: process.env,
-    envPath: await fileExists(dotenvPath) ? dotenvPath : void 0,
+    env: {
+      ...environmentVariables,
+      ...process.env
+    },
+    envPath: !Object.keys(environmentVariables).length && await fileExists(dotenvPath) ? dotenvPath : void 0,
     log: () => {
     },
     buildWatchPaths: watch ? [resolvePath(root, buildPathWorkerFile)] : void 0,

package/dist/lib/missing-storefronts.d.ts

@@ -0,0 +1,5 @@
+import { AdminSession } from '@shopify/cli-kit/node/session';
+
+declare function logMissingStorefronts(adminSession: AdminSession): void;
+
+export { logMissingStorefronts };

package/dist/lib/missing-storefronts.js

@@ -0,0 +1,18 @@
+import { renderInfo } from '@shopify/cli-kit/node/ui';
+import { newHydrogenStorefrontUrl } from './admin-urls.js';
+
+function logMissingStorefronts(adminSession) {
+  renderInfo({
+    headline: "Hydrogen storefronts",
+    body: "There are no Hydrogen storefronts on your Shop.",
+    nextSteps: [
+      `Ensure you have specified the correct shop (you specified: ${adminSession.storeFqdn})`,
+      `Ensure you have the Hydrogen sales channel installed https://apps.shopify.com/hydrogen`,
+      `Create a new Hydrogen storefront: ${newHydrogenStorefrontUrl(
+        adminSession
+      )}`
+    ]
+  });
+}
+
+export { logMissingStorefronts };

package/dist/lib/pull-environment-variables.d.ts

@@ -0,0 +1,19 @@
+import { EnvironmentVariable } from './graphql/admin/pull-variables.js';
+
+interface Arguments {
+    envBranch?: string;
+    root: string;
+    /**
+     * Optional shop override that developers would have passed using the --shop
+     * flag.
+     */
+    flagShop?: string;
+    /**
+     * Does not prompt the user to fix any errors that are encountered (e.g. no
+     * linked storefront)
+     */
+    silent?: boolean;
+}
+declare function pullRemoteEnvironmentVariables({ envBranch, root, flagShop, silent, }: Arguments): Promise<EnvironmentVariable[]>;
+
+export { pullRemoteEnvironmentVariables };

package/dist/lib/pull-environment-variables.js

@@ -0,0 +1,67 @@
+import { renderConfirmationPrompt } from '@shopify/cli-kit/node/ui';
+import { outputContent, outputToken, outputInfo } from '@shopify/cli-kit/node/output';
+import { linkStorefront } from '../commands/hydrogen/link.js';
+import { adminRequest } from './graphql.js';
+import { getHydrogenShop } from './shop.js';
+import { getAdminSession } from './admin-session.js';
+import { getConfig } from './shopify-config.js';
+import { renderMissingLink, renderMissingStorefront } from './render-errors.js';
+import { PullVariablesQuery } from './graphql/admin/pull-variables.js';
+
+async function pullRemoteEnvironmentVariables({
+  envBranch,
+  root,
+  flagShop,
+  silent
+}) {
+  const shop = await getHydrogenShop({ path: root, shop: flagShop });
+  const adminSession = await getAdminSession(shop);
+  let configStorefront = (await getConfig(root)).storefront;
+  if (!configStorefront?.id) {
+    if (!silent) {
+      renderMissingLink({ adminSession });
+      const runLink = await renderConfirmationPrompt({
+        message: outputContent`Run ${outputToken.genericShellCommand(
+          `npx shopify hydrogen link`
+        )}?`.value
+      });
+      if (!runLink) {
+        return [];
+      }
+      await linkStorefront({ path: root, shop: flagShop, silent });
+    }
+  }
+  configStorefront = (await getConfig(root)).storefront;
+  if (!configStorefront) {
+    return [];
+  }
+  if (!silent) {
+    outputInfo(
+      `Fetching environment variables from ${configStorefront.title}...`
+    );
+  }
+  const result = await adminRequest(
+    PullVariablesQuery,
+    adminSession,
+    {
+      id: configStorefront.id,
+      branch: envBranch
+    }
+  );
+  const storefront = result.hydrogenStorefront;
+  if (!storefront) {
+    if (!silent) {
+      renderMissingStorefront({ adminSession, storefront: configStorefront });
+    }
+    return [];
+  }
+  if (!storefront.environmentVariables.length) {
+    if (!silent) {
+      outputInfo(`No environment variables found.`);
+    }
+    return [];
+  }
+  return storefront.environmentVariables;
+}
+
+export { pullRemoteEnvironmentVariables };

package/dist/lib/pull-environment-variables.test.d.ts

@@ -0,0 +1 @@
+

package/dist/lib/pull-environment-variables.test.js

@@ -0,0 +1,174 @@
+import { vi, describe, beforeEach, afterEach, it, expect } from 'vitest';
+import { mockAndCaptureOutput } from '@shopify/cli-kit/node/testing/output';
+import { inTemporaryDirectory } from '@shopify/cli-kit/node/fs';
+import { renderConfirmationPrompt } from '@shopify/cli-kit/node/ui';
+import { PullVariablesQuery } from './graphql/admin/pull-variables.js';
+import { getAdminSession } from './admin-session.js';
+import { adminRequest } from './graphql.js';
+import { getConfig } from './shopify-config.js';
+import { renderMissingLink, renderMissingStorefront } from './render-errors.js';
+import { linkStorefront } from '../commands/hydrogen/link.js';
+import { pullRemoteEnvironmentVariables } from './pull-environment-variables.js';
+
+vi.mock("@shopify/cli-kit/node/ui", async () => {
+  const original = await vi.importActual("@shopify/cli-kit/node/ui");
+  return {
+    ...original,
+    renderConfirmationPrompt: vi.fn()
+  };
+});
+vi.mock("../commands/hydrogen/link.js");
+vi.mock("./admin-session.js");
+vi.mock("./shopify-config.js");
+vi.mock("./render-errors.js");
+vi.mock("./graphql.js", async () => {
+  const original = await vi.importActual(
+    "./graphql.js"
+  );
+  return {
+    ...original,
+    adminRequest: vi.fn()
+  };
+});
+vi.mock("./shop.js", () => ({
+  getHydrogenShop: () => "my-shop"
+}));
+describe("pullRemoteEnvironmentVariables", () => {
+  const ENVIRONMENT_VARIABLES_RESPONSE = [
+    {
+      id: "gid://shopify/HydrogenStorefrontEnvironmentVariable/1",
+      key: "PUBLIC_API_TOKEN",
+      value: "abc123",
+      isSecret: false
+    }
+  ];
+  const ADMIN_SESSION = {
+    token: "abc123",
+    storeFqdn: "my-shop"
+  };
+  beforeEach(async () => {
+    vi.mocked(getAdminSession).mockResolvedValue(ADMIN_SESSION);
+    vi.mocked(getConfig).mockResolvedValue({
+      storefront: {
+        id: "gid://shopify/HydrogenStorefront/2",
+        title: "Existing Link"
+      }
+    });
+    vi.mocked(adminRequest).mockResolvedValue({
+      hydrogenStorefront: {
+        id: "gid://shopify/HydrogenStorefront/1",
+        environmentVariables: ENVIRONMENT_VARIABLES_RESPONSE
+      }
+    });
+  });
+  afterEach(() => {
+    vi.resetAllMocks();
+    mockAndCaptureOutput().clear();
+  });
+  it("makes a GraphQL call to fetch environment variables", async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      await pullRemoteEnvironmentVariables({
+        root: tmpDir,
+        envBranch: "staging"
+      });
+      expect(adminRequest).toHaveBeenCalledWith(
+        PullVariablesQuery,
+        ADMIN_SESSION,
+        {
+          id: "gid://shopify/HydrogenStorefront/2",
+          branch: "staging"
+        }
+      );
+    });
+  });
+  it("returns environment variables", async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      const environmentVariables = await pullRemoteEnvironmentVariables({
+        root: tmpDir
+      });
+      expect(environmentVariables).toBe(ENVIRONMENT_VARIABLES_RESPONSE);
+    });
+  });
+  describe("when environment variables are empty", () => {
+    beforeEach(() => {
+      vi.mocked(adminRequest).mockResolvedValue({
+        hydrogenStorefront: {
+          id: "gid://shopify/HydrogenStorefront/1",
+          environmentVariables: []
+        }
+      });
+    });
+    it("renders a message", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        const outputMock = mockAndCaptureOutput();
+        await pullRemoteEnvironmentVariables({ root: tmpDir });
+        expect(outputMock.info()).toMatch(/No environment variables found\./);
+      });
+    });
+    it("returns an empty array", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        const environmentVariables = await pullRemoteEnvironmentVariables({
+          root: tmpDir
+        });
+        expect(environmentVariables).toStrictEqual([]);
+      });
+    });
+  });
+  describe("when there is no linked storefront", () => {
+    beforeEach(() => {
+      vi.mocked(getConfig).mockResolvedValue({
+        storefront: void 0
+      });
+    });
+    it("calls renderMissingLink", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        await pullRemoteEnvironmentVariables({ root: tmpDir });
+        expect(renderMissingLink).toHaveBeenCalledOnce();
+      });
+    });
+    it("prompts the user to create a link", async () => {
+      vi.mocked(renderConfirmationPrompt).mockResolvedValue(true);
+      await inTemporaryDirectory(async (tmpDir) => {
+        await pullRemoteEnvironmentVariables({ root: tmpDir });
+        expect(renderConfirmationPrompt).toHaveBeenCalledWith({
+          message: expect.stringMatching(/Run .*npx shopify hydrogen link.*\?/)
+        });
+        expect(linkStorefront).toHaveBeenCalledWith({
+          path: tmpDir
+        });
+      });
+    });
+    describe("and the user does not create a new link", () => {
+      it("returns an empty array", async () => {
+        vi.mocked(renderConfirmationPrompt).mockResolvedValue(false);
+        await inTemporaryDirectory(async (tmpDir) => {
+          const environmentVariables = await pullRemoteEnvironmentVariables({
+            root: tmpDir
+          });
+          expect(environmentVariables).toStrictEqual([]);
+        });
+      });
+    });
+  });
+  describe("when there is no matching storefront in the shop", () => {
+    beforeEach(() => {
+      vi.mocked(adminRequest).mockResolvedValue({
+        hydrogenStorefront: null
+      });
+    });
+    it("calls renderMissingStorefront", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        await pullRemoteEnvironmentVariables({ root: tmpDir });
+        expect(renderMissingStorefront).toHaveBeenCalledOnce();
+      });
+    });
+    it("returns an empty array", async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        const environmentVariables = await pullRemoteEnvironmentVariables({
+          root: tmpDir
+        });
+        expect(environmentVariables).toStrictEqual([]);
+      });
+    });
+  });
+});