@bobfrankston/npmglobalize 1.0.184 → 1.0.186

package/lib.d.ts

@@ -296,6 +296,7 @@ export declare function parseVersionTag(tag: string): number[] | null;
 export declare function compareVersions(a: number[], b: number[]): number;
 /** Fix version/tag mismatches */
 export declare function fixVersionTagMismatch(cwd: string, pkg: any, verbose?: boolean): boolean;
+export declare function printPnpmSuggestionSummary(): void;
 /** Return declared deps (dependencies + devDependencies) that don't resolve from
  *  `pkgDir`. Skips `workspace:`/`link:` specs (handled by workspace tooling /
  *  rarely used). `file:` deps are checked: npm installs them as junctions

package/lib.js

@@ -29,6 +29,7 @@ function spawnSafe(cmd, args, options = {}) {
     return spawnSync(cmd, args, opts);
 }
 import readline from 'readline';
+import { styleText } from 'util';
 import libversion from 'libnpmversion';
 import JSON5 from 'json5';
 import { fileURLToPath } from 'url';
@@ -1666,6 +1667,59 @@ export function fixVersionTagMismatch(cwd, pkg, verbose = false) {
 function sleepSync(ms) {
     Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
+/** User-requested pnpm-eval hook (2026-05-14). The first local `npm install`
+ *  failure in a process prints a yellow-on-red banner and pauses 60s so the
+ *  user can read it. Every failure (first and subsequent) is captured in
+ *  `_pnpmFailureContexts` so `printPnpmSuggestionSummary()` can re-emit the
+ *  banner — listing all failure sites — at end-of-run, in case the live
+ *  banner scrolled past. Remove once pnpm-vs-npm decision is made. */
+let _pnpmSuggestionShown = false;
+const _pnpmFailureContexts = [];
+function _pnpmBanner(contexts) {
+    const width = 76;
+    const wrap = (s) => styleText(['yellow', 'bgRed', 'bold'], ' ' + s.padEnd(width - 2) + ' ');
+    const body = [
+        '',
+        contexts.length > 1
+            ? `npm install FAILED  --  ${contexts.length} sites  --  consider trying pnpm`
+            : 'npm install FAILED  --  consider trying pnpm',
+        '',
+    ];
+    for (const c of contexts) {
+        const label = `  - ${c}`;
+        body.push(label.length > width - 2 ? label.slice(0, width - 5) + '...' : label);
+    }
+    body.push('', 'pnpm uses a content-addressed store with strict node_modules and', 'much faster installs. Commands mirror npm; great workspace support.', '', 'Try:   npm i -g pnpm  &&  pnpm import  &&  pnpm install', '');
+    return body.map(wrap);
+}
+async function suggestPnpmOnInstallFailure(context) {
+    _pnpmFailureContexts.push(context);
+    if (_pnpmSuggestionShown)
+        return;
+    _pnpmSuggestionShown = true;
+    const lines = _pnpmBanner([context]);
+    console.error('');
+    for (const l of lines)
+        console.error(l);
+    console.error(styleText(['yellow', 'bgRed', 'bold'], ' ' + 'Pausing 60s so you can read this. Ctrl+C to abort.'.padEnd(74) + ' '));
+    console.error('');
+    await new Promise(resolve => setTimeout(resolve, 60_000));
+}
+/** Re-emit the pnpm banner at end-of-run if any `npm install` failed.
+ *  No-op when nothing failed. Safe to call from multiple summary paths —
+ *  guarded so the summary banner prints at most once per process. */
+let _pnpmSummaryPrinted = false;
+export function printPnpmSuggestionSummary() {
+    if (_pnpmSummaryPrinted)
+        return;
+    if (_pnpmFailureContexts.length === 0)
+        return;
+    _pnpmSummaryPrinted = true;
+    console.error('');
+    for (const l of _pnpmBanner(_pnpmFailureContexts))
+        console.error(l);
+    console.error('');
+}
 /** Wait for a package version to appear on the npm registry.
  *  First-time publishes (brand-new package name) take much longer to
  *  propagate than version bumps — npm has no cached metadata to update,
@@ -1828,6 +1882,7 @@ export async function ensureFileDepModules(cwd, verbose = false, visited = new S
             console.error(colors.red(`  ✗ npm install failed in ${abs}`));
             if (r.stderr)
                 console.error(colors.dim(r.stderr.split('\n').slice(0, 5).join('\n')));
+            await suggestPnpmOnInstallFailure(`ensureFileDepModules (cwd): ${abs}`);
         }
     }
     for (const key of ['dependencies', 'devDependencies']) {
@@ -1865,6 +1920,7 @@ export async function ensureFileDepModules(cwd, verbose = false, visited = new S
                     console.error(colors.red(`  ✗ npm install failed in ${target}`));
                     if (r.stderr)
                         console.error(colors.dim(r.stderr.split('\n').slice(0, 5).join('\n')));
+                    await suggestPnpmOnInstallFailure(`ensureFileDepModules (file: dep ${name}): ${target}`);
                 }
             }
             await ensureFileDepModules(target, verbose, visited);
@@ -1993,6 +2049,7 @@ export async function ensureWorkspaceDepModules(rootDir, members, verbose = fals
         console.error(colors.red(`  ✗ npm install failed in ${root}`));
         if (r.stderr)
             console.error(colors.dim(r.stderr.split('\n').slice(0, 5).join('\n')));
+        await suggestPnpmOnInstallFailure(`ensureWorkspaceDepModules: ${root}`);
     }
 }
 /** Run npm install -g with retries for registry propagation delay.
@@ -4788,6 +4845,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             console.log(`  ${colors.yellow('!')} ${s}`);
         console.log(colors.yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
         console.log('');
+        printPnpmSuggestionSummary();
         return true;
     }
     // Skip if private
@@ -5901,6 +5959,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     }
     console.log(colors.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
     console.log('');
+    printPnpmSuggestionSummary();
     // Only show "To use run" message if package provides commands (has bin field)
     if (finalPkg.bin) {
         const commandName = finalPkg.name.includes('/') ? finalPkg.name.split('/')[1] : finalPkg.name;
@@ -6254,6 +6313,7 @@ export async function globalizeWorkspace(rootDir, options = {}, configOptions =
     }
     console.log(colors.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
     console.log('');
+    printPnpmSuggestionSummary();
     // Global install of the workspace root (monorepo CLI)
     const { install = false, link = false, wsl = false, dryRun = false, verbose = false } = options;
     const rootPkgFinal = readPackageJson(rootDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.184",
+  "version": "1.0.186",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",