feat(package-managers): add bun support

.circleci/config.yml

@@ -21,7 +21,7 @@ jobs:
   build:
     working_directory: ~/nest
     docker:
-      - image: cimg/node:24.14.1
+      - image: cimg/node:24.15.0
     steps:
       - checkout
       - restore_cache:
@@ -40,7 +40,7 @@ jobs:
   unit_tests:
     working_directory: ~/nest
     docker:
-      - image: cimg/node:24.14.1
+      - image: cimg/node:24.15.0
     steps:
       - checkout
       - *restore-cache

actions/new.action.ts

@@ -134,7 +134,12 @@ const installPackages = async (
 const askForPackageManager = async () => {
   const question = generateSelect('packageManager')(
     MESSAGES.PACKAGE_MANAGER_QUESTION,
-  )([PackageManager.NPM, PackageManager.YARN, PackageManager.PNPM]);
+  )([
+    PackageManager.NPM,
+    PackageManager.YARN,
+    PackageManager.PNPM,
+    PackageManager.BUN,
+  ]);
 
   return select(question).catch(gracefullyExitOnPromptError);
 };

lib/package-managers/bun.package-manager.ts

@@ -0,0 +1,27 @@
+import { Runner, RunnerFactory } from '../runners/index.js';
+import { BunRunner } from '../runners/bun.runner.js';
+import { AbstractPackageManager } from './abstract.package-manager.js';
+import { PackageManager } from './package-manager.js';
+import { PackageManagerCommands } from './package-manager-commands.js';
+
+export class BunPackageManager extends AbstractPackageManager {
+  constructor() {
+    super(RunnerFactory.create(Runner.BUN) as BunRunner);
+  }
+
+  public get name() {
+    return PackageManager.BUN.toUpperCase();
+  }
+
+  get cli(): PackageManagerCommands {
+    return {
+      install: 'install',
+      add: 'add',
+      update: 'update',
+      remove: 'remove',
+      saveFlag: '--save',
+      saveDevFlag: '--dev',
+      silentFlag: '--silent',
+    };
+  }
+}

lib/package-managers/index.ts

@@ -4,5 +4,6 @@ export * from './abstract.package-manager.js';
 export * from './npm.package-manager.js';
 export * from './yarn.package-manager.js';
 export * from './pnpm.package-manager.js';
+export * from './bun.package-manager.js';
 export * from './project.dependency.js';
 export * from './package-manager-commands.js';

lib/package-managers/package-manager.factory.ts

@@ -4,6 +4,7 @@ import { NpmPackageManager } from './npm.package-manager.js';
 import { PackageManager } from './package-manager.js';
 import { YarnPackageManager } from './yarn.package-manager.js';
 import { PnpmPackageManager } from './pnpm.package-manager.js';
