@bobfrankston/npmglobalize 1.0.140 → 1.0.141

package/lib.js

@@ -1072,6 +1072,96 @@ export function runCommand(cmd, args, options = {}) {
         return { success: false, output: '', stderr: error.message };
     }
 }
+/** Diagnose common build/version failure patterns and print actionable hints.
+ *  Returns true if a diagnosis was printed. */
+function diagnoseBuildFailure(errorText, cwd) {
+    let diagnosed = false;
+    // Pattern: missing module / package not found
+    const missingPkg = errorText.match(/Cannot find (?:package|module) ['"](@?[^'"\/]+(?:\/[^'"\/]+)?)/);
+    if (missingPkg) {
+        const pkgName = missingPkg[1];
+        console.error(colors.yellow(`\n  Hint: missing package "${pkgName}"`));
+        // Check for broken symlinks in node_modules tree
+        const searchDirs = [cwd];
+        try {
+            for (const entry of fs.readdirSync(cwd, { withFileTypes: true })) {
+                if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== '.git' && entry.name !== 'prev') {
+                    searchDirs.push(path.join(cwd, entry.name));
+                }
+            }
+        }
+        catch { /* ignore */ }
+        for (const dir of searchDirs) {
+            const nmPath = path.join(dir, 'node_modules', ...pkgName.split('/'));
+            try {
+                const stat = fs.lstatSync(nmPath);
+                if (stat.isSymbolicLink()) {
+                    const target = fs.readlinkSync(nmPath);
+                    const resolved = path.resolve(path.dirname(nmPath), target);
+                    if (!fs.existsSync(resolved)) {
+                        console.error(colors.yellow(`  Broken symlink: ${nmPath}`));
+                        console.error(colors.yellow(`    → ${resolved} (target missing)`));
+                        console.error(colors.yellow(`  Fix: cd "${dir}" && npm install`));
+                        diagnosed = true;
+                    }
+                    else {
+                        console.error(colors.yellow(`  Symlink exists at ${nmPath} but module still failed to load.`));
+                        console.error(colors.yellow(`  Check that the target package has been built (has .js files).`));
+                        diagnosed = true;
+                    }
+                }
+            }
+            catch {
+                // No symlink found at this location — check if it should exist
+                const subPkgPath = path.join(dir, 'package.json');
+                if (fs.existsSync(subPkgPath)) {
+                    try {
+                        const subPkg = JSON.parse(fs.readFileSync(subPkgPath, 'utf-8'));
+                        const allDeps = { ...subPkg.dependencies, ...subPkg.devDependencies };
+                        if (allDeps[pkgName]) {
+                            const depValue = allDeps[pkgName];
+                            if (typeof depValue === 'string' && depValue.startsWith('file:')) {
+                                const target = path.resolve(dir, depValue.replace('file:', ''));
+                                console.error(colors.yellow(`  "${pkgName}" is a file: dep in ${path.relative(cwd, subPkgPath) || 'package.json'}`));
+                                console.error(colors.yellow(`    → ${target}`));
+                                if (!fs.existsSync(target)) {
+                                    console.error(colors.yellow(`    Target directory does not exist!`));
+                                }
+                                else {
+                                    console.error(colors.yellow(`  Fix: cd "${dir}" && npm install`));
+                                }
+                                diagnosed = true;
+                            }
+                            else {
+                                console.error(colors.yellow(`  "${pkgName}" is listed in ${path.relative(cwd, subPkgPath) || 'package.json'} but not installed.`));
+                                console.error(colors.yellow(`  Fix: cd "${dir}" && npm install`));
+                                diagnosed = true;
+                            }
+                        }
+                    }
+                    catch { /* ignore parse errors */ }
+                }
+            }
+        }
+        if (!diagnosed) {
+            console.error(colors.yellow(`  "${pkgName}" is not installed and not listed as a dependency.`));
+            console.error(colors.yellow(`  If needed, add it: npm install ${pkgName}`));
+            diagnosed = true;
+        }
+    }
+    // Pattern: permission denied
+    if (!diagnosed && /permission denied|EPERM|EACCES/.test(errorText)) {
+        console.error(colors.yellow('\n  Hint: permission error during build.'));
+        console.error(colors.yellow('  Check file ownership and that no other process has files locked.'));
+        diagnosed = true;
+    }
+    // Pattern: TypeScript compilation error
+    if (!diagnosed && /error TS\d+/.test(errorText)) {
+        console.error(colors.yellow('\n  Hint: TypeScript compilation errors. Fix the type errors above before publishing.'));
+        diagnosed = true;
+    }
+    return diagnosed;
+}
 /** Run git commit silently and print a compact summary (no per-file create/delete mode lines). */
 function gitCommit(msg, cwd) {
     const result = runCommand('git', ['commit', '-m', msg], { cwd, silent: true });
@@ -2646,6 +2736,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             const buildResult = runCommand('npm', ['run', 'build'], { cwd, silent: !verbose });
             if (!buildResult.success) {
                 console.error(colors.red('ERROR: Build failed:'), buildResult.stderr || buildResult.output);
+                diagnoseBuildFailure(buildResult.stderr || buildResult.output || '', cwd);
                 if (!force) {
                     return false;
                 }
@@ -3551,6 +3642,9 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                 if (error.code)
                     console.error('  exit code:', error.code);
             }
+            // Diagnose common failures (missing modules, permissions, TS errors)
+            const versionErrorText = [error.message, error.stderr, error.stdout].filter(Boolean).join('\n');
+            diagnoseBuildFailure(versionErrorText, cwd);
             // Show the full error stack in verbose mode
             if (verbose && error.stack) {
                 console.error('  Stack trace:', error.stack);

package/package.json

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