alchemy 2.0.0-beta.18 → 2.0.0-beta.19

package/lib/Telemetry/Attributes.js

@@ -0,0 +1,144 @@
+import { exec } from "node:child_process";
+import * as crypto from "node:crypto";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as nodePath from "node:path";
+import * as Effect from "effect/Effect";
+import packageJson from "../../package.json" with { type: "json" };
+const ALCHEMY_DIR = nodePath.join(os.homedir(), ".alchemy");
+const ID_PATH = nodePath.join(ALCHEMY_DIR, "id");
+const DISABLED_PATH = nodePath.join(ALCHEMY_DIR, "telemetry-disabled");
+const tryRead = (path) => Effect.tryPromise({
+    try: () => fs.readFile(path, "utf-8").then((s) => s.trim()),
+    catch: () => null,
+}).pipe(Effect.catch(() => Effect.succeed(null)));
+const sha256Hex = (input) => crypto.createHash("sha256").update(input).digest("hex");
+const hashStringOrEmpty = (input) => input == null || input === "" ? "" : sha256Hex(input);
+const execCapture = (cmd) => Effect.callback((resume) => {
+    exec(cmd, { timeout: 1500 }, (err, stdout) => {
+        if (err) {
+            resume(Effect.succeed(null));
+            return;
+        }
+        resume(Effect.succeed(stdout.toString().trim()));
+    });
+});
+const getOrCreateUserId = Effect.gen(function* () {
+    const existing = yield* tryRead(ID_PATH);
+    if (existing)
+        return existing;
+    const id = crypto.randomUUID();
+    yield* Effect.tryPromise({
+        try: async () => {
+            await fs.mkdir(ALCHEMY_DIR, { recursive: true });
+            await fs.writeFile(ID_PATH, id);
+        },
+        catch: () => null,
+    }).pipe(Effect.catch(() => Effect.void));
+    return id;
+});
+const getRootCommitHash = execCapture(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 {}'`);
+const getGitOriginUrl = execCapture("git config --get remote.origin.url");
+const getBranchName = execCapture("git rev-parse --abbrev-ref HEAD");
+const getRuntime = () => {
+    const g = globalThis;
+    if (typeof g.Bun !== "undefined") {
+        return { name: "bun", version: g.Bun.version };
+    }
+    if (typeof g.Deno !== "undefined") {
+        return { name: "deno", version: g.Deno.version?.deno ?? "" };
+    }
+    if (globalThis.process?.versions?.node) {
+        return { name: "node", version: process.versions.node };
+    }
+    return { name: "", version: "" };
+};
+const CI_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: "BUILDKITE", provider: "Buildkite", isCI: true },
+    { env: "NOW_BUILDER", provider: "Vercel", isCI: true },
+    { env: "VERCEL", provider: "Vercel", isCI: false },
+];
+const getCIEnvironment = () => {
+    for (const p of CI_PROVIDERS) {
+        if (process.env[p.env]) {
+            return { provider: p.provider, isCI: p.isCI };
+        }
+    }
+    return { provider: "", isCI: !!process.env.CI };
+};
+const TELEMETRY_DISABLED_ENV = () => !!process.env.ALCHEMY_TELEMETRY_DISABLED ||
+    !!process.env.DO_NOT_TRACK ||
+    !!process.env.NO_TRACK;
+/**
+ * `true` if telemetry is disabled via environment variable
+ * (`DO_NOT_TRACK`, `NO_TRACK`, `ALCHEMY_TELEMETRY_DISABLED`) or via a
+ * persisted opt-out file at `~/.alchemy/telemetry-disabled`.
+ */
+export const isTelemetryDisabled = Effect.gen(function* () {
+    if (TELEMETRY_DISABLED_ENV())
+        return true;
+    const persisted = yield* tryRead(DISABLED_PATH);
+    return persisted === "true";
+});
+/**
+ * Persists an opt-out so future invocations skip telemetry without needing
+ * an env var.
+ */
+export const setTelemetryDisabled = Effect.tryPromise({
+    try: async () => {
+        await fs.mkdir(ALCHEMY_DIR, { recursive: true });
+        await fs.writeFile(DISABLED_PATH, "true");
+    },
+    catch: () => null,
+}).pipe(Effect.catch(() => Effect.void));
+export const setTelemetryEnabled = Effect.tryPromise({
+    try: () => fs.rm(DISABLED_PATH, { force: true }),
+    catch: () => null,
+}).pipe(Effect.catch(() => Effect.void));
+const collectAttributesUncached = Effect.gen(function* () {
+    const [userId, rootCommit, originUrl, branch] = yield* Effect.all([
+        getOrCreateUserId,
+        getRootCommitHash,
+        getGitOriginUrl,
+        getBranchName,
+    ], { concurrency: "unbounded" });
+    const runtime = getRuntime();
+    const ci = getCIEnvironment();
+    return {
+        "alchemy.user.id": userId,
+        "alchemy.session.id": process.env.ALCHEMY_TELEMETRY_SESSION_ID ?? crypto.randomUUID(),
+        "alchemy.version": packageJson.version,
+        "alchemy.git.root_commit": rootCommit ?? "",
+        "alchemy.git.origin_hash": hashStringOrEmpty(originUrl),
+        "alchemy.git.branch_hash": hashStringOrEmpty(branch),
+        "alchemy.runtime.name": runtime.name,
+        "alchemy.runtime.version": runtime.version,
+        "alchemy.ci.provider": ci.provider,
+        "alchemy.ci": ci.isCI,
+        "host.arch": os.arch(),
+        "os.type": os.platform(),
+        "os.version": os.release(),
+        "host.cpus": os.cpus().length,
+        "host.memory_mb": Math.round(os.totalmem() / 1024 / 1024),
+    };
+});
+let cachedAttrs;
+/**
+ * Resolves the {@link TelemetryAttributes} for the current process. Cached
+ * so file I/O and `git` invocations only run once per CLI invocation; every
+ * subsequent caller gets the same record (and therefore the same session
+ * id).
+ */
+export const collectAttributes = Effect.suspend(() => cachedAttrs !== undefined
+    ? Effect.succeed(cachedAttrs)
+    : collectAttributesUncached.pipe(Effect.tap((a) => Effect.sync(() => {
+        cachedAttrs = a;
+    }))));
+//# sourceMappingURL=Attributes.js.map

