alchemy 0.87.0 → 0.90.0

package/bin/alchemy.js

@@ -36878,7 +36878,7 @@ async function deriveScryptKey(passphrase, salt) {
 async function libsodiumDecrypt(encryptedValue, key) {
 	const sodium = (await import("libsodium-wrappers")).default;
 	await sodium.ready;
-	const cryptoKey = sodium.crypto_generichash(sodium.crypto_secretbox_KEYBYTES, sodium.from_string(key));
+	const cryptoKey = sodium.crypto_generichash(sodium.crypto_secretbox_KEYBYTES, sodium.from_string(key), null);
 	const combined = sodium.from_base64(encryptedValue, sodium.base64_variants.ORIGINAL);
 	const nonce = combined.slice(0, sodium.crypto_secretbox_NONCEBYTES);
 	const ciphertext = combined.slice(sodium.crypto_secretbox_NONCEBYTES);
@@ -37050,54 +37050,10 @@ var FileSystemStateStore = class {
 	}
 };
 
-//#endregion
-//#region ../node_modules/.bun/env-paths@3.0.0/node_modules/env-paths/index.js
-const homedir = os.homedir();
-const tmpdir = os.tmpdir();
-const { env: env$1 } = y;
-const macos = (name$1) => {
-	const library = path.join(homedir, "Library");
-	return {
-		data: path.join(library, "Application Support", name$1),
-		config: path.join(library, "Preferences", name$1),
-		cache: path.join(library, "Caches", name$1),
-		log: path.join(library, "Logs", name$1),
-		temp: path.join(tmpdir, name$1)
-	};
-};
-const windows = (name$1) => {
-	const appData = env$1.APPDATA || path.join(homedir, "AppData", "Roaming");
-	const localAppData = env$1.LOCALAPPDATA || path.join(homedir, "AppData", "Local");
-	return {
-		data: path.join(localAppData, name$1, "Data"),
-		config: path.join(appData, name$1, "Config"),
-		cache: path.join(localAppData, name$1, "Cache"),
-		log: path.join(localAppData, name$1, "Log"),
-		temp: path.join(tmpdir, name$1)
-	};
-};
-const linux = (name$1) => {
-	const username = path.basename(homedir);
-	return {
-		data: path.join(env$1.XDG_DATA_HOME || path.join(homedir, ".local", "share"), name$1),
-		config: path.join(env$1.XDG_CONFIG_HOME || path.join(homedir, ".config"), name$1),
-		cache: path.join(env$1.XDG_CACHE_HOME || path.join(homedir, ".cache"), name$1),
-		log: path.join(env$1.XDG_STATE_HOME || path.join(homedir, ".local", "state"), name$1),
-		temp: path.join(tmpdir, username, name$1)
-	};
-};
-function envPaths(name$1, { suffix = "nodejs" } = {}) {
-	if (typeof name$1 !== "string") throw new TypeError(`Expected a string, got ${typeof name$1}`);
-	if (suffix) name$1 += `-${suffix}`;
-	if (y.platform === "darwin") return macos(name$1);
-	if (y.platform === "win32") return windows(name$1);
-	return linux(name$1);
-}
-
 //#endregion
 //#region package.json
 var name = "alchemy";
-var version = "0.87.0";
+var version = "0.90.0";
 var license = "Apache-2.0";
 var author = "Sam Goodwin <sam@alchemy.run>";
 var homepage = "https://alchemy.run";
@@ -37113,7 +37069,7 @@ var scripts = {
 	"build": "rm -rf ./*.tsbuildinfo && rm -rf ./lib && tsc -b && tsdown",
 	"dev": "tsdown --watch",
 	"drizzle:generate": "bun run scripts/drizzle-generate.ts",
-	"postbuild": "cpx 'src/**/*/types.d.ts' lib && cpx 'src/**/*.txt' lib",
+	"postbuild": "(cpy '**/*.d.ts' ../lib --cwd=src || true) && (cpy '**/*.txt' ../lib --cwd=src || true)",
 	"publish:npm": "cp ../README.md . && bun run build && tsdown && bun publish && rm README.md"
 };
 var files = [
@@ -37290,7 +37246,7 @@ var dependencies = {
 	"glob": "^10.0.0",
 	"jszip": "^3.0.0",
 	"libsodium-wrappers": "^0.8.0",
-	"miniflare": "^4.20260120.0",
+	"miniflare": "4.20260310.0",
 	"neverthrow": "^8.2.0",
 	"open": "^10.1.2",
 	"openapi-types": "^12.1.3",
@@ -37374,7 +37330,7 @@ var devDependencies = {
 	"braintrust": "^0.0.201",
 	"capnweb": "^0.4.0",
 	"cojson-core-wasm": "^0.18.16",
-	"cpx": "^1.5.0",
+	"cpy-cli": "^7.0.0",
 	"debug": "^4.4.1",
 	"dofs": "^0.1.0",
 	"drizzle-kit": "^0.31.8",
@@ -37415,134 +37371,508 @@ var package_default = {
 };
 
 //#endregion
-//#region src/util/cli-args.ts
-const cliArgs = process.argv.slice(2);
-function parseOption(option, defaultValue) {
-	const i$2 = cliArgs.indexOf(option);
-	return i$2 !== -1 && i$2 + 1 < cliArgs.length ? cliArgs[i$2 + 1] : defaultValue;
-}
-
-//#endregion
-//#region src/util/is-transient-error.ts
-function isTransientNetworkError(err) {
-	return err?.code === "UND_ERR_SOCKET" || err?.code === "ECONNRESET" || err?.code === "UND_ERR_CONNECT_TIMEOUT" || err?.code === "EPIPE" || err?.name === "FetchError";
+//#region src/util/dedent.ts
+/**
+* Tagged template literal for removing indentation from a block of text.
+*
+* If the first line is empty, it will be ignored.
+*/
+function dedent(strings, ...values) {
+	let lines = String.raw({ raw: strings }, ...values).split("\n");
+	while (lines.length > 0 && lines[0].trim() === "") lines = lines.slice(1);
+	while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines = lines.slice(0, lines.length - 1);
+	if (lines.length === 0) return "";
+	let minIndentLength = Number.POSITIVE_INFINITY;
+	for (const line of lines) if (line.trim() !== "") {
+		const indent = line.match(/^[ \t]*/)?.[0];
+		if (indent != null && indent.length < minIndentLength) minIndentLength = indent.length;
+	}
+	if (minIndentLength === Number.POSITIVE_INFINITY) return lines.join("\n");
+	lines = lines.map((line) => {
+		if (line.trim() === "") return line;
+		return line.startsWith(" ".repeat(minIndentLength)) || line.startsWith("	".repeat(minIndentLength)) ? line.substring(minIndentLength) : line;
+	});
+	return lines.join("\n");
 }
 
 //#endregion
-//#region src/util/logger.ts
-const logger = new Proxy({}, { get: (_$2, prop) => {
-	const logger$1 = Scope.getScope()?.logger ?? {
-		log: console.log,
-		error: console.error,
-		warn: console.warn,
-		warnOnce: console.warn,
+//#region src/util/cli.ts
+const colors = {
+	reset: "\x1B[0m",
+	cyanBright: "\x1B[96m",
+	yellowBright: "\x1B[93m",
+	magenta: "\x1B[35m",
+	greenBright: "\x1B[92m",
+	redBright: "\x1B[91m",
+	gray: "\x1B[90m"
+};
+const shouldDisableColors = () => {
+	return Boolean(process.env.NO_COLOR);
+};
+const colorize = (text, color) => {
+	if (shouldDisableColors()) return text;
+	return `${colors[color]}${text}${colors.reset}`;
+};
+let loggers = {};
+const createLoggerInstance = (alchemyInfo, customLogger) => {
+	return loggers[alchemyInfo.appName] ??= customLogger ?? createFallbackLogger(alchemyInfo);
+};
+const createDummyLogger = () => {
+	return {
+		log: () => {},
+		error: () => {},
+		warn: () => {},
+		warnOnce: () => {},
 		task: () => {},
 		exit: () => {}
 	};
-	return logger$1[prop].bind(logger$1);
-} });
+};
+const createFallbackLogger = (alchemyInfo) => {
+	if (alchemyInfo.phase !== "read") console.log(dedent`
+      ${colorize("Alchemy", "cyanBright")} (v${package_default.version})
+      App: ${alchemyInfo.appName}
+      Phase: ${alchemyInfo.phase}
+      Stage: ${alchemyInfo.stage}
+      
+    `);
+	return {
+		log: console.log,
+		error: (...args) => console.error(colorize("ERROR", "redBright"), ...args),
+		warn: (...args) => console.warn(colorize("WARN", "yellowBright"), ...args),
+		warnOnce: (message) => {
+			globalThis._ALCHEMY_WARNINGS ??= /* @__PURE__ */ new Set();
+			if (globalThis._ALCHEMY_WARNINGS.has(message)) return;
+			globalThis._ALCHEMY_WARNINGS.add(message);
+			console.warn(colorize("WARN", "yellowBright"), message);
+		},
+		task: (_id, data) => {
+			const prefix = data.prefix ? `[${data.prefix}]` : "";
+			const paddedPrefix = prefix.padEnd(12);
+			const prefixWithColor = data.prefixColor && prefix ? colorize(paddedPrefix, data.prefixColor) : paddedPrefix;
+			const resource = data.resource ? colorize(data.resource, "gray") : "";
+			const message = data.message;
+			if (prefixWithColor && resource) console.log(`${prefixWithColor}${resource} ${message}`);
+			else if (prefixWithColor) console.log(`${prefixWithColor}${message}`);
+			else console.log(`${message}`);
+		},
+		exit: () => {}
+	};
+};
+const formatFQN = (fqn) => fqn.split("/").slice(2).join(" > ");
 
 //#endregion
-//#region src/util/telemetry.ts
-const ALCHEMY_DIR = path$1.join(os.homedir(), ".alchemy");
-const ID_PATH = path$1.join(ALCHEMY_DIR, "id");
-const ID_PATH_LEGACY = path$1.join(envPaths("alchemy", { suffix: "" }).config, "id");
-const DISABLED_PATH = path$1.join(ALCHEMY_DIR, "telemetry-disabled");
-const TELEMETRY_DISABLED = !!process.env.ALCHEMY_TELEMETRY_DISABLED || !!process.env.DO_NOT_TRACK;
-const TELEMETRY_API_URL = process.env.ALCHEMY_TELEMETRY_API_URL ?? "https://telemetry.alchemy.run";
-const SUPPRESS_TELEMETRY_ERRORS = !!process.env.ALCHEMY_TELEMETRY_SUPPRESS_ERRORS;
-const getGlobalTelemetryDisabled = memoize(async () => {
-	return await fs$1.readFile(DISABLED_PATH, "utf-8").then((data) => data.trim() === "true").catch(() => false);
-});
-async function setGlobalTelemetryDisabled() {
-	await fs$1.mkdir(ALCHEMY_DIR, { recursive: true });
-	await fs$1.writeFile(DISABLED_PATH, "true");
-}
-async function setGlobalTelemetryEnabled() {
-	await fs$1.rm(DISABLED_PATH, { force: true });
-}
-async function getOrCreateUserId() {
-	async function readUserId(path$32) {
+//#region src/util/mutex.ts
+/**
+* Simple async mutex that ensures only one async operation executes at a time
+*/
+var AsyncMutex = class {
+	locked = false;
+	queue = [];
+	async lock(operation) {
+		return new Promise((resolve$1, reject) => {
+			const execute = async () => {
+				this.locked = true;
+				try {
+					resolve$1(await operation());
+				} catch (error$84) {
+					reject(error$84);
+				} finally {
+					this.locked = false;
+					const next = this.queue.shift();
+					if (next) next();
+				}
+			};
+			if (this.locked) this.queue.push(execute);
+			else execute();
+		});
+	}
+};
+
+//#endregion
+//#region src/util/idempotent-spawn.ts
+/**
+* Idempotently ensure a long-lived child is running with stdout/stderr -> files,
+* and mirror those logs to THIS process's console with persisted offsets.
+*
+* Use: await ensureLoggedChildAndMirror({ cmd: "vite dev" })
+*/
+async function idempotentSpawn({ cmd, cwd: cwd$1, env: env$2, stateFile = "state.json", overlapBytes = 0, resume = false, log = "log.txt", processName, extract, isSameProcess, quiet = false }) {
+	if (!processName && !isSameProcess) processName = cmd.split(" ")[0];
+	const outPath = log;
+	await Promise.all([fs$1.mkdir(path$1.dirname(stateFile), { recursive: true }), fs$1.mkdir(path$1.dirname(log), { recursive: true })]);
+	const { promise: extracted, resolve: resolveExtracted } = Promise.withResolvers();
+	if (!extract) resolveExtracted(void 0);
+	const pid = await ensureChildRunning();
+	const write = quiet ? () => false : (buf) => process.stdout.write(buf);
+	await followFilePersisted(outPath, {
+		stateKey: `${path$1.resolve(outPath)}::stdout`,
+		write
+	});
+	return {
+		extracted,
+		stop: async () => pid ? await kill(pid) : void 0
+	};
+	function isPidAlive(pid$1) {
+		if (!pid$1 || Number.isNaN(pid$1)) return false;
 		try {
-			return (await fs$1.readFile(path$32, "utf-8")).trim();
+			process.kill(pid$1, 0);
+			return true;
 		} catch {
-			return null;
+			return false;
 		}
 	}
-	const id = await readUserId(ID_PATH);
-	if (id) return id;
-	const legacyId = await readUserId(ID_PATH_LEGACY);
-	try {
-		const id$1 = legacyId ?? crypto.randomUUID();
-		await fs$1.mkdir(ALCHEMY_DIR, { recursive: true });
-		await fs$1.writeFile(ID_PATH, id$1);
-		if (!legacyId) console.warn(["Attention: To help improve Alchemy, we collect anonymous usage, performance, and error data.", "You can opt out by setting the ALCHEMY_TELEMETRY_DISABLED or DO_NOT_TRACK environment variable to a truthy value."].join("\n"));
-		return id$1;
-	} catch {
-		return null;
+	async function writeJsonAtomic(file$2, data) {
+		const dir = path$1.dirname(file$2);
+		const tmp = path$1.join(dir, `.${path$1.basename(file$2)}.${process.pid}.${Date.now()}.tmp`);
+		await fs$1.writeFile(tmp, JSON.stringify(data, null, 2), { mode: 384 });
+		await fs$1.rename(tmp, file$2);
 	}
-}
-async function getRootCommitHash() {
-	return new Promise((resolve$1) => {
-		exec(process.platform === "win32" ? `git rev-list --max-parents=0 HEAD | ForEach-Object { if (-not (git cat-file -p $_ | Select-String "^parent ")) { $_ } }` : `git rev-list --max-parents=0 HEAD | xargs -r -I{} sh -c 'git cat-file -p {} | grep -q "^parent " || echo {}'`, (err, stdout$1) => {
-			if (err) {
-				resolve$1(null);
-				return;
-			}
-			resolve$1(stdout$1.trim());
-		});
-	});
-}
-async function getGitOriginUrlHash() {
-	return new Promise((resolve$1) => {
-		exec("git config --get remote.origin.url", (err, stdout$1) => {
-			if (err) {
-				resolve$1(null);
-				return;
-			}
-			resolve$1(hashString(stdout$1.trim()));
+	async function readJson$3(file$2) {
+		try {
+			return JSON.parse(await fs$1.readFile(file$2, "utf8"));
+		} catch {
+			return;
+		}
+	}
+	async function spawnLoggedChild() {
+		const out = await fs$1.open(outPath, "a");
+		const child = spawn(cmd, {
+			shell: true,
+			cwd: cwd$1,
+			stdio: [
+				"inherit",
+				out.fd,
+				out.fd
+			],
+			env: env$2,
+			detached: false
 		});
-	});
-}
-async function getBranchName() {
-	return new Promise((resolve$1) => {
-		exec("git rev-parse --abbrev-ref HEAD", (err, stdout$1) => {
-			if (err) {
-				resolve$1(null);
-				return;
+		await out.close();
+		const stateAll = await readJson$3(stateFile) ?? {};
+		stateAll.pid = child.pid;
+		await writeJsonAtomic(stateFile, stateAll);
+		return child;
+	}
+	async function ensureChildRunning() {
+		const stateAll = await readJson$3(stateFile);
+		if (stateAll) {
+			const pid$1 = Number.parseInt(stateAll.pid, 10);
+			if (isPidAlive(pid$1)) return pid$1;
+			if (await isSameProcess?.(pid$1)) return pid$1;
+			if (processName) {
+				const processes = await find("pid", pid$1);
+				if (processes.length > 1) console.warn(`Found multiple processes with PID ${pid$1}, using the first one`);
+				if (processes.length > 0) {
+					if (processes[0].name.startsWith(processName)) return pid$1;
+				}
 			}
-			resolve$1(stdout$1.trim());
+		}
+		await Promise.all([fs$1.rm(stateFile).catch(() => {}), fs$1.rm(log).catch(() => {})]);
+		return (await spawnLoggedChild()).pid;
+	}
+	async function followFilePersisted(logPath, { write: write$1, chunkSize = 64 * 1024, tickMs = 100 }) {
+		logPath = path$1.resolve(logPath);
+		let state = await readJson$3(stateFile) ?? {};
+		let fh = await fs$1.open(logPath, "r");
+		let st = await fh.stat();
+		let ino = Number(st.ino ?? 0);
+		let dev$1 = Number(st.dev ?? 0);
+		let offset = resume && state.ino === ino && state.dev === dev$1 && typeof state.offset === "number" ? Math.max(0, Math.min(st.size, state.offset - overlapBytes)) : st.size;
+		let closed = false;
+		const drainMutex = new AsyncMutex();
+		let remainder;
+		if (offset > 0) {
+			const fullBuffer = Buffer.allocUnsafe(offset);
+			await fh.read({
+				position: 0,
+				buffer: fullBuffer,
+				length: offset
+			});
+			parse$10(fullBuffer.toString("utf8"));
+		}
+		await drain();
+		const watcher = fs.watch(logPath, async () => {
+			if (closed) return;
+			try {
+				const cur = await fh.stat();
+				const curIno = Number(cur.ino ?? 0);
+				const curDev = Number(cur.dev ?? 0);
+				if (curIno !== ino || curDev !== dev$1) {
+					await fh.close().catch(() => {});
+					fh = await fs$1.open(logPath, "r");
+					const cur2 = await fh.stat();
+					ino = Number(cur2.ino ?? 0);
+					dev$1 = Number(cur2.dev ?? 0);
+					offset = 0;
+				}
+			} catch {}
+			await drain();
 		});
-	});
+		const tick = setInterval(() => {
+			drain().catch(() => {});
+		}, tickMs);
+		return async function stop() {
+			closed = true;
+			watcher.close();
+			clearInterval(tick);
+			await fh.close().catch(() => {});
+			await persist();
+		};
+		async function persist() {
+			try {
+				const cur = await fh.stat();
+				state = {
+					...state,
+					offset,
+					ino: Number(cur.ino ?? ino),
+					dev: Number(cur.dev ?? dev$1),
+					size: cur.size,
+					mtimeMs: cur.mtimeMs
+				};
+				await writeJsonAtomic(stateFile, state);
+			} catch {}
+		}
+		function parse$10(content) {
+			const lines = content.split("\n");
+			if (extract) {
+				if (lines.length > 0) remainder = lines[lines.length - 1];
+				for (const line of lines.slice(0, -1)) {
+					const extracted$1 = extract(line);
+					if (extracted$1) {
+						resolveExtracted(extracted$1);
+						break;
+					}
+				}
+			}
+		}
+		function drain() {
+			return drainMutex.lock(async () => {
+				while (true) {
+					const cur = await fh.stat().catch(() => null);
+					if (!cur) break;
+					if (cur.size < offset) offset = 0;
+					const toRead = Math.min(chunkSize, cur.size - offset);
+					if (toRead <= 0) break;
+					const { bytesRead, buffer } = await fh.read({
+						position: offset,
+						buffer: Buffer.allocUnsafe(toRead),
+						length: toRead
+					});
+					if (!bytesRead) break;
+					const chunk = buffer.subarray(0, bytesRead);
+					write$1(chunk);
+					parse$10(`${remainder || ""}${chunk.toString("utf8")}`);
+					offset += bytesRead;
+				}
+				await persist();
+			});
+		}
+	}
+	async function kill(pid$1) {
+		try {
+			process.kill(pid$1, "SIGTERM");
+		} catch {
+			return;
+		}
+		if ((await find("pid", pid$1)).some((p$1) => p$1.name !== "<defunct>")) try {
+			process.kill(pid$1, "SIGKILL");
+		} catch {}
+	}
 }
-function getRuntime$1() {
-	if (globalThis.Bun) return {
-		name: "bun",
-		version: Bun.version
-	};
-	if (globalThis.Deno) return {
-		name: "deno",
-		version: Deno.version?.deno ?? null
+/**
+* The find-process package is a bit of a mess and has different behavior across runtimes (bun, tsx, node, etc.)
+*
+* This wrapper function defensively searches for the find function in the imported module.
+*
+* It confirmed to support:
+* 1. node
+* 2. bun
+* 3. tsx
+*
+* TODO(sam): check deno?
+*/
+const find = async (...args) => {
+	const findProcess = await import("find-process");
+	return (findProcess.default?.default ?? findProcess.default ?? findProcess.find ?? findProcess)(...args);
+};
+
+//#endregion
+//#region src/util/logger.ts
+const logger = new Proxy({}, { get: (_$2, prop) => {
+	const logger$1 = Scope.getScope()?.logger ?? {
+		log: console.log,
+		error: console.error,
+		warn: console.warn,
+		warnOnce: console.warn,
+		task: () => {},
+		exit: () => {}
 	};
-	if (globalThis.EdgeRuntime) return {
-		name: "workerd",
-		version: null
+	return logger$1[prop].bind(logger$1);
+} });
+
+//#endregion
+//#region src/util/root-dir.ts
+const ALCHEMY_ROOT = process.env.ALCHEMY_ROOT ?? process.cwd();
+
+//#endregion
+//#region ../node_modules/.bun/env-paths@3.0.0/node_modules/env-paths/index.js
+const homedir = os.homedir();
+const tmpdir = os.tmpdir();
+const { env: env$1 } = y;
+const macos = (name$1) => {
+	const library = path.join(homedir, "Library");
+	return {
+		data: path.join(library, "Application Support", name$1),
+		config: path.join(library, "Preferences", name$1),
+		cache: path.join(library, "Caches", name$1),
+		log: path.join(library, "Logs", name$1),
+		temp: path.join(tmpdir, name$1)
 	};
-	if (globalThis.process?.versions?.node) return {
-		name: "node",
-		version: process.versions.node
+};
+const windows = (name$1) => {
+	const appData = env$1.APPDATA || path.join(homedir, "AppData", "Roaming");
+	const localAppData = env$1.LOCALAPPDATA || path.join(homedir, "AppData", "Local");
+	return {
+		data: path.join(localAppData, name$1, "Data"),
+		config: path.join(appData, name$1, "Config"),
+		cache: path.join(localAppData, name$1, "Cache"),
+		log: path.join(localAppData, name$1, "Log"),
+		temp: path.join(tmpdir, name$1)
 	};
+};
+const linux = (name$1) => {
+	const username = path.basename(homedir);
 	return {
-		name: null,
-		version: null
+		data: path.join(env$1.XDG_DATA_HOME || path.join(homedir, ".local", "share"), name$1),
+		config: path.join(env$1.XDG_CONFIG_HOME || path.join(homedir, ".config"), name$1),
+		cache: path.join(env$1.XDG_CACHE_HOME || path.join(homedir, ".cache"), name$1),
+		log: path.join(env$1.XDG_STATE_HOME || path.join(homedir, ".local", "state"), name$1),
+		temp: path.join(tmpdir, username, name$1)
 	};
+};
+function envPaths(name$1, { suffix = "nodejs" } = {}) {
+	if (typeof name$1 !== "string") throw new TypeError(`Expected a string, got ${typeof name$1}`);
+	if (suffix) name$1 += `-${suffix}`;
+	if (y.platform === "darwin") return macos(name$1);
+	if (y.platform === "win32") return windows(name$1);
+	return linux(name$1);
 }
-const PROVIDERS$1 = [
-	{
-		env: "GITHUB_ACTIONS",
-		provider: "GitHub Actions",
-		isCI: true
-	},
+
+//#endregion
+//#region src/util/cli-args.ts
+const cliArgs = process.argv.slice(2);
+function parseOption(option, defaultValue) {
+	const i$2 = cliArgs.indexOf(option);
+	return i$2 !== -1 && i$2 + 1 < cliArgs.length ? cliArgs[i$2 + 1] : defaultValue;
+}
+
+//#endregion
+//#region src/util/is-transient-error.ts
+function isTransientNetworkError(err) {
+	return err?.code === "UND_ERR_SOCKET" || err?.code === "ECONNRESET" || err?.code === "UND_ERR_CONNECT_TIMEOUT" || err?.code === "EPIPE" || err?.name === "FetchError";
+}
+
+//#endregion
+//#region src/util/telemetry.ts
+const ALCHEMY_DIR = path$1.join(os.homedir(), ".alchemy");
+const ID_PATH = path$1.join(ALCHEMY_DIR, "id");
+const ID_PATH_LEGACY = path$1.join(envPaths("alchemy", { suffix: "" }).config, "id");
+const DISABLED_PATH = path$1.join(ALCHEMY_DIR, "telemetry-disabled");
+const TELEMETRY_DISABLED = !!process.env.ALCHEMY_TELEMETRY_DISABLED || !!process.env.DO_NOT_TRACK;
+const TELEMETRY_API_URL = process.env.ALCHEMY_TELEMETRY_API_URL ?? "https://telemetry.alchemy.run";
+const SUPPRESS_TELEMETRY_ERRORS = !!process.env.ALCHEMY_TELEMETRY_SUPPRESS_ERRORS;
+const getGlobalTelemetryDisabled = memoize(async () => {
+	return await fs$1.readFile(DISABLED_PATH, "utf-8").then((data) => data.trim() === "true").catch(() => false);
+});
+async function setGlobalTelemetryDisabled() {
+	await fs$1.mkdir(ALCHEMY_DIR, { recursive: true });
+	await fs$1.writeFile(DISABLED_PATH, "true");
+}
+async function setGlobalTelemetryEnabled() {
+	await fs$1.rm(DISABLED_PATH, { force: true });
+}
+async function getOrCreateUserId() {
+	async function readUserId(path$32) {
+		try {
+			return (await fs$1.readFile(path$32, "utf-8")).trim();
+		} catch {
+			return null;
+		}
+	}
+	const id = await readUserId(ID_PATH);
+	if (id) return id;
+	const legacyId = await readUserId(ID_PATH_LEGACY);
+	try {
+		const id$1 = legacyId ?? crypto.randomUUID();
+		await fs$1.mkdir(ALCHEMY_DIR, { recursive: true });
+		await fs$1.writeFile(ID_PATH, id$1);
+		if (!legacyId) console.warn(["Attention: To help improve Alchemy, we collect anonymous usage, performance, and error data.", "You can opt out by setting the ALCHEMY_TELEMETRY_DISABLED or DO_NOT_TRACK environment variable to a truthy value."].join("\n"));
+		return id$1;
+	} catch {
+		return null;
+	}
+}
+async function getRootCommitHash() {
+	return new Promise((resolve$1) => {
+		exec(process.platform === "win32" ? `git rev-list --max-parents=0 HEAD | ForEach-Object { if (-not (git cat-file -p $_ | Select-String "^parent ")) { $_ } }` : `git rev-list --max-parents=0 HEAD | xargs -r -I{} sh -c 'git cat-file -p {} | grep -q "^parent " || echo {}'`, (err, stdout$1) => {
+			if (err) {
+				resolve$1(null);
+				return;
+			}
+			resolve$1(stdout$1.trim());
+		});
+	});
+}
+async function getGitOriginUrlHash() {
+	return new Promise((resolve$1) => {
+		exec("git config --get remote.origin.url", (err, stdout$1) => {
+			if (err) {
+				resolve$1(null);
+				return;
+			}
+			resolve$1(hashString(stdout$1.trim()));
+		});
+	});
+}
+async function getBranchName() {
+	return new Promise((resolve$1) => {
+		exec("git rev-parse --abbrev-ref HEAD", (err, stdout$1) => {
+			if (err) {
+				resolve$1(null);
+				return;
+			}
+			resolve$1(stdout$1.trim());
+		});
+	});
+}
+function getRuntime$1() {
+	if (globalThis.Bun) return {
+		name: "bun",
+		version: Bun.version
+	};
+	if (globalThis.Deno) return {
+		name: "deno",
+		version: Deno.version?.deno ?? null
+	};
+	if (globalThis.EdgeRuntime) return {
+		name: "workerd",
+		version: null
+	};
+	if (globalThis.process?.versions?.node) return {
+		name: "node",
+		version: process.versions.node
+	};
+	return {
+		name: null,
+		version: null
+	};
+}
+const PROVIDERS$1 = [
+	{
+		env: "GITHUB_ACTIONS",
+		provider: "GitHub Actions",
+		isCI: true
+	},
 	{
 		env: "GITLAB_CI",
 		provider: "GitLab CI",
@@ -37692,394 +38022,6 @@ async function fetchNoResponse(url$2, options = {}) {
 	});
 }
 
-//#endregion
-//#region src/state/instrumented-state-store.ts
-var InstrumentedStateStore = class {
-	/** @internal */
-	__phantom;
-	stateStore;
-	stateStoreClass;
-	constructor(stateStore) {
-		this.stateStore = stateStore;
-		this.stateStoreClass = stateStore.constructor.name;
-	}
-	async callWithTelemetry(event, fn) {
-		const start = performance.now();
-		let error$84;
-		try {
-			return await fn();
-		} catch (err) {
-			error$84 = err;
-			throw err;
-		} finally {
-			await createAndSendEvent({
-				event,
-				stateStore: this.stateStoreClass,
-				duration: performance.now() - start
-			}, error$84 instanceof Error ? error$84 : error$84 ? new Error(String(error$84)) : void 0);
-		}
-	}
-	async init() {
-		if (this.stateStore.init == null) return;
-		await this.callWithTelemetry("statestore.init", this.stateStore.init.bind(this.stateStore));
-	}
-	async deinit() {
-		if (this.stateStore.deinit == null) return;
-		await this.callWithTelemetry("statestore.deinit", this.stateStore.deinit.bind(this.stateStore));
-	}
-	async list() {
-		return await this.callWithTelemetry("statestore.list", this.stateStore.list.bind(this.stateStore));
-	}
-	async count() {
-		return await this.callWithTelemetry("statestore.count", this.stateStore.count.bind(this.stateStore));
-	}
-	async get(key) {
-		return await this.callWithTelemetry("statestore.get", this.stateStore.get.bind(this.stateStore, key));
-	}
-	async getBatch(ids) {
-		return await this.callWithTelemetry("statestore.getBatch", this.stateStore.getBatch.bind(this.stateStore, ids));
-	}
-	async all() {
-		return await this.callWithTelemetry("statestore.all", this.stateStore.all.bind(this.stateStore));
-	}
-	async set(key, value) {
-		await this.callWithTelemetry("statestore.set", this.stateStore.set.bind(this.stateStore, key, value));
-	}
-	async delete(key) {
-		await this.callWithTelemetry("statestore.delete", this.stateStore.delete.bind(this.stateStore, key));
-	}
-};
-
-//#endregion
-//#region src/util/dedent.ts
-/**
-* Tagged template literal for removing indentation from a block of text.
-*
-* If the first line is empty, it will be ignored.
-*/
-function dedent(strings, ...values) {
-	let lines = String.raw({ raw: strings }, ...values).split("\n");
-	while (lines.length > 0 && lines[0].trim() === "") lines = lines.slice(1);
-	while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines = lines.slice(0, lines.length - 1);
-	if (lines.length === 0) return "";
-	let minIndentLength = Number.POSITIVE_INFINITY;
-	for (const line of lines) if (line.trim() !== "") {
-		const indent = line.match(/^[ \t]*/)?.[0];
-		if (indent != null && indent.length < minIndentLength) minIndentLength = indent.length;
-	}
-	if (minIndentLength === Number.POSITIVE_INFINITY) return lines.join("\n");
-	lines = lines.map((line) => {
-		if (line.trim() === "") return line;
-		return line.startsWith(" ".repeat(minIndentLength)) || line.startsWith("	".repeat(minIndentLength)) ? line.substring(minIndentLength) : line;
-	});
-	return lines.join("\n");
-}
-
-//#endregion
-//#region src/util/cli.ts
-const colors = {
-	reset: "\x1B[0m",
-	cyanBright: "\x1B[96m",
-	yellowBright: "\x1B[93m",
-	magenta: "\x1B[35m",
-	greenBright: "\x1B[92m",
-	redBright: "\x1B[91m",
-	gray: "\x1B[90m"
-};
-const shouldDisableColors = () => {
-	return Boolean(process.env.NO_COLOR);
-};
-const colorize = (text, color) => {
-	if (shouldDisableColors()) return text;
-	return `${colors[color]}${text}${colors.reset}`;
-};
-let loggers = {};
-const createLoggerInstance = (alchemyInfo, customLogger) => {
-	return loggers[alchemyInfo.appName] ??= customLogger ?? createFallbackLogger(alchemyInfo);
-};
-const createDummyLogger = () => {
-	return {
-		log: () => {},
-		error: () => {},
-		warn: () => {},
-		warnOnce: () => {},
-		task: () => {},
-		exit: () => {}
-	};
-};
-const createFallbackLogger = (alchemyInfo) => {
-	if (alchemyInfo.phase !== "read") console.log(dedent`
-      ${colorize("Alchemy", "cyanBright")} (v${package_default.version})
-      App: ${alchemyInfo.appName}
-      Phase: ${alchemyInfo.phase}
-      Stage: ${alchemyInfo.stage}
-      
-    `);
-	return {
-		log: console.log,
-		error: (...args) => console.error(colorize("ERROR", "redBright"), ...args),
-		warn: (...args) => console.warn(colorize("WARN", "yellowBright"), ...args),
-		warnOnce: (message) => {
-			globalThis._ALCHEMY_WARNINGS ??= /* @__PURE__ */ new Set();
-			if (globalThis._ALCHEMY_WARNINGS.has(message)) return;
-			globalThis._ALCHEMY_WARNINGS.add(message);
-			console.warn(colorize("WARN", "yellowBright"), message);
-		},
-		task: (_id, data) => {
-			const prefix = data.prefix ? `[${data.prefix}]` : "";
-			const paddedPrefix = prefix.padEnd(12);
-			const prefixWithColor = data.prefixColor && prefix ? colorize(paddedPrefix, data.prefixColor) : paddedPrefix;
-			const resource = data.resource ? colorize(data.resource, "gray") : "";
-			const message = data.message;
-			if (prefixWithColor && resource) console.log(`${prefixWithColor}${resource} ${message}`);
-			else if (prefixWithColor) console.log(`${prefixWithColor}${message}`);
-			else console.log(`${message}`);
-		},
-		exit: () => {}
-	};
-};
-const formatFQN = (fqn) => fqn.split("/").slice(2).join(" > ");
-
-//#endregion
-//#region src/util/mutex.ts
-/**
-* Simple async mutex that ensures only one async operation executes at a time
-*/
-var AsyncMutex = class {
-	locked = false;
-	queue = [];
-	async lock(operation) {
-		return new Promise((resolve$1, reject) => {
-			const execute = async () => {
-				this.locked = true;
-				try {
-					resolve$1(await operation());
-				} catch (error$84) {
-					reject(error$84);
-				} finally {
-					this.locked = false;
-					const next = this.queue.shift();
-					if (next) next();
-				}
-			};
-			if (this.locked) this.queue.push(execute);
-			else execute();
-		});
-	}
-};
-
-//#endregion
-//#region src/util/idempotent-spawn.ts
-/**
-* Idempotently ensure a long-lived child is running with stdout/stderr -> files,
-* and mirror those logs to THIS process's console with persisted offsets.
-*
-* Use: await ensureLoggedChildAndMirror({ cmd: "vite dev" })
-*/
-async function idempotentSpawn({ cmd, cwd: cwd$1, env: env$2, stateFile = "state.json", overlapBytes = 0, resume = false, log = "log.txt", processName, extract, isSameProcess, quiet = false }) {
-	if (!processName && !isSameProcess) processName = cmd.split(" ")[0];
-	const outPath = log;
-	await Promise.all([fs$1.mkdir(path$1.dirname(stateFile), { recursive: true }), fs$1.mkdir(path$1.dirname(log), { recursive: true })]);
-	const { promise: extracted, resolve: resolveExtracted } = Promise.withResolvers();
-	if (!extract) resolveExtracted(void 0);
-	const pid = await ensureChildRunning();
-	const write = quiet ? () => false : (buf) => process.stdout.write(buf);
-	await followFilePersisted(outPath, {
-		stateKey: `${path$1.resolve(outPath)}::stdout`,
-		write
-	});
-	return {
-		extracted,
-		stop: async () => pid ? await kill(pid) : void 0
-	};
-	function isPidAlive(pid$1) {
-		if (!pid$1 || Number.isNaN(pid$1)) return false;
-		try {
-			process.kill(pid$1, 0);
-			return true;
-		} catch {
-			return false;
-		}
-	}
-	async function writeJsonAtomic(file$2, data) {
-		const dir = path$1.dirname(file$2);
-		const tmp = path$1.join(dir, `.${path$1.basename(file$2)}.${process.pid}.${Date.now()}.tmp`);
-		await fs$1.writeFile(tmp, JSON.stringify(data, null, 2), { mode: 384 });
-		await fs$1.rename(tmp, file$2);
-	}
-	async function readJson$3(file$2) {
-		try {
-			return JSON.parse(await fs$1.readFile(file$2, "utf8"));
-		} catch {
-			return;
-		}
-	}
-	async function spawnLoggedChild() {
-		const out = await fs$1.open(outPath, "a");
-		const child = spawn(cmd, {
-			shell: true,
-			cwd: cwd$1,
-			stdio: [
-				"inherit",
-				out.fd,
-				out.fd
-			],
-			env: env$2,
-			detached: false
-		});
-		await out.close();
-		const stateAll = await readJson$3(stateFile) ?? {};
-		stateAll.pid = child.pid;
-		await writeJsonAtomic(stateFile, stateAll);
-		return child;
-	}
-	async function ensureChildRunning() {
-		const stateAll = await readJson$3(stateFile);
-		if (stateAll) {
-			const pid$1 = Number.parseInt(stateAll.pid, 10);
-			if (isPidAlive(pid$1)) return pid$1;
-			if (await isSameProcess?.(pid$1)) return pid$1;
-			if (processName) {
-				const processes = await find("pid", pid$1);
-				if (processes.length > 1) console.warn(`Found multiple processes with PID ${pid$1}, using the first one`);
-				if (processes.length > 0) {
-					if (processes[0].name.startsWith(processName)) return pid$1;
-				}
-			}
-		}
-		await Promise.all([fs$1.rm(stateFile).catch(() => {}), fs$1.rm(log).catch(() => {})]);
-		return (await spawnLoggedChild()).pid;
-	}
-	async function followFilePersisted(logPath, { write: write$1, chunkSize = 64 * 1024, tickMs = 100 }) {
-		logPath = path$1.resolve(logPath);
-		let state = await readJson$3(stateFile) ?? {};
-		let fh = await fs$1.open(logPath, "r");
-		let st = await fh.stat();
-		let ino = Number(st.ino ?? 0);
-		let dev$1 = Number(st.dev ?? 0);
-		let offset = resume && state.ino === ino && state.dev === dev$1 && typeof state.offset === "number" ? Math.max(0, Math.min(st.size, state.offset - overlapBytes)) : st.size;
-		let closed = false;
-		const drainMutex = new AsyncMutex();
-		let remainder;
-		if (offset > 0) {
-			const fullBuffer = Buffer.allocUnsafe(offset);
-			await fh.read({
-				position: 0,
-				buffer: fullBuffer,
-				length: offset
-			});
-			parse$10(fullBuffer.toString("utf8"));
-		}
-		await drain();
-		const watcher = fs.watch(logPath, async () => {
-			if (closed) return;
-			try {
-				const cur = await fh.stat();
-				const curIno = Number(cur.ino ?? 0);
-				const curDev = Number(cur.dev ?? 0);
-				if (curIno !== ino || curDev !== dev$1) {
-					await fh.close().catch(() => {});
-					fh = await fs$1.open(logPath, "r");
-					const cur2 = await fh.stat();
-					ino = Number(cur2.ino ?? 0);
-					dev$1 = Number(cur2.dev ?? 0);
-					offset = 0;
-				}
-			} catch {}
-			await drain();
-		});
-		const tick = setInterval(() => {
-			drain().catch(() => {});
-		}, tickMs);
-		return async function stop() {
-			closed = true;
-			watcher.close();
-			clearInterval(tick);
-			await fh.close().catch(() => {});
-			await persist();
-		};
-		async function persist() {
-			try {
-				const cur = await fh.stat();
-				state = {
-					...state,
-					offset,
-					ino: Number(cur.ino ?? ino),
-					dev: Number(cur.dev ?? dev$1),
-					size: cur.size,
-					mtimeMs: cur.mtimeMs
-				};
-				await writeJsonAtomic(stateFile, state);
-			} catch {}
-		}
-		function parse$10(content) {
-			const lines = content.split("\n");
-			if (extract) {
-				if (lines.length > 0) remainder = lines[lines.length - 1];
-				for (const line of lines.slice(0, -1)) {
-					const extracted$1 = extract(line);
-					if (extracted$1) {
-						resolveExtracted(extracted$1);
-						break;
-					}
-				}
-			}
-		}
-		function drain() {
-			return drainMutex.lock(async () => {
-				while (true) {
-					const cur = await fh.stat().catch(() => null);
-					if (!cur) break;
-					if (cur.size < offset) offset = 0;
-					const toRead = Math.min(chunkSize, cur.size - offset);
-					if (toRead <= 0) break;
-					const { bytesRead, buffer } = await fh.read({
-						position: offset,
-						buffer: Buffer.allocUnsafe(toRead),
-						length: toRead
-					});
-					if (!bytesRead) break;
-					const chunk = buffer.subarray(0, bytesRead);
-					write$1(chunk);
-					parse$10(`${remainder || ""}${chunk.toString("utf8")}`);
-					offset += bytesRead;
-				}
-				await persist();
-			});
-		}
-	}
-	async function kill(pid$1) {
-		try {
-			process.kill(pid$1, "SIGTERM");
-		} catch {
-			return;
-		}
-		if ((await find("pid", pid$1)).some((p$1) => p$1.name !== "<defunct>")) try {
-			process.kill(pid$1, "SIGKILL");
-		} catch {}
-	}
-}
-/**
-* The find-process package is a bit of a mess and has different behavior across runtimes (bun, tsx, node, etc.)
-*
-* This wrapper function defensively searches for the find function in the imported module.
-*
-* It confirmed to support:
-* 1. node
-* 2. bun
-* 3. tsx
-*
-* TODO(sam): check deno?
-*/
-const find = async (...args) => {
-	const findProcess = await import("find-process");
-	return (findProcess.default?.default ?? findProcess.default ?? findProcess.find ?? findProcess)(...args);
-};
-
-//#endregion
-//#region src/util/root-dir.ts
-const ALCHEMY_ROOT = process.env.ALCHEMY_ROOT ?? process.cwd();
-
 //#endregion
 //#region src/util/validate-resource-id.ts
 function validateResourceID(id, qualifier = "Resource") {
@@ -38187,7 +38129,7 @@ var Scope = class Scope {
 		this.destroyStrategy = 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.");
 		this.stateStore = stateStore ?? this.parent?.stateStore ?? ((scope) => new FileSystemStateStore(scope));
-		this.state = new InstrumentedStateStore(this.stateStore(this));
+		this.state = this.stateStore(this);
 		this.dataMutex = new AsyncMutex();
 	}
 	async has(id, type$1) {