awscfn 1.1.3 → 1.3.0

package/README.md

@@ -127,12 +127,34 @@ awscfn update-stack -n <STACK_NAME> -t <TEMPLATE_FILE> -p <PARAMS_FILE>
 | `--name`, `-n` | Stack name |
 | `--template`, `-t` | CloudFormation template file |
 | `--params`, `-p` | Parameters file (YAML) |
+| `--create` | If the stack doesn't exist, create it (instead of erroring) |
+| `-m` | Shorthand for `--create` |
 
 If there are no changes to apply, the command succeeds gracefully:
 ```
 ✓ Stack my-stack is up to date (no changes)
 ```
 
+### 👁️ preview-stack
+
+Builds a change set (same capabilities as deploy), prints a **table of planned resource-level changes**, then **deletes** the change set without executing it. If the stack exists, uses an **UPDATE** change set; otherwise **CREATE**.
+
+```bash
+awscfn preview-stack -n <STACK_NAME> -t <TEMPLATE_FILE> -p <PARAMS_FILE>
+```
+
+| Flag | Description |
+|------|-------------|
+| `--name`, `-n` | Stack name |
+| `--template`, `-t` | CloudFormation template file |
+| `--params`, `-p` | Parameters file (YAML) |
+
+Use this to review Add / Modify / Remove actions (and replacement hints) before running **`create-stack`** or **`update-stack`**.
+
+If the stack is **`ROLLBACK_COMPLETE`**, **`update-stack`** would delete and recreate it — **`preview-stack` cannot model that path** and exits with an error (delete the stack or run **`update-stack`** first).
+
+Non-resource change-set entries (for example hooks) are counted and noted when they are not shown as table rows.
+
 ### ♻️ redeploy-stack
 
 ```bash
@@ -178,7 +200,7 @@ If the names don't match, the deletion will be aborted.
 
 ### Nested stacks and IAM
 
-Change sets request **`CAPABILITY_NAMED_IAM`** and **`CAPABILITY_AUTO_EXPAND`**, so stacks that define named IAM resources or **nested stacks** (including templates from [`aws cloudformation package`](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/package.html)) work with **`create-stack`** / **`update-stack`** and the SDK `createStack` / `updateStack` helpers.
+Change sets request **`CAPABILITY_NAMED_IAM`** and **`CAPABILITY_AUTO_EXPAND`**, so stacks that define named IAM resources or **nested stacks** (including templates from [`aws cloudformation package`](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/package.html)) work with **`create-stack`** / **`update-stack`** / **`preview-stack`** and the SDK `createStack` / `updateStack` / `previewChangeSet` helpers.
 
 ### 📋 `listStacks(): Promise<StackSummary[]>`
 
@@ -323,6 +345,25 @@ Reason: Resource handler returned message: "CannotPullContainerError: image not
 
 > ✅ This function ensures safety by skipping updates for in-progress stacks and gracefully recovering from `ROLLBACK_COMPLETE` states.
 
+### 👁️ `previewChangeSet(stackName, template, operation)` / `previewStack(...)`
+
+**SDK:** Build a change set, print a colored table of planned resource changes (Add / Modify / Remove, replacement hints), then delete the change set — **without** executing it. Same capabilities as deploy (`CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`).
+
+```ts
+import { initCloudFormationClient, previewChangeSet } from 'awscfn';
+
+initCloudFormationClient();
+
+await previewChangeSet('my-stack', {
+  body: templateString,
+  params: { Env: 'prod' },
+}, 'UPDATE');
+```
+
+**CLI:** Prefer `awscfn preview-stack -n … -t … -p …`, which picks **CREATE** vs **UPDATE** from whether the stack exists (same idea as deploy). Refuses **`ROLLBACK_COMPLETE`** stacks (same recovery path as **`update-stack`**: delete + create).
+
+Table output lives in **`lib/formatChangeSet`** (shared formatting, not CLI-only).
+
 ## Contributing
 
 - Open an [issue](https://github.com/mhweiner/awscfn/issues) for bugs or suggestions

package/bin/awscfn

@@ -7,6 +7,7 @@ const yargs = require('yargs');
 const { createStack } = require('../dist/createStack');
 const { deleteStack } = require('../dist/deleteStack');
 const { listStacks } = require('../dist/listStacks');
+const { previewStack } = require('../dist/previewStack');
 const { redeployStack } = require('../dist/redeployStack');
 const { updateStack } = require('../dist/updateStack');
 const { getOutputConfig, setOutputConfig } = require('../dist/lib/output');
@@ -90,6 +91,15 @@ const templateOpt = {
 const paramsOpt = {
   params: { type: 'string', alias: 'p', describe: 'Parameters file (YAML). Optional; omit to use template defaults.', demandOption: false },
 };
+const createIfMissingOpt = {
+  create: {
+    type: 'boolean',
+    alias: 'm',
+    describe: 'Create the stack if it does not exist (update-stack only)',
+    demandOption: false,
+    default: false,
+  },
+};
 const confirmOpt = {
   confirm: { type: 'string', alias: 'c', describe: 'Repeat stack name to confirm deletion', demandOption: true },
 };
@@ -155,9 +165,17 @@ yargs
   .command(
     'update-stack',
     'Update a CloudFormation stack',
+    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt, ...createIfMissingOpt }),
+    ({ name, template, params, create }) => {
+      runCommand(() => updateStack(name, template, params, Boolean(create)));
+    }
+  )
+  .command(
+    'preview-stack',
+    'Preview changes without deploying (change set only)',
     (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt }),
     ({ name, template, params }) => {
-      runCommand(() => updateStack(name, template, params));
+      runCommand(() => previewStack(name, template, params));
     }
   )
   .completion(

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './lib/cfn';
 export * from './lib/output';
+export { previewStack } from './previewStack';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewStack = void 0;
 __exportStar(require("./lib/cfn"), exports);
 __exportStar(require("./lib/output"), exports);
+var previewStack_1 = require("./previewStack");
+Object.defineProperty(exports, "previewStack", { enumerable: true, get: function () { return previewStack_1.previewStack; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA4C;AAApC,4GAAA,YAAY,OAAA"}

package/dist/lib/cfn/executeChangeSet.d.ts

@@ -1,5 +1,12 @@
 import { Template, TemplateParams } from './index';
-type ChangeSetOperation = 'UPDATE' | 'CREATE';
+export type ChangeSetOperation = 'UPDATE' | 'CREATE';
+/**
+ * Create a change set and return its ARN/id (does not wait).
+ */
+export declare function submitChangeSetRequest<P extends TemplateParams>(stackName: string, template: Template<P>, operation: ChangeSetOperation): Promise<string>;
+/**
+ * Wait until the change set finishes building ({@link waitUntilChangeSetCreateComplete}) with spinner.
+ */
+export declare function waitForChangeSetBuild(changeSetId: string): Promise<void>;
 export declare function createAndExecChangeSet<P extends TemplateParams>(stackName: string, template: Template<P>, operation: ChangeSetOperation): Promise<string>;
-export {};
 //# sourceMappingURL=executeChangeSet.d.ts.map

package/dist/lib/cfn/executeChangeSet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeChangeSet.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/executeChangeSet.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AAG9D,KAAK,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAgE9C,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EACjE,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAejB"}
+{"version":3,"file":"executeChangeSet.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/executeChangeSet.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AAG9D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAoBrD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EACjE,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;AAiBD,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EACjE,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/lib/cfn/executeChangeSet.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitChangeSetRequest = submitChangeSetRequest;
+exports.waitForChangeSetBuild = waitForChangeSetBuild;
 exports.createAndExecChangeSet = createAndExecChangeSet;
 const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
 const index_1 = require("./index");
@@ -16,8 +18,10 @@ function toCfnParameters(params) {
         ParameterValue: String(value),
     }));
 }
-// eslint-disable-next-line max-lines-per-function
-async function createChangeSet(stackName, template, operation) {
+/**
+ * Create a change set and return its ARN/id (does not wait).
+ */
+async function submitChangeSetRequest(stackName, template, operation) {
     const cf = (0, index_1.getCfClient)();
     const changeSetName = `${stackName}-rev-${Date.now()}`;
     const templateBody = typeof template === 'string' ? template : template.body;
@@ -32,25 +36,36 @@ async function createChangeSet(stackName, template, operation) {
         Parameters: parameters,
         Capabilities: ['CAPABILITY_NAMED_IAM', 'CAPABILITY_AUTO_EXPAND'],
     }));
+    return changeset.Id;
+}
+/**
+ * Wait until the change set finishes building ({@link waitUntilChangeSetCreateComplete}) with spinner.
+ */
+async function waitForChangeSetBuild(changeSetId) {
+    const cf = (0, index_1.getCfClient)();
     const cfg = (0, output_1.getOutputConfig)();
     const stopSpinner = cfg.ci ? null : (0, output_1.startSpinner)();
     if (cfg.ci)
         (0, output_1.dim)(`  ${output_1.symbols.ellipsis} Waiting for changeset to be ready...`);
     try {
         await (0, client_cloudformation_1.waitUntilChangeSetCreateComplete)({ client: cf, maxWaitTime: 120 }, {
-            ChangeSetName: changeset.Id,
+            ChangeSetName: changeSetId,
         });
     }
     finally {
         if (stopSpinner)
             stopSpinner();
     }
-    return changeset.Id;
+}
+async function createChangeSetAndWait(stackName, template, operation) {
+    const changeSetId = await submitChangeSetRequest(stackName, template, operation);
+    await waitForChangeSetBuild(changeSetId);
+    return changeSetId;
 }
 async function createAndExecChangeSet(stackName, template, operation) {
     (0, output_1.dim)(`  ${output_1.symbols.bullet} Creating changeset ${(0, output_1.gray)(`(${operation.toLowerCase()})`)}`);
     const cf = (0, index_1.getCfClient)();
-    const changeSetId = await createChangeSet(stackName, template, operation);
+    const changeSetId = await createChangeSetAndWait(stackName, template, operation);
     (0, output_1.dim)(`  ${output_1.symbols.bullet} Executing changeset...`);
     await cf.send(new client_cloudformation_1.ExecuteChangeSetCommand({
         ChangeSetName: changeSetId,

package/dist/lib/cfn/executeChangeSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"executeChangeSet.js","sourceRoot":"","sources":["../../../src/lib/cfn/executeChangeSet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executeChangeSet.js","sourceRoot":"","sources":["../../../src/lib/cfn/executeChangeSet.ts"],"names":[],"mappings":"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"}

package/dist/lib/cfn/index.d.ts

@@ -9,6 +9,7 @@ export declare function getCfClient(): CloudFormationClient;
 export * from './createStack';
 export * from './getStackByName';
 export * from './listStacks';
+export * from './previewChangeSet';
 export * from './updateStack';
 export * from './deleteStack';
 export * from './validateTemplate';

package/dist/lib/cfn/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;CACZ,GAAG,MAAM,CAAC;AAIX,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;CACZ,GAAG,MAAM,CAAC;AAIX,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/lib/cfn/index.js

@@ -29,6 +29,7 @@ function getCfClient() {
 __exportStar(require("./createStack"), exports);
 __exportStar(require("./getStackByName"), exports);
 __exportStar(require("./listStacks"), exports);
+__exportStar(require("./previewChangeSet"), exports);
 __exportStar(require("./updateStack"), exports);
 __exportStar(require("./deleteStack"), exports);
 __exportStar(require("./validateTemplate"), exports);

package/dist/lib/cfn/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,4DAIC;AAED,kCAMC;AAtBD,0EAAoE;AAQpE,IAAI,EAAkC,CAAC;AAEvC,SAAgB,wBAAwB;IAEpC,EAAE,GAAG,IAAI,4CAAoB,EAAE,CAAC;AAEpC,CAAC;AAED,SAAgB,WAAW;IAEvB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAElE,OAAO,EAAE,CAAC;AAEd,CAAC;AAED,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,4DAIC;AAED,kCAMC;AAtBD,0EAAoE;AAQpE,IAAI,EAAkC,CAAC;AAEvC,SAAgB,wBAAwB;IAEpC,EAAE,GAAG,IAAI,4CAAoB,EAAE,CAAC;AAEpC,CAAC;AAED,SAAgB,WAAW;IAEvB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAElE,OAAO,EAAE,CAAC;AAEd,CAAC;AAED,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,qDAAmC;AACnC,gDAA8B;AAC9B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}

package/dist/lib/cfn/previewChangeSet.d.ts

@@ -0,0 +1,7 @@
+import { type ChangeSetOperation } from './executeChangeSet';
+import { Template, TemplateParams } from './index';
+/**
+ * Build a change set, print planned resource changes (without executing), then delete the change set.
+ */
+export declare function previewChangeSet<P extends TemplateParams>(stackName: string, template: Template<P>, operation: ChangeSetOperation): Promise<void>;
+//# sourceMappingURL=previewChangeSet.d.ts.map

package/dist/lib/cfn/previewChangeSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewChangeSet.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/previewChangeSet.ts"],"names":[],"mappings":"AAOA,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AA2G9D;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAC3D,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/lib/cfn/previewChangeSet.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewChangeSet = previewChangeSet;
+const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
+const formatChangeSet_1 = require("../formatChangeSet");
+const executeChangeSet_1 = require("./executeChangeSet");
+const index_1 = require("./index");
+const output_1 = require("../output");
+function isNoChangesOutcome(desc) {
+    const reason = desc.StatusReason ?? '';
+    return Boolean(desc.Status === 'FAILED'
+        && (reason.includes('didn\'t contain changes')
+            || reason.includes('No updates are to be performed')));
+}
+/** Merge paginated {@link DescribeChangeSetCommand} results so large change lists are complete. */
+async function describeChangeSetPaginated(changeSetId) {
+    const cf = (0, index_1.getCfClient)();
+    let nextToken;
+    let first;
+    const allChanges = [];
+    do {
+        const page = await cf.send(new client_cloudformation_1.DescribeChangeSetCommand({
+            ChangeSetName: changeSetId,
+            NextToken: nextToken,
+        }));
+        if (!first) {
+            first = page;
+        }
+        allChanges.push(...(page.Changes ?? []));
+        nextToken = page.NextToken;
+    } while (nextToken);
+    return { ...(first ?? {}), Changes: allChanges };
+}
+async function deleteChangeSetQuiet(changeSetId) {
+    const cf = (0, index_1.getCfClient)();
+    try {
+        await cf.send(new client_cloudformation_1.DeleteChangeSetCommand({
+            ChangeSetName: changeSetId,
+        }));
+    }
+    catch {
+        // Best-effort cleanup after preview
+    }
+}
+function printPlannedTable(stackName, desc) {
+    console.log('');
+    (0, output_1.info)(`${output_1.symbols.arrow} Planned resource changes for ${(0, output_1.cyan)(stackName)}`);
+    const lines = (0, formatChangeSet_1.formatChangeSetPreviewLines)(desc.Changes ?? []);
+    for (const line of lines)
+        console.log(line);
+    console.log('');
+    const statusNote = `  ${output_1.symbols.info} Change set status: ${desc.Status ?? 'unknown'}${desc.ExecutionStatus ? ` · execution: ${desc.ExecutionStatus}` : ''}`;
+    (0, output_1.dim)(statusNote);
+    (0, output_1.success)(`${output_1.symbols.check} Preview complete — change set was not executed`);
+}
+/** Fetch full change list after the SDK waiter finished building the change set (waiter polls status only). */
+async function runPreviewFromBuiltChangeSet(stackName, changeSetId) {
+    const desc = await describeChangeSetPaginated(changeSetId);
+    if (isNoChangesOutcome(desc)) {
+        (0, output_1.success)(`${output_1.symbols.check} Stack ${(0, output_1.cyan)(stackName)} — no changes to apply`);
+        return;
+    }
+    if (desc.Status !== 'CREATE_COMPLETE') {
+        throw new Error(desc.StatusReason ?? `Change set status: ${desc.Status ?? 'unknown'}`);
+    }
+    printPlannedTable(stackName, desc);
+}
+/**
+ * Build a change set, print planned resource changes (without executing), then delete the change set.
+ */
+async function previewChangeSet(stackName, template, operation) {
+    (0, output_1.dim)(`  ${output_1.symbols.bullet} Building change set ${(0, output_1.gray)(`(${operation.toLowerCase()} preview)`)}`);
+    const changeSetId = await (0, executeChangeSet_1.submitChangeSetRequest)(stackName, template, operation);
+    try {
+        try {
+            await (0, executeChangeSet_1.waitForChangeSetBuild)(changeSetId);
+        }
+        catch (waitErr) {
+            const descEarly = await describeChangeSetPaginated(changeSetId);
+            if (isNoChangesOutcome(descEarly)) {
+                (0, output_1.success)(`${output_1.symbols.check} Stack ${(0, output_1.cyan)(stackName)} — no changes to apply`);
+                return;
+            }
+            const detail = descEarly.StatusReason ?? 'Change set did not complete successfully';
+            if (waitErr instanceof Error) {
+                waitErr.message = `${detail} — ${waitErr.message}`;
+                throw waitErr;
+            }
+            throw new Error(detail, { cause: waitErr });
+        }
+        await runPreviewFromBuiltChangeSet(stackName, changeSetId);
+    }
+    finally {
+        await deleteChangeSetQuiet(changeSetId);
+    }
+}
+//# sourceMappingURL=previewChangeSet.js.map

package/dist/lib/cfn/previewChangeSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewChangeSet.js","sourceRoot":"","sources":["../../../src/lib/cfn/previewChangeSet.ts"],"names":[],"mappings":"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"}

package/dist/lib/formatChangeSet.d.ts

@@ -0,0 +1,10 @@
+import type { Change } from '@aws-sdk/client-cloudformation';
+/**
+ * Printable rows for a CloudFormation change set's {@link Change} list (resource-level rows).
+ * Sorts by logical resource id for stable output.
+ * Non-resource entries (e.g. hooks) are counted but not tabulated.
+ */
+export declare function formatChangeSetPreviewLines(changes: Change[], opts?: {
+    color?: boolean;
+}): string[];
+//# sourceMappingURL=formatChangeSet.d.ts.map

package/dist/lib/formatChangeSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatChangeSet.d.ts","sourceRoot":"","sources":["../../src/lib/formatChangeSet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAiB,MAAM,gCAAgC,CAAC;AAyE3E;;;;GAIG;AACH,wBAAgB,2BAA2B,CACvC,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,GACzB,MAAM,EAAE,CA2CV"}

package/dist/lib/formatChangeSet.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatChangeSetPreviewLines = formatChangeSetPreviewLines;
+const output_1 = require("./output");
+const colors = {
+    dim: '\x1b[2m',
+    gray: '\x1b[90m',
+};
+function pickActionStyle(action) {
+    if (action === 'Add')
+        return output_1.green;
+    if (action === 'Remove')
+        return output_1.red;
+    if (action === 'Modify')
+        return output_1.yellow;
+    if (action === 'Import')
+        return output_1.cyan;
+    return (t) => t;
+}
+function padRight(s, width) {
+    return s.length >= width ? s : s + ' '.repeat(width - s.length);
+}
+/** Entries such as hooks or future types that do not carry {@link ResourceChange}. */
+function countNonResourceEntries(changes) {
+    return changes.filter((c) => !c.ResourceChange).length;
+}
+function resourceRows(resourceChanges, maxLogical, maxType, configColor) {
+    const out = [];
+    for (const r of resourceChanges) {
+        const logical = padRight(r.LogicalResourceId ?? '—', maxLogical);
+        const resType = padRight(r.ResourceType ?? '—', maxType);
+        const replacement = r.Replacement ?? '—';
+        const style = pickActionStyle(r.Action);
+        const rawAction = r.Action ?? '—';
+        const actionCell = configColor
+            ? style(rawAction) + ' '.repeat(Math.max(0, 10 - rawAction.length))
+            : rawAction.padEnd(10);
+        out.push(`  ${actionCell}  ${logical}  ${resType}  ${replacement}`);
+    }
+    return out;
+}
+function sortedResourceChanges(changes) {
+    const resourceChanges = changes
+        .map((c) => c.ResourceChange)
+        .filter((rc) => Boolean(rc));
+    resourceChanges.sort((a, b) => (a.LogicalResourceId ?? '').localeCompare(b.LogicalResourceId ?? ''));
+    return resourceChanges;
+}
+/**
+ * Printable rows for a CloudFormation change set's {@link Change} list (resource-level rows).
+ * Sorts by logical resource id for stable output.
+ * Non-resource entries (e.g. hooks) are counted but not tabulated.
+ */
+function formatChangeSetPreviewLines(changes, opts) {
+    const configColor = opts?.color ?? (0, output_1.getOutputConfig)().color;
+    const resourceChanges = sortedResourceChanges(changes);
+    const nonResourceCount = countNonResourceEntries(changes);
+    if (resourceChanges.length === 0) {
+        if (nonResourceCount > 0) {
+            const msg = `  (no resource-level rows — ${nonResourceCount} other change entr${nonResourceCount === 1 ? 'y' : 'ies'}, e.g. hooks)`;
+            return [configColor ? (0, output_1.gray)(msg) : msg];
+        }
+        return ['  (no resource-level changes in this change set)'];
+    }
+    const maxLogical = Math.max(14, ...resourceChanges.map((r) => (r.LogicalResourceId ?? '').length));
+    const maxType = Math.max(12, ...resourceChanges.map((r) => (r.ResourceType ?? '').length));
+    const headerLine = `${padRight('ACTION', 10)}  ${padRight('LOGICAL ID', maxLogical)}  `
+        + `${padRight('RESOURCE TYPE', maxType)}  REPLACE`;
+    const divider = '-'.repeat(headerLine.length);
+    const lines = [
+        configColor ? (0, output_1.colorize)(headerLine, colors.dim) : headerLine,
+        configColor ? (0, output_1.colorize)(divider, colors.gray) : divider,
+        ...resourceRows(resourceChanges, maxLogical, maxType, configColor),
+    ];
+    if (nonResourceCount > 0) {
+        const note = `  (${nonResourceCount} non-resource change${nonResourceCount === 1 ? '' : 's'} omitted from table — e.g. hooks)`;
+        lines.push(configColor ? (0, output_1.gray)(note) : note);
+    }
+    return lines;
+}
+//# sourceMappingURL=formatChangeSet.js.map

package/dist/lib/formatChangeSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatChangeSet.js","sourceRoot":"","sources":["../../src/lib/formatChangeSet.ts"],"names":[],"mappings":"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"}

package/dist/lib/formatChangeSet.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formatChangeSet.spec.d.ts.map

package/dist/lib/formatChangeSet.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatChangeSet.spec.d.ts","sourceRoot":"","sources":["../../src/lib/formatChangeSet.spec.ts"],"names":[],"mappings":""}

package/dist/lib/formatChangeSet.spec.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const kizu_1 = require("kizu");
+const formatChangeSet_1 = require("./formatChangeSet");
+(0, kizu_1.test)('formatChangeSetPreviewLines sorts by logical id and prints columns', (assert) => {
+    const changes = [
+        {
+            Type: 'Resource',
+            ResourceChange: {
+                Action: 'Modify',
+                LogicalResourceId: 'B',
+                ResourceType: 'AWS::S3::Bucket',
+                Replacement: 'False',
+            },
+        },
+        {
+            Type: 'Resource',
+            ResourceChange: {
+                Action: 'Add',
+                LogicalResourceId: 'A',
+                ResourceType: 'AWS::IAM::Role',
+                Replacement: 'False',
+            },
+        },
+    ];
+    const lines = (0, formatChangeSet_1.formatChangeSetPreviewLines)(changes, { color: false });
+    const text = lines.join('\n');
+    assert.equal(text.includes('LOGICAL ID'), true);
+    assert.equal(text.includes('RESOURCE TYPE'), true);
+    assert.equal(text.includes('AWS::IAM::Role'), true);
+    assert.equal(text.includes('AWS::S3::Bucket'), true);
+    const dataLines = lines.filter((l) => l.includes('Add') && l.includes('A'));
+    assert.equal(dataLines.length >= 1, true);
+});
+(0, kizu_1.test)('formatChangeSetPreviewLines empty changes', (assert) => {
+    const lines = (0, formatChangeSet_1.formatChangeSetPreviewLines)([], { color: false });
+    assert.equal(lines.length, 1);
+    assert.equal(lines[0].includes('no resource-level'), true);
+});
+(0, kizu_1.test)('formatChangeSetPreviewLines counts non-resource-only changes', (assert) => {
+    const changes = [
+        {
+            Type: 'Resource',
+            HookInvocationCount: 1,
+        },
+    ];
+    const lines = (0, formatChangeSet_1.formatChangeSetPreviewLines)(changes, { color: false });
+    assert.equal(lines.length, 1);
+    assert.equal(lines[0].includes('other change'), true);
+});
+(0, kizu_1.test)('formatChangeSetPreviewLines footer when mixed resource and non-resource', (assert) => {
+    const changes = [
+        {
+            Type: 'Resource',
+            ResourceChange: {
+                Action: 'Add',
+                LogicalResourceId: 'R',
+                ResourceType: 'AWS::SNS::Topic',
+                Replacement: 'False',
+            },
+        },
+        {
+            Type: 'Resource',
+            HookInvocationCount: 2,
+        },
+    ];
+    const lines = (0, formatChangeSet_1.formatChangeSetPreviewLines)(changes, { color: false });
+    const text = lines.join('\n');
+    assert.equal(text.includes('AWS::SNS::Topic'), true);
+    assert.equal(text.includes('non-resource'), true);
+});
+//# sourceMappingURL=formatChangeSet.spec.js.map

package/dist/lib/formatChangeSet.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatChangeSet.spec.js","sourceRoot":"","sources":["../../src/lib/formatChangeSet.spec.ts"],"names":[],"mappings":"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"}

package/dist/previewStack.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI: preview stack changes without executing (build change set, print table, delete change set).
+ * CREATE vs UPDATE matches whether the stack already exists.
+ */
+export declare function previewStack(stackName: string, templatePath: string, paramsPath?: string): Promise<void>;
+//# sourceMappingURL=previewStack.d.ts.map

package/dist/previewStack.d.ts.map

@@ -0,0 +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,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/previewStack.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewStack = previewStack;
+const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
+const cfn = __importStar(require("./lib/cfn"));
+const loadTemplateAndParams_1 = require("./cli/loadTemplateAndParams");
+const validateTemplate_1 = require("./cli/validateTemplate");
+const output_1 = require("./lib/output");
+/**
+ * CLI: preview stack changes without executing (build change set, print table, delete change set).
+ * CREATE vs UPDATE matches whether the stack already exists.
+ */
+async function previewStack(stackName, templatePath, paramsPath) {
+    cfn.initCloudFormationClient();
+    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath);
+    const existing = await cfn.getStackByName(stackName);
+    if (existing?.StackStatus === client_cloudformation_1.StackStatus.ROLLBACK_COMPLETE) {
+        (0, output_1.warn)(`Stack ${stackName} is in ROLLBACK_COMPLETE; update-stack would delete and recreate it. `
+            + 'Preview cannot model that flow.');
+        throw new Error('cannot preview: stack is ROLLBACK_COMPLETE — delete the stack or run update-stack (delete + create) first.');
+    }
+    console.log('validating template...');
+    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);
+}
+//# sourceMappingURL=previewStack.js.map

package/dist/previewStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewStack.js","sourceRoot":"","sources":["../src/previewStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,oCAiCC;AA3CD,0EAA2D;AAC3D,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,yCAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,YAAY,CAC9B,SAAiB,EACjB,YAAoB,EACpB,UAAmB;IAGnB,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,6CAAqB,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjF,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"}

package/dist/updateStack.d.ts

@@ -1,5 +1,5 @@
 /**
  * CLI handler: update an existing CloudFormation stack.
  */
-export declare function updateStack(stackName: string, templatePath: string, paramsPath?: string): Promise<void>;
+export declare function updateStack(stackName: string, templatePath: string, paramsPath?: string, create?: boolean): Promise<void>;
 //# sourceMappingURL=updateStack.d.ts.map

package/dist/updateStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateStack.d.ts","sourceRoot":"","sources":["../src/updateStack.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,WAAW,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"updateStack.d.ts","sourceRoot":"","sources":["../src/updateStack.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,WAAW,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,OAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/updateStack.js

@@ -41,12 +41,19 @@ const log_1 = require("./cli/log");
 /**
  * CLI handler: update an existing CloudFormation stack.
  */
-async function updateStack(stackName, templatePath, paramsPath) {
+async function updateStack(stackName, templatePath, paramsPath, create = false) {
     cfn.initCloudFormationClient();
     const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath);
     const existing = await cfn.getStackByName(stackName);
     if (!existing) {
-        throw new Error('stack not found, try create command');
+        if (!create) {
+            throw new Error('stack not found, try create command');
+        }
+        console.log('validating template...');
+        await (0, validateTemplate_1.validateTemplateOrExit)(template);
+        (0, log_1.logStackAction)(stackName, 'creating', params);
+        await cfn.createStack(stackName, { body: template, params });
+        return;
     }
     console.log('validating template...');
     await (0, validateTemplate_1.validateTemplateOrExit)(template);

package/dist/updateStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateStack.js","sourceRoot":"","sources":["../src/updateStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kCAuBC;AA/BD,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,mCAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,WAAW,CAC7B,SAAiB,EACjB,YAAoB,EACpB,UAAmB;IAGnB,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,6CAAqB,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEZ,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE3D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,MAAM,IAAA,yCAAsB,EAAC,QAAQ,CAAC,CAAC;IAEvC,IAAA,oBAAc,EAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;AAE9D,CAAC"}
+{"version":3,"file":"updateStack.js","sourceRoot":"","sources":["../src/updateStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kCAoCC;AA5CD,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,mCAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,WAAW,CAC7B,SAAiB,EACjB,YAAoB,EACpB,UAAmB,EACnB,SAAkB,KAAK;IAGvB,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,6CAAqB,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEZ,IAAI,CAAC,MAAM,EAAE,CAAC;YAEV,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAE3D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,MAAM,IAAA,yCAAsB,EAAC,QAAQ,CAAC,CAAC;QAEvC,IAAA,oBAAc,EAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;QAE3D,OAAO;IAEX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,MAAM,IAAA,yCAAsB,EAAC,QAAQ,CAAC,CAAC;IAEvC,IAAA,oBAAc,EAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;AAE9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awscfn",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "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",

package/dist/lib/placeholder.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=placeholder.spec.d.ts.map

package/dist/lib/placeholder.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"placeholder.spec.d.ts","sourceRoot":"","sources":["../../src/lib/placeholder.spec.ts"],"names":[],"mappings":""}

package/dist/lib/placeholder.spec.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const kizu_1 = require("kizu");
-(0, kizu_1.test)('awscfn test suite placeholder', (assert) => {
-    // No tests yet; remove this file when adding real specs.
-    assert.equal(1, 1);
-});
-//# sourceMappingURL=placeholder.spec.js.map

package/dist/lib/placeholder.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"placeholder.spec.js","sourceRoot":"","sources":["../../src/lib/placeholder.spec.ts"],"names":[],"mappings":";;AAAA,+BAA0B;AAE1B,IAAA,WAAI,EAAC,+BAA+B,EAAE,CAAC,MAAM,EAAE,EAAE;IAE7C,yDAAyD;IACzD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvB,CAAC,CAAC,CAAC"}