package/lib/Telemetry/Attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attributes.js","sourceRoot":"","sources":["../../src/Telemetry/Attributes.ts"],"names":[],"mappings":"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"}

package/lib/Telemetry/Layer.d.ts

@@ -0,0 +1,14 @@
+import * as Layer from "effect/Layer";
+/**
+ * The CLI's telemetry layer. Builds an OTLP HTTP exporter that ships spans
+ * to {@link TRACES_URL} and metrics to {@link METRICS_URL}, attaching
+ * {@link collectAttributes} as resource-level attributes so every signal
+ * carries user/project/runtime context.
+ *
+ * If the user has opted out (via `DO_NOT_TRACK`, `NO_TRACK`,
+ * `ALCHEMY_TELEMETRY_DISABLED`, or `~/.alchemy/telemetry-disabled`), this
+ * resolves to {@link Layer.empty}. Effect's default `Tracer` is a no-op,
+ * so all `withSpan`/`Effect.fn` instrumentation in core stays free.
+ */
+export declare const TelemetryLive: Layer.Layer<never, never, never>;
+//# sourceMappingURL=Layer.d.ts.map

package/lib/Telemetry/Layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layer.d.ts","sourceRoot":"","sources":["../../src/Telemetry/Layer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AA2CtC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CASxD,CAAC"}

package/lib/Telemetry/Layer.js

