@aws/nx-plugin 1.0.0-rc.22 → 1.0.0-rc.24

package/src/utils/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/metrics.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { joinPathFragments, type Tree } from '@nx/devkit';\nimport { applyGritQL, captureAllGritQL } from './ast';\nimport { formatFilesInSubtree } from './format';\nimport { getPackageVersion, type NxGeneratorInfo } from './nx';\nimport {\n  PACKAGES_DIR,\n  SHARED_CONSTRUCTS_DIR,\n  SHARED_TERRAFORM_DIR,\n} from './shared-constructs-constants';\n\n// Used to identify @aws/nx-plugin in AWS metrics\nexport const METRIC_ID = 'uksb-4wk0bqpg5s';\n\n// File in which the MetricsAspect may exist (CDK)\nexport const METRICS_ASPECT_FILE_PATH = joinPathFragments(\n  PACKAGES_DIR,\n  SHARED_CONSTRUCTS_DIR,\n  'src',\n  'core',\n  'app.ts',\n);\n\n// File in which the Terraform metrics CloudFormation stack may exist\nexport const TERRAFORM_METRICS_FILE_PATH = joinPathFragments(\n  PACKAGES_DIR,\n  SHARED_TERRAFORM_DIR,\n  'src',\n  'metrics',\n  'metrics.tf',\n);\n\n// GritQL `within` clause to scope matches to the MetricsAspect class body\nconst WITHIN_METRICS_ASPECT =\n  '$old <: within `class MetricsAspect implements $_ { $_ }`';\n\n// Strip the surrounding quotes from a captured string literal (eg 'g1' or \"g1\")\nconst unquote = (literal: string): string => literal.slice(1, -1);\n\n// Extracts the existing metric tags from the CDK MetricsAspect tags array\nconst readCdkMetricTags = async (tree: Tree): Promise<string[]> =>\n  (\n    await captureAllGritQL(\n      tree,\n      METRICS_ASPECT_FILE_PATH,\n      `\\`$tag\\` where { $tag <: string(), $tag <: within \\`const tags: string[] = $_\\` }`,\n    )\n  ).map(unquote);\n\n// Extracts the existing metric tags from the Terraform metric_tags array\nconst readTerraformMetricTags = async (tree: Tree): Promise<string[]> =>\n  (\n    await captureAllGritQL(\n      tree,\n      TERRAFORM_METRICS_FILE_PATH,\n      '`\"$tag\"` where { $tag <: within `metric_tags = $_` }',\n    )\n  ).map(unquote);\n\n/**\n * Instruments metrics by updating the MetricsAspect in common/constructs/src/core/app.ts if the file exists,\n * and/or updating the Terraform metrics CloudFormation stack if it exists.\n *\n * Both files are converged to the same tag set (the union of tags already\n * present in either file plus the incoming generators). This keeps the tag set\n * deterministic regardless of the order in which metrics files are created\n * across a multi-generator run, so re-running the same set of generators does\n * not grow the tags.\n */\nexport const addGeneratorMetricsIfApplicable = async (\n  tree: Tree,\n  generatorInfo: NxGeneratorInfo[],\n) => {\n  const cdkExists = tree.exists(METRICS_ASPECT_FILE_PATH);\n  const terraformExists = tree.exists(TERRAFORM_METRICS_FILE_PATH);\n\n  if (!cdkExists && !terraformExists) {\n    return;\n  }\n\n  // Converge both files to the union of all known tags so the set is stable\n  // regardless of when each metrics file was created.\n  const tags = [\n    ...new Set([\n      ...(await readCdkMetricTags(tree)),\n      ...(await readTerraformMetricTags(tree)),\n      ...generatorInfo.map((info) => info.metric),\n    ]),\n  ];\n\n  if (cdkExists) {\n    await updateCdkMetrics(tree, tags);\n  }\n\n  if (terraformExists) {\n    await updateTerraformMetrics(tree, tags);\n  }\n};\n\n/**\n * Updates the CDK MetricsAspect with the metric id, version and tags\n */\nconst updateCdkMetrics = async (tree: Tree, tags: string[]) => {\n  // Update the id\n  await applyGritQL(\n    tree,\n    METRICS_ASPECT_FILE_PATH,\n    `\\`const id = $old\\` => \\`const id = '${METRIC_ID}'\\`` +\n      ` where { ${WITHIN_METRICS_ASPECT} }`,\n  );\n\n  // Update the version\n  await applyGritQL(\n    tree,\n    METRICS_ASPECT_FILE_PATH,\n    `\\`const version = $old\\` => \\`const version = '${getPackageVersion()}'\\`` +\n      ` where { ${WITHIN_METRICS_ASPECT} }`,\n  );\n\n  // Add each tag, leaving existing tags in place to keep re-runs stable\n  for (const tag of tags) {\n    await applyGritQL(\n      tree,\n      METRICS_ASPECT_FILE_PATH,\n      `\\`const tags: string[] = $old\\`` +\n        ` where { ${WITHIN_METRICS_ASPECT},` +\n        ` if ($old <: \\`[]\\`) { $old => \\`['${tag}']\\` }` +\n        ` else { $old <: \\`[$items]\\` where { $items += \\`, '${tag}'\\` } },` +\n        ` $old <: not contains \\`'${tag}'\\` }`,\n    );\n  }\n\n  await formatFilesInSubtree(tree, METRICS_ASPECT_FILE_PATH);\n};\n\n/**\n * Updates the Terraform metrics CloudFormation stack with the metric id, version and tags\n */\nconst updateTerraformMetrics = async (tree: Tree, tags: string[]) => {\n  // Update metric_id\n  await applyGritQL(\n    tree,\n    TERRAFORM_METRICS_FILE_PATH,\n    `\\`metric_id = $old\\` => \\`metric_id = \"${METRIC_ID}\"\\``,\n  );\n\n  // Update metric_version\n  await applyGritQL(\n    tree,\n    TERRAFORM_METRICS_FILE_PATH,\n    `\\`metric_version = $old\\` => \\`metric_version = \"${getPackageVersion()}\"\\``,\n  );\n\n  // Add each tag, leaving existing tags in place to keep re-runs stable\n  for (const tag of tags) {\n    await applyGritQL(\n      tree,\n      TERRAFORM_METRICS_FILE_PATH,\n      `or { \\`metric_tags = []\\` => \\`metric_tags = [\"${tag}\"]\\`,` +\n        ` \\`metric_tags = [$items]\\` where { $items += \\`, \"${tag}\"\\` }` +\n        ` where { $items <: not contains \\`\"${tag}\"\\` } }`,\n    );\n  }\n};\n"],"names":["joinPathFragments","applyGritQL","captureAllGritQL","formatFilesInSubtree","getPackageVersion","PACKAGES_DIR","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_DIR","METRIC_ID","METRICS_ASPECT_FILE_PATH","TERRAFORM_METRICS_FILE_PATH","WITHIN_METRICS_ASPECT","unquote","literal","slice","readCdkMetricTags","tree","map","readTerraformMetricTags","addGeneratorMetricsIfApplicable","generatorInfo","cdkExists","exists","terraformExists","tags","Set","info","metric","updateCdkMetrics","updateTerraformMetrics","tag"],"mappings":"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"}

