alchemy 0.47.0 → 0.48.1

package/src/cloudflare/website.ts

@@ -2,14 +2,11 @@ import path from "node:path";
 import { alchemy } from "../alchemy.ts";
 import { Exec } from "../os/exec.ts";
 import { Scope } from "../scope.ts";
+import { detectPackageManager } from "../util/detect-package-manager.ts";
 import { Assets } from "./assets.ts";
 import type { Bindings } from "./bindings.ts";
-import {
-  DEFAULT_COMPATIBILITY_DATE,
-  Worker,
-  type AssetsConfig,
-  type WorkerProps,
-} from "./worker.ts";
+import { DEFAULT_COMPATIBILITY_DATE } from "./compatibility-date.gen.ts";
+import { Worker, type AssetsConfig, type WorkerProps } from "./worker.ts";
 import { WranglerJson, type WranglerJsonSpec } from "./wrangler.json.ts";
 
 export interface WebsiteProps<B extends Bindings>
@@ -100,7 +97,6 @@ export interface WebsiteProps<B extends Bindings>
    */
   dev?: {
     command: string;
-    url: string;
   };
 
   /**
@@ -123,6 +119,15 @@ export interface WebsiteProps<B extends Bindings>
   };
 }
 
+const packageManager = await detectPackageManager();
+const devCommand = {
+  npm: "npx vite dev",
+  bun: "bun vite dev",
+  pnpm: "pnpm vite dev",
+  yarn: "yarn vite dev",
+  deno: "deno task dev",
+}[packageManager];
+
 export type Website<B extends Bindings> = B extends { ASSETS: any }
   ? never
   : Worker<B & { ASSETS: Assets }>;
@@ -189,12 +194,9 @@ export default {
 };`,
         url: props.url ?? true,
         adopt: props.adopt ?? true,
-        dev: props.dev
-          ? {
-              command: props.dev.command,
-              url: props.dev.url,
-            }
-          : undefined,
+        dev: {
+          command: props.dev?.command ?? devCommand,
+        },
       } as WorkerProps<any> & { name: string };
 
       if (wrangler) {
@@ -216,7 +218,7 @@ export default {
         });
       }
 
-      const isDev = scope.dev && !!props.dev;
+      const isDev = scope.local;
 
       if (props.command && !isDev) {
         await Exec("build", {

package/src/cloudflare/worker.ts

@@ -1,16 +1,9 @@
 import type esbuild from "esbuild";
 import kleur from "kleur";
 import { spawn } from "node:child_process";
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from "node:fs";
+import fs from "node:fs/promises";
 import { isDeepStrictEqual } from "node:util";
 import path from "pathe";
-import { BUILD_DATE } from "../build-date.ts";
 import type { Context } from "../context.ts";
 import type { BundleProps } from "../esbuild/bundle.ts";
 import { InnerResourceScope, Resource, ResourceKind } from "../resource.ts";
@@ -18,7 +11,7 @@ import { getBindKey, tryGetBinding } from "../runtime/bind.ts";
 import { isRuntime } from "../runtime/global.ts";
 import { bootstrapPlugin } from "../runtime/plugin.ts";
 import { Scope } from "../scope.ts";
-import { Secret, secret } from "../secret.ts";
+import { Secret, isSecret, secret } from "../secret.ts";
 import { serializeScope } from "../serde.ts";
 import type { type } from "../type.ts";
 import { DeferredPromise } from "../util/deferred-promise.ts";
@@ -49,6 +42,7 @@ import {
   normalizeWorkerBundle,
 } from "./bundle/index.ts";
 import { wrap } from "./bundle/normalize.ts";
+import { DEFAULT_COMPATIBILITY_DATE } from "./compatibility-date.gen.ts";
 import {
   type CompatibilityPreset,
   unionCompatibilityFlags,
@@ -92,6 +86,7 @@ import { Workflow, isWorkflow, upsertWorkflow } from "./workflow.ts";
 // Previous versions of `Worker` used the `Bundle` resource.
 // This import is here to avoid errors when destroying the `Bundle` resource.
 import "../esbuild/bundle.ts";
+import { exists } from "../util/exists.ts";
 
 /**
  * Configuration options for static assets
@@ -217,7 +212,7 @@ export interface BaseWorkerProps<
 
   /**
    * The compatibility date for the worker
-   * @default BUILD_DATE - automatically pinned to the package build date
+   * @default DEFAULT_WORKER_COMPATIBILITY_DATE - automatically pinned to the latest Workers release
    */
   compatibilityDate?: string;
 
