@bobfrankston/npmglobalize 1.0.143 → 1.0.145

package/cli.js

@@ -2,7 +2,7 @@
 /**
  * npmglobalize CLI - Transform file: dependencies to npm versions for publishing
  */
-import { globalize, globalizeWorkspace, readConfig, readPackageJson, readUserNpmConfig, writeConfig, writePackageJson, confirm, getBuildIssues, clearBuildIssues, recordBuildIssue, extractFirstTscError } from './lib.js';
+import { globalize, globalizeWorkspace, installCleanupHandlers, readConfig, readPackageJson, readUserNpmConfig, writeConfig, writePackageJson, confirm, getBuildIssues, clearBuildIssues, recordBuildIssue, extractFirstTscError } from './lib.js';
 import fs from 'fs';
 import path from 'path';
 import { styleText } from 'util';
@@ -343,6 +343,7 @@ function printBuildSummary() {
     console.log('');
 }
 export async function main() {
+    installCleanupHandlers();
     // Show version at the very start
     const ownPkgPath = path.join(__dirname, 'package.json');
     const ownPkg = JSON.parse(fs.readFileSync(ownPkgPath, 'utf-8'));

package/ignorepatterns.json5

@@ -15,7 +15,8 @@
             "*.pfx",
             "token",
             "tokens",
-            "*.token"
+            "*.token",
+            "*.tgz"
         ],
         // Prompted or auto-added with --conform
         recommended: [

package/lib.d.ts

@@ -132,6 +132,8 @@ export declare function readConfig(dir: string): Partial<GlobalizeOptions>;
 export declare function writeConfig(dir: string, config: Partial<GlobalizeOptions>, explicitKeys?: Set<string>): void;
 /** Write package.json to a directory */
 export declare function writePackageJson(dir: string, pkg: any): void;
+/** Install signal/exit handlers that restore `.dependencies` backups on abnormal exit. */
+export declare function installCleanupHandlers(): void;
 /** Resolve a file: path to absolute path */
 export declare function resolveFilePath(fileRef: string, baseDir: string): string;
 /** Check if a dependency value is a file: reference */
@@ -188,7 +190,8 @@ export declare function transformDeps(pkg: any, baseDir: string, verbose?: boole
         path: string;
     }>;
 };
-/** Restore file: dependencies from .dependencies */
+/** Restore file: dependencies from .dependencies using a three-way merge that
+ *  preserves any external modifications made since the last transform. */
 export declare function restoreDeps(pkg: any, verbose?: boolean): boolean;
 /** Check if .dependencies exist (already transformed) */
 export declare function hasBackup(pkg: any): boolean;
@@ -268,6 +271,7 @@ declare const _default: {
     validatePackageJson: typeof validatePackageJson;
     confirm: typeof confirm;
     initGit: typeof initGit;
+    installCleanupHandlers: typeof installCleanupHandlers;
 };
 export default _default;
 //# sourceMappingURL=lib.d.ts.map

package/lib.js

@@ -313,10 +313,111 @@ export function writeConfig(dir, config, explicitKeys) {
     lines.push('}');
     fs.writeFileSync(configPath, lines.join('\n') + '\n');
 }
