Add nub to recognised package managers

.changeset/nub-package-manager.md

@@ -0,0 +1,10 @@
+---
+"@cloudflare/workers-utils": patch
+"@cloudflare/autoconfig": patch
+"@cloudflare/cli-shared-helpers": patch
+"wrangler": patch
+---
+
+Recognise nub as a package manager
+
+wrangler now detects nub — from its `npm_config_user_agent` and an installed `nub` binary — and autoconfig detects nub projects by their `nub.lock`, alongside npm, pnpm, yarn, and bun. Package installation helpers use `nub`/`nubx` accordingly.

packages/autoconfig/src/details/framework-detection.ts

@@ -4,6 +4,7 @@ import {
 	BunPackageManager,
 	FatalError,
 	NpmPackageManager,
+	NubPackageManager,
 	PnpmPackageManager,
 	UserError,
 	YarnPackageManager,
@@ -82,7 +83,10 @@ export async function detectFramework(
 
 	// Convert the package manager detected by @netlify/build-info to our PackageManager type.
 	// This is populated after getBuildSettings() runs, which triggers the full detection chain.
-	const packageManager = convertDetectedPackageManager(project.packageManager);
+	// @netlify/build-info doesn't recognise nub, so prefer its nub.lock when present.
+	const packageManager = existsSync(join(projectPath, "nub.lock"))
+		? NubPackageManager
+		: convertDetectedPackageManager(project.packageManager);
 
 	const lockFileExists = packageManager.lockFiles.some((lockFile) =>
 		existsSync(join(projectPath, lockFile))

packages/cli/packages.ts

@@ -141,6 +141,7 @@
 	}
 
 	switch (packageManager) {
+		case "nub":
 		case "pnpm":
 		case "nub":
 			return ["--workspace-root"];

packages/workers-utils/src/index.ts

@@ -162,6 +162,7 @@ export {
 	PnpmPackageManager,
 	YarnPackageManager,
 	BunPackageManager,
+	NubPackageManager,
 } from "./package-manager";
 
 export {

packages/workers-utils/src/package-manager.ts

@@ -4,7 +4,7 @@
  */
 export interface PackageManager {
 	/** The package manager identifier. */
-	type: "npm" | "yarn" | "pnpm" | "bun";
+	type: "npm" | "yarn" | "pnpm" | "bun" | "nub";
 	/** The command used to execute packages (e.g. `npx`, `pnpm`, `bunx`). */
 	npx: string;
 	/** The command segments used to download and execute packages (e.g. `["npx"]`, `["pnpm", "dlx"]`). */
@@ -52,3 +52,13 @@ export const BunPackageManager = {
 	dlx: ["bunx"],
 	lockFiles: ["bun.lockb", "bun.lock"],
 } as const satisfies PackageManager;
+
+/**
+ * Manage packages using nub.
+ */
+export const NubPackageManager = {
+	type: "nub",
+	npx: "nubx",
+	dlx: ["nubx"],
+	lockFiles: ["nub.lock"],
+} as const satisfies PackageManager;

packages/workers-utils/tests/package-manager.test.ts

@@ -0,0 +1,47 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { describe, it } from "vitest";
+import {
+	BunPackageManager,
+	NpmPackageManager,
+	NubPackageManager,
+	PnpmPackageManager,
+	YarnPackageManager,
+} from "../src/package-manager";
+import { runInTempDir, seed } from "../src/test-helpers";
+import type { PackageManager } from "../src/package-manager";
+
+const packageManagers: PackageManager[] = [
+	NpmPackageManager,
+	PnpmPackageManager,
+	YarnPackageManager,
+	BunPackageManager,
+	NubPackageManager,
+];
+
+describe("package managers", () => {
+	it("describes nub", ({ expect }) => {
+		expect(NubPackageManager).toEqual({
+			type: "nub",
+			npx: "nubx",
+			dlx: ["nubx"],
+			lockFiles: ["nub.lock"],
+		});
+	});
+
+	describe("lock file detection", () => {
+		runInTempDir();
+
+		// Detection is lock-file-based: a project is managed by the package
+		// manager whose lock file is present, matching how consumers resolve it.
+		const findByLockFile = (dir: string) =>
+			packageManagers.find((pm) =>
+				pm.lockFiles.some((lockFile) => existsSync(join(dir, lockFile)))
+			);
+
+		it("detects nub from nub.lock", async ({ expect }) => {
+			await seed({ "nub.lock": "" });
+			expect(findByLockFile(process.cwd())).toBe(NubPackageManager);
+		});
+	});
+});

packages/wrangler/src/package-manager.ts

@@ -10,22 +10,25 @@ export {
 	PnpmPackageManager,
 	YarnPackageManager,
 	BunPackageManager,
+	NubPackageManager,
 } from "@cloudflare/workers-utils";
 
 import {
 	NpmPackageManager,
 	PnpmPackageManager,
 	YarnPackageManager,
 	BunPackageManager,
+	NubPackageManager,
 } from "@cloudflare/workers-utils";
 import type { PackageManager } from "@cloudflare/workers-utils";
 
 export async function getPackageManager(): Promise<PackageManager> {
-	const [hasYarn, hasNpm, hasPnpm, hasBun] = await Promise.all([
+	const [hasYarn, hasNpm, hasPnpm, hasBun, hasNub] = await Promise.all([
 		supportsYarn(),
 		supportsNpm(),
 		supportsPnpm(),
 		supportsBun(),
+		supportsNub(),
 	]);
 
 	const userAgent = sniffUserAgent();
@@ -43,6 +46,9 @@ export async function getPackageManager(): Promise<PackageManager> {
 	} else if (userAgent === "bun" && hasBun) {
 		logger.debug("Using bun as package manager.");
 		return { ...BunPackageManager };
+	} else if (userAgent === "nub" && hasNub) {
+		logger.debug("Using nub as package manager.");
+		return { ...NubPackageManager };
 	}
 
 	// lastly, check what's installed
@@ -58,9 +64,12 @@ export async function getPackageManager(): Promise<PackageManager> {
 	} else if (hasBun) {
 		logger.debug("Using bun as package manager.");
 		return { ...BunPackageManager };
+	} else if (hasNub) {
+		logger.debug("Using nub as package manager.");
+		return { ...NubPackageManager };
 	} else {
 		throw new UserError(
-			"Unable to find a package manager. Supported managers are: npm, yarn, pnpm, and bun.",
+			"Unable to find a package manager. Supported managers are: npm, yarn, pnpm, bun, and nub.",
 			{
 				telemetryMessage: "package manager detection missing manager",
 			}
@@ -100,6 +109,10 @@ function supportsBun(): Promise<boolean> {
 	return supports("bun");
 }
 
+function supportsNub(): Promise<boolean> {
+	return supports("nub");
+}
+
 /**
  * The environment variable `npm_config_user_agent` can be used to
  * guess the package manager that was used to execute wrangler.
@@ -111,7 +124,13 @@ function supportsBun(): Promise<boolean> {
  * - [yarn](https://yarnpkg.com/advanced/lifecycle-scripts#environment-variables)
  * - [bun](https://github.com/oven-sh/bun/blob/550522e99b303d8172b7b16c5750d458cb056434/src/Global.zig#L205)
  */
-export function sniffUserAgent(): "npm" | "pnpm" | "yarn" | "bun" | undefined {
+export function sniffUserAgent():
+	| "npm"
+	| "pnpm"
+	| "yarn"
+	| "bun"
+	| "nub"
+	| undefined {
 	const userAgent = env.npm_config_user_agent;
 	if (userAgent === undefined) {
 		return undefined;
@@ -129,6 +148,11 @@ export function sniffUserAgent(): "npm" | "pnpm" | "yarn" | "bun" | undefined {
 		return "bun";
 	}
 
+	// nub's user agent contains "npm" (e.g. `nub/0.4.5 npm/? …`), so check it before npm.
+	if (userAgent.includes("nub")) {
+		return "nub";
+	}
+
 	// npm should come last as it is included in the user agent strings of other package managers
 	if (userAgent.includes("npm")) {
 		return "npm";