package/src/utils/mock-project-graph.js

@@ -1,10 +1,7 @@
-"use strict";
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
+ */ /**
  * Mock createProjectGraphAsync to avoid expensive project graph building in tests.
  *
  * This is the vitest equivalent of Nx's own internal testing utility:
@@ -15,13 +12,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * 2. @nx/devkit's exports are wrapped with read-only getters by vitest
  * 3. The CJS module at nx/src/project-graph/project-graph.js is the actual
  *    implementation that @nx/devkit re-exports
- */
-const module_1 = require("module");
-// @ts-expect-error test utility used by vite only
-const _require = (0, module_1.createRequire)(import.meta.url);
+ */ import { createRequire } from "module";
+const _require = createRequire(import.meta.url);
 const projectGraph = _require('nx/src/project-graph/project-graph');
-projectGraph.createProjectGraphAsync = async () => ({
-    nodes: {},
-    dependencies: {},
-});
+projectGraph.createProjectGraphAsync = async ()=>({
+        nodes: {},
+        dependencies: {}
+    });
+
 //# sourceMappingURL=mock-project-graph.js.map

package/src/utils/mock-project-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-project-graph.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/mock-project-graph.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH;;;;;;;;;;;GAWG;AACH,mCAAuC;AAEvC,kDAAkD;AAClD,MAAM,QAAQ,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AACpE,YAAY,CAAC,uBAAuB,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IAClD,KAAK,EAAE,EAAE;IACT,YAAY,EAAE,EAAE;CACjB,CAAC,CAAC"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/mock-project-graph.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Mock createProjectGraphAsync to avoid expensive project graph building in tests.\n *\n * This is the vitest equivalent of Nx's own internal testing utility:\n * https://github.com/nrwl/nx/blob/master/packages/nx/src/internal-testing-utils/mock-project-graph.ts\n *\n * We patch the underlying nx module directly because:\n * 1. vitest's vi.mock only affects ESM imports within the test file\n * 2. @nx/devkit's exports are wrapped with read-only getters by vitest\n * 3. The CJS module at nx/src/project-graph/project-graph.js is the actual\n *    implementation that @nx/devkit re-exports\n */\nimport { createRequire } from 'module';\n\nconst _require = createRequire(import.meta.url);\nconst projectGraph = _require('nx/src/project-graph/project-graph');\nprojectGraph.createProjectGraphAsync = async () => ({\n  nodes: {},\n  dependencies: {},\n});\n"],"names":["createRequire","_require","url","projectGraph","createProjectGraphAsync","nodes","dependencies"],"mappings":"AAAA;;;CAGC,GAED;;;;;;;;;;;CAWC,GACD,SAASA,aAAa,QAAQ,SAAS;AAEvC,MAAMC,WAAWD,cAAc,YAAYE,GAAG;AAC9C,MAAMC,eAAeF,SAAS;AAC9BE,aAAaC,uBAAuB,GAAG,UAAa,CAAA;QAClDC,OAAO,CAAC;QACRC,cAAc,CAAC;IACjB,CAAA"}

package/src/utils/names.d.ts

