alchemy 2.0.0-beta.76 → 2.0.0-beta.77

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
 
 <a href="https://alchemy.run">
-  <img src="./images/readme-hero.png" alt="Alchemy — Infrastructure as Effects" width="360" />
+  <img src="https://raw.githubusercontent.com/alchemy-run/alchemy/main/images/readme-hero.webp" alt="Alchemy — Infrastructure as Effects" width="360" />
 </a>
 
 <br />

package/THIRD_PARTY_LICENSES.md

@@ -6,7 +6,7 @@ respective license notices.
 
 ## Astro
 
-Portions of `packages/cloudflare-frameworks/src/astro` are derived from
+Portions of `packages/frontend-frameworks/src/astro` are derived from
 `@astrojs/cloudflare`.
 
 Copyright (c) 2021 Fred K. Schott
@@ -33,7 +33,7 @@ SOFTWARE.
 
 ## SvelteKit
 
-Portions of `packages/cloudflare-frameworks/src/sveltekit` are derived from
+Portions of `packages/frontend-frameworks/src/sveltekit` are derived from
 `@sveltejs/adapter-cloudflare`.
 
 Copyright (c) 2020 SvelteKit contributors
@@ -43,7 +43,7 @@ Astro section above.
 
 ## Waku
 
-Portions of `packages/cloudflare-frameworks/src/waku` are derived from Waku.
+Portions of `packages/frontend-frameworks/src/waku` are derived from Waku.
 
 Copyright (c) 2023 Daishi Kato
 
@@ -65,7 +65,7 @@ License reproduced in the Astro section above.
 
 ## OpenNext for Cloudflare
 
-Portions of `packages/cloudflare-frameworks/src/nextjs`, including the build
+Portions of `packages/frontend-frameworks/src/nextjs`, including the build
 runner and development-context integration, are derived from OpenNext for
 Cloudflare.
 
@@ -122,17 +122,17 @@ been dedicated to the public domain. See <https://www.sqlite.org/copyright.html>
 
 ## Upstream source references
 
