pubz 0.3.0 → 0.4.1

package/README.md

@@ -1,5 +1,9 @@
 # `pubz`
 
+<img width="1024" height="1024" alt="image" src="https://github.com/user-attachments/assets/11ffa33c-e895-4a7d-b2c3-dfadde8dd124" />
+
+---
+
 ```bash
 bunx pubz
 ```
@@ -14,8 +18,10 @@ bunx pubz
 6. Commits version changes
 7. Prompts you for where you want to publish (e.g. `npm` or private registry)
 8. Builds packages
-9. Publishes to npm
-10. Prompts you to create a `git tag` and push it
+9. Transforms `workspace:` definitions to hard version numbers (so `npm` can be used for publishing with OIDC support).
+10. Publishes to npm
+11. Prompts you to create a `git tag` and push it
+12. Generates a changelog and creates a GitHub Release
 
 ## Options
 
@@ -181,49 +187,35 @@ Discovering packages...
 
 Found 1 publishable package(s):
 
-  • pubz@0.2.2
+  • pubz@0.4.0
 
 Step 1: Version Management
 ──────────────────────────────
 
-Current version: 0.2.2
-
-? Bump version before publishing? [Y/n]
-? Select version bump type:
-
-  > 1) patch (0.2.2 -> 0.2.3)
-    2) minor (0.2.2 -> 0.3.0)
-    3) major (0.2.2 -> 1.0.0)
-
-  Enter choice [1-3] (default: 1): 1
-
-Updating version to 0.2.3 in all packages...
-
-  Updated pubz: 0.2.2 -> 0.2.3
- M package.json
-Committing version bump...
-[main 945e1a3] chore: release v0.2.3
- 1 file changed, 1 insertion(+), 1 deletion(-)
-  Changes committed
+Current version: 0.4.0
 