@@ -0,0 +1,50 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
+import * as OtlpMetrics from "effect/unstable/observability/OtlpMetrics";
+import * as OtlpSerialization from "effect/unstable/observability/OtlpSerialization";
+import * as OtlpTracer from "effect/unstable/observability/OtlpTracer";
+import packageJson from "../../package.json" with { type: "json" };
+import { collectAttributes, isTelemetryDisabled } from "./Attributes.js";
+const TRACES_URL = "https://otel.alchemy.run/v1/traces";
+const METRICS_URL = "https://otel.alchemy.run/v1/metrics";
+const SERVICE_NAME = "alchemy-cli";
+const buildOtlpLayer = (attrs) => {
+    const resource = {
+        serviceName: SERVICE_NAME,
+        serviceVersion: packageJson.version,
+        attributes: attrs,
+    };
+    // Short export intervals so even sub-second CLI invocations flush at
+    // least one batch before the process exits.
+    const tracer = OtlpTracer.layer({
+        url: TRACES_URL,
+        resource,
+        exportInterval: "1 second",
+    });
+    const metrics = OtlpMetrics.layer({
+        url: METRICS_URL,
+        resource,
+        exportInterval: "1 second",
+    });
+    return Layer.mergeAll(tracer, metrics).pipe(Layer.provide(OtlpSerialization.layerJson), Layer.provide(FetchHttpClient.layer));
+};
+/**
+ * The CLI's telemetry layer. Builds an OTLP HTTP exporter that ships spans
+ * to {@link TRACES_URL} and metrics to {@link METRICS_URL}, attaching
+ * {@link collectAttributes} as resource-level attributes so every signal
+ * carries user/project/runtime context.
+ *
+ * If the user has opted out (via `DO_NOT_TRACK`, `NO_TRACK`,
+ * `ALCHEMY_TELEMETRY_DISABLED`, or `~/.alchemy/telemetry-disabled`), this
+ * resolves to {@link Layer.empty}. Effect's default `Tracer` is a no-op,
+ * so all `withSpan`/`Effect.fn` instrumentation in core stays free.
+ */
+export const TelemetryLive = Layer.unwrap(Effect.gen(function* () {
+    if (yield* isTelemetryDisabled) {
+        return Layer.empty;
+    }
+    const attrs = yield* collectAttributes;
+    return buildOtlpLayer(attrs);
+}));
+//# sourceMappingURL=Layer.js.map

package/lib/Telemetry/Layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layer.js","sourceRoot":"","sources":["../../src/Telemetry/Layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,WAAW,MAAM,2CAA2C,CAAC;AACzE,OAAO,KAAK,iBAAiB,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,UAAU,MAAM,0CAA0C,CAAC;AAEvE,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,UAAU,GAAG,oCAAoC,CAAC;AACxD,MAAM,WAAW,GAAG,qCAAqC,CAAC;AAE1D,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,MAAM,cAAc,GAAG,CACrB,KAA8B,EACI,EAAE;IACpC,MAAM,QAAQ,GAAG;QACf,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,WAAW,CAAC,OAAO;QACnC,UAAU,EAAE,KAAK;KAClB,CAAC;IAEF,qEAAqE;IACrE,4CAA4C;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,GAAG,EAAE,UAAU;QACf,QAAQ;QACR,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC;QAChC,GAAG,EAAE,WAAW;QAChB,QAAQ;QACR,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CACzC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAC1C,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CACrC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,KAAK,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC;IACvC,OAAO,cAAc,CAAC,KAA2C,CAAC,CAAC;AACrE,CAAC,CAAC,CACH,CAAC"}

package/lib/Telemetry/Metrics.d.ts

@@ -0,0 +1,34 @@
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Metric from "effect/Metric";
+/**
+ * Counter for resource lifecycle operations. Tagged per call with
+ * `resource_type`, `op` (`precreate`/`create`/`update`/`delete`/`read`),
+ * and `status` (`success`/`error`).
+ */
+export declare const resourceCounter: Metric.Counter<number>;
+/**
+ * Histogram of how long each lifecycle operation takes.
+ */
+export declare const resourceDuration: Metric.Histogram<Duration.Duration>;
+/**
+ * Counter for CLI command invocations.
+ */
+export declare const cliCounter: Metric.Counter<number>;
+/**
+ * Wraps a resource lifecycle Effect to record a counter + timer entry,
+ * tagged with `resource_type`, `op`, and `status` (`success`/`error`).
+ *
+ * Usage:
+ * ```ts
+ * provider.create(input).pipe(recordResourceOp(node.resource.Type, "create"))
+ * ```
+ */
+export declare const recordResourceOp: (resourceType: string, op: ResourceOp) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Wraps a CLI command Effect to bump {@link cliCounter} with the
+ * outcome (`success`/`error`).
+ */
+export declare const recordCli: (command: string) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+export type ResourceOp = "precreate" | "create" | "update" | "delete" | "read";
+//# sourceMappingURL=Metrics.d.ts.map