-- Astro: <https://github.com/withastro/astro>
-- SvelteKit: <https://github.com/sveltejs/kit>
-- Waku: <https://github.com/wakujs/waku>
-- Cloudflare Workers SDK: <https://github.com/cloudflare/workers-sdk>
-- OpenNext for Cloudflare: <https://github.com/opennextjs/opennextjs-cloudflare>
+- Astro: [`a2240c43830e29c1d85667f4c610655d6b10253f`](https://github.com/withastro/astro/tree/a2240c43830e29c1d85667f4c610655d6b10253f)
+- SvelteKit: [`f36b3a4cd307bd8c89e03fa191becc175e7b3077`](https://github.com/sveltejs/kit/tree/f36b3a4cd307bd8c89e03fa191becc175e7b3077)
+- Waku: [`39e868f2638c27de9635c68ebf965e14a4112e9b`](https://github.com/wakujs/waku/tree/39e868f2638c27de9635c68ebf965e14a4112e9b)
+- Cloudflare Workers SDK: [`b7b4ff84477982e7c770bb93928287893fcf2e03`](https://github.com/cloudflare/workers-sdk/tree/b7b4ff84477982e7c770bb93928287893fcf2e03)
+- OpenNext for Cloudflare: [`da4b7fc8c89441a6f96205635fa70e329d1f0df7`](https://github.com/opennextjs/opennextjs-cloudflare/tree/da4b7fc8c89441a6f96205635fa70e329d1f0df7)
 - SST: <https://github.com/sst/sst>
 - node-sanitize-filename: <https://github.com/parshap/node-sanitize-filename>
 - node-ignore: <https://github.com/kaelzhang/node-ignore>
 - SQLite: <https://github.com/sqlite/sqlite>
 
-The external `.vendor` Git submodules are separate works governed by the
-license files in their respective repositories. This notice covers code copied
+The first-class `submodules/` checkouts (distilled, floci) are separate works
+governed by the license files in their respective repositories. This notice covers code copied
 or adapted into the Alchemy repository; it does not replace the license
 documentation within those submodules.

package/bin/cli.js

@@ -20,9 +20,10 @@
 // exports point at .ts source), but consumers install into `node_modules/`,
 // so the path check sends them to the bundled `alchemy.js` regardless.
 //
-// Own the spawn so bun's hard-coded watcher warning can be filtered while
-// signals, IPC messages, and the child's exit status are forwarded.
+// Own the spawn so runtime diagnostics can be filtered while signals, IPC
+// messages, and the child's exit status are forwarded.
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
 import { constants } from "node:os";
 import { fileURLToPath } from "node:url";
 import path from "pathe";
@@ -40,7 +41,10 @@ import path from "pathe";
 const foregroundChild = (program, args, stderrFilter) => {
   /** @type {import("node:child_process").StdioOptions} */
   const stdio = process.send ? [0, 1, "pipe", "ipc"] : [0, 1, "pipe"];
-  const child = spawn(program, args, { stdio });
+  const child = spawn(program, args, {
+    env: { ...process.env, NODE_ENV: "production" },
+    stdio,
+  });
   /** @type {Map<NodeJS.Signals, () => void>} */
   const listeners = new Map();
 
@@ -59,7 +63,15 @@ const foregroundChild = (program, args, stderrFilter) => {
   child.stderr?.on("data", (chunk) => {
     buffer += chunk.toString();
     const lines = buffer.split(/(?<=\n)/);
-    buffer = lines.pop() ?? "";
+    // The lookbehind split KEEPS separators, so a chunk ending in "\n"
+    // yields a COMPLETE final element — unconditionally popping it held
+    // the last line of every stderr burst (e.g. an error trace's final
+    // frame) until the next write or stream end, where it surfaced after
+    // Ctrl+C looking like unrelated output. Only buffer a genuine partial.
+    buffer =
+      lines.length > 0 && !lines[lines.length - 1].endsWith("\n")
+        ? (lines.pop() ?? "")
+        : "";
     for (const line of lines) {
       if (stderrFilter(line)) process.stderr.write(line);
     }
@@ -97,7 +109,12 @@ const foregroundChild = (program, args, stderrFilter) => {
 
 const execpath = (process.env.npm_execpath ?? "").toLowerCase();
 const userAgent = (process.env.npm_config_user_agent ?? "").toLowerCase();
-const invokedByBun = execpath.includes("bun") || userAgent.startsWith("bun/");
+// `typeof Bun`: someone ran `bun bin/cli.js` directly (no bun env markers,
+// shebang bypassed) — the launcher itself IS bun, so bun is the runtime.
+const invokedByBun =
+  execpath.includes("bun") ||
+  userAgent.startsWith("bun/") ||
+  typeof globalThis.Bun !== "undefined";
 
 // Derive the bin dir from this launcher's own location rather than
 // require.resolve("alchemy/bin/alchemy.js"). The bundled alchemy.js is a
@@ -108,6 +125,24 @@ const binDir = path.dirname(fileURLToPath(import.meta.url));
 const jsEntry = path.join(binDir, "alchemy.js");
 const tsEntry = path.join(binDir, "alchemy.ts");
 
+const [nodeMajor = 0, nodeMinor = 0] = process.versions.node
+  .split(".")
+  .map(Number);
+
+/**
+ * Whether this node has `module.registerHooks` (v22.15 / v23.5 / v24+).
+ * Alchemy loads every `.ts`/`.tsx` — its own source in a checkout, the
+ * user's stack everywhere — through the Oxc loader those hooks install, and
+ * never through Node's built-in TypeScript support (strip-only, and its
+ * transform flag was removed in Node 26). So this is THE gate for running
+ * under node at all. Mirrors `src/Util/Node.ts#isRegisterHooksSupported` —
+ * duplicated because this launcher must run under plain node first.
+ */
+const nodeSupportsHooks =
+  (nodeMajor === 22 && nodeMinor >= 15) ||
+  (nodeMajor === 23 && nodeMinor >= 5) ||
+  nodeMajor >= 24;
+
 // Treat any install-tree path as published.
 const isDev = !(
   binDir.includes("/node_modules/") || binDir.includes("\\node_modules\\")
@@ -116,6 +151,15 @@ const isDev = !(
 // We no longer force bun in dev when node is the invoker because this prevents us from testing in node.
 const runtime = invokedByBun ? "bun" : "node";
 
+if (runtime === "node" && !nodeSupportsHooks) {
+  process.stderr.write(
+    `alchemy: node ${process.versions.node} is not supported ` +
+      "(module.registerHooks needs node 22.15+, 23.5+, or 24+).\n" +
+      "Use a newer node, or run alchemy with bun.\n",
+  );
+  process.exit(1);
+}
+
 const args = [];
 
 if (runtime === "bun" && isDev) {
@@ -128,8 +172,29 @@ if (runtime === "bun" && isDev) {
   args.push(`--tsconfig-override=${path.join(binDir, "..", "tsconfig.json")}`);
 }
 
-// .ts only runs under bun.
-args.push(runtime === "bun" ? tsEntry : jsEntry, ...process.argv.slice(2));
+if (runtime === "node") {
+  // Checkout: run the source directly, no build required — the
+  // register-dev-mode hooks load .ts/.tsx through Oxc AND resolve the
+  // monorepo's own packages (`alchemy/*`, `@alchemy.run/*`,
+  // `@distilled.cloud/*`) through their `bun` export condition onto src/,
+  // so the CLI, the user's stack, and every workspace dependency load one
+  // source universe instead of whatever built lib/ happens to be around.
+  // Published: only the Oxc loader, for the user's own .ts/.tsx.
+  args.push(
+    "--import",
+    new URL(isDev ? "register-dev-mode.js" : "register-oxc.js", import.meta.url)
+      .href,
+  );
+}
+const entry = runtime === "bun" || isDev ? tsEntry : jsEntry;
+if (entry === jsEntry && !existsSync(jsEntry)) {
+  process.stderr.write(
+    `alchemy: ${jsEntry} has not been built.\n` +
+      "Run `pnpm build` in packages/alchemy.\n",
+  );
+  process.exit(1);
+}
+args.push(entry, ...process.argv.slice(2));
 
 // Substring match (not regex) — bun may wrap the line in ANSI color codes
 // when stderr is piped to a TTY-aware parent, so anchored regex is fragile.
@@ -140,10 +205,22 @@ args.push(runtime === "bun" ? tsEntry : jsEntry, ...process.argv.slice(2));
 // back to an absolute open, and logs. Bun's own tsconfig-override tests
 // tolerate the same line. Only our dev path passes --tsconfig-override, which
 // is why published installs never see it.
+// For node, spawn the launcher's OWN binary rather than whatever PATH
+// resolves: the version gates above interrogated process.versions, so the
+// flags must go to that exact node (an explicit `/opt/node24/bin/node
+// bin/cli.js` with an older PATH node would otherwise die on unknown
+// options). `runtime === "node"` implies the launcher IS node — a bun
+// launcher forces the bun branch. For bun, the usual shebang case means the
+// launcher is node and bun comes from PATH; a direct `bun bin/cli.js` run
+// reuses that same bun via execPath.
+const program =
+  runtime === "bun"
+    ? typeof globalThis.Bun !== "undefined"
+      ? process.execPath
+      : "bun"
+    : process.execPath;
 foregroundChild(
-  runtime,
+  program,
   args,
-  (line) =>
-    !line.includes("is not in the project directory and will not be watched") &&
-    !line.includes("directory mismatch for directory"),
+  (line) => !line.includes("directory mismatch for directory"),
 );