@red-hat-developer-hub/cli-module-install-dynamic-plugins 0.2.0

package/dist/lock-file.cjs.js

@@ -0,0 +1,100 @@
+'use strict';
+
+var node_fs = require('node:fs');
+var fs = require('node:fs/promises');
+var errors = require('./errors.cjs.js');
+var log = require('./log.cjs.js');
+
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceCompat(fs);
+
+const POLL_INTERVAL_MS = 1e3;
+const DEFAULT_LOCK_TIMEOUT_MS = 10 * 60 * 1e3;
+async function createLock(lockPath) {
+  const timeoutMs = parseLockTimeout(
+    process.env.DYNAMIC_PLUGINS_LOCK_TIMEOUT_MS
+  );
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    try {
+      await fs__namespace.writeFile(lockPath, String(process.pid), { flag: "wx" });
+      log.log(`======= Created lock file: ${lockPath}`);
+      return;
+    } catch (err) {
+      if (err.code !== "EEXIST") throw err;
+    }
+    if (Date.now() >= deadline) {
+      throw new errors.InstallException(
+        `Timed out after ${timeoutMs}ms waiting for lock file ${lockPath}. Another install may be stuck \u2014 remove the file manually to proceed.`
+      );
+    }
+    log.log(`======= Waiting for lock to be released: ${lockPath}`);
+    await waitForPath(lockPath, deadline);
+  }
+}
+function parseLockTimeout(raw) {
+  if (!raw) return DEFAULT_LOCK_TIMEOUT_MS;
+  const n = Number.parseInt(raw, 10);
+  return Number.isFinite(n) && n >= 1 ? n : DEFAULT_LOCK_TIMEOUT_MS;
+}
+async function removeLock(lockPath) {
+  try {
+    await fs__namespace.unlink(lockPath);
+    log.log(`======= Removed lock file: ${lockPath}`);
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+  }
+}
+function registerLockCleanup(lockPath) {
+  const cleanup = () => {
+    try {
+      node_fs.unlinkSync(lockPath);
+    } catch {
+    }
+  };
+  process.on("exit", cleanup);
+  process.on("SIGTERM", () => {
+    cleanup();
+    process.exit(0);
+  });
+  process.on("SIGINT", () => {
+    cleanup();
+    process.exit(130);
+  });
+}
+async function waitForPath(lockPath, deadline) {
+  for (; ; ) {
+    try {
+      await fs__namespace.access(lockPath);
+    } catch {
+      return;
+    }
+    if (Date.now() >= deadline) return;
+    await sleep(POLL_INTERVAL_MS);
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+exports.createLock = createLock;
+exports.registerLockCleanup = registerLockCleanup;
+exports.removeLock = removeLock;
+//# sourceMappingURL=lock-file.cjs.js.map

package/dist/lock-file.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.cjs.js","sources":["../src/lock-file.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { unlinkSync } from 'node:fs';\nimport * as fs from 'node:fs/promises';\nimport { InstallException } from './errors';\nimport { log } from './log';\n\nconst POLL_INTERVAL_MS = 1000;\nconst DEFAULT_LOCK_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes\n\n/**\n * Acquire an exclusive lock file. If the file exists we wait (polling every\n * second) until it disappears, then try to create it atomically with the\n * `wx` flag. Bounded by `DYNAMIC_PLUGINS_LOCK_TIMEOUT_MS` (default 10 min)\n * so a stale lock from a `kill -9`'d process doesn't wedge the init container\n * forever — override via env var.\n */\nexport async function createLock(lockPath: string): Promise<void> {\n  const timeoutMs = parseLockTimeout(\n    process.env.DYNAMIC_PLUGINS_LOCK_TIMEOUT_MS,\n  );\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    try {\n      await fs.writeFile(lockPath, String(process.pid), { flag: 'wx' });\n      log(`======= Created lock file: ${lockPath}`);\n      return;\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== 'EEXIST') throw err;\n    }\n    if (Date.now() >= deadline) {\n      throw new InstallException(\n        `Timed out after ${timeoutMs}ms waiting for lock file ${lockPath}. ` +\n          `Another install may be stuck — remove the file manually to proceed.`,\n      );\n    }\n    log(`======= Waiting for lock to be released: ${lockPath}`);\n    await waitForPath(lockPath, deadline);\n  }\n}\n\nfunction parseLockTimeout(raw: string | undefined): number {\n  if (!raw) return DEFAULT_LOCK_TIMEOUT_MS;\n  const n = Number.parseInt(raw, 10);\n  return Number.isFinite(n) && n >= 1 ? n : DEFAULT_LOCK_TIMEOUT_MS;\n}\n\nexport async function removeLock(lockPath: string): Promise<void> {\n  try {\n    await fs.unlink(lockPath);\n    log(`======= Removed lock file: ${lockPath}`);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n  }\n}\n\n/** Register sync best-effort cleanup on process exit / SIGTERM / SIGINT. */\nexport function registerLockCleanup(lockPath: string): void {\n  const cleanup = (): void => {\n    try {\n      unlinkSync(lockPath);\n    } catch {\n      /* lock already gone */\n    }\n  };\n  process.on('exit', cleanup);\n  process.on('SIGTERM', () => {\n    cleanup();\n    process.exit(0);\n  });\n  process.on('SIGINT', () => {\n    cleanup();\n    process.exit(130);\n  });\n}\n\nasync function waitForPath(lockPath: string, deadline: number): Promise<void> {\n  for (;;) {\n    try {\n      await fs.access(lockPath);\n    } catch {\n      return; // gone\n    }\n    if (Date.now() >= deadline) return;\n    await sleep(POLL_INTERVAL_MS);\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"names":["fs","log","InstallException","unlinkSync"],"mappings":"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"}

package/dist/log.cjs.js

@@ -0,0 +1,9 @@
+'use strict';
+
+function log(message) {
+  process.stdout.write(`${message}
+`);
+}
+
+exports.log = log;
+//# sourceMappingURL=log.cjs.js.map

package/dist/log.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.cjs.js","sources":["../src/log.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport function log(message: string): void {\n  process.stdout.write(`${message}\\n`);\n}\n"],"names":[],"mappings":";;AAeO,SAAS,IAAI,OAAA,EAAuB;AACzC,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,OAAO;AAAA,CAAI,CAAA;AACrC;;;;"}

package/dist/merger.cjs.js

@@ -0,0 +1,333 @@
+'use strict';
+
+require('node:fs/promises');
+require('yaml');
+var errors = require('./errors.cjs.js');
+var log = require('./log.cjs.js');
+var npmKey = require('./npm-key.cjs.js');
+var ociKey = require('./oci-key.cjs.js');
+var types = require('./types.cjs.js');
+var util = require('./util.cjs.js');
+
+function isForbiddenKey(key) {
+  return key === "__proto__" || key === "constructor" || key === "prototype";
+}
+function safeSet(dst, key, value) {
+  if (key === "__proto__" || key === "constructor" || key === "prototype")
+    return;
+  Object.defineProperty(dst, key, {
+    value,
+    writable: true,
+    enumerable: true,
+    configurable: true
+  });
+}
+function deepMerge(src, dst, prefix = "") {
+  for (const [key, value] of Object.entries(src)) {
+    if (isForbiddenKey(key)) continue;
+    const dstRecord = dst;
+    if (util.isPlainObject(value)) {
+      const existing = dstRecord[key];
+      const node = util.isPlainObject(existing) ? existing : {};
+      safeSet(dstRecord, key, node);
+      deepMerge(value, node, `${prefix}${key}.`);
+    } else {
+      if (key in dst && !isEqual(dstRecord[key], value)) {
+        throw new errors.InstallException(
+          `Config key '${prefix}${key}' defined differently for 2 dynamic plugins`
+        );
+      }
+      safeSet(dstRecord, key, value);
+    }
+  }
+  return dst;
+}
+async function mergePlugin(plugin, allPlugins, configFile, level, imageCache) {
+  if (typeof plugin.package !== "string") {
+    throw new errors.InstallException(
+      `content of the 'plugins.package' field must be a string in ${configFile}`
+    );
+  }
+  if (plugin.package.startsWith(types.OCI_PROTO)) {
+    await mergeOciPlugin(plugin, allPlugins, configFile, level, imageCache);
+  } else {
+    mergeNpmPlugin(plugin, allPlugins, configFile, level);
+  }
+}
+function mergeNpmPlugin(plugin, allPlugins, configFile, level) {
+  const key = npmKey.npmPluginKey(plugin.package);
+  doMerge(key, plugin, allPlugins, configFile, level);
+}
+async function mergeOciPlugin(plugin, allPlugins, configFile, level, imageCache) {
+  let parsed = await ociKey.ociPluginKey(plugin.package, imageCache);
+  if (parsed.inherit && parsed.resolvedPath === null) {
+    parsed = resolveInherit(plugin, allPlugins, parsed);
+  } else if (!plugin.package.includes("!") && parsed.resolvedPath) {
+    plugin.package = `${plugin.package}!${parsed.resolvedPath}`;
+  }
+  plugin.version = parsed.version;
+  const existing = allPlugins[parsed.pluginKey];
+  if (!existing) {
+    if (parsed.inherit) {
+      throw new errors.InstallException(
+        `ERROR: {{inherit}} tag is set and there is currently no resolved tag or digest for ${plugin.package} in ${configFile}.`
+      );
+    }
+    log.log(
+      `
+======= Adding new dynamic plugin configuration for version \`${parsed.version}\` of ${parsed.pluginKey}`
+    );
+    plugin.last_modified_level = level;
+    allPlugins[parsed.pluginKey] = plugin;
+    return;
+  }
+  log.log(`
+======= Overriding dynamic plugin configuration ${parsed.pluginKey}`);
+  if (existing.last_modified_level === level) {
+    throw new errors.InstallException(
+      `Duplicate plugin configuration for ${plugin.package} found in ${configFile}.`
+    );
+  }
+  if (!parsed.inherit) {
+    existing.package = plugin.package;
+    if (existing.version !== parsed.version) {
+      log.log(
+        `INFO: Overriding version for ${parsed.pluginKey} from \`${existing.version ?? ""}\` to \`${parsed.version}\``
+      );
+    }
+    existing.version = parsed.version;
+  }
+  copyPluginFields(plugin, existing, [
+    "package",
+    "version",
+    "last_modified_level"
+  ]);
+  existing.last_modified_level = level;
+}
+function resolveInherit(plugin, allPlugins, parsed) {
+  const prefix = `${parsed.pluginKey}:!`;
+  const matches = Object.keys(allPlugins).filter((k) => k.startsWith(prefix));
+  if (matches.length === 0) {
+    throw new errors.InstallException(
+      `Cannot use {{inherit}} for ${parsed.pluginKey}: no existing plugin configuration found. Ensure a plugin from this image is defined in an included file with an explicit version.`
+    );
+  }
+  if (matches.length > 1) {
+    const formatted = matches.map((m) => {
+      const baseVersion = allPlugins[m]?.version ?? "";
+      const registryPart2 = m.split(":!")[0] ?? "";
+      const pathPart = m.split(":!").at(-1) ?? "";
+      return `  - ${registryPart2}:${baseVersion}!${pathPart}`;
+    }).join("\n");
+    throw new errors.InstallException(
+      `Cannot use {{inherit}} for ${parsed.pluginKey}: multiple plugins from this image are defined in the included files:
+${formatted}
+Please specify which plugin configuration to inherit from using: ${parsed.pluginKey}:{{inherit}}!<plugin_path>`
+    );
+  }
+  const matchedKey = matches[0];
+  const basePlugin = allPlugins[matchedKey];
+  if (!basePlugin?.version) {
+    throw new errors.InstallException(
+      `Internal: inherited plugin ${matchedKey} has no version`
+    );
+  }
+  const version = basePlugin.version;
+  const resolvedPath = matchedKey.split(":!").at(-1) ?? "";
+  const registryPart = matchedKey.split(":!")[0] ?? "";
+  plugin.package = `${registryPart}:${version}!${resolvedPath}`;
+  log.log(
+    `
+======= Inheriting version \`${version}\` and plugin path \`${resolvedPath}\` for ${matchedKey}`
+  );
+  return { pluginKey: matchedKey, version, inherit: true, resolvedPath };
+}
+function doMerge(key, plugin, allPlugins, configFile, level) {
+  const existing = allPlugins[key];
+  if (!existing) {
+    log.log(`
+======= Adding new dynamic plugin configuration for ${key}`);
+    plugin.last_modified_level = level;
+    allPlugins[key] = plugin;
+    return;
+  }
+  log.log(`
+======= Overriding dynamic plugin configuration ${key}`);
+  if (existing.last_modified_level === level) {
+    throw new errors.InstallException(
+      `Duplicate plugin configuration for ${plugin.package} found in ${configFile}.`
+    );
+  }
+  copyPluginFields(plugin, existing, ["last_modified_level"]);
+  existing.last_modified_level = level;
+}
+function copyPluginFields(src, dst, skip) {
+  const skipSet = new Set(skip);
+  for (const [k, v] of Object.entries(src)) {
+    if (skipSet.has(k) || isForbiddenKey(k)) continue;
+    safeSet(dst, k, v);
+  }
+}
+function isEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== typeof b) return false;
+  if (Array.isArray(a) && Array.isArray(b)) return isArrayEqual(a, b);
+  if (util.isPlainObject(a) && util.isPlainObject(b)) return isObjectEqual(a, b);
+  return false;
+}
+function isArrayEqual(a, b) {
+  if (a.length !== b.length) return false;
+  return a.every((v, i) => isEqual(v, b[i]));
+}
+function isObjectEqual(a, b) {
+  const keysA = Object.keys(a);
+  if (keysA.length !== Object.keys(b).length) return false;
+  return keysA.every((k) => isEqual(a[k], b[k]));
+}
+function entryKeyOf(registry, path) {
+  return `${registry} ${path ?? ""}`;
+}
+function logInvalidOciFormat(pkg, sourceFile, disabled) {
+  if (!disabled) {
+    throw new errors.InstallException(
+      `oci package '${pkg}' is not in the expected format '${types.OCI_PROTO}<registry>:<tag>' or '${types.OCI_PROTO}<registry>@<algo>:<digest>' (optionally followed by '!<path>') in ${sourceFile} where <registry> may include a port (e.g. host:5000/path) and <algo> is one of ${types.RECOGNIZED_ALGORITHMS.join(", ")}`
+    );
+  }
+  log.log(
+    `WARNING: Skipping disabled OCI plugin with invalid format: '${pkg}' in ${sourceFile}. Expected format: '${types.OCI_PROTO}<registry>:<tag>' or '${types.OCI_PROTO}<registry>@<algo>:<digest>' (optionally followed by '!<path>') where <registry> may include a port (e.g. host:5000/path) and <algo> is one of ${types.RECOGNIZED_ALGORITHMS.join(", ")}`
+  );
+}
+function recordEntryState(state, registry, path, level, disabled, pkg, sourceFile) {
+  const key = entryKeyOf(registry, path);
+  const existing = state.perEntryState.get(key);
+  if (!existing) {
+    state.perEntryState.set(key, { disabled, level });
+    return true;
+  }
+  if (existing.level === level) {
+    const pathSuffix = path ? `!${path}` : "";
+    if (!disabled) {
+      throw new errors.InstallException(
+        `Duplicate OCI plugin configuration for ${registry}${pathSuffix} found at the same level in ${sourceFile}: ${pkg}`
+      );
+    }
+    log.log(
+      `WARNING: Skipping duplicate disabled OCI plugin configuration for ${registry}${pathSuffix} in ${sourceFile}`
+    );
+    return false;
+  }
+  if (level > existing.level) state.perEntryState.set(key, { disabled, level });
+  return true;
+}
+function recordRegistryPath(state, registry, path, sourceFile) {
+  if (!path) {
+    state.pathlessRegistries.set(registry, sourceFile);
+    return;
+  }
+  let bucket = state.definedPaths.get(registry);
+  if (!bucket) {
+    bucket = /* @__PURE__ */ new Map();
+    state.definedPaths.set(registry, bucket);
+  }
+  bucket.set(path, sourceFile);
+}
+function processOciEntry(state, plugin, level, sourceFile) {
+  const pkg = plugin.package;
+  if (typeof pkg !== "string" || !pkg.startsWith(types.OCI_PROTO)) return;
+  const disabled = plugin.disabled === true;
+  const parsed = ociKey.tryParseOciRegistryAndPath(pkg);
+  if (!parsed) {
+    logInvalidOciFormat(pkg, sourceFile, disabled);
+    return;
+  }
+  const { registry, path } = parsed;
+  if (!recordEntryState(state, registry, path, level, disabled, pkg, sourceFile))
+    return;
+  recordRegistryPath(state, registry, path, sourceFile);
+}
+function formatExplicitPaths(bucket) {
+  return [...bucket.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([p, src]) => `${p} (in ${src})`).join("\n  - ");
+}
+function validateAmbiguousPathless(state) {
+  for (const [registry, pathlessSource] of state.pathlessRegistries) {
+    const bucket = state.definedPaths.get(registry);
+    if (!bucket || bucket.size <= 1) continue;
+    const formatted = formatExplicitPaths(bucket);
+    const pathlessState = state.perEntryState.get(entryKeyOf(registry, null));
+    if (pathlessState?.disabled) {
+      log.log(
+        `WARNING: Skipping disabled ambiguous path-less OCI reference for ${registry} in ${pathlessSource}: multiple path-specific entries exist:
+  - ${formatted}
+Cannot use path-less syntax for multi-plugin images. Please specify a !<plugin-path> suffix for the plugin`
+      );
+      continue;
+    }
+    throw new errors.InstallException(
+      `Ambiguous path-less OCI reference for ${registry} in ${pathlessSource}: multiple path-specific entries exist:
+  - ${formatted}
+Cannot use path-less syntax for multi-plugin images. Please specify a !<plugin-path> suffix for the plugin.`
+    );
+  }
+}
+function effectiveRegistryDisabled(state, registry) {
+  const pathlessState = state.perEntryState.get(entryKeyOf(registry, null));
+  if (!pathlessState) return false;
+  const bucket = state.definedPaths.get(registry);
+  if (bucket?.size !== 1) return pathlessState.disabled;
+  const [singlePath] = bucket.keys();
+  if (singlePath === void 0) return pathlessState.disabled;
+  const definedState = state.perEntryState.get(
+    entryKeyOf(registry, singlePath)
+  );
+  if (definedState && definedState.level > pathlessState.level)
+    return definedState.disabled;
+  return pathlessState.disabled;
+}
+function computeDisabledRegistries(state) {
+  const out = /* @__PURE__ */ new Set();
+  for (const registry of state.pathlessRegistries.keys()) {
+    if (effectiveRegistryDisabled(state, registry)) out.add(registry);
+  }
+  return out;
+}
+function preMergeOciDisabledState(includePluginLists, mainPlugins, mainConfigFile) {
+  const state = {
+    perEntryState: /* @__PURE__ */ new Map(),
+    pathlessRegistries: /* @__PURE__ */ new Map(),
+    definedPaths: /* @__PURE__ */ new Map()
+  };
+  for (const [file, plugins] of includePluginLists) {
+    for (const plugin of plugins) processOciEntry(state, plugin, 0, file);
+  }
+  for (const plugin of mainPlugins)
+    processOciEntry(state, plugin, 1, mainConfigFile);
+  validateAmbiguousPathless(state);
+  return computeDisabledRegistries(state);
+}
+function filterDisabledOciPlugins(plugins, disabledRegistries) {
+  const out = [];
+  for (const plugin of plugins) {
+    const pkg = plugin.package;
+    if (typeof pkg === "string" && pkg.startsWith(types.OCI_PROTO)) {
+      const parsed = ociKey.tryParseOciRegistryAndPath(pkg);
+      if (parsed && disabledRegistries.has(parsed.registry)) {
+        log.log(`
+======= Disabling OCI plugin ${pkg}`);
+        continue;
+      }
+      if (!parsed && plugin.disabled === true) {
+        log.log(`
+======= Disabling OCI plugin ${pkg}`);
+        continue;
+      }
+    }
+    out.push(plugin);
+  }
+  return out;
+}
+
+exports.deepMerge = deepMerge;
+exports.filterDisabledOciPlugins = filterDisabledOciPlugins;
+exports.mergePlugin = mergePlugin;
+exports.preMergeOciDisabledState = preMergeOciDisabledState;
+//# sourceMappingURL=merger.cjs.js.map

package/dist/merger.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.cjs.js","sources":["../src/merger.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport * as fs from 'node:fs/promises';\nimport { parse as parseYaml } from 'yaml';\nimport { InstallException } from './errors';\nimport { log } from './log';\nimport { type OciImageCache } from './image-cache';\nimport { npmPluginKey } from './npm-key';\nimport {\n  ociPluginKey,\n  type ParsedOciKey,\n  tryParseOciRegistryAndPath,\n} from './oci-key';\nimport {\n  type DynamicPluginsConfig,\n  OCI_PROTO,\n  type Plugin,\n  type PluginMap,\n  type PluginSpec,\n  RECOGNIZED_ALGORITHMS,\n} from './types';\nimport { isPlainObject } from './util';\n\n/**\n * Reject `__proto__`, `constructor`, and `prototype` keys.\n *\n * Inlined string-literal comparisons (rather than a shared `Set.has()` call)\n * because CodeQL's `js/prototype-polluting-function` analysis only treats\n * this specific pattern as an exhaustive prototype-pollution sanitizer when\n * looking at the call site — a `Set` lookup gets flagged as \"not guarded\".\n */\nfunction isForbiddenKey(key: string): boolean {\n  return key === '__proto__' || key === 'constructor' || key === 'prototype';\n}\n\n/**\n * Safely assign `value` to `dst[key]` without touching the prototype chain.\n *\n * Two layers of defense:\n *   1. Reject the three prototype-pollution keys outright.\n *   2. `Object.defineProperty` over `dst[key] = value` so that even if a\n *      forbidden key somehow slipped through, the prototype chain is still\n *      not mutated (`defineProperty` bypasses the `__proto__` setter).\n */\nfunction safeSet<T extends object>(dst: T, key: string, value: unknown): void {\n  if (key === '__proto__' || key === 'constructor' || key === 'prototype')\n    return;\n  Object.defineProperty(dst, key, {\n    value,\n    writable: true,\n    enumerable: true,\n    configurable: true,\n  });\n}\n\n/**\n * Recursively merges `src` into `dst` in place and returns `dst`. Raises on\n * conflicting scalar values so duplicate plugin configs never silently\n * overwrite each other (matches the Python `merge()` contract).\n *\n * Skips `__proto__`, `constructor`, and `prototype` keys to prevent prototype\n * pollution via user-supplied YAML.\n */\nexport function deepMerge<T extends Record<string, unknown>>(\n  src: Record<string, unknown>,\n  dst: T,\n  prefix = '',\n): T {\n  for (const [key, value] of Object.entries(src)) {\n    if (isForbiddenKey(key)) continue;\n    const dstRecord = dst as Record<string, unknown>;\n    if (isPlainObject(value)) {\n      const existing = dstRecord[key];\n      const node = isPlainObject(existing) ? existing : {};\n      safeSet(dstRecord, key, node);\n      deepMerge(value, node, `${prefix}${key}.`);\n    } else {\n      if (key in dst && !isEqual(dstRecord[key], value)) {\n        throw new InstallException(\n          `Config key '${prefix}${key}' defined differently for 2 dynamic plugins`,\n        );\n      }\n      safeSet(dstRecord, key, value);\n    }\n  }\n  return dst;\n}\n\n/**\n * Read a dynamic-plugins config file (main or included), parse its `plugins`,\n * and merge each into `allPlugins` using the OCI or NPM merger as appropriate.\n */\nexport async function mergePluginsFromFile(\n  configFile: string,\n  allPlugins: PluginMap,\n  level: number,\n  imageCache?: OciImageCache,\n): Promise<void> {\n  const content = parseYaml(await fs.readFile(configFile, 'utf8'));\n  if (!isPlainObject(content)) {\n    throw new InstallException(`${configFile} must contain a mapping`);\n  }\n  const plugins = (content as DynamicPluginsConfig).plugins;\n  if (!Array.isArray(plugins)) {\n    throw new InstallException(\n      `${configFile} must contain a 'plugins' list (got ${typeof plugins})`,\n    );\n  }\n  for (const plugin of plugins) {\n    await mergePlugin(plugin, allPlugins, configFile, level, imageCache);\n  }\n}\n\nexport async function mergePlugin(\n  plugin: Plugin,\n  allPlugins: PluginMap,\n  configFile: string,\n  level: number,\n  imageCache?: OciImageCache,\n): Promise<void> {\n  if (typeof plugin.package !== 'string') {\n    throw new InstallException(\n      `content of the 'plugins.package' field must be a string in ${configFile}`,\n    );\n  }\n  if (plugin.package.startsWith(OCI_PROTO)) {\n    await mergeOciPlugin(plugin, allPlugins, configFile, level, imageCache);\n  } else {\n    mergeNpmPlugin(plugin, allPlugins, configFile, level);\n  }\n}\n\nfunction mergeNpmPlugin(\n  plugin: Plugin,\n  allPlugins: PluginMap,\n  configFile: string,\n  level: number,\n): void {\n  const key = npmPluginKey(plugin.package);\n  doMerge(key, plugin, allPlugins, configFile, level);\n}\n\nasync function mergeOciPlugin(\n  plugin: Plugin,\n  allPlugins: PluginMap,\n  configFile: string,\n  level: number,\n  imageCache: OciImageCache | undefined,\n): Promise<void> {\n  let parsed = await ociPluginKey(plugin.package, imageCache);\n\n  if (parsed.inherit && parsed.resolvedPath === null) {\n    parsed = resolveInherit(plugin, allPlugins, parsed);\n  } else if (!plugin.package.includes('!') && parsed.resolvedPath) {\n    plugin.package = `${plugin.package}!${parsed.resolvedPath}`;\n  }\n\n  plugin.version = parsed.version;\n\n  const existing = allPlugins[parsed.pluginKey];\n  if (!existing) {\n    if (parsed.inherit) {\n      throw new InstallException(\n        `ERROR: {{inherit}} tag is set and there is currently no resolved tag or digest ` +\n          `for ${plugin.package} in ${configFile}.`,\n      );\n    }\n    log(\n      `\\n======= Adding new dynamic plugin configuration for version \\`${parsed.version}\\` of ${parsed.pluginKey}`,\n    );\n    plugin.last_modified_level = level;\n    allPlugins[parsed.pluginKey] = plugin;\n    return;\n  }\n\n  log(`\\n======= Overriding dynamic plugin configuration ${parsed.pluginKey}`);\n  if (existing.last_modified_level === level) {\n    throw new InstallException(\n      `Duplicate plugin configuration for ${plugin.package} found in ${configFile}.`,\n    );\n  }\n\n  if (!parsed.inherit) {\n    existing.package = plugin.package;\n    if (existing.version !== parsed.version) {\n      log(\n        `INFO: Overriding version for ${parsed.pluginKey} from \\`${existing.version ?? ''}\\` to \\`${parsed.version}\\``,\n      );\n    }\n    existing.version = parsed.version;\n  }\n  copyPluginFields(plugin, existing, [\n    'package',\n    'version',\n    'last_modified_level',\n  ]);\n  existing.last_modified_level = level;\n}\n\n/**\n * Resolve `{{inherit}}` without a plugin path — finds a single previously-\n * merged plugin from the same image, adopts its version + path, and mutates\n * `plugin.package` in place. Throws with a helpful message when zero or\n * multiple matches are found.\n */\nfunction resolveInherit(\n  plugin: Plugin,\n  allPlugins: PluginMap,\n  parsed: ParsedOciKey,\n): ParsedOciKey {\n  const prefix = `${parsed.pluginKey}:!`;\n  const matches = Object.keys(allPlugins).filter(k => k.startsWith(prefix));\n  if (matches.length === 0) {\n    throw new InstallException(\n      `Cannot use {{inherit}} for ${parsed.pluginKey}: no existing plugin ` +\n        `configuration found. Ensure a plugin from this image is defined in an ` +\n        `included file with an explicit version.`,\n    );\n  }\n  if (matches.length > 1) {\n    const formatted = matches\n      .map(m => {\n        const baseVersion = allPlugins[m]?.version ?? '';\n        const registryPart = m.split(':!')[0] ?? '';\n        const pathPart = m.split(':!').at(-1) ?? '';\n        return `  - ${registryPart}:${baseVersion}!${pathPart}`;\n      })\n      .join('\\n');\n    throw new InstallException(\n      `Cannot use {{inherit}} for ${parsed.pluginKey}: multiple plugins from ` +\n        `this image are defined in the included files:\\n${formatted}\\n` +\n        `Please specify which plugin configuration to inherit from using: ` +\n        `${parsed.pluginKey}:{{inherit}}!<plugin_path>`,\n    );\n  }\n  const matchedKey = matches[0] as string;\n  const basePlugin = allPlugins[matchedKey];\n  if (!basePlugin?.version) {\n    throw new InstallException(\n      `Internal: inherited plugin ${matchedKey} has no version`,\n    );\n  }\n  const version = basePlugin.version;\n  const resolvedPath = matchedKey.split(':!').at(-1) ?? '';\n  const registryPart = matchedKey.split(':!')[0] ?? '';\n  plugin.package = `${registryPart}:${version}!${resolvedPath}`;\n  log(\n    `\\n======= Inheriting version \\`${version}\\` and plugin path \\`${resolvedPath}\\` for ${matchedKey}`,\n  );\n  return { pluginKey: matchedKey, version, inherit: true, resolvedPath };\n}\n\nfunction doMerge(\n  key: string,\n  plugin: Plugin,\n  allPlugins: PluginMap,\n  configFile: string,\n  level: number,\n): void {\n  const existing = allPlugins[key];\n  if (!existing) {\n    log(`\\n======= Adding new dynamic plugin configuration for ${key}`);\n    plugin.last_modified_level = level;\n    allPlugins[key] = plugin;\n    return;\n  }\n  log(`\\n======= Overriding dynamic plugin configuration ${key}`);\n  if (existing.last_modified_level === level) {\n    throw new InstallException(\n      `Duplicate plugin configuration for ${plugin.package} found in ${configFile}.`,\n    );\n  }\n  copyPluginFields(plugin, existing, ['last_modified_level']);\n  existing.last_modified_level = level;\n}\n\nfunction copyPluginFields(\n  src: Plugin,\n  dst: Plugin,\n  skip: ReadonlyArray<string>,\n): void {\n  const skipSet = new Set<string>(skip);\n  for (const [k, v] of Object.entries(src)) {\n    if (skipSet.has(k) || isForbiddenKey(k)) continue;\n    safeSet(dst, k, v);\n  }\n}\n\nfunction isEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== typeof b) return false;\n  if (Array.isArray(a) && Array.isArray(b)) return isArrayEqual(a, b);\n  if (isPlainObject(a) && isPlainObject(b)) return isObjectEqual(a, b);\n  return false;\n}\n\nfunction isArrayEqual(a: readonly unknown[], b: readonly unknown[]): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((v, i) => isEqual(v, b[i]));\n}\n\nfunction isObjectEqual(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean {\n  const keysA = Object.keys(a);\n  if (keysA.length !== Object.keys(b).length) return false;\n  return keysA.every(k => isEqual(a[k], b[k]));\n}\n\ntype IncludePluginList = readonly [\n  file: string,\n  plugins: readonly PluginSpec[],\n];\n\ntype EntryState = { disabled: boolean; level: number };\n\ntype PreMergeState = {\n  perEntryState: Map<string, EntryState>;\n  pathlessRegistries: Map<string, string>;\n  definedPaths: Map<string, Map<string, string>>;\n};\n\nfunction entryKeyOf(registry: string, path: string | null): string {\n  return `${registry} ${path ?? ''}`;\n}\n\nfunction logInvalidOciFormat(\n  pkg: string,\n  sourceFile: string,\n  disabled: boolean,\n): void {\n  if (!disabled) {\n    throw new InstallException(\n      `oci package '${pkg}' is not in the expected format '${OCI_PROTO}<registry>:<tag>' ` +\n        `or '${OCI_PROTO}<registry>@<algo>:<digest>' (optionally followed by '!<path>') in ${sourceFile} ` +\n        `where <registry> may include a port (e.g. host:5000/path) ` +\n        `and <algo> is one of ${RECOGNIZED_ALGORITHMS.join(', ')}`,\n    );\n  }\n  log(\n    `WARNING: Skipping disabled OCI plugin with invalid format: '${pkg}' in ${sourceFile}. ` +\n      `Expected format: '${OCI_PROTO}<registry>:<tag>' or '${OCI_PROTO}<registry>@<algo>:<digest>' ` +\n      `(optionally followed by '!<path>') where <registry> may include a port (e.g. host:5000/path) ` +\n      `and <algo> is one of ${RECOGNIZED_ALGORITHMS.join(', ')}`,\n  );\n}\n\n/**\n * Record the entry's disabled state at its level. Returns `false` when the\n * entry is a duplicate at the same level (warning logged for disabled-dups,\n * throws for enabled-dups) so the caller can skip recording its path/source.\n */\nfunction recordEntryState(\n  state: PreMergeState,\n  registry: string,\n  path: string | null,\n  level: number,\n  disabled: boolean,\n  pkg: string,\n  sourceFile: string,\n): boolean {\n  const key = entryKeyOf(registry, path);\n  const existing = state.perEntryState.get(key);\n  if (!existing) {\n    state.perEntryState.set(key, { disabled, level });\n    return true;\n  }\n  if (existing.level === level) {\n    const pathSuffix = path ? `!${path}` : '';\n    if (!disabled) {\n      throw new InstallException(\n        `Duplicate OCI plugin configuration for ${registry}${pathSuffix} ` +\n          `found at the same level in ${sourceFile}: ${pkg}`,\n      );\n    }\n    log(\n      `WARNING: Skipping duplicate disabled OCI plugin configuration for ${registry}${pathSuffix} in ${sourceFile}`,\n    );\n    return false;\n  }\n  if (level > existing.level) state.perEntryState.set(key, { disabled, level });\n  return true;\n}\n\nfunction recordRegistryPath(\n  state: PreMergeState,\n  registry: string,\n  path: string | null,\n  sourceFile: string,\n): void {\n  if (!path) {\n    state.pathlessRegistries.set(registry, sourceFile);\n    return;\n  }\n  let bucket = state.definedPaths.get(registry);\n  if (!bucket) {\n    bucket = new Map<string, string>();\n    state.definedPaths.set(registry, bucket);\n  }\n  bucket.set(path, sourceFile);\n}\n\nfunction processOciEntry(\n  state: PreMergeState,\n  plugin: PluginSpec,\n  level: number,\n  sourceFile: string,\n): void {\n  const pkg = plugin.package;\n  if (typeof pkg !== 'string' || !pkg.startsWith(OCI_PROTO)) return;\n  const disabled = plugin.disabled === true;\n  const parsed = tryParseOciRegistryAndPath(pkg);\n  if (!parsed) {\n    logInvalidOciFormat(pkg, sourceFile, disabled);\n    return;\n  }\n  const { registry, path } = parsed;\n  if (\n    !recordEntryState(state, registry, path, level, disabled, pkg, sourceFile)\n  )\n    return;\n  recordRegistryPath(state, registry, path, sourceFile);\n}\n\nfunction formatExplicitPaths(bucket: Map<string, string>): string {\n  return [...bucket.entries()]\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([p, src]) => `${p} (in ${src})`)\n    .join('\\n  - ');\n}\n\nfunction validateAmbiguousPathless(state: PreMergeState): void {\n  for (const [registry, pathlessSource] of state.pathlessRegistries) {\n    const bucket = state.definedPaths.get(registry);\n    if (!bucket || bucket.size <= 1) continue;\n    const formatted = formatExplicitPaths(bucket);\n    const pathlessState = state.perEntryState.get(entryKeyOf(registry, null));\n    if (pathlessState?.disabled) {\n      log(\n        `WARNING: Skipping disabled ambiguous path-less OCI reference for ${registry} in ${pathlessSource}: ` +\n          `multiple path-specific entries exist:\\n  - ${formatted}\\n` +\n          `Cannot use path-less syntax for multi-plugin images. ` +\n          `Please specify a !<plugin-path> suffix for the plugin`,\n      );\n      continue;\n    }\n    throw new InstallException(\n      `Ambiguous path-less OCI reference for ${registry} in ${pathlessSource}: ` +\n        `multiple path-specific entries exist:\\n  - ${formatted}\\n` +\n        `Cannot use path-less syntax for multi-plugin images. ` +\n        `Please specify a !<plugin-path> suffix for the plugin.`,\n    );\n  }\n}\n\nfunction effectiveRegistryDisabled(\n  state: PreMergeState,\n  registry: string,\n): boolean {\n  const pathlessState = state.perEntryState.get(entryKeyOf(registry, null));\n  if (!pathlessState) return false;\n  const bucket = state.definedPaths.get(registry);\n  if (bucket?.size !== 1) return pathlessState.disabled;\n  const [singlePath] = bucket.keys();\n  if (singlePath === undefined) return pathlessState.disabled;\n  const definedState = state.perEntryState.get(\n    entryKeyOf(registry, singlePath),\n  );\n  if (definedState && definedState.level > pathlessState.level)\n    return definedState.disabled;\n  return pathlessState.disabled;\n}\n\nfunction computeDisabledRegistries(state: PreMergeState): Set<string> {\n  const out = new Set<string>();\n  for (const registry of state.pathlessRegistries.keys()) {\n    if (effectiveRegistryDisabled(state, registry)) out.add(registry);\n  }\n  return out;\n}\n\n/**\n * Pre-merge pass that walks every OCI plugin entry from the included files\n * (level 0) and the main config (level 1) and returns the set of OCI\n * registries that will be effectively disabled after the merge. Computed\n * BEFORE any skopeo work so disabled plugins never trigger a remote fetch.\n *\n * Ports `pre_merge_oci_disabled_state` from the Python installer\n * (`install-dynamic-plugins.py`). Only inspects `package` and `disabled` —\n * does NOT merge `pluginConfig`.\n *\n * Throws an `InstallException` for:\n *   - invalid OCI package strings on enabled entries,\n *   - duplicate enabled OCI entries declared at the same level,\n *   - path-less enabled references that collide with multiple explicit-path\n *     entries from the same image (ambiguous).\n *\n * Logs a warning (and skips the offending entry) for the equivalent\n * `disabled: true` scenarios — operators can still ship a disabled\n * descriptor without aborting the install.\n */\nexport function preMergeOciDisabledState(\n  includePluginLists: ReadonlyArray<IncludePluginList>,\n  mainPlugins: ReadonlyArray<PluginSpec>,\n  mainConfigFile: string,\n): Set<string> {\n  const state: PreMergeState = {\n    perEntryState: new Map(),\n    pathlessRegistries: new Map(),\n    definedPaths: new Map(),\n  };\n  for (const [file, plugins] of includePluginLists) {\n    for (const plugin of plugins) processOciEntry(state, plugin, 0, file);\n  }\n  for (const plugin of mainPlugins)\n    processOciEntry(state, plugin, 1, mainConfigFile);\n\n  validateAmbiguousPathless(state);\n  return computeDisabledRegistries(state);\n}\n\n/**\n * Drop every OCI plugin whose registry is in the disabled set, plus invalid\n * OCI entries flagged `disabled: true` (a no-op the operator clearly intends\n * to remove). Non-OCI entries pass through unchanged.\n */\nexport function filterDisabledOciPlugins(\n  plugins: ReadonlyArray<PluginSpec>,\n  disabledRegistries: ReadonlySet<string>,\n): PluginSpec[] {\n  const out: PluginSpec[] = [];\n  for (const plugin of plugins) {\n    const pkg = plugin.package;\n    if (typeof pkg === 'string' && pkg.startsWith(OCI_PROTO)) {\n      const parsed = tryParseOciRegistryAndPath(pkg);\n      if (parsed && disabledRegistries.has(parsed.registry)) {\n        log(`\\n======= Disabling OCI plugin ${pkg}`);\n        continue;\n      }\n      if (!parsed && plugin.disabled === true) {\n        log(`\\n======= Disabling OCI plugin ${pkg}`);\n        continue;\n      }\n    }\n    out.push(plugin);\n  }\n  return out;\n}\n"],"names":["isPlainObject","InstallException","OCI_PROTO","npmPluginKey","ociPluginKey","log","registryPart","RECOGNIZED_ALGORITHMS","tryParseOciRegistryAndPath"],"mappings":"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"}

