@aws/nx-plugin 1.1.0 → 1.2.0

package/src/greengrass/component/typescript/files/entrypoint/main.ts.template

@@ -0,0 +1,58 @@
+<%_ if (ipc) { _%>
+import { greengrasscoreipc } from 'aws-iot-device-sdk-v2';
+
+const TOPIC = '<%- componentName %>/heartbeat';
+const PUBLISH_INTERVAL_MS = 30_000;
+
+async function getIpcClient(): Promise<greengrasscoreipc.Client> {
+  const client = greengrasscoreipc.createClient();
+  await client.connect();
+  return client;
+}
+
+export async function publishHeartbeat(
+  client: greengrasscoreipc.Client,
+  sequence: number,
+): Promise<void> {
+  const request: greengrasscoreipc.model.PublishToTopicRequest = {
+    topic: TOPIC,
+    publishMessage: { jsonMessage: { message: { sequence } } },
+  };
+  await client.publishToTopic(request);
+  console.log(`Published heartbeat ${sequence} to ${TOPIC}`);
+}
+
+async function main(): Promise<void> {
+  const client = await getIpcClient();
+  let sequence = 0;
+  for (;;) {
+    await publishHeartbeat(client, sequence);
+    sequence += 1;
+    await new Promise((resolve) => setTimeout(resolve, PUBLISH_INTERVAL_MS));
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+<%_ } else { _%>
+const RUN_INTERVAL_MS = 30_000;
+
+export function runOnce(sequence: number): void {
+  console.log(
+    `[<%- componentName %>] heartbeat ${sequence} at ${new Date().toISOString()}`,
+  );
+}
+
+async function main(): Promise<void> {
+  let sequence = 0;
+  for (;;) {
+    runOnce(sequence);
+    sequence += 1;
+    await new Promise((resolve) => setTimeout(resolve, RUN_INTERVAL_MS));
+  }
+}
+
+main();
+<%_ } _%>

package/src/greengrass/component/typescript/files/gdk/gdk-config.json.template

@@ -0,0 +1,13 @@
+{
+  "component": {
+    "<%- componentName %>": {
+      "author": "<%- publisher %>",
+      "version": "<%- version %>",
+      "build": {
+        "build_system": "custom",
+        "custom_build_command": ["nx", "run", "<%- project %>:<%- componentDirName %>-artifact"]
+      }
+    }
+  },
+  "gdk_version": "1.0.0"
+}

package/src/greengrass/component/typescript/files/scripts/vendor-crt-addon.ts.template

@@ -0,0 +1,115 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+
+/*
+ * Usage: vendor-crt-addon.ts <project-root> <bundle-dir> <stage-dir> <addon-dir>[,<addon-dir>]
+ *
+ * Writes the deployable tree for an ipc=true TypeScript Greengrass component:
+ * every file from <bundle-dir> at the tree root, plus
+ * native/aws-crt/<addon-dir>/aws-crt-nodejs.node for each requested addon dir,
+ * copied out of the installed aws-crt. <stage-dir> is then the `bundle-dir`
+ * build-artifact.ts zips, so build-artifact.ts needs no knowledge of any of
+ * this. <addon-dir> is aws-crt's own
+ * `<platform>-<arch>-<cRuntime>` directory name, e.g. linux-arm64-glibc.
+ *
+ * aws-crt publishes its addon prebuilt for every platform it supports, so this
+ * is a file copy, never a compile, and the device never installs anything.
+ */
+
+const log = (msg: string): void => console.error(`[vendor-crt-addon] ${msg}`);
+
+function usage(): never {
+  log(
+    'Usage: vendor-crt-addon.ts <project-root> <bundle-dir> <stage-dir> <addon-dir>[,<addon-dir>]',
+  );
+  process.exit(1);
+}
+
+/**
+ * The directory of `specifier`'s package.json, resolved from `fromPath`. Falls
+ * back to walking up from the resolved entry point, because a package with an
+ * `exports` map need not expose its own package.json. Both the subpath
+ * resolve and the fallback can throw - a missing package fails the first and
+ * would otherwise crash uncaught out of the second - so both are covered by
+ * one exit path with one diagnostic.
+ *
+ * `fromPath` is made absolute first: `createRequire` accepts only an absolute
+ * path or a file URL, and Nx expands `{projectRoot}` to a workspace-relative
+ * path, so passing it through unchanged throws ERR_INVALID_ARG_VALUE before
+ * either branch below can run.
+ */
+function packageRoot(fromPath: string, specifier: string): string {
+  const from = resolve(fromPath);
+  const req = createRequire(from);
+  try {
+    return dirname(req.resolve(`${specifier}/package.json`));
+  } catch {
+    // Falls through to the walk-up fallback below.
+  }
+  try {
+    let dir = dirname(req.resolve(specifier));
+    while (!existsSync(join(dir, 'package.json'))) {
+      const parent = dirname(dir);
+      if (parent === dir) {
+        throw new Error('reached the filesystem root');
+      }
+      dir = parent;
+    }
+    return dir;
+  } catch {
+    log(`Cannot locate the package root of "${specifier}" from "${from}"`);
+    process.exit(1);
+  }
+}
+
+function main(): void {
+  const [projectRoot, bundleDir, stageDir, addonDirList] = process.argv.slice(2);
+  if (!projectRoot || !bundleDir || !stageDir || !addonDirList) usage();
+
+  const addonDirs = addonDirList
+    .split(',')
+    .map((a) => a.trim())
+    .filter((a) => a.length > 0);
+  if (addonDirs.length === 0) usage();
+
+  if (!existsSync(bundleDir)) {
+    log(`Bundle output "${bundleDir}" does not exist - run this project's "bundle" target first.`);
+    process.exit(1);
+  }
+
+  // Started empty every run: a stale addon dir from a deliberate platform
+  // change must never survive into the next artifact, because artifact bytes
+  // must depend only on the current source and the current pin.
+  rmSync(stageDir, { recursive: true, force: true });
+  mkdirSync(stageDir, { recursive: true });
+  cpSync(bundleDir, stageDir, { recursive: true });
+
+  // Two hops: pnpm's default isolated linker does not expose a transitive
+  // dependency to the host project, so aws-crt resolves from the SDK that
+  // pins it, never from here.
+  const sdkRoot = packageRoot(join(projectRoot, 'package.json'), 'aws-iot-device-sdk-v2');
+  const crtRoot = packageRoot(join(sdkRoot, 'package.json'), 'aws-crt');
+  const binDir = join(crtRoot, 'dist', 'bin');
+
+  for (const addonDir of addonDirs) {
+    const source = join(binDir, addonDir, 'aws-crt-nodejs.node');
+    if (!existsSync(source)) {
+      const available = existsSync(binDir) ? readdirSync(binDir).join(', ') : '<missing>';
+      log(
+        `aws-crt at "${crtRoot}" ships no prebuilt addon for "${addonDir}" (looked for "${source}"). Available: ${available}`,
+      );
+      process.exit(1);
+    }
+    const dest = join(stageDir, 'native', 'aws-crt', addonDir, 'aws-crt-nodejs.node');
+    if (existsSync(dest)) {
+      log(`Refusing to overwrite "${dest}" - the bundle already writes that path.`);
+      process.exit(1);
+    }
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(source, dest);
+    log(`vendored ${addonDir}/aws-crt-nodejs.node`);
+  }
+}
+
+main();

package/src/greengrass/component/typescript/generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 { NormalizedComponent } from '../common.js';
+/**
+ * Generates an AWS IoT Greengrass v2 component on an existing TypeScript
+ * project: a single-file rolldown bundle plus packaging and local-deployment
+ * targets (`<c>-artifact`, `<c>-deploy-local`, `<c>-logs`), plus, unless
+ * `--infra none`, a `GreengrassComponentVersion` CDK construct (or Terraform
+ * module, via the `hashicorp/awscc` provider) that publishes the built
+ * artifact.
+ */
+export declare const typescriptGreengrassComponentGenerator: (tree: Tree, component: NormalizedComponent) => Promise<GeneratorCallback>;
+export default typescriptGreengrassComponentGenerator;

package/src/greengrass/component/typescript/generator.js

@@ -0,0 +1,194 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { generateFiles, joinPathFragments, logger, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import { addTypeScriptBundleTarget } from "../../../utils/bundle/bundle.js";
+import { GREENGRASS_PLATFORM_MAPPINGS, RECIPE_FORMAT_VERSION } from "../../../utils/greengrass/constants.js";
+import { addArtifactDependencyToTargets, normalizeTargetKeyOrder } from "../../../utils/nx.js";
+import { sortObjectKeys } from "../../../utils/object.js";
+import { toProjectRelativePath } from "../../../utils/paths.js";
+import { registerPnpmBuiltDependencies } from "../../../utils/pnpm-workspace.js";
+import { sharedGreengrassScriptsGenerator } from "../../../utils/shared-greengrass-scripts.js";
+import { assertUnchangedPlatform, finalizeComponent, GREENGRASS_SCRIPTS_DIR, sharedComponentTargets } from "../common.js";
+import { TYPESCRIPT_DEPENDENCIES as DEPENDENCIES } from "../dependencies.js";
+/**
+ * Generates an AWS IoT Greengrass v2 component on an existing TypeScript
+ * project: a single-file rolldown bundle plus packaging and local-deployment
+ * targets (`<c>-artifact`, `<c>-deploy-local`, `<c>-logs`), plus, unless
+ * `--infra none`, a `GreengrassComponentVersion` CDK construct (or Terraform
+ * module, via the `hashicorp/awscc` provider) that publishes the built
+ * artifact.
+ */ export const typescriptGreengrassComponentGenerator = async (tree, component)=>{
+    const { project: projectConfig } = component;
+    const componentDirName = component.componentDirName;
+    const componentName = component.componentName;
+    const componentVersion = component.componentVersion;
+    const publisher = component.publisher;
+    const ipc = component.ipc;
+    const gdkConfig = component.gdkConfig;
+    const platforms = component.platforms;
+    // A rolldown bundle is pure JavaScript over every architecture, and with
+    // `ipc=true` one zip carries every targeted architecture's own vendored
+    // addon - each manifest's Setenv selects only its own - so, unlike the
+    // Python component, this generator has ONE artifact over N manifests, never
+    // N artifacts.
+    const manifests = platforms.map((p)=>{
+        const { manifestPlatform, nodeCrtAddonDir } = GREENGRASS_PLATFORM_MAPPINGS[p];
+        return {
+            os: manifestPlatform.os,
+            architecture: manifestPlatform.architecture,
+            artifactBaseName: componentDirName,
+            nodeCrtAddonDir
+        };
+    });
+    const componentDir = joinPathFragments(projectConfig.root, 'greengrass', componentDirName);
+    const entrypointDir = joinPathFragments(projectConfig.sourceRoot, 'greengrass', componentDirName);
+    const mainPath = joinPathFragments(entrypointDir, 'main.ts');
+    const mainPathFromProjectRoot = joinPathFragments(toProjectRelativePath(projectConfig, mainPath));
+    const gdkConfigPath = joinPathFragments(componentDir, 'gdk-config.json');
+    const manifestPreview = manifests.map((m)=>`  - Platform:\n      os: ${m.os}\n      architecture: ${m.architecture}\n    Artifacts:\n      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/${m.artifactBaseName}.zip\n        Unarchive: ZIP\n    Lifecycle:\n${// The Setenv block is per-manifest and names this architecture's
+        // vendored addon, so a preview without it is not paste-ready for an
+        // ipc=true component.
+        ipc ? `      Setenv:\n        AWS_CRT_NODEJS_BINARY_RELATIVE_PATH: native/aws-crt/${m.nodeCrtAddonDir}/aws-crt-nodejs.node\n` : ''}      Run: node {artifacts:decompressedPath}/${m.artifactBaseName}/index.js`).join('\n');
+    assertUnchangedPlatform(component, manifestPreview);
+    const templateOptions = {
+        componentName,
+        // Named `version` / `recipeFormat`, not `componentVersion` /
+        // `recipeFormatVersion`: a `*Version` template variable is how a template
+        // names a vended dependency pin (see `VENDED_TEMPLATE_VARS` in
+        // `version-upgrade-migration/real-templates.spec.ts`), which neither a
+        // user-owned option nor a fixed protocol constant is.
+        version: componentVersion,
+        recipeFormat: RECIPE_FORMAT_VERSION,
+        componentDescription: `${componentName} Greengrass component, generated by greengrass#component.`,
+        publisher,
+        ipc,
+        manifests,
+        componentDirName,
+        project: projectConfig.name
+    };
+    // recipe.yaml is user-owned from first generation onward, so `ipc` shapes it
+    // only on the first run: a later run that flips `ipc` to true adds the vendor
+    // target and stages the addon, but leaves the recipe without the `Setenv` that
+    // points aws-crt's loader at it, and the component then fails on the device
+    // with "AWS CRT binary not present". Add that block by hand - the guide's
+    // migration note carries the exact shape.
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'component'), componentDir, templateOptions, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    // main.ts is user-owned from first generation onward. It lives under the
+    // project's own source tree (not beside recipe.yaml, unlike Python components)
+    // so it participates in the project's normal TypeScript compile/lint/test targets.
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'entrypoint'), entrypointDir, templateOptions, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    if (gdkConfig) {
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'gdk'), componentDir, templateOptions, {
+            overwriteStrategy: OverwriteStrategy.Overwrite
+        });
+    } else if (tree.exists(gdkConfigPath)) {
+        tree.delete(gdkConfigPath);
+        logger.info(`Removed ${gdkConfigPath}; pass --gdkConfig to keep it.`);
+    }
+    await sharedGreengrassScriptsGenerator(tree, DEPENDENCIES);
+    if (ipc) {
+        // aws-crt ships an install script that builds its native addon from
+        // source. Recorded as `false`: this component vendors the prebuilt addon at
+        // build time, so the script must not run - and pnpm 11 fails the install
+        // outright with ERR_PNPM_IGNORED_BUILDS unless the decision is explicit.
+        registerPnpmBuiltDependencies(tree, {
+            'aws-crt': false
+        });
+    }
+    if (ipc) {
+        // AFTER sharedGreengrassScriptsGenerator, never before: in a workspace with
+        // no shared scripts project yet, that generator creates one and deletes the
+        // whole `src` tree it scaffolded, which would take this script with it and
+        // leave the `-vendor` target invoking a file that does not exist.
+        //
+        // Vended here rather than by that generator, and only when ipc is true,
+        // because it vends its whole directory into every workspace - putting this
+        // script there would change what an ipc=false run produces. KeepExisting
+        // like every other vended script, so a user's patches survive.
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'scripts'), GREENGRASS_SCRIPTS_DIR, templateOptions, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
+    }
+    const bundleOutputDir = joinPathFragments('greengrass', componentDirName);
+    await addTypeScriptBundleTarget(tree, projectConfig, {
+        targetFilePath: mainPathFromProjectRoot,
+        bundleOutputDir,
+        platform: 'node'
+    }, DEPENDENCIES);
+    const artifactTarget = `${componentDirName}-artifact`;
+    const vendorTarget = `${componentDirName}-vendor`;
+    const distDir = `dist/{projectRoot}/greengrass/${componentDirName}`;
+    const bundleDir = `dist/{projectRoot}/bundle/${bundleOutputDir}`;
+    // Named `stage`, not `vendor`, so it cannot be confused with the
+    // `<dist>/vendor` path build-artifact.ts reads in Python (non-bundle) mode.
+    const stageDir = `${distDir}/stage`;
+    projectConfig.targets ??= {};
+    if (ipc) {
+        projectConfig.targets[vendorTarget] = normalizeTargetKeyOrder({
+            cache: true,
+            inputs: [
+                'production',
+                '^production',
+                `{workspaceRoot}/${GREENGRASS_SCRIPTS_DIR}/**/*`,
+                // The addon bytes come from the installed aws-crt, not from any file
+                // in this project, so without this the target would serve the
+                // previous SDK's addon from cache after a version bump.
+                {
+                    externalDependencies: [
+                        'aws-iot-device-sdk-v2'
+                    ]
+                }
+            ],
+            outputs: [
+                `{workspaceRoot}/${stageDir}`
+            ],
+            executor: 'nx:run-commands',
+            dependsOn: [
+                'bundle'
+            ],
+            options: {
+                command: `tsx ${GREENGRASS_SCRIPTS_DIR}/vendor-crt-addon.ts {projectRoot} ${bundleDir} ${stageDir} ${manifests.map((m)=>m.nodeCrtAddonDir).join(',')}`
+            }
+        });
+    }
+    projectConfig.targets[artifactTarget] = normalizeTargetKeyOrder({
+        cache: true,
+        // The vended scripts live outside this project, so the cache key must
+        // name them explicitly or a refreshed script serves a stale artifact.
+        inputs: [
+            'production',
+            '^production',
+            `{workspaceRoot}/${GREENGRASS_SCRIPTS_DIR}/**/*`
+        ],
+        outputs: [
+            `{workspaceRoot}/${distDir}/greengrass-build`
+        ],
+        executor: 'nx:run-commands',
+        dependsOn: [
+            ipc ? vendorTarget : 'bundle'
+        ],
+        options: {
+            command: `tsx ${GREENGRASS_SCRIPTS_DIR}/build-artifact.ts {projectRoot} ${componentDirName} ${distDir} ${ipc ? stageDir : bundleDir}`
+        }
+    });
+    addArtifactDependencyToTargets(projectConfig, artifactTarget);
+    Object.assign(projectConfig.targets, sharedComponentTargets({
+        artifactTarget,
+        componentDirName,
+        componentName,
+        distDir
+    }));
+    // py#project and ts#project sort targets on every run, including re-runs,
+    // so append in the same order or a later project re-run reorders the file.
+    projectConfig.targets = sortObjectKeys(projectConfig.targets);
+    updateProjectConfiguration(tree, projectConfig.name, projectConfig);
+    return finalizeComponent(tree, component, mainPathFromProjectRoot, DEPENDENCIES);
+};
+export default typescriptGreengrassComponentGenerator;
+
+//# sourceMappingURL=generator.js.map

