@aws/nx-plugin 1.0.0-rc.54 → 1.0.0-rc.55

package/src/ts/react-website/cognito-auth/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/cognito-auth/generator.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 Tree,\n} from '@nx/devkit';\nimport { readFileSync } from 'fs';\nimport { join } from 'path';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast';\nimport { addHookResultToRouterProviderContext } from '../../../utils/ast/website';\nimport { addDependenciesToPackageJson } from '../../../utils/dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { resolveIac } from '../../../utils/iac';\nimport { addIdentityInfra } from '../../../utils/identity-constructs/identity-constructs';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { getNpmScope } from '../../../utils/npm-scope';\nimport {\n  addComponentGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { toProjectRelativePath } from '../../../utils/paths';\nimport { sharedConstructsGenerator } from '../../../utils/shared-constructs';\nimport { withVersions } from '../../../utils/versions';\nimport { runtimeConfigGenerator } from '../runtime-config/generator';\nimport type { TsReactWebsiteAuthGeneratorSchema } from './schema';\nimport {\n  addCloudscapeAuthMenu,\n  addNoneAuthMenu,\n  addShadcnAuthMenu,\n  deriveCognitoDomainPrefix,\n} from './utils';\n\nconst readGritPattern = (name: string): string =>\n  readFileSync(\n    join(import.meta.dirname, 'grit', `${name}.grit`),\n    'utf-8',\n  ).trim();\n\nexport const COGNITO_AUTH_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport async function tsReactWebsiteAuthGenerator(\n  tree: Tree,\n  options: TsReactWebsiteAuthGeneratorSchema,\n) {\n  const projectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.project,\n  );\n  const srcRoot = projectConfig.sourceRoot;\n\n  const cognitoDomain =\n    options.cognitoDomain && options.cognitoDomain.length > 0\n      ? options.cognitoDomain\n      : deriveCognitoDomainPrefix(getNpmScope(tree), projectConfig.name!);\n\n  await runtimeConfigGenerator(tree, {\n    project: options.project,\n    preferInstallDependencies: false,\n  });\n\n  const iac = await resolveIac(tree, options.iac);\n\n  await sharedConstructsGenerator(tree, {\n    iac,\n  });\n\n  await addIdentityInfra(tree, {\n    iac,\n    allowSignup: options.allowSignup,\n    cognitoDomain,\n  });\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'app'),\n    srcRoot,\n    options,\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  addDependenciesToPackageJson(\n    tree,\n    withVersions(['oidc-client-ts', 'react-oidc-context']),\n    {},\n    joinPathFragments(projectConfig.root, 'package.json'),\n  );\n\n  const mainTsxPath = joinPathFragments(srcRoot, 'main.tsx');\n\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'CognitoAuth',\n    './components/CognitoAuth',\n  );\n\n  await addHookResultToRouterProviderContext(tree, mainTsxPath, {\n    hook: 'useAuth',\n    module: 'react-oidc-context',\n    contextProp: 'auth',\n  });\n\n  const projectConfiguration = readProjectConfigurationUnqualified(\n    tree,\n    options.project,\n  );\n\n  const ux = (\n    (projectConfiguration.metadata as any)?.ux ?? 'shadcn'\n  ).toLowerCase();\n\n  await applyGritQL(tree, mainTsxPath, readGritPattern('cognito-auth-wrapper'));\n  // Update App Layout\n  const appLayoutTsxPath = joinPathFragments(\n    srcRoot,\n    'components',\n    'AppLayout',\n    'index.tsx',\n  );\n  if (tree.exists(appLayoutTsxPath)) {\n    await addDestructuredImport(\n      tree,\n      appLayoutTsxPath,\n      ['useAuth'],\n      'react-oidc-context',\n    );\n    await applyGritQL(\n      tree,\n      appLayoutTsxPath,\n      readGritPattern('app-layout-use-auth'),\n    );\n    // TODO: update utils if they exist by appending to the array\n    // Add a top-level navigation menu that shows the signed-in user's profile and actions\n    switch (ux) {\n      case 'cloudscape':\n        await addCloudscapeAuthMenu(tree, appLayoutTsxPath);\n        break;\n      case 'shadcn':\n        await addShadcnAuthMenu(tree, appLayoutTsxPath);\n        break;\n      case 'none':\n        await addNoneAuthMenu(tree, appLayoutTsxPath);\n        break;\n      default:\n        throw new Error(\n          `Top-level navigation menu to show the signed-in user for ux \"${ux}\" is not implemented.`,\n        );\n    }\n  } else {\n    console.info(\n      `Skipping update to ${appLayoutTsxPath} as it does not exist.`,\n    );\n  }\n  // End update App Layout\n\n  addComponentGeneratorMetadata(\n    tree,\n    options.project,\n    COGNITO_AUTH_GENERATOR_INFO,\n    toProjectRelativePath(\n      projectConfig,\n      joinPathFragments(srcRoot, 'components', 'CognitoAuth'),\n    ),\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [COGNITO_AUTH_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n}\nexport default tsReactWebsiteAuthGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","readFileSync","join","addDestructuredImport","addSingleImport","applyGritQL","addHookResultToRouterProviderContext","addDependenciesToPackageJson","formatFilesInSubtree","resolveIac","addIdentityInfra","installDependencies","addGeneratorMetricsIfApplicable","getNpmScope","addComponentGeneratorMetadata","getGeneratorInfo","readProjectConfigurationUnqualified","toProjectRelativePath","sharedConstructsGenerator","withVersions","runtimeConfigGenerator","addCloudscapeAuthMenu","addNoneAuthMenu","addShadcnAuthMenu","deriveCognitoDomainPrefix","readGritPattern","name","dirname","trim","COGNITO_AUTH_GENERATOR_INFO","filename","tsReactWebsiteAuthGenerator","tree","options","projectConfig","project","srcRoot","sourceRoot","cognitoDomain","length","preferInstallDependencies","iac","allowSignup","overwriteStrategy","KeepExisting","root","mainTsxPath","hook","module","contextProp","projectConfiguration","ux","metadata","toLowerCase","appLayoutTsxPath","exists","Error","console","info","languages"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/cognito-auth/generator.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 Tree,\n} from '@nx/devkit';\nimport { readFileSync } from 'fs';\nimport { join } from 'path';\nimport { addTsDependencies } from '../../../utils/add-dependencies';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast';\nimport { addHookResultToRouterProviderContext } from '../../../utils/ast/website';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { resolveIac } from '../../../utils/iac';\nimport { addIdentityInfra } from '../../../utils/identity-constructs/identity-constructs';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { getNpmScope } from '../../../utils/npm-scope';\nimport {\n  addComponentGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { toProjectRelativePath } from '../../../utils/paths';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../../utils/shared-constructs';\nimport { runtimeConfigGenerator } from '../runtime-config/generator';\nimport type { TsReactWebsiteAuthGeneratorSchema } from './schema';\nimport {\n  addCloudscapeAuthMenu,\n  addNoneAuthMenu,\n  addShadcnAuthMenu,\n  deriveCognitoDomainPrefix,\n} from './utils';\n\nconst readGritPattern = (name: string): string =>\n  readFileSync(\n    join(import.meta.dirname, 'grit', `${name}.grit`),\n    'utf-8',\n  ).trim();\n\nexport const DEPENDENCIES = declareDependencies()({\n  ts: [\n    { name: 'oidc-client-ts' },\n    { name: 'react-oidc-context' },\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n});\n\nexport const COGNITO_AUTH_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport async function tsReactWebsiteAuthGenerator(\n  tree: Tree,\n  options: TsReactWebsiteAuthGeneratorSchema,\n) {\n  const projectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.project,\n  );\n  const srcRoot = projectConfig.sourceRoot;\n\n  const cognitoDomain =\n    options.cognitoDomain && options.cognitoDomain.length > 0\n      ? options.cognitoDomain\n      : deriveCognitoDomainPrefix(getNpmScope(tree), projectConfig.name!);\n\n  await runtimeConfigGenerator(tree, {\n    project: options.project,\n    preferInstallDependencies: false,\n  });\n\n  const iac = await resolveIac(tree, options.iac);\n\n  await sharedConstructsGenerator(\n    tree,\n    {\n      iac,\n    },\n    DEPENDENCIES,\n  );\n\n  await addIdentityInfra(tree, {\n    iac,\n    allowSignup: options.allowSignup,\n    cognitoDomain,\n  });\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'app'),\n    srcRoot,\n    options,\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { projectRoot: projectConfig.root });\n\n  const mainTsxPath = joinPathFragments(srcRoot, 'main.tsx');\n\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'CognitoAuth',\n    './components/CognitoAuth',\n  );\n\n  await addHookResultToRouterProviderContext(tree, mainTsxPath, {\n    hook: 'useAuth',\n    module: 'react-oidc-context',\n    contextProp: 'auth',\n  });\n\n  const projectConfiguration = readProjectConfigurationUnqualified(\n    tree,\n    options.project,\n  );\n\n  const ux = (\n    (projectConfiguration.metadata as any)?.ux ?? 'shadcn'\n  ).toLowerCase();\n\n  await applyGritQL(tree, mainTsxPath, readGritPattern('cognito-auth-wrapper'));\n  // Update App Layout\n  const appLayoutTsxPath = joinPathFragments(\n    srcRoot,\n    'components',\n    'AppLayout',\n    'index.tsx',\n  );\n  if (tree.exists(appLayoutTsxPath)) {\n    await addDestructuredImport(\n      tree,\n      appLayoutTsxPath,\n      ['useAuth'],\n      'react-oidc-context',\n    );\n    await applyGritQL(\n      tree,\n      appLayoutTsxPath,\n      readGritPattern('app-layout-use-auth'),\n    );\n    // TODO: update utils if they exist by appending to the array\n    // Add a top-level navigation menu that shows the signed-in user's profile and actions\n    switch (ux) {\n      case 'cloudscape':\n        await addCloudscapeAuthMenu(tree, appLayoutTsxPath);\n        break;\n      case 'shadcn':\n        await addShadcnAuthMenu(tree, appLayoutTsxPath);\n        break;\n      case 'none':\n        await addNoneAuthMenu(tree, appLayoutTsxPath);\n        break;\n      default:\n        throw new Error(\n          `Top-level navigation menu to show the signed-in user for ux \"${ux}\" is not implemented.`,\n        );\n    }\n  } else {\n    console.info(\n      `Skipping update to ${appLayoutTsxPath} as it does not exist.`,\n    );\n  }\n  // End update App Layout\n\n  addComponentGeneratorMetadata(\n    tree,\n    options.project,\n    COGNITO_AUTH_GENERATOR_INFO,\n    toProjectRelativePath(\n      projectConfig,\n      joinPathFragments(srcRoot, 'components', 'CognitoAuth'),\n    ),\n    undefined,\n    { iac },\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [COGNITO_AUTH_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n}\nexport default tsReactWebsiteAuthGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","readFileSync","join","addTsDependencies","addDestructuredImport","addSingleImport","applyGritQL","addHookResultToRouterProviderContext","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","addIdentityInfra","installDependencies","addGeneratorMetricsIfApplicable","getNpmScope","addComponentGeneratorMetadata","getGeneratorInfo","readProjectConfigurationUnqualified","toProjectRelativePath","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","runtimeConfigGenerator","addCloudscapeAuthMenu","addNoneAuthMenu","addShadcnAuthMenu","deriveCognitoDomainPrefix","readGritPattern","name","dirname","trim","DEPENDENCIES","ts","COGNITO_AUTH_GENERATOR_INFO","filename","tsReactWebsiteAuthGenerator","tree","options","projectConfig","project","srcRoot","sourceRoot","cognitoDomain","length","preferInstallDependencies","iac","allowSignup","overwriteStrategy","KeepExisting","projectRoot","root","mainTsxPath","hook","module","contextProp","projectConfiguration","ux","metadata","toLowerCase","appLayoutTsxPath","exists","Error","console","info","undefined","languages"],"mappings":"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"}

