alchemy 0.70.2 → 0.71.0

package/lib/util/retry.d.ts

@@ -9,5 +9,5 @@
  * @returns Result of the operation
  * @throws The last error encountered if all retries fail
  */
-export declare function withExponentialBackoff<T>(operation: () => Promise<T>, isRetryable: (error: any) => any, maxAttempts?: number, initialDelayMs?: number): Promise<T>;
+export declare function withExponentialBackoff<T>(operation: () => Promise<T>, isRetryable: (error: any) => any, maxAttempts?: number, initialDelayMs?: number, maxDelayMs?: number): Promise<T>;
 //# sourceMappingURL=retry.d.ts.map

package/lib/util/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/util/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAChC,WAAW,SAAI,EACf,cAAc,SAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/util/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAChC,WAAW,SAAI,EACf,cAAc,SAAM,EACpB,UAAU,SAAQ,GACjB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/lib/util/retry.js

@@ -9,7 +9,7 @@
  * @returns Result of the operation
  * @throws The last error encountered if all retries fail
  */
-export async function withExponentialBackoff(operation, isRetryable, maxAttempts = 5, initialDelayMs = 100) {
+export async function withExponentialBackoff(operation, isRetryable, maxAttempts = 5, initialDelayMs = 100, maxDelayMs = 10000) {
     let attempt = 0;
     let delay = initialDelayMs;
     while (true) {
@@ -25,7 +25,7 @@ export async function withExponentialBackoff(operation, isRetryable, maxAttempts
             const jitter = Math.random() * 0.1 * delay;
             await new Promise((resolve) => setTimeout(resolve, delay + jitter));
             delay *= 2; // Double the delay for next attempt
-            delay = Math.min(delay, 10000); // Cap at 10 seconds
+            delay = Math.min(delay, maxDelayMs); // Cap at 10 seconds
         }
     }
 }

package/lib/util/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/util/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAA2B,EAC3B,WAAgC,EAChC,WAAW,GAAG,CAAC,EACf,cAAc,GAAG,GAAG;IAEpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,cAAc,CAAC;IAE3B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,IAAI,OAAO,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAkC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,KAAK,CAAC;YAC3C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;YACpE,KAAK,IAAI,CAAC,CAAC,CAAC,oCAAoC;YAChD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,oBAAoB;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/util/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAA2B,EAC3B,WAAgC,EAChC,WAAW,GAAG,CAAC,EACf,cAAc,GAAG,GAAG,EACpB,UAAU,GAAG,KAAK;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,cAAc,CAAC;IAE3B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,IAAI,OAAO,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAkC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,KAAK,CAAC;YAC3C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;YACpE,KAAK,IAAI,CAAC,CAAC,CAAC,oCAAoC;YAChD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,oBAAoB;QAC3D,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/util/validate-resource-id.d.ts

@@ -0,0 +1,2 @@
+export declare function validateResourceID(id: string, qualifier?: string): void;
+//# sourceMappingURL=validate-resource-id.d.ts.map

package/lib/util/validate-resource-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-resource-id.d.ts","sourceRoot":"","sources":["../../src/util/validate-resource-id.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,SAAa,GAAG,IAAI,CAS3E"}

package/lib/util/validate-resource-id.js

@@ -0,0 +1,11 @@
+export function validateResourceID(id, qualifier = "Resource") {
+    //todo(sam): during effect rewrite, this should be much more limiting
+    //todo:      its hard to undo the flexibility we've offered to users now
+    if (!id) {
+        throw new Error(`${qualifier} ID cannot be an empty string: "${id}"`);
+    }
+    if (id.includes(":")) {
+        throw new Error(`${qualifier} ID cannot include colons: "${id}"`);
+    }
+}
+//# sourceMappingURL=validate-resource-id.js.map

package/lib/util/validate-resource-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-resource-id.js","sourceRoot":"","sources":["../../src/util/validate-resource-id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,SAAS,GAAG,UAAU;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,+BAA+B,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.70.2",
+  "version": "0.71.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",
@@ -161,6 +161,7 @@
     "@aws-sdk/credential-providers": "^3.0.0",
     "@cloudflare/unenv-preset": "^2.6.3",
     "@iarna/toml": "^2.2.5",
+    "@octokit/rest": "^21.1.1",
     "@smithy/node-config-provider": "^4.0.0",
     "@smithy/types": "^4.6.0",
     "aws4fetch": "^1.0.20",
@@ -199,7 +200,6 @@
     "@cloudflare/vite-plugin": "^1.10.1",
     "@cloudflare/workers-types": "^4.20250805.0",
     "@libsql/client": "^0.15.12",
-    "@octokit/rest": "^21.1.1",
     "@opennextjs/cloudflare": "^1.6.5",
     "astro": "^5.13.2",
     "drizzle-orm": "^0.44.2",

package/src/apply.ts

@@ -20,6 +20,7 @@ import type { State } from "./state.ts";
 import { formatFQN } from "./util/cli.ts";
 import { logger } from "./util/logger.ts";
 import { createAndSendEvent } from "./util/telemetry.ts";
+import { validateResourceID } from "./util/validate-resource-id.ts";
 
 export interface ApplyOptions {
   quiet?: boolean;
@@ -56,6 +57,7 @@ async function _apply<Out extends ResourceAttributes>(
 ): Promise<Awaited<Out> & Resource> {
   const scope = resource[ResourceScope];
   const start = performance.now();
+  validateResourceID(resource[ResourceID], "Resource");
   try {
     const quiet = props?.quiet ?? scope.quiet;
     await scope.init();

package/src/cloudflare/bindings.ts

@@ -29,6 +29,7 @@ import type { VersionMetadata } from "./version-metadata.ts";
 import type { WorkerRef } from "./worker-ref.ts";
 import type { WorkerStub } from "./worker-stub.ts";
 import type { Worker } from "./worker.ts";
+import type { WorkerLoader } from "./worker-loader.ts";
 import type { Workflow } from "./workflow.ts";
 
 export type Bindings = {
@@ -74,6 +75,7 @@ export type Binding =
   | WorkerStub
   | WorkerRef
   | WorkerEntrypoint
+  | WorkerLoader
   | Workflow
   | BrowserRendering
   | VersionMetadata
@@ -138,6 +140,7 @@ export type WorkerBindingSpec =
   | WorkerBindingVectorize
   | WorkerBindingVersionMetadata
   | WorkerBindingWasmModule
+  | WorkerBindingWorkerLoader
   | WorkerBindingWorkflow;
 
 /**
@@ -515,3 +518,13 @@ export interface WorkerBindingPipeline {
   /** Pipeline name */
   pipeline: string;
 }
+
+/**
+ * Worker Loader binding type
+ */
+export interface WorkerBindingWorkerLoader {
+  /** The name of the binding */
+  name: string;
+  /** Type identifier for Worker Loader binding */
+  type: "worker_loader";
+}

package/src/cloudflare/bound.ts

@@ -4,6 +4,7 @@ import type {
   D1Database,
   DispatchNamespace,
   DurableObjectNamespace,
+  WorkerLoader,
   Fetcher,
   Hyperdrive,
   ImagesBinding,
@@ -43,6 +44,7 @@ import type { VersionMetadata as _VersionMetadata } from "./version-metadata.ts"
 import type { WorkerRef } from "./worker-ref.ts";
 import type { WorkerStub } from "./worker-stub.ts";
 import type { Worker as _Worker } from "./worker.ts";
+import type { WorkerLoader as _WorkerLoader } from "./worker-loader.ts";
 import type { Workflow as _Workflow } from "./workflow.ts";
 
 type BoundWorker<
@@ -86,35 +88,37 @@ export type Bound<T extends Binding> = T extends _DurableObjectNamespace<
                           ? D1Database
                           : T extends DispatchNamespace
                             ? DispatchNamespace
-                            : T extends _VectorizeIndex
-                              ? VectorizeIndex
-                              : T extends _Queue<infer Body>
-                                ? Queue<Body>
-                                : T extends _AnalyticsEngineDataset
-                                  ? AnalyticsEngineDataset
-                                  : T extends _Pipeline<infer R>
-                                    ? Pipeline<R>
-                                    : T extends _RateLimit
-                                      ? RateLimit
-                                      : T extends string
-                                        ? T
-                                        : T extends BrowserRendering
-                                          ? Fetcher
-                                          : T extends _Ai<infer M>
-                                            ? Ai<M>
-                                            : T extends _Images
-                                              ? ImagesBinding
-                                              : T extends _VersionMetadata
-                                                ? WorkerVersionMetadata
-                                                : T extends Self
-                                                  ? Service
-                                                  : T extends Json<infer T>
-                                                    ? T
-                                                    : T extends _Container<
-                                                          infer Obj
-                                                        >
-                                                      ? DurableObjectNamespace<
-                                                          Obj &
-                                                            Rpc.DurableObjectBranded
-                                                        >
-                                                      : Service;
+                            : T extends _WorkerLoader
+                              ? WorkerLoader
+                              : T extends _VectorizeIndex
+                                ? VectorizeIndex
+                                : T extends _Queue<infer Body>
+                                  ? Queue<Body>
+                                  : T extends _AnalyticsEngineDataset
+                                    ? AnalyticsEngineDataset
+                                    : T extends _Pipeline<infer R>
+                                      ? Pipeline<R>
+                                      : T extends _RateLimit
+                                        ? RateLimit
+                                        : T extends string
+                                          ? T
+                                          : T extends BrowserRendering
+                                            ? Fetcher
+                                            : T extends _Ai<infer M>
+                                              ? Ai<M>
+                                              : T extends _Images
+                                                ? ImagesBinding
+                                                : T extends _VersionMetadata
+                                                  ? WorkerVersionMetadata
+                                                  : T extends Self
+                                                    ? Service
+                                                    : T extends Json<infer T>
+                                                      ? T
+                                                      : T extends _Container<
+                                                            infer Obj
+                                                          >
+                                                        ? DurableObjectNamespace<
+                                                            Obj &
+                                                              Rpc.DurableObjectBranded
+                                                          >
+                                                        : Service;

package/src/cloudflare/bucket.ts

@@ -347,6 +347,13 @@ type _R2Bucket = Omit<BucketProps, "delete" | "dev"> & {
      * Whether the bucket is running remotely
      */
     remote: boolean;
+
+    /**
+     * Whether the bucket has been deployed
+     *
+     * @internal
+     */
+    isDeployed?: boolean;
   };
 
   /**
@@ -587,15 +594,17 @@ const _R2Bucket = Resource(
     }
 
     const allowPublicAccess = props.allowPublicAccess === true;
+    const isLocal = this.scope.local && !props.dev?.remote;
     const dev = {
       id: this.output?.dev?.id ?? bucketName,
       remote: props.dev?.remote ?? false,
-    };
+      isDeployed: this.output?.dev?.isDeployed || !isLocal,
+    } satisfies _R2Bucket["dev"];
     const adopt = props.adopt ?? this.scope.adopt;
 
-    if (this.scope.local && !props.dev?.remote) {
+    if (isLocal) {
       return {
-        name: this.output?.name ?? "",
+        name: bucketName,
         location: this.output?.location ?? "",
         creationDate: this.output?.creationDate ?? new Date(),
         jurisdiction: this.output?.jurisdiction ?? "default",
@@ -626,7 +635,7 @@ const _R2Bucket = Resource(
       return this.destroy();
     }
 
-    if (this.phase === "create" || !this.output?.name) {
+    if (this.phase === "create" || !this.output?.dev?.isDeployed) {
       const bucket = await createBucket(api, bucketName, props).catch(
         async (err) => {
           if (

package/src/cloudflare/bun-spa/bun-spa.ts

@@ -15,7 +15,12 @@ import {
 } from "../website.ts";
 
 export interface BunSPAProps<B extends Bindings> extends WebsiteProps<B> {
-  frontend: string;
+  /**
+   * The path to the frontend entrypoints that bun should bundle for deployment & serve in dev mode.
+   * These are usually html files. Glob patterns are supported.
+   * Typically set to index.html
+   */
+  frontend: string | string[];
   outDir?: string;
 }
 
@@ -25,15 +30,39 @@ export async function BunSPA<B extends Bindings>(
   id: string,
   props: BunSPAProps<B>,
 ): Promise<BunSPA<B> & { apiUrl: string }> {
-  const frontendPath = path.resolve(props.frontend);
-  if (!(await exists(frontendPath))) {
-    throw new Error(`Frontend path ${frontendPath} does not exist`);
-  }
+  const frontendPaths = Array.isArray(props.frontend)
+    ? props.frontend.map((p) => path.resolve(p))
+    : [path.resolve(props.frontend)];
+
+  // Helper to check if a path contains glob patterns
+  const isGlobPattern = (p: string) =>
+    p.includes("*") || p.includes("?") || p.includes("[") || p.includes("]");
+
+  // Only validate non-glob paths
+  const nonGlobPaths = frontendPaths.filter((p) => !isGlobPattern(p));
 
-  const stats = await fs.stat(frontendPath);
-  if (!stats.isFile()) {
-    throw new Error(`Frontend path ${frontendPath} is not a file`);
+  if (nonGlobPaths.length > 0) {
+    const existsPromises = nonGlobPaths.map((p) => exists(p));
+    const existsResults = await Promise.all(existsPromises);
+    const missingPaths = nonGlobPaths.filter((_p, i) => !existsResults[i]);
+    if (missingPaths.length > 0) {
+      if (missingPaths.length === 1) {
+        throw new Error(`Frontend path ${missingPaths[0]} does not exist`);
+      }
+      throw new Error(`Frontend paths ${missingPaths.join(", ")} do not exist`);
+    }
+
+    const statsPromises = nonGlobPaths.map((p) => fs.stat(p));
+    const statsResults = await Promise.all(statsPromises);
+    const notFiles = nonGlobPaths.filter((_, i) => !statsResults[i].isFile());
+    if (notFiles.length > 0) {
+      if (notFiles.length === 1) {
+        throw new Error(`Frontend path ${notFiles[0]} is not a file`);
+      }
+      throw new Error(`Frontend paths ${notFiles.join(", ")} are not files`);
+    }
   }
+
   const outDir = path.resolve(props.outDir ?? "dist/client");
 
   if (props.assets) {
@@ -58,7 +87,7 @@ export async function BunSPA<B extends Bindings>(
     },
     build: spreadBuildProps(
       props,
-      `bun build '${frontendPath}' --outdir ${outDir}`,
+      `bun build '${frontendPaths.join("' '")}' --outdir ${outDir}`,
     ),
   });
 
@@ -67,9 +96,12 @@ export async function BunSPA<B extends Bindings>(
   if (scope.local) {
     const cwd = props.cwd ?? process.cwd();
     await validateBunfigToml(cwd);
+    const frontendPathsRelativeToCwd = frontendPaths.map((p) =>
+      path.relative(cwd, p),
+    );
     const dev = spreadDevProps(
       props,
-      `bun '${path.relative(cwd, frontendPath)}'`,
+      `bun '${frontendPathsRelativeToCwd.join("' '")}'`,
     );
     const secrets = props.wrangler?.secrets ?? !props.wrangler?.path;
     const env = {

package/src/cloudflare/compatibility-date.gen.ts

@@ -4,4 +4,4 @@
 /**
  * The default Cloudflare Workers compatibility date, set based on the latest workerd release at the time of build.
  */
-export const DEFAULT_COMPATIBILITY_DATE = "2025-10-01";
+export const DEFAULT_COMPATIBILITY_DATE = "2025-10-08";

package/src/cloudflare/index.ts

@@ -36,6 +36,7 @@ export * from "./hyperdrive-ref.ts";
 export * from "./hyperdrive.ts";
 export * from "./images.ts";
 export * from "./kv-namespace.ts";
+export * from "./logpush-job.ts";
 export * from "./next.ts";
 export * from "./nuxt/nuxt.ts";
 export * from "./orange.ts";
@@ -69,5 +70,6 @@ export * from "./worker-stub.ts";
 export * from "./worker-subdomain.ts";
 export * from "./worker.ts";
 export { Workflow } from "./workflow.ts";
+export { WorkerLoader } from "./worker-loader.ts";
 export * from "./wrangler.json.ts";
 export * from "./zone.ts";