alchemy 0.69.0 → 0.70.0

package/lib/util/diff.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns an array of keys in `b` that are different from `a`.
+ */
+export declare const diff: <T>(a: T, b: NoInfer<T>) => (keyof T)[];
+//# sourceMappingURL=diff.d.ts.map

package/lib/util/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/util/diff.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,gBAQ1C,CAAC"}

package/lib/util/diff.js

@@ -0,0 +1,14 @@
+import { isDeepStrictEqual } from "node:util";
+/**
+ * Returns an array of keys in `b` that are different from `a`.
+ */
+export const diff = (a, b) => {
+    const keys = [];
+    for (const key in a) {
+        if (!isDeepStrictEqual(a[key], b[key])) {
+            keys.push(key);
+        }
+    }
+    return keys;
+};
+//# sourceMappingURL=diff.js.map

package/lib/util/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/util/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,CAAI,EAAE,CAAa,EAAE,EAAE;IAC7C,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/lib/util/telemetry.d.ts

@@ -0,0 +1,52 @@
+import type { Phase } from "../alchemy.ts";
+export declare const CONFIG_PATH: string;
+export declare const CONFIG_PATH_LEGACY: string;
+export declare const TELEMETRY_DISABLED: boolean;
+export declare const TELEMETRY_API_URL: string;
+export declare const SUPPRESS_TELEMETRY_ERRORS: boolean;
+export declare const collectData: () => Promise<GenericTelemetryData>;
+export type GenericTelemetryData = {
+    userId: string;
+    sessionId: string;
+    platform: string;
+    osVersion: string;
+    arch: string;
+    cpus: number;
+    memory: number;
+    rootCommitHash: string;
+    gitOriginUrl: string;
+    gitBranchHash: string;
+    runtime: string;
+    runtimeVersion: string;
+    ciProvider: string;
+    isCI: boolean;
+    alchemyVersion: string;
+};
+export type ErrorData = {
+    errorTag: string;
+    errorMessage: string;
+    errorStack: string;
+};
+export type CliTelemetryData = {
+    command: string;
+    event: "cli.start" | "cli.success" | "cli.error";
+};
+export type ResourceTelemetryData = {
+    phase: Phase;
+    event: "resource.start" | "resource.success" | "resource.error" | "resource.skip" | "resource.read";
+    resource: string;
+    status: "creating" | "created" | "updating" | "updated" | "deleting" | "deleted" | "unknown";
+    duration: number;
+    replaced: boolean;
+};
+export type StateStoreTelemetryData = {
+    event: "statestore.init" | "statestore.deinit" | "statestore.list" | "statestore.count" | "statestore.get" | "statestore.getBatch" | "statestore.all" | "statestore.set" | "statestore.delete";
+    stateStore: string;
+    duration: number;
+};
+export type AlchemyTelemetryData = {
+    event: "alchemy.start" | "alchemy.success" | "alchemy.error";
+    duration: number;
+};
+export declare function createAndSendEvent(data: CliTelemetryData | ResourceTelemetryData | StateStoreTelemetryData | AlchemyTelemetryData, error?: Error): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

package/lib/util/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/util/telemetry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAK3C,eAAO,MAAM,WAAW,QAA4C,CAAC;AACrE,eAAO,MAAM,kBAAkB,QAG9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,SACyC,CAAC;AAEzE,eAAO,MAAM,iBAAiB,QAC4C,CAAC;AAC3E,eAAO,MAAM,yBAAyB,SACW,CAAC;AA8GlD,eAAO,MAAM,WAAW,qCAiCtB,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EACD,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,eAAe,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EACF,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EACD,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,eAAe,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,IAAI,EACA,gBAAgB,GAChB,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,EACxB,KAAK,CAAC,EAAE,KAAK,iBA0Bd"}

package/lib/util/telemetry.js