package/src/utils/add-dependencies.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import { type DependencyDeclaration, type DependencyMetadata } from './declared-dependencies';
+/**
+ * Add the dependencies a declaration says apply, so the declaration is the only
+ * place packages are listed.
+ *
+ * Pass the very object recorded as the project's metadata: the version sync
+ * migration replays the same predicates against it, so what a generator adds and
+ * what the migration owns cannot drift.
+ */
+export interface AddDependenciesOptions {
+    /** The metadata the declaration's `when` predicates read. */
+    readonly metadata?: DependencyMetadata;
+    /**
+     * Project whose manifests receive the dependencies. Required unless every
+     * applicable entry is marked `root`, which targets the workspace root instead.
+     */
+    readonly projectRoot?: string;
+}
+/**
+ * Add every applicable TypeScript dependency from a declaration.
+ *
+ * Runtime deps land in the project's manifest so `noUndeclaredDependencies`
+ * passes; `dev: true` entries go to the root, where shared tooling belongs.
+ */
+export declare const addTsDependencies: (tree: Tree, declaration: DependencyDeclaration, { metadata, projectRoot }?: AddDependenciesOptions) => GeneratorCallback;
+/**
+ * Add every applicable Python dependency from a declaration, routing `group`
+ * entries to their pyproject dependency group.
+ *
+ * `root: true` entries go to the workspace root pyproject, where shared tooling
+ * belongs, mirroring the TypeScript side.
+ */
+export declare const addPyDependencies: (tree: Tree, declaration: DependencyDeclaration, { metadata, projectRoot }?: AddDependenciesOptions) => void;

