@aws/nx-plugin 1.0.0-rc.7 → 1.0.0-rc.70

package/src/utils/version-upgrade-migration/sync-vended-versions.js

@@ -0,0 +1,518 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { addDependenciesToPackageJson, detectPackageManager, readJson, updateJson, visitNotIgnoredFiles } from "@nx/devkit";
+import yaml from "js-yaml";
+import { getCatalogManager } from "nx/src/utils/catalog";
+import { parsePipRequirementsLine } from "pip-requirements-js";
+import { coerce, parse, satisfies, validRange } from "semver";
+import { applyGritQL, captureAllGritQL } from "../ast.js";
+import { buildInstallCommand } from "../commands.js";
+import { formatFilesInSubtree } from "../format.js";
+import { updateToml } from "../toml.js";
+import { PY_VERSIONS, TERRAFORM_VERSIONS, TS_VERSIONS } from "../versions.js";
+import { isNxPackage } from "./nx-package-updates.js";
+import { ownedDependencies } from "./owned-dependencies.js";
+import { syncEmbeddedVersions } from "./sync-embedded-versions.js";
+import { syncMetricsVersion } from "./sync-metrics-version.js";
+import { isVendedUpgrade } from "./vended-upgrade.js";
+/**
+ * Syncs the versions a generated workspace pins to those this release vends:
+ * TypeScript dependencies (including those pinned only by an override), Python
+ * pins, Terraform providers, and the plugin version the metrics files report.
+ *
+ * nx and `@nx/*` are excluded — `packageJsonUpdates` owns them so `nx migrate`
+ * collects Nx's own migrations (see `nx-package-updates.ts`).
+ */ /** Workspace files holding catalog definitions, and pnpm 11's overrides. */ const YAML_WORKSPACE_FILES = [
+    'pnpm-workspace.yaml',
+    '.yarnrc.yml'
+];
+/**
+ * Vended version for a dependency this workspace's generators own, or undefined
+ * for one the user added themselves.
+ */ const vendedTsVersion = (owned, name)=>isNxPackage(name) || !owned.ts.has(name) ? undefined : TS_VERSIONS[name];
+/** PY_VERSIONS records the `==` operator; the pin holds the bare version. */ const vendedPyVersion = (owned, name)=>owned.py.has(name) ? PY_VERSIONS[name]?.replace(/^==/, '') : undefined;
+/** Protocols whose version lives elsewhere, and is synced there instead. */ const REFERENCE_PROTOCOL = /^(?:workspace|file|link|npm|git|git\+|github|portal|patch|exec):/;
+/**
+ * Whether devkit may be handed this specifier.
+ *
+ * `catalog:` is only safe where devkit has a catalog manager (pnpm, yarn).
+ * It ships none for bun, and without one it rewrites the reference to a literal
+ * version, severing the catalog — so bun's references are synced directly.
+ */ const isSyncableSpecifier = (tree, declared)=>{
+    // A manifest is the user's file and may hold anything. A version that isn't a
+    // string is not one this can reason about, and throwing here would abort the
+    // whole `nx migrate` over a file the sync only meant to skip.
+    if (typeof declared !== 'string') {
+        return false;
+    }
+    if (REFERENCE_PROTOCOL.test(declared)) {
+        return false;
+    }
+    return !declared.startsWith('catalog:') || getCatalogManager(tree.root) !== null;
+};
+/**
+ * Whether the declared range already permits the vended version, following a
+ * `catalog:` reference to the range it points at.
+ *
+ * Devkit would narrow such a range to an exact pin, discarding a user's widened
+ * specifier without changing what resolves, so it is left alone.
+ */ const alreadyPermitsVended = (tree, packageName, declared, vended)=>{
+    let range = declared;
+    if (declared.startsWith('catalog:')) {
+        const resolved = getCatalogManager(tree.root)?.resolveCatalogReference(tree, packageName, declared);
+        if (!resolved) {
+            return false;
+        }
+        range = resolved;
+    }
+    range = range.trim();
+    // An exact pin is the case to upgrade, not a range to preserve.
+    if (parse(range) !== null || validRange(range) === null) {
+        return false;
+    }
+    return satisfies(vended, range);
+};
+/**
+ * Vended packages a manifest already declares, and the version to move each to.
+ *
+ * Only packages already present are named: devkit adds whatever it is given, so
+ * passing the full vended list would inject all of it into every manifest.
+ */ const declaredVendedPackages = (tree, owned, packageJsonPath)=>{
+    const json = readJson(tree, packageJsonPath);
+    const pick = (field)=>Object.fromEntries(Object.entries(json[field] ?? {}).flatMap(([name, declared])=>{
+            const vended = vendedTsVersion(owned, name);
+            return vended && isSyncableSpecifier(tree, declared) && !alreadyPermitsVended(tree, name, declared, vended) ? [
+                [
+                    name,
+                    vended
+                ]
+            ] : [];
+        }));
+    return {
+        dependencies: pick('dependencies'),
+        devDependencies: pick('devDependencies')
+    };
+};
+/**
+ * Sync the TypeScript dependencies every `package.json` declares.
+ *
+ * Devkit does the writing: it moves a version wherever the workspace keeps it —
+ * through a `catalog:` reference or directly — and refuses anything that isn't a
+ * strict upgrade on what is installed.
+ *
+ * Called directly rather than through this plugin's wrapper, which *migrates*
+ * declarations into the catalog; right when generating, wrong for a version bump.
+ */ const syncPackageJsons = (tree, owned)=>{
+    const updated = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (!path.endsWith('package.json')) {
+            return;
+        }
+        const { dependencies, devDependencies } = declaredVendedPackages(tree, owned, path);
+        if (Object.keys(dependencies).length === 0 && Object.keys(devDependencies).length === 0) {
+            return;
+        }
+        const before = tree.read(path, 'utf-8');
+        const catalogsBefore = readCatalogFiles(tree);
+        // Install callback dropped: `nx migrate` runs install itself.
+        addDependenciesToPackageJson(tree, dependencies, devDependencies, path);
+        if (tree.read(path, 'utf-8') !== before || readCatalogFiles(tree) !== catalogsBefore) {
+            updated.push(path);
+        }
+    });
+    return updated;
+};
+/** Snapshot of every catalog definition file, for change detection. */ const readCatalogFiles = (tree)=>[
+        ...YAML_WORKSPACE_FILES,
+        'package.json'
+    ].map((path)=>tree.exists(path) ? tree.read(path, 'utf-8') : '').join('\0');
+/**
+ * Upgrade vended catalog entries devkit cannot reach: those no manifest
+ * references, and every bun entry (bun has no catalog manager).
+ */ const syncOrphanCatalogEntries = (tree, owned)=>{
+    const referenced = referencedCatalogPackages(tree);
+    const updated = [];
+    const syncCatalog = (catalog)=>{
+        let changed = false;
+        for (const [name, declared] of Object.entries(catalog ?? {})){
+            const vended = vendedTsVersion(owned, name);
+            if (!vended || referenced.has(name)) {
+                continue;
+            }
+            if (isVendedUpgrade(vended, String(declared))) {
+                catalog[name] = vended;
+                changed = true;
+            }
+        }
+        return changed;
+    };
+    for (const path of YAML_WORKSPACE_FILES){
+        if (!tree.exists(path)) {
+            continue;
+        }
+        const catalogFile = yaml.load(tree.read(path, 'utf-8') ?? '') ?? {};
+        const changed = [
+            syncCatalog(catalogFile.catalog),
+            ...Object.values(catalogFile.catalogs ?? {}).map(syncCatalog)
+        ].some(Boolean);
+        if (changed) {
+            tree.write(path, yaml.dump(catalogFile, {
+                quotingType: "'"
+            }));
+            updated.push(path);
+        }
+    }
+    // Bun keeps its catalogs in the root manifest.
+    if (tree.exists('package.json')) {
+        let changed = false;
+        updateJson(tree, 'package.json', (json)=>{
+            changed = [
+                syncCatalog(json.catalog),
+                ...Object.values(json.catalogs ?? {}).map(syncCatalog)
+            ].some(Boolean);
+            return json;
+        });
+        if (changed) {
+            updated.push('package.json');
+        }
+    }
+    return updated;
+};
+/**
+ * The package an override key pins, or undefined when the key names none.
+ *
+ * A key is a package name, optionally preceded by the path it is scoped to and
+ * followed by the parent range it applies at:
+ *
+ *   zod                                     -> zod
+ *   zod@^3                                  -> zod
+ *   **/@modelcontextprotocol/sdk/zod        -> zod
+ *   @prisma/adapter-pg/@types/pg            -> @types/pg
+ *
+ * The last segment is the package, since every earlier one is a parent it is
+ * scoped under — except that a scope and the name after it are one segment.
+ */ const overriddenPackage = (key)=>{
+    const segments = key.split('/').reduce((acc, part)=>{
+        // A bare `@scope` is only half a name; join it to what follows.
+        const previous = acc[acc.length - 1];
+        if (previous?.startsWith('@') && !previous.includes('/')) {
+            acc[acc.length - 1] = `${previous}/${part}`;
+            return acc;
+        }
+        acc.push(part);
+        return acc;
+    }, []);
+    const name = segments[segments.length - 1];
+    if (!name || name === '.') {
+        return undefined;
+    }
+    // A trailing `@range` scopes the override to a parent version.
+    const at = name.lastIndexOf('@');
+    return at > 0 ? name.slice(0, at) : name;
+};
+/**
+ * Sync the owned packages an override pins, wherever the workspace keeps them:
+ * npm's `overrides`, yarn and bun's `resolutions`, and pnpm's `pnpm.overrides`
+ * (10) or `pnpm-workspace.yaml` `overrides` (11).
+ *
+ * Devkit does not manage these fields, so an owned package pinned only here
+ * would otherwise stay on the version it was generated with. Values are compared
+ * with `isVendedUpgrade`, so a range the user widened is left alone.
+ */ /**
+ * Where the workspace's package manager reads overrides from.
+ *
+ * Only the root manifest is considered: every package manager resolves overrides
+ * from the workspace root, so a nested `overrides` block is inert and rewriting
+ * it would imply an effect it doesn't have.
+ *
+ * pnpm moved the block between majors — 10 reads `pnpm.overrides` in the
+ * manifest, 11 reads `overrides` in `pnpm-workspace.yaml` — so both are covered
+ * rather than detecting the minor.
+ */ const overrideLocations = (tree)=>{
+    switch(detectPackageManager(tree.root)){
+        case 'npm':
+            return {
+                manifestFields: [
+                    'overrides'
+                ]
+            };
+        case 'yarn':
+            return {
+                manifestFields: [
+                    'resolutions'
+                ]
+            };
+        case 'bun':
+            // Bun reads npm's `overrides` and yarn's `resolutions` alike.
+            return {
+                manifestFields: [
+                    'overrides',
+                    'resolutions'
+                ]
+            };
+        default:
+            return {
+                manifestFields: [
+                    'pnpm.overrides'
+                ],
+                workspaceFile: 'pnpm-workspace.yaml'
+            };
+    }
+};
+const syncOverrides = (tree, owned)=>{
+    const updated = [];
+    // Nested npm overrides carry the pin under `.`, with sibling keys scoping
+    // deeper, so a value may be a string or another override object.
+    const syncOverrideTree = (overrides)=>{
+        if (typeof overrides !== 'object' || overrides === null) {
+            return false;
+        }
+        let changed = false;
+        for (const [key, value] of Object.entries(overrides)){
+            if (typeof value === 'object' && value !== null) {
+                changed = syncOverrideTree(value) || changed;
+                continue;
+            }
+            if (typeof value !== 'string') {
+                continue;
+            }
+            // `.` pins the package its parent key names.
+            const name = key === '.' ? undefined : overriddenPackage(key) ?? undefined;
+            const vended = name ? vendedTsVersion(owned, name) : undefined;
+            if (vended && isVendedUpgrade(vended, value)) {
+                overrides[key] = vended;
+                changed = true;
+            }
+        }
+        return changed;
+    };
+    const { manifestFields, workspaceFile } = overrideLocations(tree);
+    if (manifestFields.length > 0) {
+        let changed = false;
+        updateJson(tree, 'package.json', (json)=>{
+            changed = manifestFields.map((field)=>syncOverrideTree(field === 'pnpm.overrides' ? json.pnpm?.overrides : json[field])).some(Boolean);
+            return json;
+        });
+        if (changed) {
+            updated.push('package.json');
+        }
+    }
+    if (workspaceFile && tree.exists(workspaceFile)) {
+        const contents = yaml.load(tree.read(workspaceFile, 'utf-8') ?? '') ?? {};
+        if (syncOverrideTree(contents.overrides)) {
+            tree.write(workspaceFile, yaml.dump(contents, {
+                quotingType: "'"
+            }));
+            updated.push(workspaceFile);
+        }
+    }
+    return updated;
+};
+/**
+ * Packages devkit already maintains through a `catalog:` reference. Empty
+ * without a catalog manager, where no reference resolves.
+ */ const referencedCatalogPackages = (tree)=>{
+    const referenced = new Set();
+    if (getCatalogManager(tree.root) === null) {
+        return referenced;
+    }
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (!path.endsWith('package.json')) {
+            return;
+        }
+        const json = readJson(tree, path);
+        for (const field of [
+            'dependencies',
+            'devDependencies'
+        ]){
+            for (const [name, declared] of Object.entries(json[field] ?? {})){
+                if (String(declared).startsWith('catalog:')) {
+                    referenced.add(name);
+                }
+            }
+        }
+    });
+    return referenced;
+};
+/**
+ * Whether the declared specifiers already permit the vended version, so
+ * rewriting them would discard the user's range without changing what resolves.
+ *
+ * This mirrors the TypeScript side: an exact pin is the case to upgrade, a range
+ * that already reaches the vended version is left alone, and a range that falls
+ * short is moved up.
+ *
+ * A `*` wildcard or a specifier semver can't read counts as already permitting,
+ * so anything not understood is left as the user wrote it.
+ */ const pyRangePermitsVended = (specs, vended)=>specs.every((spec)=>{
+        if (spec.version.includes('*')) {
+            return true;
+        }
+        const bound = coerce(spec.version, {
+            includePrerelease: true
+        });
+        if (!bound) {
+            return true;
+        }
+        switch(spec.operator){
+            // An exact pin permits only itself, so a differing vended version is an
+            // upgrade to apply.
+            case '==':
+            case '===':
+                return satisfies(vended, `=${bound.version}`, {
+                    includePrerelease: true
+                });
+            // `~=1.2.3` allows the patch series; `~=1.2` the minor series.
+            case '~=':
+                return satisfies(vended, spec.version.split('.').length > 2 ? `~${bound.version}` : `^${bound.version}`, {
+                    includePrerelease: true
+                });
+            case '>=':
+            case '>':
+            case '<=':
+            case '<':
+                return satisfies(vended, `${spec.operator}${bound.version}`, {
+                    includePrerelease: true
+                });
+            // `!=` only excludes, so it never blocks the vended version by itself.
+            case '!=':
+                return true;
+            default:
+                return true;
+        }
+    });
+/**
+ * Upgrade a pip requirement to the vended version, or return it unchanged.
+ *
+ * Parsed rather than pattern-matched so extras and operators are read the way
+ * `uv` reads them. A requirement whose specifiers already permit the vended
+ * version keeps them; one that falls short is replaced with an exact pin, which
+ * is what the generators write.
+ */ const syncPyRequirement = (owned, requirement)=>{
+    const parsed = parsePipRequirementsLine(requirement);
+    if (parsed?.type !== 'ProjectName' || !parsed.versionSpec?.length) {
+        return requirement;
+    }
+    const name = parsed.extras?.length ? `${parsed.name}[${parsed.extras.join(',')}]` : parsed.name;
+    const vended = vendedPyVersion(owned, name);
+    if (!vended) {
+        return requirement;
+    }
+    const specs = parsed.versionSpec;
+    // Never move a version backwards: a pin above what this release vends is the
+    // user's, and a range already reaching it is theirs to keep.
+    const [first] = specs;
+    const isExactPin = specs.length === 1 && (first.operator === '==' || first.operator === '===');
+    if (isExactPin && !isVendedUpgrade(vended, first.version)) {
+        return requirement;
+    }
+    if (!isExactPin && pyRangePermitsVended(specs, vended)) {
+        return requirement;
+    }
+    return `${name}==${vended}`;
+};
+/** Sync pins in every `pyproject.toml`, dependencies and groups alike. */ const syncPyProjects = (tree, owned)=>{
+    const updated = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (!path.endsWith('pyproject.toml')) {
+            return;
+        }
+        let changed = false;
+        const syncRequirements = (requirements)=>Array.isArray(requirements) ? requirements.map((requirement)=>{
+                if (typeof requirement !== 'string') {
+                    return requirement;
+                }
+                const synced = syncPyRequirement(owned, requirement);
+                changed ||= synced !== requirement;
+                return synced;
+            }) : requirements;
+        updateToml(tree, path, (toml)=>{
+            const project = toml.project;
+            if (project?.dependencies) {
+                project.dependencies = syncRequirements(project.dependencies);
+            }
+            const groups = toml['dependency-groups'];
+            for (const group of Object.keys(groups ?? {})){
+                groups[group] = syncRequirements(groups[group]);
+            }
+            return toml;
+        });
+        if (changed) {
+            updated.push(path);
+        }
+    });
+    return updated;
+};
+/**
+ * GritQL matching one provider's `version` in `required_providers`, scoped by
+ * the sibling `source` so an alias or another provider's version can't match.
+ *
+ * `language hcl` is required — without it the pattern silently matches nothing.
+ */ const providerVersionPattern = (provider, rewrite = '')=>`language hcl\n\`version = $version\`${rewrite} where {` + ` $version <: within \`{ source = "hashicorp/${provider}" $... }\` }`;
+/** Version a provider currently declares, if it declares one. */ const declaredProviderVersion = async (tree, path, provider)=>{
+    const [captured] = await captureAllGritQL(tree, path, providerVersionPattern(provider));
+    // The match is the whole attribute, e.g. `version = "6.40.0"`.
+    return /"([^"]+)"/.exec(captured ?? '')?.[1];
+};
+/** Sync vended provider versions in every `.tf` file. */ const syncTerraformProviders = async (tree)=>{
+    const updated = [];
+    const terraformFiles = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (path.endsWith('.tf')) {
+            terraformFiles.push(path);
+        }
+    });
+    for (const path of terraformFiles){
+        let changed = false;
+        for (const [provider, vended] of Object.entries(TERRAFORM_VERSIONS)){
+            const declared = await declaredProviderVersion(tree, path, provider);
+            if (!declared || !isVendedUpgrade(vended, declared)) {
+                continue;
+            }
+            changed = await applyGritQL(tree, path, providerVersionPattern(provider, ` => \`version = "${vended}"\``)) || changed;
+        }
+        if (changed) {
+            updated.push(path);
+        }
+    }
+    return updated;
+};
+/**
+ * Sync the versions this release vends, for the dependencies the workspace's
+ * generators own.
+ */ export const syncVendedVersions = async (tree)=>{
+    const nextSteps = [];
+    const owned = await ownedDependencies(tree);
+    const packageJsons = syncPackageJsons(tree, owned);
+    const catalogs = syncOrphanCatalogEntries(tree, owned);
+    const overrides = syncOverrides(tree, owned);
+    const pyProjects = syncPyProjects(tree, owned);
+    const terraformFiles = await syncTerraformProviders(tree);
+    const skippedEmbedded = await syncEmbeddedVersions(tree, owned);
+    await syncMetricsVersion(tree);
+    // Lock files are left to the user: `nx migrate` only installs when the root
+    // manifest changes, and never runs `uv` or `terraform`.
+    if (catalogs.length > 0 || packageJsons.length > 0 || overrides.length > 0) {
+        nextSteps.push(`TypeScript dependency versions were updated. Run \`${buildInstallCommand(detectPackageManager(tree.root))}\` to update the lock file.`);
+    }
+    if (pyProjects.length > 0) {
+        nextSteps.push(`Python dependency versions were updated in ${pyProjects.join(', ')}. Run \`uv sync\` to update uv.lock.`);
+    }
+    if (terraformFiles.length > 0) {
+        nextSteps.push(`Terraform provider versions were updated in ${terraformFiles.length} file(s). Run \`terraform init -upgrade\` in each Terraform project to update its lock file.`);
+    }
+    // A synced embedded pin needs no next step — it is read the next time the thing
+    // holding it runs. A file the sync left alone does: its versions are still the
+    // old ones, and only the user can reconcile that.
+    if (skippedEmbedded.length > 0) {
+        nextSteps.push(`Version pins were left as they are in ${skippedEmbedded.join(', ')}, which repeat a pin more times than this migration rewrites at once. Update them by hand.`);
+    }
+    // Without this the workspace's own format check fails on the migrated files.
+    await formatFilesInSubtree(tree);
+    return {
+        nextSteps
+    };
+};
+
+//# sourceMappingURL=sync-vended-versions.js.map

