alchemy 0.34.0 → 0.34.2

package/lib/cloudflare/index.d.ts

@@ -38,8 +38,8 @@ export * from "./r2-rest-state-store.ts";
 export * from "./react-router.ts";
 export * from "./redwood.ts";
 export * from "./route.ts";
-export * from "./secret.ts";
 export * from "./secret-key.ts";
+export * from "./secret.ts";
 export * from "./secrets-store.ts";
 export * from "./sveltekit.ts";
 export * from "./tanstack-start.ts";
@@ -48,6 +48,7 @@ export * from "./vectorize-metadata-index.ts";
 export * from "./version-metadata.ts";
 export * from "./vite.ts";
 export * from "./website.ts";
+export * from "./worker-stub.ts";
 export * from "./worker.ts";
 export { Workflow } from "./workflow.ts";
 export * from "./wrangler.json.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/lib/cloudflare/index.js

@@ -38,8 +38,8 @@ export * from "./r2-rest-state-store.js";
 export * from "./react-router.js";
 export * from "./redwood.js";
 export * from "./route.js";
-export * from "./secret.js";
 export * from "./secret-key.js";
+export * from "./secret.js";
 export * from "./secrets-store.js";
 export * from "./sveltekit.js";
 export * from "./tanstack-start.js";
@@ -48,6 +48,7 @@ export * from "./vectorize-metadata-index.js";
 export * from "./version-metadata.js";
 export * from "./vite.js";
 export * from "./website.js";
+export * from "./worker-stub.js";
 export * from "./worker.js";
 export { Workflow } from "./workflow.js";
 export * from "./wrangler.json.js";

package/lib/cloudflare/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.34.0",
+  "version": "0.34.2",
   "type": "module",
   "module": "./lib/index.js",
   "license": "Apache-2.0",
@@ -158,6 +158,7 @@
     "@ai-sdk/anthropic": "^1.1.6",
     "@ai-sdk/openai": "^1.1.9",
     "@asteasolutions/zod-to-openapi": "^7.3.0",
+    "@aws-sdk/client-resource-groups-tagging-api": "^3.830.0",
     "@aws-sdk/client-s3": "3.726.1",
     "@biomejs/biome": "^1.9.4",
     "@cloudflare/puppeteer": "^1.0.2",

package/src/aws/index.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/src/aws/s3-state-store.ts

@@ -0,0 +1,316 @@
+import {
+  DeleteObjectCommand,
+  GetObjectCommand,
+  ListObjectsV2Command,
+  NoSuchBucket,
+  NoSuchKey,
+  PutObjectCommand,
+  S3Client,
+} from "@aws-sdk/client-s3";
+import { ResourceScope } from "../resource.ts";
+import type { Scope } from "../scope.ts";
+import { serialize } from "../serde.ts";
+import { deserializeState, type State, type StateStore } from "../state.ts";
+import { ignore } from "../util/ignore.ts";
+import { retry } from "./retry.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 class S3StateStore implements StateStore {
+  private client: S3Client;
+  private prefix: string;
+  private bucketName: string;
+  private initialized = false;
+
+  /**
+   * Create a new S3StateStore
+   *
+   * @param scope The scope this store belongs to
+   * @param options Options for the state store
+   */
+  constructor(
+    public readonly scope: Scope,
+    private readonly options: S3StateStoreOptions = {},
+  ) {
+    // 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(): Promise<void> {
+    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: any) {
+      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(): Promise<void> {
+    // We don't delete the bucket here, only via explicit resource deletion
+  }
+
+  /**
+   * List all resources in the state store
+   */
+  async list(): Promise<string[]> {
+    await this.ensureInitialized();
+
+    const keys: string[] = [];
+    let continuationToken: string | undefined;
+
+    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(): Promise<number> {
+    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: string): Promise<State | undefined> {
+    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: any) {
+      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: string[]): Promise<Record<string, State>> {
+    const result: Record<string, State> = {};
+
+    // 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(): Promise<Record<string, State>> {
+    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: string, value: State): Promise<void> {
+    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: string): Promise<void> {
+    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
+   */
+  private convertKeyForStorage(key: string): string {
+    return key.replaceAll("/", ":");
+  }
+
+  /**
+   * Convert key from storage by replacing colons with slashes
+   *
+   * @param key The storage key
+   * @returns Key with colons replaced by slashes
+   */
+  private convertKeyFromStorage(key: string): string {
+    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
+   */
+  private getObjectKey(key: string): string {
+    return `${this.prefix}${this.convertKeyForStorage(key)}`;
+  }
+
+  /**
+   * Ensure the store is initialized before operations
+   */
+  private async ensureInitialized(): Promise<void> {
+    if (!this.initialized) {
+      await this.init();
+    }
+  }
+}

package/src/cloudflare/index.ts

@@ -38,8 +38,8 @@ export * from "./r2-rest-state-store.ts";
 export * from "./react-router.ts";
 export * from "./redwood.ts";
 export * from "./route.ts";
-export * from "./secret.ts";
 export * from "./secret-key.ts";
+export * from "./secret.ts";
 export * from "./secrets-store.ts";
 export * from "./sveltekit.ts";
 export * from "./tanstack-start.ts";
@@ -48,6 +48,7 @@ export * from "./vectorize-metadata-index.ts";
 export * from "./version-metadata.ts";
 export * from "./vite.ts";
 export * from "./website.ts";
+export * from "./worker-stub.ts";
 export * from "./worker.ts";
 export { Workflow } from "./workflow.ts";
 export * from "./wrangler.json.ts";