+/** Package.json paths with a live `.dependencies` backup on disk.
+ *  Tracked so the exit handler can restore them if the process dies mid-run. */
+const dirtyPackageJsons = new Set();
 /** Write package.json to a directory */
 export function writePackageJson(dir, pkg) {
     const pkgPath = path.join(dir, 'package.json');
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+    if (hasBackup(pkg)) {
+        dirtyPackageJsons.add(pkgPath);
+    }
+    else {
+        dirtyPackageJsons.delete(pkgPath);
+    }
+}
+/** Three-way merge that restores `.dependencies` backup into `dependencies` while
+ *  preserving external modifications made since the last transform.
+ *
+ *  Uses `.transformedSnapshot` (written by transformDeps) to distinguish
+ *  "untouched transform output" from "externally modified":
+ *    - current[name] === snapshot[name] → untouched, restore to backup value
+ *    - current[name] !== snapshot[name] → modified externally, keep current
+ *    - name in backup but missing from current → removed externally, leave removed
+ *    - name in current but not in backup → added externally, keep
+ *
+ *  If no snapshot exists (legacy backup from before this mechanism), falls back to
+ *  blind restore plus new-dep merge, matching the old behavior. */
+function mergeRestore(pkg, verbose = false) {
+    const snapshot = pkg['.transformedSnapshot'];
+    let restored = false;
+    for (const key of DEP_KEYS) {
+        const dotKey = '.' + key;
+        if (!pkg[dotKey])
+            continue;
+        const backup = pkg[dotKey];
+        const current = pkg[key] || {};
+        const snap = snapshot?.[key];
+        const merged = { ...current };
+        for (const [name, backupValue] of Object.entries(backup)) {
+            if (!(name in current))
+                continue; // removed externally — leave removed
+            if (snap && name in snap) {
+                if (current[name] === snap[name]) {
+                    merged[name] = backupValue; // untouched — restore
+                }
+                else if (verbose) {
+                    console.log(colors.yellow(`  Preserving externally-modified ${key}.${name}: ${current[name]} (transform wrote ${snap[name]})`));
+                }
+            }
+            else {
+                merged[name] = backupValue; // legacy: no snapshot, blind restore
+            }
+        }
+        pkg[key] = merged;
+        delete pkg[dotKey];
+        restored = true;
+    }
+    if (restored && snapshot) {
+        delete pkg['.transformedSnapshot'];
+    }
+    return restored;
+}
+/** Synchronous emergency restore — called from signal/exit handlers.
+ *  Reads each tracked package.json, runs the three-way merge, writes it back. */
+function emergencyRestoreDeps() {
+    if (dirtyPackageJsons.size === 0)
+        return;
+    console.error(colors.yellow(`\nRestoring file: dependencies in ${dirtyPackageJsons.size} package.json file(s)...`));
+    for (const pkgPath of dirtyPackageJsons) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            if (mergeRestore(pkg)) {
+                fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+                console.error(colors.green(`  ✓ ${pkgPath}`));
+            }
+        }
+        catch (err) {
+            console.error(colors.red(`  ✗ ${pkgPath}: ${err.message}`));
+        }
+    }
+    dirtyPackageJsons.clear();
+}
+let cleanupHandlersInstalled = false;
+/** Install signal/exit handlers that restore `.dependencies` backups on abnormal exit. */
+export function installCleanupHandlers() {
+    if (cleanupHandlersInstalled)
+        return;
+    cleanupHandlersInstalled = true;
+    process.on('exit', emergencyRestoreDeps);
+    const signalHandler = (signal) => {
+        emergencyRestoreDeps();
+        process.exit(128 + (signal === 'SIGINT' ? 2 : signal === 'SIGTERM' ? 15 : 1));
+    };
+    process.on('SIGINT', signalHandler);
+    process.on('SIGTERM', signalHandler);
+    process.on('SIGHUP', signalHandler);
+    process.on('uncaughtException', (err) => {
+        console.error(colors.red('\nUncaught exception:'), err);
+        emergencyRestoreDeps();
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        console.error(colors.red('\nUnhandled rejection:'), reason);
+        emergencyRestoreDeps();
+        process.exit(1);
+    });
 }
 /** Resolve a file: path to absolute path */
 export function resolveFilePath(fileRef, baseDir) {
@@ -766,36 +867,21 @@ function hasLocalChanges(packageName, version, targetPath, verbose) {
 export function transformDeps(pkg, baseDir, verbose = false, forcePublish = false) {
     let transformed = false;
     const unpublished = [];
+    // If re-running on a previously-transformed pkg, merge-restore first.
+    // This preserves any external modifications (AI tools, npm install, manual edits)
+    // made since the last transform, then proceeds to re-transform from a clean slate.
+    if (hasBackup(pkg)) {
+        mergeRestore(pkg, verbose);
+    }
     for (const key of DEP_KEYS) {
         if (!pkg[key])
             continue;
         const dotKey = '.' + key;
-        // If .dependencies already exists, restore it and merge any new dependencies
-        if (pkg[dotKey]) {
-            // Save any new dependencies that aren't in .dependencies
-            const currentDeps = { ...pkg[key] };
-            // Restore .dependencies back to dependencies
-            pkg[key] = { ...pkg[dotKey] };
-            // Merge in any NEW dependencies that were added since transformation
-            for (const [name, value] of Object.entries(currentDeps)) {
-                if (!(name in pkg[dotKey])) {
-                    // This is a new dependency, add it
-                    pkg[key][name] = value;
-                    // Also add to .dependencies backup
-                    pkg[dotKey][name] = value;
-                    if (verbose) {
-                        console.log(`  Merged new dependency: ${name}`);
-                    }
-                }
-            }
-        }
         const hasFileRefs = Object.values(pkg[key]).some(v => isFileRef(v));
         if (!hasFileRefs)
             continue;
-        // Backup original (or update existing backup with merged deps)
-        if (!pkg[dotKey]) {
-            pkg[dotKey] = { ...pkg[key] };
-        }
+        // Backup original
+        pkg[dotKey] = { ...pkg[key] };
         // Transform file: refs to npm versions
         for (const [name, value] of Object.entries(pkg[key])) {
             if (isFileRef(value)) {
@@ -846,6 +932,17 @@ export function transformDeps(pkg, baseDir, verbose = false, forcePublish = fals
             }
         }
     }
+    // Record snapshot of transform output so restore can distinguish untouched
+    // entries from those modified externally since the transform ran.
+    if (transformed) {
+        const snapshot = {};
+        for (const key of DEP_KEYS) {
+            if (pkg['.' + key]) {
+                snapshot[key] = { ...pkg[key] };
+            }
+        }
+        pkg['.transformedSnapshot'] = snapshot;
+    }
     return { transformed, unpublished };
 }
 /** Build and print a dependency tree of file: references.
@@ -889,21 +986,10 @@ function printDepTree(baseDir, indent = 0, visited = new Set()) {
         }
     }
 }
-/** Restore file: dependencies from .dependencies */
+/** Restore file: dependencies from .dependencies using a three-way merge that
+ *  preserves any external modifications made since the last transform. */
 export function restoreDeps(pkg, verbose = false) {
-    let restored = false;
-    for (const key of DEP_KEYS) {
-        const dotKey = '.' + key;
-        if (pkg[dotKey]) {
-            pkg[key] = pkg[dotKey];
-            delete pkg[dotKey];
-            restored = true;
-            if (verbose) {
-                console.log(`  Restored ${key} from ${dotKey}`);
-            }
-        }
-    }
-    return restored;
+    return mergeRestore(pkg, verbose);
 }
 /** Check if .dependencies exist (already transformed) */
 export function hasBackup(pkg) {
@@ -3475,8 +3561,22 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                                     console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
                                 }
                                 else {
-                                    console.error(colors.red(`✗ Global install failed`));
-                                    console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
+                                    // Registry install failed — fall back to local install
+                                    const auth = checkNpmAuth();
+                                    if (!auth.authenticated) {
+                                        console.log(colors.yellow(`  Registry install failed (${auth.error || 'auth issue'}) — falling back to local install...`));
+                                    }
+                                    else {
+                                        console.log(colors.yellow(`  Registry install failed — falling back to local install...`));
+                                    }
+                                    const localFallback = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false, showCommand: true });
+                                    if (localFallback.success) {
+                                        console.log(colors.green(`✓ Installed globally from local: ${pkgName}@${pkgVersion}`));
+                                    }
+                                    else {
+                                        console.error(colors.red(`✗ Global install failed`));
+                                        console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
+                                    }
                                 }
                             }
                             else {
@@ -4026,7 +4126,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             }
         }
         catch (e) {
-            // Ignore cleanup errors
+            console.error(colors.yellow(`  Warning: could not delete tarball ${tarballName} — remove manually`));
         }
         if (!publishResult.success) {
             // Check for specific error types before recording
@@ -4180,9 +4280,25 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                         console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
                     }
                     else {
-                        console.error(colors.red(`✗ Global install failed`));
-                        console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
-                        recordBuildIssue(pkgName, 'warning', 'Global install failed');
+                        // Registry install failed — may be auth/token issue for private packages.
+                        // Fall back to local install which doesn't need registry auth.
+                        const auth = checkNpmAuth();
+                        if (!auth.authenticated) {
+                            console.log(colors.yellow(`  Registry install failed (${auth.error || 'auth issue'}) — falling back to local install...`));
+                        }
+                        else {
+                            console.log(colors.yellow(`  Registry install failed — falling back to local install...`));
+                        }
+                        const localFallback = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false, showCommand: true });
+                        if (localFallback.success) {
+                            globalInstallOk = true;
+                            console.log(colors.green(`✓ Installed globally from local: ${pkgName}@${pkgVersion}`));
+                        }
+                        else {
+                            console.error(colors.red(`✗ Global install failed`));
+                            console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
+                            recordBuildIssue(pkgName, 'warning', 'Global install failed');
+                        }
                     }
                 }
                 else {
@@ -4563,6 +4679,7 @@ export default {
     getGitStatus,
     validatePackageJson,
     confirm,
-    initGit
+    initGit,
+    installCleanupHandlers
 };
 //# sourceMappingURL=lib.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.143",
+  "version": "1.0.145",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",
@@ -31,10 +31,10 @@
     "url": "https://github.com/BobFrankston/npmglobalize.git"
   },
   "dependencies": {
-    "@bobfrankston/freezepak": "^0.1.6",
-    "@bobfrankston/importgen": "^0.1.32",
-    "@bobfrankston/themecolors": "^0.1.4",
-    "@bobfrankston/userconfig": "^1.0.6",
+    "@bobfrankston/freezepak": "^0.1.7",
+    "@bobfrankston/importgen": "^0.1.33",
+    "@bobfrankston/themecolors": "^0.1.5",
+    "@bobfrankston/userconfig": "^1.0.7",
     "@npmcli/package-json": "^7.0.4",
     "json5": "^2.2.3",
     "libnpmversion": "^8.0.3",
@@ -56,5 +56,19 @@
     "npm-registry-fetch": "^19.1.1",
     "pacote": "^21.0.4",
     "simple-git": "^3.30.0"
+  },
+  ".transformedSnapshot": {
+    "dependencies": {
+      "@bobfrankston/freezepak": "^0.1.7",
+      "@bobfrankston/importgen": "^0.1.33",
+      "@bobfrankston/themecolors": "^0.1.5",
+      "@bobfrankston/userconfig": "^1.0.7",
+      "@npmcli/package-json": "^7.0.4",
+      "json5": "^2.2.3",
+      "libnpmversion": "^8.0.3",
+      "npm-registry-fetch": "^19.1.1",
+      "pacote": "^21.0.4",
+      "simple-git": "^3.30.0"
+    }
   }
 }