install-module-linked-compat 0.1.0

package/dist/esm/lib/cache.js

@@ -0,0 +1,93 @@
+import fs from 'fs';
+import { safeRm } from 'fs-remove-compat';
+import lockfile from 'lockfile';
+import mkdirp from 'mkdirp-classic';
+import path from 'path';
+import Queue from 'queue-cb';
+import tempSuffix from 'temp-suffix';
+import getSpecifier from './getSpecifier.js';
+import install from './install.js';
+import parse from './parseInstallString.js';
+import renameWithFallback from './renameWithFallback.js';
+const LOCK_OPTIONS = {
+    wait: 600000,
+    pollPeriod: 100,
+    stale: 660000,
+    retries: 3
+};
+export default function ensureCached(installString, cachePath, callback) {
+    getSpecifier(installString, (err, specifier)=>{
+        if (err) return callback(err);
+        // biome-ignore lint/style/noNonNullAssertion: getSpecifier always sets the specifier when err is null
+        const cachedAt = path.join(cachePath, specifier);
+        const lockPath = `${cachedAt}.lock`;
+        const readyPath = path.join(cachedAt, '.ready');
+        const { name } = parse(installString);
+        // Check if already cached AND complete (fast path, no lock needed)
+        fs.stat(readyPath, (readyErr)=>{
+            if (!readyErr) return callback(undefined, cachedAt); // Valid cache
+            // Not cached or incomplete - acquire lock and install
+            doLockedInstall();
+        });
+        function doLockedInstall() {
+            // Ensure lock file's parent directory exists (handles scoped packages like @scope/pkg)
+            mkdirp(path.dirname(lockPath), (mkdirErr)=>{
+                if (mkdirErr) return callback(mkdirErr);
+                const startTime = Date.now();
+                // Retry loop for Windows EPERM - treat it like EEXIST (lock held by another process)
+                function tryLock(cb) {
+                    lockfile.lock(lockPath, {
+                        ...LOCK_OPTIONS
+                    }, (lockErr)=>{
+                        if (lockErr && lockErr.code === 'EPERM' && Date.now() - startTime < LOCK_OPTIONS.wait) {
+                            setTimeout(()=>tryLock(cb), LOCK_OPTIONS.pollPeriod);
+                            return;
+                        }
+                        cb(lockErr);
+                    });
+                }
+                tryLock((lockErr)=>{
+                    if (lockErr) return callback(lockErr);
+                    // Single exit point - always unlock before calling back
+                    function done(err) {
+                        lockfile.unlock(lockPath, ()=>callback(err, err ? undefined : cachedAt));
+                    }
+                    // Re-check cache (another process may have completed while we waited for lock)
+                    fs.stat(readyPath, (readyErr)=>{
+                        if (!readyErr) return done(); // Cache appeared while we waited
+                        // Clean up any incomplete cache before installing
+                        safeRm(cachedAt, (rmErr)=>{
+                            if (rmErr) return done(rmErr);
+                            doInstall(done);
+                        });
+                    });
+                });
+            });
+        }
+        function doInstall(cb) {
+            const tmp = `${cachedAt}-${tempSuffix()}`;
+            const tmpModulePath = path.join(tmp, 'node_modules', ...name.split('/'));
+            const queue = new Queue(1);
+            queue.defer((cb)=>mkdirp(tmp, (err)=>cb(err)));
+            queue.defer((cb)=>fs.writeFile(path.join(tmp, 'package.json'), '{}', 'utf8', (err)=>cb(err)));
+            // biome-ignore lint/style/noNonNullAssertion: getSpecifier always sets the specifier when err is null
+            queue.defer(install.bind(null, specifier, tmp));
+            queue.defer((qcb)=>{
+                // Verify npm actually created the package directory - npm may silently skip
+                // installation (exit 0) when platform doesn't match (os/cpu/libc fields)
+                fs.stat(tmpModulePath, (statErr)=>{
+                    if (statErr) return qcb(new Error(`Package directory not created by npm. This may happen when the package has platform restrictions (os/cpu/libc) that don't match the current system: ${tmpModulePath}`));
+                    qcb();
+                });
+            });
+            queue.defer(renameWithFallback.bind(null, tmpModulePath, cachedAt));
+            queue.defer(renameWithFallback.bind(null, path.join(tmp, 'node_modules'), path.join(cachedAt, 'node_modules')));
+            // Write .ready marker after both renames succeed
+            queue.defer((cb)=>fs.writeFile(readyPath, '', 'utf8', (err)=>cb(err)));
+            queue.await((queueErr)=>{
+                // Clean up temp directory whether installed or not
+                safeRm(tmp, ()=>cb(queueErr));
+            });
+        }
+    });
+}

