@aws/nx-plugin 1.0.0-rc.8 → 1.0.0-rc.80

package/src/utils/rdb-constructs/rdb-constructs.d.ts

@@ -3,10 +3,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { type Tree } from '@nx/devkit';
-import type { Containers } from '../containers';
-import type { Iac } from '../iac';
+import type { Containers } from '../containers.js';
+import type { Iac } from '../iac.js';
 export interface AddRdbConstructOptions {
     projectName: string;
+    projectRoot: string;
     nameClassName: string;
     nameKebabCase: string;
     databasePackageAlias: string;
@@ -14,8 +15,18 @@ export interface AddRdbConstructOptions {
     adminUser: string;
     engine: 'postgres' | 'mysql';
     migrationBundleDir: string;
+    /**
+     * Node.js zip bundle directory for the create-db-user Lambda (ts#rdb).
+     * When absent the migration Docker image is reused with the
+     * `create_db_user_handler.handler` command (py#rdb).
+     */
     createDbUserBundleDir: string;
-    dockerImageTag: string;
+    /** ORM framework used by the create-db-user Lambda. */
+    framework: 'prisma' | 'sqlmodel';
+    /** Local Docker tag for the Python create-db-user Lambda image. */
+    createDbUserDockerImageTag?: string;
+    /** Local Docker tag for the migration Lambda image. */
+    migrationDockerImageTag: string;
     containerEngine: Containers;
 }
 export declare const addRdbInfra: (tree: Tree, options: AddRdbConstructOptions & {

package/src/utils/rdb-constructs/rdb-constructs.js

@@ -1,57 +1,54 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addRdbTerraformModules = exports.addRdbCdkConstructs = exports.addRdbInfra = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const ast_1 = require("../ast");
-const shared_constructs_constants_1 = require("../shared-constructs-constants");
-const addRdbInfra = async (tree, options) => {
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, updateJson } from "@nx/devkit";
+import { addStarExport } from "../ast.js";
+import { esmVars } from "../module-format.js";
+import { addDependencyToTargetIfNotPresent } from "../nx.js";
+import { PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, SHARED_TERRAFORM_DIR } from "../shared-constructs-constants.js";
+import { terraformProviderVersions } from "../versions.js";
+export const addRdbInfra = async (tree, options)=>{
     if (options.iac === 'cdk') {
-        await (0, exports.addRdbCdkConstructs)(tree, options);
-    }
-    else if (options.iac === 'terraform') {
-        (0, exports.addRdbTerraformModules)(tree, options);
-    }
-    else {
+        await addRdbCdkConstructs(tree, options);
+    } else if (options.iac === 'terraform') {
+        addRdbTerraformModules(tree, options);
+    } else {
         throw new Error(`Unsupported iac ${options.iac}`);
     }
-    (0, devkit_1.updateJson)(tree, (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, options.iac === 'cdk' ? shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR : shared_constructs_constants_1.SHARED_TERRAFORM_DIR, 'project.json'), (config) => {
-        if (!config.targets) {
-            config.targets = {};
-        }
-        if (!config.targets.build) {
-            config.targets.build = {};
-        }
-        config.targets.build.dependsOn = [
-            ...(config.targets.build.dependsOn ?? []),
-            `${options.projectName}:build`,
-        ];
+    updateJson(tree, joinPathFragments(PACKAGES_DIR, options.iac === 'cdk' ? SHARED_CONSTRUCTS_DIR : SHARED_TERRAFORM_DIR, 'project.json'), (config)=>{
+        addDependencyToTargetIfNotPresent(config, 'build', `${options.projectName}:build`);
         return config;
     });
 };
-exports.addRdbInfra = addRdbInfra;
-const addRdbCdkConstructs = async (tree, options) => {
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'cdk', 'core', 'rdb'), (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'core', 'rdb'), options, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+export const addRdbCdkConstructs = async (tree, options)=>{
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'cdk', 'core', 'rdb'), joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'core', 'rdb'), {
+        ...options,
+        ...esmVars(tree)
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'cdk', 'app', 'dbs'), (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'app', 'dbs'), options, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'cdk', 'app', 'dbs'), joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'dbs'), {
+        ...options,
+        ...esmVars(tree)
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
-    await (0, ast_1.addStarExport)(tree, (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'core', 'index.ts'), './rdb/aurora.js');
-    await (0, ast_1.addStarExport)(tree, (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'app', 'dbs', 'index.ts'), `./${options.nameKebabCase}.js`);
-    await (0, ast_1.addStarExport)(tree, (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'app', 'index.ts'), './dbs/index.js');
+    await addStarExport(tree, joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'core', 'index.ts'), './rdb/aurora.js');
+    await addStarExport(tree, joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'dbs', 'index.ts'), `./${options.nameKebabCase}.js`);
+    await addStarExport(tree, joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'index.ts'), './dbs/index.js');
 };
-exports.addRdbCdkConstructs = addRdbCdkConstructs;
-const addRdbTerraformModules = (tree, options) => {
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'terraform', 'core', 'rdb'), (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_TERRAFORM_DIR, 'src', 'core', 'rdb'), {}, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+export const addRdbTerraformModules = (tree, options)=>{
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'terraform', 'core', 'rdb'), joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'core', 'rdb'), {
+        ...terraformProviderVersions()
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'terraform', 'app', 'dbs'), (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_TERRAFORM_DIR, 'src', 'app', 'dbs'), options, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'terraform', 'app', 'dbs'), joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'app', 'dbs'), {
+        ...options,
+        ...terraformProviderVersions()
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
 };
-exports.addRdbTerraformModules = addRdbTerraformModules;
+
 //# sourceMappingURL=rdb-constructs.js.map

package/src/utils/rdb-constructs/rdb-constructs.js.map