@@ -5,4 +5,20 @@ export declare const upperFirst: (str: string) => string;
 export declare const pascalCase: (str: string) => string;
 export declare const snakeCase: (str: string) => string;
 export declare const kebabCase: (str: string) => string;
+/**
+ * Normalise a string to a PEP 503 distribution name.
+ *
+ * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the
+ * canonical form of a Python project distribution name: lower-cased, with any
+ * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes
+ * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace
+ * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.
+ *
+ * Importantly this is NOT kebab-case: it does not split on camelCase humps,
+ * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes
+ * `scope-my-lib` (and only those three separators are touched).
+ *
+ * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`
+ */
+export declare const normalizeDistributionName: (str: string) => string;
 export declare const toDotNotation: (str: string) => string;

package/src/utils/names.js

@@ -1,66 +1,57 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toDotNotation = exports.kebabCase = exports.snakeCase = exports.pascalCase = exports.upperFirst = exports.toSnakeCase = exports.toKebabCase = exports.toClassName = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const lodash_camelcase_1 = tslib_1.__importDefault(require("lodash.camelcase"));
-const lodash_deburr_1 = tslib_1.__importDefault(require("lodash.deburr"));
-const toClassName = (str) => {
+ */ import camelCase from "lodash.camelcase";
+import deburr from "lodash.deburr";
+export const toClassName = (str)=>{
     if (!str) {
         return str;
     }
     const words = str.replace(/[^a-zA-Z0-9]/g, ' ').split(/\s+/);
-    return words
-        .map((word, index) => {
+    return words.map((word, index)=>{
         if (index === 0 && /^\d/.test(word)) {
             return '_' + word;
         }
         return word.charAt(0).toUpperCase() + word.slice(1);
-    })
-        .join('');
+    }).join('');
 };
-exports.toClassName = toClassName;
-const toKebabCase = (str) => str?.split('/').map(exports.kebabCase).join('/');
-exports.toKebabCase = toKebabCase;
-const toSnakeCase = (str) => str?.split('/').map(exports.snakeCase).join('/');
-exports.toSnakeCase = toSnakeCase;
-const upperFirst = (str) => str.charAt(0).toUpperCase() + str.slice(1);
-exports.upperFirst = upperFirst;
-const pascalCase = (str) => (0, exports.upperFirst)((0, lodash_camelcase_1.default)(str));
-exports.pascalCase = pascalCase;
-const snakeCase = (str) => {
-    return ((0, lodash_deburr_1.default)(str)
-        // Replace series of special characters with underscores
-        .replace(/[^a-zA-Z0-9]+/g, '_')
-        // Replace capital letters preceded by lowercase or numbers with underscore + lowercase
-        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-        // Convert to lowercase
-        .toLowerCase()
-        // Remove leading/trailing underscores
-        .replace(/^_+|_+$/g, ''));
+export const toKebabCase = (str)=>str?.split('/').map(kebabCase).join('/');
+export const toSnakeCase = (str)=>str?.split('/').map(snakeCase).join('/');
+export const upperFirst = (str)=>str.charAt(0).toUpperCase() + str.slice(1);
+export const pascalCase = (str)=>upperFirst(camelCase(str));
+export const snakeCase = (str)=>{
+    return deburr(str)// Replace series of special characters with underscores
+    .replace(/[^a-zA-Z0-9]+/g, '_')// Replace capital letters preceded by lowercase or numbers with underscore + lowercase
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')// Convert to lowercase
+    .toLowerCase()// Remove leading/trailing underscores
+    .replace(/^_+|_+$/g, '');
 };
-exports.snakeCase = snakeCase;
-const kebabCase = (str) => {
-    return ((0, lodash_deburr_1.default)(str)
-        // Replace series of special characters with hyphens
-        .replace(/[^a-zA-Z0-9]+/g, '-')
-        // Replace capital letters preceded by lowercase or numbers with hyphen + lowercase
-        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-        // Convert to lowercase
-        .toLowerCase()
-        // Remove leading/trailing hyphens
-        .replace(/^-+|-+$/g, ''));
+export const kebabCase = (str)=>{
+    return deburr(str)// Replace series of special characters with hyphens
+    .replace(/[^a-zA-Z0-9]+/g, '-')// Replace capital letters preceded by lowercase or numbers with hyphen + lowercase
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')// Convert to lowercase
+    .toLowerCase()// Remove leading/trailing hyphens
+    .replace(/^-+|-+$/g, '');
 };
-exports.kebabCase = kebabCase;
+/**
+ * Normalise a string to a PEP 503 distribution name.
+ *
+ * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the
+ * canonical form of a Python project distribution name: lower-cased, with any
+ * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes
+ * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace
+ * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.
+ *
+ * Importantly this is NOT kebab-case: it does not split on camelCase humps,
+ * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes
+ * `scope-my-lib` (and only those three separators are touched).
+ *
+ * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`
+ */ export const normalizeDistributionName = (str)=>str.toLowerCase().replace(/[._-]+/g, '-');
 // Convert a string to a dot notation string (eg. lambda_handler/my_handler.py -> lambda_handler.my_handler)
-const toDotNotation = (str) => str
-    ?.replace(/^\/|\/$/g, '') // Remove leading/trailing slashes
+export const toDotNotation = (str)=>str?.replace(/^\/|\/$/g, '') // Remove leading/trailing slashes
     .replace(/\.[^/.]+$/g, '') // Remove any file extensions
-    .split('/')
-    .filter(Boolean) // Remove empty segments (in case of double slashes)
+    .split('/').filter(Boolean) // Remove empty segments (in case of double slashes)
     .join('.');
-exports.toDotNotation = toDotNotation;
+
 //# sourceMappingURL=names.js.map

package/src/utils/names.js.map

@@ -1 +1 @@
-{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/names.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/names.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport camelCase from 'lodash.camelcase';\nimport deburr from 'lodash.deburr';\n\nexport const toClassName = (str?: string): string => {\n  if (!str) {\n    return str;\n  }\n  const words = str.replace(/[^a-zA-Z0-9]/g, ' ').split(/\\s+/);\n  return words\n    .map((word, index) => {\n      if (index === 0 && /^\\d/.test(word)) {\n        return '_' + word;\n      }\n      return word.charAt(0).toUpperCase() + word.slice(1);\n    })\n    .join('');\n};\n\nexport const toKebabCase = (str?: string): string =>\n  str?.split('/').map(kebabCase).join('/');\n\nexport const toSnakeCase = (str?: string): string =>\n  str?.split('/').map(snakeCase).join('/');\n\nexport const upperFirst = (str: string): string =>\n  str.charAt(0).toUpperCase() + str.slice(1);\n\nexport const pascalCase = (str: string): string => upperFirst(camelCase(str));\n\nexport const snakeCase = (str: string): string => {\n  return (\n    deburr(str)\n      // Replace series of special characters with underscores\n      .replace(/[^a-zA-Z0-9]+/g, '_')\n      // Replace capital letters preceded by lowercase or numbers with underscore + lowercase\n      .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n      // Convert to lowercase\n      .toLowerCase()\n      // Remove leading/trailing underscores\n      .replace(/^_+|_+$/g, '')\n  );\n};\n\nexport const kebabCase = (str: string): string => {\n  return (\n    deburr(str)\n      // Replace series of special characters with hyphens\n      .replace(/[^a-zA-Z0-9]+/g, '-')\n      // Replace capital letters preceded by lowercase or numbers with hyphen + lowercase\n      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n      // Convert to lowercase\n      .toLowerCase()\n      // Remove leading/trailing hyphens\n      .replace(/^-+|-+$/g, '')\n  );\n};\n\n/**\n * Normalise a string to a PEP 503 distribution name.\n *\n * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the\n * canonical form of a Python project distribution name: lower-cased, with any\n * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes\n * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace\n * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.\n *\n * Importantly this is NOT kebab-case: it does not split on camelCase humps,\n * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes\n * `scope-my-lib` (and only those three separators are touched).\n *\n * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`\n */\nexport const normalizeDistributionName = (str: string): string =>\n  str.toLowerCase().replace(/[._-]+/g, '-');\n\n// Convert a string to a dot notation string (eg. lambda_handler/my_handler.py -> lambda_handler.my_handler)\nexport const toDotNotation = (str: string): string =>\n  str\n    ?.replace(/^\\/|\\/$/g, '') // Remove leading/trailing slashes\n    .replace(/\\.[^/.]+$/g, '') // Remove any file extensions\n    .split('/')\n    .filter(Boolean) // Remove empty segments (in case of double slashes)\n    .join('.');\n"],"names":["camelCase","deburr","toClassName","str","words","replace","split","map","word","index","test","charAt","toUpperCase","slice","join","toKebabCase","kebabCase","toSnakeCase","snakeCase","upperFirst","pascalCase","toLowerCase","normalizeDistributionName","toDotNotation","filter","Boolean"],"mappings":"AAAA;;;CAGC,GACD,OAAOA,eAAe,mBAAmB;AACzC,OAAOC,YAAY,gBAAgB;AAEnC,OAAO,MAAMC,cAAc,CAACC;IAC1B,IAAI,CAACA,KAAK;QACR,OAAOA;IACT;IACA,MAAMC,QAAQD,IAAIE,OAAO,CAAC,iBAAiB,KAAKC,KAAK,CAAC;IACtD,OAAOF,MACJG,GAAG,CAAC,CAACC,MAAMC;QACV,IAAIA,UAAU,KAAK,MAAMC,IAAI,CAACF,OAAO;YACnC,OAAO,MAAMA;QACf;QACA,OAAOA,KAAKG,MAAM,CAAC,GAAGC,WAAW,KAAKJ,KAAKK,KAAK,CAAC;IACnD,GACCC,IAAI,CAAC;AACV,EAAE;AAEF,OAAO,MAAMC,cAAc,CAACZ,MAC1BA,KAAKG,MAAM,KAAKC,IAAIS,WAAWF,KAAK,KAAK;AAE3C,OAAO,MAAMG,cAAc,CAACd,MAC1BA,KAAKG,MAAM,KAAKC,IAAIW,WAAWJ,KAAK,KAAK;AAE3C,OAAO,MAAMK,aAAa,CAAChB,MACzBA,IAAIQ,MAAM,CAAC,GAAGC,WAAW,KAAKT,IAAIU,KAAK,CAAC,GAAG;AAE7C,OAAO,MAAMO,aAAa,CAACjB,MAAwBgB,WAAWnB,UAAUG,MAAM;AAE9E,OAAO,MAAMe,YAAY,CAACf;IACxB,OACEF,OAAOE,IACL,wDAAwD;KACvDE,OAAO,CAAC,kBAAkB,IAC3B,uFAAuF;KACtFA,OAAO,CAAC,sBAAsB,QAC/B,uBAAuB;KACtBgB,WAAW,EACZ,sCAAsC;KACrChB,OAAO,CAAC,YAAY;AAE3B,EAAE;AAEF,OAAO,MAAMW,YAAY,CAACb;IACxB,OACEF,OAAOE,IACL,oDAAoD;KACnDE,OAAO,CAAC,kBAAkB,IAC3B,mFAAmF;KAClFA,OAAO,CAAC,sBAAsB,QAC/B,uBAAuB;KACtBgB,WAAW,EACZ,kCAAkC;KACjChB,OAAO,CAAC,YAAY;AAE3B,EAAE;AAEF;;;;;;;;;;;;;;CAcC,GACD,OAAO,MAAMiB,4BAA4B,CAACnB,MACxCA,IAAIkB,WAAW,GAAGhB,OAAO,CAAC,WAAW,KAAK;AAE5C,4GAA4G;AAC5G,OAAO,MAAMkB,gBAAgB,CAACpB,MAC5BA,KACIE,QAAQ,YAAY,IAAI,kCAAkC;KAC3DA,QAAQ,cAAc,IAAI,6BAA6B;KACvDC,MAAM,KACNkB,OAAOC,SAAS,oDAAoD;KACpEX,KAAK,KAAK"}

package/src/utils/npm-scope.js

@@ -1,29 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNpmScope = getNpmScope;
-exports.getNpmScopePrefix = getNpmScopePrefix;
-exports.toScopeAlias = toScopeAlias;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-function getNpmScope(tree) {
-    const { name } = tree.exists('package.json')
-        ? (0, devkit_1.readJson)(tree, 'package.json')
-        : { name: null };
+ */ import { readJson } from "@nx/devkit";
+export function getNpmScope(tree) {
+    const { name } = tree.exists('package.json') ? readJson(tree, 'package.json') : {
+        name: null
+    };
     return name?.startsWith('@') ? name.split('/')[0].substring(1) : 'monorepo';
 }
-function getNpmScopePrefix(tree) {
+export function getNpmScopePrefix(tree) {
     const npmScope = getNpmScope(tree);
     return `@${npmScope}/`;
 }
 /**
  * Returns a safe import alias for local packages to avoid the potential for sniping attacks
- */
-function toScopeAlias(npmScopeOrPackageName) {
-    return npmScopeOrPackageName.startsWith('@')
-        ? `:${npmScopeOrPackageName.slice(1)}`
-        : npmScopeOrPackageName;
+ */ export function toScopeAlias(npmScopeOrPackageName) {
+    return npmScopeOrPackageName.startsWith('@') ? `:${npmScopeOrPackageName.slice(1)}` : npmScopeOrPackageName;
 }
+
 //# sourceMappingURL=npm-scope.js.map

package/src/utils/npm-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-scope.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/npm-scope.ts"],"names":[],"mappings":";;AAKA,kCAOC;AACD,8CAGC;AAID,oCAIC;AAxBD;;;GAGG;AACH,uCAAiD;AACjD,SAAgB,WAAW,CAAC,IAAU;IACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1C,CAAC,CAAC,IAAA,iBAAQ,EAEL,IAAI,EAAE,cAAc,CAAC;QAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnB,OAAO,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9E,CAAC;AACD,SAAgB,iBAAiB,CAAC,IAAU;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,QAAQ,GAAG,CAAC;AACzB,CAAC;AACD;;GAEG;AACH,SAAgB,YAAY,CAAC,qBAA6B;IACxD,OAAO,qBAAqB,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1C,CAAC,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACtC,CAAC,CAAC,qBAAqB,CAAC;AAC5B,CAAC"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/npm-scope.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { readJson, type Tree } from '@nx/devkit';\nexport function getNpmScope(tree: Tree): string | undefined {\n  const { name } = tree.exists('package.json')\n    ? readJson<{\n        name?: string;\n      }>(tree, 'package.json')\n    : { name: null };\n  return name?.startsWith('@') ? name.split('/')[0].substring(1) : 'monorepo';\n}\nexport function getNpmScopePrefix(tree: Tree): string | undefined {\n  const npmScope = getNpmScope(tree);\n  return `@${npmScope}/`;\n}\n/**\n * Returns a safe import alias for local packages to avoid the potential for sniping attacks\n */\nexport function toScopeAlias(npmScopeOrPackageName: string): string {\n  return npmScopeOrPackageName.startsWith('@')\n    ? `:${npmScopeOrPackageName.slice(1)}`\n    : npmScopeOrPackageName;\n}\n"],"names":["readJson","getNpmScope","tree","name","exists","startsWith","split","substring","getNpmScopePrefix","npmScope","toScopeAlias","npmScopeOrPackageName","slice"],"mappings":"AAAA;;;CAGC,GACD,SAASA,QAAQ,QAAmB,aAAa;AACjD,OAAO,SAASC,YAAYC,IAAU;IACpC,MAAM,EAAEC,IAAI,EAAE,GAAGD,KAAKE,MAAM,CAAC,kBACzBJ,SAEGE,MAAM,kBACT;QAAEC,MAAM;IAAK;IACjB,OAAOA,MAAME,WAAW,OAAOF,KAAKG,KAAK,CAAC,IAAI,CAAC,EAAE,CAACC,SAAS,CAAC,KAAK;AACnE;AACA,OAAO,SAASC,kBAAkBN,IAAU;IAC1C,MAAMO,WAAWR,YAAYC;IAC7B,OAAO,CAAC,CAAC,EAAEO,SAAS,CAAC,CAAC;AACxB;AACA;;CAEC,GACD,OAAO,SAASC,aAAaC,qBAA6B;IACxD,OAAOA,sBAAsBN,UAAU,CAAC,OACpC,CAAC,CAAC,EAAEM,sBAAsBC,KAAK,CAAC,IAAI,GACpCD;AACN"}

package/src/utils/nx.d.ts

@@ -12,7 +12,7 @@ import { type GeneratorInfo } from './generators';
  */
 export declare const listGenerators: (includeHidden?: boolean) => GeneratorInfo[];
 /**
- * Return generator information. Call this from a generator method with __filename
+ * Return generator information. Call this from a generator method with import.meta.filename
  */
 export declare const getGeneratorInfo: (generatorFileName: string) => GeneratorInfo;
 export declare const getPackageVersion: () => string;
@@ -59,12 +59,28 @@ export type TargetDependency = string | {
     target: string;
     params?: 'ignore' | 'forward';
 };
+/**
+ * Reorder a target's keys to match Nx's own serialization order. Nx reorders
+ * target properties when it rewrites an existing project.json, so applying the
+ * same order when first authoring a target keeps generators idempotent.
+ */
+export declare const normalizeTargetKeyOrder: <T extends object>(target: T) => T;
 /**
  * Mutate the project to add the dependency to the target if not already present
  * Adds the target if not present.
  *
  * Accepts either a string target name (e.g. `'build'`) or a dependency config
- * object (e.g. `{ projects: ['foo'], target: 'serve-local' }`). Deduplicates
+ * object (e.g. `{ projects: ['foo'], target: 'dev' }`). Deduplicates
  * using deep equality so re-running a generator does not grow `dependsOn`.
  */
 export declare const addDependencyToTargetIfNotPresent: (project: ProjectConfiguration, target: string, dependency: TargetDependency) => void;
+/**
+ * Register a component's `<name>-dev` target under the project-level `dev`
+ * target, so `nx run <project>:dev` starts every component in the project.
+ *
+ * Component generators author their own continuous `<name>-dev` runner and call
+ * this to aggregate it. Every component added to the project accumulates its
+ * `<name>-dev` under `dev`. Nx keys tasks by `project:target`, so any
+ * dependencies shared between components run exactly once.
+ */
+export declare const addComponentDevTarget: (targets: Record<string, ProjectConfiguration["targets"][string]>, componentDevTargetName: string) => void;

package/src/utils/nx.js

@@ -1,81 +1,66 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addDependencyToTargetIfNotPresent = exports.addComponentGeneratorMetadata = exports.addGeneratorMetadata = exports.projectExists = exports.readProjectConfigurationUnqualified = exports.getPackageVersion = exports.getGeneratorInfo = exports.listGenerators = exports.buildGeneratorInfoList = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const path = tslib_1.__importStar(require("path"));
-const package_json_1 = tslib_1.__importDefault(require("../../package.json"));
-const names_1 = require("./names");
-const npm_scope_1 = require("./npm-scope");
-var generators_1 = require("./generators");
-Object.defineProperty(exports, "buildGeneratorInfoList", { enumerable: true, get: function () { return generators_1.buildGeneratorInfoList; } });
-const generators_2 = require("./generators");
-const GENERATORS = (0, generators_2.buildGeneratorInfoList)(path.resolve(__dirname, '..', '..'));
+ */ import { getProjects, readProjectConfiguration, updateProjectConfiguration } from "@nx/devkit";
+import * as path from "path";
+import PackageJson from "../../package.json" with {
+    type: 'json'
+};
+import { toSnakeCase } from "./names.js";
+import { getNpmScope, getNpmScopePrefix } from "./npm-scope.js";
+export { buildGeneratorInfoList } from "./generators.js";
+import { buildGeneratorInfoList } from "./generators.js";
+const GENERATORS = buildGeneratorInfoList(path.resolve(import.meta.dirname, '..', '..'));
 /**
  * List Nx Plugin for AWS generators
  * @param includeHidden include hidden generators (default false)
- */
-const listGenerators = (includeHidden = false) => GENERATORS.filter((g) => includeHidden || !g.hidden);
-exports.listGenerators = listGenerators;
+ */ export const listGenerators = (includeHidden = false)=>GENERATORS.filter((g)=>includeHidden || !g.hidden);
 /**
- * Return generator information. Call this from a generator method with __filename
- */
-const getGeneratorInfo = (generatorFileName) => {
+ * Return generator information. Call this from a generator method with import.meta.filename
+ */ export const getGeneratorInfo = (generatorFileName)=>{
     const { dir, name } = path.parse(path.resolve(generatorFileName));
     const resolvedFactoryPath = path.join(dir, name);
-    return GENERATORS.find((generatorInfo) => generatorInfo.resolvedFactoryPath === resolvedFactoryPath);
+    return GENERATORS.find((generatorInfo)=>generatorInfo.resolvedFactoryPath === resolvedFactoryPath);
 };
-exports.getGeneratorInfo = getGeneratorInfo;
-const getPackageVersion = () => {
-    return package_json_1.default.version;
+export const getPackageVersion = ()=>{
+    return PackageJson.version;
 };
-exports.getPackageVersion = getPackageVersion;
 /**
  * Read a project configuration where the project name may not be fully qualified (ie may omit the scope prefix)
- */
-const readProjectConfigurationUnqualified = (tree, projectName) => {
+ */ export const readProjectConfigurationUnqualified = (tree, projectName)=>{
     try {
-        return (0, devkit_1.readProjectConfiguration)(tree, projectName);
-    }
-    catch (e) {
+        return readProjectConfiguration(tree, projectName);
+    } catch (e) {
         // Attempt to find the project without the scope
-        const project = [...(0, devkit_1.getProjects)(tree).values()].find((p) => p.name &&
-            (p.name === `${(0, npm_scope_1.getNpmScopePrefix)(tree)}${projectName}` || // TypeScript fully-qualified name
-                p.name === `${(0, names_1.toSnakeCase)((0, npm_scope_1.getNpmScope)(tree))}.${projectName}`));
+        const project = [
+            ...getProjects(tree).values()
+        ].find((p)=>p.name && (p.name === `${getNpmScopePrefix(tree)}${projectName}` || // TypeScript fully-qualified name
+            p.name === `${toSnakeCase(getNpmScope(tree))}.${projectName}`));
         if (project) {
             return project;
         }
         throw e;
     }
 };
-exports.readProjectConfigurationUnqualified = readProjectConfigurationUnqualified;
 /**
  * Returns whether a project with the given name already exists in the workspace.
  * The project name may be unqualified (ie may omit the scope prefix).
- */
-const projectExists = (tree, projectName) => {
+ */ export const projectExists = (tree, projectName)=>{
     try {
-        (0, exports.readProjectConfigurationUnqualified)(tree, projectName);
+        readProjectConfigurationUnqualified(tree, projectName);
         return true;
-    }
-    catch {
+    } catch  {
         return false;
     }
 };
-exports.projectExists = projectExists;
 /**
  * Add metadata about the generator that generated the project to the project.json
- */
-const addGeneratorMetadata = (tree, projectName, info, additionalMetadata) => {
-    const config = (0, exports.readProjectConfigurationUnqualified)(tree, projectName);
+ */ export const addGeneratorMetadata = (tree, projectName, info, additionalMetadata)=>{
+    const config = readProjectConfigurationUnqualified(tree, projectName);
     const metadata = {
         ...config?.metadata,
         generator: info.id,
-        ...additionalMetadata,
+        ...additionalMetadata
     };
     // Skip the write when nothing changed so re-running doesn't reserialize
     // project.json. metadata is plain JSON built in a fixed key order, so a
@@ -87,80 +72,132 @@ const addGeneratorMetadata = (tree, projectName, info, additionalMetadata) => {
     // identical whether or not metadata already existed (matching the order Nx
     // normalizes a read config to), keeping the change a pure metadata insert.
     const { targets, ...rest } = config;
-    (0, devkit_1.updateProjectConfiguration)(tree, config.name, {
+    updateProjectConfiguration(tree, config.name, {
         ...rest,
         metadata: metadata,
-        ...(targets ? { targets } : {}),
+        ...targets ? {
+            targets
+        } : {}
     });
 };
-exports.addGeneratorMetadata = addGeneratorMetadata;
 /**
  * Add metadata about the generator that generated the component to the project.json
- */
-const addComponentGeneratorMetadata = (tree, projectName, info, componentPath, componentName, additionalMetadata) => {
-    const config = (0, exports.readProjectConfigurationUnqualified)(tree, projectName);
+ */ export const addComponentGeneratorMetadata = (tree, projectName, info, componentPath, componentName, additionalMetadata)=>{
+    const config = readProjectConfigurationUnqualified(tree, projectName);
     const existingComponents = config?.metadata?.components ?? [];
-    const alreadyAdded = existingComponents.filter((c) => c.generator === info.id && c.name === componentName);
+    const alreadyAdded = existingComponents.filter((c)=>c.generator === info.id && c.name === componentName);
     if (alreadyAdded.length === 0) {
         const componentMetadata = {
             generator: info.id,
             path: componentPath,
-            ...(componentName ? { name: componentName } : {}),
-            ...additionalMetadata,
+            ...componentName ? {
+                name: componentName
+            } : {},
+            ...additionalMetadata
         };
         // Place metadata before targets for a stable serialized key order.
         const { targets, ...rest } = config;
-        (0, devkit_1.updateProjectConfiguration)(tree, config.name, {
+        updateProjectConfiguration(tree, config.name, {
             ...rest,
             metadata: {
                 ...config?.metadata,
-                components: [...existingComponents, componentMetadata],
+                components: [
+                    ...existingComponents,
+                    componentMetadata
+                ]
             },
-            ...(targets ? { targets } : {}),
+            ...targets ? {
+                targets
+            } : {}
         });
     }
 };
-exports.addComponentGeneratorMetadata = addComponentGeneratorMetadata;
-const targetDependencyEquals = (a, b) => {
+const targetDependencyEquals = (a, b)=>{
     if (typeof a === 'string' || typeof b === 'string') {
         return a === b;
     }
     if (a.target !== b.target || a.params !== b.params) {
         return false;
     }
-    const aProjects = Array.isArray(a.projects)
-        ? a.projects
-        : a.projects !== undefined
-            ? [a.projects]
-            : [];
-    const bProjects = Array.isArray(b.projects)
-        ? b.projects
-        : b.projects !== undefined
-            ? [b.projects]
-            : [];
+    const aProjects = Array.isArray(a.projects) ? a.projects : a.projects !== undefined ? [
+        a.projects
+    ] : [];
+    const bProjects = Array.isArray(b.projects) ? b.projects : b.projects !== undefined ? [
+        b.projects
+    ] : [];
     if (aProjects.length !== bProjects.length) {
         return false;
     }
-    return aProjects.every((p, i) => p === bProjects[i]);
+    return aProjects.every((p, i)=>p === bProjects[i]);
 };
+// The order target properties are authored in. Nx preserves a target's
+// authored key order when it reads then rewrites an existing project.json,
+// except `options` and `configurations`, which it always moves to the end (in
+// that order). Keeping `options`/`configurations` last here therefore makes a
+// generator's first-run output byte-identical to subsequent runs (idempotency);
+// the remaining keys are ordered to read intuitively.
+const NX_TARGET_KEY_ORDER = [
+    'executor',
+    'dependsOn',
+    'continuous',
+    'cache',
+    'inputs',
+    'outputs',
+    'metadata',
+    'defaultConfiguration',
+    'options',
+    'configurations'
+];
+/**
+ * Reorder a target's keys to match Nx's own serialization order. Nx reorders
+ * target properties when it rewrites an existing project.json, so applying the
+ * same order when first authoring a target keeps generators idempotent.
+ */ export const normalizeTargetKeyOrder = (target)=>Object.fromEntries(Object.entries(target).sort(([a], [b])=>{
+        const ai = NX_TARGET_KEY_ORDER.indexOf(a);
+        const bi = NX_TARGET_KEY_ORDER.indexOf(b);
+        return (ai === -1 ? NX_TARGET_KEY_ORDER.length : ai) - (bi === -1 ? NX_TARGET_KEY_ORDER.length : bi);
+    }));
 /**
  * Mutate the project to add the dependency to the target if not already present
  * Adds the target if not present.
  *
  * Accepts either a string target name (e.g. `'build'`) or a dependency config
- * object (e.g. `{ projects: ['foo'], target: 'serve-local' }`). Deduplicates
+ * object (e.g. `{ projects: ['foo'], target: 'dev' }`). Deduplicates
  * using deep equality so re-running a generator does not grow `dependsOn`.
- */
-const addDependencyToTargetIfNotPresent = (project, target, dependency) => {
+ */ export const addDependencyToTargetIfNotPresent = (project, target, dependency)=>{
     project.targets ??= {};
     project.targets[target] ??= {};
     project.targets[target].dependsOn ??= [];
     const dependsOn = project.targets[target].dependsOn;
     // Leave existing dependencies in place so re-running does not reorder them;
     // only append when the dependency is genuinely absent.
-    if (!dependsOn.some((d) => targetDependencyEquals(d, dependency))) {
+    if (!dependsOn.some((d)=>targetDependencyEquals(d, dependency))) {
         dependsOn.push(dependency);
     }
+    // Keep key order aligned with Nx's so first run matches subsequent runs.
+    project.targets[target] = normalizeTargetKeyOrder(project.targets[target]);
+};
+/**
+ * Register a component's `<name>-dev` target under the project-level `dev`
+ * target, so `nx run <project>:dev` starts every component in the project.
+ *
+ * Component generators author their own continuous `<name>-dev` runner and call
+ * this to aggregate it. Every component added to the project accumulates its
+ * `<name>-dev` under `dev`. Nx keys tasks by `project:target`, so any
+ * dependencies shared between components run exactly once.
+ */ export const addComponentDevTarget = (targets, componentDevTargetName)=>{
+    targets['dev'] ??= {
+        continuous: true,
+        dependsOn: []
+    };
+    const projectDev = targets['dev'];
+    projectDev.continuous = true;
+    projectDev.dependsOn ??= [];
+    // Append in component-creation order; dedupe keeps re-runs idempotent.
+    if (!projectDev.dependsOn.includes(componentDevTargetName)) {
+        projectDev.dependsOn.push(componentDevTargetName);
+    }
+    targets['dev'] = normalizeTargetKeyOrder(projectDev);
 };
-exports.addDependencyToTargetIfNotPresent = addDependencyToTargetIfNotPresent;
+
 //# sourceMappingURL=nx.js.map