@vltpkg/pick-manifest 1.0.0-rc.13 → 1.0.0-rc.15

package/dist/index.d.ts

@@ -7,8 +7,9 @@ export type PickManifestOptions = {
     'node-version'?: string;
     os?: string;
     arch?: string;
+    libc?: string;
 };
-export type Manifestish = Pick<Manifest, 'engines' | 'os' | 'cpu'> | Pick<RevDocEntry, 'engines' | 'os' | 'cpu'>;
+export type Manifestish = Pick<Manifest, 'engines' | 'os' | 'cpu' | 'libc'> | Pick<RevDocEntry, 'engines' | 'os' | 'cpu' | 'libc'>;
 export type Packumentish = Packument | RevDoc;
 export type PickManifestish<T extends Packumentish> = T extends RevDoc ? RevDocEntry : Manifest;
 export type ManiCheck<T extends Packumentish> = {
@@ -19,10 +20,34 @@ export type ManiCheck<T extends Packumentish> = {
     mani: PickManifestish<T>;
 };
 /**
- * Call with a manifest and the node version and process platform/arch
+ * Path to the ldd binary used for filesystem-based libc detection.
+ */
+export declare const LDD_PATH = "/usr/bin/ldd";
+/**
+ * Detect libc family by reading the /usr/bin/ldd file.
+ * Returns 'glibc', 'musl', null (detection ran but unknown)
+ * or undefined (file not readable).
+ */
+export declare const getFamilyFromFilesystem: () => string | null | undefined;
+/**
+ * Detect libc family by using process.report.getReport().
+ * Returns 'glibc', 'musl', or null if detection fails.
+ */
+export declare const getFamilyFromReport: () => string | null;
+/** Reset the cached libc detection result. For testing only. */
+export declare const resetLibcCache: () => void;
+/**
+ * Detect the libc family (glibc or musl) on Linux systems.
+ * First tries filesystem-based detection (/usr/bin/ldd),
+ * then falls back to process.report.
+ * Returns undefined on non-Linux platforms or if detection fails.
+ */
+export declare const detectLibc: () => string | undefined;
+/**
+ * Call with a manifest and the node version and process platform/arch/libc
  * to check whether a version is suitable for the current platform.
  */
-export declare const platformCheck: (mani: Manifestish, nodeVersion: Version | string, wantOs?: string, wantArch?: string) => boolean;
+export declare const platformCheck: (mani: Manifestish, nodeVersion: Version | string, wantOs?: string, wantArch?: string, wantLibc?: string) => boolean;
 /**
  * Choose the most appropriate manifest from a packument.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,EAEL,OAAO,EAER,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAEnC,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACZ,MAAM,eAAe,CAAA;AAItB,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GACnB,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,GACxC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,CAAA;AAC/C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAA;AAC7C,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,IAChD,CAAC,SAAS,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAC3C,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CACzB,CAAA;AAwCD;;;GAGG;AACH,eAAO,MAAM,aAAa,SAClB,WAAW,eACJ,OAAO,GAAG,MAAM,WACpB,MAAM,aACJ,MAAM,KAChB,OAWF,CAAA;AAoBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EACjD,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,EAC7B,IAAI,GAAE,mBAAwB,GAC7B,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAgJhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,EAEL,OAAO,EAER,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAEnC,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACZ,MAAM,eAAe,CAAA;AAKtB,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GACnB,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,GACjD,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,CAAA;AACxD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAA;AAC7C,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,IAChD,CAAC,SAAS,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAC3C,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CACzB,CAAA;AA6CD;;GAEG;AACH,eAAO,MAAM,QAAQ,iBAAiB,CAAA;AAEtC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAChC,MAAM,GACN,IAAI,GACJ,SAiBH,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,IA8B/C,CAAA;AASD,gEAAgE;AAChE,eAAO,MAAM,cAAc,QAAO,IAEjC,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAO,MAAM,GAAG,SAwBtC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,SAClB,WAAW,eACJ,OAAO,GAAG,MAAM,WACpB,MAAM,aACJ,MAAM,aACN,MAAM,KAChB,OAqBF,CAAA;AAqBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EACjD,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,EAC7B,IAAI,GAAE,mBAAwB,GAC7B,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAsJhC"}

package/dist/index.js

@@ -2,6 +2,7 @@ import { error } from '@vltpkg/error-cause';
 import { parse, Range, satisfies, Version, isRange, } from '@vltpkg/semver';
 import { Spec } from '@vltpkg/spec';
 import { isSpec } from '@vltpkg/spec/browser';
+import { readFileSync } from 'node:fs';
 const parsedNodeVersion = Version.parse(process.version);
 const isBefore = (version, before, verTimes) => {
     if (!verTimes || !version || !before)
@@ -38,12 +39,107 @@ const checkList = (value, list) => {
     }
     return match || negated === list.length;
 };
+/* c8 ignore start - Linux-only helper */
+const isMusl = (file) => file.includes('libc.musl-') || file.includes('ld-musl-');
+/* c8 ignore stop */
 /**
- * Call with a manifest and the node version and process platform/arch
+ * Path to the ldd binary used for filesystem-based libc detection.
+ */
+export const LDD_PATH = '/usr/bin/ldd';
+/**
+ * Detect libc family by reading the /usr/bin/ldd file.
+ * Returns 'glibc', 'musl', null (detection ran but unknown)
+ * or undefined (file not readable).
+ */
+export const getFamilyFromFilesystem = () => {
+    /* c8 ignore start - Linux-only detection */
+    try {
+        const content = readFileSync(LDD_PATH, 'utf-8');
+        if (content.includes('musl')) {
+            return 'musl';
+        }
+        if (content.includes('GNU C Library')) {
+            return 'glibc';
+        }
+        // File exists but content unrecognized
+        return null;
+    }
+    catch {
+        // File not readable, return undefined to signal fallback needed
+        return undefined;
+    }
+    /* c8 ignore stop */
+};
+/**
+ * Detect libc family by using process.report.getReport().
+ * Returns 'glibc', 'musl', or null if detection fails.
+ */
+export const getFamilyFromReport = () => {
+    /* c8 ignore start - Linux-only detection */
+    try {
+        const processReport = process.report;
+        const originalExclude = processReport.excludeNetwork === true;
+        processReport.excludeNetwork = true;
+        const report = processReport.getReport();
+        processReport.excludeNetwork = originalExclude;
+        if (report?.header?.glibcRuntimeVersion) {
+            return 'glibc';
+        }
+        if (Array.isArray(report?.sharedObjects) &&
+            report.sharedObjects.some(isMusl)) {
+            return 'musl';
+        }
+    }
+    catch {
+        // detection failed
+    }
+    return null;
+    /* c8 ignore stop */
+};
+/**
+ * Cached libc family detection result.
+ * null means detection ran but couldn't determine, undefined means not cached yet.
+ */
+let cachedLibcFamily = undefined;
+/* c8 ignore start - test helper */
+/** Reset the cached libc detection result. For testing only. */
+export const resetLibcCache = () => {
+    cachedLibcFamily = undefined;
+};
+/* c8 ignore stop */
+/**
+ * Detect the libc family (glibc or musl) on Linux systems.
+ * First tries filesystem-based detection (/usr/bin/ldd),
+ * then falls back to process.report.
+ * Returns undefined on non-Linux platforms or if detection fails.
+ */
+export const detectLibc = () => {
+    /* c8 ignore start - Linux-only detection */
+    // Return cached result if available (null means detection ran but failed)
+    if (cachedLibcFamily !== undefined) {
+        return cachedLibcFamily ?? undefined;
+    }
+    // libc checks only work on linux
+    if (process.platform !== 'linux') {
+        cachedLibcFamily = null;
+        return undefined;
+    }
+    // Try filesystem detection first
+    let family = getFamilyFromFilesystem();
+    // If filesystem detection didn't work, fall back to process.report
+    if (!family) {
+        family = getFamilyFromReport();
+    }
+    cachedLibcFamily = family;
+    return family ?? undefined;
+    /* c8 ignore stop */
+};
+/**
+ * Call with a manifest and the node version and process platform/arch/libc
  * to check whether a version is suitable for the current platform.
  */
-export const platformCheck = (mani, nodeVersion, wantOs, wantArch) => {
-    const { engines, os, cpu } = mani;
+export const platformCheck = (mani, nodeVersion, wantOs, wantArch, wantLibc) => {
+    const { engines, os, cpu, libc } = mani;
     if (engines) {
         const { node } = engines;
         if (node && !satisfies(nodeVersion, node, true)) {
@@ -54,16 +150,28 @@ export const platformCheck = (mani, nodeVersion, wantOs, wantArch) => {
         return false;
     if (wantArch && !checkList(wantArch, cpu))
         return false;
+    // libc checks only apply when the package specifies libc requirements
+    if (libc) {
+        /* c8 ignore start - system specific */
+        // if wantLibc is not provided, detect it
+        const libcFamily = wantLibc ?? detectLibc();
+        // if libc can't be determined, fail the check (can't install libc-specific packages)
+        if (!libcFamily)
+            return false;
+        if (!checkList(libcFamily, libc))
+            return false;
+        /* c8 ignore stop */
+    }
     return true;
 };
-const versionOk = (packument, version, nodeVersion, os, arch, before) => {
+const versionOk = (packument, version, nodeVersion, os, arch, libc, before) => {
     const mani = packument.versions[version];
     /* c8 ignore next */
     if (!mani)
         return false;
     const { time } = packument;
     return (isBefore(version, before, time) &&
-        platformCheck(mani, nodeVersion, os, arch));
+        platformCheck(mani, nodeVersion, os, arch, libc));
 };
 /**
  * Choose the most appropriate manifest from a packument.
@@ -73,10 +181,12 @@ const versionOk = (packument, version, nodeVersion, os, arch, before) => {
  * is fine.
  */
 export function pickManifest(packument, wanted, opts = {}) {
-    const { tag = 'latest', before, 'node-version': nodeVersion, os = process.platform, arch = process.arch, } = opts;
+    const { tag = 'latest', before, 'node-version': nodeVersion, os = process.platform, arch = process.arch, libc, } = opts;
     const nv = !nodeVersion ? parsedNodeVersion : Version.parse(nodeVersion);
+    // detect libc if not provided
+    const libcFamily = libc ?? detectLibc();
     // cast since 'time' might not be present on minified packuments
-    const { name, time: verTimes, versions = {}, 'dist-tags': distTags = {}, } = packument;
+    const { name, time: verTimes, versions, 'dist-tags': distTags, } = packument;
     const time = before && verTimes ? +new Date(before) : Infinity;
     let range = undefined;
     let spec = undefined;
@@ -106,7 +216,8 @@ export function pickManifest(packument, wanted, opts = {}) {
         // we use that.  Otherwise, we get the highest precedence version
         // prior to the dist-tag.
         const mani = versions[ver];
-        if (mani && versionOk(packument, ver, nv, os, arch, time)) {
+        if (mani &&
+            versionOk(packument, ver, nv, os, arch, libcFamily, time)) {
             return mani;
         }
         else {
@@ -122,7 +233,7 @@ export function pickManifest(packument, wanted, opts = {}) {
     const defTagVersion = defaultVer ? Version.parse(defaultVer) : undefined;
     if (defaultVer &&
         (range.isAny || defTagVersion?.satisfies(range)) &&
-        versionOk(packument, defaultVer, nv, os, arch, time)) {
+        versionOk(packument, defaultVer, nv, os, arch, libcFamily, time)) {
         return versions[defaultVer];
     }
     // ok, actually have to scan the list
@@ -143,7 +254,7 @@ export function pickManifest(packument, wanted, opts = {}) {
         const mc = {
             version,
             deprecated: !!mani.deprecated,
-            platform: platformCheck(mani, nv, os, arch),
+            platform: platformCheck(mani, nv, os, arch, libcFamily),
             prerelease: !!version.prerelease?.length,
             mani,
         };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport {\n  parse,\n  Range,\n  satisfies,\n  Version,\n  isRange,\n} from '@vltpkg/semver'\nimport { Spec } from '@vltpkg/spec'\nimport { isSpec } from '@vltpkg/spec/browser'\nimport type {\n  Manifest,\n  Packument,\n  RevDoc,\n  RevDocEntry,\n} from '@vltpkg/types'\n\nconst parsedNodeVersion = Version.parse(process.version)\n\nexport type PickManifestOptions = {\n  tag?: string\n  before?: Date | number | string\n  'node-version'?: string\n  os?: string\n  arch?: string\n}\n\nexport type Manifestish =\n  | Pick<Manifest, 'engines' | 'os' | 'cpu'>\n  | Pick<RevDocEntry, 'engines' | 'os' | 'cpu'>\nexport type Packumentish = Packument | RevDoc\nexport type PickManifestish<T extends Packumentish> =\n  T extends RevDoc ? RevDocEntry : Manifest\nexport type ManiCheck<T extends Packumentish> = {\n  version: Version\n  deprecated: boolean\n  platform: boolean\n  prerelease: boolean\n  mani: PickManifestish<T>\n}\n\nconst isBefore = (\n  version: string,\n  before?: number,\n  verTimes?: Record<string, string>,\n): boolean => {\n  if (!verTimes || !version || !before) return true\n  const time = version && verTimes[version]\n  return !!time && Date.parse(time) <= before\n}\n\nconst checkList = (value: string, list?: string[] | string) => {\n  if (typeof list === 'string') {\n    list = [list]\n  }\n  // invalid list is equivalent to 'any'\n  if (!Array.isArray(list)) return true\n  if (list.length === 1 && list[0] === 'any') {\n    return true\n  }\n  // match none of the negated values, and at least one of the\n  // non-negated values, if any are present.\n  let negated = 0\n  let match = false\n  for (const entry of list) {\n    const negate = entry.startsWith('!')\n    const test = negate ? entry.slice(1) : entry\n    if (negate) {\n      negated++\n      if (value === test) {\n        return false\n      }\n    } else {\n      match = match || value === test\n    }\n  }\n  return match || negated === list.length\n}\n\n/**\n * Call with a manifest and the node version and process platform/arch\n * to check whether a version is suitable for the current platform.\n */\nexport const platformCheck = (\n  mani: Manifestish,\n  nodeVersion: Version | string,\n  wantOs?: string,\n  wantArch?: string,\n): boolean => {\n  const { engines, os, cpu } = mani\n  if (engines) {\n    const { node } = engines\n    if (node && !satisfies(nodeVersion, node, true)) {\n      return false\n    }\n  }\n  if (wantOs && !checkList(wantOs, os)) return false\n  if (wantArch && !checkList(wantArch, cpu)) return false\n  return true\n}\n\nconst versionOk = (\n  packument: Packumentish,\n  version: string,\n  nodeVersion: Version,\n  os: string,\n  arch: string,\n  before?: number,\n) => {\n  const mani = packument.versions[version]\n  /* c8 ignore next */\n  if (!mani) return false\n  const { time } = packument\n  return (\n    isBefore(version, before, time) &&\n    platformCheck(mani, nodeVersion, os, arch)\n  )\n}\n\n/**\n * Choose the most appropriate manifest from a packument.\n *\n * If `before` is set in the options, then the packument MUST\n * be a full non-minified Packument object. Otherwise, a minified packument\n * is fine.\n */\nexport function pickManifest<T extends Packumentish>(\n  packument: T,\n  wanted: Range | Spec | string,\n  opts: PickManifestOptions = {},\n): PickManifestish<T> | undefined {\n  const {\n    tag = 'latest',\n    before,\n    'node-version': nodeVersion,\n    os = process.platform,\n    arch = process.arch,\n  } = opts\n  const nv =\n    !nodeVersion ? parsedNodeVersion : Version.parse(nodeVersion)\n\n  // cast since 'time' might not be present on minified packuments\n  const {\n    name,\n    time: verTimes,\n    versions = {},\n    'dist-tags': distTags = {},\n  } = packument\n\n  const time = before && verTimes ? +new Date(before) : Infinity\n  let range: Range | undefined = undefined\n  let spec: Spec | undefined = undefined\n  if (typeof wanted === 'object') {\n    if (isSpec(wanted)) {\n      const f = wanted.final\n      range = f.range\n      spec = f\n    } else if (isRange(wanted)) {\n      range = wanted\n    }\n  } else {\n    spec = Spec.parse(`${name}@${wanted}`).final\n    range = spec.range\n  }\n\n  if (!range) {\n    if (!spec?.distTag) {\n      throw error(\n        'Only dist-tag or semver range specs are supported',\n        { spec },\n      )\n    }\n    // if there is an explicit dist tag, we must get that version.\n    const ver = distTags[spec.distTag]\n    if (!ver) return undefined\n    // if the version in the dist-tags is before the before date, then\n    // we use that.  Otherwise, we get the highest precedence version\n    // prior to the dist-tag.\n    const mani = versions[ver]\n    if (mani && versionOk(packument, ver, nv, os, arch, time)) {\n      return mani as PickManifestish<T>\n    } else {\n      range = new Range(`<=${ver}`)\n    }\n  }\n\n  if (range.isAny) range = new Range('*', true)\n\n  // if the range is *, then we prefer the 'latest' if available\n  // but skip this if it should be avoided, in that case we have\n  // to try a little harder.\n  const defaultVer = distTags[tag]\n  const defTagVersion =\n    defaultVer ? Version.parse(defaultVer) : undefined\n  if (\n    defaultVer &&\n    (range.isAny || defTagVersion?.satisfies(range)) &&\n    versionOk(packument, defaultVer, nv, os, arch, time)\n  ) {\n    return versions[defaultVer] as PickManifestish<T>\n  }\n\n  // ok, actually have to scan the list\n  const entries = Object.entries(versions) as [\n    string,\n    PickManifestish<T>,\n  ][]\n\n  if (!entries.length) {\n    return undefined\n  }\n\n  let found: ManiCheck<T> | undefined = undefined\n  let foundIsDefTag = false\n\n  for (const [ver, mani] of entries) {\n    if (time && verTimes && !isBefore(ver, time, verTimes)) {\n      continue\n    }\n    const version = parse(ver)\n    if (!version?.satisfies(range)) {\n      continue\n    }\n    const mc = {\n      version,\n      deprecated: !!mani.deprecated,\n      platform: platformCheck(mani, nv, os, arch),\n      prerelease: !!version.prerelease?.length,\n      mani,\n    }\n    if (!found) {\n      found = mc\n      if (defTagVersion?.equals(found.version)) {\n        foundIsDefTag = true\n      }\n      continue\n    }\n\n    const mok = !mc.deprecated && mc.platform\n    const fok = !found.deprecated && found.platform\n\n    if (mok !== fok) {\n      if (mok) {\n        found = mc\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (mc.platform !== found.platform) {\n      if (mc.platform) {\n        found = mc\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (mc.deprecated !== found.deprecated) {\n      if (!mc.deprecated) {\n        found = mc\n        /* c8 ignore next */\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (found.prerelease !== mc.prerelease) {\n      if (!mc.prerelease) {\n        found = mc\n        /* c8 ignore next */\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (defTagVersion?.equals(mc.version)) {\n      found = mc\n      foundIsDefTag = true\n    } else if (\n      mc.version.greaterThan(found.version) &&\n      !foundIsDefTag\n    ) {\n      found = mc\n    }\n  }\n  return found?.mani\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport {\n  parse,\n  Range,\n  satisfies,\n  Version,\n  isRange,\n} from '@vltpkg/semver'\nimport { Spec } from '@vltpkg/spec'\nimport { isSpec } from '@vltpkg/spec/browser'\nimport type {\n  Manifest,\n  Packument,\n  RevDoc,\n  RevDocEntry,\n} from '@vltpkg/types'\nimport { readFileSync } from 'node:fs'\n\nconst parsedNodeVersion = Version.parse(process.version)\n\nexport type PickManifestOptions = {\n  tag?: string\n  before?: Date | number | string\n  'node-version'?: string\n  os?: string\n  arch?: string\n  libc?: string\n}\n\nexport type Manifestish =\n  | Pick<Manifest, 'engines' | 'os' | 'cpu' | 'libc'>\n  | Pick<RevDocEntry, 'engines' | 'os' | 'cpu' | 'libc'>\nexport type Packumentish = Packument | RevDoc\nexport type PickManifestish<T extends Packumentish> =\n  T extends RevDoc ? RevDocEntry : Manifest\nexport type ManiCheck<T extends Packumentish> = {\n  version: Version\n  deprecated: boolean\n  platform: boolean\n  prerelease: boolean\n  mani: PickManifestish<T>\n}\n\nconst isBefore = (\n  version: string,\n  before?: number,\n  verTimes?: Record<string, string>,\n): boolean => {\n  if (!verTimes || !version || !before) return true\n  const time = version && verTimes[version]\n  return !!time && Date.parse(time) <= before\n}\n\nconst checkList = (value: string, list?: string[] | string) => {\n  if (typeof list === 'string') {\n    list = [list]\n  }\n  // invalid list is equivalent to 'any'\n  if (!Array.isArray(list)) return true\n  if (list.length === 1 && list[0] === 'any') {\n    return true\n  }\n  // match none of the negated values, and at least one of the\n  // non-negated values, if any are present.\n  let negated = 0\n  let match = false\n  for (const entry of list) {\n    const negate = entry.startsWith('!')\n    const test = negate ? entry.slice(1) : entry\n    if (negate) {\n      negated++\n      if (value === test) {\n        return false\n      }\n    } else {\n      match = match || value === test\n    }\n  }\n  return match || negated === list.length\n}\n\n/* c8 ignore start - Linux-only helper */\nconst isMusl = (file: string) =>\n  file.includes('libc.musl-') || file.includes('ld-musl-')\n/* c8 ignore stop */\n\n/**\n * Path to the ldd binary used for filesystem-based libc detection.\n */\nexport const LDD_PATH = '/usr/bin/ldd'\n\n/**\n * Detect libc family by reading the /usr/bin/ldd file.\n * Returns 'glibc', 'musl', null (detection ran but unknown)\n * or undefined (file not readable).\n */\nexport const getFamilyFromFilesystem = ():\n  | string\n  | null\n  | undefined => {\n  /* c8 ignore start - Linux-only detection */\n  try {\n    const content = readFileSync(LDD_PATH, 'utf-8')\n    if (content.includes('musl')) {\n      return 'musl'\n    }\n    if (content.includes('GNU C Library')) {\n      return 'glibc'\n    }\n    // File exists but content unrecognized\n    return null\n  } catch {\n    // File not readable, return undefined to signal fallback needed\n    return undefined\n  }\n  /* c8 ignore stop */\n}\n\n/**\n * Detect libc family by using process.report.getReport().\n * Returns 'glibc', 'musl', or null if detection fails.\n */\nexport const getFamilyFromReport = (): string | null => {\n  /* c8 ignore start - Linux-only detection */\n  try {\n    const processReport = process.report as {\n      excludeNetwork?: boolean\n      getReport: () => unknown\n    }\n    const originalExclude = processReport.excludeNetwork === true\n    processReport.excludeNetwork = true\n    const report = processReport.getReport() as\n      | {\n          header?: { glibcRuntimeVersion?: string }\n          sharedObjects?: string[]\n        }\n      | undefined\n    processReport.excludeNetwork = originalExclude\n    if (report?.header?.glibcRuntimeVersion) {\n      return 'glibc'\n    }\n    if (\n      Array.isArray(report?.sharedObjects) &&\n      report.sharedObjects.some(isMusl)\n    ) {\n      return 'musl'\n    }\n  } catch {\n    // detection failed\n  }\n  return null\n  /* c8 ignore stop */\n}\n\n/**\n * Cached libc family detection result.\n * null means detection ran but couldn't determine, undefined means not cached yet.\n */\nlet cachedLibcFamily: string | null | undefined = undefined\n\n/* c8 ignore start - test helper */\n/** Reset the cached libc detection result. For testing only. */\nexport const resetLibcCache = (): void => {\n  cachedLibcFamily = undefined\n}\n/* c8 ignore stop */\n\n/**\n * Detect the libc family (glibc or musl) on Linux systems.\n * First tries filesystem-based detection (/usr/bin/ldd),\n * then falls back to process.report.\n * Returns undefined on non-Linux platforms or if detection fails.\n */\nexport const detectLibc = (): string | undefined => {\n  /* c8 ignore start - Linux-only detection */\n  // Return cached result if available (null means detection ran but failed)\n  if (cachedLibcFamily !== undefined) {\n    return cachedLibcFamily ?? undefined\n  }\n\n  // libc checks only work on linux\n  if (process.platform !== 'linux') {\n    cachedLibcFamily = null\n    return undefined\n  }\n\n  // Try filesystem detection first\n  let family = getFamilyFromFilesystem()\n\n  // If filesystem detection didn't work, fall back to process.report\n  if (!family) {\n    family = getFamilyFromReport()\n  }\n\n  cachedLibcFamily = family\n  return family ?? undefined\n  /* c8 ignore stop */\n}\n\n/**\n * Call with a manifest and the node version and process platform/arch/libc\n * to check whether a version is suitable for the current platform.\n */\nexport const platformCheck = (\n  mani: Manifestish,\n  nodeVersion: Version | string,\n  wantOs?: string,\n  wantArch?: string,\n  wantLibc?: string,\n): boolean => {\n  const { engines, os, cpu, libc } = mani\n  if (engines) {\n    const { node } = engines\n    if (node && !satisfies(nodeVersion, node, true)) {\n      return false\n    }\n  }\n  if (wantOs && !checkList(wantOs, os)) return false\n  if (wantArch && !checkList(wantArch, cpu)) return false\n  // libc checks only apply when the package specifies libc requirements\n  if (libc) {\n    /* c8 ignore start - system specific */\n    // if wantLibc is not provided, detect it\n    const libcFamily = wantLibc ?? detectLibc()\n    // if libc can't be determined, fail the check (can't install libc-specific packages)\n    if (!libcFamily) return false\n    if (!checkList(libcFamily, libc)) return false\n    /* c8 ignore stop */\n  }\n  return true\n}\n\nconst versionOk = (\n  packument: Packumentish,\n  version: string,\n  nodeVersion: Version,\n  os: string,\n  arch: string,\n  libc: string | undefined,\n  before?: number,\n) => {\n  const mani = packument.versions[version]\n  /* c8 ignore next */\n  if (!mani) return false\n  const { time } = packument\n  return (\n    isBefore(version, before, time) &&\n    platformCheck(mani, nodeVersion, os, arch, libc)\n  )\n}\n\n/**\n * Choose the most appropriate manifest from a packument.\n *\n * If `before` is set in the options, then the packument MUST\n * be a full non-minified Packument object. Otherwise, a minified packument\n * is fine.\n */\nexport function pickManifest<T extends Packumentish>(\n  packument: T,\n  wanted: Range | Spec | string,\n  opts: PickManifestOptions = {},\n): PickManifestish<T> | undefined {\n  const {\n    tag = 'latest',\n    before,\n    'node-version': nodeVersion,\n    os = process.platform,\n    arch = process.arch,\n    libc,\n  } = opts\n  const nv =\n    !nodeVersion ? parsedNodeVersion : Version.parse(nodeVersion)\n  // detect libc if not provided\n  const libcFamily = libc ?? detectLibc()\n\n  // cast since 'time' might not be present on minified packuments\n  const {\n    name,\n    time: verTimes,\n    versions,\n    'dist-tags': distTags,\n  } = packument\n\n  const time = before && verTimes ? +new Date(before) : Infinity\n  let range: Range | undefined = undefined\n  let spec: Spec | undefined = undefined\n  if (typeof wanted === 'object') {\n    if (isSpec(wanted)) {\n      const f = wanted.final\n      range = f.range\n      spec = f\n    } else if (isRange(wanted)) {\n      range = wanted\n    }\n  } else {\n    spec = Spec.parse(`${name}@${wanted}`).final\n    range = spec.range\n  }\n\n  if (!range) {\n    if (!spec?.distTag) {\n      throw error(\n        'Only dist-tag or semver range specs are supported',\n        { spec },\n      )\n    }\n    // if there is an explicit dist tag, we must get that version.\n    const ver = distTags[spec.distTag]\n    if (!ver) return undefined\n    // if the version in the dist-tags is before the before date, then\n    // we use that.  Otherwise, we get the highest precedence version\n    // prior to the dist-tag.\n    const mani = versions[ver]\n    if (\n      mani &&\n      versionOk(packument, ver, nv, os, arch, libcFamily, time)\n    ) {\n      return mani as PickManifestish<T>\n    } else {\n      range = new Range(`<=${ver}`)\n    }\n  }\n\n  if (range.isAny) range = new Range('*', true)\n\n  // if the range is *, then we prefer the 'latest' if available\n  // but skip this if it should be avoided, in that case we have\n  // to try a little harder.\n  const defaultVer = distTags[tag]\n  const defTagVersion =\n    defaultVer ? Version.parse(defaultVer) : undefined\n  if (\n    defaultVer &&\n    (range.isAny || defTagVersion?.satisfies(range)) &&\n    versionOk(packument, defaultVer, nv, os, arch, libcFamily, time)\n  ) {\n    return versions[defaultVer] as PickManifestish<T>\n  }\n\n  // ok, actually have to scan the list\n  const entries = Object.entries(versions) as [\n    string,\n    PickManifestish<T>,\n  ][]\n\n  if (!entries.length) {\n    return undefined\n  }\n\n  let found: ManiCheck<T> | undefined = undefined\n  let foundIsDefTag = false\n\n  for (const [ver, mani] of entries) {\n    if (time && verTimes && !isBefore(ver, time, verTimes)) {\n      continue\n    }\n    const version = parse(ver)\n    if (!version?.satisfies(range)) {\n      continue\n    }\n    const mc = {\n      version,\n      deprecated: !!mani.deprecated,\n      platform: platformCheck(mani, nv, os, arch, libcFamily),\n      prerelease: !!version.prerelease?.length,\n      mani,\n    }\n    if (!found) {\n      found = mc\n      if (defTagVersion?.equals(found.version)) {\n        foundIsDefTag = true\n      }\n      continue\n    }\n\n    const mok = !mc.deprecated && mc.platform\n    const fok = !found.deprecated && found.platform\n\n    if (mok !== fok) {\n      if (mok) {\n        found = mc\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (mc.platform !== found.platform) {\n      if (mc.platform) {\n        found = mc\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (mc.deprecated !== found.deprecated) {\n      if (!mc.deprecated) {\n        found = mc\n        /* c8 ignore next */\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (found.prerelease !== mc.prerelease) {\n      if (!mc.prerelease) {\n        found = mc\n        /* c8 ignore next */\n        foundIsDefTag = !!defTagVersion?.equals(mc.version)\n      }\n    } else if (defTagVersion?.equals(mc.version)) {\n      found = mc\n      foundIsDefTag = true\n    } else if (\n      mc.version.greaterThan(found.version) &&\n      !foundIsDefTag\n    ) {\n      found = mc\n    }\n  }\n  return found?.mani\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/pick-manifest",
   "description": "Choose a manifest from a packument",
-  "version": "1.0.0-rc.13",
+  "version": "1.0.0-rc.15",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -9,10 +9,10 @@
   },
   "author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
   "dependencies": {
-    "@vltpkg/error-cause": "1.0.0-rc.13",
-    "@vltpkg/semver": "1.0.0-rc.13",
-    "@vltpkg/types": "1.0.0-rc.13",
-    "@vltpkg/spec": "1.0.0-rc.13"
+    "@vltpkg/error-cause": "1.0.0-rc.15",
+    "@vltpkg/semver": "1.0.0-rc.15",
+    "@vltpkg/spec": "1.0.0-rc.15",
+    "@vltpkg/types": "1.0.0-rc.15"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",