@aws/nx-plugin 1.0.0-rc.57 → 1.0.0-rc.59

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

@@ -0,0 +1,304 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { visitNotIgnoredFiles } from "@nx/devkit";
+import { applyGritQL } from "../ast.js";
+import { BASE_IMAGES, CONTAINER_REPOSITORIES, CONTAINER_VERSIONS, PY_VERSIONS, TS_VERSIONS } from "../versions.js";
+import { ownedForFile } from "./owned-dependencies.js";
+import { isVendedUpgrade } from "./vended-upgrade.js";
+/** Escape a package name or image reference for use inside a regex. */ const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Characters that end a pinned version: whitespace, the backslash continuing a
+ * shell line, and the quote closing the string the pin sits in.
+ *
+ * The quote is escaped because the pattern is itself a double-quoted GritQL
+ * regex literal, which a bare quote would terminate.
+ */ const VERSION_TERMINATORS = '\\s\\\\\\"';
+/**
+ * Rewrite the capture group of an anchored regex to the vended version.
+ *
+ * The leading and trailing `[\s\S]*` anchor the match to the whole file, which
+ * is what lets a capture group be rewritten on its own: GritQL binds the group
+ * to a node it can replace, leaving every other byte untouched. Without the
+ * anchors nothing matches.
+ */ const rewriteCapture = (pattern, vended)=>`r"[\\s\\S]*${pattern}[\\s\\S]*"($version) where { $version => \`${vended}\` }`;
+/**
+ * Versions a pin's regex currently matches in the file.
+ *
+ * Read before rewriting so a version the user raised past what this release
+ * vends is left alone, matching how every other surface behaves.
+ */ const declaredVersions = (contents, pattern)=>{
+    const matches = contents.matchAll(new RegExp(pattern, 'g'));
+    return [
+        ...matches
+    ].flatMap((match)=>match[1] ? [
+            match[1]
+        ] : []);
+};
+/**
+ * Occurrences of one pin a single rewrite will handle.
+ *
+ * GritQL rewrites each match separately, so its cost grows with how many a
+ * pattern matches — ~10ms an occurrence, which a hand-authored file with hundreds
+ * of `RUN npm install` lines turns into minutes of an unattended `nx migrate`.
+ * Past this the file is left alone and reported, since a wrong version the user
+ * can see and fix beats an upgrade that appears to hang.
+ */ const MAX_OCCURRENCES_PER_PIN = 100;
+/**
+ * Apply the pins whose declared version this release moves forward.
+ *
+ * A single rewrite covers every occurrence of a pin in the file, so each pin is
+ * applied once. Reports whether anything changed, and whether a pin was left
+ * alone for exceeding {@link MAX_OCCURRENCES_PER_PIN}.
+ */ const applyPins = async (tree, path, pins)=>{
+    // Read once and re-read only after a rewrite: a rewrite parses the whole file,
+    // and there is a pin per owned package, so re-reading per pin would scale the
+    // cost of a large file with the size of the owned set.
+    let contents = tree.read(path, 'utf-8') ?? '';
+    let changed = false;
+    let skipped = false;
+    for (const { pattern, vended, kind = 'version' } of pins){
+        const declared = declaredVersions(contents, pattern);
+        if (declared.length === 0) {
+            continue;
+        }
+        if (declared.length > MAX_OCCURRENCES_PER_PIN) {
+            skipped = true;
+            continue;
+        }
+        const outOfDate = kind === 'tag' ? (tag)=>tag !== vended : (version)=>isVendedUpgrade(vended, version);
+        // A rewrite replaces every occurrence at once, so this must hold for all of
+        // them — a pin already at or beyond the vended version is left as it is.
+        if (!declared.every(outOfDate)) {
+            continue;
+        }
+        if (await applyGritQL(tree, path, rewriteCapture(pattern, vended))) {
+            contents = tree.read(path, 'utf-8') ?? '';
+            changed = true;
+        }
+    }
+    return {
+        changed,
+        skipped
+    };
+};
+/**
+ * The version this release vends for a package, or undefined for one it doesn't
+ * vend at all.
+ *
+ * Ownership is applied by the caller, which only ever passes a name drawn from
+ * the owned set — so a package the user pinned themselves never reaches here and
+ * keeps the version they chose.
+ */ const vendedTsVersion = (name)=>TS_VERSIONS[name];
+/** `PY_VERSIONS` records the `==` operator; a pin holds the bare version. */ const vendedPyVersion = (name)=>PY_VERSIONS[name]?.replace(/^==/, '');
+/**
+ * The ways a generated `Dockerfile` pins a TypeScript package's version, as
+ * regex fragments taking the escaped package name.
+ *
+ * The name is required to run to its delimiter, so a package whose name merely
+ * ends with another's — `some-npm` against `npm` — cannot match, and an
+ * installed version must start with a digit so a `@latest` style tag is left
+ * alone.
+ */ const DOCKERFILE_PIN_SHAPES = [
+    // Installed by the image build. `install` and its `i` alias are both used, as
+    // are `-g` and several packages in one command, so the name only has to follow
+    // an `npm` subcommand rather than sit right after it. The whitespace before it
+    // is matched rather than asserted, since GritQL's regex engine has no
+    // lookbehind — which also keeps `some-npm` from matching `npm`, and unlike a
+    // `\b` boundary still reaches a `@scope/name`.
+    (name)=>`npm (?:install|i|add)[^\\n]*?\\s${name}@([0-9][^${VERSION_TERMINATORS}]*)`,
+    // Held at a fixed version through an `npm pkg set` override, to clear a known
+    // vulnerability in a transitive dependency.
+    (name)=>`overrides\\.${name}=([^${VERSION_TERMINATORS}]+)`
+];
+/**
+ * Every pin a generated `Dockerfile` may carry, for the packages owned where it
+ * sits.
+ *
+ * Driven off the owned packages rather than a list of the ones that happen to be
+ * pinned today: a pin added to a template in a later release is then covered
+ * without this module changing, which is the whole point — the versions baked
+ * into image builds are pinned precisely because they clear a known
+ * vulnerability.
+ *
+ * A package the user pinned themselves is not owned, so it is never matched.
+ */ const dockerfilePins = (owned)=>{
+    const pins = [];
+    for (const name of owned.ts){
+        const vended = vendedTsVersion(name);
+        if (!vended) {
+            continue;
+        }
+        for (const shape of DOCKERFILE_PIN_SHAPES){
+            pins.push({
+                pattern: shape(escapeRegExp(name)),
+                vended
+            });
+        }
+    }
+    for (const image of Object.values(BASE_IMAGES)){
+        const [repository, tag] = splitImageReference(image);
+        pins.push({
+            // Only a `FROM` that is the whole instruction. A build stage names itself
+            // — `FROM <repo>:24 AS builder` — and picks its tag for what that stage has
+            // to run: the smithy builder needs curl and unzip, which the slim tag this
+            // release vends for a runtime image does not carry. Rewriting it would
+            // break the build, and the two share a repository, so the instruction
+            // ending is what separates them.
+            pattern: `FROM ${escapeRegExp(repository)}:([^\\s]+)\\n`,
+            vended: tag,
+            kind: 'tag'
+        });
+    }
+    return pins;
+};
+/**
+ * The repository and tag of a pinned image reference. The tag is the part after
+ * the last `:`, which a registry port would otherwise be mistaken for — every
+ * reference here carries one.
+ */ const splitImageReference = (image)=>{
+    const at = image.lastIndexOf(':');
+    return [
+        image.slice(0, at),
+        image.slice(at + 1)
+    ];
+};
+/**
+ * Whether a file is a Dockerfile: exactly `Dockerfile`, or the `<name>.Dockerfile`
+ * form the smithy templates vend as `build.Dockerfile`.
+ *
+ * Deliberately exact rather than a prefix match, which would also claim a
+ * `Dockerfile.bak` or a `Dockerfile.md` the user keeps beside a real one.
+ */ export const isDockerfile = (filePath)=>{
+    const name = filePath.split('/').pop() ?? '';
+    return name === 'Dockerfile' || name.endsWith('.Dockerfile');
+};
+/**
+ * Sync the pins in every generated Dockerfile.
+ *
+ * Ownership is resolved per file, so a Dockerfile is only rewritten for the
+ * packages the project it belongs to owns — a sibling project owning `prisma`
+ * does not license rewriting a `prisma` pin here.
+ */ const syncDockerfiles = async (tree, owned)=>{
+    const dockerfiles = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (isDockerfile(path)) {
+            dockerfiles.push(path);
+        }
+    });
+    const skipped = [];
+    for (const path of dockerfiles){
+        const result = await applyPins(tree, path, dockerfilePins(ownedForFile(owned, path)));
+        if (result.skipped) {
+            skipped.push(path);
+        }
+    }
+    return skipped;
+};
+/** The `uv run --with` pins to apply, for the Python packages owned where a file sits. */ const terraformScriptPins = (owned)=>[
+        ...owned.py
+    ].flatMap((name)=>{
+        const vended = vendedPyVersion(name);
+        return vended ? [
+            {
+                pattern: `--with ${escapeRegExp(name)}==([^${VERSION_TERMINATORS}]+)`,
+                vended
+            }
+        ] : [];
+    });
+/**
+ * Sync the Python pins a generated Terraform inline script runs through
+ * `uv run --with <package>==<version>`.
+ *
+ * These are the plugin's own pins, in a file the Terraform provider sync already
+ * visits but only reads `required_providers` from. Driven off the owned Python
+ * packages, so a pin added to a template later is covered without a change here.
+ *
+ * Scoped per file like the Dockerfiles. The modules carrying these live in the
+ * shared Terraform project, which no single generator owns — a file there belongs
+ * to no project, so it takes the workspace-wide union, which is the set of
+ * generators that legitimately write into it.
+ */ const syncTerraformScriptPins = async (tree, owned)=>{
+    const terraformFiles = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (path.endsWith('.tf')) {
+            terraformFiles.push(path);
+        }
+    });
+    const skipped = [];
+    for (const path of terraformFiles){
+        const result = await applyPins(tree, path, terraformScriptPins(ownedForFile(owned, path)));
+        if (result.skipped) {
+            skipped.push(path);
+        }
+    }
+    return skipped;
+};
+/**
+ * The ways a `uvx` invocation pins a Python version: the tool it runs, and any
+ * package it adds to that tool's environment.
+ *
+ * A command string is JSON here, so a quote ends a version too.
+ */ const UVX_PIN_SHAPES = [
+    (name)=>`uvx --from ${name}==`,
+    (name)=>`--with ${name}==`
+];
+/**
+ * Sync the pinned tools a `project.json` target command runs: a container image,
+ * and the Python versions a `uvx` invocation pins.
+ *
+ * Both are built into the command string rather than declared as a dependency, so
+ * nothing else reaches them. The images are driven off `CONTAINER_REPOSITORIES`
+ * and the Python versions off `PY_VERSIONS`, so a tool pinned in a target command
+ * later is covered without a change here — the same property the Dockerfile and
+ * Terraform paths get from the owned set.
+ *
+ * Unscoped, unlike the file-body pins: a `uvx` invocation installs nothing into
+ * the project, so there is no dependency for a generator to own. A version is only
+ * rewritten where this release vends that exact package at a higher one.
+ */ const syncTargetToolPins = async (tree)=>{
+    const projectJsons = [];
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (path.endsWith('project.json')) {
+            projectJsons.push(path);
+        }
+    });
+    const pins = [
+        ...Object.entries(CONTAINER_REPOSITORIES).map(([tool, repository])=>({
+                // A command string is JSON here, so a quote ends the reference too.
+                pattern: `${escapeRegExp(repository)}:([^${VERSION_TERMINATORS}']+)`,
+                vended: CONTAINER_VERSIONS[tool]
+            })),
+        ...Object.keys(PY_VERSIONS).flatMap((name)=>{
+            const vended = vendedPyVersion(name);
+            return vended ? UVX_PIN_SHAPES.map((shape)=>({
+                    pattern: `${shape(escapeRegExp(name))}([^${VERSION_TERMINATORS}']+)`,
+                    vended
+                })) : [];
+        })
+    ];
+    const skipped = [];
+    for (const path of projectJsons){
+        if ((await applyPins(tree, path, pins)).skipped) {
+            skipped.push(path);
+        }
+    }
+    return skipped;
+};
+/**
+ * Sync the vended versions baked into generated file bodies: `Dockerfile` pins,
+ * the Python pins in Terraform inline scripts, and the tooling images
+ * `project.json` target commands run.
+ *
+ * Reports only the files left for the user: a pin that takes effect the next time
+ * the thing holding it runs needs no follow-up, but one this skipped for holding
+ * more occurrences than it will rewrite at once does.
+ *
+ * @returns paths whose pins were left as they were
+ */ export const syncEmbeddedVersions = async (tree, owned)=>[
+        ...await syncDockerfiles(tree, owned),
+        ...await syncTerraformScriptPins(tree, owned),
+        ...await syncTargetToolPins(tree)
+    ];
+
+//# sourceMappingURL=sync-embedded-versions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/version-upgrade-migration/sync-embedded-versions.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { visitNotIgnoredFiles } from '@nx/devkit';\nimport { applyGritQL } from '../ast';\nimport {\n  BASE_IMAGES,\n  CONTAINER_REPOSITORIES,\n  CONTAINER_VERSIONS,\n  PY_VERSIONS,\n  TS_VERSIONS,\n} from '../versions';\nimport { type OwnedDependencies, ownedForFile } from './owned-dependencies';\nimport { isVendedUpgrade } from './vended-upgrade';\n\n/**\n * Sync the vended versions generators bake into the body of a file rather than\n * into a manifest: the container image pins in a `Dockerfile`, the Python pins\n * in a Terraform inline script, and the tooling images a `project.json` target\n * command runs.\n *\n * Every version here is pinned to clear a known HIGH/CRITICAL vulnerability, or\n * to keep a generated image reproducible, so leaving them behind strands a\n * workspace on exactly the versions most in need of an upgrade.\n *\n * These sit inside shell commands, which GritQL has no grammar for — so instead\n * of pattern-matching the surrounding syntax, each pin is located by an anchored\n * regex whose single capture group is the version, and only that capture is\n * rewritten. The file's own text around it is never reconstructed, so a\n * reformatted or hand-edited file syncs the same way a freshly generated one\n * does.\n */\n\n/** A pin found in a file body, and the version this release vends for it. */\ninterface EmbeddedPin {\n  /** Regex matching the pin, with the version as its only capture group. */\n  readonly pattern: string;\n  readonly vended: string;\n  /**\n   * Whether the declared value is a version to move forward, or a tag to replace\n   * whenever it differs. A tag — `lts-slim`, say — has no ordering to compare, so\n   * one that isn't what this release vends is simply out of date.\n   */\n  readonly kind?: 'version' | 'tag';\n}\n\n/** Escape a package name or image reference for use inside a regex. */\nconst escapeRegExp = (value: string): string =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * Characters that end a pinned version: whitespace, the backslash continuing a\n * shell line, and the quote closing the string the pin sits in.\n *\n * The quote is escaped because the pattern is itself a double-quoted GritQL\n * regex literal, which a bare quote would terminate.\n */\nconst VERSION_TERMINATORS = '\\\\s\\\\\\\\\\\\\"';\n\n/**\n * Rewrite the capture group of an anchored regex to the vended version.\n *\n * The leading and trailing `[\\s\\S]*` anchor the match to the whole file, which\n * is what lets a capture group be rewritten on its own: GritQL binds the group\n * to a node it can replace, leaving every other byte untouched. Without the\n * anchors nothing matches.\n */\nconst rewriteCapture = (pattern: string, vended: string): string =>\n  `r\"[\\\\s\\\\S]*${pattern}[\\\\s\\\\S]*\"($version) where { $version => \\`${vended}\\` }`;\n\n/**\n * Versions a pin's regex currently matches in the file.\n *\n * Read before rewriting so a version the user raised past what this release\n * vends is left alone, matching how every other surface behaves.\n */\nconst declaredVersions = (contents: string, pattern: string): string[] => {\n  const matches = contents.matchAll(new RegExp(pattern, 'g'));\n  return [...matches].flatMap((match) => (match[1] ? [match[1]] : []));\n};\n\n/**\n * Occurrences of one pin a single rewrite will handle.\n *\n * GritQL rewrites each match separately, so its cost grows with how many a\n * pattern matches — ~10ms an occurrence, which a hand-authored file with hundreds\n * of `RUN npm install` lines turns into minutes of an unattended `nx migrate`.\n * Past this the file is left alone and reported, since a wrong version the user\n * can see and fix beats an upgrade that appears to hang.\n */\nconst MAX_OCCURRENCES_PER_PIN = 100;\n\n/**\n * Apply the pins whose declared version this release moves forward.\n *\n * A single rewrite covers every occurrence of a pin in the file, so each pin is\n * applied once. Reports whether anything changed, and whether a pin was left\n * alone for exceeding {@link MAX_OCCURRENCES_PER_PIN}.\n */\nconst applyPins = async (\n  tree: Tree,\n  path: string,\n  pins: readonly EmbeddedPin[],\n): Promise<{ changed: boolean; skipped: boolean }> => {\n  // Read once and re-read only after a rewrite: a rewrite parses the whole file,\n  // and there is a pin per owned package, so re-reading per pin would scale the\n  // cost of a large file with the size of the owned set.\n  let contents = tree.read(path, 'utf-8') ?? '';\n  let changed = false;\n  let skipped = false;\n\n  for (const { pattern, vended, kind = 'version' } of pins) {\n    const declared = declaredVersions(contents, pattern);\n    if (declared.length === 0) {\n      continue;\n    }\n    if (declared.length > MAX_OCCURRENCES_PER_PIN) {\n      skipped = true;\n      continue;\n    }\n    const outOfDate =\n      kind === 'tag'\n        ? (tag: string) => tag !== vended\n        : (version: string) => isVendedUpgrade(vended, version);\n    // A rewrite replaces every occurrence at once, so this must hold for all of\n    // them — a pin already at or beyond the vended version is left as it is.\n    if (!declared.every(outOfDate)) {\n      continue;\n    }\n    if (await applyGritQL(tree, path, rewriteCapture(pattern, vended))) {\n      contents = tree.read(path, 'utf-8') ?? '';\n      changed = true;\n    }\n  }\n\n  return { changed, skipped };\n};\n\n/**\n * The version this release vends for a package, or undefined for one it doesn't\n * vend at all.\n *\n * Ownership is applied by the caller, which only ever passes a name drawn from\n * the owned set — so a package the user pinned themselves never reaches here and\n * keeps the version they chose.\n */\nconst vendedTsVersion = (name: string): string | undefined =>\n  TS_VERSIONS[name as keyof typeof TS_VERSIONS];\n\n/** `PY_VERSIONS` records the `==` operator; a pin holds the bare version. */\nconst vendedPyVersion = (name: string): string | undefined =>\n  PY_VERSIONS[name as keyof typeof PY_VERSIONS]?.replace(/^==/, '');\n\n/**\n * The ways a generated `Dockerfile` pins a TypeScript package's version, as\n * regex fragments taking the escaped package name.\n *\n * The name is required to run to its delimiter, so a package whose name merely\n * ends with another's — `some-npm` against `npm` — cannot match, and an\n * installed version must start with a digit so a `@latest` style tag is left\n * alone.\n */\nconst DOCKERFILE_PIN_SHAPES: readonly ((name: string) => string)[] = [\n  // Installed by the image build. `install` and its `i` alias are both used, as\n  // are `-g` and several packages in one command, so the name only has to follow\n  // an `npm` subcommand rather than sit right after it. The whitespace before it\n  // is matched rather than asserted, since GritQL's regex engine has no\n  // lookbehind — which also keeps `some-npm` from matching `npm`, and unlike a\n  // `\\b` boundary still reaches a `@scope/name`.\n  (name) =>\n    `npm (?:install|i|add)[^\\\\n]*?\\\\s${name}@([0-9][^${VERSION_TERMINATORS}]*)`,\n  // Held at a fixed version through an `npm pkg set` override, to clear a known\n  // vulnerability in a transitive dependency.\n  (name) => `overrides\\\\.${name}=([^${VERSION_TERMINATORS}]+)`,\n];\n\n/**\n * Every pin a generated `Dockerfile` may carry, for the packages owned where it\n * sits.\n *\n * Driven off the owned packages rather than a list of the ones that happen to be\n * pinned today: a pin added to a template in a later release is then covered\n * without this module changing, which is the whole point — the versions baked\n * into image builds are pinned precisely because they clear a known\n * vulnerability.\n *\n * A package the user pinned themselves is not owned, so it is never matched.\n */\nconst dockerfilePins = (owned: {\n  readonly ts: ReadonlySet<string>;\n}): EmbeddedPin[] => {\n  const pins: EmbeddedPin[] = [];\n\n  for (const name of owned.ts) {\n    const vended = vendedTsVersion(name);\n    if (!vended) {\n      continue;\n    }\n    for (const shape of DOCKERFILE_PIN_SHAPES) {\n      pins.push({ pattern: shape(escapeRegExp(name)), vended });\n    }\n  }\n\n  for (const image of Object.values(BASE_IMAGES)) {\n    const [repository, tag] = splitImageReference(image);\n    pins.push({\n      // Only a `FROM` that is the whole instruction. A build stage names itself\n      // — `FROM <repo>:24 AS builder` — and picks its tag for what that stage has\n      // to run: the smithy builder needs curl and unzip, which the slim tag this\n      // release vends for a runtime image does not carry. Rewriting it would\n      // break the build, and the two share a repository, so the instruction\n      // ending is what separates them.\n      pattern: `FROM ${escapeRegExp(repository)}:([^\\\\s]+)\\\\n`,\n      vended: tag,\n      kind: 'tag',\n    });\n  }\n\n  return pins;\n};\n\n/**\n * The repository and tag of a pinned image reference. The tag is the part after\n * the last `:`, which a registry port would otherwise be mistaken for — every\n * reference here carries one.\n */\nconst splitImageReference = (image: string): [string, string] => {\n  const at = image.lastIndexOf(':');\n  return [image.slice(0, at), image.slice(at + 1)];\n};\n\n/**\n * Whether a file is a Dockerfile: exactly `Dockerfile`, or the `<name>.Dockerfile`\n * form the smithy templates vend as `build.Dockerfile`.\n *\n * Deliberately exact rather than a prefix match, which would also claim a\n * `Dockerfile.bak` or a `Dockerfile.md` the user keeps beside a real one.\n */\nexport const isDockerfile = (filePath: string): boolean => {\n  const name = filePath.split('/').pop() ?? '';\n  return name === 'Dockerfile' || name.endsWith('.Dockerfile');\n};\n\n/**\n * Sync the pins in every generated Dockerfile.\n *\n * Ownership is resolved per file, so a Dockerfile is only rewritten for the\n * packages the project it belongs to owns — a sibling project owning `prisma`\n * does not license rewriting a `prisma` pin here.\n */\nconst syncDockerfiles = async (\n  tree: Tree,\n  owned: OwnedDependencies,\n): Promise<string[]> => {\n  const dockerfiles: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (isDockerfile(path)) {\n      dockerfiles.push(path);\n    }\n  });\n\n  const skipped: string[] = [];\n  for (const path of dockerfiles) {\n    const result = await applyPins(\n      tree,\n      path,\n      dockerfilePins(ownedForFile(owned, path)),\n    );\n    if (result.skipped) {\n      skipped.push(path);\n    }\n  }\n  return skipped;\n};\n\n/** The `uv run --with` pins to apply, for the Python packages owned where a file sits. */\nconst terraformScriptPins = (owned: {\n  readonly py: ReadonlySet<string>;\n}): EmbeddedPin[] =>\n  [...owned.py].flatMap((name) => {\n    const vended = vendedPyVersion(name);\n    return vended\n      ? [\n          {\n            pattern: `--with ${escapeRegExp(name)}==([^${VERSION_TERMINATORS}]+)`,\n            vended,\n          },\n        ]\n      : [];\n  });\n\n/**\n * Sync the Python pins a generated Terraform inline script runs through\n * `uv run --with <package>==<version>`.\n *\n * These are the plugin's own pins, in a file the Terraform provider sync already\n * visits but only reads `required_providers` from. Driven off the owned Python\n * packages, so a pin added to a template later is covered without a change here.\n *\n * Scoped per file like the Dockerfiles. The modules carrying these live in the\n * shared Terraform project, which no single generator owns — a file there belongs\n * to no project, so it takes the workspace-wide union, which is the set of\n * generators that legitimately write into it.\n */\nconst syncTerraformScriptPins = async (\n  tree: Tree,\n  owned: OwnedDependencies,\n): Promise<string[]> => {\n  const terraformFiles: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (path.endsWith('.tf')) {\n      terraformFiles.push(path);\n    }\n  });\n\n  const skipped: string[] = [];\n  for (const path of terraformFiles) {\n    const result = await applyPins(\n      tree,\n      path,\n      terraformScriptPins(ownedForFile(owned, path)),\n    );\n    if (result.skipped) {\n      skipped.push(path);\n    }\n  }\n  return skipped;\n};\n\n/**\n * The ways a `uvx` invocation pins a Python version: the tool it runs, and any\n * package it adds to that tool's environment.\n *\n * A command string is JSON here, so a quote ends a version too.\n */\nconst UVX_PIN_SHAPES: readonly ((name: string) => string)[] = [\n  (name) => `uvx --from ${name}==`,\n  (name) => `--with ${name}==`,\n];\n\n/**\n * Sync the pinned tools a `project.json` target command runs: a container image,\n * and the Python versions a `uvx` invocation pins.\n *\n * Both are built into the command string rather than declared as a dependency, so\n * nothing else reaches them. The images are driven off `CONTAINER_REPOSITORIES`\n * and the Python versions off `PY_VERSIONS`, so a tool pinned in a target command\n * later is covered without a change here — the same property the Dockerfile and\n * Terraform paths get from the owned set.\n *\n * Unscoped, unlike the file-body pins: a `uvx` invocation installs nothing into\n * the project, so there is no dependency for a generator to own. A version is only\n * rewritten where this release vends that exact package at a higher one.\n */\nconst syncTargetToolPins = async (tree: Tree): Promise<string[]> => {\n  const projectJsons: string[] = [];\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (path.endsWith('project.json')) {\n      projectJsons.push(path);\n    }\n  });\n\n  const pins: EmbeddedPin[] = [\n    ...Object.entries(CONTAINER_REPOSITORIES).map(([tool, repository]) => ({\n      // A command string is JSON here, so a quote ends the reference too.\n      pattern: `${escapeRegExp(repository)}:([^${VERSION_TERMINATORS}']+)`,\n      vended: CONTAINER_VERSIONS[tool as keyof typeof CONTAINER_VERSIONS],\n    })),\n    ...Object.keys(PY_VERSIONS).flatMap((name) => {\n      const vended = vendedPyVersion(name);\n      return vended\n        ? UVX_PIN_SHAPES.map((shape) => ({\n            pattern: `${shape(escapeRegExp(name))}([^${VERSION_TERMINATORS}']+)`,\n            vended,\n          }))\n        : [];\n    }),\n  ];\n\n  const skipped: string[] = [];\n  for (const path of projectJsons) {\n    if ((await applyPins(tree, path, pins)).skipped) {\n      skipped.push(path);\n    }\n  }\n  return skipped;\n};\n\n/**\n * Sync the vended versions baked into generated file bodies: `Dockerfile` pins,\n * the Python pins in Terraform inline scripts, and the tooling images\n * `project.json` target commands run.\n *\n * Reports only the files left for the user: a pin that takes effect the next time\n * the thing holding it runs needs no follow-up, but one this skipped for holding\n * more occurrences than it will rewrite at once does.\n *\n * @returns paths whose pins were left as they were\n */\nexport const syncEmbeddedVersions = async (\n  tree: Tree,\n  owned: OwnedDependencies,\n): Promise<string[]> => [\n  ...(await syncDockerfiles(tree, owned)),\n  ...(await syncTerraformScriptPins(tree, owned)),\n  ...(await syncTargetToolPins(tree)),\n];\n"],"names":["visitNotIgnoredFiles","applyGritQL","BASE_IMAGES","CONTAINER_REPOSITORIES","CONTAINER_VERSIONS","PY_VERSIONS","TS_VERSIONS","ownedForFile","isVendedUpgrade","escapeRegExp","value","replace","VERSION_TERMINATORS","rewriteCapture","pattern","vended","declaredVersions","contents","matches","matchAll","RegExp","flatMap","match","MAX_OCCURRENCES_PER_PIN","applyPins","tree","path","pins","read","changed","skipped","kind","declared","length","outOfDate","tag","version","every","vendedTsVersion","name","vendedPyVersion","DOCKERFILE_PIN_SHAPES","dockerfilePins","owned","ts","shape","push","image","Object","values","repository","splitImageReference","at","lastIndexOf","slice","isDockerfile","filePath","split","pop","endsWith","syncDockerfiles","dockerfiles","result","terraformScriptPins","py","syncTerraformScriptPins","terraformFiles","UVX_PIN_SHAPES","syncTargetToolPins","projectJsons","entries","map","tool","keys","syncEmbeddedVersions"],"mappings":"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"}

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

@@ -13,6 +13,7 @@ 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";
 /**
@@ -39,6 +40,12 @@ import { isVendedUpgrade } from "./vended-upgrade.js";
  * 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;
     }
@@ -482,6 +489,7 @@ const syncOverrides = (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`.
@@ -494,6 +502,12 @@ const syncOverrides = (tree, owned)=>{
     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 {

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

@@ -1 +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 { 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: string): boolean => {\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  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\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","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"],"mappings":"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"}
+{"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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"}