package/src/greengrass/component/typescript/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/greengrass/component/typescript/generator.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  generateFiles,\n  joinPathFragments,\n  logger,\n  OverwriteStrategy,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { addTypeScriptBundleTarget } from '../../../utils/bundle/bundle.js';\nimport {\n  GREENGRASS_PLATFORM_MAPPINGS,\n  RECIPE_FORMAT_VERSION,\n} from '../../../utils/greengrass/constants.js';\nimport {\n  addArtifactDependencyToTargets,\n  normalizeTargetKeyOrder,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { toProjectRelativePath } from '../../../utils/paths.js';\nimport { registerPnpmBuiltDependencies } from '../../../utils/pnpm-workspace.js';\nimport { sharedGreengrassScriptsGenerator } from '../../../utils/shared-greengrass-scripts.js';\nimport type { NormalizedComponent } from '../common.js';\nimport {\n  assertUnchangedPlatform,\n  finalizeComponent,\n  GREENGRASS_SCRIPTS_DIR,\n  sharedComponentTargets,\n} from '../common.js';\nimport { TYPESCRIPT_DEPENDENCIES as DEPENDENCIES } from '../dependencies.js';\n\n/**\n * Generates an AWS IoT Greengrass v2 component on an existing TypeScript\n * project: a single-file rolldown bundle plus packaging and local-deployment\n * targets (`<c>-artifact`, `<c>-deploy-local`, `<c>-logs`), plus, unless\n * `--infra none`, a `GreengrassComponentVersion` CDK construct (or Terraform\n * module, via the `hashicorp/awscc` provider) that publishes the built\n * artifact.\n */\nexport const typescriptGreengrassComponentGenerator = async (\n  tree: Tree,\n  component: NormalizedComponent,\n): Promise<GeneratorCallback> => {\n  const { project: projectConfig } = component;\n\n  const componentDirName = component.componentDirName;\n  const componentName = component.componentName;\n  const componentVersion = component.componentVersion;\n  const publisher = component.publisher;\n  const ipc = component.ipc;\n  const gdkConfig = component.gdkConfig;\n  const platforms = component.platforms;\n  // A rolldown bundle is pure JavaScript over every architecture, and with\n  // `ipc=true` one zip carries every targeted architecture's own vendored\n  // addon - each manifest's Setenv selects only its own - so, unlike the\n  // Python component, this generator has ONE artifact over N manifests, never\n  // N artifacts.\n  const manifests = platforms.map((p) => {\n    const { manifestPlatform, nodeCrtAddonDir } =\n      GREENGRASS_PLATFORM_MAPPINGS[p];\n    return {\n      os: manifestPlatform.os,\n      architecture: manifestPlatform.architecture,\n      artifactBaseName: componentDirName,\n      nodeCrtAddonDir,\n    };\n  });\n\n  const componentDir = joinPathFragments(\n    projectConfig.root,\n    'greengrass',\n    componentDirName,\n  );\n  const entrypointDir = joinPathFragments(\n    projectConfig.sourceRoot!,\n    'greengrass',\n    componentDirName,\n  );\n  const mainPath = joinPathFragments(entrypointDir, 'main.ts');\n  const mainPathFromProjectRoot = joinPathFragments(\n    toProjectRelativePath(projectConfig, mainPath),\n  );\n  const gdkConfigPath = joinPathFragments(componentDir, 'gdk-config.json');\n\n  const manifestPreview = manifests\n    .map(\n      (m) =>\n        `  - Platform:\\n      os: ${m.os}\\n      architecture: ${m.architecture}\\n    Artifacts:\\n      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/${m.artifactBaseName}.zip\\n        Unarchive: ZIP\\n    Lifecycle:\\n${\n          // The Setenv block is per-manifest and names this architecture's\n          // vendored addon, so a preview without it is not paste-ready for an\n          // ipc=true component.\n          ipc\n            ? `      Setenv:\\n        AWS_CRT_NODEJS_BINARY_RELATIVE_PATH: native/aws-crt/${m.nodeCrtAddonDir}/aws-crt-nodejs.node\\n`\n            : ''\n        }      Run: node {artifacts:decompressedPath}/${m.artifactBaseName}/index.js`,\n    )\n    .join('\\n');\n  assertUnchangedPlatform(component, manifestPreview);\n\n  const templateOptions = {\n    componentName,\n    // Named `version` / `recipeFormat`, not `componentVersion` /\n    // `recipeFormatVersion`: a `*Version` template variable is how a template\n    // names a vended dependency pin (see `VENDED_TEMPLATE_VARS` in\n    // `version-upgrade-migration/real-templates.spec.ts`), which neither a\n    // user-owned option nor a fixed protocol constant is.\n    version: componentVersion,\n    recipeFormat: RECIPE_FORMAT_VERSION,\n    componentDescription: `${componentName} Greengrass component, generated by greengrass#component.`,\n    publisher,\n    ipc,\n    manifests,\n    componentDirName,\n    project: projectConfig.name,\n  };\n\n  // recipe.yaml is user-owned from first generation onward, so `ipc` shapes it\n  // only on the first run: a later run that flips `ipc` to true adds the vendor\n  // target and stages the addon, but leaves the recipe without the `Setenv` that\n  // points aws-crt's loader at it, and the component then fails on the device\n  // with \"AWS CRT binary not present\". Add that block by hand - the guide's\n  // migration note carries the exact shape.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'component'),\n    componentDir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // main.ts is user-owned from first generation onward. It lives under the\n  // project's own source tree (not beside recipe.yaml, unlike Python components)\n  // so it participates in the project's normal TypeScript compile/lint/test targets.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'entrypoint'),\n    entrypointDir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  if (gdkConfig) {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'gdk'),\n      componentDir,\n      templateOptions,\n      { overwriteStrategy: OverwriteStrategy.Overwrite },\n    );\n  } else if (tree.exists(gdkConfigPath)) {\n    tree.delete(gdkConfigPath);\n    logger.info(`Removed ${gdkConfigPath}; pass --gdkConfig to keep it.`);\n  }\n\n  await sharedGreengrassScriptsGenerator(tree, DEPENDENCIES);\n\n  if (ipc) {\n    // aws-crt ships an install script that builds its native addon from\n    // source. Recorded as `false`: this component vendors the prebuilt addon at\n    // build time, so the script must not run - and pnpm 11 fails the install\n    // outright with ERR_PNPM_IGNORED_BUILDS unless the decision is explicit.\n    registerPnpmBuiltDependencies(tree, { 'aws-crt': false });\n  }\n\n  if (ipc) {\n    // AFTER sharedGreengrassScriptsGenerator, never before: in a workspace with\n    // no shared scripts project yet, that generator creates one and deletes the\n    // whole `src` tree it scaffolded, which would take this script with it and\n    // leave the `-vendor` target invoking a file that does not exist.\n    //\n    // Vended here rather than by that generator, and only when ipc is true,\n    // because it vends its whole directory into every workspace - putting this\n    // script there would change what an ipc=false run produces. KeepExisting\n    // like every other vended script, so a user's patches survive.\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'scripts'),\n      GREENGRASS_SCRIPTS_DIR,\n      templateOptions,\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  const bundleOutputDir = joinPathFragments('greengrass', componentDirName);\n  await addTypeScriptBundleTarget(\n    tree,\n    projectConfig,\n    {\n      targetFilePath: mainPathFromProjectRoot,\n      bundleOutputDir,\n      platform: 'node',\n    },\n    DEPENDENCIES,\n  );\n\n  const artifactTarget = `${componentDirName}-artifact`;\n  const vendorTarget = `${componentDirName}-vendor`;\n  const distDir = `dist/{projectRoot}/greengrass/${componentDirName}`;\n  const bundleDir = `dist/{projectRoot}/bundle/${bundleOutputDir}`;\n  // Named `stage`, not `vendor`, so it cannot be confused with the\n  // `<dist>/vendor` path build-artifact.ts reads in Python (non-bundle) mode.\n  const stageDir = `${distDir}/stage`;\n\n  projectConfig.targets ??= {};\n\n  if (ipc) {\n    projectConfig.targets[vendorTarget] = normalizeTargetKeyOrder({\n      cache: true,\n      inputs: [\n        'production',\n        '^production',\n        `{workspaceRoot}/${GREENGRASS_SCRIPTS_DIR}/**/*`,\n        // The addon bytes come from the installed aws-crt, not from any file\n        // in this project, so without this the target would serve the\n        // previous SDK's addon from cache after a version bump.\n        { externalDependencies: ['aws-iot-device-sdk-v2'] },\n      ],\n      outputs: [`{workspaceRoot}/${stageDir}`],\n      executor: 'nx:run-commands',\n      dependsOn: ['bundle'],\n      options: {\n        command: `tsx ${GREENGRASS_SCRIPTS_DIR}/vendor-crt-addon.ts {projectRoot} ${bundleDir} ${stageDir} ${manifests\n          .map((m) => m.nodeCrtAddonDir)\n          .join(',')}`,\n      },\n    });\n  }\n\n  projectConfig.targets[artifactTarget] = normalizeTargetKeyOrder({\n    cache: true,\n    // The vended scripts live outside this project, so the cache key must\n    // name them explicitly or a refreshed script serves a stale artifact.\n    inputs: [\n      'production',\n      '^production',\n      `{workspaceRoot}/${GREENGRASS_SCRIPTS_DIR}/**/*`,\n    ],\n    outputs: [`{workspaceRoot}/${distDir}/greengrass-build`],\n    executor: 'nx:run-commands',\n    dependsOn: [ipc ? vendorTarget : 'bundle'],\n    options: {\n      command: `tsx ${GREENGRASS_SCRIPTS_DIR}/build-artifact.ts {projectRoot} ${componentDirName} ${distDir} ${ipc ? stageDir : bundleDir}`,\n    },\n  });\n  addArtifactDependencyToTargets(projectConfig, artifactTarget);\n\n  Object.assign(\n    projectConfig.targets,\n    sharedComponentTargets({\n      artifactTarget,\n      componentDirName,\n      componentName,\n      distDir,\n    }),\n  );\n\n  // py#project and ts#project sort targets on every run, including re-runs,\n  // so append in the same order or a later project re-run reorders the file.\n  projectConfig.targets = sortObjectKeys(projectConfig.targets);\n  updateProjectConfiguration(tree, projectConfig.name, projectConfig);\n\n  return finalizeComponent(\n    tree,\n    component,\n    mainPathFromProjectRoot,\n    DEPENDENCIES,\n  );\n};\n\nexport default typescriptGreengrassComponentGenerator;\n"],"names":["generateFiles","joinPathFragments","logger","OverwriteStrategy","updateProjectConfiguration","addTypeScriptBundleTarget","GREENGRASS_PLATFORM_MAPPINGS","RECIPE_FORMAT_VERSION","addArtifactDependencyToTargets","normalizeTargetKeyOrder","sortObjectKeys","toProjectRelativePath","registerPnpmBuiltDependencies","sharedGreengrassScriptsGenerator","assertUnchangedPlatform","finalizeComponent","GREENGRASS_SCRIPTS_DIR","sharedComponentTargets","TYPESCRIPT_DEPENDENCIES","DEPENDENCIES","typescriptGreengrassComponentGenerator","tree","component","project","projectConfig","componentDirName","componentName","componentVersion","publisher","ipc","gdkConfig","platforms","manifests","map","p","manifestPlatform","nodeCrtAddonDir","os","architecture","artifactBaseName","componentDir","root","entrypointDir","sourceRoot","mainPath","mainPathFromProjectRoot","gdkConfigPath","manifestPreview","m","join","templateOptions","version","recipeFormat","componentDescription","name","dirname","overwriteStrategy","KeepExisting","Overwrite","exists","delete","info","bundleOutputDir","targetFilePath","platform","artifactTarget","vendorTarget","distDir","bundleDir","stageDir","targets","cache","inputs","externalDependencies","outputs","executor","dependsOn","options","command","Object","assign"],"mappings":"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"}

package/src/infra/app/generator.d.ts

@@ -47,7 +47,7 @@ export declare const DEPENDENCIES: import("../../utils/declared-dependencies.js"
     readonly when: (m: import("../../utils/shared-constructs-constants.js").IacMetadata) => boolean;
 } & {
     versionOnly: true;
-}], readonly import("../../utils/declared-dependencies.js").DeclaredPyDependency<"ruff" | "a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "mcp" | "pip-check-updates" | "pip-licenses" | "pydantic" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", Record<string, never>>[]>;
+}], readonly import("../../utils/declared-dependencies.js").DeclaredPyDependency<"ruff" | "a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "awsiotsdk" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "mcp" | "pip-check-updates" | "pip-licenses" | "pydantic" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", Record<string, never>>[]>;
 export declare const INFRA_APP_GENERATOR_INFO: NxGeneratorInfo;
 export declare function tsInfraGenerator(tree: Tree, schema: TsInfraGeneratorSchema): Promise<GeneratorCallback>;
 export default tsInfraGenerator;