package/lib/Telemetry/Metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../../src/Telemetry/Metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,eAAe,wBAI1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,qCAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,wBAGrB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC1B,cAAc,MAAM,EAAE,IAAI,UAAU,MACpC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAa1D,CAAC;AAEP;;;GAGG;AACH,eAAO,MAAM,SAAS,GACnB,SAAS,MAAM,MACf,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAW3D,CAAC;AAEN,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC"}

package/lib/Telemetry/Metrics.js

@@ -0,0 +1,57 @@
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Metric from "effect/Metric";
+/**
+ * Counter for resource lifecycle operations. Tagged per call with
+ * `resource_type`, `op` (`precreate`/`create`/`update`/`delete`/`read`),
+ * and `status` (`success`/`error`).
+ */
+export const resourceCounter = Metric.counter("alchemy.resource.operations", {
+    description: "Number of resource lifecycle operations dispatched by alchemy apply.",
+    incremental: true,
+});
+/**
+ * Histogram of how long each lifecycle operation takes.
+ */
+export const resourceDuration = Metric.timer("alchemy.resource.duration", {
+    description: "Wall-clock duration of resource lifecycle operations dispatched by alchemy apply.",
+});
+/**
+ * Counter for CLI command invocations.
+ */
+export const cliCounter = Metric.counter("alchemy.cli.invocations", {
+    description: "Number of alchemy CLI command invocations.",
+    incremental: true,
+});
+/**
+ * Wraps a resource lifecycle Effect to record a counter + timer entry,
+ * tagged with `resource_type`, `op`, and `status` (`success`/`error`).
+ *
+ * Usage:
+ * ```ts
+ * provider.create(input).pipe(recordResourceOp(node.resource.Type, "create"))
+ * ```
+ */
+export const recordResourceOp = (resourceType, op) => (self) => Effect.suspend(() => {
+    const startNs = process.hrtime.bigint();
+    const baseAttrs = { resource_type: resourceType, op };
+    return self.pipe(Effect.onExit((exit) => recordOutcome(baseAttrs, Exit.isSuccess(exit) ? "success" : "error", elapsed(startNs))));
+});
+/**
+ * Wraps a CLI command Effect to bump {@link cliCounter} with the
+ * outcome (`success`/`error`).
+ */
+export const recordCli = (command) => (self) => self.pipe(Effect.onExit((exit) => Metric.update(Metric.withAttributes(cliCounter, {
+    command,
+    status: Exit.isSuccess(exit) ? "success" : "error",
+}), 1)));
+const elapsed = (startNs) => Duration.nanos(process.hrtime.bigint() - startNs);
+const recordOutcome = (baseAttrs, status, duration) => {
+    const attrs = { ...baseAttrs, status };
+    return Effect.all([
+        Metric.update(Metric.withAttributes(resourceCounter, attrs), 1),
+        Metric.update(Metric.withAttributes(resourceDuration, attrs), duration),
+    ], { discard: true });
+};
+//# sourceMappingURL=Metrics.js.map

package/lib/Telemetry/Metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.js","sourceRoot":"","sources":["../../src/Telemetry/Metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE;IAC3E,WAAW,EACT,sEAAsE;IACxE,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;IACxE,WAAW,EACT,mFAAmF;CACtF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE;IAClE,WAAW,EAAE,4CAA4C;IACzD,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAAC,YAAoB,EAAE,EAAc,EAAE,EAAE,CACzC,CAAU,IAA4B,EAA0B,EAAE,CAChE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;IAClB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,EAAW,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CACd,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACrB,aAAa,CACX,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAC1C,OAAO,CAAC,OAAO,CAAC,CACjB,CACF,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEP;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GACpB,CAAC,OAAe,EAAE,EAAE,CACpB,CAAU,IAA4B,EAA0B,EAAE,CAChE,IAAI,CAAC,IAAI,CACP,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACrB,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE;IAChC,OAAO;IACP,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;CACnD,CAAC,EACF,CAAC,CACF,CACF,CACF,CAAC;AASN,MAAM,OAAO,GAAG,CAAC,OAAe,EAAqB,EAAE,CACrD,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;AAEpD,MAAM,aAAa,GAAG,CACpB,SAAoD,EACpD,MAA2B,EAC3B,QAA2B,EACN,EAAE;IACvB,MAAM,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC,GAAG,CACf;QACE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;KACxE,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "2.0.0-beta.18",
+  "version": "2.0.0-beta.19",
   "homepage": "https://alchemy.run",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