@@ -353,7 +348,6 @@ export interface BaseWorkerProps<
    * the worker will be emulated locally and available at a randomly selected port.
    */
   dev?:
-    | boolean
     | {
         /**
          * Port to use for local development
@@ -365,11 +359,16 @@ export interface BaseWorkerProps<
          * @default false
          */
         remote?: boolean;
+        /** @internal */
+        command?: undefined;
       }
     | {
         command: string;
-        url: string;
         cwd?: string;
+        /** @internal */
+        port?: undefined;
+        /** @internal */
+        remote?: undefined;
       };
 
   /**
@@ -1014,8 +1013,6 @@ export function Worker<const B extends Bindings>(
   });
 }
 
-export const DEFAULT_COMPATIBILITY_DATE = BUILD_DATE;
-
 export const _Worker = Resource(
   "cloudflare::Worker",
   {
@@ -1047,8 +1044,6 @@ export const _Worker = Resource(
         ? props.namespace
         : props.namespace?.namespaceName;
 
-    const dev = normalizeDev(this, props.dev);
-
     const [bundle, error] = wrap(() =>
       normalizeWorkerBundle({
         entrypoint: props.entrypoint,
@@ -1067,34 +1062,46 @@ export const _Worker = Resource(
       }),
     );
 
-    if (dev.local) {
+    // run locally if
+    const local = this.scope.local && !props.dev?.remote;
+    const watch = this.scope.watch;
+
+    if (local) {
       let url: string | undefined;
       if (error) {
         throw error;
       }
 
-      switch (dev.type) {
-        case "command":
-          createDevCommand({
-            id,
-            command: dev.command,
-            cwd: dev.cwd ?? props.cwd ?? process.cwd(),
-            env: props.env ?? {},
-          });
-          url = dev.url;
-          break;
-        case "miniflare": {
-          url = await createMiniflare({
-            id,
-            workerName,
-            compatibilityDate,
-            compatibilityFlags,
-            bindings: props.bindings,
-            bundle,
-            port: dev.port,
-          });
-          break;
-        }
+      if (props.dev?.command) {
+        const { url: commandUrl } = await createDevCommand({
+          id,
+          command: props.dev.command,
+          cwd: props.dev.cwd || props.cwd || process.cwd(),
+          env: {
+            ...props.env,
+            ...Object.fromEntries(
+              Object.entries(props.bindings ?? {}).flatMap(([key, value]) =>
+                typeof value === "string"
+                  ? [[key, value]]
+                  : isSecret(value)
+                    ? [[key, value.unencrypted]]
+                    : [],
+              ),
+            ),
+          },
+        });
+        url = commandUrl;
+      } else {
+        url = await createMiniflare({
+          id,
+          workerName,
+          compatibilityDate,
+          compatibilityFlags,
+          bindings: props.bindings,
+          bundle,
+          port: props.dev?.port,
+          assets: props.assets,
+        });
       }
 
       return this({
@@ -1218,7 +1225,7 @@ export const _Worker = Resource(
     }
 
     let putWorkerResult: PutWorkerResult;
-    if (dev.type === "remote") {
+    if (watch) {
       // todo(john): clean this up and add log tail
       const controller = new AbortController();
       cleanups.push(() => controller.abort());
@@ -1436,57 +1443,6 @@ process.on("SIGINT", async () => {
   process.exit(0);
 });
 
-type Dev =
-  | {
-      type: "none";
-      local: false;
-    }
-  | {
-      type: "miniflare";
-      port?: number;
-      local: true;
-    }
-  | {
-      type: "command";
-      command: string;
-      url: string;
-      cwd?: string;
-      local: true;
-    }
-  | {
-      type: "remote";
-      local: false;
-    };
-
-const normalizeDev = (ctx: Context<any>, dev: WorkerProps["dev"]): Dev => {
-  if (!ctx.scope.dev || ctx.phase === "delete" || dev === false) {
-    return {
-      type: "none",
-      local: false,
-    };
-  }
-  const devObj = dev === true ? {} : (dev ?? {});
-  if ("command" in devObj) {
-    // Commands are always local
-    return {
-      type: "command",
-      ...devObj,
-      local: true,
-    };
-  }
-  if (devObj.remote === false || ctx.scope.dev === "prefer-local") {
-    return {
-      type: "miniflare",
-      port: devObj.port,
-      local: true,
-    };
-  }
-  return {
-    type: "remote",
-    local: false,
-  };
-};
-
 const assertUnique = <T, Key extends keyof T>(
   inputs: T[],
   key: Key,
@@ -1714,6 +1670,7 @@ async function createMiniflare(props: {
   bindings: Bindings | undefined;
   port: number | undefined;
   bundle: WorkerBundleProvider;
+  assets: AssetsConfig | undefined;
 }) {
   const sharedOptions: Omit<MiniflareWorkerOptions, "bundle"> = {
     name: props.workerName,
@@ -1721,6 +1678,7 @@ async function createMiniflare(props: {
     compatibilityFlags: props.compatibilityFlags,
     bindings: props.bindings,
     port: props.port,
+    assets: props.assets,
   };
 
   const startPromise = new DeferredPromise<string>();
@@ -1858,15 +1816,15 @@ async function createMiniflare(props: {
   return await startPromise.value;
 }
 
-function createDevCommand(props: {
+async function createDevCommand(props: {
   id: string;
   command: string;
   cwd: string;
   env: Record<string, string>;
-}) {
+}): Promise<{ url: string }> {
   const persistFile = path.join(process.cwd(), ".alchemy", `${props.id}.pid`);
-  if (existsSync(persistFile)) {
-    const pid = Number.parseInt(readFileSync(persistFile, "utf8"));
+  if (await exists(persistFile)) {
+    const pid = Number.parseInt(await fs.readFile(persistFile, "utf8"));
     try {
       // Actually kill the process if it's alive
       process.kill(pid, "SIGTERM");
@@ -1874,7 +1832,7 @@ function createDevCommand(props: {
       // ignore
     }
     try {
-      unlinkSync(persistFile);
+      await fs.unlink(persistFile);
     } catch {
       // ignore
     }
@@ -1890,21 +1848,61 @@ function createDevCommand(props: {
         ".alchemy",
         "miniflare",
       ),
+      // Force colors in the child process since we're piping output
+      // FORCE_COLOR: "1",
     },
-    stdio: ["inherit", "inherit", "inherit"],
+    stdio: ["inherit", "pipe", "pipe"],
   });
-  cleanups.push(() => {
-    try {
-      unlinkSync(persistFile);
-    } catch {
-      // ignore
-    }
-    proc.kill();
+  const { url } = await new Promise<{ url: string }>((resolve, reject) => {
+    let urlFound = false;
+    let stdout = "";
+    let stderr = "";
+    const urlRegex =
+      /http:\/\/(?:(?:localhost|0\.0\.0\.0|127\.0\.0\.1)|(?:\d{1,3}\.){3}\d{1,3}):\d+(?:\/)?/;
+
+    const parseOutput = (data: string) => {
+      if (!urlFound) {
+        const match = data.match(urlRegex);
+        if (match) {
+          urlFound = true;
+          resolve({ url: match[0] });
+        }
+      }
+    };
+
+    // Handle stdout - parse for URL and write through with colors preserved
+    proc.stdout?.on("data", (data) => {
+      parseOutput(
+        (stdout += data.toString().replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "")),
+      );
+      process.stdout.write(data);
+    });
+
+    proc.stderr?.on("data", (data) => {
+      parseOutput(
+        (stderr += data.toString().replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "")),
+      );
+      process.stderr.write(data);
+    });
+
+    proc.on("error", (error) => {
+      reject(error);
+    });
+
+    cleanups.push(async () => {
+      try {
+        await fs.unlink(persistFile);
+      } catch {
+        // ignore
+      }
+      proc.kill();
+    });
   });
   if (proc.pid) {
-    mkdirSync(path.dirname(persistFile), { recursive: true });
-    writeFileSync(persistFile, proc.pid.toString());
+    await fs.mkdir(path.dirname(persistFile), { recursive: true });
+    await fs.writeFile(persistFile, proc.pid.toString());
   }
+  return { url };
 }
 
 type PutWorkerOptions = Omit<WorkerProps, "entrypoint"> & {

package/src/scope.ts

@@ -38,7 +38,18 @@ export interface ScopeOptions {
   stateStore?: StateStoreType;
   quiet?: boolean;
   phase?: Phase;
-  dev?: "prefer-local" | "prefer-remote";
+  /**
+   * Determines if resources should be simulated locally (where possible)
+   *
+   * @default - `true` if ran with `alchemy dev` or `bun ./alchemy.run.ts --dev`
+   */
+  local?: boolean;
+  /**
+   * Determines if local changes to resources should be reactively pushed to the local or remote environment.
+   *
+   * @default - `true` if ran with `alchemy dev`, `alchemy watch`, `bun --watch ./alchemy.run.ts`
+   */
+  watch?: boolean;
   telemetryClient?: ITelemetryClient;
   logger?: LoggerApi;
 }