+? Bump version before publishing? [Y/n] n
 ? Select publish target:
 
   > 1) Public npm registry (https://registry.npmjs.org)
     2) GitHub Packages (https://npm.pkg.github.com)
 
-  Enter choice [1-2] (default: 1):
+  Enter choice [1-2] (default: 1): 
 
 Publishing to: https://registry.npmjs.org
 
+Verifying npm authentication...
+Authenticated as zdavison
+
 Step 2: Building Packages
 ──────────────────────────────
 
 Running build...
 
 $ bun build src/cli.ts --outdir dist --target node
-Bundled 7 modules in 7ms
+Bundled 10 modules in 5ms
 
-  cli.js  28.65 KB  (entry point)
+  cli.js  41.27 KB  (entry point)
 
 
 Build completed successfully
@@ -237,46 +229,68 @@ Step 3: Publishing to npm
 
 About to publish the following packages:
 
-  • pubz@0.2.3
+  • pubz@0.4.0
 
 Registry: https://registry.npmjs.org
 
-? Continue? [Y/n]
+? Continue? [Y/n] 
+
+Preparing packages for publish...
 
 Publishing packages...
 
-Publishing pubz@0.2.3...
-npm notice
-npm notice 📦  pubz@0.2.3
-npm notice Tarball Contents
-npm notice 717B  package.json
-npm notice 2.3kB README.md
-npm notice 28.7kB dist/cli.js
-npm notice Tarball Details
-npm notice name:          pubz
-npm notice version:       0.2.3
-npm notice filename:      pubz-0.2.3.tgz
-npm notice package size:  8.3 kB
-npm notice unpacked size: 31.6 kB
-npm notice shasum:        b8cd25d62b05d5cd6a4ecc8ff6ef6e522e7b2aa5
-npm notice integrity:     sha512-jihTMvUxMeXNX[...]2+gtHJexETkWA==
-npm notice total files:   3
-npm notice
-+ pubz@0.2.3
+Publishing pubz@0.4.0...
+npm notice 
+npm notice 📦  pubz@0.4.0
+npm notice === Tarball Contents === 
+npm notice 7.1kB  README.md   
+npm notice 41.3kB dist/cli.js 
+npm notice 697B   package.json
+npm notice === Tarball Details === 
+npm notice name:          pubz                                    
+npm notice version:       0.4.0                                   
+npm notice filename:      pubz-0.4.0.tgz                          
+npm notice package size:  12.0 kB                                 
+npm notice unpacked size: 49.1 kB                                 
+npm notice shasum:        3026a7936458dcaa84030a0ce2e206b9f74aa65d
+npm notice integrity:     sha512-6vKMOsC7sZa87[...]w8KNx1fD45u/A==
+npm notice total files:   3                                       
+npm notice 
+npm notice Publishing to https://registry.npmjs.org/ with tag latest and public access
+Authenticate your account at:
+https://www.npmjs.com/auth/cli/c47d9bee-2a1e-4adf-9aab-63d15acfade2
+Press ENTER to open in the browser...
+
++ pubz@0.4.0
   pubz published successfully
 
 ══════════════════════════════
 Publishing complete!
 
-Published version: 0.2.3
-
-? Create a git tag for v0.2.3? [Y/n]
-
-  Tag v0.2.3 created
-? Push tag to origin? [Y/n]
+Published version: 0.4.0
+
+Changes since v0.2.12:
+  5553c95 Fix ENTER to open browser not working.
+  9aaddff Fix tag/push/release branch when using --yes.
+  0ce3ab8 Generate changlog and attach it to release page / print it out during publish.
+  5a29ca4 Merge branch 'main' of github.com:mm-zacharydavison/pubz
+  b4c47fc Clean up README.md formatting
+  2da403c Update README.md
+  88a4211 Update README with image and usage instructions
+  8a8148a Update README.md
+  2b45d21 Transform 'workspace:' definitions on publish, and restore them before any commit.
+
+? Create a git tag for v0.4.0? [Y/n] 
+
+  Tag v0.4.0 created
+? Push tag to origin? [Y/n] 
+remote: This repository moved. Please use the new location:        
+remote:   git@github.com:zdavison/pubz.git        
 To github.com:mm-zacharydavison/pubz.git
- * [new tag]         v0.2.3 -> v0.2.3
-  Tag v0.2.3 pushed to origin
+ * [new tag]         v0.4.0 -> v0.4.0
+  Tag v0.4.0 pushed to origin
+? Create a GitHub release? [Y/n] 
+  Release created: https://github.com/zdavison/pubz/releases/tag/v0.4.0
 
 Done!
 ```

package/dist/cli.js

@@ -195,6 +195,9 @@ function prompt(question) {
 function closePrompt() {
   rl.close();
 }
+function pausePrompt() {
+  rl.close();
+}
 function resetPrompt() {
   rl.close();
   rl = readline.createInterface({
@@ -317,10 +320,25 @@ async function multiSelect(message, options, allSelectedByDefault = true) {
 
 // src/auth.ts
 import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+
+// src/log.ts
+var verboseEnabled = false;
+function setVerbose(enabled) {
+  verboseEnabled = enabled;
+}
+function debug(...args) {
+  if (verboseEnabled) {
+    console.error("[debug]", ...args);
+  }
+}
+
+// src/auth.ts
 async function checkNpmAuth(registry) {
   return new Promise((resolve2) => {
     const proc = spawn("npm", ["whoami", "--registry", registry], {
-      stdio: ["inherit", "pipe", "pipe"]
+      stdio: ["ignore", "pipe", "pipe"],
+      cwd: homedir()
     });
     let stdout = "";
     let stderr = "";
@@ -334,6 +352,7 @@ async function checkNpmAuth(registry) {
       if (code === 0 && stdout.trim()) {
         resolve2({ authenticated: true, username: stdout.trim() });
       } else {
+        debug(`npm whoami failed: code=${code}, stdout=${JSON.stringify(stdout)}, stderr=${JSON.stringify(stderr)}`);
         resolve2({ authenticated: false });
       }
     });
@@ -341,10 +360,13 @@ async function checkNpmAuth(registry) {
 }
 async function npmLogin(registry) {
   return new Promise((resolve2) => {
+    debug(`spawning: npm login --registry ${registry}`);
     const proc = spawn("npm", ["login", "--registry", registry], {
-      stdio: "inherit"
+      stdio: "inherit",
+      cwd: homedir()
     });
     proc.on("close", (code) => {
+      debug(`npm login exited: code=${code}`);
       if (code === 0) {
         resolve2({ success: true });
       } else {
@@ -357,6 +379,7 @@ async function npmLogin(registry) {
 // src/publish.ts
 import { spawn as spawn2 } from "node:child_process";
 import { readFile as readFile2, stat as stat3 } from "node:fs/promises";
+import { homedir as homedir2 } from "node:os";
 import { join as join3 } from "node:path";
 function run(command, args, cwd) {
   return new Promise((resolve2) => {
@@ -455,7 +478,9 @@ async function publishPackage(pkg, registry, context, dryRun) {
   let result;
   if (context.useBrowserAuth) {
     args.push("--auth-type", "web");
-    const interactiveResult = await runInteractive(NPM_COMMAND, args, pkg.path);
+    args.push(pkg.path);
+    context.onInteractiveStart?.();
+    const interactiveResult = await runInteractive(NPM_COMMAND, args, homedir2());
     result = { code: interactiveResult.code, output: "" };
     context.onInteractiveComplete?.();
   } else {
@@ -535,6 +560,118 @@ async function pushGitTag(version, cwd, dryRun) {
   return { success: true };
 }
 
+// src/changelog.ts
+import { spawn as spawn3 } from "node:child_process";
+function parseGitRemoteUrl(remoteUrl) {
+  const sshMatch = remoteUrl.match(/^git@([^:]+):(.+?)(?:\.git)?$/);
+  if (sshMatch) {
+    return `https://${sshMatch[1]}/${sshMatch[2]}`;
+  }
+  const httpsMatch = remoteUrl.match(/^https?:\/\/([^/]+)\/(.+?)(?:\.git)?$/);
+  if (httpsMatch) {
+    return `https://${httpsMatch[1]}/${httpsMatch[2]}`;
+  }
+  return null;
+}
+function runSilent(command, args, cwd) {
+  return new Promise((resolve2) => {
+    const proc = spawn3(command, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let output = "";
+    proc.stdout?.on("data", (data) => {
+      output += data.toString();
+    });
+    proc.stderr?.on("data", (data) => {
+      output += data.toString();
+    });
+    proc.on("close", (code) => {
+      resolve2({ code: code ?? 1, output });
+    });
+  });
+}
+async function getPreviousTag(cwd) {
+  const result = await runSilent("git", ["tag", "--sort=-version:refname"], cwd);
+  if (result.code !== 0)
+    return null;
+  const tags = result.output.trim().split(`
+`).filter((t) => t.length > 0);
+  return tags[0] ?? null;
+}
+async function getRepoUrl(cwd) {
+  const result = await runSilent("git", ["remote", "get-url", "origin"], cwd);
+  if (result.code !== 0)
+    return null;
+  return parseGitRemoteUrl(result.output.trim());
+}
+async function getCommitsSince(ref, cwd) {
+  const result = await runSilent("git", ["log", `${ref}..HEAD`, "--oneline", "--no-decorate"], cwd);
+  if (result.code !== 0)
+    return [];
+  return result.output.trim().split(`
+`).filter((line) => line.length > 0).map((line) => {
+    const spaceIdx = line.indexOf(" ");
+    return {
+      sha: line.slice(0, spaceIdx),
+      message: line.slice(spaceIdx + 1)
+    };
+  });
+}
+function isReleaseCommit(message) {
+  return /^chore: release v/.test(message);
+}
+function formatChangelogTerminal(commits) {
+  const filtered = commits.filter((c) => !isReleaseCommit(c.message));
+  if (filtered.length === 0)
+    return "";
+  return filtered.map((c) => `  ${dim(c.sha)} ${c.message}`).join(`
+`);
+}
+function formatChangelogMarkdown(commits, repoUrl) {
+  const filtered = commits.filter((c) => !isReleaseCommit(c.message));
+  if (filtered.length === 0)
+    return "";
+  return filtered.map((c) => {
+    const shaRef = repoUrl ? `[\`${c.sha}\`](${repoUrl}/commit/${c.sha})` : `\`${c.sha}\``;
+    return `- ${shaRef} ${c.message}`;
+  }).join(`
+`);
+}
+async function fetchTags(cwd) {
+  await runSilent("git", ["fetch", "--tags"], cwd);
+}
+async function generateChangelog(cwd) {
+  await fetchTags(cwd);
+  const [previousTag, repoUrl] = await Promise.all([
+    getPreviousTag(cwd),
+    getRepoUrl(cwd)
+  ]);
+  if (!previousTag) {
+    return { commits: [], terminal: "", markdown: "", previousTag: null, repoUrl };
+  }
+  const commits = await getCommitsSince(previousTag, cwd);
+  const terminal = formatChangelogTerminal(commits);
+  const markdown = formatChangelogMarkdown(commits, repoUrl);
+  return { commits, terminal, markdown, previousTag, repoUrl };
+}
+async function createGitHubRelease(version, body, cwd, dryRun) {
+  const tagName = `v${version}`;
+  if (dryRun) {
+    console.log(`[DRY RUN] Would create GitHub release for ${tagName}`);
+    return { success: true };
+  }
+  const result = await runSilent("gh", ["release", "create", tagName, "--title", tagName, "--notes", body], cwd);
+  if (result.code !== 0) {
+    return {
+      success: false,
+      error: result.output.trim() || `Failed to create GitHub release for ${tagName}`
+    };
+  }
+  const url = result.output.trim();
+  return { success: true, url };
+}
+
 // src/version.ts
 import { readFile as readFile3, writeFile } from "node:fs/promises";
 async function transformWorkspaceProtocolForPublish(packages, newVersion, dryRun) {
@@ -605,6 +742,9 @@ async function restoreWorkspaceProtocol(transforms) {
     console.log(`  Restored workspace references in ${byPath.size} package(s)`);
   }
 }
+function isValidVersion(version) {
+  return /^\d+\.\d+\.\d+(-.+)?$/.test(version);
+}
 function bumpVersion(version, type) {
   if (type === "none")
     return version;
@@ -702,6 +842,7 @@ Options:
   --yes, -y              Skip yes/no confirmation prompts (still asks for choices)
   --ci                   CI mode: skip all prompts, auto-accept everything
   --version <value>      Version bump type (patch|minor|major) or explicit version (required with --ci)
+  --verbose              Show debug logging
   -h, --help             Show this help message
 
 Examples:
@@ -721,6 +862,7 @@ function parseArgs(args) {
     skipConfirms: false,
     ci: false,
     version: "",
+    verbose: false,
     help: false
   };
   for (let i = 0;i < args.length; i++) {
@@ -748,6 +890,9 @@ function parseArgs(args) {
       case "--version":
         options.version = args[++i] || "";
         break;
+      case "--verbose":
+        options.verbose = true;
+        break;
       case "-h":
       case "--help":
         options.help = true;
@@ -762,6 +907,7 @@ async function main() {
     process.exit(0);
   }
   const options = parseArgs(process.argv.slice(2));
+  setVerbose(options.verbose);
   if (options.help) {
     printUsage();
     process.exit(0);
@@ -849,7 +995,13 @@ async function main() {
       newVersion = bumpVersion(currentVersion, options.version);
       console.log(`Bumping version (${options.version}): ${yellow(currentVersion)} → ${green(newVersion)}`);
     } else {
-      newVersion = options.version;
+      const cleaned = options.version.startsWith("v") ? options.version.slice(1) : options.version;
+      if (!isValidVersion(cleaned)) {
+        console.error(red(bold("Error:")) + ` Invalid version "${options.version}". Expected format: major.minor.patch (e.g. 1.2.3, 1.2.3-beta)`);
+        closePrompt();
+        process.exit(1);
+      }
+      newVersion = cleaned;
       console.log(`Using explicit version: ${green(newVersion)}`);
     }
     console.log("");
@@ -872,7 +1024,7 @@ async function main() {
   } else if (!skipAllPrompts) {
     const shouldBump = skipConfirms || await confirm("Bump version before publishing?");
     if (shouldBump) {
-      const bumpType = await select("Select version bump type:", [
+      const bumpChoice = await select("Select version bump type:", [
         {
           label: `patch (${previewBump(currentVersion, "patch")})`,
           value: "patch"
@@ -884,9 +1036,27 @@ async function main() {
         {
           label: `major (${previewBump(currentVersion, "major")})`,
           value: "major"
+        },
+        {
+          label: "custom version",
+          value: "custom"
         }
       ]);
-      newVersion = bumpVersion(currentVersion, bumpType);
+      if (bumpChoice === "custom") {
+        let customVersion = "";
+        while (!customVersion) {
+          const input = await prompt(`  Enter version: `);
+          const cleaned = input.startsWith("v") ? input.slice(1) : input;
+          if (isValidVersion(cleaned)) {
+            customVersion = cleaned;
+          } else {
+            console.log(yellow("  Invalid version. Expected format: major.minor.patch (e.g. 1.2.3, 1.2.3-beta)"));
+          }
+        }
+        newVersion = customVersion;
+      } else {
+        newVersion = bumpVersion(currentVersion, bumpChoice);
+      }
       console.log("");
       console.log(`Updating version to ${green(newVersion)} in all packages...`);
       console.log("");
@@ -930,7 +1100,9 @@ async function main() {
       console.log("");
       console.log(yellow("Not logged in to npm.") + " Starting login...");
       console.log("");
+      pausePrompt();
       const loginResult = await npmLogin(registry);
+      resetPrompt();
       if (!loginResult.success) {
         console.error(red(bold("Login failed:")) + ` ${loginResult.error}`);
         closePrompt();
@@ -1014,6 +1186,7 @@ async function main() {
   const publishContext = {
     otp: options.otp,
     useBrowserAuth: !options.ci,
+    onInteractiveStart: pausePrompt,
     onInteractiveComplete: resetPrompt
   };
   let publishFailed = false;
@@ -1052,27 +1225,52 @@ async function main() {
   console.log("");
   console.log(`Published version: ${green(bold(newVersion))}`);
   console.log("");
+  const changelog = await generateChangelog(cwd);
+  if (changelog.terminal) {
+    console.log(bold("Changes since ") + cyan(changelog.previousTag ?? "initial") + bold(":"));
+    console.log(changelog.terminal);
+    console.log("");
+  }
   if (!options.dryRun) {
     if (options.ci) {
-      console.log("");
       console.log(cyan("Creating git tag..."));
       const tagResult = await createGitTag(newVersion, cwd, options.dryRun);
       if (tagResult.success) {
         console.log(cyan("Pushing tag to origin..."));
         await pushGitTag(newVersion, cwd, options.dryRun);
+        if (changelog.markdown) {
+          console.log(cyan("Creating GitHub release..."));
+          const releaseResult = await createGitHubRelease(newVersion, changelog.markdown, cwd, options.dryRun);
+          if (releaseResult.success && releaseResult.url) {
+            console.log(`  Release created: ${cyan(releaseResult.url)}`);
+          } else if (!releaseResult.success) {
+            console.error(yellow(releaseResult.error ?? "Failed to create GitHub release"));
+          }
+        }
       } else {
         console.error(red(tagResult.error ?? "Failed to create git tag"));
       }
       console.log("");
-    } else if (!skipConfirms) {
-      const shouldTag = await confirm(`Create a git tag for ${cyan(`v${newVersion}`)}?`);
+    } else {
+      const shouldTag = skipConfirms || await confirm(`Create a git tag for ${cyan(`v${newVersion}`)}?`);
       if (shouldTag) {
         console.log("");
         const tagResult = await createGitTag(newVersion, cwd, options.dryRun);
         if (tagResult.success) {
-          const shouldPush = await confirm("Push tag to origin?");
+          const shouldPush = skipConfirms || await confirm("Push tag to origin?");
           if (shouldPush) {
             await pushGitTag(newVersion, cwd, options.dryRun);
+            if (changelog.markdown) {
+              const shouldRelease = skipConfirms || await confirm("Create a GitHub release?");
+              if (shouldRelease) {
+                const releaseResult = await createGitHubRelease(newVersion, changelog.markdown, cwd, options.dryRun);
+                if (releaseResult.success && releaseResult.url) {
+                  console.log(`  Release created: ${cyan(releaseResult.url)}`);
+                } else if (!releaseResult.success) {
+                  console.error(yellow(releaseResult.error ?? "Failed to create GitHub release"));
+                }
+              }
+            }
           } else {
             console.log(`Tag created locally. Push manually with: ${dim(`git push origin v${newVersion}`)}`);
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pubz",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Interactive CLI for publishing npm packages (single or monorepo)",
   "type": "module",
   "bin": {