@@ -136,6 +136,12 @@
       "worker": "./src/Cloudflare/*/index.ts",
       "import": "./lib/Cloudflare/*/index.js"
     },
+    "./Axiom": {
+      "types": "./src/Axiom/index.ts",
+      "bun": "./src/Axiom/index.ts",
+      "worker": "./src/Axiom/index.ts",
+      "import": "./lib/Axiom/index.js"
+    },
     "./GitHub": {
       "types": "./src/GitHub/index.ts",
       "bun": "./src/GitHub/index.ts",
@@ -232,6 +238,7 @@
     "@aws-sdk/credential-providers": "^3.0.0",
     "@clack/prompts": "^0.11.0",
     "@distilled.cloud/aws": "^0.12.5",
+    "@distilled.cloud/axiom": "^0.12.5",
     "@distilled.cloud/cloudflare": "^0.12.5",
     "@distilled.cloud/cloudflare-rolldown-plugin": "0.3.0",
     "@distilled.cloud/cloudflare-vite-plugin": "0.2.0",
@@ -254,6 +261,8 @@
     "ignore": "^7.0.5",
     "jszip": "^3.10.1",
     "libsodium-wrappers": "^0.8.3",
+    "magic-string": "^0.30.21",
+    "picomatch": "^4.0.4",
     "rolldown": "1.0.0-rc.13",
     "sonda": "^0.11.1",
     "web-tree-sitter": "0.25.10",
@@ -266,9 +275,11 @@
     "@effect/platform-bun": "4.0.0-beta.48",
     "@effect/platform-node": "4.0.0-beta.48",
     "@effect/platform-node-shared": "4.0.0-beta.48",
+    "@oxc-project/types": "^0.127.0",
     "@types/aws-lambda": "^8.10.152",
     "@types/bun": "latest",
     "@types/node": "latest",
+    "@types/picomatch": "^4.0.0",
     "@types/react": "^19.2.2",
     "better-auth": "^1.6.2",
     "effect": "4.0.0-beta.48",

package/src/Apply.ts

@@ -25,6 +25,7 @@ import { findProviderByType } from "./Provider.ts";
 import type { ResourceBinding } from "./Resource.ts";
 import { Stack } from "./Stack.ts";
 import { Stage } from "./Stage.ts";
+import { recordResourceOp, type ResourceOp } from "./Telemetry/Metrics.ts";
 import {
   type CreatedResourceState,
   type CreatingResourceState,
@@ -81,6 +82,41 @@ const provideLifecycleScope =
       ),
     ) as Effect.Effect<A, E, Exclude<R, InstanceId | Artifacts>>;
 
+/**
+ * Instruments a single provider lifecycle call with an OTel span
+ * (`provider.<op>`), the resource counter / duration histogram, and the
+ * scoped artifacts/instance services normally supplied by
+ * {@link provideLifecycleScope}.
+ *
+ * This is the only call site through which provider lifecycle methods
+ * are dispatched, so wrapping it here gives us a fully-instrumented
+ * toolchain without touching any individual provider implementation.
+ */
+const instrumentLifecycle =
+  (
+    op: ResourceOp,
+    fqn: string,
+    resourceType: string,
+    logicalId: string,
+    instanceId: string,
+  ) =>
+  <A, E, R>(
+    effect: Effect.Effect<A, E, R>,
+  ): Effect.Effect<A, E, Exclude<R, InstanceId | Artifacts>> =>
+    effect.pipe(
+      provideLifecycleScope(fqn, instanceId),
+      recordResourceOp(resourceType, op),
+      Effect.withSpan(`provider.${op}`, {
+        attributes: {
+          "alchemy.resource.fqn": fqn,
+          "alchemy.resource.type": resourceType,
+          "alchemy.resource.logical_id": logicalId,
+          "alchemy.resource.instance_id": instanceId,
+          "alchemy.resource.op": op,
+        },
+      }),
+    );
+
 export const apply = <P extends Plan>(
   plan: P,
 ): Effect.Effect<
@@ -149,7 +185,15 @@ export const apply = <P extends Plan>(
       Object.entries(tracker).map(([fqn, t]) => [fqn, t.output]),
     );
     return yield* Output.evaluate(plan.output, outputs);
