alchemy 0.34.0 → 0.34.2

package/bin/alchemy.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { parseArgs } from "node:util";
 import { createAlchemy } from "./create-alchemy.ts";
+import { bootstrapS3 } from "./bootstrap-s3.ts";
 
 // Parse command-line arguments. We allow unknown flags because different
 // sub-commands may accept different sets.
@@ -13,6 +14,8 @@ const { values, positionals } = parseArgs({
     overwrite: { type: "boolean" },
     help: { type: "boolean", short: "h" },
     version: { type: "boolean", short: "v" },
+    region: { type: "string" },
+    prefix: { type: "string" },
   },
 });
 
@@ -23,6 +26,11 @@ const usage = `Usage: alchemy <command> [options]
 
 Available commands:
   create    Scaffold a new project
+  bootstrap Bootstrap cloud resources for alchemy
+
+Bootstrap options:
+  --region    AWS region (defaults to AWS profile default)
+  --prefix    S3 bucket name prefix (default: alchemy-state)
 `;
 
 if (!command) {
@@ -61,6 +69,24 @@ switch (command) {
     break;
   }
 
+  case "bootstrap": {
+    const subcommand = positionals.shift();
+
+    if (subcommand === "s3") {
+      await bootstrapS3({
+        region: values.region as string | undefined,
+        prefix: values.prefix as string | undefined,
+        help: values.help as boolean | undefined,
+      });
+    } else {
+      console.error(`Unknown bootstrap subcommand: ${subcommand || "(none)"}`);
+      console.error("Available bootstrap subcommands:");
+      console.error("  s3    Create S3 bucket for state storage");
+      process.exit(1);
+    }
+    break;
+  }
+
   default:
     console.error(`Unknown command: ${command}`);
     process.exit(1);

package/bin/bootstrap-s3.ts

@@ -0,0 +1,255 @@
+import {
+  GetResourcesCommand,
+  ResourceGroupsTaggingAPIClient,
+} from "@aws-sdk/client-resource-groups-tagging-api";
+import {
+  CreateBucketCommand,
+  PutBucketTaggingCommand,
+  S3Client,
+} from "@aws-sdk/client-s3";
+import { loadConfig } from "@smithy/node-config-provider";
+
+export interface BootstrapS3Options {
+  region?: string;
+  prefix?: string;
+  help?: boolean;
+}
+
+const BOOTSTRAP_TAG_KEY = "alchemy:bootstrap";
+const BOOTSTRAP_TAG_VALUE = "s3-state-store";
+
+/**
+ * Generate a random suffix for bucket names to avoid conflicts
+ */
+function generateRandomSuffix(): string {
+  return Math.random().toString(36).substring(2, 8);
+}
+
+/**
+ * Find existing bootstrap bucket by checking tags using Resource Groups API
+ */
+async function findExistingBootstrapBucket(
+  region: string,
+  prefix: string,
+): Promise<string | null> {
+  try {
+    const resourceGroupsClient = new ResourceGroupsTaggingAPIClient({ region });
+
+    const result = await resourceGroupsClient.send(
+      new GetResourcesCommand({
+        ResourceTypeFilters: ["s3:bucket"],
+        TagFilters: [
+          {
+            Key: BOOTSTRAP_TAG_KEY,
+            Values: [BOOTSTRAP_TAG_VALUE],
+          },
+        ],
+      }),
+    );
+
+    if (!result.ResourceTagMappingList) {
+      return null;
+    }
+
+    // Find a bucket that matches our prefix
+    for (const resource of result.ResourceTagMappingList) {
+      if (resource.ResourceARN) {
+        // Extract bucket name from ARN: arn:aws:s3:::bucket-name
+        const bucketName = resource.ResourceARN.split(":::")[1];
+        if (bucketName?.startsWith(prefix)) {
+          return bucketName;
+        }
+      }
+    }
+  } catch (error: any) {
+    console.error("Error finding bootstrap buckets:", error.message);
+    return null;
+  }
+
+  return null;
+}
+
+/**
+ * Create a new S3 bucket with bootstrap tags
+ */
+async function createBootstrapBucket(
+  s3Client: S3Client,
+  bucketName: string,
+): Promise<void> {
+  try {
+    // Create the bucket
+    const createCommand = new CreateBucketCommand({
+      Bucket: bucketName,
+    });
+
+    await s3Client.send(createCommand);
+    console.log(`✅ Created S3 bucket: ${bucketName}`);
+
+    // Add bootstrap tags
+    await s3Client.send(
+      new PutBucketTaggingCommand({
+        Bucket: bucketName,
+        Tagging: {
+          TagSet: [
+            {
+              Key: BOOTSTRAP_TAG_KEY,
+              Value: BOOTSTRAP_TAG_VALUE,
+            },
+            {
+              Key: "Purpose",
+              Value: "Alchemy state storage",
+            },
+            {
+              Key: "CreatedBy",
+              Value: "alchemy-cli",
+            },
+          ],
+        },
+      }),
+    );
+
+    console.log("✅ Tagged bucket with bootstrap markers");
+  } catch (error: any) {
+    if (error.name === "BucketAlreadyExists") {
+      throw new Error(
+        `Bucket name '${bucketName}' is already taken. Please try again to generate a new random suffix.`,
+      );
+    } else if (error.name === "BucketAlreadyOwnedByYou") {
+      console.log(`✅ Bucket ${bucketName} already exists and is owned by you`);
+
+      // Still add tags if they're missing
+      try {
+        await s3Client.send(
+          new PutBucketTaggingCommand({
+            Bucket: bucketName,
+            Tagging: {
+              TagSet: [
+                {
+                  Key: BOOTSTRAP_TAG_KEY,
+                  Value: BOOTSTRAP_TAG_VALUE,
+                },
+                {
+                  Key: "Purpose",
+                  Value: "Alchemy state storage",
+                },
+                {
+                  Key: "CreatedBy",
+                  Value: "alchemy-cli",
+                },
+              ],
+            },
+          }),
+        );
+        console.log("✅ Added bootstrap tags to existing bucket");
+      } catch (tagError: any) {
+        throw new Error(
+          `Failed to tag existing bucket '${bucketName}': ${tagError.message}`,
+        );
+      }
+    } else {
+      throw error;
+    }
+  }
+}
+
+/**
+ * Get the default AWS region from the current profile/configuration
+ */
+async function getDefaultRegion(): Promise<string> {
+  try {
+    const regionProvider = loadConfig({
+      environmentVariableSelector: (env) =>
+        env.AWS_REGION || env.AWS_DEFAULT_REGION,
+      configFileSelector: (profile) => profile.region,
+      default: "us-east-1",
+    });
+
+    return await regionProvider();
+  } catch (_error) {
+    return "us-east-1"; // Default fallback
+  }
+}
+
+/**
+ * Bootstrap S3 bucket for Alchemy state storage
+ */
+export async function bootstrapS3(options: BootstrapS3Options): Promise<void> {
+  if (options.help) {
+    console.log(`
+Usage: alchemy bootstrap s3 [options]
+
+Create an S3 bucket for Alchemy state storage with proper tagging.
+
+Options:
+  --region    AWS region (defaults to AWS profile default: us-east-1)
+  --prefix    S3 bucket name prefix (default: alchemy-state)
+  --help      Show this help message
+
+Examples:
+  alchemy bootstrap s3                                    # Use defaults
+  alchemy bootstrap s3 --region us-west-2                # Specify region
+  alchemy bootstrap s3 --prefix my-app-state             # Custom prefix
+  alchemy bootstrap s3 --region eu-west-1 --prefix app   # Both options
+
+The created bucket will be tagged with 'alchemy:bootstrap=s3-state-store' to
+identify it for future bootstrap operations and avoid creating duplicates.
+`);
+    return;
+  }
+
+  const prefix = options.prefix || "alchemy-state";
+  const region = options.region || (await getDefaultRegion());
+
+  console.log("🚀 Bootstrapping S3 state storage...");
+  console.log(`   Region: ${region}`);
+  console.log(`   Prefix: ${prefix}`);
+
+  // Initialize S3 client
+  const s3Client = new S3Client({
+    region,
+  });
+
+  try {
+    // Check for existing bootstrap bucket
+    const existingBucket = await findExistingBootstrapBucket(region, prefix);
+
+    if (existingBucket) {
+      console.log(`✅ Found existing bootstrap bucket: ${existingBucket}`);
+      console.log("\n📝 To use this bucket in your alchemy.run.ts file:\n");
+      console.log(`import { S3StateStore } from "alchemy/aws";`);
+      console.log("\nconst stateStore = new S3StateStore(scope, {");
+      console.log(`  bucketName: "${existingBucket}",`);
+      console.log(`  region: "${region}",`);
+      console.log("});\n");
+      return;
+    }
+
+    // Generate a new bucket name with random suffix
+    const bucketName = `${prefix}-${generateRandomSuffix()}`;
+    console.log(`📦 Creating new bucket: ${bucketName}`);
+
+    // Create the bucket
+    await createBootstrapBucket(s3Client, bucketName);
+
+    console.log("\n🎉 Bootstrap complete!");
+    console.log("\n📝 To use this bucket in your alchemy.run.ts file:\n");
+    console.log(`import { S3StateStore } from "alchemy/aws";`);
+    console.log("\nconst stateStore = new S3StateStore(scope, {");
+    console.log(`  bucketName: "${bucketName}",`);
+    console.log(`  region: "${region}",`);
+    console.log("});\n");
+  } catch (error: any) {
+    console.error(`❌ Failed to bootstrap S3: ${error.message}`);
+
+    if (error.message?.includes("credentials")) {
+      console.error("\n💡 Make sure your AWS credentials are configured:");
+      console.error(`   - Run 'aws configure' to set up credentials`);
+      console.error(
+        "   - Or set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables",
+      );
+      console.error("   - Or use IAM roles if running on EC2/Lambda");
+    }
+
+    process.exit(1);
+  }
+}

package/lib/aws/index.d.ts

@@ -5,6 +5,7 @@ export * from "./policy-attachment.ts";
 export * from "./policy.ts";
 export * from "./queue.ts";
 export * from "./role.ts";
+export * from "./s3-state-store.ts";
 export * from "./ses.ts";
 export * from "./ssm-parameter.ts";
 export * from "./table.ts";

package/lib/aws/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/lib/aws/index.js

@@ -5,6 +5,7 @@ export * from "./policy-attachment.js";
 export * from "./policy.js";
 export * from "./queue.js";
 export * from "./role.js";
+export * from "./s3-state-store.js";
 export * from "./ses.js";
 export * from "./ssm-parameter.js";
 export * from "./table.js";

package/lib/aws/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/lib/aws/s3-state-store.d.ts

@@ -0,0 +1,117 @@
+import type { Scope } from "../scope.ts";
+import { type State, type StateStore } from "../state.ts";
+/**
+ * Options for S3StateStore
+ */
+export interface S3StateStoreOptions {
+    /**
+     * The prefix to use for object keys in the S3 bucket
+     * This allows multiple state stores to use the same S3 bucket
+     */
+    prefix?: string;
+    /**
+     * The S3 bucket name to use
+     * Required - the bucket must already exist
+     */
+    bucketName?: string;
+    /**
+     * AWS region for the S3 client
+     * If not provided, uses the default AWS region configuration
+     */
+    region?: string;
+}
+/**
+ * State store implementation using AWS S3
+ * Provides reliable, scalable state storage with eventual consistency
+ */
+export declare class S3StateStore implements StateStore {
+    readonly scope: Scope;
+    private readonly options;
+    private client;
+    private prefix;
+    private bucketName;
+    private initialized;
+    /**
+     * Create a new S3StateStore
+     *
+     * @param scope The scope this store belongs to
+     * @param options Options for the state store
+     */
+    constructor(scope: Scope, options?: S3StateStoreOptions);
+    /**
+     * Initialize the S3 client and verify bucket access
+     */
+    init(): Promise<void>;
+    /**
+     * S3 buckets cannot be deleted programmatically via this method
+     */
+    deinit(): Promise<void>;
+    /**
+     * List all resources in the state store
+     */
+    list(): Promise<string[]>;
+    /**
+     * Count the number of items in the state store
+     */
+    count(): Promise<number>;
+    /**
+     * Get a state by key
+     *
+     * @param key The key to look up
+     * @returns The state or undefined if not found
+     */
+    get(key: string): Promise<State | undefined>;
+    /**
+     * Get multiple states by their keys
+     *
+     * @param ids Array of keys to fetch
+     * @returns Record mapping keys to their states
+     */
+    getBatch(ids: string[]): Promise<Record<string, State>>;
+    /**
+     * Get all states in the store
+     *
+     * @returns Record mapping all keys to their states
+     */
+    all(): Promise<Record<string, State>>;
+    /**
+     * Set a state for a key
+     *
+     * @param key The key to set
+     * @param value The state to store
+     */
+    set(key: string, value: State): Promise<void>;
+    /**
+     * Delete a state by key
+     *
+     * @param key The key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Convert key for storage by replacing slashes with colons
+     * since S3 treats slashes as directory separators
+     *
+     * @param key The original key
+     * @returns Key with slashes replaced by colons
+     */
+    private convertKeyForStorage;
+    /**
+     * Convert key from storage by replacing colons with slashes
+     *
+     * @param key The storage key
+     * @returns Key with colons replaced by slashes
+     */
+    private convertKeyFromStorage;
+    /**
+     * Get the full object key for storage
+     *
+     * @param key The original key
+     * @returns The key with prefix for use in the S3 bucket
+     */
+    private getObjectKey;
+    /**
+     * Ensure the store is initialized before operations
+     */
+    private ensureInitialized;
+}
+//# sourceMappingURL=s3-state-store.d.ts.map

package/lib/aws/s3-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-state-store.d.ts","sourceRoot":"","sources":["../../src/aws/s3-state-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAoB,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAI5E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,UAAU;aAa3B,KAAK,EAAE,KAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;gBAEe,KAAK,EAAE,KAAK,EACX,OAAO,GAAE,mBAAwB;IAepD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgC/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAuClD;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAe7D;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAK3C;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,iBAAiB;CAKhC"}

package/lib/aws/s3-state-store.js

@@ -0,0 +1,224 @@
+import { DeleteObjectCommand, GetObjectCommand, ListObjectsV2Command, NoSuchBucket, NoSuchKey, PutObjectCommand, S3Client, } from "@aws-sdk/client-s3";
+import { ResourceScope } from "../resource.js";
+import { serialize } from "../serde.js";
+import { deserializeState } from "../state.js";
+import { ignore } from "../util/ignore.js";
+import { retry } from "./retry.js";
+/**
+ * State store implementation using AWS S3
+ * Provides reliable, scalable state storage with eventual consistency
+ */
+export class S3StateStore {
+    scope;
+    options;
+    client;
+    prefix;
+    bucketName;
+    initialized = false;
+    /**
+     * Create a new S3StateStore
+     *
+     * @param scope The scope this store belongs to
+     * @param options Options for the state store
+     */
+    constructor(scope, options = {}) {
+        this.scope = scope;
+        this.options = options;
+        // Use the scope's chain to build the prefix, similar to how FileSystemStateStore builds its directory
+        const scopePath = scope.chain.join("/");
+        this.prefix = options.prefix
+            ? `${options.prefix}${scopePath}/`
+            : `alchemy/${scopePath}/`;
+        this.bucketName = options.bucketName ?? "alchemy-state";
+        this.client = new S3Client({
+            region: options.region,
+        });
+    }
+    /**
+     * Initialize the S3 client and verify bucket access
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        // Verify bucket exists and is accessible
+        try {
+            await retry(() => this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucketName,
+                MaxKeys: 1,
+            })));
+        }
+        catch (error) {
+            if (error.name === NoSuchBucket.name) {
+                throw new Error(`S3 bucket '${this.bucketName}' does not exist. Please create the bucket first.`);
+            }
+            throw error;
+        }
+        this.initialized = true;
+    }
+    /**
+     * S3 buckets cannot be deleted programmatically via this method
+     */
+    async deinit() {
+        // We don't delete the bucket here, only via explicit resource deletion
+    }
+    /**
+     * List all resources in the state store
+     */
+    async list() {
+        await this.ensureInitialized();
+        const keys = [];
+        let continuationToken;
+        do {
+            const response = await retry(() => this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucketName,
+                Prefix: this.prefix,
+                ContinuationToken: continuationToken,
+            })));
+            if (response.Contents) {
+                keys.push(...response.Contents.map((obj) => {
+                    const key = obj.Key.slice(this.prefix.length);
+                    return this.convertKeyFromStorage(key);
+                }));
+            }
+            continuationToken = response.NextContinuationToken;
+        } while (continuationToken);
+        return keys;
+    }
+    /**
+     * Count the number of items in the state store
+     */
+    async count() {
+        const keys = await this.list();
+        return keys.length;
+    }
+    /**
+     * Get a state by key
+     *
+     * @param key The key to look up
+     * @returns The state or undefined if not found
+     */
+    async get(key) {
+        await this.ensureInitialized();
+        try {
+            const response = await retry(() => this.client.send(new GetObjectCommand({
+                Bucket: this.bucketName,
+                Key: this.getObjectKey(key),
+            })));
+            if (!response.Body) {
+                return undefined;
+            }
+            // Read the stream into a string
+            const content = await response.Body.transformToString();
+            // Parse and deserialize the state data
+            const state = await deserializeState(this.scope, content);
+            // Create a new state object with proper output
+            return {
+                ...state,
+                output: {
+                    ...(state.output || {}),
+                    [ResourceScope]: this.scope,
+                },
+            };
+        }
+        catch (error) {
+            if (error.name === NoSuchKey.name) {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get multiple states by their keys
+     *
+     * @param ids Array of keys to fetch
+     * @returns Record mapping keys to their states
+     */
+    async getBatch(ids) {
+        const result = {};
+        // S3 doesn't have a batch get operation, so we need to make multiple requests
+        const promises = ids.map(async (id) => {
+            const state = await this.get(id);
+            if (state) {
+                result[id] = state;
+            }
+        });
+        await Promise.all(promises);
+        return result;
+    }
+    /**
+     * Get all states in the store
+     *
+     * @returns Record mapping all keys to their states
+     */
+    async all() {
+        const keys = await this.list();
+        return this.getBatch(keys);
+    }
+    /**
+     * Set a state for a key
+     *
+     * @param key The key to set
+     * @param value The state to store
+     */
+    async set(key, value) {
+        await this.ensureInitialized();
+        const objectKey = this.getObjectKey(key);
+        // Serialize the state to handle cyclic structures
+        const serializedData = JSON.stringify(await serialize(this.scope, value), null, 2);
+        await retry(() => this.client.send(new PutObjectCommand({
+            Bucket: this.bucketName,
+            Key: objectKey,
+            Body: serializedData,
+            ContentType: "application/json",
+        })));
+    }
+    /**
+     * Delete a state by key
+     *
+     * @param key The key to delete
+     */
+    async delete(key) {
+        await this.ensureInitialized();
+        await ignore(NoSuchKey.name, () => retry(() => this.client.send(new DeleteObjectCommand({
+            Bucket: this.bucketName,
+            Key: this.getObjectKey(key),
+        }))));
+    }
+    /**
+     * Convert key for storage by replacing slashes with colons
+     * since S3 treats slashes as directory separators
+     *
+     * @param key The original key
+     * @returns Key with slashes replaced by colons
+     */
+    convertKeyForStorage(key) {
+        return key.replaceAll("/", ":");
+    }
+    /**
+     * Convert key from storage by replacing colons with slashes
+     *
+     * @param key The storage key
+     * @returns Key with colons replaced by slashes
+     */
+    convertKeyFromStorage(key) {
+        return key.replaceAll(":", "/");
+    }
+    /**
+     * Get the full object key for storage
+     *
+     * @param key The original key
+     * @returns The key with prefix for use in the S3 bucket
+     */
+    getObjectKey(key) {
+        return `${this.prefix}${this.convertKeyForStorage(key)}`;
+    }
+    /**
+     * Ensure the store is initialized before operations
+     */
+    async ensureInitialized() {
+        if (!this.initialized) {
+            await this.init();
+        }
+    }
+}
+//# sourceMappingURL=s3-state-store.js.map

package/lib/aws/s3-state-store.js.map

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