package/dist/npm-key.cjs.js

@@ -0,0 +1,44 @@
+'use strict';
+
+const NPM_PACKAGE_PATTERN = /^(@[^/]+\/)?([^@]+)(?:@(.+))?$/;
+const NPM_ALIAS_PATTERN = /^([^@]+)@npm:(@[^/]+\/)?([^@]+)(?:@(.+))?$/;
+const GITHUB_SHORTHAND_PATTERN = /^([^/@]+)\/([^/#]+)(?:#(.+))?$/;
+const GIT_URL_PATTERNS = [
+  /^git\+https?:\/\/[^#]+(?:#(.+))?$/,
+  /^git\+ssh:\/\/[^#]+(?:#(.+))?$/,
+  /^git:\/\/[^#]+(?:#(.+))?$/,
+  /^https:\/\/github\.com\/[^/]+\/[^/#]+(?:\.git)?(?:#(.+))?$/,
+  /^git@github\.com:[^/]+\/[^/#]+(?:\.git)?(?:#(.+))?$/,
+  /^github:([^/@]+)\/([^/#]+)(?:#(.+))?$/
+];
+function npmPluginKey(pkg) {
+  if (pkg.startsWith("./") || pkg.endsWith(".tgz")) return pkg;
+  const aliasKey = tryParseAlias(pkg);
+  if (aliasKey) return aliasKey;
+  if (isGitLikeSpec(pkg)) return stripRefSuffix(pkg);
+  return stripStandardNpmVersion(pkg);
+}
+function tryParseAlias(pkg) {
+  const m = NPM_ALIAS_PATTERN.exec(pkg);
+  if (!m) return null;
+  const [, aliasName, scope, name] = m;
+  return `${aliasName}@npm:${scope ?? ""}${name}`;
+}
+function isGitLikeSpec(pkg) {
+  if (GIT_URL_PATTERNS.some((re) => re.test(pkg))) return true;
+  if (pkg.includes("://") || pkg.startsWith("@")) return false;
+  return GITHUB_SHORTHAND_PATTERN.test(pkg);
+}
+function stripRefSuffix(pkg) {
+  const hash = pkg.indexOf("#");
+  return hash >= 0 ? pkg.slice(0, hash) : pkg;
+}
+function stripStandardNpmVersion(pkg) {
+  const m = NPM_PACKAGE_PATTERN.exec(pkg);
+  if (!m) return pkg;
+  const [, scope, name] = m;
+  return `${scope ?? ""}${name}`;
+}
+
+exports.npmPluginKey = npmPluginKey;
+//# sourceMappingURL=npm-key.cjs.js.map

package/dist/npm-key.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-key.cjs.js","sources":["../src/npm-key.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// [@scope/]name[@version]\nconst NPM_PACKAGE_PATTERN = /^(@[^/]+\\/)?([^@]+)(?:@(.+))?$/;\n// alias@npm:[@scope/]name[@version]\nconst NPM_ALIAS_PATTERN = /^([^@]+)@npm:(@[^/]+\\/)?([^@]+)(?:@(.+))?$/;\n// user/repo\nconst GITHUB_SHORTHAND_PATTERN = /^([^/@]+)\\/([^/#]+)(?:#(.+))?$/;\n\nconst GIT_URL_PATTERNS: RegExp[] = [\n  /^git\\+https?:\\/\\/[^#]+(?:#(.+))?$/,\n  /^git\\+ssh:\\/\\/[^#]+(?:#(.+))?$/,\n  /^git:\\/\\/[^#]+(?:#(.+))?$/,\n  /^https:\\/\\/github\\.com\\/[^/]+\\/[^/#]+(?:\\.git)?(?:#(.+))?$/,\n  /^git@github\\.com:[^/]+\\/[^/#]+(?:\\.git)?(?:#(.+))?$/,\n  /^github:([^/@]+)\\/([^/#]+)(?:#(.+))?$/,\n];\n\nexport function npmPluginKey(pkg: string): string {\n  // Local packages and tarballs have no version to strip.\n  if (pkg.startsWith('./') || pkg.endsWith('.tgz')) return pkg;\n\n  // Aliases: \"my-alias@npm:real-pkg@1.2.3\" -> \"my-alias@npm:real-pkg\"\n  const aliasKey = tryParseAlias(pkg);\n  if (aliasKey) return aliasKey;\n\n  // Git URLs / GitHub shorthand: strip `#ref` suffix.\n  if (isGitLikeSpec(pkg)) return stripRefSuffix(pkg);\n\n  return stripStandardNpmVersion(pkg);\n}\n\nfunction tryParseAlias(pkg: string): string | null {\n  const m = NPM_ALIAS_PATTERN.exec(pkg);\n  if (!m) return null;\n  const [, aliasName, scope, name] = m;\n  return `${aliasName}@npm:${scope ?? ''}${name}`;\n}\n\nfunction isGitLikeSpec(pkg: string): boolean {\n  if (GIT_URL_PATTERNS.some(re => re.test(pkg))) return true;\n  // GitHub shorthand `user/repo#ref` — but not scoped packages or full URLs.\n  if (pkg.includes('://') || pkg.startsWith('@')) return false;\n  return GITHUB_SHORTHAND_PATTERN.test(pkg);\n}\n\nfunction stripRefSuffix(pkg: string): string {\n  const hash = pkg.indexOf('#');\n  return hash >= 0 ? pkg.slice(0, hash) : pkg;\n}\n\nfunction stripStandardNpmVersion(pkg: string): string {\n  const m = NPM_PACKAGE_PATTERN.exec(pkg);\n  if (!m) return pkg;\n  const [, scope, name] = m;\n  return `${scope ?? ''}${name}`;\n}\n"],"names":[],"mappings":";;AAiBA,MAAM,mBAAA,GAAsB,gCAAA;AAE5B,MAAM,iBAAA,GAAoB,4CAAA;AAE1B,MAAM,wBAAA,GAA2B,gCAAA;AAEjC,MAAM,gBAAA,GAA6B;AAAA,EACjC,mCAAA;AAAA,EACA,gCAAA;AAAA,EACA,2BAAA;AAAA,EACA,4DAAA;AAAA,EACA,qDAAA;AAAA,EACA;AACF,CAAA;AAEO,SAAS,aAAa,GAAA,EAAqB;AAEhD,EAAA,IAAI,GAAA,CAAI,WAAW,IAAI,CAAA,IAAK,IAAI,QAAA,CAAS,MAAM,GAAG,OAAO,GAAA;AAGzD,EAAA,MAAM,QAAA,GAAW,cAAc,GAAG,CAAA;AAClC,EAAA,IAAI,UAAU,OAAO,QAAA;AAGrB,EAAA,IAAI,aAAA,CAAc,GAAG,CAAA,EAAG,OAAO,eAAe,GAAG,CAAA;AAEjD,EAAA,OAAO,wBAAwB,GAAG,CAAA;AACpC;AAEA,SAAS,cAAc,GAAA,EAA4B;AACjD,EAAA,MAAM,CAAA,GAAI,iBAAA,CAAkB,IAAA,CAAK,GAAG,CAAA;AACpC,EAAA,IAAI,CAAC,GAAG,OAAO,IAAA;AACf,EAAA,MAAM,GAAG,SAAA,EAAW,KAAA,EAAO,IAAI,CAAA,GAAI,CAAA;AACnC,EAAA,OAAO,GAAG,SAAS,CAAA,KAAA,EAAQ,KAAA,IAAS,EAAE,GAAG,IAAI,CAAA,CAAA;AAC/C;AAEA,SAAS,cAAc,GAAA,EAAsB;AAC3C,EAAA,IAAI,gBAAA,CAAiB,KAAK,CAAA,EAAA,KAAM,EAAA,CAAG,KAAK,GAAG,CAAC,GAAG,OAAO,IAAA;AAEtD,EAAA,IAAI,GAAA,CAAI,SAAS,KAAK,CAAA,IAAK,IAAI,UAAA,CAAW,GAAG,GAAG,OAAO,KAAA;AACvD,EAAA,OAAO,wBAAA,CAAyB,KAAK,GAAG,CAAA;AAC1C;AAEA,SAAS,eAAe,GAAA,EAAqB;AAC3C,EAAA,MAAM,IAAA,GAAO,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC5B,EAAA,OAAO,QAAQ,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,IAAI,CAAA,GAAI,GAAA;AAC1C;AAEA,SAAS,wBAAwB,GAAA,EAAqB;AACpD,EAAA,MAAM,CAAA,GAAI,mBAAA,CAAoB,IAAA,CAAK,GAAG,CAAA;AACtC,EAAA,IAAI,CAAC,GAAG,OAAO,GAAA;AACf,EAAA,MAAM,GAAG,KAAA,EAAO,IAAI,CAAA,GAAI,CAAA;AACxB,EAAA,OAAO,CAAA,EAAG,KAAA,IAAS,EAAE,CAAA,EAAG,IAAI,CAAA,CAAA;AAC9B;;;;"}