alchemy 0.93.11 → 0.94.0

package/src/cloudflare/miniflare/remote-binding-proxy.ts

@@ -21,12 +21,6 @@ type WranglerSessionConfig =
       minimal_mode: boolean;
     };
 
-interface WorkersPreviewSession {
-  inspector_websocket: string;
-  prewarm: string;
-  token: string;
-}
-
 export interface RemoteBindingProxy {
   server: HTTPServer;
   bindings: WorkerBindingSpec[];
@@ -135,7 +129,7 @@ async function createWorkersPreviewToken(
     session: WranglerSessionConfig;
   },
 ) {
-  const session = await createWorkersPreviewSession(api);
+  const previewUploadToken = await createPreviewUploadToken(api);
   const formData = await WorkerBundle.toFormData(input.bundle);
   formData.append("metadata", JSON.stringify(input.metadata));
   formData.append("wrangler-session-config", JSON.stringify(input.session));
@@ -146,59 +140,42 @@ async function createWorkersPreviewToken(
       formData,
       {
         headers: {
-          "cf-preview-upload-config-token": session.token,
+          "cf-preview-upload-config-token": previewUploadToken,
         },
       },
     ),
   );
-  // Fire and forget prewarm call
-  // (see https://github.com/cloudflare/workers-sdk/blob/6c6afbd6072b96e78e67d3a863ed849c6aa49472/packages/wrangler/src/dev/create-worker-preview.ts#L338)
-  void prewarm(session.prewarm, res.preview_token);
   return res.preview_token;
 }
 