package/dist/esm/lib/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/cache.ts"],"sourcesContent":["import fs from 'fs';\nimport { safeRm } from 'fs-remove-compat';\nimport lockfile from 'lockfile';\nimport mkdirp from 'mkdirp-classic';\nimport path from 'path';\nimport Queue from 'queue-cb';\nimport tempSuffix from 'temp-suffix';\nimport type { EnsureCachedCallback } from '../types.ts';\nimport getSpecifier from './getSpecifier.ts';\nimport install from './install.ts';\nimport parse from './parseInstallString.ts';\nimport renameWithFallback from './renameWithFallback.ts';\n\nconst LOCK_OPTIONS = {\n  wait: 600000, // Wait up to 10 minutes for lock (npm installs can be slow)\n  pollPeriod: 100, // Check every 100ms\n  stale: 660000, // Consider locks stale after 11 minutes (must be > wait)\n  retries: 3, // Retry 3 times on transient errors\n};\n\nexport default function ensureCached(installString: string, cachePath: string, callback: EnsureCachedCallback) {\n  getSpecifier(installString, (err, specifier) => {\n    if (err) return callback(err);\n    // biome-ignore lint/style/noNonNullAssertion: getSpecifier always sets the specifier when err is null\n    const cachedAt = path.join(cachePath, specifier!);\n    const lockPath = `${cachedAt}.lock`;\n    const readyPath = path.join(cachedAt, '.ready');\n    const { name } = parse(installString);\n\n    // Check if already cached AND complete (fast path, no lock needed)\n    fs.stat(readyPath, (readyErr: NodeJS.ErrnoException | null) => {\n      if (!readyErr) return callback(undefined, cachedAt); // Valid cache\n\n      // Not cached or incomplete - acquire lock and install\n      doLockedInstall();\n    });\n\n    function doLockedInstall() {\n      // Ensure lock file's parent directory exists (handles scoped packages like @scope/pkg)\n      mkdirp(path.dirname(lockPath), (mkdirErr: Error | null) => {\n        if (mkdirErr) return callback(mkdirErr);\n\n        const startTime = Date.now();\n\n        // Retry loop for Windows EPERM - treat it like EEXIST (lock held by another process)\n        function tryLock(cb: (err?: Error | null) => void) {\n          lockfile.lock(lockPath, { ...LOCK_OPTIONS }, (lockErr: Error | null) => {\n            if (lockErr && (lockErr as NodeJS.ErrnoException).code === 'EPERM' && Date.now() - startTime < LOCK_OPTIONS.wait) {\n              setTimeout(() => tryLock(cb), LOCK_OPTIONS.pollPeriod);\n              return;\n            }\n            cb(lockErr);\n          });\n        }\n\n        tryLock((lockErr) => {\n          if (lockErr) return callback(lockErr);\n\n          // Single exit point - always unlock before calling back\n          function done(err?: Error | null) {\n            lockfile.unlock(lockPath, () => callback(err, err ? undefined : cachedAt));\n          }\n\n          // Re-check cache (another process may have completed while we waited for lock)\n          fs.stat(readyPath, (readyErr: NodeJS.ErrnoException | null) => {\n            if (!readyErr) return done(); // Cache appeared while we waited\n\n            // Clean up any incomplete cache before installing\n            safeRm(cachedAt, (rmErr) => {\n              if (rmErr) return done(rmErr);\n              doInstall(done);\n            });\n          });\n        });\n      });\n    }\n\n    function doInstall(cb: (err?: Error | null) => void) {\n      const tmp = `${cachedAt}-${tempSuffix()}`;\n      const tmpModulePath = path.join(tmp, 'node_modules', ...name.split('/'));\n\n      const queue = new Queue(1);\n      queue.defer((cb) => mkdirp(tmp, (err) => cb(err)));\n      queue.defer((cb) => fs.writeFile(path.join(tmp, 'package.json'), '{}', 'utf8', (err) => cb(err)));\n      // biome-ignore lint/style/noNonNullAssertion: getSpecifier always sets the specifier when err is null\n      queue.defer(install.bind(null, specifier!, tmp));\n      queue.defer((qcb) => {\n        // Verify npm actually created the package directory - npm may silently skip\n        // installation (exit 0) when platform doesn't match (os/cpu/libc fields)\n        fs.stat(tmpModulePath, (statErr) => {\n          if (statErr) return qcb(new Error(`Package directory not created by npm. This may happen when the package has platform restrictions (os/cpu/libc) that don't match the current system: ${tmpModulePath}`));\n          qcb();\n        });\n      });\n      queue.defer(renameWithFallback.bind(null, tmpModulePath, cachedAt));\n      queue.defer(renameWithFallback.bind(null, path.join(tmp, 'node_modules'), path.join(cachedAt, 'node_modules')));\n      // Write .ready marker after both renames succeed\n      queue.defer((cb) => fs.writeFile(readyPath, '', 'utf8', (err) => cb(err)));\n      queue.await((queueErr) => {\n        // Clean up temp directory whether installed or not\n        safeRm(tmp, () => cb(queueErr));\n      });\n    }\n  });\n}\n"],"names":["fs","safeRm","lockfile","mkdirp","path","Queue","tempSuffix","getSpecifier","install","parse","renameWithFallback","LOCK_OPTIONS","wait","pollPeriod","stale","retries","ensureCached","installString","cachePath","callback","err","specifier","cachedAt","join","lockPath","readyPath","name","stat","readyErr","undefined","doLockedInstall","dirname","mkdirErr","startTime","Date","now","tryLock","cb","lock","lockErr","code","setTimeout","done","unlock","rmErr","doInstall","tmp","tmpModulePath","split","queue","defer","writeFile","bind","qcb","statErr","Error","await","queueErr"],"mappings":"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"}

package/dist/esm/lib/clear.d.ts

@@ -0,0 +1,2 @@
+import type { CleanOptions } from '../types.js';
+export default function clear(_options?: CleanOptions): void;

package/dist/esm/lib/clear.js

@@ -0,0 +1,6 @@
+import { safeRmSync } from 'fs-remove-compat';
+import { DEFAULT_CACHE_PATH } from '../constants.js';
+export default function clear(_options) {
+    safeRmSync(DEFAULT_CACHE_PATH);
+    console.log(`Cleaned ${DEFAULT_CACHE_PATH}`);
+}

package/dist/esm/lib/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/clear.ts"],"sourcesContent":["import { safeRmSync } from 'fs-remove-compat';\nimport { DEFAULT_CACHE_PATH } from '../constants.ts';\n\nimport type { CleanOptions } from '../types.ts';\n\nexport default function clear(_options?: CleanOptions) {\n  safeRmSync(DEFAULT_CACHE_PATH);\n  console.log(`Cleaned ${DEFAULT_CACHE_PATH}`);\n}\n"],"names":["safeRmSync","DEFAULT_CACHE_PATH","clear","_options","console","log"],"mappings":"AAAA,SAASA,UAAU,QAAQ,mBAAmB;AAC9C,SAASC,kBAAkB,QAAQ,kBAAkB;AAIrD,eAAe,SAASC,MAAMC,QAAuB;IACnDH,WAAWC;IACXG,QAAQC,GAAG,CAAC,CAAC,QAAQ,EAAEJ,oBAAoB;AAC7C"}

package/dist/esm/lib/getSpecifier.d.ts

@@ -0,0 +1,2 @@
+import type { GetScopedSpecifiedCallback } from '../types.js';
+export default function getSpecifier(installString: string, callback: GetScopedSpecifiedCallback): void;

package/dist/esm/lib/getSpecifier.js

@@ -0,0 +1,18 @@
+import { getContent } from 'get-file-compat';
+import parseInstallString from './parseInstallString.js';
+export default function getSpecifier(installString, callback) {
+    const { name, version } = parseInstallString(installString);
+    if (version) return callback(undefined, installString);
+    // URL-encode the package name (handles scoped packages: @scope/pkg -> @scope%2Fpkg)
+    const encodedName = encodeURIComponent(name).replace(/%40/g, '@');
+    getContent(`https://registry.npmjs.org/${encodedName}/latest`, 'utf8', (err, res)=>{
+        if (err) return callback(err);
+        try {
+            var _ref;
+            const json = JSON.parse((_ref = res === null || res === void 0 ? void 0 : res.content) !== null && _ref !== void 0 ? _ref : 'null');
+            callback(undefined, `${name}@${json.version}`);
+        } catch (err) {
+            callback(err);
+        }
+    });
+}

package/dist/esm/lib/getSpecifier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/getSpecifier.ts"],"sourcesContent":["import { getContent } from 'get-file-compat';\nimport type { GetScopedSpecifiedCallback } from '../types.ts';\nimport parseInstallString from './parseInstallString.ts';\n\ninterface JSONPackage {\n  version: string;\n}\n\nexport default function getSpecifier(installString: string, callback: GetScopedSpecifiedCallback) {\n  const { name, version } = parseInstallString(installString);\n  if (version) return callback(undefined, installString);\n\n  // URL-encode the package name (handles scoped packages: @scope/pkg -> @scope%2Fpkg)\n  const encodedName = encodeURIComponent(name).replace(/%40/g, '@');\n  getContent(`https://registry.npmjs.org/${encodedName}/latest`, 'utf8', (err, res) => {\n    if (err) return callback(err);\n    try {\n      const json = JSON.parse(res?.content ?? 'null');\n      callback(undefined, `${name}@${(json as JSONPackage).version}`);\n    } catch (err) {\n      callback(err as Error);\n    }\n  });\n}\n"],"names":["getContent","parseInstallString","getSpecifier","installString","callback","name","version","undefined","encodedName","encodeURIComponent","replace","err","res","json","JSON","parse","content"],"mappings":"AAAA,SAASA,UAAU,QAAQ,kBAAkB;AAE7C,OAAOC,wBAAwB,0BAA0B;AAMzD,eAAe,SAASC,aAAaC,aAAqB,EAAEC,QAAoC;IAC9F,MAAM,EAAEC,IAAI,EAAEC,OAAO,EAAE,GAAGL,mBAAmBE;IAC7C,IAAIG,SAAS,OAAOF,SAASG,WAAWJ;IAExC,oFAAoF;IACpF,MAAMK,cAAcC,mBAAmBJ,MAAMK,OAAO,CAAC,QAAQ;IAC7DV,WAAW,CAAC,2BAA2B,EAAEQ,YAAY,OAAO,CAAC,EAAE,QAAQ,CAACG,KAAKC;QAC3E,IAAID,KAAK,OAAOP,SAASO;QACzB,IAAI;;YACF,MAAME,OAAOC,KAAKC,KAAK,SAACH,gBAAAA,0BAAAA,IAAKI,OAAO,uCAAI;YACxCZ,SAASG,WAAW,GAAGF,KAAK,CAAC,EAAE,AAACQ,KAAqBP,OAAO,EAAE;QAChE,EAAE,OAAOK,KAAK;YACZP,SAASO;QACX;IACF;AACF"}

package/dist/esm/lib/install.d.ts

@@ -0,0 +1,2 @@
+import type { InstallCallback } from '../types.js';
+export default function install(specifier: string, dest: string, callback: InstallCallback): void;

package/dist/esm/lib/install.js

@@ -0,0 +1,23 @@
+import spawn from 'cross-spawn-cb';
+import { bind } from 'node-version-call-local';
+import path from 'path';
+import url from 'url';
+const __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));
+const major = +process.versions.node.split('.')[0];
+const workerPath = path.join(__dirname, '..', '..', 'cjs', 'lib', 'install.js');
+function run(specifier, dest, callback) {
+    spawn('npm', [
+        'install',
+        specifier
+    ], {
+        cwd: dest
+    }, (err)=>{
+        err ? callback(err) : callback(undefined, path.join(dest, ...specifier.split('/')));
+    });
+}
+const worker = major > 0 ? run : bind('>0.12', workerPath, {
+    callbacks: true
+});
+export default function install(specifier, dest, callback) {
+    worker(specifier, dest, callback);
+}