package/src/utils/add-dependencies.js

@@ -0,0 +1,83 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { joinPathFragments } from "@nx/devkit";
+import { applicableDependencies } from "./declared-dependencies.js";
+import { addDependenciesToPackageJson } from "./dependencies.js";
+import { addDependenciesToDependencyGroupInPyProjectToml, addDependenciesToPyProjectToml } from "./py.js";
+import { TS_VERSIONS } from "./versions.js";
+/**
+ * The manifest an entry belongs in: the workspace root for shared tooling
+ * (`root: true`), otherwise the project's own.
+ *
+ * A project-level entry with no `projectRoot` is a mistake rather than a default
+ * — silently adding it to the root manifest would leave the project failing
+ * `noUndeclaredDependencies` on a dependency it imports.
+ */ const requireProjectRoot = (entry, projectRoot, generator)=>{
+    if (entry.root) {
+        return undefined;
+    }
+    if (!projectRoot) {
+        throw new Error(`${generator} was called without a projectRoot, but '${String(entry.name)}' is not declared with \`root: true\`. ` + `Pass the project's root, or declare the dependency with \`root: true\` if it belongs to the workspace root.`);
+    }
+    return projectRoot;
+};
+/**
+ * Add every applicable TypeScript dependency from a declaration.
+ *
+ * Runtime deps land in the project's manifest so `noUndeclaredDependencies`
+ * passes; `dev: true` entries go to the root, where shared tooling belongs.
+ */ export const addTsDependencies = (tree, declaration, { metadata = {}, projectRoot } = {})=>{
+    const applicable = applicableDependencies(declaration.ts, metadata);
+    const manifests = new Map();
+    for (const entry of applicable){
+        const root = requireProjectRoot(entry, projectRoot, 'addTsDependencies');
+        const manifestPath = root ? joinPathFragments(root, 'package.json') : 'package.json';
+        const manifest = manifests.get(manifestPath) ?? {
+            runtime: {},
+            dev: {}
+        };
+        manifest[entry.dev ? 'dev' : 'runtime'][entry.name] = TS_VERSIONS[entry.name];
+        manifests.set(manifestPath, manifest);
+    }
+    const callbacks = [
+        ...manifests
+    ].map(([manifestPath, { runtime, dev }])=>addDependenciesToPackageJson(tree, runtime, dev, manifestPath));
+    return async ()=>{
+        for (const callback of callbacks){
+            await callback();
+        }
+    };
+};
+/**
+ * Add every applicable Python dependency from a declaration, routing `group`
+ * entries to their pyproject dependency group.
+ *
+ * `root: true` entries go to the workspace root pyproject, where shared tooling
+ * belongs, mirroring the TypeScript side.
+ */ export const addPyDependencies = (tree, declaration, { metadata = {}, projectRoot } = {})=>{
+    const applicable = applicableDependencies(declaration.py, metadata);
+    // Keyed by the pyproject to write and the group within it, since one
+    // declaration may span the project's and the workspace root's.
+    const buckets = new Map();
+    for (const entry of applicable){
+        const root = requireProjectRoot(entry, projectRoot, 'addPyDependencies') ?? '.';
+        const key = `${root}\0${entry.group ?? ''}`;
+        const bucket = buckets.get(key) ?? {
+            root,
+            group: entry.group,
+            names: []
+        };
+        bucket.names.push(entry.name);
+        buckets.set(key, bucket);
+    }
+    for (const { root, group, names } of buckets.values()){
+        if (group) {
+            addDependenciesToDependencyGroupInPyProjectToml(tree, root, group, declaration, names);
+        } else {
+            addDependenciesToPyProjectToml(tree, root, declaration, names);
+        }
+    }
+};
+
+//# sourceMappingURL=add-dependencies.js.map

