feat(npm): add fn to Update a package's tag in the npm registry to a specific version

src/index.ts

@@ -31,6 +31,7 @@ export { default as gitPublishBranch } from "./git/doGitPublishBranch.js";
 export { default as gitReset } from "./git/doGitReset.js";
 export { default as gitDiff } from "./git/doGitDiff.js";
 
+export { default as npmSetTag } from "./npm/doSetNpmTag.js";
 export { default as npmBumpVersion } from "./npm/doNpmBumpVersion.js";
 export { default as npmPublish } from "./npm/doNpmPublish.js";
 export { default as refreshPackageLock } from "./npm/doRefreshPackageLock.js";

src/npm/doSetNpmTag.ts

@@ -0,0 +1,19 @@
+import spawn from "../utils/spawn.js";
+import appendCmdIfWindows from "./utils/appendCmdIfWindows.js";
+import npmLogger from "./utils/npmLogger.js";
+
+/**
+ * Update a package's tag in the npm registry to a specific version
+ * @param packageName The name of the package to update
+ * @param version The version to use for the update
+ * @param tag Th tag to update
+ */
+export default async function (
+  packageName: string,
+  version: string,
+  tag: string,
+) {
+  const params = ["dist-tag", "add", [packageName, version].join("@"), tag];
+  const npmPs = await spawn(appendCmdIfWindows`npm`, params, npmLogger);
+  return npmPs.stdout.toString().trim();
+}