alchemy 0.55.3 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.55.3",
+  "version": "0.57.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",
@@ -61,6 +61,34 @@
       "bun": "./src/cloudflare/index.ts",
       "import": "./lib/cloudflare/index.js"
     },
+    "./cloudflare/astro": {
+      "bun": "./src/cloudflare/astro/plugin.ts",
+      "import": "./lib/cloudflare/astro/plugin.js"
+    },
+    "./cloudflare/nuxt": {
+      "bun": "./src/cloudflare/nuxt/plugin.ts",
+      "import": "./lib/cloudflare/nuxt/plugin.js"
+    },
+    "./cloudflare/redwood": {
+      "bun": "./src/cloudflare/redwood/plugin.ts",
+      "import": "./lib/cloudflare/redwood/plugin.js"
+    },
+    "./cloudflare/react-router": {
+      "bun": "./src/cloudflare/react-router/plugin.ts",
+      "import": "./lib/cloudflare/react-router/plugin.js"
+    },
+    "./cloudflare/sveltekit": {
+      "bun": "./src/cloudflare/sveltekit/plugin.ts",
+      "import": "./lib/cloudflare/sveltekit/plugin.js"
+    },
+    "./cloudflare/tanstack-start": {
+      "bun": "./src/cloudflare/tanstack-start/plugin.ts",
+      "import": "./lib/cloudflare/tanstack-start/plugin.js"
+    },
+    "./cloudflare/vite": {
+      "bun": "./src/cloudflare/vite/plugin.ts",
+      "import": "./lib/cloudflare/vite/plugin.js"
+    },
     "./dns": {
       "bun": "./src/dns/index.ts",
       "import": "./lib/dns/index.js"
@@ -93,6 +121,10 @@
       "bun": "./src/planetscale/index.ts",
       "import": "./lib/planetscale/index.js"
     },
+    "./random": {
+      "bun": "./src/random/index.ts",
+      "import": "./lib/random/index.js"
+    },
     "./sentry": {
       "bun": "./src/sentry/index.ts",
       "import": "./lib/sentry/index.js"
@@ -143,7 +175,9 @@
     "@swc/core": "^1.11.24",
     "aws4fetch": "^1.0.20",
     "diff": "^8.0.2",
+    "env-paths": "^3.0.0",
     "esbuild": "^0.25.1",
+    "execa": "^9.6.0",
     "fast-json-patch": "^3.1.1",
     "fast-xml-parser": "^5.2.5",
     "glob": "^10.0.0",
@@ -155,10 +189,10 @@
     "open": "^10.1.2",
     "openapi-types": "^12.1.3",
     "pathe": "^2.0.3",
+    "signal-exit": "^4.1.0",
     "turndown": "^7.0.0",
     "unenv": "2.0.0-rc.15",
     "ws": "^8.18.3",
-    "xdg-app-paths": "^8.3.0",
     "yaml": "^2.0.0"
   },
   "peerDependencies": {
@@ -175,13 +209,13 @@
     "@aws-sdk/client-sqs": "^3.0.0",
     "@aws-sdk/client-ssm": "^3.0.0",
     "@aws-sdk/client-sts": "^3.0.0",
+    "@cloudflare/vite-plugin": "^1.10.1",
     "@libsql/client": "^0.15.9",
     "@octokit/rest": "^21.1.1",
     "ai": "^4.0.0",
     "arktype": "^2.0.0",
     "cloudflare": "^4.0.0",
     "drizzle-orm": "^0.44.2",
-    "execa": "^9.6.0",
     "hono": "^4.0.0",
     "prettier": "^3.0.0",
     "stripe": "^17.0.0"
@@ -198,6 +232,9 @@
     "@cloudflare/workers-types": "^4.20250620.0",
     "@iarna/toml": "^2.2.5",
     "@octokit/rest": "^21.1.1",
+    "@react-router/dev": "^7.7.1",
+    "@sveltejs/adapter-cloudflare": "^7.1.2",
+    "@sentry/cloudflare": "^9.43.0",
     "@types/bun": "latest",
     "@types/diff": "^5.0.0",
     "@types/fs-extra": "^11.0.4",
@@ -220,9 +257,11 @@
     "libsodium-wrappers": "^0.7.15",
     "listr2": "^8.0.0",
     "nitro-cloudflare-dev": "^0.2.2",
+    "nitropack": "^2.12.4",
     "openpgp": "^6.1.0",
     "picocolors": "^1.1.1",
     "prettier": "^3.5.3",
+    "rwsdk": "^0.1.28",
     "trpc-cli": "^0.10.0",
     "ts-morph": "^26.0.0",
     "tsdown": "^0.13.0",
@@ -232,7 +271,7 @@
     "typescript": "^5.8.3",
     "vite": "^6.0.7",
     "vitepress": "^1.6.3",
-    "wrangler": "^3.114.0",
+    "wrangler": "^4.27.0",
     "yaml": "^2.7.1",
     "zod": "^4.0.10"
   }