@@ -1 +1 @@
-{"version":3,"file":"rdb-constructs.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/utils/rdb-constructs/rdb-constructs.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,uCAOoB;AACpB,gCAAuC;AAGvC,gFAIwC;AAgBjC,MAAM,WAAW,GAAG,KAAK,EAC9B,IAAU,EACV,OAA8C,EAC9C,EAAE;IACF,IAAI,OAAO,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAA,2BAAmB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QACvC,IAAA,8BAAsB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,IAAA,mBAAU,EACR,IAAI,EACJ,IAAA,0BAAiB,EACf,0CAAY,EACZ,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,mDAAqB,CAAC,CAAC,CAAC,kDAAoB,EACpE,cAAc,CACf,EACD,CAAC,MAA4B,EAAE,EAAE;QAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG;YAC/B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;YACzC,GAAG,OAAO,CAAC,WAAW,QAAQ;SAC/B,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAjCW,QAAA,WAAW,eAiCtB;AAEK,MAAM,mBAAmB,GAAG,KAAK,EACtC,IAAU,EACV,OAA+B,EAC/B,EAAE;IACF,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAC3D,IAAA,0BAAiB,EACf,0CAAY,EACZ,mDAAqB,EACrB,KAAK,EACL,MAAM,EACN,KAAK,CACN,EACD,OAAO,EACP;QACE,iBAAiB,EAAE,0BAAiB,CAAC,YAAY;KAClD,CACF,CAAC;IAEF,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAC1D,IAAA,0BAAiB,EAAC,0CAAY,EAAE,mDAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAC3E,OAAO,EACP;QACE,iBAAiB,EAAE,0BAAiB,CAAC,YAAY;KAClD,CACF,CAAC;IAEF,MAAM,IAAA,mBAAa,EACjB,IAAI,EACJ,IAAA,0BAAiB,EACf,0CAAY,EACZ,mDAAqB,EACrB,KAAK,EACL,MAAM,EACN,UAAU,CACX,EACD,iBAAiB,CAClB,CAAC;IACF,MAAM,IAAA,mBAAa,EACjB,IAAI,EACJ,IAAA,0BAAiB,EACf,0CAAY,EACZ,mDAAqB,EACrB,KAAK,EACL,KAAK,EACL,KAAK,EACL,UAAU,CACX,EACD,KAAK,OAAO,CAAC,aAAa,KAAK,CAChC,CAAC;IACF,MAAM,IAAA,mBAAa,EACjB,IAAI,EACJ,IAAA,0BAAiB,EACf,0CAAY,EACZ,mDAAqB,EACrB,KAAK,EACL,KAAK,EACL,UAAU,CACX,EACD,gBAAgB,CACjB,CAAC;AACJ,CAAC,CAAC;AAhEW,QAAA,mBAAmB,uBAgE9B;AAEK,MAAM,sBAAsB,GAAG,CACpC,IAAU,EACV,OAA+B,EAC/B,EAAE;IACF,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EACjE,IAAA,0BAAiB,EAAC,0CAAY,EAAE,kDAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAC3E,EAAE,EACF;QACE,iBAAiB,EAAE,0BAAiB,CAAC,YAAY;KAClD,CACF,CAAC;IAEF,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,EAChE,IAAA,0BAAiB,EAAC,0CAAY,EAAE,kDAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAC1E,OAAO,EACP;QACE,iBAAiB,EAAE,0BAAiB,CAAC,YAAY;KAClD,CACF,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,sBAAsB,0BAuBjC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/rdb-constructs/rdb-constructs.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n  updateJson,\n} from '@nx/devkit';\nimport { addStarExport } from '../ast.js';\nimport type { Containers } from '../containers.js';\nimport type { Iac } from '../iac.js';\nimport { esmVars } from '../module-format.js';\nimport { addDependencyToTargetIfNotPresent } from '../nx.js';\nimport {\n  PACKAGES_DIR,\n  SHARED_CONSTRUCTS_DIR,\n  SHARED_TERRAFORM_DIR,\n} from '../shared-constructs-constants.js';\nimport { terraformProviderVersions } from '../versions.js';\n\nexport interface AddRdbConstructOptions {\n  projectName: string;\n  projectRoot: string;\n  nameClassName: string;\n  nameKebabCase: string;\n  databasePackageAlias: string;\n  databaseName: string;\n  adminUser: string;\n  engine: 'postgres' | 'mysql';\n  migrationBundleDir: string;\n  /**\n   * Node.js zip bundle directory for the create-db-user Lambda (ts#rdb).\n   * When absent the migration Docker image is reused with the\n   * `create_db_user_handler.handler` command (py#rdb).\n   */\n  createDbUserBundleDir: string;\n  /** ORM framework used by the create-db-user Lambda. */\n  framework: 'prisma' | 'sqlmodel';\n  /** Local Docker tag for the Python create-db-user Lambda image. */\n  createDbUserDockerImageTag?: string;\n  /** Local Docker tag for the migration Lambda image. */\n  migrationDockerImageTag: string;\n  containerEngine: Containers;\n}\n\nexport const addRdbInfra = async (\n  tree: Tree,\n  options: AddRdbConstructOptions & { iac: Iac },\n) => {\n  if (options.iac === 'cdk') {\n    await addRdbCdkConstructs(tree, options);\n  } else if (options.iac === 'terraform') {\n    addRdbTerraformModules(tree, options);\n  } else {\n    throw new Error(`Unsupported iac ${options.iac}`);\n  }\n\n  updateJson(\n    tree,\n    joinPathFragments(\n      PACKAGES_DIR,\n      options.iac === 'cdk' ? SHARED_CONSTRUCTS_DIR : SHARED_TERRAFORM_DIR,\n      'project.json',\n    ),\n    (config: ProjectConfiguration) => {\n      addDependencyToTargetIfNotPresent(\n        config,\n        'build',\n        `${options.projectName}:build`,\n      );\n      return config;\n    },\n  );\n};\n\nexport const addRdbCdkConstructs = async (\n  tree: Tree,\n  options: AddRdbConstructOptions,\n) => {\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'cdk', 'core', 'rdb'),\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_CONSTRUCTS_DIR,\n      'src',\n      'core',\n      'rdb',\n    ),\n    { ...options, ...esmVars(tree) },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'cdk', 'app', 'dbs'),\n    joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'dbs'),\n    { ...options, ...esmVars(tree) },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  await addStarExport(\n    tree,\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_CONSTRUCTS_DIR,\n      'src',\n      'core',\n      'index.ts',\n    ),\n    './rdb/aurora.js',\n  );\n  await addStarExport(\n    tree,\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_CONSTRUCTS_DIR,\n      'src',\n      'app',\n      'dbs',\n      'index.ts',\n    ),\n    `./${options.nameKebabCase}.js`,\n  );\n  await addStarExport(\n    tree,\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_CONSTRUCTS_DIR,\n      'src',\n      'app',\n      'index.ts',\n    ),\n    './dbs/index.js',\n  );\n};\n\nexport const addRdbTerraformModules = (\n  tree: Tree,\n  options: AddRdbConstructOptions,\n) => {\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'terraform', 'core', 'rdb'),\n    joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'core', 'rdb'),\n    { ...terraformProviderVersions() },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'terraform', 'app', 'dbs'),\n    joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'app', 'dbs'),\n    { ...options, ...terraformProviderVersions() },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n};\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateJson","addStarExport","esmVars","addDependencyToTargetIfNotPresent","PACKAGES_DIR","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_DIR","terraformProviderVersions","addRdbInfra","tree","options","iac","addRdbCdkConstructs","addRdbTerraformModules","Error","config","projectName","dirname","overwriteStrategy","KeepExisting","nameKebabCase"],"mappings":"AAAA;;;CAGC,GACD,SACEA,aAAa,EACbC,iBAAiB,EACjBC,iBAAiB,EAGjBC,UAAU,QACL,aAAa;AACpB,SAASC,aAAa,QAAQ,YAAY;AAG1C,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,iCAAiC,QAAQ,WAAW;AAC7D,SACEC,YAAY,EACZC,qBAAqB,EACrBC,oBAAoB,QACf,oCAAoC;AAC3C,SAASC,yBAAyB,QAAQ,iBAAiB;AA2B3D,OAAO,MAAMC,cAAc,OACzBC,MACAC;IAEA,IAAIA,QAAQC,GAAG,KAAK,OAAO;QACzB,MAAMC,oBAAoBH,MAAMC;IAClC,OAAO,IAAIA,QAAQC,GAAG,KAAK,aAAa;QACtCE,uBAAuBJ,MAAMC;IAC/B,OAAO;QACL,MAAM,IAAII,MAAM,CAAC,gBAAgB,EAAEJ,QAAQC,GAAG,EAAE;IAClD;IAEAX,WACES,MACAX,kBACEM,cACAM,QAAQC,GAAG,KAAK,QAAQN,wBAAwBC,sBAChD,iBAEF,CAACS;QACCZ,kCACEY,QACA,SACA,GAAGL,QAAQM,WAAW,CAAC,MAAM,CAAC;QAEhC,OAAOD;IACT;AAEJ,EAAE;AAEF,OAAO,MAAMH,sBAAsB,OACjCH,MACAC;IAEAb,cACEY,MACAX,kBAAkB,YAAYmB,OAAO,EAAE,SAAS,OAAO,QAAQ,QAC/DnB,kBACEM,cACAC,uBACA,OACA,QACA,QAEF;QAAE,GAAGK,OAAO;QAAE,GAAGR,QAAQO,KAAK;IAAC,GAC/B;QACES,mBAAmBnB,kBAAkBoB,YAAY;IACnD;IAGFtB,cACEY,MACAX,kBAAkB,YAAYmB,OAAO,EAAE,SAAS,OAAO,OAAO,QAC9DnB,kBAAkBM,cAAcC,uBAAuB,OAAO,OAAO,QACrE;QAAE,GAAGK,OAAO;QAAE,GAAGR,QAAQO,KAAK;IAAC,GAC/B;QACES,mBAAmBnB,kBAAkBoB,YAAY;IACnD;IAGF,MAAMlB,cACJQ,MACAX,kBACEM,cACAC,uBACA,OACA,QACA,aAEF;IAEF,MAAMJ,cACJQ,MACAX,kBACEM,cACAC,uBACA,OACA,OACA,OACA,aAEF,CAAC,EAAE,EAAEK,QAAQU,aAAa,CAAC,GAAG,CAAC;IAEjC,MAAMnB,cACJQ,MACAX,kBACEM,cACAC,uBACA,OACA,OACA,aAEF;AAEJ,EAAE;AAEF,OAAO,MAAMQ,yBAAyB,CACpCJ,MACAC;IAEAb,cACEY,MACAX,kBAAkB,YAAYmB,OAAO,EAAE,SAAS,aAAa,QAAQ,QACrEnB,kBAAkBM,cAAcE,sBAAsB,OAAO,QAAQ,QACrE;QAAE,GAAGC,2BAA2B;IAAC,GACjC;QACEW,mBAAmBnB,kBAAkBoB,YAAY;IACnD;IAGFtB,cACEY,MACAX,kBAAkB,YAAYmB,OAAO,EAAE,SAAS,aAAa,OAAO,QACpEnB,kBAAkBM,cAAcE,sBAAsB,OAAO,OAAO,QACpE;QAAE,GAAGI,OAAO;QAAE,GAAGH,2BAA2B;IAAC,GAC7C;QACEW,mBAAmBnB,kBAAkBoB,YAAY;IACnD;AAEJ,EAAE"}