-  }).pipe(ensureArtifactStore);
+  }).pipe(
+    ensureArtifactStore,
+    Effect.withSpan("apply", {
+      attributes: {
+        "alchemy.resources.count": Object.keys(plan.resources).length,
+        "alchemy.deletions.count": Object.keys(plan.deletions).length,
+      },
+    }),
+  );
 
 // ── Phase 1: concurrent initial execution ──────────────────────────────────
 //
@@ -411,7 +455,15 @@ const executeNode = (
               instanceId,
               bindings: excludeDeletedBindings(node.bindings),
             })
-            .pipe(provideLifecycleScope(fqn, instanceId));
+            .pipe(
+              instrumentLifecycle(
+                "precreate",
+                fqn,
+                node.resource.Type,
+                logicalId,
+                instanceId,
+              ),
+            );
           yield* commit<CreatingResourceState>({
             status: "creating",
             fqn,
@@ -458,7 +510,15 @@ const executeNode = (
             session: scopedSession,
             output: attr,
           })
-          .pipe(provideLifecycleScope(fqn, instanceId));
+          .pipe(
+            instrumentLifecycle(
+              "create",
+              fqn,
+              node.resource.Type,
+              logicalId,
+              instanceId,
+            ),
+          );
 
         yield* commit<CreatedResourceState>({
           status: "created",
@@ -557,7 +617,15 @@ const executeNode = (
             // @ts-expect-error - type system says this can be undefined, can it be?
             output: node.state.attr,
           })
-          .pipe(provideLifecycleScope(fqn, instanceId));
+          .pipe(
+            instrumentLifecycle(
+              "update",
+              fqn,
+              node.resource.Type,
+              logicalId,
+              instanceId,
+            ),
+          );
 
         if (node.state.status === "replaced") {
           yield* commit<ReplacedResourceState>({
@@ -657,7 +725,15 @@ const executeNode = (
               instanceId,
               bindings: excludeDeletedBindings(node.bindings),
             })
-            .pipe(provideLifecycleScope(fqn, instanceId));
+            .pipe(
+              instrumentLifecycle(
+                "precreate",
+                fqn,
+                node.resource.Type,
+                logicalId,
+                instanceId,
+              ),
+            );
           yield* commit<ReplacingResourceState>({
             status: "replacing",
             fqn,
@@ -706,7 +782,15 @@ const executeNode = (
             session: scopedSession,
             output: attr,
           })
-          .pipe(provideLifecycleScope(fqn, instanceId));
+          .pipe(
+            instrumentLifecycle(
+              "create",
+              fqn,
+              node.resource.Type,
+              logicalId,
+              instanceId,
+            ),
+          );
 
         yield* commit<ReplacedResourceState>({
           // Creation of the new generation succeeded; from here on the only remaining
@@ -745,7 +829,16 @@ const executeNode = (
       // @ts-expect-error - node is never, this should be unreachable
       return yield* Effect.die(`Unknown action: ${node.action}`);
     });
-  }) as Effect.Effect<void, never, never>;
+  }).pipe(
+    Effect.withSpan("apply.resource", {
+      attributes: {
+        "alchemy.resource.fqn": fqn,
+        "alchemy.resource.type": node.resource.Type,
+        "alchemy.resource.logical_id": node.resource.LogicalId,
+        "alchemy.resource.action": node.action,
+      },
+    }),
+  ) as Effect.Effect<void, never, never>;
 
 // ── Phase 3: imperative convergence loop ───────────────────────────────────
 //
@@ -830,7 +923,15 @@ const converge = Effect.fnUntraced(function* (
           olds: oldProps,
           output: tracker[fqn].output,
         })
-        .pipe(provideLifecycleScope(fqn, instanceId));
+        .pipe(
+          instrumentLifecycle(
+            "update",
+            fqn,
+            node.resource.Type,
+            logicalId,
+            instanceId,
+          ),
+        );
 
       tracker[fqn] = {
         output: attr,
@@ -1007,7 +1108,15 @@ const collectGarbage = Effect.fnUntraced(function* (
                   session: scopedSession,
                   bindings: [],
                 })
-                .pipe(provideLifecycleScope(fqn, instanceId));
+                .pipe(
+                  instrumentLifecycle(
+                    "delete",
+                    fqn,
+                    resourceType,
+                    logicalId,
+                    instanceId,
+                  ),
+                );
             }
 
             if (isDeleteNode(node)) {