package/src/alchemy.ts

@@ -1,6 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 
+import { onExit } from "signal-exit";
 import { ReplacedSignal } from "./apply.ts";
 import { DestroyStrategy, DestroyedSignal, destroy } from "./destroy.ts";
 import { env } from "./env.ts";
@@ -172,6 +173,12 @@ async function _alchemy(
       password: mergedOptions?.password ?? process.env.ALCHEMY_PASSWORD,
       telemetryClient,
     });
+    onExit((code) => {
+      root.cleanup().then(() => {
+        process.exit(code);
+      });
+      return true;
+    });
     const stageName = mergedOptions?.stage ?? DEFAULT_STAGE;
     const stage = new Scope({
       ...mergedOptions,

package/src/apply.ts

@@ -15,7 +15,6 @@ import {
 } from "./resource.ts";
 import { Scope, type PendingDeletions } from "./scope.ts";
 import { serialize } from "./serde.ts";
-import type { State } from "./state.ts";
 import { formatFQN } from "./util/cli.ts";
 import { logger } from "./util/logger.ts";
 import type { Telemetry } from "./util/telemetry/index.ts";
@@ -53,9 +52,7 @@ async function _apply<Out extends Resource>(
   try {
     const quiet = props?.quiet ?? scope.quiet;
     await scope.init();
-    let state: State | undefined = (await scope.state.get(
-      resource[ResourceID],
-    ))!;
+    let state = await scope.state.get(resource[ResourceID]);
     const provider: Provider = PROVIDERS.get(resource[ResourceKind]);
     if (provider === undefined) {
       throw new Error(`Provider "${resource[ResourceKind]}" not found`);
@@ -280,17 +277,16 @@ async function _apply<Out extends Resource>(
       replaced: isReplaced,
     });
 
-    state = (await scope.state.get(resource[ResourceID]))!;
+    state = await scope.state.get(resource[ResourceID]);
     await scope.state.set(resource[ResourceID], {
       kind: resource[ResourceKind],
       id: resource[ResourceID],
       fqn: resource[ResourceFQN],
       seq: resource[ResourceSeq],
-      data: state.data,
+      data: state?.data ?? {}, // TODO: this used to be force-unwrapped but that was crashing for me - is this change ok?
       status,
       output,
       props,
-      // deps: [...deps],
     });
     return output as any;
   } catch (error) {

package/src/cloudflare/{astro.ts → astro/astro.ts}

@@ -1,15 +1,18 @@
-import path from "node:path";
-import type { Assets } from "./assets.ts";
-import type { Bindings } from "./bindings.ts";
-import type { WebsiteProps } from "./website.ts";
-import { Website } from "./website.ts";
-import type { Worker } from "./worker.ts";
+import { join, resolve } from "node:path";
+import { getPackageManagerRunner } from "../../util/detect-package-manager.ts";
+import type { Assets } from "../assets.ts";
+import type { Bindings } from "../bindings.ts";
+import { Website, type WebsiteProps } from "../website.ts";
+import type { Worker } from "../worker.ts";
 
 /**
  * Properties for creating an Astro resource.
  * Extends WebsiteProps, allowing customization of the underlying Website.
  */
-export interface AstroProps<B extends Bindings> extends WebsiteProps<B> {}
+export interface AstroProps<B extends Bindings>
+  extends Omit<WebsiteProps<B>, "spa"> {
+  output?: "server" | "static";
+}
 
 /**
  * Represents the output of an Astro resource deployment.
@@ -65,29 +68,43 @@ export async function Astro<B extends Bindings>(
   id: string,
   props: AstroProps<B> = {},
 ): Promise<Astro<B>> {
-  if (props?.bindings?.ASSETS) {
-    throw new Error("ASSETS binding is reserved for internal use");
-  }
-  const wrangler = props?.wrangler ?? true;
-  const main = props?.main ?? path.join("dist", "_worker.js/index.js");
-  const assetsDir =
-    typeof props?.assets === "string"
-      ? props?.assets
-      : (props?.assets?.dist ?? "dist");
-
-  return Website(id, {
+  const cwd = resolve(props.cwd ?? process.cwd());
+  const output = props.output ?? (await resolveOutputType(cwd));
+  const runner = await getPackageManagerRunner();
+  return await Website(id, {
     ...props,
-    command: props.command ?? "astro build",
-    dev: props.dev ?? {
-      command: "astro dev",
-    },
     noBundle: props.noBundle ?? true,
-    main,
-    assets: {
-      dist: assetsDir,
-      not_found_handling: "none",
-      run_worker_first: false,
-    },
-    wrangler,
+    build: props.build ?? `${runner} astro build`,
+    dev: props.dev ?? `${runner} astro dev`,
+    entrypoint:
+      props.entrypoint ??
+      (output === "server" ? "dist/_worker.js/index.js" : undefined),
+    assets: props.assets ?? "dist",
   });
 }
+
+async function resolveOutputType(cwd: string): Promise<"server" | "static"> {
+  const candidates = [
+    "astro.config.mjs",
+    "astro.config.js",
+    "astro.config.ts",
+    "astro.config.mts",
+  ];
+  for (const candidate of candidates) {
+    try {
+      const config = await import(join(cwd, candidate));
+      if (
+        typeof config.default === "object" &&
+        config.default &&
+        "output" in config.default &&
+        typeof config.default.output === "string"
+      ) {
+        return config.default.output;
+      }
+      return "static";
+    } catch {
+      // ignore
+    }
+  }
+  return "static";
+}

package/src/cloudflare/astro/plugin.ts

@@ -0,0 +1,11 @@
+import cloudflare, { type Options } from "@astrojs/cloudflare";
+import { getPlatformProxyOptions } from "../cloudflare-env-proxy.ts";
+
+const alchemy = (options?: Options) => {
+  return cloudflare({
+    platformProxy: getPlatformProxyOptions(options?.platformProxy),
+    ...options,
+  });
+};
+
+export default alchemy;

package/src/cloudflare/bundle/plugin-hot-reload.ts

@@ -3,11 +3,9 @@ import assert from "node:assert";
 
 export interface HotReloadPluginProps {
   onBuildStart?: () => void | Promise<void>;
-  onBuildEnd?: (result: esbuild.BuildResult) => void | Promise<void>;
-  onBuildError?: (errors: esbuild.Message[]) => void | Promise<void>;
 }
 
-export function createHotReloadPlugin(): {
+export function createHotReloadPlugin(props?: HotReloadPluginProps): {
   plugin: esbuild.Plugin;
   iterator: AsyncIterable<esbuild.BuildResult>;
 } {
@@ -22,6 +20,9 @@ export function createHotReloadPlugin(): {
   const plugin: esbuild.Plugin = {
     name: "alchemy-hot-reload",
     setup(build) {
+      if (props?.onBuildStart) {
+        build.onStart(props.onBuildStart);
+      }
       build.onEnd(async (result) => {
         assert(_controller);
         _controller.enqueue(result);

package/src/cloudflare/cloudflare-env-proxy.ts

@@ -0,0 +1,50 @@
+import type { GetPlatformProxyOptions } from "wrangler";
+import {
+  DEFAULT_CONFIG_PATH,
+  DEFAULT_PERSIST_PATH,
+  validateConfigPath,
+  validatePersistPath,
+} from "./miniflare/paths.ts";
+
+export const getCloudflareEnvProxy = async <E>(
+  options: GetPlatformProxyOptions = {},
+) => {
+  const { getPlatformProxy } = await import("wrangler");
+  const config = getPlatformProxyOptions(options);
+  const proxy = await getPlatformProxy(config);
+  return proxy.env as E;
+};
+
+export const getPlatformProxyOptions = (
+  input: GetPlatformProxyOptions = {},
+): GetPlatformProxyOptions => {
+  const persist =
+    input.persist === false
+      ? false
+      : {
+          path: validatePersistPath(
+            typeof input.persist === "object" &&
+              typeof input.persist.path === "string"
+              ? input.persist.path
+              : DEFAULT_PERSIST_PATH,
+          ),
+        };
+  if (!persist) {
+    const message =
+      "[Alchemy] Persistence for local bindings is disabled. Some bindings may not work as expected. To enable, remove the \`persist\` option from getPlatformProxyOptions.";
+    if (!warned.has(message)) {
+      console.warn(message);
+      warned.add(message);
+    }
+  }
+  return {
+    ...input,
+    configPath: validateConfigPath(input.configPath ?? DEFAULT_CONFIG_PATH),
+    persist,
+    experimental: input.experimental ?? {
+      remoteBindings: true,
+    },
+  };
+};
+
+const warned = new Set<string>();

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-07-26";
+export const DEFAULT_COMPATIBILITY_DATE = "2025-08-03";

package/src/cloudflare/compatibility-presets.ts

@@ -13,7 +13,7 @@ export const COMPATIBILITY_PRESETS = {
    * Node.js compatibility preset
    * Enables Node.js APIs and runtime compatibility
    */
-  node: ["nodejs_compat"],
+  node: ["nodejs_compat", "nodejs_compat_populate_process_env"],
 } as const;
 
 export type CompatibilityPreset = keyof typeof COMPATIBILITY_PRESETS;

package/src/cloudflare/d1-local-migrations.ts

@@ -13,7 +13,7 @@ export const applyLocalD1Migrations = async (
   const miniflare = new mf.Miniflare({
     script: "",
     modules: true,
-    defaultPersistRoot: path.join(process.cwd(), ".alchemy/miniflare"),
+    defaultPersistRoot: path.join(process.cwd(), ".alchemy/miniflare/v3"), // vite plugin forces /v3 suffix
     d1Persist: true,
     d1Databases: { DB: options.databaseId },
     log: process.env.DEBUG ? new mf.Log(mf.LogLevel.DEBUG) : undefined,

package/src/cloudflare/index.ts

@@ -9,12 +9,13 @@ export * from "./api-schema.ts";
 export * from "./api-shield.ts";
 export * from "./api.ts";
 export * from "./assets.ts";
-export * from "./astro.ts";
+export * from "./astro/astro.ts";
 export * from "./bindings.ts";
 export * from "./bound.ts";
 export * from "./browser-rendering.ts";
 export * from "./bucket.ts";
 export * from "./certificate-pack.ts";
+export * from "./cloudflare-env-proxy.ts";
 export * from "./compatibility-date.gen.ts";
 export * from "./container.ts";
 export * from "./custom-domain.ts";
@@ -32,28 +33,27 @@ export * from "./email-rule.ts";
 export * from "./hyperdrive.ts";
 export * from "./images.ts";
 export * from "./kv-namespace.ts";
-export * from "./local-dev-cloudflare-shim.ts";
-export * from "./nuxt.ts";
+export * from "./nuxt/nuxt.ts";
 export * from "./orange.ts";
 export * from "./permission-groups.ts";
 export * from "./pipeline.ts";
 export * from "./queue-consumer.ts";
 export * from "./queue.ts";
 export * from "./rate-limit.ts";
-export * from "./react-router.ts";
+export * from "./react-router/react-router.ts";
 export * from "./redirect-rule.ts";
-export * from "./redwood.ts";
+export * from "./redwood/redwood.ts";
 export * from "./route.ts";
 export * from "./secret-key.ts";
 export * from "./secret.ts";
 export * from "./secrets-store.ts";
 export * from "./state.ts";
-export * from "./sveltekit.ts";
-export * from "./tanstack-start.ts";
+export * from "./sveltekit/sveltekit.ts";
+export * from "./tanstack-start/tanstack-start.ts";
 export * from "./vectorize-index.ts";
 export * from "./vectorize-metadata-index.ts";
 export * from "./version-metadata.ts";
-export * from "./vite.ts";
+export * from "./vite/vite.ts";
 export * from "./website.ts";
 export * from "./worker-ref.ts";
 export * from "./worker-stub.ts";