fix(cli-utils): Create directories in CLI when writing to non-existent paths

.changeset/rotten-balloons-bow.md

@@ -0,0 +1,5 @@
+---
+'@gql.tada/cli-utils': patch
+---
+
+Create target directories if they don't exist and the CLI is trying to write to them.

packages/cli-utils/src/commands/shared/utils.ts

@@ -1,9 +1,26 @@
 import type { WriteStream } from 'node:tty';
 import type { PathLike } from 'node:fs';
+import { dirname } from 'node:path';
 import * as fs from 'node:fs/promises';
 
+/** Checks whether a directory exists on disk */
+const directoryExists = async (file: PathLike): Promise<boolean> => {
+  try {
+    const stat = await fs.stat(file);
+    if (stat.isDirectory()) {
+      return true;
+    } else if (stat.isSymbolicLink()) {
+      return directoryExists(await fs.realpath(file));
+    } else {
+      return false;
+    }
+  } catch {
+    return false;
+  }
+};
+
 /** Checks whether a file exists on disk */
-export const fileExists = (file: PathLike): Promise<boolean> =>
+const fileExists = (file: PathLike): Promise<boolean> =>
   fs
     .stat(file)
     .then((stat) => stat.isFile())
@@ -32,7 +49,14 @@ export const writeOutput = async (target: WriteTarget, contents: string): Promis
         }
       });
     });
-  } else if (!(await fileExists(target))) {
+  }
+
+  const targetDirectory = dirname(typeof target !== 'string' ? await fs.realpath(target) : target);
+  if (!(await directoryExists(targetDirectory))) {
+    await fs.mkdir(targetDirectory, { recursive: true });
+  }
+
+  if (!(await fileExists(target))) {
     // If the file doesn't exist, we can write directly, and not
     // try-catch so the error falls through
     await fs.writeFile(target, contents);