awscfn 1.0.0 → 1.1.0

package/README.md

@@ -14,7 +14,7 @@ CLI and TypeScript SDK for managing AWS CloudFormation stacks.
 ## Why awscfn?
 
 - **Simple YAML parameters** — No more wrestling with verbose JSON. Just clean, readable YAML files.
-- **See what's happening** — Real-time event streaming shows you exactly what CloudFormation is doing instead of waiting blindly.
+- **See what's happening** — Real-time event streaming in your terminal. No refreshing the console, no juggling `aws cloudformation create-stack` and `describe-stack-events` in another window.
 - **Errors that make sense** — When deploys fail, you get the actual error message from CloudFormation, not a cryptic timeout.
 - **CI/CD friendly** — Works great in GitHub Actions with auto-detected CI mode.
 - **CLI & SDK** — Use from command line or import directly in Node.js/TypeScript projects.
@@ -57,6 +57,16 @@ During stack operations, awscfn streams CloudFormation stack events in real-time
 
 When a failure occurs, the error message includes the actual reason from CloudFormation events.
 
+### 📋 list-stacks
+
+List all CloudFormation stacks in the current region (name, status, creation date).
+
+```bash
+npx awscfn list-stacks
+```
+
+No options. Output is a table of stack name, status, and creation date.
+
 ### 🚀 create-stack
 
 ```bash
@@ -129,6 +139,19 @@ If the names don't match, the deletion will be aborted.
 
 > ⚠️ Requires AWS credentials to be configured in your shell or environment. [Start here](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) if you haven't already.
 
+### 📋 `listStacks(): Promise<StackSummary[]>`
+
+Returns all CloudFormation stacks in the current region (paginated). Excludes `DELETE_COMPLETE` (AWS default). Each item is an AWS SDK `StackSummary` (e.g. `StackName`, `StackStatus`, `CreationTime`).
+
+```ts
+import { listStacks } from 'awscfn';
+
+const stacks = await listStacks();
+for (const s of stacks) {
+  console.log(s.StackName, s.StackStatus);
+}
+```
+
 ### 📦 `createStack(stackName: string, template: Template<P>): Promise<Stack>`
 
 Creates a new CloudFormation stack using a change set and waits for it to complete or fail.

package/bin/awscfn

@@ -6,6 +6,7 @@ const yargs = require('yargs');
 
 const { createStack } = require('../dist/createStack');
 const { deleteStack } = require('../dist/deleteStack');
+const { listStacks } = require('../dist/listStacks');
 const { redeployStack } = require('../dist/redeployStack');
 const { updateStack } = require('../dist/updateStack');
 const { setOutputConfig } = require('../dist/lib/output');
@@ -109,6 +110,14 @@ yargs
       color: !argv.noColor && (process.stdout.isTTY || argv.ci),
     });
   })
+  .command(
+    'list-stacks',
+    'List all CloudFormation stacks',
+    (cmd) => cmd,
+    () => {
+      runCommand(() => listStacks());
+    }
+  )
   .command(
     'create-stack',
     'Create a CloudFormation stack',

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

@@ -8,6 +8,7 @@ export declare function initCloudFormationClient(): void;
 export declare function getCfClient(): CloudFormationClient;
 export * from './createStack';
 export * from './getStackByName';
+export * from './listStacks';
 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,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,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

@@ -28,6 +28,7 @@ function getCfClient() {
 }
 __exportStar(require("./createStack"), exports);
 __exportStar(require("./getStackByName"), exports);
+__exportStar(require("./listStacks"), 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,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,gDAA8B;AAC9B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}

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

@@ -0,0 +1,6 @@
+import { StackSummary } from '@aws-sdk/client-cloudformation';
+/**
+ * Fetches all CloudFormation stacks (paginated). Excludes DELETE_COMPLETE by default (AWS behavior).
+ */
+export declare function listStacks(): Promise<StackSummary[]>;
+//# sourceMappingURL=listStacks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listStacks.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/listStacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAC,MAAM,gCAAgC,CAAC;AAG/E;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAkB1D"}

package/dist/lib/cfn/listStacks.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listStacks = listStacks;
+const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
+const _1 = require(".");
+/**
+ * Fetches all CloudFormation stacks (paginated). Excludes DELETE_COMPLETE by default (AWS behavior).
+ */
+async function listStacks() {
+    const cf = (0, _1.getCfClient)();
+    const out = [];
+    let nextToken;
+    do {
+        const result = await cf.send(new client_cloudformation_1.ListStacksCommand({ NextToken: nextToken }));
+        const summaries = result.StackSummaries ?? [];
+        out.push(...summaries);
+        nextToken = result.NextToken;
+    } while (nextToken);
+    return out;
+}
+//# sourceMappingURL=listStacks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listStacks.js","sourceRoot":"","sources":["../../../src/lib/cfn/listStacks.ts"],"names":[],"mappings":";;AAMA,gCAkBC;AAxBD,0EAA+E;AAC/E,wBAA8B;AAE9B;;GAEG;AACI,KAAK,UAAU,UAAU;IAE5B,MAAM,EAAE,GAAG,IAAA,cAAW,GAAE,CAAC;IACzB,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,SAA6B,CAAC;IAElC,GAAG,CAAC;QAEA,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,yCAAiB,CAAC,EAAC,SAAS,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;QAE9C,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QACvB,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEjC,CAAC,QAAQ,SAAS,EAAE;IAEpB,OAAO,GAAG,CAAC;AAEf,CAAC"}

package/dist/listStacks.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI handler: list all CloudFormation stacks.
+ */
+export declare function listStacks(): Promise<void>;
+//# sourceMappingURL=listStacks.d.ts.map

package/dist/listStacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listStacks.d.ts","sourceRoot":"","sources":["../src/listStacks.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAkChD"}

package/dist/listStacks.js

@@ -0,0 +1,70 @@
+"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.listStacks = listStacks;
+const cfn = __importStar(require("./lib/cfn"));
+const output_1 = require("./lib/output");
+const colors = {
+    dim: '\x1b[2m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m',
+};
+/**
+ * CLI handler: list all CloudFormation stacks.
+ */
+async function listStacks() {
+    cfn.initCloudFormationClient();
+    const stacks = await cfn.listStacks();
+    const config = (0, output_1.getOutputConfig)();
+    if (stacks.length === 0) {
+        console.log('No stacks found.');
+        return;
+    }
+    const maxName = Math.max(20, ...stacks.map((s) => (s.StackName ?? '').length));
+    const headerName = 'STACK NAME'.padEnd(maxName);
+    const headerStatus = 'STATUS';
+    const headerCreated = 'CREATED';
+    console.log(config.color ? (0, output_1.colorize)(`${headerName}  ${headerStatus}  ${headerCreated}`, colors.dim) : `${headerName}  ${headerStatus}  ${headerCreated}`);
+    console.log(config.color ? (0, output_1.colorize)('-'.repeat(headerName.length + 2 + headerStatus.length + 2 + 10), colors.gray) : '-'.repeat(headerName.length + 2 + headerStatus.length + 2 + 10));
+    for (const s of stacks) {
+        const name = (s.StackName ?? '—').padEnd(maxName);
+        const status = s.StackStatus ?? '—';
+        const created = s.CreationTime
+            ? s.CreationTime.toISOString().slice(0, 10)
+            : '—';
+        console.log(`${name}  ${status}  ${created}`);
+    }
+}
+//# sourceMappingURL=listStacks.js.map

package/dist/listStacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listStacks.js","sourceRoot":"","sources":["../src/listStacks.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,gCAkCC;AA9CD,+CAAiC;AACjC,yCAAuD;AAEvD,MAAM,MAAM,GAAG;IACX,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,SAAS;CACnB,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,UAAU;IAE5B,GAAG,CAAC,wBAAwB,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAA,wBAAe,GAAE,CAAC;IAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAEtB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO;IAEX,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,QAAQ,CAAC;IAC9B,MAAM,aAAa,GAAG,SAAS,CAAC;IAEhC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,iBAAQ,EAAC,GAAG,UAAU,KAAK,YAAY,KAAK,aAAa,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,KAAK,YAAY,KAAK,aAAa,EAAE,CAAC,CAAC;IAC1J,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,iBAAQ,EAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEvL,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAErB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC;QACpC,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY;YAC1B,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3C,CAAC,CAAC,GAAG,CAAC;QAEV,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;IAElD,CAAC;AAEL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awscfn",
-  "version": "1.0.0",
+  "version": "1.1.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",