@@ -0,0 +1,191 @@
+import envPaths from "env-paths";
+import { exec } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "pathe";
+import pkg from "../../package.json" with { type: "json" };
+import { Scope } from "../scope.js";
+import { logger } from "./logger.js";
+import { memoize } from "./memoize.js";
+export const CONFIG_PATH = path.join(os.homedir(), ".alchemy", "id");
+export const CONFIG_PATH_LEGACY = path.join(envPaths("alchemy", { suffix: "" }).config, "id");
+export const TELEMETRY_DISABLED = !!process.env.ALCHEMY_TELEMETRY_DISABLED || !!process.env.DO_NOT_TRACK;
+export const TELEMETRY_API_URL = process.env.ALCHEMY_TELEMETRY_API_URL ?? "https://telemetry.alchemy.run";
+export const SUPPRESS_TELEMETRY_ERRORS = !!process.env.ALCHEMY_TELEMETRY_SUPPRESS_ERRORS;
+async function getOrCreateUserId() {
+    async function readUserId(path) {
+        try {
+            return (await readFile(path, "utf-8")).trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    const id = await readUserId(CONFIG_PATH);
+    if (id) {
+        return id;
+    }
+    const legacyId = await readUserId(CONFIG_PATH_LEGACY);
+    try {
+        const id = legacyId ?? crypto.randomUUID();
+        await mkdir(path.dirname(CONFIG_PATH), { recursive: true });
+        await writeFile(CONFIG_PATH, id);
+        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;
+    }
+    catch {
+        return null;
+    }
+}
+async function getRootCommitHash() {
+    return new Promise((resolve) => {
+        exec("git rev-list --max-parents=0 HEAD", (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+async function getGitOriginUrlHash() {
+    return new Promise((resolve) => {
+        exec("git config --get remote.origin.url", (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(hashString(stdout.trim()));
+        });
+    });
+}
+async function getBranchName() {
+    return new Promise((resolve) => {
+        exec("git rev-parse --abbrev-ref HEAD", (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+function getRuntime() {
+    if (globalThis.Bun)
+        return { name: "bun", version: Bun.version };
+    // @ts-expect-error
+    if (globalThis.Deno)
+        // @ts-expect-error
+        return { name: "deno", version: Deno.version?.deno ?? null };
+    // @ts-expect-error
+    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 = [
+    { env: "GITHUB_ACTIONS", provider: "GitHub Actions", isCI: true },
+    { env: "GITLAB_CI", provider: "GitLab CI", isCI: true },
+    { env: "CIRCLECI", provider: "CircleCI", isCI: true },
+    { env: "JENKINS_URL", provider: "Jenkins", isCI: true },
+    { env: "TRAVIS", provider: "Travis CI", isCI: true },
+    { env: "NOW_BUILDER", provider: "Vercel", isCI: true },
+    { env: "VERCEL", provider: "Vercel", isCI: false },
+];
+function getEnvironment() {
+    for (const provider of PROVIDERS) {
+        if (process.env[provider.env]) {
+            return {
+                provider: provider.provider,
+                isCI: provider.isCI,
+            };
+        }
+    }
+    return {
+        provider: null,
+        isCI: !!process.env.CI,
+    };
+}
+export const collectData = memoize(async () => {
+    const [userId, rootCommitHash, gitOriginUrlHash, branchHash, runtime, environment,] = await Promise.all([
+        getOrCreateUserId(),
+        getRootCommitHash(),
+        getGitOriginUrlHash(),
+        getBranchName().then(hashString),
+        getRuntime(),
+        getEnvironment(),
+    ]);
+    return {
+        userId: userId ?? "",
+        sessionId: crypto.randomUUID(),
+        platform: os.platform(),
+        osVersion: os.release(),
+        arch: os.arch(),
+        cpus: os.cpus().length,
+        memory: Math.round(os.totalmem() / 1024 / 1024),
+        rootCommitHash: rootCommitHash ?? "",
+        gitOriginUrl: gitOriginUrlHash ?? "",
+        gitBranchHash: branchHash ?? "",
+        runtime: runtime.name ?? "",
+        runtimeVersion: runtime.version ?? "",
+        ciProvider: environment.provider ?? "",
+        isCI: environment.isCI,
+        alchemyVersion: pkg.version,
+    };
+});
+export async function createAndSendEvent(data, error) {
+    if (Scope.getScope()?.noTrack || TELEMETRY_DISABLED) {
+        return;
+    }
+    try {
+        const eventData = {
+            ...data,
+            ...("duration" in data
+                ? { duration: Math.round(data.duration * 1000) }
+                : {}),
+            ...(await collectData()),
+            ...serializeError(error),
+        };
+        await fetch(TELEMETRY_API_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(eventData),
+        });
+    }
+    catch (error) {
+        if (!SUPPRESS_TELEMETRY_ERRORS) {
+            logger.warn("Failed to send telemetry event:", error);
+        }
+    }
+}
+async function hashString(input) {
+    if (input == null) {
+        return null;
+    }
+    const data = new TextEncoder().encode(input);
+    const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hashBuffer), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function serializeError(error) {
+    if (error instanceof Error) {
+        return {
+            errorTag: error.name ?? "",
+            errorMessage: error.message?.replaceAll(os.homedir(), "~") ?? "", // redact home directory
+            errorStack: error.stack?.replaceAll(os.homedir(), "~") ?? "",
+        };
+    }
+    return {
+        errorTag: "",
+        errorMessage: "",
+        errorStack: "",
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/lib/util/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/util/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,OAAO,CAAC;AACzB,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CACzC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAC1C,IAAI,CACL,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AAEzE,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,+BAA+B,CAAC;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC;AAElD,KAAK,UAAU,iBAAiB;IAC9B,KAAK,UAAU,UAAU,CAAC,IAAY;QACpC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACV;gBACE,8FAA8F;gBAC9F,mHAAmH;aACpH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,IAAI,CAAC,mCAAmC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACxD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,IAAI,CAAC,oCAAoC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACzD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,IAAI,CAAC,iCAAiC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACtD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,UAAU,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACjE,mBAAmB;IACnB,IAAI,UAAU,CAAC,IAAI;QACjB,mBAAmB;QACnB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;IAC/D,mBAAmB;IACnB,IAAI,UAAU,CAAC,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACtE,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,SAAS,GAAG;IAChB,EAAE,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;IACjE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IACvD,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE;IACrD,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE;IACvD,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;IACpD,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;IACtD,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;CAC1C,CAAC;AAEX,SAAS,cAAc;IACrB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAmC,EAAE;IAC3E,MAAM,CACJ,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,WAAW,EACZ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,iBAAiB,EAAE;QACnB,iBAAiB,EAAE;QACnB,mBAAmB,EAAE;QACrB,aAAa,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;QAChC,UAAU,EAAE;QACZ,cAAc,EAAE;KACjB,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;QAC9B,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;QACvB,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE;QACvB,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM;QACtB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;QAC/C,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,YAAY,EAAE,gBAAgB,IAAI,EAAE;QACpC,aAAa,EAAE,UAAU,IAAI,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QAC3B,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QACrC,UAAU,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;QACtC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,cAAc,EAAE,GAAG,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC,CAAC,CAAC;AAwEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAIwB,EACxB,KAAa;IAEb,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACpD,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG;YAChB,GAAG,IAAI;YACP,GAAG,CAAC,UAAU,IAAI,IAAI;gBACpB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE;gBAChD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,MAAM,WAAW,EAAE,CAAC;YACxB,GAAG,cAAc,CAAC,KAAK,CAAC;SACzB,CAAC;QACF,MAAM,KAAK,CAAC,iBAAiB,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,yBAAyB,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAoB;IAC5C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CACnC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,KAAwB;IAC9C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YAC1B,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,wBAAwB;YAC1F,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE;SAC7D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",
@@ -40,6 +40,14 @@
       "bun": "./src/llms.ts",
       "import": "./lib/llms.js"
     },
+    "./coinbase": {
+      "bun": "./src/coinbase/index.ts",
+      "import": "./lib/coinbase/index.js"
+    },
+    "./coinbase/faucet": {
+      "bun": "./src/coinbase/faucet.ts",
+      "import": "./lib/coinbase/faucet.js"
+    },
     "./aws": {
       "bun": "./src/aws/index.ts",
       "import": "./lib/aws/index.js"
@@ -52,6 +60,10 @@
       "bun": "./src/aws/oidc/index.ts",
       "import": "./lib/aws/oidc/index.js"
     },
+    "./clickhouse": {
+      "bun": "./src/clickhouse/index.ts",
+      "import": "./lib/clickhouse/index.js"
+    },
     "./cloudflare": {
       "bun": "./src/cloudflare/index.ts",
       "import": "./lib/cloudflare/index.js"
@@ -150,6 +162,7 @@
     "@cloudflare/unenv-preset": "^2.6.3",
     "@iarna/toml": "^2.2.5",
     "@smithy/node-config-provider": "^4.0.0",
+    "@smithy/types": "^4.6.0",
     "aws4fetch": "^1.0.20",
     "env-paths": "^3.0.0",
     "esbuild": "^0.25.1",
@@ -175,6 +188,7 @@
   "peerDependencies": {
     "@astrojs/cloudflare": "^12.6.4",
     "@aws-sdk/client-dynamodb": "^3.0.0",
+    "@coinbase/cdp-sdk": "^0.10.0",
     "@aws-sdk/client-iam": "^3.0.0",
     "@aws-sdk/client-lambda": "^3.0.0",
     "@aws-sdk/client-s3": "^3.0.0",
@@ -196,6 +210,9 @@
     "@astrojs/cloudflare": {
       "optional": true
     },
+    "@coinbase/cdp-sdk": {
+      "optional": true
+    },
     "@aws-sdk/client-dynamodb": {
       "optional": true
     },
@@ -264,6 +281,7 @@
     "@cloudflare/puppeteer": "^1.0.2",
     "@cloudflare/vite-plugin": "^1.11.6",
     "@cloudflare/workers-types": "^4.20250805.0",
+    "@coinbase/cdp-sdk": "^1.38.2",
     "@libsql/client": "^0.15.12",
     "@octokit/rest": "^21.1.1",
     "@sentry/cloudflare": "^9.43.0",

package/src/alchemy.ts

@@ -17,7 +17,6 @@ import { secret } from "./secret.ts";
 import type { StateStoreType } from "./state.ts";
 import type { LoggerApi } from "./util/cli.ts";
 import { ALCHEMY_ROOT } from "./util/root-dir.ts";
-import { TelemetryClient } from "./util/telemetry/client.ts";
 
 /**
  * Type alias for semantic highlighting of `alchemy` as a type keyword
@@ -162,20 +161,13 @@ If this is a mistake, you can disable this check by setting the ALCHEMY_CI_STATE
   }
 
   const phase = mergedOptions?.phase ?? "up";
-  const telemetryClient =
-    mergedOptions?.parent?.telemetryClient ??
-    TelemetryClient.create({
-      phase,
-      enabled: mergedOptions?.telemetry ?? true,
-      quiet: mergedOptions?.quiet ?? false,
-    });
   const root = new Scope({
     ...mergedOptions,
     parent: undefined,
     scopeName: appName,
     phase,
     password: mergedOptions?.password ?? process.env.ALCHEMY_PASSWORD,
-    telemetryClient,
+    noTrack: mergedOptions?.noTrack ?? false,
     isSelected: app === undefined ? undefined : app === appName,
   });
   onExit((code) => {
@@ -280,12 +272,12 @@ export interface AlchemyOptions {
    */
   password?: string;
   /**
-   * Whether to send anonymous telemetry data to the Alchemy team.
+   * Whether to stop sending anonymous telemetry data to the Alchemy team.
    * You can also opt out by setting the `DO_NOT_TRACK` or `ALCHEMY_TELEMETRY_DISABLED` environment variables to a truthy value.
    *
-   * @default true
+   * @default false
    */
-  telemetry?: boolean;
+  noTrack?: boolean;
   /**
    * A custom logger instance to use for this scope.
    * If not provided, the default fallback logger will be used.
@@ -353,18 +345,11 @@ async function run<T>(
           RunOptions,
           (this: Scope, scope: Scope) => Promise<T>,
         ]);
-  const telemetryClient =
-    options?.parent?.telemetryClient ??
-    TelemetryClient.create({
-      phase: options?.phase ?? "up",
-      enabled: options?.telemetry ?? true,
-      quiet: options?.quiet ?? false,
-    });
   const _scope = new Scope({
     ...options,
     parent: options?.parent,
     scopeName: id,
-    telemetryClient,
+    noTrack: options?.noTrack ?? false,
   });
   let noop = options?.noop ?? false;
   try {

package/src/apply.ts

@@ -19,7 +19,7 @@ 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";
+import { createAndSendEvent } from "./util/telemetry.ts";
 
 export interface ApplyOptions {
   quiet?: boolean;
@@ -83,9 +83,13 @@ async function _apply<Out extends ResourceAttributes>(
         // we are running in a monorepo and are not the selected app, so we need to wait for the process to be consistent
         state = await waitForConsistentState();
       }
-      scope.telemetryClient.record({
+      createAndSendEvent({
         event: "resource.read",
+        phase: scope.phase,
+        duration: performance.now() - start,
+        status: state.status,
         resource: resource[ResourceKind],
+        replaced: false,
       });
       return state.output as Awaited<Out> & Resource;
 
@@ -179,10 +183,13 @@ async function _apply<Out extends ResourceAttributes>(
             status: "success",
           });
         }
-        scope.telemetryClient.record({
+        createAndSendEvent({
           event: "resource.skip",
           resource: resource[ResourceKind],
           status: state.status,
+          phase: scope.phase,
+          duration: performance.now() - start,
+          replaced: false,
         });
         return state.output as Awaited<Out> & Resource;
       }
@@ -202,10 +209,13 @@ async function _apply<Out extends ResourceAttributes>(
       });
     }
 
-    scope.telemetryClient.record({
+    createAndSendEvent({
       event: "resource.start",
       resource: resource[ResourceKind],
       status: state.status,
+      phase: scope.phase,
+      duration: performance.now() - start,
+      replaced: false,
     });
 
     await scope.state.set(resource[ResourceID], state);
@@ -326,11 +336,12 @@ async function _apply<Out extends ResourceAttributes>(
     }
 
     const status = phase === "create" ? "created" : "updated";
-    scope.telemetryClient.record({
+    createAndSendEvent({
       event: "resource.success",
       resource: resource[ResourceKind],
       status,
-      elapsed: performance.now() - start,
+      phase: scope.phase,
+      duration: performance.now() - start,
       replaced: isReplaced,
     });
 
@@ -347,12 +358,18 @@ async function _apply<Out extends ResourceAttributes>(
     });
     return output as Awaited<Out> & Resource;
   } catch (error) {
-    scope.telemetryClient.record({
-      event: "resource.error",
-      resource: resource[ResourceKind],
-      error: error as Telemetry.ErrorInput,
-      elapsed: performance.now() - start,
-    });
+    let errorToSend = error instanceof Error ? error : new Error(String(error));
+    createAndSendEvent(
+      {
+        event: "resource.error",
+        resource: resource[ResourceKind],
+        duration: performance.now() - start,
+        phase: scope.phase,
+        status: "unknown",
+        replaced: false,
+      },
+      errorToSend,
+    );
     scope.fail();
     throw error;
   }

package/src/aws/utils.ts

@@ -1,12 +1,13 @@
 import { fromNodeProviderChain } from "@aws-sdk/credential-providers";
 import { loadConfig } from "@smithy/node-config-provider";
+import type { Provider } from "@smithy/types";
 import { AwsClient } from "aws4fetch";
 import { flattenParams } from "../util/params.ts";
 
 /**
  * Get AWS region from configuration
  */
-export const getRegion = loadConfig({
+export const getRegion: Provider<string> = loadConfig({
   environmentVariableSelector: (env: any) =>
     env.AWS_REGION || env.AWS_DEFAULT_REGION,
   configFileSelector: (profile: any) => profile.region,

package/src/clickhouse/api/client.gen.ts

@@ -0,0 +1,28 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import {
+  type ClientOptions,
+  type Config,
+  createClient,
+  createConfig,
+} from "../../util/api/client/index.ts";
+import type { ClientOptions as ClientOptions2 } from "./types.gen.ts";
+
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (
+  override?: Config<ClientOptions & T>,
+) => Config<Required<ClientOptions> & T>;
+
+export const client = createClient(
+  createConfig<ClientOptions2>({
+    baseUrl: "https://api.clickhouse.cloud",
+    throwOnError: true,
+  }),
+);