package/src/utils/add-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/add-dependencies.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  type GeneratorCallback,\n  joinPathFragments,\n  type Tree,\n} from '@nx/devkit';\nimport {\n  applicableDependencies,\n  type DependencyDeclaration,\n  type DependencyMetadata,\n} from './declared-dependencies';\nimport { addDependenciesToPackageJson } from './dependencies';\nimport {\n  addDependenciesToDependencyGroupInPyProjectToml,\n  addDependenciesToPyProjectToml,\n} from './py';\nimport { TS_VERSIONS } from './versions';\n\n/**\n * Add the dependencies a declaration says apply, so the declaration is the only\n * place packages are listed.\n *\n * Pass the very object recorded as the project's metadata: the version sync\n * migration replays the same predicates against it, so what a generator adds and\n * what the migration owns cannot drift.\n */\nexport interface AddDependenciesOptions {\n  /** The metadata the declaration's `when` predicates read. */\n  readonly metadata?: DependencyMetadata;\n  /**\n   * Project whose manifests receive the dependencies. Required unless every\n   * applicable entry is marked `root`, which targets the workspace root instead.\n   */\n  readonly projectRoot?: string;\n}\n\n/**\n * The manifest an entry belongs in: the workspace root for shared tooling\n * (`root: true`), otherwise the project's own.\n *\n * A project-level entry with no `projectRoot` is a mistake rather than a default\n * — silently adding it to the root manifest would leave the project failing\n * `noUndeclaredDependencies` on a dependency it imports.\n */\nconst requireProjectRoot = (\n  entry: { name: unknown; root?: boolean },\n  projectRoot: string | undefined,\n  generator: string,\n): string | undefined => {\n  if (entry.root) {\n    return undefined;\n  }\n  if (!projectRoot) {\n    throw new Error(\n      `${generator} was called without a projectRoot, but '${String(entry.name)}' is not declared with \\`root: true\\`. ` +\n        `Pass the project's root, or declare the dependency with \\`root: true\\` if it belongs to the workspace root.`,\n    );\n  }\n  return projectRoot;\n};\n\n/**\n * Add every applicable TypeScript dependency from a declaration.\n *\n * Runtime deps land in the project's manifest so `noUndeclaredDependencies`\n * passes; `dev: true` entries go to the root, where shared tooling belongs.\n */\nexport const addTsDependencies = (\n  tree: Tree,\n  declaration: DependencyDeclaration,\n  { metadata = {}, projectRoot }: AddDependenciesOptions = {},\n): GeneratorCallback => {\n  const applicable = applicableDependencies(declaration.ts, metadata);\n  const manifests = new Map<\n    string,\n    { runtime: Record<string, string>; dev: Record<string, string> }\n  >();\n  for (const entry of applicable) {\n    const root = requireProjectRoot(entry, projectRoot, 'addTsDependencies');\n    const manifestPath = root\n      ? joinPathFragments(root, 'package.json')\n      : 'package.json';\n    const manifest = manifests.get(manifestPath) ?? { runtime: {}, dev: {} };\n    manifest[entry.dev ? 'dev' : 'runtime'][entry.name as string] =\n      TS_VERSIONS[entry.name];\n    manifests.set(manifestPath, manifest);\n  }\n\n  const callbacks = [...manifests].map(([manifestPath, { runtime, dev }]) =>\n    addDependenciesToPackageJson(tree, runtime, dev, manifestPath),\n  );\n  return async () => {\n    for (const callback of callbacks) {\n      await callback();\n    }\n  };\n};\n\n/**\n * Add every applicable Python dependency from a declaration, routing `group`\n * entries to their pyproject dependency group.\n *\n * `root: true` entries go to the workspace root pyproject, where shared tooling\n * belongs, mirroring the TypeScript side.\n */\nexport const addPyDependencies = (\n  tree: Tree,\n  declaration: DependencyDeclaration,\n  { metadata = {}, projectRoot }: AddDependenciesOptions = {},\n): void => {\n  const applicable = applicableDependencies(declaration.py, metadata);\n\n  // Keyed by the pyproject to write and the group within it, since one\n  // declaration may span the project's and the workspace root's.\n  const buckets = new Map<\n    string,\n    { root: string; group?: string; names: string[] }\n  >();\n  for (const entry of applicable) {\n    const root =\n      requireProjectRoot(entry, projectRoot, 'addPyDependencies') ?? '.';\n    const key = `${root}\\0${entry.group ?? ''}`;\n    const bucket = buckets.get(key) ?? { root, group: entry.group, names: [] };\n    bucket.names.push(entry.name as string);\n    buckets.set(key, bucket);\n  }\n\n  for (const { root, group, names } of buckets.values()) {\n    if (group) {\n      addDependenciesToDependencyGroupInPyProjectToml(\n        tree,\n        root,\n        group,\n        declaration,\n        names as never,\n      );\n    } else {\n      addDependenciesToPyProjectToml(tree, root, declaration, names as never);\n    }\n  }\n};\n"],"names":["joinPathFragments","applicableDependencies","addDependenciesToPackageJson","addDependenciesToDependencyGroupInPyProjectToml","addDependenciesToPyProjectToml","TS_VERSIONS","requireProjectRoot","entry","projectRoot","generator","root","undefined","Error","String","name","addTsDependencies","tree","declaration","metadata","applicable","ts","manifests","Map","manifestPath","manifest","get","runtime","dev","set","callbacks","map","callback","addPyDependencies","py","buckets","key","group","bucket","names","push","values"],"mappings":"AAAA;;;CAGC,GACD,SAEEA,iBAAiB,QAEZ,aAAa;AACpB,SACEC,sBAAsB,QAGjB,6BAA0B;AACjC,SAASC,4BAA4B,QAAQ,oBAAiB;AAC9D,SACEC,+CAA+C,EAC/CC,8BAA8B,QACzB,UAAO;AACd,SAASC,WAAW,QAAQ,gBAAa;AAoBzC;;;;;;;CAOC,GACD,MAAMC,qBAAqB,CACzBC,OACAC,aACAC;IAEA,IAAIF,MAAMG,IAAI,EAAE;QACd,OAAOC;IACT;IACA,IAAI,CAACH,aAAa;QAChB,MAAM,IAAII,MACR,GAAGH,UAAU,wCAAwC,EAAEI,OAAON,MAAMO,IAAI,EAAE,uCAAuC,CAAC,GAChH,CAAC,2GAA2G,CAAC;IAEnH;IACA,OAAON;AACT;AAEA;;;;;CAKC,GACD,OAAO,MAAMO,oBAAoB,CAC/BC,MACAC,aACA,EAAEC,WAAW,CAAC,CAAC,EAAEV,WAAW,EAA0B,GAAG,CAAC,CAAC;IAE3D,MAAMW,aAAalB,uBAAuBgB,YAAYG,EAAE,EAAEF;IAC1D,MAAMG,YAAY,IAAIC;IAItB,KAAK,MAAMf,SAASY,WAAY;QAC9B,MAAMT,OAAOJ,mBAAmBC,OAAOC,aAAa;QACpD,MAAMe,eAAeb,OACjBV,kBAAkBU,MAAM,kBACxB;QACJ,MAAMc,WAAWH,UAAUI,GAAG,CAACF,iBAAiB;YAAEG,SAAS,CAAC;YAAGC,KAAK,CAAC;QAAE;QACvEH,QAAQ,CAACjB,MAAMoB,GAAG,GAAG,QAAQ,UAAU,CAACpB,MAAMO,IAAI,CAAW,GAC3DT,WAAW,CAACE,MAAMO,IAAI,CAAC;QACzBO,UAAUO,GAAG,CAACL,cAAcC;IAC9B;IAEA,MAAMK,YAAY;WAAIR;KAAU,CAACS,GAAG,CAAC,CAAC,CAACP,cAAc,EAAEG,OAAO,EAAEC,GAAG,EAAE,CAAC,GACpEzB,6BAA6Bc,MAAMU,SAASC,KAAKJ;IAEnD,OAAO;QACL,KAAK,MAAMQ,YAAYF,UAAW;YAChC,MAAME;QACR;IACF;AACF,EAAE;AAEF;;;;;;CAMC,GACD,OAAO,MAAMC,oBAAoB,CAC/BhB,MACAC,aACA,EAAEC,WAAW,CAAC,CAAC,EAAEV,WAAW,EAA0B,GAAG,CAAC,CAAC;IAE3D,MAAMW,aAAalB,uBAAuBgB,YAAYgB,EAAE,EAAEf;IAE1D,qEAAqE;IACrE,+DAA+D;IAC/D,MAAMgB,UAAU,IAAIZ;IAIpB,KAAK,MAAMf,SAASY,WAAY;QAC9B,MAAMT,OACJJ,mBAAmBC,OAAOC,aAAa,wBAAwB;QACjE,MAAM2B,MAAM,GAAGzB,KAAK,EAAE,EAAEH,MAAM6B,KAAK,IAAI,IAAI;QAC3C,MAAMC,SAASH,QAAQT,GAAG,CAACU,QAAQ;YAAEzB;YAAM0B,OAAO7B,MAAM6B,KAAK;YAAEE,OAAO,EAAE;QAAC;QACzED,OAAOC,KAAK,CAACC,IAAI,CAAChC,MAAMO,IAAI;QAC5BoB,QAAQN,GAAG,CAACO,KAAKE;IACnB;IAEA,KAAK,MAAM,EAAE3B,IAAI,EAAE0B,KAAK,EAAEE,KAAK,EAAE,IAAIJ,QAAQM,MAAM,GAAI;QACrD,IAAIJ,OAAO;YACTjC,gDACEa,MACAN,MACA0B,OACAnB,aACAqB;QAEJ,OAAO;YACLlC,+BAA+BY,MAAMN,MAAMO,aAAaqB;QAC1D;IACF;AACF,EAAE"}

package/src/utils/agent-connection/agent-connection.d.ts

@@ -3,7 +3,28 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { type Tree } from '@nx/devkit';
+import { type DependencyDeclaration, type MustDeclare, type MustDeclarePy } from '../declared-dependencies';
 import { type IPyDepVersion } from '../versions';
+/** TypeScript dependencies a caller must declare to emit agent-connection clients. */
+export declare const AGENT_CONNECTION_DEPENDENCIES: readonly [{
+    readonly name: "@aws-lambda-powertools/parameters";
+}, {
+    readonly name: "@aws-sdk/credential-providers";
+}, {
+    readonly name: "aws4fetch";
+}, {
+    readonly name: "@modelcontextprotocol/sdk";
+}, {
+    readonly name: "@a2a-js/sdk";
+}, {
+    readonly name: "@strands-agents/sdk";
+}];
+/** Python dependencies a caller must declare to emit agent-connection clients. */
+export declare const AGENT_CONNECTION_PY_DEPENDENCIES: readonly [{
+    readonly name: "aws-lambda-powertools";
+}, {
+    readonly name: "strands-agents";
+}];
 export declare const AGENT_CONNECTION_PROJECT_DIR: string;
 /**
  * Get the directory of the shared Python agent-connection project.
@@ -49,7 +70,7 @@ export declare function resolveAgentFramework(framework: string | undefined): Ag
  * Per-connection generators emit their own protocol + framework client
  * templates via `addTypeScriptCoreClient`.
  */
-export declare function ensureTypeScriptAgentConnectionProject(tree: Tree): Promise<void>;
+export declare function ensureTypeScriptAgentConnectionProject<const D extends DependencyDeclaration>(tree: Tree, declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>): Promise<void>;
 /**
  * Emit a framework's base Layer-2 helpers (model-error logging + per-session
  * agent cache) into the agent-connection project and re-export them. The agent
@@ -57,7 +78,7 @@ export declare function ensureTypeScriptAgentConnectionProject(tree: Tree): Prom
  * is wired in, so the agent generator calls this directly; connection
  * generators call it transitively via `addTypeScriptCoreClient`.
  */
-export declare function addTypeScriptFrameworkBase(tree: Tree, framework?: AgentFramework): Promise<void>;
+export declare function addTypeScriptFrameworkBase<const D extends DependencyDeclaration>(tree: Tree, declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>, framework?: AgentFramework): Promise<void>;
 /**
  * Emit the TypeScript client templates for a connection protocol and agent
  * framework into the agent-connection project's `src/core/` directory. Safe to
@@ -69,13 +90,13 @@ export declare function addTypeScriptFrameworkBase(tree: Tree, framework?: Agent
  *  - Layer 1 the protocol's transport/client-config — always
  *  - Layer 2 the framework's base helpers + protocol client — per framework
  */
-export declare function addTypeScriptCoreClient(tree: Tree, protocol: ConnectionProtocol, framework?: AgentFramework): Promise<void>;
+export declare function addTypeScriptCoreClient<const D extends DependencyDeclaration>(tree: Tree, protocol: ConnectionProtocol, declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>, framework?: AgentFramework): Promise<void>;
 /**
  * Ensure the shared Python agent-connection project exists.
  * Only creates the project shell — per-connection generators are responsible
  * for emitting their own core client templates.
  */
-export declare function ensurePythonAgentConnectionProject(tree: Tree): Promise<void>;
+export declare function ensurePythonAgentConnectionProject<const D extends DependencyDeclaration>(tree: Tree, declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>): Promise<void>;
 /**
  * Emit a framework's base Layer-2 helpers (model-error logging + per-session
  * agent cache) into the Python agent-connection project and re-export them.
@@ -83,7 +104,7 @@ export declare function ensurePythonAgentConnectionProject(tree: Tree): Promise<
  * client is wired in, so the agent generator calls this directly; connection
  * generators call it transitively via `addPythonCoreClient`.
  */
-export declare function addPythonFrameworkBase(tree: Tree, framework?: AgentFramework): Promise<void>;
+export declare function addPythonFrameworkBase<const D extends DependencyDeclaration>(tree: Tree, declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>, framework?: AgentFramework): Promise<void>;
 /**
  * Emit the Python client templates for a connection protocol and agent
  * framework into the agent-connection project's core directory.
@@ -94,7 +115,7 @@ export declare function addPythonFrameworkBase(tree: Tree, framework?: AgentFram
  *  - Layer 1 the protocol's transport/client-config — always
  *  - Layer 2 the framework's base helpers + protocol client — per framework
  */
-export declare function addPythonCoreClient(tree: Tree, protocol: ConnectionProtocol, framework?: AgentFramework): Promise<void>;
+export declare function addPythonCoreClient<const D extends DependencyDeclaration>(tree: Tree, protocol: ConnectionProtocol, declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>, framework?: AgentFramework): Promise<void>;
 /**
  * Patch a TypeScript agent.ts to create a connection client and register it
  * in the Agent's tools. Used by the MCP and gateway connection generators —

package/src/utils/agent-connection/agent-connection.js

@@ -5,10 +5,39 @@
 import pyProjectGenerator, { getPyProjectDetails } from "../../py/project/generator.js";
 import tsProjectGenerator from "../../ts/lib/generator.js";
 import { addStarExport, applyGritQL, matchGritQL } from "../ast.js";
+import { forDependencies } from "../declared-dependencies.js";
 import { addDependenciesToPackageJson } from "../dependencies.js";
 import { esmVars } from "../module-format.js";
 import { addDependenciesToPyProjectToml } from "../py.js";
 import { withVersions } from "../versions.js";
+/** TypeScript dependencies a caller must declare to emit agent-connection clients. */ export const AGENT_CONNECTION_DEPENDENCIES = [
+    {
+        name: '@aws-lambda-powertools/parameters'
+    },
+    {
+        name: '@aws-sdk/credential-providers'
+    },
+    {
+        name: 'aws4fetch'
+    },
+    {
+        name: '@modelcontextprotocol/sdk'
+    },
+    {
+        name: '@a2a-js/sdk'
+    },
+    {
+        name: '@strands-agents/sdk'
+    }
+];
+/** Python dependencies a caller must declare to emit agent-connection clients. */ export const AGENT_CONNECTION_PY_DEPENDENCIES = [
+    {
+        name: 'aws-lambda-powertools'
+    },
+    {
+        name: 'strands-agents'
+    }
+];
 /** Prefix a GritQL pattern with `language python` */ const py = (pattern)=>`language python\n${pattern}`;
 const AGENT_CONNECTION_DIR = 'agent-connection';
 const PACKAGES_DIR = 'packages';
@@ -197,7 +226,7 @@ const tsCoreDir = ()=>joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'co
         '@strands-agents/sdk'
     ]
 };