package/dist/esm/lib/install.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/install.ts"],"sourcesContent":["import spawn from 'cross-spawn-cb';\nimport { bind } from 'node-version-call-local';\nimport path from 'path';\nimport url from 'url';\nimport type { InstallCallback } from '../types.ts';\n\nconst __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));\nconst major = +process.versions.node.split('.')[0];\nconst workerPath = path.join(__dirname, '..', '..', 'cjs', 'lib', 'install.js');\n\nfunction run(specifier: string, dest: string, callback: InstallCallback): void {\n  spawn('npm', ['install', specifier], { cwd: dest }, (err) => {\n    err ? callback(err) : callback(undefined, path.join(dest, ...specifier.split('/')));\n  });\n}\n\ntype installFunction = (specifier: string, dest: string, callback: InstallCallback) => void;\n\nconst worker = (major > 0 ? run : bind('>0.12', workerPath, { callbacks: true })) as installFunction;\n\nexport default function install(specifier: string, dest: string, callback: InstallCallback): void {\n  worker(specifier, dest, callback);\n}\n"],"names":["spawn","bind","path","url","__dirname","dirname","__filename","fileURLToPath","major","process","versions","node","split","workerPath","join","run","specifier","dest","callback","cwd","err","undefined","worker","callbacks","install"],"mappings":"AAAA,OAAOA,WAAW,iBAAiB;AACnC,SAASC,IAAI,QAAQ,0BAA0B;AAC/C,OAAOC,UAAU,OAAO;AACxB,OAAOC,SAAS,MAAM;AAGtB,MAAMC,YAAYF,KAAKG,OAAO,CAAC,OAAOC,eAAe,cAAcA,aAAaH,IAAII,aAAa,CAAC,YAAYJ,GAAG;AACjH,MAAMK,QAAQ,CAACC,QAAQC,QAAQ,CAACC,IAAI,CAACC,KAAK,CAAC,IAAI,CAAC,EAAE;AAClD,MAAMC,aAAaX,KAAKY,IAAI,CAACV,WAAW,MAAM,MAAM,OAAO,OAAO;AAElE,SAASW,IAAIC,SAAiB,EAAEC,IAAY,EAAEC,QAAyB;IACrElB,MAAM,OAAO;QAAC;QAAWgB;KAAU,EAAE;QAAEG,KAAKF;IAAK,GAAG,CAACG;QACnDA,MAAMF,SAASE,OAAOF,SAASG,WAAWnB,KAAKY,IAAI,CAACG,SAASD,UAAUJ,KAAK,CAAC;IAC/E;AACF;AAIA,MAAMU,SAAUd,QAAQ,IAAIO,MAAMd,KAAK,SAASY,YAAY;IAAEU,WAAW;AAAK;AAE9E,eAAe,SAASC,QAAQR,SAAiB,EAAEC,IAAY,EAAEC,QAAyB;IACxFI,OAAON,WAAWC,MAAMC;AAC1B"}