package/src/utils/version-upgrade-migration/sync-vended-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/version-upgrade-migration/sync-vended-versions.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  addDependenciesToPackageJson,\n  detectPackageManager,\n  type MigrationReturnObject,\n  readJson,\n  type Tree,\n  updateJson,\n  visitNotIgnoredFiles,\n} from '@nx/devkit';\nimport yaml from 'js-yaml';\nimport { getCatalogManager } from 'nx/src/utils/catalog';\nimport { parsePipRequirementsLine } from 'pip-requirements-js';\nimport { coerce, parse, satisfies, validRange } from 'semver';\nimport { applyGritQL, captureAllGritQL } from '../ast';\nimport { buildInstallCommand } from '../commands';\nimport { formatFilesInSubtree } from '../format';\nimport { updateToml } from '../toml';\nimport { PY_VERSIONS, TERRAFORM_VERSIONS, TS_VERSIONS } from '../versions';\nimport { isNxPackage } from './nx-package-updates';\nimport {\n  type OwnedDependencies,\n  ownedDependencies,\n} from './owned-dependencies';\nimport { syncEmbeddedVersions } from './sync-embedded-versions';\nimport { syncMetricsVersion } from './sync-metrics-version';\nimport { isVendedUpgrade } from './vended-upgrade';\n\n/**\n * Syncs the versions a generated workspace pins to those this release vends:\n * TypeScript dependencies (including those pinned only by an override), Python\n * pins, Terraform providers, and the plugin version the metrics files report.\n *\n * nx and `@nx/*` are excluded — `packageJsonUpdates` owns them so `nx migrate`\n * collects Nx's own migrations (see `nx-package-updates.ts`).\n */\n\n/** Workspace files holding catalog definitions, and pnpm 11's overrides. */\nconst YAML_WORKSPACE_FILES = ['pnpm-workspace.yaml', '.yarnrc.yml'];\n\n/**\n * Vended version for a dependency this workspace's generators own, or undefined\n * for one the user added themselves.\n */\nconst vendedTsVersion = (\n  owned: OwnedDependencies,\n  name: string,\n): string | undefined =>\n  isNxPackage(name) || !owned.ts.has(name)\n    ? undefined\n    : TS_VERSIONS[name as keyof typeof TS_VERSIONS];\n\n/** PY_VERSIONS records the `==` operator; the pin holds the bare version. */\nconst vendedPyVersion = (\n  owned: OwnedDependencies,\n  name: string,\n): string | undefined =>\n  owned.py.has(name)\n    ? PY_VERSIONS[name as keyof typeof PY_VERSIONS]?.replace(/^==/, '')\n    : undefined;\n\n/** Protocols whose version lives elsewhere, and is synced there instead. */\nconst REFERENCE_PROTOCOL =\n  /^(?:workspace|file|link|npm|git|git\\+|github|portal|patch|exec):/;\n\n/**\n * Whether devkit may be handed this specifier.\n *\n * `catalog:` is only safe where devkit has a catalog manager (pnpm, yarn).\n * It ships none for bun, and without one it rewrites the reference to a literal\n * version, severing the catalog — so bun's references are synced directly.\n */\nconst isSyncableSpecifier = (tree: Tree, declared: unknown): boolean => {\n  // A manifest is the user's file and may hold anything. A version that isn't a\n  // string is not one this can reason about, and throwing here would abort the\n  // whole `nx migrate` over a file the sync only meant to skip.\n  if (typeof declared !== 'string') {\n    return false;\n  }\n  if (REFERENCE_PROTOCOL.test(declared)) {\n    return false;\n  }\n  return (\n    !declared.startsWith('catalog:') || getCatalogManager(tree.root) !== null\n  );\n};\n\n/**\n * Whether the declared range already permits the vended version, following a\n * `catalog:` reference to the range it points at.\n *\n * Devkit would narrow such a range to an exact pin, discarding a user's widened\n * specifier without changing what resolves, so it is left alone.\n */\nconst alreadyPermitsVended = (\n  tree: Tree,\n  packageName: string,\n  declared: string,\n  vended: string,\n): boolean => {\n  let range = declared;\n  if (declared.startsWith('catalog:')) {\n    const resolved = getCatalogManager(tree.root)?.resolveCatalogReference(\n      tree,\n      packageName,\n      declared,\n    );\n    if (!resolved) {\n      return false;\n    }\n    range = resolved;\n  }\n  range = range.trim();\n  // An exact pin is the case to upgrade, not a range to preserve.\n  if (parse(range) !== null || validRange(range) === null) {\n    return false;\n  }\n  return satisfies(vended, range);\n};\n\n/**\n * Vended packages a manifest already declares, and the version to move each to.\n *\n * Only packages already present are named: devkit adds whatever it is given, so\n * passing the full vended list would inject all of it into every manifest.\n */\nconst declaredVendedPackages = (\n  tree: Tree,\n  owned: OwnedDependencies,\n  packageJsonPath: string,\n): {\n  dependencies: Record<string, string>;\n  devDependencies: Record<string, string>;\n} => {\n  const json = readJson(tree, packageJsonPath);\n  const pick = (field: 'dependencies' | 'devDependencies') =>\n    Object.fromEntries(\n      Object.entries((json[field] ?? {}) as Record<string, string>).flatMap(\n        ([name, declared]) => {\n          const vended = vendedTsVersion(owned, name);\n          return vended &&\n            isSyncableSpecifier(tree, declared) &&\n            !alreadyPermitsVended(tree, name, declared, vended)\n            ? [[name, vended] as const]\n            : [];\n        },\n      ),\n    );\n  return {\n    dependencies: pick('dependencies'),\n    devDependencies: pick('devDependencies'),\n  };\n};\n\n/**\n * Sync the TypeScript dependencies every `package.json` declares.\n *\n * Devkit does the writing: it moves a version wherever the workspace keeps it —\n * through a `catalog:` reference or directly — and refuses anything that isn't a\n * strict upgrade on what is installed.\n *\n * Called directly rather than through this plugin's wrapper, which *migrates*\n * declarations into the catalog; right when generating, wrong for a version bump.\n */\nconst syncPackageJsons = (tree: Tree, owned: OwnedDependencies): string[] => {\n  const updated: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (!path.endsWith('package.json')) {\n      return;\n    }\n    const { dependencies, devDependencies } = declaredVendedPackages(\n      tree,\n      owned,\n      path,\n    );\n    if (\n      Object.keys(dependencies).length === 0 &&\n      Object.keys(devDependencies).length === 0\n    ) {\n      return;\n    }\n\n    const before = tree.read(path, 'utf-8');\n    const catalogsBefore = readCatalogFiles(tree);\n    // Install callback dropped: `nx migrate` runs install itself.\n    addDependenciesToPackageJson(tree, dependencies, devDependencies, path);\n    if (\n      tree.read(path, 'utf-8') !== before ||\n      readCatalogFiles(tree) !== catalogsBefore\n    ) {\n      updated.push(path);\n    }\n  });\n\n  return updated;\n};\n\n/** Snapshot of every catalog definition file, for change detection. */\nconst readCatalogFiles = (tree: Tree): string =>\n  [...YAML_WORKSPACE_FILES, 'package.json']\n    .map((path) => (tree.exists(path) ? tree.read(path, 'utf-8') : ''))\n    .join('\\0');\n\n/**\n * Upgrade vended catalog entries devkit cannot reach: those no manifest\n * references, and every bun entry (bun has no catalog manager).\n */\nconst syncOrphanCatalogEntries = (\n  tree: Tree,\n  owned: OwnedDependencies,\n): string[] => {\n  const referenced = referencedCatalogPackages(tree);\n  const updated: string[] = [];\n\n  const syncCatalog = (\n    catalog: Record<string, string> | undefined,\n  ): boolean => {\n    let changed = false;\n    for (const [name, declared] of Object.entries(catalog ?? {})) {\n      const vended = vendedTsVersion(owned, name);\n      if (!vended || referenced.has(name)) {\n        continue;\n      }\n      if (isVendedUpgrade(vended, String(declared))) {\n        catalog![name] = vended;\n        changed = true;\n      }\n    }\n    return changed;\n  };\n\n  for (const path of YAML_WORKSPACE_FILES) {\n    if (!tree.exists(path)) {\n      continue;\n    }\n    const catalogFile = (yaml.load(tree.read(path, 'utf-8') ?? '') ?? {}) as {\n      catalog?: Record<string, string>;\n      catalogs?: Record<string, Record<string, string>>;\n    };\n    const changed = [\n      syncCatalog(catalogFile.catalog),\n      ...Object.values(catalogFile.catalogs ?? {}).map(syncCatalog),\n    ].some(Boolean);\n    if (changed) {\n      tree.write(path, yaml.dump(catalogFile, { quotingType: \"'\" }));\n      updated.push(path);\n    }\n  }\n\n  // Bun keeps its catalogs in the root manifest.\n  if (tree.exists('package.json')) {\n    let changed = false;\n    updateJson(tree, 'package.json', (json) => {\n      changed = [\n        syncCatalog(json.catalog),\n        ...Object.values(\n          (json.catalogs ?? {}) as Record<string, Record<string, string>>,\n        ).map(syncCatalog),\n      ].some(Boolean);\n      return json;\n    });\n    if (changed) {\n      updated.push('package.json');\n    }\n  }\n\n  return updated;\n};\n\n/**\n * The package an override key pins, or undefined when the key names none.\n *\n * A key is a package name, optionally preceded by the path it is scoped to and\n * followed by the parent range it applies at:\n *\n *   zod                                     -> zod\n *   zod@^3                                  -> zod\n *   **&#47;@modelcontextprotocol/sdk/zod        -> zod\n *   @prisma/adapter-pg/@types/pg            -> @types/pg\n *\n * The last segment is the package, since every earlier one is a parent it is\n * scoped under — except that a scope and the name after it are one segment.\n */\nconst overriddenPackage = (key: string): string | undefined => {\n  const segments = key.split('/').reduce<string[]>((acc, part) => {\n    // A bare `@scope` is only half a name; join it to what follows.\n    const previous = acc[acc.length - 1];\n    if (previous?.startsWith('@') && !previous.includes('/')) {\n      acc[acc.length - 1] = `${previous}/${part}`;\n      return acc;\n    }\n    acc.push(part);\n    return acc;\n  }, []);\n\n  const name = segments[segments.length - 1];\n  if (!name || name === '.') {\n    return undefined;\n  }\n  // A trailing `@range` scopes the override to a parent version.\n  const at = name.lastIndexOf('@');\n  return at > 0 ? name.slice(0, at) : name;\n};\n\n/**\n * Sync the owned packages an override pins, wherever the workspace keeps them:\n * npm's `overrides`, yarn and bun's `resolutions`, and pnpm's `pnpm.overrides`\n * (10) or `pnpm-workspace.yaml` `overrides` (11).\n *\n * Devkit does not manage these fields, so an owned package pinned only here\n * would otherwise stay on the version it was generated with. Values are compared\n * with `isVendedUpgrade`, so a range the user widened is left alone.\n */\n/**\n * Where the workspace's package manager reads overrides from.\n *\n * Only the root manifest is considered: every package manager resolves overrides\n * from the workspace root, so a nested `overrides` block is inert and rewriting\n * it would imply an effect it doesn't have.\n *\n * pnpm moved the block between majors — 10 reads `pnpm.overrides` in the\n * manifest, 11 reads `overrides` in `pnpm-workspace.yaml` — so both are covered\n * rather than detecting the minor.\n */\nconst overrideLocations = (\n  tree: Tree,\n): {\n  manifestFields: readonly ('overrides' | 'resolutions' | 'pnpm.overrides')[];\n  workspaceFile?: string;\n} => {\n  switch (detectPackageManager(tree.root)) {\n    case 'npm':\n      return { manifestFields: ['overrides'] };\n    case 'yarn':\n      return { manifestFields: ['resolutions'] };\n    case 'bun':\n      // Bun reads npm's `overrides` and yarn's `resolutions` alike.\n      return { manifestFields: ['overrides', 'resolutions'] };\n    default:\n      return {\n        manifestFields: ['pnpm.overrides'],\n        workspaceFile: 'pnpm-workspace.yaml',\n      };\n  }\n};\n\nconst syncOverrides = (tree: Tree, owned: OwnedDependencies): string[] => {\n  const updated: string[] = [];\n\n  // Nested npm overrides carry the pin under `.`, with sibling keys scoping\n  // deeper, so a value may be a string or another override object.\n  const syncOverrideTree = (overrides: unknown): boolean => {\n    if (typeof overrides !== 'object' || overrides === null) {\n      return false;\n    }\n    let changed = false;\n    for (const [key, value] of Object.entries(\n      overrides as Record<string, unknown>,\n    )) {\n      if (typeof value === 'object' && value !== null) {\n        changed = syncOverrideTree(value) || changed;\n        continue;\n      }\n      if (typeof value !== 'string') {\n        continue;\n      }\n      // `.` pins the package its parent key names.\n      const name =\n        key === '.' ? undefined : (overriddenPackage(key) ?? undefined);\n      const vended = name ? vendedTsVersion(owned, name) : undefined;\n      if (vended && isVendedUpgrade(vended, value)) {\n        (overrides as Record<string, unknown>)[key] = vended;\n        changed = true;\n      }\n    }\n    return changed;\n  };\n\n  const { manifestFields, workspaceFile } = overrideLocations(tree);\n\n  if (manifestFields.length > 0) {\n    let changed = false;\n    updateJson(tree, 'package.json', (json) => {\n      changed = manifestFields\n        .map((field) =>\n          syncOverrideTree(\n            field === 'pnpm.overrides' ? json.pnpm?.overrides : json[field],\n          ),\n        )\n        .some(Boolean);\n      return json;\n    });\n    if (changed) {\n      updated.push('package.json');\n    }\n  }\n\n  if (workspaceFile && tree.exists(workspaceFile)) {\n    const contents = (yaml.load(tree.read(workspaceFile, 'utf-8') ?? '') ??\n      {}) as Record<string, unknown>;\n    if (syncOverrideTree(contents.overrides)) {\n      tree.write(workspaceFile, yaml.dump(contents, { quotingType: \"'\" }));\n      updated.push(workspaceFile);\n    }\n  }\n\n  return updated;\n};\n\n/**\n * Packages devkit already maintains through a `catalog:` reference. Empty\n * without a catalog manager, where no reference resolves.\n */\nconst referencedCatalogPackages = (tree: Tree): Set<string> => {\n  const referenced = new Set<string>();\n  if (getCatalogManager(tree.root) === null) {\n    return referenced;\n  }\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (!path.endsWith('package.json')) {\n      return;\n    }\n    const json = readJson(tree, path);\n    for (const field of ['dependencies', 'devDependencies'] as const) {\n      for (const [name, declared] of Object.entries(\n        (json[field] ?? {}) as Record<string, string>,\n      )) {\n        if (String(declared).startsWith('catalog:')) {\n          referenced.add(name);\n        }\n      }\n    }\n  });\n  return referenced;\n};\n\n/** Pip specifier as `pip-requirements-js` reports it. */\ninterface PyVersionSpec {\n  readonly operator: string;\n  readonly version: string;\n}\n\n/**\n * Whether the declared specifiers already permit the vended version, so\n * rewriting them would discard the user's range without changing what resolves.\n *\n * This mirrors the TypeScript side: an exact pin is the case to upgrade, a range\n * that already reaches the vended version is left alone, and a range that falls\n * short is moved up.\n *\n * A `*` wildcard or a specifier semver can't read counts as already permitting,\n * so anything not understood is left as the user wrote it.\n */\nconst pyRangePermitsVended = (\n  specs: readonly PyVersionSpec[],\n  vended: string,\n): boolean =>\n  specs.every((spec) => {\n    if (spec.version.includes('*')) {\n      return true;\n    }\n    const bound = coerce(spec.version, { includePrerelease: true });\n    if (!bound) {\n      return true;\n    }\n    switch (spec.operator) {\n      // An exact pin permits only itself, so a differing vended version is an\n      // upgrade to apply.\n      case '==':\n      case '===':\n        return satisfies(vended, `=${bound.version}`, {\n          includePrerelease: true,\n        });\n      // `~=1.2.3` allows the patch series; `~=1.2` the minor series.\n      case '~=':\n        return satisfies(\n          vended,\n          spec.version.split('.').length > 2\n            ? `~${bound.version}`\n            : `^${bound.version}`,\n          { includePrerelease: true },\n        );\n      case '>=':\n      case '>':\n      case '<=':\n      case '<':\n        return satisfies(vended, `${spec.operator}${bound.version}`, {\n          includePrerelease: true,\n        });\n      // `!=` only excludes, so it never blocks the vended version by itself.\n      case '!=':\n        return true;\n      default:\n        return true;\n    }\n  });\n\n/**\n * Upgrade a pip requirement to the vended version, or return it unchanged.\n *\n * Parsed rather than pattern-matched so extras and operators are read the way\n * `uv` reads them. A requirement whose specifiers already permit the vended\n * version keeps them; one that falls short is replaced with an exact pin, which\n * is what the generators write.\n */\nconst syncPyRequirement = (\n  owned: OwnedDependencies,\n  requirement: string,\n): string => {\n  const parsed = parsePipRequirementsLine(requirement);\n  if (parsed?.type !== 'ProjectName' || !parsed.versionSpec?.length) {\n    return requirement;\n  }\n\n  const name = parsed.extras?.length\n    ? `${parsed.name}[${parsed.extras.join(',')}]`\n    : parsed.name;\n  const vended = vendedPyVersion(owned, name);\n  if (!vended) {\n    return requirement;\n  }\n\n  const specs = parsed.versionSpec as readonly PyVersionSpec[];\n  // Never move a version backwards: a pin above what this release vends is the\n  // user's, and a range already reaching it is theirs to keep.\n  const [first] = specs;\n  const isExactPin =\n    specs.length === 1 && (first.operator === '==' || first.operator === '===');\n  if (isExactPin && !isVendedUpgrade(vended, first.version)) {\n    return requirement;\n  }\n  if (!isExactPin && pyRangePermitsVended(specs, vended)) {\n    return requirement;\n  }\n  return `${name}==${vended}`;\n};\n\n/** Sync pins in every `pyproject.toml`, dependencies and groups alike. */\nconst syncPyProjects = (tree: Tree, owned: OwnedDependencies): string[] => {\n  const updated: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (!path.endsWith('pyproject.toml')) {\n      return;\n    }\n\n    let changed = false;\n    const syncRequirements = (requirements: unknown): unknown =>\n      Array.isArray(requirements)\n        ? requirements.map((requirement) => {\n            if (typeof requirement !== 'string') {\n              return requirement;\n            }\n            const synced = syncPyRequirement(owned, requirement);\n            changed ||= synced !== requirement;\n            return synced;\n          })\n        : requirements;\n\n    updateToml(tree, path, (toml) => {\n      const project = toml.project as Record<string, unknown> | undefined;\n      if (project?.dependencies) {\n        project.dependencies = syncRequirements(project.dependencies) as never;\n      }\n      const groups = toml['dependency-groups'] as\n        | Record<string, unknown>\n        | undefined;\n      for (const group of Object.keys(groups ?? {})) {\n        groups![group] = syncRequirements(groups![group]) as never;\n      }\n      return toml;\n    });\n\n    if (changed) {\n      updated.push(path);\n    }\n  });\n\n  return updated;\n};\n\n/**\n * GritQL matching one provider's `version` in `required_providers`, scoped by\n * the sibling `source` so an alias or another provider's version can't match.\n *\n * `language hcl` is required — without it the pattern silently matches nothing.\n */\nconst providerVersionPattern = (provider: string, rewrite = ''): string =>\n  `language hcl\\n\\`version = $version\\`${rewrite} where {` +\n  ` $version <: within \\`{ source = \"hashicorp/${provider}\" $... }\\` }`;\n\n/** Version a provider currently declares, if it declares one. */\nconst declaredProviderVersion = async (\n  tree: Tree,\n  path: string,\n  provider: string,\n): Promise<string | undefined> => {\n  const [captured] = await captureAllGritQL(\n    tree,\n    path,\n    providerVersionPattern(provider),\n  );\n  // The match is the whole attribute, e.g. `version = \"6.40.0\"`.\n  return /\"([^\"]+)\"/.exec(captured ?? '')?.[1];\n};\n\n/** Sync vended provider versions in every `.tf` file. */\nconst syncTerraformProviders = async (tree: Tree): Promise<string[]> => {\n  const updated: string[] = [];\n  const terraformFiles: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (path.endsWith('.tf')) {\n      terraformFiles.push(path);\n    }\n  });\n\n  for (const path of terraformFiles) {\n    let changed = false;\n    for (const [provider, vended] of Object.entries(TERRAFORM_VERSIONS)) {\n      const declared = await declaredProviderVersion(tree, path, provider);\n      if (!declared || !isVendedUpgrade(vended, declared)) {\n        continue;\n      }\n      changed =\n        (await applyGritQL(\n          tree,\n          path,\n          providerVersionPattern(provider, ` => \\`version = \"${vended}\"\\``),\n        )) || changed;\n    }\n    if (changed) {\n      updated.push(path);\n    }\n  }\n\n  return updated;\n};\n\n/**\n * Sync the versions this release vends, for the dependencies the workspace's\n * generators own.\n */\nexport const syncVendedVersions = async (\n  tree: Tree,\n): Promise<MigrationReturnObject> => {\n  const nextSteps: string[] = [];\n  const owned = await ownedDependencies(tree);\n\n  const packageJsons = syncPackageJsons(tree, owned);\n  const catalogs = syncOrphanCatalogEntries(tree, owned);\n  const overrides = syncOverrides(tree, owned);\n  const pyProjects = syncPyProjects(tree, owned);\n  const terraformFiles = await syncTerraformProviders(tree);\n  const skippedEmbedded = await syncEmbeddedVersions(tree, owned);\n  await syncMetricsVersion(tree);\n\n  // Lock files are left to the user: `nx migrate` only installs when the root\n  // manifest changes, and never runs `uv` or `terraform`.\n  if (catalogs.length > 0 || packageJsons.length > 0 || overrides.length > 0) {\n    nextSteps.push(\n      `TypeScript dependency versions were updated. Run \\`${buildInstallCommand(\n        detectPackageManager(tree.root),\n      )}\\` to update the lock file.`,\n    );\n  }\n  if (pyProjects.length > 0) {\n    nextSteps.push(\n      `Python dependency versions were updated in ${pyProjects.join(', ')}. Run \\`uv sync\\` to update uv.lock.`,\n    );\n  }\n  if (terraformFiles.length > 0) {\n    nextSteps.push(\n      `Terraform provider versions were updated in ${terraformFiles.length} file(s). Run \\`terraform init -upgrade\\` in each Terraform project to update its lock file.`,\n    );\n  }\n  // A synced embedded pin needs no next step — it is read the next time the thing\n  // holding it runs. A file the sync left alone does: its versions are still the\n  // old ones, and only the user can reconcile that.\n  if (skippedEmbedded.length > 0) {\n    nextSteps.push(\n      `Version pins were left as they are in ${skippedEmbedded.join(', ')}, which repeat a pin more times than this migration rewrites at once. Update them by hand.`,\n    );\n  }\n\n  // Without this the workspace's own format check fails on the migrated files.\n  await formatFilesInSubtree(tree);\n\n  return { nextSteps };\n};\n"],"names":["addDependenciesToPackageJson","detectPackageManager","readJson","updateJson","visitNotIgnoredFiles","yaml","getCatalogManager","parsePipRequirementsLine","coerce","parse","satisfies","validRange","applyGritQL","captureAllGritQL","buildInstallCommand","formatFilesInSubtree","updateToml","PY_VERSIONS","TERRAFORM_VERSIONS","TS_VERSIONS","isNxPackage","ownedDependencies","syncEmbeddedVersions","syncMetricsVersion","isVendedUpgrade","YAML_WORKSPACE_FILES","vendedTsVersion","owned","name","ts","has","undefined","vendedPyVersion","py","replace","REFERENCE_PROTOCOL","isSyncableSpecifier","tree","declared","test","startsWith","root","alreadyPermitsVended","packageName","vended","range","resolved","resolveCatalogReference","trim","declaredVendedPackages","packageJsonPath","json","pick","field","Object","fromEntries","entries","flatMap","dependencies","devDependencies","syncPackageJsons","updated","path","endsWith","keys","length","before","read","catalogsBefore","readCatalogFiles","push","map","exists","join","syncOrphanCatalogEntries","referenced","referencedCatalogPackages","syncCatalog","catalog","changed","String","catalogFile","load","values","catalogs","some","Boolean","write","dump","quotingType","overriddenPackage","key","segments","split","reduce","acc","part","previous","includes","at","lastIndexOf","slice","overrideLocations","manifestFields","workspaceFile","syncOverrides","syncOverrideTree","overrides","value","pnpm","contents","Set","add","pyRangePermitsVended","specs","every","spec","version","bound","includePrerelease","operator","syncPyRequirement","requirement","parsed","type","versionSpec","extras","first","isExactPin","syncPyProjects","syncRequirements","requirements","Array","isArray","synced","toml","project","groups","group","providerVersionPattern","provider","rewrite","declaredProviderVersion","captured","exec","syncTerraformProviders","terraformFiles","syncVendedVersions","nextSteps","packageJsons","pyProjects","skippedEmbedded"],"mappings":"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"}

package/src/utils/version-upgrade-migration/vended-upgrade.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Whether the vended version is a strict upgrade on the declared one.
+ *
+ * Only an exact declared version is upgraded: a range is the user's choice, and
+ * a reference (`catalog:`, `workspace:*`, a tag) holds its version elsewhere.
+ *
+ * Used for Python pins, Terraform providers and catalog entries no manifest
+ * references. TypeScript dependencies go through devkit instead.
+ */
+export declare const isVendedUpgrade: (vended: string, declared: string) => boolean;

package/src/utils/version-upgrade-migration/vended-upgrade.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { coerce, gt, validRange } from "semver";
+/**
+ * Whether the vended version is a strict upgrade on the declared one.
+ *
+ * Only an exact declared version is upgraded: a range is the user's choice, and
+ * a reference (`catalog:`, `workspace:*`, a tag) holds its version elsewhere.
+ *
+ * Used for Python pins, Terraform providers and catalog entries no manifest
+ * references. TypeScript dependencies go through devkit instead.
+ */ export const isVendedUpgrade = (vended, declared)=>{
+    const vendedParsed = coerce(vended, {
+        includePrerelease: true
+    });
+    if (!vendedParsed) {
+        return false;
+    }
+    if (!isSemverRange(declared)) {
+        return false;
+    }
+    const declaredParsed = parseExact(declared);
+    return declaredParsed ? gt(vendedParsed, declaredParsed) : false;
+};
+/** Empty is `*` to semver, so it is excluded explicitly. */ const isSemverRange = (specifier)=>{
+    const trimmed = specifier.trim();
+    return trimmed.length > 0 && validRange(trimmed) !== null;
+};
+/** Coerce only an exact version, leaving ranges unparsed. */ const parseExact = (specifier)=>{
+    const trimmed = specifier.trim();
+    if (/[\s|^~><*]|\|\||:/.test(trimmed)) {
+        return null;
+    }
+    return coerce(trimmed, {
+        includePrerelease: true
+    });
+};
+
+//# sourceMappingURL=vended-upgrade.js.map