alchemy 0.83.0 → 0.83.2

package/src/cloudflare/astro/plugin.ts

@@ -7,13 +7,27 @@ const isAstroCheck =
   process.argv.includes("check");
 
 const alchemy = (options?: Options): AstroIntegration => {
-  return cloudflare({
+  const integration = cloudflare({
     platformProxy: getPlatformProxyOptions(
       options?.platformProxy,
       !isAstroCheck,
     ),
     ...options,
   });
+  const setup = integration.hooks["astro:config:setup"];
+  integration.hooks["astro:config:setup"] = async (options) => {
+    options.updateConfig({
+      vite: {
+        server: {
+          watch: {
+            ignored: ["**/.alchemy/**"],
+          },
+        },
+      },
+    });
+    await setup?.(options);
+  };
+  return integration;
 };
 
 export default alchemy;

package/src/cloudflare/bucket-custom-domain.ts

@@ -13,8 +13,7 @@ import { inferZoneIdFromPattern } from "./route.ts";
 import type { Zone } from "./zone.ts";
 
 export interface R2BucketCustomDomainProps
-  extends CloudflareApiOptions,
-    R2BucketCustomDomainOptions {
+  extends CloudflareApiOptions, R2BucketCustomDomainOptions {
   /**
    * The bucket to attach the domain to.
    */

package/src/cloudflare/bucket.ts

@@ -546,7 +546,9 @@ export async function R2Bucket(
       options?: Pick<R2PutOptions, "httpMetadata">,
     ): Promise<PutR2ObjectResponse> => {
       if (isLocal) {
-        return await (await localBucket()).put(
+        return await (
+          await localBucket()
+        ).put(
           key,
           typeof value === "string"
             ? value
@@ -1331,7 +1333,12 @@ function mapHeadersToHttpMetadata(headers: Headers): R2HTTPMetadata {
 
 export async function putObject(
   api: CloudflareApi,
-  { bucketName, key, object, options }: {
+  {
+    bucketName,
+    key,
+    object,
+    options,
+  }: {
     bucketName: string;
     key: string;
     object: PutObjectObject;

package/src/cloudflare/bundle/plugin-wasm.ts

@@ -1,5 +1,6 @@
 import type esbuild from "esbuild";
 import assert from "node:assert";
+import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "pathe";
 import type { WorkerBundle } from "../worker-bundle.ts";
@@ -35,11 +36,9 @@ export function createWasmPlugin() {
           build.initialOptions.outdir,
         );
 
-        // Use relative path as module specifier for portability (note: the `?module` suffix is not needed in workerd)
-        const specifier = path.relative(
-          build.initialOptions.absWorkingDir,
-          copyFrom,
-        );
+        // Use path hash as module specifier for portability (note: the `?module` suffix is not needed in workerd)
+        const hash = crypto.createHash("sha256").update(copyFrom).digest("hex");
+        const specifier = `${hash}.wasm`;
 
         // Copy to outdir so it's included in the upload
         const copyTo = path.join(outdir, specifier);

package/src/cloudflare/container.ts

@@ -16,7 +16,8 @@ import {
  * for Cloudflare API authentication.
  */
 export interface ContainerProps
-  extends Omit<ImageProps, "registry" | "skipPush">,
+  extends
+    Omit<ImageProps, "registry" | "skipPush">,
     Partial<CloudflareApiOptions> {
   /**
    * The class name for the container binding.
@@ -890,7 +891,7 @@ export async function createContainerApplication(
     return result.result;
   }
 
-  const error = result.errors.find((e) => e.code === 1000);
+  const error = result.errors.find((e) => e.code === 1608);
   if (error) {
     // WEIRD: json-encoded error message - might change when they release an official API
     const errorMessage = JSON.parse(error.message) as {
@@ -938,7 +939,7 @@ export async function createContainerApplication(
   }
 
   throw Error(
-    `Failed to create container application: ${result.errors?.map((e: { message: string }) => e.message).join(", ") ?? "Unknown error"}`,
+    `Failed to create container application: ${result.errors?.map((e) => `[${e.code}] ${e.message}`).join(", ") ?? "Unknown error"}`,
   );
 }
 type Region =

package/src/cloudflare/dispatch-namespace.ts

@@ -45,8 +45,10 @@ export function isDispatchNamespace(
 /**
  * Output returned after Dispatch Namespace creation/update
  */
-export interface DispatchNamespace
-  extends Omit<DispatchNamespaceProps, "delete"> {
+export interface DispatchNamespace extends Omit<
+  DispatchNamespaceProps,
+  "delete"
+> {
   type: "dispatch_namespace";
   /**
    * The name of the namespace

package/src/cloudflare/hyperdrive.ts

@@ -210,6 +210,12 @@ export interface HyperdriveProps extends CloudflareApiOptions {
      * @default origin
      */
     origin?: HyperdriveOriginInput;
+
+    /**
+     * Whether to run the hyperdrive remotely instead of locally
+     * @default false
+     */
+    remote?: boolean;
   };
 }
 
@@ -247,6 +253,11 @@ export type Hyperdrive = Omit<HyperdriveProps, "origin" | "dev"> & {
      * The connection string to use for local development
      */
     origin: Secret;
+
+    /**
+     * Whether the hyperdrive is running remotely
+     */
+    remote: boolean;
   };
 
   /**
@@ -333,6 +344,22 @@ export type Hyperdrive = Omit<HyperdriveProps, "origin" | "dev"> & {
  *     user: "postgres"
  *   }
  * });
+ *
+ * @example
+ * // Create a Hyperdrive that runs remotely even in local dev mode
+ * const remoteDevHyperdrive = await Hyperdrive("remote-dev-db", {
+ *   name: "remote-dev-db",
+ *   origin: {
+ *     database: "postgres",
+ *     host: "database.example.com",
+ *     password: alchemy.secret(process.env.DB_PASSWORD),
+ *     port: 5432,
+ *     user: "postgres"
+ *   },
+ *   dev: {
+ *     remote: true
+ *   }
+ * });
  */
 export async function Hyperdrive(
   id: string,
@@ -343,6 +370,7 @@ export async function Hyperdrive(
     origin: toConnectionString(
       normalizeHyperdriveOrigin(props.dev?.origin ?? origin),
     ),
+    remote: props.dev?.remote ?? false,
     force: Scope.current.local,
   };
   return await _Hyperdrive(id, {
@@ -364,6 +392,7 @@ interface InternalHyperdriveProps extends CloudflareApiOptions {
   mtls?: HyperdriveMtls;
   dev: {
     origin: Secret;
+    remote?: boolean;
     force?: boolean;
   };
   adopt?: boolean;
@@ -382,7 +411,7 @@ const _Hyperdrive = Resource(
     const name =
       props.name ?? this.output?.name ?? this.scope.createPhysicalName(id);
 
-    if (this.scope.local) {
+    if (this.scope.local && !props.dev?.remote) {
       return {
         id,
         hyperdriveId: hyperdriveId || "",
@@ -390,7 +419,10 @@ const _Hyperdrive = Resource(
         origin: props.origin,
         caching: props.caching,
         mtls: props.mtls,
-        dev: props.dev,
+        dev: {
+          origin: props.dev.origin,
+          remote: false,
+        },
         type: "hyperdrive",
       };
     }
@@ -485,7 +517,10 @@ const _Hyperdrive = Resource(
       origin: props.origin,
       caching: result.caching,
       mtls: result.mtls,
-      dev: props.dev,
+      dev: {
+        origin: props.dev.origin,
+        remote: props.dev.remote ?? false,
+      },
       type: "hyperdrive",
     };
   },

package/src/cloudflare/index.ts

@@ -41,6 +41,7 @@ export * from "./hyperdrive.ts";
 export * from "./images.ts";
 export * from "./kv-namespace.ts";
 export * from "./logpush-job.ts";
+export * from "./miniflare/miniflare-controller.ts";
 export * from "./next.ts";
 export * from "./nuxt/nuxt.ts";
 export * from "./orange.ts";

package/src/cloudflare/logpush-job.ts

@@ -349,7 +349,7 @@ const _LogPushJob = Resource(
   "cloudflare::LogPushJob",
   async function (
     this: Context<LogPushJob>,
-    _id: string,
+    id: string,
     props: Omit<LogPushJobProps, "destination"> & {
       destination: Secret<string> | R2Bucket;
     },
@@ -424,15 +424,22 @@ const _LogPushJob = Resource(
           accessKeyId = apiToken.accessKeyId.unencrypted;
           secretAccessKey = apiToken.secretAccessKey.unencrypted;
         } catch (err) {
-          console.error(err);
-          console.warn(
-            "[Cloudflare Logpush Job] Warning: Cloudflare currently only allows the use of a Global API Key or an API Token with permission to create other API Tokens in order to generate new API Tokens programmatically.\n" +
-              "Please use your Global API Key, or create an API Token with the necessary permissions. For more information, see: https://alchemy.run/guides/cloudflare/#api-token",
-          );
-          throw new Error(
-            "Unable to create an API Token: Cloudflare only allows Global API Key or an API Token with permission to create other API Tokens. " +
-              "See https://alchemy.run/guides/cloudflare/#api-token for more details.",
+          const message = [
+            `Cannot create LogPushJob "${id}" because credentials for destination R2 bucket "${bucket.name}" could not be created. This may be because of an authentication error.`,
+          ];
+          if (api.credentials.type === "api-token") {
+            message.push(
+              "Please ensure that your API token has the correct permissions, or use a global API key and email instead.",
+            );
+          } else if (api.credentials.type === "oauth") {
+            message.push(
+              "Please use a global API key and email, or create an API token with the necessary permissions.",
+            );
+          }
+          message.push(
+            "See https://alchemy.run/guides/cloudflare/ for more details.",
           );
+          throw new Error(message.join("\n"), { cause: err });
         }
       }
 
@@ -523,10 +530,6 @@ const _LogPushJob = Resource(
       },
       // if we just recently created an api token for R2, we can retry on 1002 which are caused by token propagation
       (error: CloudflareApiError) => {
-        console.warn(
-          "Received error when creating LogPush job, there may be a propagation delay",
-          error.message,
-        );
         return error.errorData?.[0]?.code === 1002;
       },
       30,

package/src/cloudflare/queue-consumer.ts

@@ -20,7 +20,7 @@ export interface QueueConsumerSettings {
 
   /**
    * Maximum number of concurrent consumer worker invocations
-   * @default 2
+   * @default undefined
    */
   maxConcurrency?: number;
 
@@ -32,7 +32,7 @@ export interface QueueConsumerSettings {
 
   /**
    * Maximum time in milliseconds to wait for batch to fill
-   * @default 500
+   * @default 5_000
    */
   maxWaitTimeMs?: number;
 

package/src/cloudflare/ruleset.ts

@@ -12,8 +12,9 @@ import { findZoneForHostname, type Zone } from "./zone.ts";
 /**
  * Properties for creating or updating a Ruleset
  */
-export interface RulesetProps<Phase extends RulePhase>
-  extends Partial<CloudflareApiOptions> {
+export interface RulesetProps<
+  Phase extends RulePhase,
+> extends Partial<CloudflareApiOptions> {
   /**
    * The zone to apply the ruleset to
    */

package/src/cloudflare/tunnel-route.ts

@@ -88,8 +88,10 @@ export function isTunnelRoute(resource: any): resource is TunnelRoute {
 /**
  * Output returned after TunnelRoute creation/update
  */
-export interface TunnelRoute
-  extends Omit<TunnelRouteProps, "delete" | "tunnel" | "routeId"> {
+export interface TunnelRoute extends Omit<
+  TunnelRouteProps,
+  "delete" | "tunnel" | "routeId"
+> {
   /**
    * The ID of the route
    */

package/src/cloudflare/website.ts

@@ -18,8 +18,10 @@ import { computeWorkerDevDomain } from "./worker-subdomain.ts";
 import { type AssetsConfig, Worker, type WorkerProps } from "./worker.ts";
 import { WranglerJson, type WranglerJsonSpec } from "./wrangler.json.ts";
 
-export interface WebsiteProps<B extends Bindings>
-  extends Omit<WorkerProps<B>, "assets" | "dev"> {
+export interface WebsiteProps<B extends Bindings> extends Omit<
+  WorkerProps<B>,
+  "assets" | "dev"
+> {
   /**
    * Configuration for the build command
    *

package/src/cloudflare/worker-assets.ts

@@ -31,7 +31,12 @@ interface FileMetadata {
  */
 export async function uploadAssets(
   api: CloudflareApi,
-  { workerName, assets, assetConfig, namespace }: {
+  {
+    workerName,
+    assets,
+    assetConfig,
+    namespace,
+  }: {
     workerName: string;
     assets: Assets;
     assetConfig?: WorkerProps["assets"];

package/src/cloudflare/worker-bundle.ts

@@ -242,7 +242,8 @@ export namespace WorkerBundleSource {
   }
 
   export interface ESBuildProps
-    extends WorkerBundleSource.BaseProps,
+    extends
+      WorkerBundleSource.BaseProps,
       Omit<
         esbuild.BuildOptions,
         "entryPoints" | "format" | "absWorkingDir" | "outdir"

package/src/cloudflare/worker-metadata.ts

@@ -24,6 +24,7 @@ import {
   isWorker,
   Worker,
   type AssetsConfig,
+  type WorkerPlacement,
   type WorkerProps,
 } from "./worker.ts";
 
@@ -217,9 +218,7 @@ export interface WorkerMetadata {
     suspended: boolean;
   }[];
   containers?: { class_name: string }[];
-  placement?: {
-    mode: "smart";
-  };
+  placement?: WorkerPlacement;
   limits?: {
     cpu_ms?: number;
   };
@@ -240,9 +239,7 @@ export async function prepareWorkerMetadata(
     };
     tags?: string[];
     unstable_cacheWorkerSettings?: boolean;
-    placement?: {
-      mode: "smart";
-    };
+    placement?: WorkerPlacement;
   },
 ): Promise<WorkerMetadata> {
   const oldSettings = await (

package/src/cloudflare/worker.ts

@@ -365,22 +365,16 @@ export interface BaseWorkerProps<
       };
 
   /**
-   * Smart placement configuration for the worker.
+   * Placement configuration for the worker.
    *
-   * Controls how Cloudflare places the worker across its network for optimal performance.
+   * Controls where your Worker runs to reduce latency to back-end infrastructure.
+   * Only one placement option can be specified (mutually exclusive).
    *
-   * When omitted, smart placement is disabled (default behavior).
+   * When omitted, the Worker runs in the data center closest to the incoming request.
+   *
+   * @see https://developers.cloudflare.com/workers/configuration/smart-placement/
    */
-  placement?: {
-    /**
-     * The placement mode for the worker.
-     *
-     * - "smart": Automatically optimize placement based on performance metrics
-     *
-     * @default undefined (smart placement disabled)
-     */
-    mode: "smart";
-  };
+  placement?: WorkerPlacement;
 
   limits?: {
     /**
@@ -477,6 +471,136 @@ export interface WorkerObservability {
   };
 }
 
+/**
+ * Worker placement configuration for controlling where your Worker runs.
+ *
+ * Only one placement option can be specified at a time (mutually exclusive).
+ *
+ * @see https://developers.cloudflare.com/workers/configuration/smart-placement/
+ */
+export type WorkerPlacement =
+  | WorkerPlacementSmart
+  | WorkerPlacementRegion
+  | WorkerPlacementHost
+  | WorkerPlacementHostname;
+
+/**
+ * Smart placement mode - Cloudflare automatically places your Worker
+ * closest to the upstream with the most requests.
+ *
+ * Use when your Worker connects to multiple back-end services or you
+ * don't know the exact location of your infrastructure.
+ *
+ * @example
+ * ```ts
+ * const worker = await Worker("api", {
+ *   entrypoint: "./src/worker.ts",
+ *   placement: { mode: "smart" }
+ * });
+ * ```
+ */
+export interface WorkerPlacementSmart {
+  /**
+   * Enable smart placement mode.
+   *
+   * Cloudflare automatically analyzes your Worker's traffic patterns and
+   * places it in an optimal location based on performance metrics.
+   */
+  mode: "smart";
+}
+
+/**
+ * Region-based placement - place your Worker closest to a specific
+ * cloud provider region.
+ *
+ * Use when your back-end infrastructure runs in a known AWS, GCP, or Azure region.
+ *
+ * @example
+ * ```ts
+ * const worker = await Worker("api", {
+ *   entrypoint: "./src/worker.ts",
+ *   placement: { region: "aws:us-east-1" }
+ * });
+ * ```
+ */
+export interface WorkerPlacementRegion {
+  /**
+   * Cloud provider region to place your Worker closest to.
+   *
+   * Format: `{provider}:{region}`
+   *
+   * Supported providers:
+   * - AWS: `aws:us-east-1`, `aws:us-west-2`, `aws:eu-central-1`, etc.
+   * - GCP: `gcp:us-east4`, `gcp:europe-west1`, `gcp:asia-east1`, etc.
+   * - Azure: `azure:westeurope`, `azure:eastus`, `azure:southeastasia`, etc.
+   *
+   * @see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html
+   * @see https://cloud.google.com/compute/docs/regions-zones
+   * @see https://learn.microsoft.com/en-us/azure/reliability/regions-list
+   *
+   * @example "aws:us-east-1"
+   * @example "gcp:us-east4"
+   * @example "azure:westeurope"
+   */
+  region: string;
+}
+
+/**
+ * Host-based placement (layer 4) - place your Worker closest to a specific
+ * TCP endpoint.
+ *
+ * Use when your infrastructure is not in a major cloud provider and you need
+ * to probe a TCP service (like a database) to determine optimal placement.
+ *
+ * @example
+ * ```ts
+ * const worker = await Worker("api", {
+ *   entrypoint: "./src/worker.ts",
+ *   placement: { host: "my-database.example.com:5432" }
+ * });
+ * ```
+ */
+export interface WorkerPlacementHost {
+  /**
+   * Host endpoint to probe (TCP/layer 4) for placement.
+   *
+   * Cloudflare uses TCP CONNECT checks to measure latency and selects
+   * the best data center. Use this for database hosts or other TCP services.
+   *
+   * Format: `hostname:port`
+   *
+   * @example "my_database_host.com:5432"
+   */
+  host: string;
+}
+
+/**
+ * Hostname-based placement (layer 7) - place your Worker closest to a specific
+ * HTTP endpoint.
+ *
+ * Use when your infrastructure is not in a major cloud provider and you need
+ * to probe an HTTP service (like an API) to determine optimal placement.
+ *
+ * @example
+ * ```ts
+ * const worker = await Worker("api", {
+ *   entrypoint: "./src/worker.ts",
+ *   placement: { hostname: "my-api.example.com" }
+ * });
+ * ```
+ */
+export interface WorkerPlacementHostname {
+  /**
+   * Hostname to probe (HTTP/layer 7) for placement.
+   *
+   * Cloudflare uses HTTP HEAD checks to measure latency and selects
+   * the best data center. Use this for API endpoints or other HTTP services.
+   *
+   * @example "my_api_server.com"
+   */
+  hostname: string;
+}
+
 export interface InlineWorkerProps<
   B extends Bindings | undefined = Bindings,
   RPC extends Rpc.WorkerEntrypointBranded = Rpc.WorkerEntrypointBranded,
@@ -630,11 +754,9 @@ export type Worker<
   version?: string;
 
   /**
-   * Smart placement configuration for the worker
+   * Placement configuration for the worker
    */
-  placement?: {
-    mode: "smart";
-  };
+  placement?: WorkerPlacement;
 
   /**
    * Whether the worker has a remote deployment

package/src/cloudflare/zone-settings.ts

@@ -89,8 +89,7 @@ export interface AutomaticHTTPSRewritesSetting extends CloudflareSettingBase {
 /**
  * Automatic Platform Optimization setting
  */
-export interface AutomaticPlatformOptimizationSetting
-  extends CloudflareSettingBase {
+export interface AutomaticPlatformOptimizationSetting extends CloudflareSettingBase {
   id: "automatic_platform_optimization";
   value: {
     enabled: boolean;

package/src/coinbase/evm-smart-account.ts

@@ -48,8 +48,7 @@ export interface EvmSmartAccountProps extends CoinbaseClientOptions {
   faucet?: FaucetConfig;
 }
 
-export interface EvmSmartAccount
-  extends Resource<"coinbase::evm-smart-account"> {
+export interface EvmSmartAccount extends Resource<"coinbase::evm-smart-account"> {
   /**
    * The smart account name in CDP
    */

package/src/coinbase/faucet.ts

@@ -141,7 +141,9 @@ for (const account of accounts) {
 
       // Skip if already processed in this run
       if (funded.has(key)) {
-        console.log(`  ⏭️  Skipping ${token} on ${network} (already requested)`);
+        console.log(
+          `  ⏭️  Skipping ${token} on ${network} (already requested)`,
+        );
         continue;
       }
 

package/src/context.ts

@@ -17,8 +17,9 @@ export type Context<
   Props extends ResourceProps = ResourceProps,
 > = CreateContext<Out> | UpdateContext<Out, Props> | DeleteContext<Out, Props>;
 
-export interface CreateContext<Out extends ResourceAttributes>
-  extends BaseContext<Out> {
+export interface CreateContext<
+  Out extends ResourceAttributes,
+> extends BaseContext<Out> {
   phase: "create";
   output?: undefined;
   props?: undefined;

package/src/esbuild/bundle.ts

@@ -73,8 +73,9 @@ export interface BundleProps extends Partial<esbuild.BuildOptions> {
 /**
  * Output returned after bundle creation/update
  */
-export interface Bundle<P extends BundleProps = BundleProps>
-  extends BundleProps {
+export interface Bundle<
+  P extends BundleProps = BundleProps,
+> extends BundleProps {
   /**
    * Path to the bundled file
    * Absolute or relative path to the generated bundle