+import { BunPackageManager } from './bun.package-manager.js';
 
 export class PackageManagerFactory {
   public static create(name: PackageManager | string): AbstractPackageManager {
@@ -14,6 +15,8 @@ export class PackageManagerFactory {
         return new YarnPackageManager();
       case PackageManager.PNPM:
         return new PnpmPackageManager();
+      case PackageManager.BUN:
+        return new BunPackageManager();
       default:
         throw new Error(`Package manager ${name} is not managed.`);
     }
@@ -35,6 +38,13 @@ export class PackageManagerFactory {
         return this.create(PackageManager.PNPM);
       }
 
+      const hasBunLockFile = ['bun.lock', 'bun.lockb'].some((lockFile) =>
+        files.includes(lockFile),
+      );
+      if (hasBunLockFile) {
+        return this.create(PackageManager.BUN);
+      }
+
       return this.create(DEFAULT_PACKAGE_MANAGER);
     } catch {
       return this.create(DEFAULT_PACKAGE_MANAGER);

lib/package-managers/package-manager.ts

@@ -2,4 +2,5 @@ export enum PackageManager {
   NPM = 'npm',
   YARN = 'yarn',
   PNPM = 'pnpm',
+  BUN = 'bun',
 }

lib/runners/bun.runner.ts

@@ -0,0 +1,7 @@
+import { AbstractRunner } from './abstract.runner.js';
+
+export class BunRunner extends AbstractRunner {
+  constructor() {
+    super('bun');
+  }
+}

lib/runners/runner.factory.ts

@@ -1,8 +1,10 @@
+import { yellow } from 'ansis';
 import { NpmRunner } from './npm.runner.js';
 import { PnpmRunner } from './pnpm.runner.js';
 import { Runner } from './runner.js';
 import { SchematicRunner } from './schematic.runner.js';
 import { YarnRunner } from './yarn.runner.js';
+import { BunRunner } from './bun.runner.js';
 
 export class RunnerFactory {
   public static create(runner: Runner) {
@@ -19,6 +21,9 @@ export class RunnerFactory {
       case Runner.PNPM:
         return new PnpmRunner();
 
+      case Runner.BUN:
+        return new BunRunner();
+
       default:
         throw new Error(`Unsupported runner: ${runner}`);
     }

lib/runners/runner.ts

@@ -3,4 +3,5 @@ export enum Runner {
   NPM,
   YARN,
   PNPM,
+  BUN,
 }

test/lib/package-managers/bun.package-manager.spec.ts

@@ -0,0 +1,126 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { join } from 'path';
+import {
+  BunPackageManager,
+  PackageManagerCommands,
+} from '../../../lib/package-managers';
+import { BunRunner } from '../../../lib/runners/bun.runner';
+
+vi.mock('../../../lib/runners/bun.runner.js');
+
+describe('BunPackageManager', () => {
+  let packageManager: BunPackageManager;
+  beforeEach(() => {
+    (BunRunner as any).mockClear();
+    (BunRunner as any).mockImplementation(function () {
+      return {
+        run: (): Promise<void> => Promise.resolve(),
+      };
+    });
+    packageManager = new BunPackageManager();
+  });
+  it('should be created', () => {
+    expect(packageManager).toBeInstanceOf(BunPackageManager);
+  });
+  it('should have the correct cli commands', () => {
+    const expectedValues: PackageManagerCommands = {
+      install: 'install',
+      add: 'add',
+      update: 'update',
+      remove: 'remove',
+      saveFlag: '--save',
+      saveDevFlag: '--dev',
+      silentFlag: '--silent',
+    };
+    expect(packageManager.cli).toMatchObject(expectedValues);
+  });
+  describe('install', () => {
+    it('should use the proper command for installing', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dirName = '/tmp';
+      const testDir = join(process.cwd(), dirName);
+      packageManager.install(dirName, 'npm');
+      expect(spy).toBeCalledWith('install --silent', true, testDir);
+    });
+  });
+  describe('addProduction', () => {
+    it('should use the proper command for adding production dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const tag = '5.0.0';
+      const command = `add --save ${dependencies
+        .map((dependency) => `${dependency}@${tag}`)
+        .join(' ')}`;
+      packageManager.addProduction(dependencies, tag);
+      expect(spy).toBeCalledWith(command, true);
+    });
+  });
+  describe('addDevelopment', () => {
+    it('should use the proper command for adding development dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const tag = '5.0.0';
+      const command = `add --dev ${dependencies
+        .map((dependency) => `${dependency}@${tag}`)
+        .join(' ')}`;
+      packageManager.addDevelopment(dependencies, tag);
+      expect(spy).toBeCalledWith(command, true);
+    });
+  });
+  describe('updateProduction', () => {
+    it('should use the proper command for updating production dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const command = `update ${dependencies.join(' ')}`;
+      packageManager.updateProduction(dependencies);
+      expect(spy).toBeCalledWith(command, true);
+    });
+  });
+  describe('updateDevelopment', () => {
+    it('should use the proper command for updating development dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const command = `update ${dependencies.join(' ')}`;
+      packageManager.updateDevelopment(dependencies);
+      expect(spy).toBeCalledWith(command, true);
+    });
+  });
+  describe('upgradeProduction', () => {
+    it('should use the proper command for upgrading production dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const tag = '5.0.0';
+      const uninstallCommand = `remove --save ${dependencies.join(' ')}`;
+
+      const installCommand = `add --save ${dependencies
+        .map((dependency) => `${dependency}@${tag}`)
+        .join(' ')}`;
+
+      return packageManager.upgradeProduction(dependencies, tag).then(() => {
+        expect(spy.mock.calls).toEqual([
+          [uninstallCommand, true],
+          [installCommand, true],
+        ]);
+      });
+    });
+  });
+  describe('upgradeDevelopment', () => {
+    it('should use the proper command for upgrading development dependencies', () => {
+      const spy = vi.spyOn((packageManager as any).runner, 'run');
+      const dependencies = ['@nestjs/common', '@nestjs/core'];
+      const tag = '5.0.0';
+      const uninstallCommand = `remove --dev ${dependencies.join(' ')}`;
+
+      const installCommand = `add --dev ${dependencies
+        .map((dependency) => `${dependency}@${tag}`)
+        .join(' ')}`;
+
+      return packageManager.upgradeDevelopment(dependencies, tag).then(() => {
+        expect(spy.mock.calls).toEqual([
+          [uninstallCommand, true],
+          [installCommand, true],
+        ]);
+      });
+    });
+  });
+});

test/lib/package-managers/package-manager.factory.spec.ts

@@ -1,6 +1,7 @@
 import { describe, it, expect, vi, afterAll, Mock } from 'vitest';
 import * as fs from 'fs';
 import {
+  BunPackageManager,
   NpmPackageManager,
   PackageManagerFactory,
   PnpmPackageManager,
@@ -46,11 +47,27 @@ describe('PackageManagerFactory', () => {
       );
     });
 
+    it('should return BunPackageManager when "bun.lock" file is found', async () => {
+      (fs.promises.readdir as jest.Mock).mockResolvedValue(['bun.lock']);
+
+      const manager = await PackageManagerFactory.find();
+      expect(manager).toBeInstanceOf(BunPackageManager);
+    });
+
+    it('should return BunPackageManager when "bun.lockb" file is found', async () => {
+      (fs.promises.readdir as jest.Mock).mockResolvedValue(['bun.lockb']);
+
+      const manager = await PackageManagerFactory.find();
+      expect(manager).toBeInstanceOf(BunPackageManager);
+    });
+
     describe('when there are all supported lock files', () => {
       it('should prioritize "yarn.lock" file over all the others lock files', async () => {
         (fs.promises.readdir as Mock).mockResolvedValue([
           'pnpm-lock.yaml',
           'package-lock.json',
+          'bun.lock',
+          'bun.lockb',
           // This is intentionally the last element in this array
           'yarn.lock',
         ]);