@adobe/helix-deploy 13.1.24 → 13.2.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# [13.2.0](https://github.com/adobe/helix-deploy/compare/v13.1.25...v13.2.0) (2025-11-25)
+
+
+### Bug Fixes
+
+* always get api-id for updateLinks ([67a1fc5](https://github.com/adobe/helix-deploy/commit/67a1fc560cf7429504e1c8d8ee4a56c80e3f15a1))
+* remove createApi config option ([6760c4b](https://github.com/adobe/helix-deploy/commit/6760c4b72b689f8b1ed942228301f4077232c518))
+
+
+### Features
+
+* create routes & links options ([2c1b387](https://github.com/adobe/helix-deploy/commit/2c1b38766d1a211fe6db5ed2ad7b009e171536d3))
+
+## [13.1.25](https://github.com/adobe/helix-deploy/compare/v13.1.24...v13.1.25) (2025-11-25)
+
+
+### Bug Fixes
+
+* **deps:** update external fixes to v3.928.0 ([#867](https://github.com/adobe/helix-deploy/issues/867)) ([772beff](https://github.com/adobe/helix-deploy/commit/772beff0efe17fd859043ff81089404c12ba8421))
+
 ## [13.1.24](https://github.com/adobe/helix-deploy/compare/v13.1.23...v13.1.24) (2025-11-24)
 
 

package/README.md

@@ -35,6 +35,12 @@
 
 The deploy parameters can be specifies in the CLI via `-p`. See below.
 
+## Developing
+
+1. Install dependencies once with `npm install`.
+2. Run the linter via `npm run lint`.
+3. Run the unit-test suite with `npm test`. The script runs `c8 mocha -i -g Integration`, so tests explicitly tagged as "Integration" are skipped.
+
 ## CLI
 
 The command line interface `hedy` can either be invoked via `./node_modules/.bin/hedy`.
@@ -123,6 +129,7 @@ AWS Deployment Options
       --aws-cleanup-integrations  Cleans up unused integrations  [boolean] [default: false]
       --aws-cleanup-versions      Cleans up unused versions  [boolean] [default: false]
       --aws-create-routes         Create routes for function (usually not needed due to proxy function).  [boolean] [default: false]
+      --aws-link-routes           Create or update routes, integrations, permissions, and authorizers when linking versions.  [boolean] [default: true]
       --aws-create-authorizer     Creates API Gateway authorizer using lambda authorization with this function and the specified name. The string can contain placeholders (note that all dots ('.') are replaced with underscores. Example: "helix-authorizer_${version}".  [string]
       --aws-attach-authorizer     Attach specified authorizer to routes during linking.  [string]
       --aws-lambda-format         Format to use to create lambda functions (note that all dots ('.') will be replaced with underscores.  [string] [default: "${packageName}--${baseName}"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/helix-deploy",
-  "version": "13.1.24",
+  "version": "13.2.0",
   "description": "Library and Commandline Tools to build and deploy OpenWhisk Actions",
   "license": "Apache-2.0",
   "homepage": "https://github.com/adobe/helix-deploy#readme",
@@ -39,12 +39,12 @@
   "dependencies": {
     "@adobe/fetch": "4.2.3",
     "@adobe/helix-shared-process-queue": "3.1.3",
-    "@aws-sdk/client-apigatewayv2": "3.927.0",
-    "@aws-sdk/client-lambda": "3.927.0",
-    "@aws-sdk/client-s3": "3.927.0",
-    "@aws-sdk/client-secrets-manager": "3.927.0",
-    "@aws-sdk/client-ssm": "3.927.0",
-    "@aws-sdk/client-sts": "3.927.0",
+    "@aws-sdk/client-apigatewayv2": "3.928.0",
+    "@aws-sdk/client-lambda": "3.928.0",
+    "@aws-sdk/client-s3": "3.928.0",
+    "@aws-sdk/client-secrets-manager": "3.928.0",
+    "@aws-sdk/client-ssm": "3.928.0",
+    "@aws-sdk/client-sts": "3.928.0",
     "@google-cloud/functions": "4.2.1",
     "@google-cloud/secret-manager": "6.1.1",
     "@google-cloud/storage": "7.17.3",
@@ -75,6 +75,7 @@
     "mocha-multi-reporters": "1.5.1",
     "nock": "13.5.6",
     "semantic-release": "25.0.2",
+    "xml2js": "0.6.2",
     "yauzl": "3.2.0"
   },
   "engines": {

package/src/deploy/AWSConfig.js

@@ -19,6 +19,7 @@ export default class AWSConfig {
       region: '',
       role: '',
       apiId: '',
+      linkRoutes: true,
       cleanUpIntegrations: false,
       cleanUpVersions: false,
       createRoutes: false,
@@ -49,6 +50,7 @@ export default class AWSConfig {
       .withAWSCreateAuthorizer(argv.awsCreateAuthorizer)
       .withAWSAttachAuthorizer(argv.awsAttachAuthorizer)
       .withAWSIdentitySources(argv.awsIdentitySource)
+      .withAWSLinkRoutes(argv.awsLinkRoutes)
       .withAWSCleanUpIntegrations(argv.awsCleanupIntegrations)
       .withAWSCleanUpVersions(argv.awsCleanupVersions)
       .withAWSCreateRoutes(argv.awsCreateRoutes)
@@ -101,6 +103,11 @@ export default class AWSConfig {
     return this;
   }
 
+  withAWSLinkRoutes(value) {
+    this.linkRoutes = value;
+    return this;
+  }
+
   withAWSCreateRoutes(value) {
     this.createRoutes = value;
     return this;
@@ -172,7 +179,7 @@ export default class AWSConfig {
   static yarg(yargs) {
     return yargs
       .group(['aws-region', 'aws-api', 'aws-role', 'aws-cleanup-buckets', 'aws-cleanup-integrations',
-        'aws-cleanup-versions', 'aws-create-routes', 'aws-create-authorizer', 'aws-attach-authorizer',
+        'aws-cleanup-versions', 'aws-link-routes', 'aws-create-routes', 'aws-create-authorizer', 'aws-attach-authorizer',
         'aws-lambda-format', 'aws-parameter-manager', 'aws-deploy-template', 'aws-arch', 'aws-update-secrets',
         'aws-deploy-bucket', 'aws-identity-source', 'aws-log-format', 'aws-layers',
         'aws-tracing-mode', 'aws-extra-permissions', 'aws-tags', 'aws-handler'], 'AWS Deployment Options')
@@ -201,6 +208,11 @@ export default class AWSConfig {
         type: 'boolean',
         default: false,
       })
+      .option('aws-link-routes', {
+        description: 'Create or update routes, integrations, permissions, and authorizers when linking versions.',
+        type: 'boolean',
+        default: true,
+      })
       .option('aws-parameter-manager', {
         description: 'Manager to use for storing package params. (either "secret" for Secrets Manager or "system" for System Manager)',
         type: 'string',

package/src/deploy/AWSDeployer.js

@@ -491,12 +491,17 @@ export default class AWSDeployer extends BaseDeployer {
 
   async createAPI() {
     const { cfg } = this;
+    const requestedApiId = this._cfg.apiId;
     const { ApiId, ApiEndpoint } = await this.initApiId();
     this._functionURL = `${ApiEndpoint}${this.functionPath}`;
 
+    if (requestedApiId !== 'create') {
+      return;
+    }
+
     // check for stage
     const res = await this._api.send(new GetStagesCommand({
-      ApiId: this._cfg.apiId,
+      ApiId,
     }));
     const stage = res.Items.find((s) => s.StageName === '$default');
     if (!stage) {
@@ -838,6 +843,15 @@ export default class AWSDeployer extends BaseDeployer {
     const { cfg, functionName } = this;
     const { ApiId } = await this.initApiId();
     const functionVersion = cfg.version.replace(/\./g, '_');
+    const shouldLinkRoutes = this._cfg.linkRoutes !== false;
+
+    let routes = [];
+    if (shouldLinkRoutes) {
+      this.log.info(chalk`--: fetching routes ...`);
+      routes = await this.fetchRoutes(ApiId);
+    } else {
+      this.log.info(chalk`--: skipping route linking per configuration.`);
+    }
 
     let res;
     let incrementalVersion;
@@ -856,10 +870,6 @@ export default class AWSDeployer extends BaseDeployer {
       throw e;
     }
 
-    // get all the routes
-    this.log.info(chalk`--: fetching routes ...`);
-    const routes = await this.fetchRoutes(ApiId);
-
     // create routes for each symlink
     const sfx = this.getLinkVersions();
 
@@ -867,6 +877,12 @@ export default class AWSDeployer extends BaseDeployer {
       // create or update alias
       const aliasArn = await this.createOrUpdateAlias(suffix.replace('.', '_'), functionName, incrementalVersion);
 
+      if (!shouldLinkRoutes) {
+        this.log.info(chalk`--: skipped route updates for link {blue ${suffix}} (linkRoutes disabled).`);
+        // eslint-disable-next-line no-continue
+        continue;
+      }
+
       // find or create integration
       let integration = await this.findIntegration(ApiId, aliasArn);
       if (integration) {