-async function prewarm(url: string, previewToken: string) {
-  try {
-    // Pass the preview token to the Access probe — prewarm targets a preview
-    // worker URL, which only surfaces an Access 302 when the request carries
-    // the preview token.
-    const accessToken = await getAccessToken(
-      new URL(url).hostname,
-      previewToken,
-    );
-    await fetch(url, {
-      method: "POST",
-      headers: {
-        "cf-workers-preview-token": previewToken,
-        ...(accessToken ? { cookie: `CF_Authorization=${accessToken}` } : {}),
-      },
-    });
-  } catch {
-    // Ignore prewarm errors
-  }
-}
-
-async function createWorkersPreviewSession(api: CloudflareApi) {
-  const { exchange_url } = await extractCloudflareResult<{
-    exchange_url: string;
+async function createPreviewUploadToken(api: CloudflareApi) {
+  const { token, exchange_url } = await extractCloudflareResult<{
+    exchange_url: string | null | undefined;
     token: string;
   }>(
     "create workers preview session",
     api.get(`/accounts/${api.accountId}/workers/subdomain/edge-preview`),
   );
+  if (!exchange_url) {
+    return token;
+  }
   const accessToken = await getAccessToken(new URL(exchange_url).hostname);
-  const res = await fetch(exchange_url, {
+  const json = await fetch(exchange_url, {
     headers: {
       ...(accessToken ? { cookie: `CF_Authorization=${accessToken}` } : {}),
     },
-  });
-  if (!res.ok) {
-    throw new Error(
-      `Failed to create workers preview session: ${res.status} ${res.statusText}`,
-    );
+  })
+    .then((res) => res.json())
+    .catch(() => undefined);
+  if (
+    typeof json === "object" &&
+    json !== null &&
+    "token" in json &&
+    typeof json.token === "string"
+  ) {
+    return json.token;
   }
-  const json: WorkersPreviewSession = await res.json();
-  return json;
+  return token;
 }
 
 /**

package/src/cloudflare/worker-metadata.ts

@@ -206,6 +206,17 @@ export interface WorkerMetadata {
     };
   };
   logpush?: boolean;
+  /**
+   * Workers Cache configuration.
+   *
+   * The wire shape matches what wrangler (>= 4.69) uploads.
+   *
+   * @see https://developers.cloudflare.com/workers/cache/configuration/
+   */
+  cache_options?: {
+    enabled: boolean;
+    cross_version_cache?: boolean;
+  };
   migrations?: SingleStepMigration;
   main_module?: string;
   body_part?: string;
@@ -355,6 +366,19 @@ export async function prepareWorkerMetadata(
       enabled: observability?.enabled !== false,
     },
     logpush: props.logpush ?? false,
+    cache_options:
+      props.cache != null
+        ? {
+            enabled:
+              typeof props.cache === "boolean"
+                ? props.cache
+                : (props.cache.enabled ?? true),
+            cross_version_cache:
+              typeof props.cache === "object"
+                ? props.cache.crossVersionCache
+                : undefined,
+          }
+        : undefined,
     // TODO(sam): base64 encode instead? 0 collision risk vs readability.
     tags: [
       // encode a mapping table of Durable Object stable ID -> binding name
@@ -516,6 +540,12 @@ export async function prepareWorkerMetadata(
         jurisdiction:
           binding.jurisdiction === "default" ? undefined : binding.jurisdiction,
       });
+    } else if (binding.type === "artifacts") {
+      meta.bindings.push({
+        type: "artifacts",
+        name: bindingName,
+        namespace: binding.namespace,
+      });
     } else if (binding.type === "send_email") {
       meta.bindings.push({
         type: "send_email",
@@ -597,7 +627,9 @@ export async function prepareWorkerMetadata(
       meta.bindings.push({
         type: "json",
         name: bindingName,
-        json: JSON.stringify(binding.json),
+        // send the raw value (like wrangler does) so the runtime injects the
+        // native type; stringifying here would inject a string instead
+        json: binding.json,
       });
     } else if (binding.type === "analytics_engine") {
       meta.bindings.push({

package/src/cloudflare/worker.ts

@@ -249,6 +249,21 @@ export interface BaseWorkerProps<
    */
   assets?: AssetsConfig;
 
+  /**
+   * Enable Workers Cache — a Worker-owned edge cache in front of this Worker.
+   *
+   * When enabled, Cloudflare checks the cache before invoking the Worker and
+   * serves matching responses directly from the edge. Caching is controlled
+   * with standard response headers (`Cache-Control`, `Cache-Tag`, `Vary`) and
+   * entries can be purged at runtime with `ctx.cache.purge()`.
+   *
+   * Pass `true` as shorthand for `{ enabled: true }`.
+   *
+   * @see https://developers.cloudflare.com/workers/cache/
+   * @default undefined - Workers Cache is disabled
+   */
+  cache?: boolean | WorkerCacheOptions;
+
   /**
    * Cron expressions for the trigger.
    *
@@ -431,6 +446,31 @@ export interface BaseWorkerProps<
   tailConsumers?: Array<Worker | { service: string }>;
 }
 
+/**
+ * Configuration for Workers Cache — the edge cache that sits in front of a
+ * Worker's `fetch()` invocations.
+ *
+ * @see https://developers.cloudflare.com/workers/cache/configuration/
+ */
+export interface WorkerCacheOptions {
+  /**
+   * If Workers Cache is enabled for this Worker
+   *
+   * @default true
+   */
+  enabled?: boolean;
+
+  /**
+   * Whether cached responses may be reused across Worker versions.
+   *
+   * By default the cache is scoped to a single Worker version, so every
+   * deployment starts cold. Enable this when responses are version-agnostic.
+   *
+   * @default false
+   */
+  crossVersionCache?: boolean;
+}
+
 export interface WorkerObservability {
   /**
    * If observability is enabled for this Worker
@@ -1601,7 +1641,7 @@ async function provisionResources<B extends Bindings>(
             // In local dev mode, queue.id is "" (no Cloudflare API call).
             // Use queue.dev.id (resource ID, e.g. "email-queue") to avoid
             // all consumers colliding on the same "-consumer" resource ID.
-            // See: https://github.com/alchemy-run/alchemy/issues/1363
+            // See: https://github.com/alchemy-run/alchemy-async/issues/1363
             const queueConsumerId = options.local
               ? eventSource.queue.dev?.id || eventSource.queue.id
               : eventSource.queue.id;

package/src/cloudflare/wrangler.json.ts

@@ -264,6 +264,11 @@ async function processBindings(
   const kvNamespaces: WranglerJsonConfig["kv_namespaces"] = [];
   const durableObjects: WranglerJsonConfig["durable_objects"]["bindings"] = [];
   const r2Buckets: WranglerJsonConfig["r2_buckets"] = [];
+  const artifacts: {
+    binding: string;
+    namespace: string;
+    remote?: boolean;
+  }[] = [];
   const services: WranglerJsonConfig["services"] = [];
   const sendEmailBindings: WranglerJsonConfig["send_email"] = [];
   const secrets: string[] = [];
@@ -422,6 +427,12 @@ async function processBindings(
         allowed_sender_addresses: binding.allowedSenderAddresses,
         ...(binding.dev?.remote ? { remote: true } : {}),
       });
+    } else if (binding.type === "artifacts") {
+      artifacts.push({
+        binding: bindingName,
+        namespace: binding.namespace,
+        remote: binding.dev?.remote ?? true,
+      });
     } else if (binding.type === "secret") {
       // Secret binding
       secrets.push(bindingName);
@@ -598,6 +609,14 @@ async function processBindings(
     spec.r2_buckets = r2Buckets;
   }
 
+  if (artifacts.length > 0) {
+    (
+      spec as WranglerJsonSpec & {
+        artifacts?: typeof artifacts;
+      }
+    ).artifacts = artifacts;
+  }
+
   if (services.length > 0) {
     spec.services = services;
   }

package/src/cloudflare/zone.ts

@@ -415,7 +415,7 @@ export const Zone = Resource(
 
     // Add a small delay to ensure settings are propagated
     // TODO(michael): do we need this?
-    // https://github.com/alchemy-run/alchemy/issues/681
+    // https://github.com/alchemy-run/alchemy-async/issues/681
     await new Promise((resolve) => setTimeout(resolve, 2000));
 
     // Update Bot Management configuration if provided

package/src/scope.ts

@@ -324,7 +324,7 @@ export class Scope {
       destroyStrategy ?? this.parent?.destroyStrategy ?? "sequential";
     if (this.local) {
       this.logger.warnOnce(
-        "Development mode is in beta. Please report any issues to https://github.com/alchemy-run/alchemy/issues.",
+        "Development mode is in beta. Please report any issues to https://github.com/alchemy-run/alchemy-async/issues.",
       );
     }
 
@@ -652,7 +652,7 @@ export class Scope {
         throw e;
       })) ?? [];
 
-    //todo(michael): remove once we deprecate doss; see: https://github.com/alchemy-run/alchemy/issues/585
+    //todo(michael): remove once we deprecate doss; see: https://github.com/alchemy-run/alchemy-async/issues/585
     let hasCorruptedResources = false;
     if (pendingDeletions) {
       for (const { resource, oldProps } of pendingDeletions) {