-const emitTs = (tree, templateDir)=>{
+const emitTs = (tree, templateDir, declaration)=>{
     generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', templateDir), tsCoreDir(), {
         ...esmVars(tree)
     }, {
@@ -205,7 +234,7 @@ const emitTs = (tree, templateDir)=>{
     });
     const deps = TS_TEMPLATE_DEPS[templateDir];
     if (deps?.length) {
-        addDependenciesToPackageJson(tree, withVersions(deps), {}, joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'package.json'));
+        addDependenciesToPackageJson(tree, withVersions(forDependencies(declaration), deps), {}, joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'package.json'));
     }
 };
 /**
@@ -213,7 +242,7 @@ const emitTs = (tree, templateDir)=>{
  * framework-agnostic core helpers (runtime-config loader, session context).
  * Per-connection generators emit their own protocol + framework client
  * templates via `addTypeScriptCoreClient`.
- */ export async function ensureTypeScriptAgentConnectionProject(tree) {
+ */ export async function ensureTypeScriptAgentConnectionProject(tree, declaration) {
     const projectJsonPath = joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'project.json');
     if (!tree.exists(projectJsonPath)) {
         await tsProjectGenerator(tree, {
@@ -222,7 +251,7 @@ const emitTs = (tree, templateDir)=>{
         });
     }
     // Framework-agnostic runtime-config + session-context helpers.
-    emitTs(tree, 'core-runtime-config');
+    emitTs(tree, 'core-runtime-config', declaration);
     // Re-export session-context helpers so agent server entry points can set the
     // current session on each inbound request without pulling in internals.
     await addStarExport(tree, joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'), './core/session-context.js');
@@ -233,13 +262,13 @@ const emitTs = (tree, templateDir)=>{
  * server entry point imports these regardless of whether any connection client
  * is wired in, so the agent generator calls this directly; connection
  * generators call it transitively via `addTypeScriptCoreClient`.
- */ export async function addTypeScriptFrameworkBase(tree, framework = 'strands') {
+ */ export async function addTypeScriptFrameworkBase(tree, declaration, framework = 'strands') {
     const lang = FRAMEWORKS[framework].ts;
     if (!lang) {
         throw new Error(`The '${framework}' framework does not support TypeScript agents.`);
     }
     if (lang.base) {
-        emitTs(tree, lang.base);
+        emitTs(tree, lang.base, declaration);
     }
     const indexPath = joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts');
     for (const reExport of lang.baseReExports){
@@ -256,23 +285,23 @@ const emitTs = (tree, templateDir)=>{
  *  - Layer 1 `core-shared` MCP transport — for mcp/gateway protocols
  *  - Layer 1 the protocol's transport/client-config — always
  *  - Layer 2 the framework's base helpers + protocol client — per framework
- */ export async function addTypeScriptCoreClient(tree, protocol, framework = 'strands') {
+ */ export async function addTypeScriptCoreClient(tree, protocol, declaration, framework = 'strands') {
     const fw = frameworkLanguage(framework, 'ts', protocol);
-    emitTs(tree, 'core-auth');
+    emitTs(tree, 'core-auth', declaration);
     if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {
-        emitTs(tree, 'core-shared');
+        emitTs(tree, 'core-shared', declaration);
     }
-    emitTs(tree, TS_PROTOCOL_TEMPLATES[protocol]);
+    emitTs(tree, TS_PROTOCOL_TEMPLATES[protocol], declaration);
     // Framework Layer 2: base helpers (re-exported for the agent server) + the
     // thin protocol client.
-    await addTypeScriptFrameworkBase(tree, framework);
-    emitTs(tree, fw.protocol);
+    await addTypeScriptFrameworkBase(tree, forDependencies(declaration), framework);
+    emitTs(tree, fw.protocol, declaration);
 }
 /**
  * Ensure the shared Python agent-connection project exists.
  * Only creates the project shell — per-connection generators are responsible
  * for emitting their own core client templates.
- */ export async function ensurePythonAgentConnectionProject(tree) {
+ */ export async function ensurePythonAgentConnectionProject(tree, declaration) {
     const projectDir = getPythonAgentConnectionProjectDir(tree);
     const moduleName = getPythonAgentConnectionModuleName(tree);
     const projectJsonPath = joinPathFragments(projectDir, 'project.json');
@@ -305,7 +334,7 @@ const emitTs = (tree, templateDir)=>{
     await addPythonReExport(tree, moduleInitPath, '.core.session_context', 'get_current_session_id');
     await addPythonReExport(tree, moduleInitPath, '.core.session_context', 'session_id_context');
     // The runtime-config loader reads AppConfig via aws-lambda-powertools.
-    addDependenciesToPyProjectToml(tree, projectDir, [
+    addDependenciesToPyProjectToml(tree, projectDir, forDependencies(declaration), [
         'aws-lambda-powertools'
     ]);
 }
@@ -319,7 +348,7 @@ const emitPy = (tree, templateDir)=>generateFiles(tree, joinPathFragments(import
  * The agent server entry point imports these regardless of whether a connection
  * client is wired in, so the agent generator calls this directly; connection
  * generators call it transitively via `addPythonCoreClient`.
- */ export async function addPythonFrameworkBase(tree, framework = 'strands') {
+ */ export async function addPythonFrameworkBase(tree, declaration, framework = 'strands') {
     const lang = FRAMEWORKS[framework].py;
     if (!lang) {
         throw new Error(`The '${framework}' framework does not support Python agents.`);
@@ -332,7 +361,7 @@ const emitPy = (tree, templateDir)=>generateFiles(tree, joinPathFragments(import
         await addPythonReExport(tree, moduleInitPath, reExport.fromModule, reExport.importName);
     }
     if (lang.deps.length > 0) {
-        addDependenciesToPyProjectToml(tree, getPythonAgentConnectionProjectDir(tree), lang.deps);
+        addDependenciesToPyProjectToml(tree, getPythonAgentConnectionProjectDir(tree), forDependencies(declaration), lang.deps);
     }
 }
 /**
@@ -344,7 +373,7 @@ const emitPy = (tree, templateDir)=>generateFiles(tree, joinPathFragments(import
  *  - Layer 1 `py-core-shared` MCP transport — for mcp/gateway protocols
  *  - Layer 1 the protocol's transport/client-config — always
  *  - Layer 2 the framework's base helpers + protocol client — per framework
- */ export async function addPythonCoreClient(tree, protocol, framework = 'strands') {
+ */ export async function addPythonCoreClient(tree, protocol, declaration, framework = 'strands') {
     const fw = frameworkLanguage(framework, 'py', protocol);
     emitPy(tree, 'py-core-auth');
     if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {
@@ -352,7 +381,7 @@ const emitPy = (tree, templateDir)=>generateFiles(tree, joinPathFragments(import
     }
     emitPy(tree, PY_PROTOCOL_TEMPLATES[protocol]);
     // Framework Layer 2: base helpers + the thin protocol client.
-    await addPythonFrameworkBase(tree, framework);
+    await addPythonFrameworkBase(tree, forDependencies(declaration), framework);
     emitPy(tree, fw.protocol);
 }
 /**