feat: add option to install dependencies with a frozen lockfile

src/api.ts

@@ -4,7 +4,7 @@ import {
   getWorkspaceArgs,
   doesDependencyExist,
 } from "./_utils";
-import type { OperationOptions } from "./types";
+import type { OperationOptions, PackageManagerName } from "./types";
 
 /**
  * Installs project dependencies.
@@ -13,13 +13,27 @@ import type { OperationOptions } from "./types";
  * @param options.cwd - The directory to run the command in.
  * @param options.silent - Whether to run the command in silent mode.
  * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.frozenLockFile - Whether to install dependencies with frozen lock file.
  */
 export async function installDependencies(
-  options: Pick<OperationOptions, "cwd" | "silent" | "packageManager"> = {},
+  options: Pick<OperationOptions, "cwd" | "silent" | "packageManager"> & {
+    frozenLockFile?: boolean;
+  } = {},
 ) {
   const resolvedOptions = await resolveOperationOptions(options);
 
-  await executeCommand(resolvedOptions.packageManager.command, ["install"], {
+  const pmToInstallCommandMap: Record<PackageManagerName, string[]> = {
+    npm: ["ci"],
+    yarn: ["install", "--immutable"],
+    bun: ["install", "--frozen-lockfile"],
+    pnpm: ["install", "--frozen-lockfile"],
+  };
+
+  const commandArgs = options.frozenLockFile
+    ? pmToInstallCommandMap[resolvedOptions.packageManager.name]
+    : ["install"];
+
+  await executeCommand(resolvedOptions.packageManager.command, commandArgs, {
     cwd: resolvedOptions.cwd,
     silent: resolvedOptions.silent,
   });

test/api.test.ts

@@ -21,6 +21,18 @@ describe("api (workspace)", () => {
         expect(installDependenciesSpy).toHaveReturned();
       }, 60_000);
 
+      it("installs dependencies with lockfile", async () => {
+        const installDependenciesSpy = vi.fn(installDependencies);
+        const executeInstallDependenciesSpy = () =>
+          installDependenciesSpy({
+            cwd: fixture.dir,
+            silent: !process.env.DEBUG,
+            frozenLockFile: true,
+          });
+        await executeInstallDependenciesSpy();
+        expect(installDependenciesSpy).toHaveReturned();
+      }, 60_000);
+
       it("adds dependency", async () => {
         const addDependencySpy = vi.fn(addDependency);
         const executeAddDependencySpy = () =>