package/src/init/generator.d.ts

@@ -17,7 +17,7 @@ export declare const DEPENDENCIES: import("../utils/declared-dependencies.js").D
     readonly name: "typescript";
 }, {
     readonly name: "@biomejs/biome";
-}], readonly import("../utils/declared-dependencies.js").DeclaredPyDependency<"ruff" | "a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "mcp" | "pip-check-updates" | "pip-licenses" | "pydantic" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", Record<string, never>>[]>;
+}], readonly import("../utils/declared-dependencies.js").DeclaredPyDependency<"ruff" | "a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "awsiotsdk" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "mcp" | "pip-check-updates" | "pip-licenses" | "pydantic" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", Record<string, never>>[]>;
 export declare const INIT_GENERATOR_INFO: NxGeneratorInfo;
 /**
  * Configure an existing Nx workspace to use the @aws/nx-plugin.

package/src/internal/test-matrix/generator.js

@@ -4,6 +4,7 @@
  */ import { agentcoreGatewayGenerator } from "../../sdk/agentcore-gateway.js";
 import { agentcoreHarnessGenerator } from "../../sdk/agentcore-harness.js";
 import { connectionGenerator } from "../../sdk/connection.js";
+import { greengrassComponentGenerator } from "../../sdk/greengrass.js";
 import { licenseGenerator } from "../../sdk/license.js";
 import { pyAgentGenerator, pyApiGenerator, pyDynamoDBGenerator, pyLambdaFunctionGenerator, pyMcpServerGenerator, pyProjectGenerator, pyRdbGenerator } from "../../sdk/py.js";
 import { smithyProjectGenerator } from "../../sdk/smithy.js";
