awscfn 1.6.0 → 1.6.1

package/README.md

@@ -180,6 +180,18 @@ If the stack is **`ROLLBACK_COMPLETE`**, **`update-stack`** would delete and rec
 
 Non-resource change-set entries (for example hooks) are counted and noted when they are not shown as table rows.
 
+### ✅ validate-template
+
+Validate a CloudFormation template without creating a change set.
+
+```bash
+awscfn validate-template -t <TEMPLATE_FILE>
+```
+
+| Flag | Description |
+|------|-------------|
+| `--template`, `-t` | CloudFormation template file |
+
 ### ♻️ redeploy-stack
 
 ```bash

package/bin/awscfn

@@ -13,6 +13,8 @@ const { inspectStack } = require('../dist/inspectStack');
 const { previewStack } = require('../dist/previewStack');
 const { redeployStack } = require('../dist/redeployStack');
 const { updateStack } = require('../dist/updateStack');
+const { validateTemplateOrExit } = require('../dist/cli/validateTemplate');
+const { initCloudFormationClient } = require('../dist/lib/cfn');
 const { getOutputConfig, setOutputConfig } = require('../dist/lib/output');
 
 const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8'));
@@ -431,6 +433,19 @@ const cli = yargs
       runCommand(() => previewStack(name, template, params, require('../dist/cli/parseParamOverrides').parseParamOverrides(set).overrides));
     }
   )
+  .command(
+    'validate-template',
+    'Validate a CloudFormation template',
+    (cmd) => cmd.options({ ...templateOpt }),
+    ({ template }) => {
+      runCommand(async () => {
+        initCloudFormationClient();
+        const templateBody = fs.readFileSync(template, 'utf8');
+        await validateTemplateOrExit(templateBody);
+        console.log('template is valid');
+      });
+    }
+  )
   .command(
     'inspect-stack',
     'Inspect a deployed stack in interactive panes (with fallback)',

package/dist/previewStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"previewStack.d.ts","sourceRoot":"","sources":["../src/previewStack.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CA6Bf"}
+{"version":3,"file":"previewStack.d.ts","sourceRoot":"","sources":["../src/previewStack.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/previewStack.js

@@ -56,6 +56,22 @@ async function previewStack(stackName, templatePath, paramsPath, overrides) {
     await (0, validateTemplate_1.validateTemplateOrExit)(template);
     const operation = existing ? 'UPDATE' : 'CREATE';
     (0, output_1.info)(`${output_1.symbols.arrow} Preview ${(0, output_1.cyan)(operation)} for stack ${(0, output_1.cyan)(stackName)}`);
-    await cfn.previewChangeSet(stackName, { body: template, params }, operation);
+    try {
+        await cfn.previewChangeSet(stackName, { body: template, params }, operation);
+    }
+    finally {
+        await cleanupCreatePreviewStack(existing, stackName);
+    }
+}
+async function cleanupCreatePreviewStack(existing, stackName) {
+    if (existing)
+        return;
+    const createdForPreview = await cfn.getStackByName(stackName, true);
+    if (!createdForPreview || createdForPreview.StackStatus !== client_cloudformation_1.StackStatus.REVIEW_IN_PROGRESS) {
+        return;
+    }
+    (0, output_1.warn)(`Preview created stack ${stackName} in REVIEW_IN_PROGRESS. `
+        + 'Cleaning it up automatically...');
+    await cfn.deleteStack(createdForPreview);
 }
 //# sourceMappingURL=previewStack.js.map

package/dist/previewStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"previewStack.js","sourceRoot":"","sources":["../src/previewStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,oCAkCC;AA5CD,0EAA2D;AAC3D,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,yCAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,YAAY,CAC9B,SAAiB,EACjB,YAAoB,EACpB,UAAmB,EACnB,SAAkC;IAGlC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,6CAAqB,EAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,QAAQ,EAAE,WAAW,KAAK,mCAAW,CAAC,iBAAiB,EAAE,CAAC;QAE1D,IAAA,aAAI,EACA,SAAS,SAAS,uEAAuE;cACvF,iCAAiC,CACtC,CAAC;QAEF,MAAM,IAAI,KAAK,CACX,4GAA4G,CAC/G,CAAC;IAEN,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,MAAM,IAAA,yCAAsB,EAAC,QAAQ,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEjD,IAAA,aAAI,EAAC,GAAG,gBAAO,CAAC,KAAK,YAAY,IAAA,aAAI,EAAC,SAAS,CAAC,cAAc,IAAA,aAAI,EAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAEjF,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,EAAE,SAAS,CAAC,CAAC;AAE/E,CAAC"}
+{"version":3,"file":"previewStack.js","sourceRoot":"","sources":["../src/previewStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,oCA0CC;AApDD,0EAA2D;AAC3D,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,yCAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,YAAY,CAC9B,SAAiB,EACjB,YAAoB,EACpB,UAAmB,EACnB,SAAkC;IAGlC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,6CAAqB,EAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,QAAQ,EAAE,WAAW,KAAK,mCAAW,CAAC,iBAAiB,EAAE,CAAC;QAE1D,IAAA,aAAI,EACA,SAAS,SAAS,uEAAuE;cACvF,iCAAiC,CACtC,CAAC;QAEF,MAAM,IAAI,KAAK,CACX,4GAA4G,CAC/G,CAAC;IAEN,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,MAAM,IAAA,yCAAsB,EAAC,QAAQ,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEjD,IAAA,aAAI,EAAC,GAAG,gBAAO,CAAC,KAAK,YAAY,IAAA,aAAI,EAAC,SAAS,CAAC,cAAc,IAAA,aAAI,EAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAEjF,IAAI,CAAC;QAED,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,EAAE,SAAS,CAAC,CAAC;IAE/E,CAAC;YAAS,CAAC;QAEP,MAAM,yBAAyB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAEzD,CAAC;AAEL,CAAC;AAED,KAAK,UAAU,yBAAyB,CACpC,QAAwD,EACxD,SAAiB;IAGjB,IAAI,QAAQ;QAAE,OAAO;IAErB,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEpE,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,WAAW,KAAK,mCAAW,CAAC,kBAAkB,EAAE,CAAC;QAEzF,OAAO;IAEX,CAAC;IAED,IAAA,aAAI,EACA,yBAAyB,SAAS,0BAA0B;UAC1D,iCAAiC,CACtC,CAAC;IACF,MAAM,GAAG,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAE7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awscfn",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "CLI and TypeScript SDK for managing AWS CloudFormation stacks with simple YAML parameters and real-time event streaming.",
   "type": "commonjs",
   "main": "./dist/index.js",