awscfn 1.2.0 → 1.4.0

package/README.md

@@ -115,6 +115,7 @@ awscfn create-stack -n <STACK_NAME> -t <TEMPLATE_FILE> -p <PARAMS_FILE>
 | `--name`, `-n` | Stack name |
 | `--template`, `-t` | CloudFormation template file |
 | `--params`, `-p` | Parameters file (YAML) |
+| `--set`, `-s` | Override one or more parameters (repeatable `Key=Value`) |
 
 ### ⬆️ update-stack
 
@@ -127,6 +128,9 @@ 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) |
+| `--set`, `-s` | Override one or more parameters (repeatable `Key=Value`). You can omit `--params` to override only specific values on an existing stack. |
+| `--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:
 ```
@@ -146,6 +150,7 @@ awscfn preview-stack -n <STACK_NAME> -t <TEMPLATE_FILE> -p <PARAMS_FILE>
 | `--name`, `-n` | Stack name |
 | `--template`, `-t` | CloudFormation template file |
 | `--params`, `-p` | Parameters file (YAML) |
+| `--set`, `-s` | Override one or more parameters (repeatable `Key=Value`) |
 
 Use this to review Add / Modify / Remove actions (and replacement hints) before running **`create-stack`** or **`update-stack`**.
 

package/bin/awscfn

@@ -91,6 +91,25 @@ const templateOpt = {
 const paramsOpt = {
   params: { type: 'string', alias: 'p', describe: 'Parameters file (YAML). Optional; omit to use template defaults.', demandOption: false },
 };
+const setOpt = {
+  set: {
+    type: 'string',
+    alias: 's',
+    array: true,
+    describe: 'Override one or more parameters (repeatable). Format: Key=Value',
+    demandOption: false,
+    default: [],
+  },
+};
+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 },
 };