package/dist/esm/lib/parseInstallString.d.ts

@@ -0,0 +1,4 @@
+export default function parseInstallString(installString: string): {
+    name: string;
+    version: string | undefined;
+};

package/dist/esm/lib/parseInstallString.js

@@ -0,0 +1,14 @@
+export default function parseInstallString(installString) {
+    var _installParts_pop;
+    const installParts = installString.split('/');
+    const nameVersionParts = ((_installParts_pop = installParts.pop()) !== null && _installParts_pop !== void 0 ? _installParts_pop : '').split('@');
+    const version = nameVersionParts.length > 1 ? nameVersionParts.pop() : undefined;
+    const name = [
+        ...installParts,
+        nameVersionParts.join('@')
+    ].join('/');
+    return {
+        name,
+        version
+    };
+}

package/dist/esm/lib/parseInstallString.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/parseInstallString.ts"],"sourcesContent":["export default function parseInstallString(installString: string) {\n  const installParts = installString.split('/');\n  const nameVersionParts = (installParts.pop() ?? '').split('@');\n  const version = nameVersionParts.length > 1 ? nameVersionParts.pop() : undefined;\n  const name = [...installParts, nameVersionParts.join('@')].join('/');\n  return {\n    name,\n    version,\n  };\n}\n"],"names":["parseInstallString","installString","installParts","split","nameVersionParts","pop","version","length","undefined","name","join"],"mappings":"AAAA,eAAe,SAASA,mBAAmBC,aAAqB;QAEpCC;IAD1B,MAAMA,eAAeD,cAAcE,KAAK,CAAC;IACzC,MAAMC,mBAAmB,EAACF,oBAAAA,aAAaG,GAAG,gBAAhBH,+BAAAA,oBAAsB,IAAIC,KAAK,CAAC;IAC1D,MAAMG,UAAUF,iBAAiBG,MAAM,GAAG,IAAIH,iBAAiBC,GAAG,KAAKG;IACvE,MAAMC,OAAO;WAAIP;QAAcE,iBAAiBM,IAAI,CAAC;KAAK,CAACA,IAAI,CAAC;IAChE,OAAO;QACLD;QACAH;IACF;AACF"}