@@ -107,7 +118,8 @@ export class Scope {
   public readonly stateStore: StateStoreType;
   public readonly quiet: boolean;
   public readonly phase: Phase;
-  public readonly dev?: "prefer-local" | "prefer-remote";
+  public readonly local: boolean;
+  public readonly watch: boolean;
   public readonly logger: LoggerApi;
   public readonly telemetryClient: ITelemetryClient;
   public readonly dataMutex: AsyncMutex;
@@ -162,9 +174,10 @@ export class Scope {
           options.logger,
         );
 
-    this.dev = options.dev ?? this.parent?.dev;
+    this.local = options.local ?? this.parent?.local ?? false;
+    this.watch = options.watch ?? this.parent?.watch ?? false;
 
-    if (this.dev) {
+    if (this.local) {
       this.logger.warnOnce(
         "Development mode is in beta. Please report any issues to https://github.com/sam-goodwin/alchemy/issues.",
       );
@@ -415,6 +428,10 @@ export class Scope {
     await this.rootTelemetryClient?.finalize()?.catch((error) => {
       this.logger.warn("Telemetry finalization failed:", error);
     });
+
+    if (!this.parent && process.env.ALCHEMY_TEST_KILL_ON_FINALIZE) {
+      process.exit(0);
+    }
   }
 
   public async destroyPendingDeletions() {

package/src/state/cloudflare-state-store.ts

@@ -1,8 +1,8 @@
 import { alchemy } from "../alchemy.ts";
-import { BUILD_DATE } from "../build-date.ts";
 import type { CloudflareApiOptions } from "../cloudflare/api.ts";
 import { createCloudflareApi } from "../cloudflare/api.ts";
 import { getInternalWorkerBundle } from "../cloudflare/bundle/internal-worker-bundle.ts";
+import { DEFAULT_COMPATIBILITY_DATE } from "../cloudflare/compatibility-date.gen.ts";
 import { DurableObjectNamespace } from "../cloudflare/durable-object-namespace.ts";
 import { getWorkerSettings } from "../cloudflare/worker-metadata.ts";
 import {
@@ -109,7 +109,7 @@ const provision = memoize(async (options: CloudflareStateStoreOptions) => {
     );
     await putWorker(api, {
       workerName: scriptName,
-      compatibilityDate: BUILD_DATE,
+      compatibilityDate: DEFAULT_COMPATIBILITY_DATE,
       format: "esm",
       scriptBundle: {
         entrypoint: bundle.file.name,

package/src/util/http.ts

@@ -0,0 +1,94 @@
+import http from "node:http";
+import type { AddressInfo } from "node:net";
+import { Readable } from "node:stream";
+
+export class HTTPServer {
+  httpServer: http.Server;
+
+  constructor(options: {
+    fetch: (request: Request) => Promise<Response>;
+  }) {
+    this.httpServer = http.createServer();
+    this.httpServer.on("request", async (req, res) => {
+      const response = await options.fetch(toWebRequest(req));
+      await writeNodeResponse(res, response);
+    });
+  }
+
+  listen(port?: number) {
+    return new Promise<this>((resolve, reject) => {
+      this.httpServer.on("listening", () => {
+        resolve(this);
+      });
+      this.httpServer.on("error", (error) => {
+        reject(error);
+      });
+      this.httpServer.listen(port);
+    });
+  }
+
+  get url() {
+    const address = this.httpServer.address() as AddressInfo | null;
+    if (!address) {
+      throw new Error("Server is not listening");
+    }
+    const hostname = address.address === "::" ? "localhost" : address.address;
+    return `http://${hostname}:${address.port}`;
+  }
+
+  close() {
+    return new Promise((resolve, reject) => {
+      this.httpServer.close((err) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve(undefined);
+        }
+      });
+    });
+  }
+}
+
+export function toWebRequest(
+  req: http.IncomingMessage,
+  host?: string,
+): Request {
+  const method = req.method ?? "GET";
+  const url = new URL(req.url ?? "/", `http://${host ?? req.headers.host}`);
+  const body =
+    ["GET", "HEAD", "OPTIONS"].includes(method) || !req.readable
+      ? undefined
+      : Readable.toWeb(req);
+  return new Request(url.toString(), {
+    method,
+    headers: req.headers as Record<string, string>,
+    body: body as unknown as BodyInit,
+    // @ts-expect-error - caused by @cloudflare/workers-types
+    duplex: body ? "half" : undefined,
+    redirect: "manual",
+  });
+}
+
+export async function writeNodeResponse(
+  res: http.ServerResponse,
+  response: Response,
+) {
+  res.statusCode = response.status;
+  response.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+  if (response.body) {
+    await response.body.pipeTo(
+      new WritableStream({
+        write(chunk) {
+          res.write(chunk);
+        },
+        close() {
+          res.end();
+        },
+      }),
+    );
+  } else {
+    res.end();
+  }
+}

package/src/util/safe-fetch.ts

@@ -20,6 +20,7 @@ export async function safeFetch(
         err?.code === "UND_ERR_SOCKET" ||
         err?.code === "ECONNRESET" ||
         err?.code === "UND_ERR_CONNECT_TIMEOUT" ||
+        err?.code === "EPIPE" ||
         err?.name === "FetchError";
 
       if (!shouldRetry || attempt === retries) {

package/templates/react-router/package.json

@@ -3,7 +3,7 @@
   "name": "@alchemy.run/react-router-template",
   "private": true,
   "scripts": {
-    "build": "vite build",
+    "build": "react-router build",
     "deploy": "alchemy deploy",
     "destroy": "alchemy destroy",
     "dev": "alchemy dev",

package/templates/react-router/tsconfig.cloudflare.json

@@ -11,7 +11,11 @@
     "composite": true,
     "strict": true,
     "lib": ["DOM", "DOM.Iterable", "ES2022"],
-    "types": ["vite/client"],
+    "types": [
+      "vite/client",
+      "@cloudflare/workers-types",
+      "./types/env.d.ts"
+    ],
     "target": "ES2022",
     "module": "ES2022",
     "moduleResolution": "bundler",

package/templates/react-router/tsconfig.json

@@ -10,8 +10,5 @@
     "skipLibCheck": true,
     "strict": true,
     "noEmit": true,
-    "types": [
-        "./worker-configuration.d.ts"
-    ]
   }
 }

package/templates/react-router/tsconfig.node.json

@@ -8,10 +8,6 @@
   "compilerOptions": {
     "composite": true,
     "strict": true,
-    "types": [
-      "@cloudflare/workers-types",
-      "./types/env.d.ts"
-    ],
     "lib": ["ES2022"],
     "target": "ES2022",
     "module": "ES2022",

package/lib/build-date.d.ts

@@ -1,6 +0,0 @@
-/**
- * The build date used as the default worker compatibility date.
- * This is set to the date when the package was built.
- */
-export declare const BUILD_DATE = "2025-07-16";
-//# sourceMappingURL=build-date.d.ts.map

package/lib/build-date.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-date.d.ts","sourceRoot":"","sources":["../src/build-date.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,UAAU,eAAe,CAAC"}

package/lib/build-date.js

@@ -1,8 +0,0 @@
-// This file is auto-generated during build
-// Do not edit manually
-/**
- * The build date used as the default worker compatibility date.
- * This is set to the date when the package was built.
- */
-export const BUILD_DATE = "2025-07-16";
-//# sourceMappingURL=build-date.js.map

package/lib/build-date.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-date.js","sourceRoot":"","sources":["../src/build-date.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,uBAAuB;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC"}

package/lib/util/http-server.d.ts

@@ -1,14 +0,0 @@
-import http from "node:http";
-export declare class HTTPServer {
-    server: http.Server;
-    ready: Promise<void>;
-    constructor(options: {
-        port?: number;
-        fetch: (request: Request) => Promise<Response>;
-    });
-    get port(): number;
-    get hostname(): string;
-    get url(): string;
-    stop(): Promise<unknown>;
-}
-//# sourceMappingURL=http-server.d.ts.map

package/lib/util/http-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/util/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,qBAAa,UAAU;IACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAET,OAAO,EAAE;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAChD;IAWD,IAAI,IAAI,WAEP;IAED,IAAI,QAAQ,WAMX;IAED,IAAI,GAAG,WAEN;IAED,IAAI;CAWL"}