package/src/utils/ruff.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Rules whose fixes are applied to generated Python.
+ *
+ * `ruff_wasm`'s `check` serialises every fix without its applicability (the
+ * `Fix::applicability()` it drops is what `ruff check --fix` filters on) and
+ * ignores `unsafe-fixes`, so it cannot be asked for only the fixes the CLI would
+ * apply. Taking them all would rewrite `if x == True` to `if x`.
+ *
+ * Ruff's `fixable` setting filters inside the linter, which keeps the decision
+ * in ruff — but it selects by *rule*, and applicability is a property of each
+ * *diagnostic*: across ruff's own 1598 lint fixtures, 27 rules under the vended
+ * selection emit both safe and unsafe fixes depending on the code (one `UP008`
+ * is safe, another is unsafe when dropping the arguments would take a comment
+ * with them). So no rule list, allowing or denying, can reproduce `--fix`: for
+ * those 27 it can only take both or neither.
+ *
+ * Given that, the list stays as small as generation needs rather than reaching
+ * for an equivalence it cannot have. These four cover the import hygiene
+ * generation itself creates by merging imports into existing files, and ruff
+ * documents each of their fixes as safe — except F401 in an `__init__.py`, which
+ * is excluded below. Templates are authored free of other violations, so nothing
+ * else needs fixing here, and the user's own `lint --configuration=fix` remains
+ * the full-fidelity path. A test re-checks these against ruff's own docs.
+ */
+export declare const FIXABLE_RULES: string[];
+/**
+ * The ruff release these bindings are built from. `@astral-sh/ruff-wasm-nodejs`
+ * is published from the ruff repo on every release, so its versions track ruff's
+ * exactly — keep this in step with `PY_VERSIONS.ruff` (the ruff the vended
+ * `format` and `lint` targets run) so generated files stay `ruff format
+ * --check`-clean on disk. A test asserts the two agree.
+ */
+export declare const RUFF_WASM_VERSION: string;
+/** Ruff settings, as accepted by the WASM `Workspace` constructor. */
+export interface RuffOptions {
+    readonly 'line-length'?: number;
+    readonly 'target-version'?: string;
+    readonly lint?: {
+        readonly select?: readonly string[];
+        readonly 'extend-select'?: readonly string[];
+        readonly fixable?: readonly string[];
+        readonly unfixable?: readonly string[];
+        readonly isort?: {
+            readonly 'known-first-party'?: readonly string[];
+        };
+    };
+}
+/**
+ * Apply ruff's lint fixes and formatter to Python content, in process.
+ *
+ * Equivalent to piping the content through `ruff check --fix` then `ruff
+ * format` — the tools the vended `lint` and `format` targets run — without
+ * paying two process spawns per file.
+ */
+export declare const ruffFixAndFormat: (content: string, filePath: string, options: RuffOptions) => string;

