wyvrnpm 1.2.0 → 1.3.2

package/src/resolve.js

@@ -1,200 +1,257 @@
-'use strict';
-
-/**
- * Compares two version strings of the form "major.minor.patch.build".
- * Each missing component is treated as 0.
- *
- * @param {string} a - First version string.
- * @param {string} b - Second version string.
- * @returns {-1|0|1} -1 if a < b, 0 if equal, 1 if a > b.
- */
-function compareVersions(a, b) {
-  const parsePart = (s) => s.split('.').map((n) => parseInt(n, 10) || 0);
-  const pa = parsePart(a);
-  const pb = parsePart(b);
-  const len = Math.max(pa.length, pb.length);
-  for (let i = 0; i < len; i++) {
-    const na = pa[i] !== undefined ? pa[i] : 0;
-    const nb = pb[i] !== undefined ? pb[i] : 0;
-    if (na < nb) return -1;
-    if (na > nb) return 1;
-  }
-  return 0;
-}
-
-/**
- * Resolves the "latest" tag for a package by fetching latest.json from the registry.
- *
- * @param {string} name
- * @param {string[]} packageSources
- * @param {string} platform
- * @param {Function} httpClient
- * @returns {Promise<string>} The resolved version string.
- */
-async function resolveLatestVersion(name, packageSources, platform, httpClient) {
-  for (const source of packageSources) {
-    const base = source.replace(/\/$/, '');
-    const candidates = [
-      `${base}/${platform}/${name}/latest.json`,
-      `${base}/common/${name}/latest.json`,
-    ];
-    for (const url of candidates) {
-      try {
-        const response = await httpClient(url);
-        if (!response.ok) continue;
-        const data = await response.json();
-        if (data && data.version) return data.version;
-      } catch {
-        // Try next candidate.
-      }
-    }
-  }
-  throw new Error(`Could not resolve "latest" version for "${name}" from any source`);
-}
-
-/**
- * Fetches razer.json for a single package from the first source that responds.
- *
- * @param {string} name
- * @param {string} version
- * @param {string[]} packageSources
- * @param {string} platform
- * @param {Function} httpClient
- * @param {Map<string, object>} cache - In-flight / completed fetch cache.
- * @returns {Promise<object|null>} Parsed razer.json or null if not found anywhere.
- */
-async function fetchPackageManifest(name, version, packageSources, platform, httpClient, cache) {
-  const cacheKey = `${name}@${version}`;
-  if (cache.has(cacheKey)) {
-    return cache.get(cacheKey);
-  }
-
-  for (const source of packageSources) {
-    const base = source.replace(/\/$/, '');
-    const candidates = [
-      `${base}/${platform}/${name}/${version}/wyvrn.json`,
-      `${base}/${platform}/${name}/${version}/razer.json`,
-      `${base}/common/${name}/${version}/wyvrn.json`,
-      `${base}/common/${name}/${version}/razer.json`,
-    ];
-    for (const url of candidates) {
-      try {
-        const response = await httpClient(url);
-        if (!response.ok) continue;
-        const data = await response.json();
-        cache.set(cacheKey, data);
-        return data;
-      } catch {
-        // Try next candidate.
-      }
-    }
-  }
-
-  console.warn(`[wyvrn] Warning: could not fetch manifest for ${name}@${version} from any source`);
-  cache.set(cacheKey, null);
-  return null;
-}
-
-/**
- * Resolves the full, flattened dependency graph starting from rootDeps.
- * When the same package is required at multiple versions the highest version wins.
- *
- * @param {Record<string, string>} rootDeps - Direct dependencies { name: version }.
- * @param {string[]} packageSources - Ordered list of base URLs to try.
- * @param {string} platform - Target platform string (e.g. "win_x64").
- * @param {Function} httpClient - fetch-compatible function.
- * @returns {Promise<Map<string, string>>} Resolved map of name -> version.
- */
-async function resolveDependencies(rootDeps, packageSources, platform, httpClient, lockedVersions = new Map()) {
-  /** @type {Map<string, string>} Final resolved versions. */
-  const resolved = new Map();
-
-  /** @type {Map<string, object|null>} Manifest cache to avoid duplicate fetches. */
-  const manifestCache = new Map();
-
-  /**
-   * Pending work queue: each entry is { name, version }.
-   * We process iteratively to avoid deep recursion on large dependency trees.
-   */
-  const queue = Object.entries(rootDeps).map(([name, version]) => ({ name, version }));
-
-  while (queue.length > 0) {
-    let { name, version } = queue.shift();
-
-    // Lock file always wins — use pinned version regardless of what was requested.
-    if (lockedVersions.has(name)) {
-      version = lockedVersions.get(name);
-    }
-
-    // Resolve the "latest" tag to a concrete version before proceeding.
-    if (version === 'latest') {
-      try {
-        version = await resolveLatestVersion(name, packageSources, platform, httpClient);
-        console.log(`[wyvrn] Resolved "${name}@latest" → ${version}`);
-      } catch (err) {
-        console.warn(`[wyvrn] Warning: ${err.message}`);
-        continue;
-      }
-    }
-
-    if (resolved.has(name)) {
-      const existing = resolved.get(name);
-      if (existing === version) {
-        continue;
-      }
-      // Locked packages never lose to a conflict.
-      if (lockedVersions.has(name)) {
-        continue;
-      }
-      // Conflict: keep the latest version.
-      const winner = compareVersions(version, existing) > 0 ? version : existing;
-      if (winner !== existing) {
-        console.warn(
-          `[wyvrn] Version conflict for "${name}": ${existing} vs ${version} — using ${winner}`,
-        );
-        resolved.set(name, winner);
-        // Re-fetch the winning version's manifest to pull in its transitive deps.
-        queue.push({ name, version: winner });
-      }
-      continue;
-    }
-
-    resolved.set(name, version);
-
-    const manifest = await fetchPackageManifest(
-      name,
-      version,
-      packageSources,
-      platform,
-      httpClient,
-      manifestCache,
-    );
-    if (!manifest) {
-      continue;
-    }
-
-    // Support both formats:
-    //   PascalCase array: { Dependencies: [ { Name, Version }, ... ] }
-    //   lowercase object: { dependencies: { name: version, ... } }
-    let deps = [];
-    if (Array.isArray(manifest.Dependencies)) {
-      deps = manifest.Dependencies.filter((d) => d.Name && d.Version).map((d) => ({
-        name: d.Name,
-        version: d.Version,
-      }));
-    } else if (manifest.dependencies && typeof manifest.dependencies === 'object') {
-      deps = Object.entries(manifest.dependencies).map(([name, version]) => ({ name, version }));
-    }
-    for (const dep of deps) {
-      queue.push({ name: dep.name, version: dep.version });
-    }
-  }
-
-  return resolved;
-}
-
-module.exports = {
-  compareVersions,
-  resolveLatestVersion,
-  resolveDependencies,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Checks if a version string represents a linked package.
+ * @param {string} version
+ * @returns {boolean}
+ */
+function isLinkedVersion(version) {
+  return typeof version === 'string' && version.startsWith('linked:');
+}
+
+/**
+ * Extracts the local path from a linked version string.
+ * @param {string} version - e.g. "linked:C:\\Dev\\my-package"
+ * @returns {string} The local path.
+ */
+function getLinkedPath(version) {
+  return version.slice('linked:'.length);
+}
+
+/**
+ * Reads a local package's manifest (wyvrn.json or razer.json).
+ * @param {string} packagePath - Path to the package directory.
+ * @returns {object|null} Parsed manifest or null if not found.
+ */
+function readLocalManifest(packagePath) {
+  const candidates = ['wyvrn.json', 'razer.json'];
+  for (const filename of candidates) {
+    const manifestPath = path.join(packagePath, filename);
+    if (fs.existsSync(manifestPath)) {
+      try {
+        return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+      } catch {
+        // Try next candidate
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Compares two version strings of the form "major.minor.patch.build".
+ * Each missing component is treated as 0.
+ *
+ * @param {string} a - First version string.
+ * @param {string} b - Second version string.
+ * @returns {-1|0|1} -1 if a < b, 0 if equal, 1 if a > b.
+ */
+function compareVersions(a, b) {
+  const parsePart = (s) => s.split('.').map((n) => parseInt(n, 10) || 0);
+  const pa = parsePart(a);
+  const pb = parsePart(b);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const na = pa[i] !== undefined ? pa[i] : 0;
+    const nb = pb[i] !== undefined ? pb[i] : 0;
+    if (na < nb) return -1;
+    if (na > nb) return 1;
+  }
+  return 0;
+}
+
+/**
+ * Resolves the "latest" tag for a package by fetching latest.json from the registry.
+ *
+ * @param {string} name
+ * @param {string[]} packageSources
+ * @param {string} platform
+ * @param {Function} httpClient
+ * @returns {Promise<string>} The resolved version string.
+ */
+async function resolveLatestVersion(name, packageSources, platform, httpClient) {
+  for (const source of packageSources) {
+    const base = source.replace(/\/$/, '');
+    const candidates = [
+      `${base}/${platform}/${name}/latest.json`,
+      `${base}/common/${name}/latest.json`,
+    ];
+    for (const url of candidates) {
+      try {
+        const response = await httpClient(url);
+        if (!response.ok) continue;
+        const data = await response.json();
+        if (data && data.version) return data.version;
+      } catch {
+        // Try next candidate.
+      }
+    }
+  }
+  throw new Error(`Could not resolve "latest" version for "${name}" from any source`);
+}
+
+/**
+ * Fetches razer.json for a single package from the first source that responds.
+ *
+ * @param {string} name
+ * @param {string} version
+ * @param {string[]} packageSources
+ * @param {string} platform
+ * @param {Function} httpClient
+ * @param {Map<string, object>} cache - In-flight / completed fetch cache.
+ * @returns {Promise<object|null>} Parsed razer.json or null if not found anywhere.
+ */
+async function fetchPackageManifest(name, version, packageSources, platform, httpClient, cache) {
+  const cacheKey = `${name}@${version}`;
+  if (cache.has(cacheKey)) {
+    return cache.get(cacheKey);
+  }
+
+  for (const source of packageSources) {
+    const base = source.replace(/\/$/, '');
+    const candidates = [
+      `${base}/${platform}/${name}/${version}/wyvrn.json`,
+      `${base}/${platform}/${name}/${version}/razer.json`,
+      `${base}/common/${name}/${version}/wyvrn.json`,
+      `${base}/common/${name}/${version}/razer.json`,
+    ];
+    for (const url of candidates) {
+      try {
+        const response = await httpClient(url);
+        if (!response.ok) continue;
+        const data = await response.json();
+        cache.set(cacheKey, data);
+        return data;
+      } catch {
+        // Try next candidate.
+      }
+    }
+  }
+
+  console.warn(`[wyvrn] Warning: could not fetch manifest for ${name}@${version} from any source`);
+  cache.set(cacheKey, null);
+  return null;
+}
+
+/**
+ * Resolves the full, flattened dependency graph starting from rootDeps.
+ * When the same package is required at multiple versions the highest version wins.
+ *
+ * @param {Record<string, string>} rootDeps - Direct dependencies { name: version }.
+ * @param {string[]} packageSources - Ordered list of base URLs to try.
+ * @param {string} platform - Target platform string (e.g. "win_x64").
+ * @param {Function} httpClient - fetch-compatible function.
+ * @returns {Promise<Map<string, string>>} Resolved map of name -> version.
+ */
+async function resolveDependencies(rootDeps, packageSources, platform, httpClient, lockedVersions = new Map()) {
+  /** @type {Map<string, string>} Final resolved versions. */
+  const resolved = new Map();
+
+  /** @type {Map<string, object|null>} Manifest cache to avoid duplicate fetches. */
+  const manifestCache = new Map();
+
+  /**
+   * Pending work queue: each entry is { name, version }.
+   * We process iteratively to avoid deep recursion on large dependency trees.
+   */
+  const queue = Object.entries(rootDeps).map(([name, version]) => ({ name, version }));
+
+  while (queue.length > 0) {
+    let { name, version } = queue.shift();
+
+    // Lock file always wins — use pinned version regardless of what was requested.
+    if (lockedVersions.has(name)) {
+      version = lockedVersions.get(name);
+    }
+
+    // Resolve the "latest" tag to a concrete version before proceeding.
+    // Skip this for linked packages which have "linked:" prefix.
+    if (version === 'latest') {
+      try {
+        version = await resolveLatestVersion(name, packageSources, platform, httpClient);
+        console.log(`[wyvrn] Resolved "${name}@latest" → ${version}`);
+      } catch (err) {
+        console.warn(`[wyvrn] Warning: ${err.message}`);
+        continue;
+      }
+    }
+
+    if (resolved.has(name)) {
+      const existing = resolved.get(name);
+      if (existing === version) {
+        continue;
+      }
+      // Locked packages never lose to a conflict.
+      if (lockedVersions.has(name)) {
+        continue;
+      }
+      // Conflict: keep the latest version.
+      const winner = compareVersions(version, existing) > 0 ? version : existing;
+      if (winner !== existing) {
+        console.warn(
+          `[wyvrn] Version conflict for "${name}": ${existing} vs ${version} — using ${winner}`,
+        );
+        resolved.set(name, winner);
+        // Re-fetch the winning version's manifest to pull in its transitive deps.
+        queue.push({ name, version: winner });
+      }
+      continue;
+    }
+
+    resolved.set(name, version);
+
+    // Handle linked packages: read local manifest instead of fetching from remote
+    let manifest;
+    if (isLinkedVersion(version)) {
+      const localPath = getLinkedPath(version);
+      manifest = readLocalManifest(localPath);
+      if (manifest) {
+        console.log(`[wyvrn] Linked: ${name} → ${localPath}`);
+      } else {
+        console.log(`[wyvrn] Linked: ${name} → ${localPath} (no manifest found)`);
+      }
+    } else {
+      manifest = await fetchPackageManifest(
+        name,
+        version,
+        packageSources,
+        platform,
+        httpClient,
+        manifestCache,
+      );
+    }
+
+    if (!manifest) {
+      continue;
+    }
+
+    // Support both formats:
+    //   PascalCase array: { Dependencies: [ { Name, Version }, ... ] }
+    //   lowercase object: { dependencies: { name: version, ... } }
+    let deps = [];
+    if (Array.isArray(manifest.Dependencies)) {
+      deps = manifest.Dependencies.filter((d) => d.Name && d.Version).map((d) => ({
+        name: d.Name,
+        version: d.Version,
+      }));
+    } else if (manifest.dependencies && typeof manifest.dependencies === 'object') {
+      deps = Object.entries(manifest.dependencies).map(([name, version]) => ({ name, version }));
+    }
+    for (const dep of deps) {
+      queue.push({ name: dep.name, version: dep.version });
+    }
+  }
+
+  return resolved;
+}
+
+module.exports = {
+  compareVersions,
+  resolveLatestVersion,
+  resolveDependencies,
+  isLinkedVersion,
+  getLinkedPath,
+};