@@ -216,6 +217,47 @@ import { getNpmScope, getNpmScopePrefix } from "../../utils/npm-scope.js";
         iac: 'inherit',
         ...defaults
     });
+    // Greengrass: the `AWS::GreengrassV2` resources exist in the
+    // `hashicorp/awscc` Terraform provider (this workspace pins it), so both
+    // `--iac cdk` and `--iac terraform` are exercised here via `iac: 'inherit'`.
+    //
+    // A component with publication infrastructure and an app wrapper in the
+    // workspace's infrastructure project. Hosted on a dedicated project:
+    // vendoring's `--only-binary :all:` refuses the source-built workspace
+    // members other entries add to py-project, and one component per project is
+    // the documented production default.
+    await pyProjectGenerator(tree, {
+        name: 'py-greengrass-project',
+        type: 'application',
+        ...projectDefaults
+    });
+    await greengrassComponentGenerator(tree, {
+        project: py('py-greengrass-project'),
+        name: 'my-greengrass-component',
+        language: 'python',
+        platform: 'linux-amd64-arm64',
+        gdkConfig: true,
+        iac: 'inherit',
+        ...defaults
+    });
+    // The TypeScript component gets a dedicated host project for the same
+    // reason: the shared `bundle` target this generator wires rebuilds every
+    // bundled entrypoint in its project together, so hosting it alongside
+    // `ts-project`'s Lambda function would couple this device-oriented
+    // bundle's cache invalidation to an unrelated Lambda bundle's.
+    await tsProjectGenerator(tree, {
+        name: 'ts-greengrass-project',
+        ...projectDefaults
+    });
+    await greengrassComponentGenerator(tree, {
+        project: 'ts-greengrass-project',
+        name: 'my-ts-greengrass-component',
+        language: 'typescript',
+        ipc: true,
+        componentVersion: '1.0.0',
+        iac: 'inherit',
+        ...defaults
+    });
     // MCP servers — uninfra'd and hosted on AgentCore.
     await pyMcpServerGenerator(tree, {
         project: 'py_project',