package/src/utils/ruff.js

@@ -0,0 +1,140 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { PositionEncoding, Workspace } from "@astral-sh/ruff-wasm-nodejs";
+import path from "path";
+/**
+ * Rules whose fixes are applied to generated Python.
+ *
+ * `ruff_wasm`'s `check` serialises every fix without its applicability (the
+ * `Fix::applicability()` it drops is what `ruff check --fix` filters on) and
+ * ignores `unsafe-fixes`, so it cannot be asked for only the fixes the CLI would
+ * apply. Taking them all would rewrite `if x == True` to `if x`.
+ *
+ * Ruff's `fixable` setting filters inside the linter, which keeps the decision
+ * in ruff — but it selects by *rule*, and applicability is a property of each
+ * *diagnostic*: across ruff's own 1598 lint fixtures, 27 rules under the vended
+ * selection emit both safe and unsafe fixes depending on the code (one `UP008`
+ * is safe, another is unsafe when dropping the arguments would take a comment
+ * with them). So no rule list, allowing or denying, can reproduce `--fix`: for
+ * those 27 it can only take both or neither.
+ *
+ * Given that, the list stays as small as generation needs rather than reaching
+ * for an equivalence it cannot have. These four cover the import hygiene
+ * generation itself creates by merging imports into existing files, and ruff
+ * documents each of their fixes as safe — except F401 in an `__init__.py`, which
+ * is excluded below. Templates are authored free of other violations, so nothing
+ * else needs fixing here, and the user's own `lint --configuration=fix` remains
+ * the full-fidelity path. A test re-checks these against ruff's own docs.
+ */ export const FIXABLE_RULES = [
+    'I001',
+    'F401',
+    'F811',
+    'E401'
+];
+/** Escape hatch matching ruff's own fix loop bound. */ const MAX_FIX_ITERATIONS = 100;
+/**
+ * The ruff release these bindings are built from. `@astral-sh/ruff-wasm-nodejs`
+ * is published from the ruff repo on every release, so its versions track ruff's
+ * exactly — keep this in step with `PY_VERSIONS.ruff` (the ruff the vended
+ * `format` and `lint` targets run) so generated files stay `ruff format
+ * --check`-clean on disk. A test asserts the two agree.
+ */ export const RUFF_WASM_VERSION = Workspace.version();
+/**
+ * Apply one diagnostic's fix, resolving ruff's (row, column) positions against
+ * the content. Positions are requested in UTF-16, which is how JavaScript
+ * already indexes strings, so they need no transcoding.
+ */ const applyFix = (content, edits)=>{
+    const lineStarts = [
+        0
+    ];
+    for(let i = 0; i < content.length; i++){
+        if (content[i] === '\n') {
+            lineStarts.push(i + 1);
+        }
+    }
+    // Ruff can report a position one past the last line (eg when deleting a
+    // trailing line), so clamp rather than indexing past the end.
+    const offsetOf = (location)=>(lineStarts[location.row - 1] ?? content.length) + (location.column - 1);
+    let result = '';
+    let end = 0;
+    for (const edit of [
+        ...edits
+    ].sort((a, b)=>offsetOf(a.location) - offsetOf(b.location))){
+        const start = offsetOf(edit.location);
+        if (start < end) {
+            continue;
+        }
+        result += content.slice(end, start) + (edit.content ?? '');
+        end = offsetOf(edit.end_location);
+    }
+    return result + content.slice(end);
+};
+/**
+ * Ruff treats an `__init__.py` as re-exporting its imports, so an unused import
+ * there gets a diagnostic with no fix — removing it would drop the package's
+ * public API. `ruff_wasm` lints under a fixed placeholder filename and so cannot
+ * apply this itself, making the file's real name the caller's to account for.
+ */ const isInitPy = (filePath)=>path.basename(filePath) === '__init__.py';
+/**
+ * A `Workspace` costs far more to construct than to run, and the same settings
+ * recur across every file of a project, so key them by the resolved options.
+ */ const _workspaces = new Map();
+const getWorkspace = (options)=>{
+    const key = JSON.stringify(options);
+    let workspace = _workspaces.get(key);
+    if (!workspace) {
+        workspace = new Workspace(options, PositionEncoding.Utf16);
+        _workspaces.set(key, workspace);
+    }
+    return workspace;
+};
+/**
+ * Apply ruff's lint fixes and formatter to Python content, in process.
+ *
+ * Equivalent to piping the content through `ruff check --fix` then `ruff
+ * format` — the tools the vended `lint` and `format` targets run — without
+ * paying two process spawns per file.
+ */ export const ruffFixAndFormat = (content, filePath, options)=>{
+    const workspace = getWorkspace({
+        ...options,
+        lint: {
+            ...options.lint,
+            fixable: FIXABLE_RULES,
+            // Never drop an `__init__.py` import: ruff keeps these as re-exports.
+            ...isInitPy(filePath) ? {
+                unfixable: [
+                    'F401'
+                ]
+            } : {}
+        }
+    });
+    // Apply a single fix per pass and re-lint, as ruff does until the content
+    // stabilises. Taking one fix at a time leaves ruff to decide what is
+    // applicable against the current content, rather than reproducing how it
+    // batches, orders and skips overlapping fixes within a pass.
+    for(let i = 0; i < MAX_FIX_ITERATIONS; i++){
+        let diagnostic;
+        try {
+            diagnostic = workspace.check(content).find((d)=>d.fix && d.fix.edits.length > 0);
+        } catch  {
+            break;
+        }
+        if (!diagnostic?.fix) {
+            break;
+        }
+        const fixed = applyFix(content, diagnostic.fix.edits);
+        if (fixed === content) {
+            break;
+        }
+        content = fixed;
+    }
+    try {
+        return workspace.format(content);
+    } catch  {
+        // Leave content the formatter rejects (eg a syntax error) as-is.
+        return content;
+    }
+};
+
+//# sourceMappingURL=ruff.js.map