package/dist/esm/lib/renameWithFallback.d.ts

@@ -0,0 +1 @@
+export default function renameWithFallback(src: string, dest: string, callback: (err?: Error | null) => void): void;

package/dist/esm/lib/renameWithFallback.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+export default function renameWithFallback(src, dest, callback) {
+    fs.rename(src, dest, (err)=>{
+        if (!err) return callback();
+        // Another process may have already created dest - check if it exists
+        // On Windows, concurrent renames to the same destination throw EPERM
+        if (err.code === 'EEXIST' || err.code === 'ENOTEMPTY' || err.code === 'EPERM') {
+            fs.stat(dest, (statErr)=>{
+                if (!statErr) return callback(); // dest exists, race was won by another process
+                callback(err); // dest doesn't exist, actual error
+            });
+            return;
+        }
+        callback(err);
+    });
+}

package/dist/esm/lib/renameWithFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/lib/renameWithFallback.ts"],"sourcesContent":["import fs from 'fs';\n\nexport default function renameWithFallback(src: string, dest: string, callback: (err?: Error | null) => void): void {\n  fs.rename(src, dest, (err) => {\n    if (!err) return callback();\n\n    // Another process may have already created dest - check if it exists\n    // On Windows, concurrent renames to the same destination throw EPERM\n    if (err.code === 'EEXIST' || err.code === 'ENOTEMPTY' || err.code === 'EPERM') {\n      fs.stat(dest, (statErr) => {\n        if (!statErr) return callback(); // dest exists, race was won by another process\n        callback(err); // dest doesn't exist, actual error\n      });\n      return;\n    }\n\n    callback(err);\n  });\n}\n"],"names":["fs","renameWithFallback","src","dest","callback","rename","err","code","stat","statErr"],"mappings":"AAAA,OAAOA,QAAQ,KAAK;AAEpB,eAAe,SAASC,mBAAmBC,GAAW,EAAEC,IAAY,EAAEC,QAAsC;IAC1GJ,GAAGK,MAAM,CAACH,KAAKC,MAAM,CAACG;QACpB,IAAI,CAACA,KAAK,OAAOF;QAEjB,qEAAqE;QACrE,qEAAqE;QACrE,IAAIE,IAAIC,IAAI,KAAK,YAAYD,IAAIC,IAAI,KAAK,eAAeD,IAAIC,IAAI,KAAK,SAAS;YAC7EP,GAAGQ,IAAI,CAACL,MAAM,CAACM;gBACb,IAAI,CAACA,SAAS,OAAOL,YAAY,+CAA+C;gBAChFA,SAASE,MAAM,mCAAmC;YACpD;YACA;QACF;QAEAF,SAASE;IACX;AACF"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/dist/esm/types.d.ts

@@ -0,0 +1,9 @@
+export interface CleanOptions {
+    slient?: boolean;
+}
+export type GetScopedSpecifiedCallback = (err?: Error | null, installSpecifier?: string) => void;
+export type EnsureCachedCallback = (err?: Error | null, cachedAt?: string) => void;
+export type InstallCallback = (err?: Error | null, installedAt?: string) => void;
+export interface InstallOptions {
+    cachePath?: string;
+}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export { };

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/types.ts"],"sourcesContent":["export interface CleanOptions {\n  slient?: boolean;\n}\n\nexport type GetScopedSpecifiedCallback = (err?: Error | null, installSpecifier?: string) => void;\nexport type EnsureCachedCallback = (err?: Error | null, cachedAt?: string) => void;\nexport type InstallCallback = (err?: Error | null, installedAt?: string) => void;\n\nexport interface InstallOptions {\n  cachePath?: string;\n}\n"],"names":[],"mappings":"AAQA,WAEC"}

package/dist/esm/workers/async.d.ts

@@ -0,0 +1,2 @@
+import type { InstallCallback, InstallOptions } from '../types.js';
+export default function installModule(installString: string, nodeModulesPath: string, options: InstallOptions, callback: InstallCallback): void;

package/dist/esm/workers/async.js

@@ -0,0 +1,50 @@
+var _process_env_OSTYPE;
+import fs from 'fs';
+import { safeRm } from 'fs-remove-compat';
+import mkdirp from 'mkdirp-classic';
+import path from 'path';
+import Queue from 'queue-cb';
+import tempSuffix from 'temp-suffix';
+import { DEFAULT_CACHE_PATH } from '../constants.js';
+import cache from '../lib/cache.js';
+import parseInstallString from '../lib/parseInstallString.js';
+const isWindows = process.platform === 'win32' || /^(msys|cygwin)$/.test((_process_env_OSTYPE = process.env.OSTYPE) !== null && _process_env_OSTYPE !== void 0 ? _process_env_OSTYPE : '');
+const symlinkType = isWindows ? 'junction' : 'dir';
+export default function installModule(installString, nodeModulesPath, options, callback) {
+    const cachePath = options.cachePath || DEFAULT_CACHE_PATH;
+    const { name } = parseInstallString(installString);
+    const dest = path.join(nodeModulesPath, ...name.split('/'));
+    fs.stat(dest, (err)=>{
+        if (!err) return callback(undefined, dest); // already installed
+        cache(installString, cachePath, (err, cachedAt)=>{
+            if (err) {
+                console.log(`Could not install: ${installString}. Message: ${err.message}`);
+                return callback(err);
+            }
+            // Use temp symlink + atomic rename to avoid cross-process race conditions
+            const tempDest = tempSuffix(dest);
+            const queue = new Queue(1);
+            queue.defer((cb)=>mkdirp(path.dirname(dest), (err)=>cb(err)));
+            // biome-ignore lint/style/noNonNullAssertion: cache always sets cachedAt when err is null
+            queue.defer((cb)=>fs.symlink(cachedAt, tempDest, symlinkType, (err)=>cb(err)));
+            queue.defer((cb)=>{
+                fs.rename(tempDest, dest, (err)=>{
+                    var _err_code;
+                    // If rename fails because dest exists, another process won - that's ok
+                    if (err && [
+                        'EEXIST',
+                        'ENOTEMPTY',
+                        'EPERM'
+                    ].indexOf((_err_code = err.code) !== null && _err_code !== void 0 ? _err_code : '') >= 0) {
+                        safeRm(tempDest, ()=>cb());
+                        return;
+                    }
+                    cb(err);
+                });
+            });
+            queue.await((err)=>{
+                err ? safeRm(tempDest, ()=>callback(err)) : callback(undefined, dest);
+            });
+        });
+    });
+}

package/dist/esm/workers/async.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/workers/async.ts"],"sourcesContent":["import fs from 'fs';\nimport { safeRm } from 'fs-remove-compat';\nimport mkdirp from 'mkdirp-classic';\nimport path from 'path';\nimport Queue from 'queue-cb';\nimport tempSuffix from 'temp-suffix';\nimport { DEFAULT_CACHE_PATH } from '../constants.ts';\nimport cache from '../lib/cache.ts';\nimport parseInstallString from '../lib/parseInstallString.ts';\n\nconst isWindows = process.platform === 'win32' || /^(msys|cygwin)$/.test(process.env.OSTYPE ?? '');\nconst symlinkType = isWindows ? 'junction' : 'dir';\n\nimport type { InstallCallback, InstallOptions } from '../types.ts';\n\nexport default function installModule(installString: string, nodeModulesPath: string, options: InstallOptions, callback: InstallCallback): void {\n  const cachePath = options.cachePath || DEFAULT_CACHE_PATH;\n  const { name } = parseInstallString(installString);\n  const dest = path.join(nodeModulesPath, ...name.split('/'));\n\n  fs.stat(dest, (err) => {\n    if (!err) return callback(undefined, dest); // already installed\n\n    cache(installString, cachePath, (err, cachedAt) => {\n      if (err) {\n        console.log(`Could not install: ${installString}. Message: ${err.message}`);\n        return callback(err);\n      }\n\n      // Use temp symlink + atomic rename to avoid cross-process race conditions\n      const tempDest = tempSuffix(dest);\n      const queue = new Queue(1);\n      queue.defer((cb) => mkdirp(path.dirname(dest), (err) => cb(err)));\n      // biome-ignore lint/style/noNonNullAssertion: cache always sets cachedAt when err is null\n      queue.defer((cb) => fs.symlink(cachedAt!, tempDest, symlinkType, (err) => cb(err)));\n      queue.defer((cb) => {\n        fs.rename(tempDest, dest, (err) => {\n          // If rename fails because dest exists, another process won - that's ok\n          if (err && ['EEXIST', 'ENOTEMPTY', 'EPERM'].indexOf(err.code ?? '') >= 0) {\n            safeRm(tempDest, () => cb());\n            return;\n          }\n          cb(err);\n        });\n      });\n      queue.await((err) => {\n        err ? safeRm(tempDest, () => callback(err)) : callback(undefined, dest);\n      });\n    });\n  });\n}\n"],"names":["process","fs","safeRm","mkdirp","path","Queue","tempSuffix","DEFAULT_CACHE_PATH","cache","parseInstallString","isWindows","platform","test","env","OSTYPE","symlinkType","installModule","installString","nodeModulesPath","options","callback","cachePath","name","dest","join","split","stat","err","undefined","cachedAt","console","log","message","tempDest","queue","defer","cb","dirname","symlink","rename","indexOf","code","await"],"mappings":"IAUyEA;AAVzE,OAAOC,QAAQ,KAAK;AACpB,SAASC,MAAM,QAAQ,mBAAmB;AAC1C,OAAOC,YAAY,iBAAiB;AACpC,OAAOC,UAAU,OAAO;AACxB,OAAOC,WAAW,WAAW;AAC7B,OAAOC,gBAAgB,cAAc;AACrC,SAASC,kBAAkB,QAAQ,kBAAkB;AACrD,OAAOC,WAAW,kBAAkB;AACpC,OAAOC,wBAAwB,+BAA+B;AAE9D,MAAMC,YAAYV,QAAQW,QAAQ,KAAK,WAAW,kBAAkBC,IAAI,EAACZ,sBAAAA,QAAQa,GAAG,CAACC,MAAM,cAAlBd,iCAAAA,sBAAsB;AAC/F,MAAMe,cAAcL,YAAY,aAAa;AAI7C,eAAe,SAASM,cAAcC,aAAqB,EAAEC,eAAuB,EAAEC,OAAuB,EAAEC,QAAyB;IACtI,MAAMC,YAAYF,QAAQE,SAAS,IAAId;IACvC,MAAM,EAAEe,IAAI,EAAE,GAAGb,mBAAmBQ;IACpC,MAAMM,OAAOnB,KAAKoB,IAAI,CAACN,oBAAoBI,KAAKG,KAAK,CAAC;IAEtDxB,GAAGyB,IAAI,CAACH,MAAM,CAACI;QACb,IAAI,CAACA,KAAK,OAAOP,SAASQ,WAAWL,OAAO,oBAAoB;QAEhEf,MAAMS,eAAeI,WAAW,CAACM,KAAKE;YACpC,IAAIF,KAAK;gBACPG,QAAQC,GAAG,CAAC,CAAC,mBAAmB,EAAEd,cAAc,WAAW,EAAEU,IAAIK,OAAO,EAAE;gBAC1E,OAAOZ,SAASO;YAClB;YAEA,0EAA0E;YAC1E,MAAMM,WAAW3B,WAAWiB;YAC5B,MAAMW,QAAQ,IAAI7B,MAAM;YACxB6B,MAAMC,KAAK,CAAC,CAACC,KAAOjC,OAAOC,KAAKiC,OAAO,CAACd,OAAO,CAACI,MAAQS,GAAGT;YAC3D,0FAA0F;YAC1FO,MAAMC,KAAK,CAAC,CAACC,KAAOnC,GAAGqC,OAAO,CAACT,UAAWI,UAAUlB,aAAa,CAACY,MAAQS,GAAGT;YAC7EO,MAAMC,KAAK,CAAC,CAACC;gBACXnC,GAAGsC,MAAM,CAACN,UAAUV,MAAM,CAACI;wBAE2BA;oBADpD,uEAAuE;oBACvE,IAAIA,OAAO;wBAAC;wBAAU;wBAAa;qBAAQ,CAACa,OAAO,EAACb,YAAAA,IAAIc,IAAI,cAARd,uBAAAA,YAAY,OAAO,GAAG;wBACxEzB,OAAO+B,UAAU,IAAMG;wBACvB;oBACF;oBACAA,GAAGT;gBACL;YACF;YACAO,MAAMQ,KAAK,CAAC,CAACf;gBACXA,MAAMzB,OAAO+B,UAAU,IAAMb,SAASO,QAAQP,SAASQ,WAAWL;YACpE;QACF;IACF;AACF"}

package/dist/esm/workers/sync.d.ts

@@ -0,0 +1 @@
+export default function installModuleSync(installString: string, nodeModulesPath: string, options?: object): string | undefined;

package/dist/esm/workers/sync.js

@@ -0,0 +1,14 @@
+import Module from 'module';
+import path from 'path';
+import url from 'url';
+const _require = typeof require === 'undefined' ? Module.createRequire(import.meta.url) : require;
+const __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));
+// Worker MUST always load from dist/cjs/ for old Node compatibility (works from both cjs and esm)
+const workerPath = path.join(__dirname, '..', '..', 'cjs', 'workers', 'async.js');
+let functionExec = null; // break dependencies
+export default function installModuleSync(installString, nodeModulesPath, options) {
+    if (!functionExec) functionExec = _require('function-exec-sync');
+    return functionExec === null || functionExec === void 0 ? void 0 : functionExec({
+        callbacks: true
+    }, workerPath, installString, nodeModulesPath, options);
+}

package/dist/esm/workers/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/install-module-linked-compat/src/workers/sync.ts"],"sourcesContent":["import Module from 'module';\nimport path from 'path';\nimport url from 'url';\n\nconst _require = typeof require === 'undefined' ? Module.createRequire(import.meta.url) : require;\nconst __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));\n\n// Worker MUST always load from dist/cjs/ for old Node compatibility (works from both cjs and esm)\nconst workerPath = path.join(__dirname, '..', '..', 'cjs', 'workers', 'async.js');\n\nlet functionExec: ((opts: object, ...args: unknown[]) => unknown) | null = null; // break dependencies\nexport default function installModuleSync(installString: string, nodeModulesPath: string, options?: object): string | undefined {\n  if (!functionExec) functionExec = _require('function-exec-sync');\n  return functionExec?.({ callbacks: true }, workerPath, installString, nodeModulesPath, options) as string | undefined;\n}\n"],"names":["Module","path","url","_require","require","createRequire","__dirname","dirname","__filename","fileURLToPath","workerPath","join","functionExec","installModuleSync","installString","nodeModulesPath","options","callbacks"],"mappings":"AAAA,OAAOA,YAAY,SAAS;AAC5B,OAAOC,UAAU,OAAO;AACxB,OAAOC,SAAS,MAAM;AAEtB,MAAMC,WAAW,OAAOC,YAAY,cAAcJ,OAAOK,aAAa,CAAC,YAAYH,GAAG,IAAIE;AAC1F,MAAME,YAAYL,KAAKM,OAAO,CAAC,OAAOC,eAAe,cAAcA,aAAaN,IAAIO,aAAa,CAAC,YAAYP,GAAG;AAEjH,kGAAkG;AAClG,MAAMQ,aAAaT,KAAKU,IAAI,CAACL,WAAW,MAAM,MAAM,OAAO,WAAW;AAEtE,IAAIM,eAAuE,MAAM,qBAAqB;AACtG,eAAe,SAASC,kBAAkBC,aAAqB,EAAEC,eAAuB,EAAEC,OAAgB;IACxG,IAAI,CAACJ,cAAcA,eAAeT,SAAS;IAC3C,OAAOS,yBAAAA,mCAAAA,aAAe;QAAEK,WAAW;IAAK,GAAGP,YAAYI,eAAeC,iBAAiBC;AACzF"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "install-module-linked-compat",
+  "version": "0.1.0",
+  "description": "Installs and symlinks a module into node_modules",
+  "keywords": [
+    "npm",
+    "install",
+    "module",
+    "cache",
+    "symlink",
+    "link"
+  ],
+  "homepage": "https://github.com/kmalakoff/install-module-linked-compat#README.md",
+  "bugs": {
+    "url": "https://github.com/kmalakoff/install-module-linked-compat/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/kmalakoff/install-module-linked-compat.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Kevin Malakoff",
+    "email": "kmalakoff@gmail.com",
+    "url": "https://github.com/kmalakoff"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/cjs/index.js",
+  "source": "src/index.ts",
+  "types": "dist/cjs/index.d.ts",
+  "bin": {
+    "iml-compat": "bin/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsds build",
+    "format": "tsds format",
+    "prepublishOnly": "tsds validate",
+    "test": "tsds test:node --no-timeouts",
+    "test:engines": "nvu engines tsds test:node --no-timeouts",
+    "version": "tsds version"
+  },
+  "dependencies": {
+    "cross-spawn-cb": "^3.0.0",
+    "exit-compat": "^1.0.0",
+    "fs-remove-compat": "^1.0.0",
+    "get-file-compat": "^2.0.0",
+    "getopts-compat": "^2.2.5",
+    "homedir-polyfill": "^1.0.3",
+    "lockfile": "^1.0.4",
+    "mkdirp-classic": "^0.5.2",
+    "node-version-call-local": "^1.0.0",
+    "queue-cb": "^1.0.0",
+    "temp-suffix": "^1.0.10"
+  },
+  "devDependencies": {
+    "@types/lockfile": "^1.0.4",
+    "@types/mocha": "*",
+    "@types/node": "*",
+    "node-version-use": "*",
+    "pinkie-promise": "*",
+    "ts-dev-stack": "*",
+    "tsds-config": "*"
+  },
+  "engines": {
+    "node": ">=0.8"
+  },
+  "allowScripts": {
+    "node-filename-to-dist-paths": true,
+    "node-semvers": true,
+    "node-version-use": true,
+    "thread-sleep-compat": true
+  }
+}