@aws/nx-plugin 1.1.1 → 1.3.0

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

@@ -0,0 +1,192 @@
+/**
+ * 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 { FsCommands } from "../../../utils/fs.js";
+import { GREENGRASS_PLATFORM_MAPPINGS, RECIPE_FORMAT_VERSION } from "../../../utils/greengrass/constants.js";
+import { toSnakeCase } from "../../../utils/names.js";
+import { addArtifactDependencyToTargets, normalizeTargetKeyOrder } from "../../../utils/nx.js";
+import { sortObjectKeys } from "../../../utils/object.js";
+import { toProjectRelativePath } from "../../../utils/paths.js";
+import { sharedGreengrassScriptsGenerator } from "../../../utils/shared-greengrass-scripts.js";
+import { tryReadToml } from "../../../utils/toml.js";
+import { LAMBDA_RUNTIME_VERSIONS } from "../../../utils/versions.js";
+import { assertUnchangedPlatform, finalizeComponent, GREENGRASS_SCRIPTS_DIR, sharedComponentTargets } from "../common.js";
+import { PY_DEPENDENCIES as DEPENDENCIES } from "../dependencies.js";
+/**
+ * The lowest Python `major.minor` declared by `[project].requires-python`
+ * (eg "3.14" from ">=3.14"), so vendoring targets the device's own floor
+ * rather than the Lambda runtime `addPythonBundleTarget` pins. Falls back to
+ * the plugin's Lambda Python floor only when the project declares none.
+ */ const pythonVersionFloor = (requiresPython)=>{
+    if (typeof requiresPython === 'string') {
+        let min;
+        for (const match of requiresPython.matchAll(/(\d+)\.(\d+)/g)){
+            const major = Number(match[1]);
+            const minor = Number(match[2]);
+            if (!min || major < min.major || major === min.major && minor < min.minor) {
+                min = {
+                    major,
+                    minor
+                };
+            }
+        }
+        if (min) {
+            return `${min.major}.${min.minor}`;
+        }
+    }
+    return LAMBDA_RUNTIME_VERSIONS.python;
+};
+/**
+ * Generates an AWS IoT Greengrass v2 component on an existing Python project:
+ * packaging and local-deployment targets (`<c>-vendor`, `<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 pythonGreengrassComponentGenerator = async (tree, component)=>{
+    const { project: projectConfig, options } = component;
+    const componentDirName = component.componentDirName;
+    const componentSnakeCase = toSnakeCase(options.name);
+    const componentName = component.componentName;
+    const componentVersion = component.componentVersion;
+    const publisher = component.publisher;
+    const ipc = component.ipc;
+    const gdkConfig = component.gdkConfig;
+    const platforms = component.platforms;
+    const isMultiPlatform = platforms.length > 1;
+    const distDir = `dist/{projectRoot}/greengrass/${componentDirName}`;
+    const distDirVendor = `${distDir}/vendor`;
+    // One entry per recipe manifest. Every per-architecture name - the vendor
+    // subdirectory, the zip base name and the manifest `architecture` value -
+    // is derived from the SAME mapping entry, so they cannot drift apart.
+    const manifests = platforms.map((p)=>{
+        const { uvPlatform, manifestPlatform } = GREENGRASS_PLATFORM_MAPPINGS[p];
+        return {
+            uvPlatform,
+            os: manifestPlatform.os,
+            architecture: manifestPlatform.architecture,
+            // Single-platform names stay flat: `<c>.zip` and `vendor/`.
+            artifactBaseName: isMultiPlatform ? `${componentDirName}-${manifestPlatform.architecture}` : componentDirName,
+            vendorDir: isMultiPlatform ? `${distDirVendor}/${manifestPlatform.architecture}` : distDirVendor
+        };
+    });
+    const pyProjectPath = joinPathFragments(projectConfig.root, 'pyproject.toml');
+    const pyproject = tryReadToml(tree, pyProjectPath);
+    const pythonFloor = pythonVersionFloor(pyproject?.project?.['requires-python']);
+    const componentDir = joinPathFragments(projectConfig.root, 'greengrass', componentDirName);
+    const mainPath = joinPathFragments(componentDir, 'main.py');
+    const gdkConfigPath = joinPathFragments(componentDir, 'gdk-config.json');
+    // Flat under tests/greengrass/, one file per component: pytest imports a test
+    // module by basename, so two components sharing a `test_main.py` basename in
+    // sibling directories would collide.
+    const testDir = joinPathFragments(projectConfig.root, 'tests', 'greengrass');
+    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      Run: python${pythonFloor} {artifacts:decompressedPath}/${m.artifactBaseName}/main.py`).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 using Python ${pythonFloor}, generated by greengrass#component.`,
+        publisher,
+        ipc,
+        manifests,
+        // The recipe Run command pins the same interpreter the wheels were
+        // vendored for; a bare `python3` can resolve to an older device default
+        // whose ABI the vendored native wheels do not support.
+        pythonFloor,
+        componentDirName,
+        componentSnakeCase,
+        project: projectConfig.name
+    };
+    // recipe.yaml and main.py are user-owned from first generation onward.
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'component'), componentDir, 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.`);
+    }
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'tests'), testDir, templateOptions, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    await sharedGreengrassScriptsGenerator(tree, DEPENDENCIES);
+    const vendorTarget = `${componentDirName}-vendor`;
+    const artifactTarget = `${componentDirName}-artifact`;
+    projectConfig.targets ??= {};
+    const fs = new FsCommands(tree, DEPENDENCIES);
+    projectConfig.targets[vendorTarget] = normalizeTargetKeyOrder({
+        cache: true,
+        // The vendor dir holds only exported dependencies, never test files.
+        inputs: [
+            'production',
+            '^production'
+        ],
+        outputs: [
+            `{workspaceRoot}/${distDirVendor}`
+        ],
+        executor: 'nx:run-commands',
+        dependsOn: [
+            'compile'
+        ],
+        options: {
+            commands: [
+                // `uv pip install --target` adds to whatever is already there and
+                // never prunes, so without this a dropped dependency - or the other
+                // platform's `vendor/<architecture>` directory after a deliberate
+                // platform change - would still be packaged into the next artifact.
+                // Artifact bytes must depend only on the current source.
+                fs.rm(distDirVendor),
+                fs.mkdir(distDirVendor),
+                `uv export --frozen --no-dev --no-editable --no-emit-project --project {projectRoot} --package ${projectConfig.name} -o ${distDirVendor}/requirements.txt`,
+                // `--only-binary :all:` is required: without it an sdist can build a
+                // host-architecture binary into a cross-architecture artifact.
+                ...manifests.map((m)=>`uv pip install -n --no-deps --no-installer-metadata --no-compile-bytecode --only-binary :all: --python-platform ${m.uvPlatform} --python-version ${pythonFloor} --target ${m.vendorDir} -r ${distDirVendor}/requirements.txt`)
+            ],
+            parallel: false
+        }
+    });
+    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: [
+            vendorTarget
+        ],
+        options: {
+            command: `tsx ${GREENGRASS_SCRIPTS_DIR}/build-artifact.ts {projectRoot} ${componentDirName} ${distDir}${isMultiPlatform ? ` --platforms=${manifests.map((m)=>m.architecture).join(',')}` : ''}`
+        }
+    });
+    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, joinPathFragments(toProjectRelativePath(projectConfig, mainPath)), DEPENDENCIES);
+};
+export default pythonGreengrassComponentGenerator;
+
+//# sourceMappingURL=generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/greengrass/component/python/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 { FsCommands } from '../../../utils/fs.js';\nimport {\n  GREENGRASS_PLATFORM_MAPPINGS,\n  RECIPE_FORMAT_VERSION,\n} from '../../../utils/greengrass/constants.js';\nimport { toSnakeCase } from '../../../utils/names.js';\nimport {\n  addArtifactDependencyToTargets,\n  normalizeTargetKeyOrder,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { toProjectRelativePath } from '../../../utils/paths.js';\nimport { sharedGreengrassScriptsGenerator } from '../../../utils/shared-greengrass-scripts.js';\nimport { tryReadToml } from '../../../utils/toml.js';\nimport { LAMBDA_RUNTIME_VERSIONS } from '../../../utils/versions.js';\nimport type { NormalizedComponent } from '../common.js';\nimport {\n  assertUnchangedPlatform,\n  finalizeComponent,\n  GREENGRASS_SCRIPTS_DIR,\n  sharedComponentTargets,\n} from '../common.js';\nimport { PY_DEPENDENCIES as DEPENDENCIES } from '../dependencies.js';\n\n/**\n * The lowest Python `major.minor` declared by `[project].requires-python`\n * (eg \"3.14\" from \">=3.14\"), so vendoring targets the device's own floor\n * rather than the Lambda runtime `addPythonBundleTarget` pins. Falls back to\n * the plugin's Lambda Python floor only when the project declares none.\n */\nconst pythonVersionFloor = (requiresPython: unknown): string => {\n  if (typeof requiresPython === 'string') {\n    let min: { major: number; minor: number } | undefined;\n    for (const match of requiresPython.matchAll(/(\\d+)\\.(\\d+)/g)) {\n      const major = Number(match[1]);\n      const minor = Number(match[2]);\n      if (\n        !min ||\n        major < min.major ||\n        (major === min.major && minor < min.minor)\n      ) {\n        min = { major, minor };\n      }\n    }\n    if (min) {\n      return `${min.major}.${min.minor}`;\n    }\n  }\n  return LAMBDA_RUNTIME_VERSIONS.python;\n};\n\n/**\n * Generates an AWS IoT Greengrass v2 component on an existing Python project:\n * packaging and local-deployment targets (`<c>-vendor`, `<c>-artifact`,\n * `<c>-deploy-local`, `<c>-logs`), plus, unless `--infra none`, a\n * `GreengrassComponentVersion` CDK construct (or Terraform module, via the\n * `hashicorp/awscc` provider) that publishes the built artifact.\n */\nexport const pythonGreengrassComponentGenerator = async (\n  tree: Tree,\n  component: NormalizedComponent,\n): Promise<GeneratorCallback> => {\n  const { project: projectConfig, options } = component;\n\n  const componentDirName = component.componentDirName;\n  const componentSnakeCase = toSnakeCase(options.name);\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  const isMultiPlatform = platforms.length > 1;\n  const distDir = `dist/{projectRoot}/greengrass/${componentDirName}`;\n  const distDirVendor = `${distDir}/vendor`;\n  // One entry per recipe manifest. Every per-architecture name - the vendor\n  // subdirectory, the zip base name and the manifest `architecture` value -\n  // is derived from the SAME mapping entry, so they cannot drift apart.\n  const manifests = platforms.map((p) => {\n    const { uvPlatform, manifestPlatform } = GREENGRASS_PLATFORM_MAPPINGS[p];\n    return {\n      uvPlatform,\n      os: manifestPlatform.os,\n      architecture: manifestPlatform.architecture,\n      // Single-platform names stay flat: `<c>.zip` and `vendor/`.\n      artifactBaseName: isMultiPlatform\n        ? `${componentDirName}-${manifestPlatform.architecture}`\n        : componentDirName,\n      vendorDir: isMultiPlatform\n        ? `${distDirVendor}/${manifestPlatform.architecture}`\n        : distDirVendor,\n    };\n  });\n\n  const pyProjectPath = joinPathFragments(projectConfig.root, 'pyproject.toml');\n  const pyproject = tryReadToml(tree, pyProjectPath) as unknown as\n    | { project?: { 'requires-python'?: unknown } }\n    | undefined;\n  const pythonFloor = pythonVersionFloor(\n    pyproject?.project?.['requires-python'],\n  );\n\n  const componentDir = joinPathFragments(\n    projectConfig.root,\n    'greengrass',\n    componentDirName,\n  );\n  const mainPath = joinPathFragments(componentDir, 'main.py');\n  const gdkConfigPath = joinPathFragments(componentDir, 'gdk-config.json');\n  // Flat under tests/greengrass/, one file per component: pytest imports a test\n  // module by basename, so two components sharing a `test_main.py` basename in\n  // sibling directories would collide.\n  const testDir = joinPathFragments(projectConfig.root, 'tests', 'greengrass');\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      Run: python${pythonFloor} {artifacts:decompressedPath}/${m.artifactBaseName}/main.py`,\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 using Python ${pythonFloor}, generated by greengrass#component.`,\n    publisher,\n    ipc,\n    manifests,\n    // The recipe Run command pins the same interpreter the wheels were\n    // vendored for; a bare `python3` can resolve to an older device default\n    // whose ABI the vendored native wheels do not support.\n    pythonFloor,\n    componentDirName,\n    componentSnakeCase,\n    project: projectConfig.name,\n  };\n\n  // recipe.yaml and main.py are user-owned from first generation onward.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'component'),\n    componentDir,\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  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'tests'),\n    testDir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  await sharedGreengrassScriptsGenerator(tree, DEPENDENCIES);\n\n  const vendorTarget = `${componentDirName}-vendor`;\n  const artifactTarget = `${componentDirName}-artifact`;\n\n  projectConfig.targets ??= {};\n\n  const fs = new FsCommands(tree, DEPENDENCIES);\n\n  projectConfig.targets[vendorTarget] = normalizeTargetKeyOrder({\n    cache: true,\n    // The vendor dir holds only exported dependencies, never test files.\n    inputs: ['production', '^production'],\n    outputs: [`{workspaceRoot}/${distDirVendor}`],\n    executor: 'nx:run-commands',\n    dependsOn: ['compile'],\n    options: {\n      commands: [\n        // `uv pip install --target` adds to whatever is already there and\n        // never prunes, so without this a dropped dependency - or the other\n        // platform's `vendor/<architecture>` directory after a deliberate\n        // platform change - would still be packaged into the next artifact.\n        // Artifact bytes must depend only on the current source.\n        fs.rm(distDirVendor),\n        fs.mkdir(distDirVendor),\n        `uv export --frozen --no-dev --no-editable --no-emit-project --project {projectRoot} --package ${projectConfig.name} -o ${distDirVendor}/requirements.txt`,\n        // `--only-binary :all:` is required: without it an sdist can build a\n        // host-architecture binary into a cross-architecture artifact.\n        ...manifests.map(\n          (m) =>\n            `uv pip install -n --no-deps --no-installer-metadata --no-compile-bytecode --only-binary :all: --python-platform ${m.uvPlatform} --python-version ${pythonFloor} --target ${m.vendorDir} -r ${distDirVendor}/requirements.txt`,\n        ),\n      ],\n      parallel: false,\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: [vendorTarget],\n    options: {\n      command: `tsx ${GREENGRASS_SCRIPTS_DIR}/build-artifact.ts {projectRoot} ${componentDirName} ${distDir}${\n        isMultiPlatform\n          ? ` --platforms=${manifests.map((m) => m.architecture).join(',')}`\n          : ''\n      }`,\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    joinPathFragments(toProjectRelativePath(projectConfig, mainPath)),\n    DEPENDENCIES,\n  );\n};\n\nexport default pythonGreengrassComponentGenerator;\n"],"names":["generateFiles","joinPathFragments","logger","OverwriteStrategy","updateProjectConfiguration","FsCommands","GREENGRASS_PLATFORM_MAPPINGS","RECIPE_FORMAT_VERSION","toSnakeCase","addArtifactDependencyToTargets","normalizeTargetKeyOrder","sortObjectKeys","toProjectRelativePath","sharedGreengrassScriptsGenerator","tryReadToml","LAMBDA_RUNTIME_VERSIONS","assertUnchangedPlatform","finalizeComponent","GREENGRASS_SCRIPTS_DIR","sharedComponentTargets","PY_DEPENDENCIES","DEPENDENCIES","pythonVersionFloor","requiresPython","min","match","matchAll","major","Number","minor","python","pythonGreengrassComponentGenerator","tree","component","project","projectConfig","options","componentDirName","componentSnakeCase","name","componentName","componentVersion","publisher","ipc","gdkConfig","platforms","isMultiPlatform","length","distDir","distDirVendor","manifests","map","p","uvPlatform","manifestPlatform","os","architecture","artifactBaseName","vendorDir","pyProjectPath","root","pyproject","pythonFloor","componentDir","mainPath","gdkConfigPath","testDir","manifestPreview","m","join","templateOptions","version","recipeFormat","componentDescription","dirname","overwriteStrategy","KeepExisting","Overwrite","exists","delete","info","vendorTarget","artifactTarget","targets","fs","cache","inputs","outputs","executor","dependsOn","commands","rm","mkdir","parallel","command","Object","assign"],"mappings":"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"}

package/src/greengrass/component/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/greengrass/component/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/greengrass/component/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nexport interface GreengrassComponentGeneratorSchema {\n  project: string;\n  name: string;\n  language?: 'typescript' | 'python';\n  componentName?: string;\n  componentVersion?: string;\n  publisher?: string;\n  ipc?: boolean;\n  gdkConfig?: boolean;\n  platform?: 'linux-amd64' | 'linux-arm64' | 'linux-amd64-arm64';\n  infra?: 'component-version' | 'none';\n  iac?: 'inherit' | 'cdk' | 'terraform';\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GACD,WAaC"}

package/src/greengrass/component/schema.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface GreengrassComponentGeneratorSchema {
+  project: string;
+  name: string;
+  language?: 'typescript' | 'python';
+  componentName?: string;
+  componentVersion?: string;
+  publisher?: string;
+  ipc?: boolean;
+  gdkConfig?: boolean;
+  platform?: 'linux-amd64' | 'linux-arm64' | 'linux-amd64-arm64';
+  infra?: 'component-version' | 'none';
+  iac?: 'inherit' | 'cdk' | 'terraform';
+  preferInstallDependencies?: boolean;
+}

package/src/greengrass/component/schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "greengrass#component",
+  "title": "greengrass#component",
+  "x-label": "Greengrass Component",
+  "description": "Add an AWS IoT Greengrass component to an existing Python or TypeScript project. Language is inferred from the selected project's marker when unambiguous.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The existing Python or TypeScript host project",
+      "x-prompt": "Select the project to add the Greengrass component to",
+      "x-dropdown": "projects"
+    },
+    "name": {
+      "type": "string",
+      "description": "The component name",
+      "x-priority": "important",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like for the Greengrass component?"
+    },
+    "language": {
+      "type": "string",
+      "enum": ["typescript", "python"],
+      "description": "The component language. Omit it only when the host has exactly one supported language marker."
+    },
+    "componentName": {
+      "type": "string",
+      "description": "The recipe ComponentName. Defaults to a reversed-domain name derived from the workspace npm scope and component name."
+    },
+    "componentVersion": {
+      "type": "string",
+      "default": "1.0.0",
+      "description": "The recipe ComponentVersion. CDK resolves NEXT_* at deploy time; Terraform requires an explicit semantic version. With infra=none, NEXT_* is written unchanged."
+    },
+    "publisher": {
+      "type": "string",
+      "description": "The recipe ComponentPublisher. Defaults to the workspace npm scope."
+    },
+    "ipc": {
+      "type": "boolean",
+      "default": false,
+      "description": "Whether to wire the Greengrass IPC client. Defaults to false for both languages."
+    },
+    "gdkConfig": {
+      "type": "boolean",
+      "default": false,
+      "description": "Vend gdk-config.json for using the GDK CLI by hand. GDK supports NEXT_PATCH, not NEXT_MINOR or NEXT_MAJOR.",
+      "x-priority": "low"
+    },
+    "platform": {
+      "type": "string",
+      "enum": ["linux-amd64", "linux-arm64", "linux-amd64-arm64"],
+      "default": "linux-arm64",
+      "description": "The core device platform or platforms.",
+      "x-priority": "important",
+      "x-prompt": "Which core device platform(s) would you like to target?"
+    },
+    "infra": {
+      "type": "string",
+      "enum": ["component-version", "none"],
+      "default": "component-version",
+      "description": "component-version vends reusable Greengrass component infrastructure; none supports local development only.",
+      "x-priority": "important",
+      "x-prompt": "Which infrastructure would you like to provision?"
+    },
+    "iac": {
+      "type": "string",
+      "enum": ["inherit", "cdk", "terraform"],
+      "default": "inherit",
+      "description": "The IaC provider, resolved only when infrastructure is requested.",
+      "x-priority": "important",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether to prefer installing dependencies after the generator runs."
+    }
+  },
+  "required": ["project", "name"]
+}