@@ -132,9 +151,9 @@ yargs
   .command(
     'create-stack',
     'Create a CloudFormation stack',
-    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt }),
-    ({ name, template, params }) => {
-      runCommand(() => createStack(name, template, params));
+    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt, ...setOpt }),
+    ({ name, template, params, set }) => {
+      runCommand(() => createStack(name, template, params, require('../dist/cli/parseParamOverrides').parseParamOverrides(set).overrides));
     }
   )
   .command(
@@ -156,17 +175,17 @@ yargs
   .command(
     'update-stack',
     'Update a CloudFormation stack',
-    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt }),
-    ({ name, template, params }) => {
-      runCommand(() => updateStack(name, template, params));
+    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt, ...createIfMissingOpt, ...setOpt }),
+    ({ name, template, params, create, set }) => {
+      runCommand(() => updateStack(name, template, params, Boolean(create), require('../dist/cli/parseParamOverrides').parseParamOverrides(set).overrides));
     }
   )
   .command(
     'preview-stack',
     'Preview changes without deploying (change set only)',
-    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt }),
-    ({ name, template, params }) => {
-      runCommand(() => previewStack(name, template, params));
+    (cmd) => cmd.options({ ...nameOpt, ...templateOpt, ...paramsOpt, ...setOpt }),
+    ({ name, template, params, set }) => {
+      runCommand(() => previewStack(name, template, params, require('../dist/cli/parseParamOverrides').parseParamOverrides(set).overrides));
     }
   )
   .completion(

package/dist/cli/loadTemplateAndParams.d.ts

@@ -6,5 +6,5 @@ export interface TemplateAndParams {
  * Load template from file and optional params. If no params file is given, uses {}.
  * CloudFormation will error if a required parameter has no default.
  */
-export declare function loadTemplateAndParams(templatePath: string, paramsPath: string | undefined): Promise<TemplateAndParams>;
+export declare function loadTemplateAndParams(templatePath: string, paramsPath: string | undefined, overrides?: Record<string, string>): Promise<TemplateAndParams>;
 //# sourceMappingURL=loadTemplateAndParams.d.ts.map

package/dist/cli/loadTemplateAndParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadTemplateAndParams.d.ts","sourceRoot":"","sources":["../../src/cli/loadTemplateAndParams.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}
+{"version":3,"file":"loadTemplateAndParams.d.ts","sourceRoot":"","sources":["../../src/cli/loadTemplateAndParams.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}

package/dist/cli/loadTemplateAndParams.js

@@ -8,11 +8,20 @@ const templateHasParameters_1 = require("../lib/templateHasParameters");
  * Load template from file and optional params. If no params file is given, uses {}.
  * CloudFormation will error if a required parameter has no default.
  */
-async function loadTemplateAndParams(templatePath, paramsPath) {
+async function loadTemplateAndParams(templatePath, paramsPath, overrides) {
     const template = (0, node_fs_1.readFileSync)(templatePath, 'utf-8');
-    const params = (paramsPath && (0, templateHasParameters_1.templateHasParameters)(template))
+    const hasParameters = (0, templateHasParameters_1.templateHasParameters)(template);
+    const fileParams = (paramsPath && (0, templateHasParameters_1.templateHasParameters)(template))
         ? (await (0, getParamsFromFile_1.getParamsFromFile)(paramsPath))
         : {};
+    if (!hasParameters && overrides && Object.keys(overrides).length > 0) {
+        throw new Error('Template does not declare Parameters, but --set was provided. '
+            + 'Remove --set or add a Parameters section to the template.');
+    }
+    const params = {
+        ...fileParams,
+        ...(overrides ?? {}),
+    };
     return { template, params };
 }
 //# sourceMappingURL=loadTemplateAndParams.js.map

package/dist/cli/loadTemplateAndParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadTemplateAndParams.js","sourceRoot":"","sources":["../../src/cli/loadTemplateAndParams.ts"],"names":[],"mappings":";;AAaA,sDAYC;AAzBD,qCAAqC;AACrC,gEAA2D;AAC3D,wEAAmE;AAOnE;;;GAGG;AACI,KAAK,UAAU,qBAAqB,CACvC,YAAoB,EACpB,UAA8B;IAG9B,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,CAAC,UAAU,IAAI,IAAA,6CAAqB,EAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,CAAE,CAAC,MAAM,IAAA,qCAAiB,EAAC,UAAU,CAAC,CAA6B;QACpE,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC;AAE9B,CAAC"}
+{"version":3,"file":"loadTemplateAndParams.js","sourceRoot":"","sources":["../../src/cli/loadTemplateAndParams.ts"],"names":[],"mappings":";;AAaA,sDA4BC;AAzCD,qCAAqC;AACrC,gEAA2D;AAC3D,wEAAmE;AAOnE;;;GAGG;AACI,KAAK,UAAU,qBAAqB,CACvC,YAAoB,EACpB,UAA8B,EAC9B,SAAkC;IAGlC,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,IAAA,6CAAqB,EAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,CAAC,UAAU,IAAI,IAAA,6CAAqB,EAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC,CAAE,CAAC,MAAM,IAAA,qCAAiB,EAAC,UAAU,CAAC,CAA6B;QACpE,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,CAAC,aAAa,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAEnE,MAAM,IAAI,KAAK,CACX,gEAAgE;cAC9D,2DAA2D,CAChE,CAAC;IAEN,CAAC;IAED,MAAM,MAAM,GAAG;QACX,GAAG,UAAU;QACb,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;KACvB,CAAC;IAEF,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC;AAE9B,CAAC"}

package/dist/cli/loadTemplateAndParams.spec.d.ts

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

package/dist/cli/loadTemplateAndParams.spec.d.ts.map

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

package/dist/cli/loadTemplateAndParams.spec.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const kizu_1 = require("kizu");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const loadTemplateAndParams_1 = require("./loadTemplateAndParams");
+(0, kizu_1.test)('loadTemplateAndParams throws when template has no Parameters but overrides provided', async (assert) => {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'awscfn-'));
+    const templatePath = (0, node_path_1.join)(dir, 'template.yaml');
+    (0, node_fs_1.writeFileSync)(templatePath, 'Resources: {}', 'utf-8');
+    await assert.throws(() => (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, undefined, { Foo: 'bar' }), /does not declare Parameters/i);
+});
+//# sourceMappingURL=loadTemplateAndParams.spec.js.map

package/dist/cli/loadTemplateAndParams.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTemplateAndParams.spec.js","sourceRoot":"","sources":["../../src/cli/loadTemplateAndParams.spec.ts"],"names":[],"mappings":";;AAAA,+BAA0B;AAC1B,qCAAmD;AACnD,qCAA+B;AAC/B,yCAA+B;AAC/B,mEAA8D;AAE9D,IAAA,WAAI,EAAC,qFAAqF,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAEzG,MAAM,GAAG,GAAG,IAAA,qBAAW,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEhD,IAAA,uBAAa,EAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAEtD,MAAM,MAAM,CAAC,MAAM,CACf,GAAG,EAAE,CAAC,IAAA,6CAAqB,EAAC,YAAY,EAAE,SAAS,EAAE,EAAC,GAAG,EAAE,KAAK,EAAC,CAAC,EAClE,8BAA8B,CACjC,CAAC;AAEN,CAAC,CAAC,CAAC"}

package/dist/cli/parseParamOverrides.d.ts

@@ -0,0 +1,9 @@
+export interface ParamOverrideParseResult {
+    overrides: Record<string, string>;
+}
+/**
+ * Parse repeatable CLI overrides like:
+ *   ["Foo=bar", "Env=prod"]
+ */
+export declare function parseParamOverrides(values: unknown[] | undefined): ParamOverrideParseResult;
+//# sourceMappingURL=parseParamOverrides.d.ts.map

package/dist/cli/parseParamOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseParamOverrides.d.ts","sourceRoot":"","sources":["../../src/cli/parseParamOverrides.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,wBAAwB,CAyB3F"}

package/dist/cli/parseParamOverrides.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseParamOverrides = parseParamOverrides;
+/**
+ * Parse repeatable CLI overrides like:
+ *   ["Foo=bar", "Env=prod"]
+ */
+function parseParamOverrides(values) {
+    const overrides = {};
+    if (!values)
+        return { overrides };
+    for (const raw of values) {
+        if (typeof raw !== 'string')
+            throw new Error(`Invalid --set value: ${String(raw)}`);
+        const idx = raw.indexOf('=');
+        if (idx <= 0)
+            throw new Error(`Invalid --set value (expected Key=Value): ${raw}`);
+        const key = raw.slice(0, idx).trim();
+        const value = raw.slice(idx + 1);
+        if (!key)
+            throw new Error(`Invalid --set value (empty key): ${raw}`);
+        overrides[key] = value;
+    }
+    return { overrides };
+}
+//# sourceMappingURL=parseParamOverrides.js.map

package/dist/cli/parseParamOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseParamOverrides.js","sourceRoot":"","sources":["../../src/cli/parseParamOverrides.ts"],"names":[],"mappings":";;AAQA,kDAyBC;AA7BD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,MAA6B;IAE7D,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAC,SAAS,EAAC,CAAC;IAEhC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAEvB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEpF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,GAAG,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,EAAE,CAAC,CAAC;QAElF,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAEjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;QAErE,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAE3B,CAAC;IAED,OAAO,EAAC,SAAS,EAAC,CAAC;AAEvB,CAAC"}

package/dist/cli/parseParamOverrides.spec.d.ts

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

package/dist/cli/parseParamOverrides.spec.d.ts.map

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

package/dist/cli/parseParamOverrides.spec.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const kizu_1 = require("kizu");
+const parseParamOverrides_1 = require("./parseParamOverrides");
+(0, kizu_1.test)('parseParamOverrides parses repeated Key=Value pairs', (assert) => {
+    const { overrides } = (0, parseParamOverrides_1.parseParamOverrides)(['Foo=bar', 'Env=prod']);
+    assert.equal(overrides, { Foo: 'bar', Env: 'prod' });
+});
+(0, kizu_1.test)('parseParamOverrides last value wins for duplicate keys', (assert) => {
+    const { overrides } = (0, parseParamOverrides_1.parseParamOverrides)(['Foo=bar', 'Foo=baz']);
+    assert.equal(overrides, { Foo: 'baz' });
+});
+(0, kizu_1.test)('parseParamOverrides throws on invalid format', (assert) => {
+    assert.throws(() => (0, parseParamOverrides_1.parseParamOverrides)(['NoEquals']), /expected Key=Value/);
+});
+//# sourceMappingURL=parseParamOverrides.spec.js.map

package/dist/cli/parseParamOverrides.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseParamOverrides.spec.js","sourceRoot":"","sources":["../../src/cli/parseParamOverrides.spec.ts"],"names":[],"mappings":";;AAAA,+BAA0B;AAC1B,+DAA0D;AAE1D,IAAA,WAAI,EAAC,qDAAqD,EAAE,CAAC,MAAM,EAAE,EAAE;IAEnE,MAAM,EAAC,SAAS,EAAC,GAAG,IAAA,yCAAmB,EAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAEjE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAC,CAAC,CAAC;AAEvD,CAAC,CAAC,CAAC;AAEH,IAAA,WAAI,EAAC,wDAAwD,EAAE,CAAC,MAAM,EAAE,EAAE;IAEtE,MAAM,EAAC,SAAS,EAAC,GAAG,IAAA,yCAAmB,EAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,EAAC,GAAG,EAAE,KAAK,EAAC,CAAC,CAAC;AAE1C,CAAC,CAAC,CAAC;AAEH,IAAA,WAAI,EAAC,8CAA8C,EAAE,CAAC,MAAM,EAAE,EAAE;IAE5D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAmB,EAAC,CAAC,UAAU,CAAQ,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAExF,CAAC,CAAC,CAAC"}

package/dist/createStack.d.ts

@@ -1,5 +1,5 @@
 /**
  * CLI handler: create a new CloudFormation stack.
  */
-export declare function createStack(stackName: string, templatePath: string, paramsPath?: string): Promise<void>;
+export declare function createStack(stackName: string, templatePath: string, paramsPath?: string, overrides?: Record<string, string>): Promise<void>;
 //# sourceMappingURL=createStack.d.ts.map

package/dist/createStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStack.d.ts","sourceRoot":"","sources":["../src/createStack.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":"createStack.d.ts","sourceRoot":"","sources":["../src/createStack.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,WAAW,CAC7B,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,CAmBf"}

package/dist/createStack.js

@@ -41,9 +41,9 @@ const log_1 = require("./cli/log");
 /**
  * CLI handler: create a new CloudFormation stack.
  */
-async function createStack(stackName, templatePath, paramsPath) {
+async function createStack(stackName, templatePath, paramsPath, overrides) {
     cfn.initCloudFormationClient();
-    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath);
+    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath, overrides);
     const existing = await cfn.getStackByName(stackName);
     if (existing) {
         throw new Error('stack already exists, try update command');

package/dist/createStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStack.js","sourceRoot":"","sources":["../src/createStack.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,QAAQ,EAAE,CAAC;QAEX,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAEhE,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,SAAS,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;AAE/D,CAAC"}
+{"version":3,"file":"createStack.js","sourceRoot":"","sources":["../src/createStack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kCAwBC;AAhCD,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,mCAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,WAAW,CAC7B,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,CAAC;QAEX,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAEhE,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,SAAS,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;AAE/D,CAAC"}

package/dist/previewStack.d.ts

@@ -2,5 +2,5 @@
  * 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>;
+export declare function previewStack(stackName: string, templatePath: string, paramsPath?: string, overrides?: Record<string, string>): Promise<void>;
 //# sourceMappingURL=previewStack.d.ts.map

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,GACpB,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,CA6Bf"}

package/dist/previewStack.js

@@ -43,9 +43,9 @@ 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) {
+async function previewStack(stackName, templatePath, paramsPath, overrides) {
     cfn.initCloudFormationClient();
-    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath);
+    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath, overrides);
     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. `

package/dist/previewStack.js.map

@@ -1 +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"}
+{"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"}

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, overrides?: Record<string, string>): 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,EACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,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, overrides) {
     cfn.initCloudFormationClient();
-    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath);
+    const { template, params } = await (0, loadTemplateAndParams_1.loadTemplateAndParams)(templatePath, paramsPath, overrides);
     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,kCAqCC;AA7CD,+CAAiC;AACjC,uEAAkE;AAClE,6DAA8D;AAC9D,mCAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,WAAW,CAC7B,SAAiB,EACjB,YAAoB,EACpB,UAAmB,EACnB,SAAkB,KAAK,EACvB,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,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.2.0",
+  "version": "1.4.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",