@go-to-k/cdkd 0.0.2 → 0.0.3

package/README.md

@@ -306,16 +306,16 @@ Reproduce with `./tests/benchmark/run-benchmark.sh all`. See [tests/benchmark/RE
 
 ## Installation
 
-### From npm (experimental)
+### From npm
 
 ```bash
-npm i -g @go-to-k/cdkd@experimental   # latest experimental
-npm i -g @go-to-k/cdkd@0.1.0          # pin to a specific version
+npm i -g @go-to-k/cdkd          # latest release
+npm i -g @go-to-k/cdkd@0.0.2    # pin to a specific version
 ```
 
 The installed binary is `cdkd` — run it the same way in either install path.
 
-> Published under the `experimental` dist-tag while the project is in early development. There is no `latest` tag yet — always pin to `@experimental` (or a specific version) so `npm i -g @go-to-k/cdkd` does not silently resolve to a future stable release with different behavior.
+> cdkd is an experimental / educational project and is not intended for production use — see the warning at the top of this README. Pin to a specific version if you need reproducible installs.
 
 ### From source
 

package/dist/cli.js

@@ -2893,6 +2893,7 @@ import {
   GetObjectCommand,
   PutObjectCommand as PutObjectCommand2,
   DeleteObjectCommand,
+  HeadBucketCommand as HeadBucketCommand2,
   HeadObjectCommand as HeadObjectCommand2,
   ListObjectsV2Command,
   NoSuchKey
@@ -2909,6 +2910,28 @@ var S3StateBackend = class {
   getStateKey(stackName) {
     return `${this.config.prefix}/${stackName}/state.json`;
   }
+  /**
+   * Verify that the configured state bucket exists.
+   *
+   * Called early in deploy/destroy to fail fast before expensive work
+   * (asset publishing, Docker builds) runs against a missing bucket.
+   */
+  async verifyBucketExists() {
+    try {
+      await this.s3Client.send(new HeadBucketCommand2({ Bucket: this.config.bucket }));
+    } catch (error) {
+      const name = error.name;
+      if (name === "NotFound" || name === "NoSuchBucket") {
+        throw new StateError(
+          `State bucket '${this.config.bucket}' does not exist. Run 'cdkd bootstrap' to create it, or specify an existing bucket via --state-bucket, CDKD_STATE_BUCKET, or cdk.json context.cdkd.stateBucket.`
+        );
+      }
+      throw new StateError(
+        `Failed to verify state bucket '${this.config.bucket}': ${error instanceof Error ? error.message : String(error)}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
   /**
    * Check if state exists for a stack
    */
@@ -26028,6 +26051,11 @@ async function deployCommand(stacks, options) {
     ...options.profile && { profile: options.profile }
   });
   setAwsClients(awsClients);
+  const preflightStateBackend = new S3StateBackend(awsClients.s3, {
+    bucket: stateBucket,
+    prefix: options.statePrefix
+  });
+  await preflightStateBackend.verifyBucketExists();
   let deployInterrupted = false;
   const topLevelSigintHandler = () => {
     if (deployInterrupted) {
@@ -26481,6 +26509,7 @@ async function destroyCommand(stackArgs, options) {
       prefix: options.statePrefix
     };
     const stateBackend = new S3StateBackend(awsClients.s3, stateConfig);
+    await stateBackend.verifyBucketExists();
     const lockManager = new LockManager(awsClients.s3, stateConfig);
     const dagBuilder = new DagBuilder();
     const providerRegistry = new ProviderRegistry();
@@ -26861,7 +26890,7 @@ function reorderArgs(argv) {
 }
 async function main() {
   const program = new Command8();
-  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.0.2");
+  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.0.3");
   program.addCommand(createBootstrapCommand());
   program.addCommand(createSynthCommand());
   program.addCommand(createDeployCommand());