package/src/greengrass/component/typescript/__snapshots__/generator.spec.ts.snap

@@ -0,0 +1,275 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`greengrass#component generator (typescript) > multi-architecture (platform: linux-amd64-arm64) > should match snapshot for a multi-architecture component > multi-arch-snapshot 1`] = `
+{
+  "packages/test-project/greengrass/my-component/recipe.yaml": "RecipeFormatVersion: '2020-01-25'
+ComponentName: com.proj.MyComponent
+ComponentVersion: 1.0.0
+ComponentDescription: com.proj.MyComponent Greengrass component, generated by greengrass#component.
+ComponentPublisher: proj
+Manifests:
+  - Platform:
+      os: linux
+      architecture: amd64
+    Artifacts:
+      # Placeholders are substituted at publish time. The basename must stay
+      # my-component.zip, which is what the Run script below unarchives to.
+      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/my-component.zip
+        Unarchive: ZIP
+    Lifecycle:
+      # Requires a node binary on the device's PATH. The generated bundle was
+      # tested with Node.js 22; Greengrass uses the installed runtime.
+      Run: node {artifacts:decompressedPath}/my-component/index.js
+  - Platform:
+      os: linux
+      architecture: aarch64
+    Artifacts:
+      # Placeholders are substituted at publish time. The basename must stay
+      # my-component.zip, which is what the Run script below unarchives to.
+      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/my-component.zip
+        Unarchive: ZIP
+    Lifecycle:
+      # Requires a node binary on the device's PATH. The generated bundle was
+      # tested with Node.js 22; Greengrass uses the installed runtime.
+      Run: node {artifacts:decompressedPath}/my-component/index.js
+",
+  "packages/test-project/project.json": "{
+  "name": "test-project",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/test-project/src",
+  "metadata": {
+    "components": [
+      {
+        "generator": "greengrass#component",
+        "path": "src/greengrass/my-component/main.ts",
+        "name": "my-component",
+        "language": "typescript",
+        "componentName": "com.proj.MyComponent",
+        "componentVersion": "1.0.0",
+        "platform": "linux-amd64-arm64",
+        "ipc": false,
+        "gdkConfig": false
+      }
+    ]
+  },
+  "targets": {
+    "assemble": {
+      "dependsOn": ["bundle", "my-component-artifact"]
+    },
+    "build": {
+      "dependsOn": ["bundle", "my-component-artifact"]
+    },
+    "bundle": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["compile"],
+      "cache": true,
+      "inputs": ["default"],
+      "outputs": ["{workspaceRoot}/dist/{projectRoot}/bundle"],
+      "options": {
+        "command": "rolldown -c rolldown.config.ts",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "compile": {
+      "executor": "@nx/js:tsc"
+    },
+    "my-component-artifact": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["bundle"],
+      "cache": true,
+      "inputs": [
+        "production",
+        "^production",
+        "{workspaceRoot}/packages/common/scripts/src/greengrass/**/*"
+      ],
+      "outputs": [
+        "{workspaceRoot}/dist/{projectRoot}/greengrass/my-component/greengrass-build"
+      ],
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/build-artifact.ts {projectRoot} my-component dist/{projectRoot}/greengrass/my-component dist/{projectRoot}/bundle/greengrass/my-component"
+      }
+    },
+    "my-component-deploy-local": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["my-component-artifact"],
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/deploy-local.ts dist/{projectRoot}/greengrass/my-component"
+      }
+    },
+    "my-component-logs": {
+      "executor": "nx:run-commands",
+      "continuous": true,
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/component-logs.ts com.proj.MyComponent"
+      }
+    }
+  }
+}
+",
+  "packages/test-project/rolldown.config.ts": "import { defineConfig } from 'rolldown';
+
+export default defineConfig([
+  {
+    tsconfig: 'tsconfig.lib.json',
+    input: 'src/greengrass/my-component/main.ts',
+    output: {
+      file: '../../dist/packages/test-project/bundle/greengrass/my-component/index.js',
+      format: 'cjs',
+      codeSplitting: false,
+    },
+    platform: 'node',
+  },
+]);
+",
+  "packages/test-project/src/greengrass/my-component/main.ts": "const RUN_INTERVAL_MS = 30_000;
+
+export function runOnce(sequence: number): void {
+  console.log(
+    \`[com.proj.MyComponent] 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();
+",
+}
+`;
+
+exports[`greengrass#component generator (typescript) > should match snapshot > main-snapshot 1`] = `
+{
+  "packages/test-project/greengrass/my-component/recipe.yaml": "RecipeFormatVersion: '2020-01-25'
+ComponentName: com.proj.MyComponent
+ComponentVersion: 1.0.0
+ComponentDescription: com.proj.MyComponent Greengrass component, generated by greengrass#component.
+ComponentPublisher: proj
+Manifests:
+  - Platform:
+      os: linux
+      architecture: aarch64
+    Artifacts:
+      # Placeholders are substituted at publish time. The basename must stay
+      # my-component.zip, which is what the Run script below unarchives to.
+      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/my-component.zip
+        Unarchive: ZIP
+    Lifecycle:
+      # Requires a node binary on the device's PATH. The generated bundle was
+      # tested with Node.js 22; Greengrass uses the installed runtime.
+      Run: node {artifacts:decompressedPath}/my-component/index.js
+",
+  "packages/test-project/project.json": "{
+  "name": "test-project",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/test-project/src",
+  "metadata": {
+    "components": [
+      {
+        "generator": "greengrass#component",
+        "path": "src/greengrass/my-component/main.ts",
+        "name": "my-component",
+        "language": "typescript",
+        "componentName": "com.proj.MyComponent",
+        "componentVersion": "1.0.0",
+        "platform": "linux-arm64",
+        "ipc": false,
+        "gdkConfig": false
+      }
+    ]
+  },
+  "targets": {
+    "assemble": {
+      "dependsOn": ["bundle", "my-component-artifact"]
+    },
+    "build": {
+      "dependsOn": ["bundle", "my-component-artifact"]
+    },
+    "bundle": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["compile"],
+      "cache": true,
+      "inputs": ["default"],
+      "outputs": ["{workspaceRoot}/dist/{projectRoot}/bundle"],
+      "options": {
+        "command": "rolldown -c rolldown.config.ts",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "compile": {
+      "executor": "@nx/js:tsc"
+    },
+    "my-component-artifact": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["bundle"],
+      "cache": true,
+      "inputs": [
+        "production",
+        "^production",
+        "{workspaceRoot}/packages/common/scripts/src/greengrass/**/*"
+      ],
+      "outputs": [
+        "{workspaceRoot}/dist/{projectRoot}/greengrass/my-component/greengrass-build"
+      ],
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/build-artifact.ts {projectRoot} my-component dist/{projectRoot}/greengrass/my-component dist/{projectRoot}/bundle/greengrass/my-component"
+      }
+    },
+    "my-component-deploy-local": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["my-component-artifact"],
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/deploy-local.ts dist/{projectRoot}/greengrass/my-component"
+      }
+    },
+    "my-component-logs": {
+      "executor": "nx:run-commands",
+      "continuous": true,
+      "options": {
+        "command": "tsx packages/common/scripts/src/greengrass/component-logs.ts com.proj.MyComponent"
+      }
+    }
+  }
+}
+",
+  "packages/test-project/rolldown.config.ts": "import { defineConfig } from 'rolldown';
+
+export default defineConfig([
+  {
+    tsconfig: 'tsconfig.lib.json',
+    input: 'src/greengrass/my-component/main.ts',
+    output: {
+      file: '../../dist/packages/test-project/bundle/greengrass/my-component/index.js',
+      format: 'cjs',
+      codeSplitting: false,
+    },
+    platform: 'node',
+  },
+]);
+",
+  "packages/test-project/src/greengrass/my-component/main.ts": "const RUN_INTERVAL_MS = 30_000;
+
+export function runOnce(sequence: number): void {
+  console.log(
+    \`[com.proj.MyComponent] 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/component/recipe.yaml.template

@@ -0,0 +1,41 @@
+RecipeFormatVersion: '<%- recipeFormat %>'
+ComponentName: <%- componentName %>
+ComponentVersion: <%- version %>
+ComponentDescription: <%- componentDescription %>
+ComponentPublisher: <%- publisher %>
+<%_ if (ipc) { _%>
+ComponentConfiguration:
+  DefaultConfiguration:
+    accessControl:
+      aws.greengrass.ipc.pubsub:
+        <%- componentName %>:pubsub:1:
+          policyDescription: Allow publishing heartbeat messages to this component's own topic.
+          operations:
+            - aws.greengrass#PublishToTopic
+          resources:
+            - <%- componentName %>/heartbeat
+<%_ } _%>
+Manifests:
+<%_ manifests.forEach((m) => { _%>
+  - Platform:
+      os: <%- m.os %>
+      architecture: <%- m.architecture %>
+    Artifacts:
+      # Placeholders are substituted at publish time. The basename must stay
+      # <%- m.artifactBaseName %>.zip, which is what the Run script below unarchives to.
+      - Uri: s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/<%- m.artifactBaseName %>.zip
+        Unarchive: ZIP
+    Lifecycle:
+<%_ if (ipc) { _%>
+      # aws-crt ships its native addon prebuilt for every platform it supports,
+      # so this component's build copies this architecture's copy into the
+      # artifact and aws-crt's own loader reads it from this path, resolved
+      # relative to index.js. There is no Install step: the decompressed
+      # artifact folder is read-only by contract, and nothing here writes to it.
+      Setenv:
+        AWS_CRT_NODEJS_BINARY_RELATIVE_PATH: native/aws-crt/<%- m.nodeCrtAddonDir %>/aws-crt-nodejs.node
+<%_ } _%>
+      # Requires a node binary on the device's PATH. The generated bundle was
+      # tested with Node.js 22; Greengrass uses the installed runtime.
+      Run: node {artifacts:decompressedPath}/<%- m.artifactBaseName %>/index.js
+<%_ }); _%>