pkgmgr 1.0.0 → 1.1.1

package/README.md

@@ -2,6 +2,12 @@
 
 A minimal CLI that forwards commands to whichever package manager you're already using.
 
+<a href="https://github.com/epicweb-dev/full-stack-foundations/commit/fdb0644909a6d5e847b9bf3fb12e8efd120aa036">
+  <img src="./demo.png" alt="Diff showing package.json scripts being updated to use pkgmgr instead of npm. Scripts like postinstall, start, dev, build, and test are changed from using npm and npx to pkgmgr and pkgmgrx. The result: these scripts now work seamlessly whether contributors use npm, pnpm, yarn, or bun." style="max-width: 691px; max-height: 868px;" />
+</a>
+
+**What's happening here:** A project replaces hardcoded `npm` and `npx` calls with `pkgmgr` and `pkgmgrx` in their package.json scripts. Now when a contributor runs `pnpm run dev`, the script uses `pnpm`. When another runs `bun run dev`, it uses `bun`. No configuration, no conditional logic—just automatic package manager detection.
+
 ## The Problem
 
 You're writing a script, a tool, or documentation that needs to run package manager commands. But different users use different package managers (npm, pnpm, yarn, bun), and you don't want to:
@@ -24,6 +30,10 @@ pkgmgr exec vitest      # runs: <detected-pm> exec vitest
 
 ## Available Binaries
 
+### Package Manager Binaries (`pkgmgr`)
+
+Forward commands directly to the detected package manager.
+
 | Binary | Fallback |
 |--------|----------|
 | `pkgmgr` | npm |
@@ -31,6 +41,22 @@ pkgmgr exec vitest      # runs: <detected-pm> exec vitest
 | `pkgmgr-pnpm` | pnpm |
 | `pkgmgr-yarn` | yarn |
 
+### Exec Binaries (`pkgmgrx`)
+
+Forward commands to the detected package manager's "exec" equivalent.
+
+| Binary | Fallback | Executes |
+|--------|----------|----------|
+| `pkgmgrx` | npm | `npx <args>` |
+| `pkgmgrx-bun` | bun | `bunx <args>` |
+| `pkgmgrx-pnpm` | pnpm | `pnpm dlx <args>` |
+| `pkgmgrx-yarn` | yarn | `yarn dlx <args>` |
+
+```bash
+pkgmgrx cowsay "Hello"    # runs: npx cowsay "Hello" (or bunx, pnpm dlx, yarn dlx)
+pkgmgrx tsc --version     # runs: npx tsc --version
+```
+
 All binaries use the same detection logic. The only difference is which package manager is used when detection fails (no `PKGMGR` env var and no `npm_config_user_agent`).
 
 ## Detection Logic

package/bin/lib.js

@@ -1,5 +1,13 @@
 const SUPPORTED = new Set(['npm', 'pnpm', 'yarn', 'bun'])
 
+// Maps package manager to its "exec" command equivalent
+const EXEC_COMMANDS = {
+  npm: { bin: 'npx', args: [] },
+  pnpm: { bin: 'pnpm', args: ['dlx'] },
+  yarn: { bin: 'yarn', args: ['dlx'] },
+  bun: { bin: 'bunx', args: [] },
+}
+
 export function detectPackageManager(fallback = 'npm') {
   // 1. Explicit override via environment variable
   const envOverride = process.env.PKGMGR
@@ -45,3 +53,32 @@ export async function run(fallback = 'npm') {
     process.exit(code ?? 0)
   })
 }
+
+export async function runExec(fallback = 'npm') {
+  const pm = detectPackageManager(fallback)
+  const args = process.argv.slice(2)
+
+  if (args.length === 0) {
+    console.error('pkgmgrx: no command specified')
+    process.exit(1)
+  }
+
+  const { bin, args: prefixArgs } = EXEC_COMMANDS[pm]
+  const command = [...prefixArgs, ...args]
+
+  const { spawn } = await import('node:child_process')
+
+  const child = spawn(bin, command, {
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  })
+
+  child.on('error', (err) => {
+    console.error(`pkgmgrx: failed to execute ${bin}: ${err.message}`)
+    process.exit(1)
+  })
+
+  child.on('close', (code) => {
+    process.exit(code ?? 0)
+  })
+}

package/bin/pkgmgrx-bun.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('bun')

package/bin/pkgmgrx-pnpm.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('pnpm')

package/bin/pkgmgrx-yarn.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('yarn')

package/bin/pkgmgrx.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('npm')

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "pkgmgr",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Forward commands to the package manager you're already using",
   "bin": {
     "pkgmgr": "./bin/pkgmgr.js",
     "pkgmgr-bun": "./bin/pkgmgr-bun.js",
     "pkgmgr-pnpm": "./bin/pkgmgr-pnpm.js",
-    "pkgmgr-yarn": "./bin/pkgmgr-yarn.js"
+    "pkgmgr-yarn": "./bin/pkgmgr-yarn.js",
+    "pkgmgrx": "./bin/pkgmgrx.js",
+    "pkgmgrx-bun": "./bin/pkgmgrx-bun.js",
+    "pkgmgrx-pnpm": "./bin/pkgmgrx-pnpm.js",
+    "pkgmgrx-yarn": "./bin/pkgmgrx-yarn.js"
   },
   "files": [
     "bin"