package/src/utils/ruff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/ruff.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { PositionEncoding, Workspace } from '@astral-sh/ruff-wasm-nodejs';\nimport path from 'path';\n\n/**\n * Rules whose fixes are applied to generated Python.\n *\n * `ruff_wasm`'s `check` serialises every fix without its applicability (the\n * `Fix::applicability()` it drops is what `ruff check --fix` filters on) and\n * ignores `unsafe-fixes`, so it cannot be asked for only the fixes the CLI would\n * apply. Taking them all would rewrite `if x == True` to `if x`.\n *\n * Ruff's `fixable` setting filters inside the linter, which keeps the decision\n * in ruff — but it selects by *rule*, and applicability is a property of each\n * *diagnostic*: across ruff's own 1598 lint fixtures, 27 rules under the vended\n * selection emit both safe and unsafe fixes depending on the code (one `UP008`\n * is safe, another is unsafe when dropping the arguments would take a comment\n * with them). So no rule list, allowing or denying, can reproduce `--fix`: for\n * those 27 it can only take both or neither.\n *\n * Given that, the list stays as small as generation needs rather than reaching\n * for an equivalence it cannot have. These four cover the import hygiene\n * generation itself creates by merging imports into existing files, and ruff\n * documents each of their fixes as safe — except F401 in an `__init__.py`, which\n * is excluded below. Templates are authored free of other violations, so nothing\n * else needs fixing here, and the user's own `lint --configuration=fix` remains\n * the full-fidelity path. A test re-checks these against ruff's own docs.\n */\nexport const FIXABLE_RULES = ['I001', 'F401', 'F811', 'E401'];\n\n/** Escape hatch matching ruff's own fix loop bound. */\nconst MAX_FIX_ITERATIONS = 100;\n\n/**\n * The ruff release these bindings are built from. `@astral-sh/ruff-wasm-nodejs`\n * is published from the ruff repo on every release, so its versions track ruff's\n * exactly — keep this in step with `PY_VERSIONS.ruff` (the ruff the vended\n * `format` and `lint` targets run) so generated files stay `ruff format\n * --check`-clean on disk. A test asserts the two agree.\n */\nexport const RUFF_WASM_VERSION = Workspace.version();\n\ninterface Location {\n  readonly row: number;\n  readonly column: number;\n}\n\ninterface Edit {\n  readonly content: string | null;\n  readonly location: Location;\n  readonly end_location: Location;\n}\n\ninterface Diagnostic {\n  readonly fix: { readonly edits: readonly Edit[] } | null;\n}\n\n/** Ruff settings, as accepted by the WASM `Workspace` constructor. */\nexport interface RuffOptions {\n  readonly 'line-length'?: number;\n  readonly 'target-version'?: string;\n  readonly lint?: {\n    readonly select?: readonly string[];\n    readonly 'extend-select'?: readonly string[];\n    readonly fixable?: readonly string[];\n    readonly unfixable?: readonly string[];\n    readonly isort?: { readonly 'known-first-party'?: readonly string[] };\n  };\n}\n\n/**\n * Apply one diagnostic's fix, resolving ruff's (row, column) positions against\n * the content. Positions are requested in UTF-16, which is how JavaScript\n * already indexes strings, so they need no transcoding.\n */\nconst applyFix = (content: string, edits: readonly Edit[]): string => {\n  const lineStarts = [0];\n  for (let i = 0; i < content.length; i++) {\n    if (content[i] === '\\n') {\n      lineStarts.push(i + 1);\n    }\n  }\n  // Ruff can report a position one past the last line (eg when deleting a\n  // trailing line), so clamp rather than indexing past the end.\n  const offsetOf = (location: Location): number =>\n    (lineStarts[location.row - 1] ?? content.length) + (location.column - 1);\n\n  let result = '';\n  let end = 0;\n  for (const edit of [...edits].sort(\n    (a, b) => offsetOf(a.location) - offsetOf(b.location),\n  )) {\n    const start = offsetOf(edit.location);\n    if (start < end) {\n      continue;\n    }\n    result += content.slice(end, start) + (edit.content ?? '');\n    end = offsetOf(edit.end_location);\n  }\n  return result + content.slice(end);\n};\n\n/**\n * Ruff treats an `__init__.py` as re-exporting its imports, so an unused import\n * there gets a diagnostic with no fix — removing it would drop the package's\n * public API. `ruff_wasm` lints under a fixed placeholder filename and so cannot\n * apply this itself, making the file's real name the caller's to account for.\n */\nconst isInitPy = (filePath: string): boolean =>\n  path.basename(filePath) === '__init__.py';\n\n/**\n * A `Workspace` costs far more to construct than to run, and the same settings\n * recur across every file of a project, so key them by the resolved options.\n */\nconst _workspaces = new Map<string, Workspace>();\nconst getWorkspace = (options: RuffOptions): Workspace => {\n  const key = JSON.stringify(options);\n  let workspace = _workspaces.get(key);\n  if (!workspace) {\n    workspace = new Workspace(options, PositionEncoding.Utf16);\n    _workspaces.set(key, workspace);\n  }\n  return workspace;\n};\n\n/**\n * Apply ruff's lint fixes and formatter to Python content, in process.\n *\n * Equivalent to piping the content through `ruff check --fix` then `ruff\n * format` — the tools the vended `lint` and `format` targets run — without\n * paying two process spawns per file.\n */\nexport const ruffFixAndFormat = (\n  content: string,\n  filePath: string,\n  options: RuffOptions,\n): string => {\n  const workspace = getWorkspace({\n    ...options,\n    lint: {\n      ...options.lint,\n      fixable: FIXABLE_RULES,\n      // Never drop an `__init__.py` import: ruff keeps these as re-exports.\n      ...(isInitPy(filePath) ? { unfixable: ['F401'] } : {}),\n    },\n  });\n\n  // Apply a single fix per pass and re-lint, as ruff does until the content\n  // stabilises. Taking one fix at a time leaves ruff to decide what is\n  // applicable against the current content, rather than reproducing how it\n  // batches, orders and skips overlapping fixes within a pass.\n  for (let i = 0; i < MAX_FIX_ITERATIONS; i++) {\n    let diagnostic: Diagnostic | undefined;\n    try {\n      diagnostic = (workspace.check(content) as Diagnostic[]).find(\n        (d) => d.fix && d.fix.edits.length > 0,\n      );\n    } catch {\n      // Content that does not parse has nothing to fix; still try to format it.\n      break;\n    }\n    if (!diagnostic?.fix) {\n      break;\n    }\n    const fixed = applyFix(content, diagnostic.fix.edits);\n    if (fixed === content) {\n      break;\n    }\n    content = fixed;\n  }\n\n  try {\n    return workspace.format(content);\n  } catch {\n    // Leave content the formatter rejects (eg a syntax error) as-is.\n    return content;\n  }\n};\n"],"names":["PositionEncoding","Workspace","path","FIXABLE_RULES","MAX_FIX_ITERATIONS","RUFF_WASM_VERSION","version","applyFix","content","edits","lineStarts","i","length","push","offsetOf","location","row","column","result","end","edit","sort","a","b","start","slice","end_location","isInitPy","filePath","basename","_workspaces","Map","getWorkspace","options","key","JSON","stringify","workspace","get","Utf16","set","ruffFixAndFormat","lint","fixable","unfixable","diagnostic","check","find","d","fix","fixed","format"],"mappings":"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"}

package/src/utils/shared-constructs-constants.d.ts

@@ -1,7 +1,3 @@
-/**
- * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
 export declare const PACKAGES_DIR = "packages";
 export declare const SHARED_CONSTRUCTS_NAME = "common-constructs";
 export declare const SHARED_CONSTRUCTS_DIR = "common/constructs";
@@ -13,3 +9,49 @@ export declare const SHARED_INFRA_CONFIG_NAME = "common-infra-config";
 export declare const SHARED_INFRA_CONFIG_DIR = "common/infra-config";
 export declare const SHARED_SCRIPTS_NAME = "common-scripts";
 export declare const SHARED_SCRIPTS_DIR = "common/scripts";
+export declare const DYNAMODB_GENERATOR_IDS: string[];
+/**
+ * What a generator records about the infrastructure it generated.
+ *
+ * Every generator that creates infrastructure records the `iac` it used, so a
+ * predicate can tell a CDK project from a Terraform one at upgrade time. Absent
+ * when the generator was run with no infrastructure, so its presence doubles as
+ * "infrastructure was generated" — which is what gates the packages an infra
+ * helper adds.
+ */
+export interface IacMetadata {
+    readonly iac?: string;
+}
+/**
+ * Whether infrastructure was generated at all, so the packages an infra helper
+ * adds are only claimed where that helper ran.
+ *
+ * Reads `iac` rather than the generator's own `infra` option: every generator
+ * resolves `iac` only on the infra branch, so one recorded field answers both
+ * questions and no generator needs a second one.
+ */
+export declare const generatedInfrastructure: (m: IacMetadata) => boolean;
+/**
+ * Whether Terraform infrastructure was generated, for the versions only a `.tf`
+ * module pins — a Terraform inline script's `uv run --with` pins, which the CDK
+ * branch never writes.
+ */
+export declare const generatedTerraform: (m: IacMetadata) => boolean;
+/**
+ * Dependencies a caller must declare to use the shared constructs project.
+ * Lives here so generators can spread it without importing the generator.
+ *
+ * `constructs` and `aws-cdk-lib` are gated on CDK because
+ * `sharedConstructsGenerator` creates the TypeScript constructs project on that
+ * branch alone — a Terraform workspace gets the shared Terraform project and
+ * never receives them.
+ */
+export declare const SHARED_CONSTRUCTS_DEPENDENCIES: readonly [{
+    readonly name: "constructs";
+    readonly when: (m: IacMetadata) => boolean;
+}, {
+    readonly name: "aws-cdk-lib";
+    readonly when: (m: IacMetadata) => boolean;
+}, {
+    readonly name: "@types/node";
+}];

package/src/utils/shared-constructs-constants.js

@@ -1,19 +1,54 @@
-"use strict";
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SHARED_SCRIPTS_DIR = exports.SHARED_SCRIPTS_NAME = exports.SHARED_INFRA_CONFIG_DIR = exports.SHARED_INFRA_CONFIG_NAME = exports.SHARED_SHADCN_DIR = exports.SHARED_SHADCN_NAME = exports.SHARED_TERRAFORM_DIR = exports.SHARED_TERRAFORM_NAME = exports.SHARED_CONSTRUCTS_DIR = exports.SHARED_CONSTRUCTS_NAME = exports.PACKAGES_DIR = void 0;
-exports.PACKAGES_DIR = 'packages';
-exports.SHARED_CONSTRUCTS_NAME = 'common-constructs';
-exports.SHARED_CONSTRUCTS_DIR = 'common/constructs';
-exports.SHARED_TERRAFORM_NAME = 'terraform';
-exports.SHARED_TERRAFORM_DIR = 'common/terraform';
-exports.SHARED_SHADCN_NAME = 'common-shadcn';
-exports.SHARED_SHADCN_DIR = 'common/shadcn';
-exports.SHARED_INFRA_CONFIG_NAME = 'common-infra-config';
-exports.SHARED_INFRA_CONFIG_DIR = 'common/infra-config';
-exports.SHARED_SCRIPTS_NAME = 'common-scripts';
-exports.SHARED_SCRIPTS_DIR = 'common/scripts';
+ */ export const PACKAGES_DIR = 'packages';
+export const SHARED_CONSTRUCTS_NAME = 'common-constructs';
+export const SHARED_CONSTRUCTS_DIR = 'common/constructs';
+export const SHARED_TERRAFORM_NAME = 'terraform';
+export const SHARED_TERRAFORM_DIR = 'common/terraform';
+export const SHARED_SHADCN_NAME = 'common-shadcn';
+export const SHARED_SHADCN_DIR = 'common/shadcn';
+export const SHARED_INFRA_CONFIG_NAME = 'common-infra-config';
+export const SHARED_INFRA_CONFIG_DIR = 'common/infra-config';
+export const SHARED_SCRIPTS_NAME = 'common-scripts';
+export const SHARED_SCRIPTS_DIR = 'common/scripts';
+export const DYNAMODB_GENERATOR_IDS = [
+    'ts#dynamodb',
+    'py#dynamodb'
+];
+/**
+ * Whether infrastructure was generated at all, so the packages an infra helper
+ * adds are only claimed where that helper ran.
+ *
+ * Reads `iac` rather than the generator's own `infra` option: every generator
+ * resolves `iac` only on the infra branch, so one recorded field answers both
+ * questions and no generator needs a second one.
+ */ export const generatedInfrastructure = (m)=>m.iac !== undefined;
+/**
+ * Whether Terraform infrastructure was generated, for the versions only a `.tf`
+ * module pins — a Terraform inline script's `uv run --with` pins, which the CDK
+ * branch never writes.
+ */ export const generatedTerraform = (m)=>m.iac === 'terraform';
+/**
+ * Dependencies a caller must declare to use the shared constructs project.
+ * Lives here so generators can spread it without importing the generator.
+ *
+ * `constructs` and `aws-cdk-lib` are gated on CDK because
+ * `sharedConstructsGenerator` creates the TypeScript constructs project on that
+ * branch alone — a Terraform workspace gets the shared Terraform project and
+ * never receives them.
+ */ export const SHARED_CONSTRUCTS_DEPENDENCIES = [
+    {
+        name: 'constructs',
+        when: (m)=>m.iac === 'cdk'
+    },
+    {
+        name: 'aws-cdk-lib',
+        when: (m)=>m.iac === 'cdk'
+    },
+    {
+        name: '@types/node'
+    }
+];
+
 //# sourceMappingURL=shared-constructs-constants.js.map

package/src/utils/shared-constructs-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-constructs-constants.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/shared-constructs-constants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEU,QAAA,YAAY,GAAG,UAAU,CAAC;AAC1B,QAAA,sBAAsB,GAAG,mBAAmB,CAAC;AAC7C,QAAA,qBAAqB,GAAG,mBAAmB,CAAC;AAC5C,QAAA,qBAAqB,GAAG,WAAW,CAAC;AACpC,QAAA,oBAAoB,GAAG,kBAAkB,CAAC;AAC1C,QAAA,kBAAkB,GAAG,eAAe,CAAC;AACrC,QAAA,iBAAiB,GAAG,eAAe,CAAC;AACpC,QAAA,wBAAwB,GAAG,qBAAqB,CAAC;AACjD,QAAA,uBAAuB,GAAG,qBAAqB,CAAC;AAChD,QAAA,mBAAmB,GAAG,gBAAgB,CAAC;AACvC,QAAA,kBAAkB,GAAG,gBAAgB,CAAC"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/shared-constructs-constants.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { DeclaredTsDependency } from './declared-dependencies.js';\nimport type { ITsDepVersion } from './versions.js';\n\nexport const PACKAGES_DIR = 'packages';\nexport const SHARED_CONSTRUCTS_NAME = 'common-constructs';\nexport const SHARED_CONSTRUCTS_DIR = 'common/constructs';\nexport const SHARED_TERRAFORM_NAME = 'terraform';\nexport const SHARED_TERRAFORM_DIR = 'common/terraform';\nexport const SHARED_SHADCN_NAME = 'common-shadcn';\nexport const SHARED_SHADCN_DIR = 'common/shadcn';\nexport const SHARED_INFRA_CONFIG_NAME = 'common-infra-config';\nexport const SHARED_INFRA_CONFIG_DIR = 'common/infra-config';\nexport const SHARED_SCRIPTS_NAME = 'common-scripts';\nexport const SHARED_SCRIPTS_DIR = 'common/scripts';\n\nexport const DYNAMODB_GENERATOR_IDS = ['ts#dynamodb', 'py#dynamodb'];\n\n/**\n * What a generator records about the infrastructure it generated.\n *\n * Every generator that creates infrastructure records the `iac` it used, so a\n * predicate can tell a CDK project from a Terraform one at upgrade time. Absent\n * when the generator was run with no infrastructure, so its presence doubles as\n * \"infrastructure was generated\" — which is what gates the packages an infra\n * helper adds.\n */\nexport interface IacMetadata {\n  readonly iac?: string;\n}\n\n/**\n * Whether infrastructure was generated at all, so the packages an infra helper\n * adds are only claimed where that helper ran.\n *\n * Reads `iac` rather than the generator's own `infra` option: every generator\n * resolves `iac` only on the infra branch, so one recorded field answers both\n * questions and no generator needs a second one.\n */\nexport const generatedInfrastructure = (m: IacMetadata): boolean =>\n  m.iac !== undefined;\n\n/**\n * Whether Terraform infrastructure was generated, for the versions only a `.tf`\n * module pins — a Terraform inline script's `uv run --with` pins, which the CDK\n * branch never writes.\n */\nexport const generatedTerraform = (m: IacMetadata): boolean =>\n  m.iac === 'terraform';\n\n/**\n * Dependencies a caller must declare to use the shared constructs project.\n * Lives here so generators can spread it without importing the generator.\n *\n * `constructs` and `aws-cdk-lib` are gated on CDK because\n * `sharedConstructsGenerator` creates the TypeScript constructs project on that\n * branch alone — a Terraform workspace gets the shared Terraform project and\n * never receives them.\n */\nexport const SHARED_CONSTRUCTS_DEPENDENCIES = [\n  { name: 'constructs', when: (m: IacMetadata) => m.iac === 'cdk' },\n  { name: 'aws-cdk-lib', when: (m: IacMetadata) => m.iac === 'cdk' },\n  { name: '@types/node' },\n] as const satisfies readonly DeclaredTsDependency<\n  ITsDepVersion,\n  IacMetadata\n>[];\n"],"names":["PACKAGES_DIR","SHARED_CONSTRUCTS_NAME","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_NAME","SHARED_TERRAFORM_DIR","SHARED_SHADCN_NAME","SHARED_SHADCN_DIR","SHARED_INFRA_CONFIG_NAME","SHARED_INFRA_CONFIG_DIR","SHARED_SCRIPTS_NAME","SHARED_SCRIPTS_DIR","DYNAMODB_GENERATOR_IDS","generatedInfrastructure","m","iac","undefined","generatedTerraform","SHARED_CONSTRUCTS_DEPENDENCIES","name","when"],"mappings":"AAAA;;;CAGC,GAID,OAAO,MAAMA,eAAe,WAAW;AACvC,OAAO,MAAMC,yBAAyB,oBAAoB;AAC1D,OAAO,MAAMC,wBAAwB,oBAAoB;AACzD,OAAO,MAAMC,wBAAwB,YAAY;AACjD,OAAO,MAAMC,uBAAuB,mBAAmB;AACvD,OAAO,MAAMC,qBAAqB,gBAAgB;AAClD,OAAO,MAAMC,oBAAoB,gBAAgB;AACjD,OAAO,MAAMC,2BAA2B,sBAAsB;AAC9D,OAAO,MAAMC,0BAA0B,sBAAsB;AAC7D,OAAO,MAAMC,sBAAsB,iBAAiB;AACpD,OAAO,MAAMC,qBAAqB,iBAAiB;AAEnD,OAAO,MAAMC,yBAAyB;IAAC;IAAe;CAAc,CAAC;AAerE;;;;;;;CAOC,GACD,OAAO,MAAMC,0BAA0B,CAACC,IACtCA,EAAEC,GAAG,KAAKC,UAAU;AAEtB;;;;CAIC,GACD,OAAO,MAAMC,qBAAqB,CAACH,IACjCA,EAAEC,GAAG,KAAK,YAAY;AAExB;;;;;;;;CAQC,GACD,OAAO,MAAMG,iCAAiC;IAC5C;QAAEC,MAAM;QAAcC,MAAM,CAACN,IAAmBA,EAAEC,GAAG,KAAK;IAAM;IAChE;QAAEI,MAAM;QAAeC,MAAM,CAACN,IAAmBA,EAAEC,GAAG,KAAK;IAAM;IACjE;QAAEI,MAAM;IAAc;CACvB,CAGG"}

package/src/utils/shared-constructs.d.ts

@@ -3,8 +3,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { type Tree } from '@nx/devkit';
-import type { Iac } from './iac';
+import type { DependencyDeclaration, MustDeclare } from './declared-dependencies.js';
+import type { Iac } from './iac.js';
+import { SHARED_CONSTRUCTS_DEPENDENCIES } from './shared-constructs-constants.js';
+export { SHARED_CONSTRUCTS_DEPENDENCIES };
 export interface SharedConstructsGeneratorOptions {
     iac: Iac;
 }
-export declare function sharedConstructsGenerator(tree: Tree, options: SharedConstructsGeneratorOptions): Promise<void>;
+export declare function sharedConstructsGenerator<const D extends DependencyDeclaration>(tree: Tree, options: SharedConstructsGeneratorOptions, declaration: D & MustDeclare<typeof SHARED_CONSTRUCTS_DEPENDENCIES, D>): Promise<void>;