@superblocksteam/sdk 2.0.139-next.1 → 2.0.140-next.0

package/dist/telemetry/otlp-config.js.map

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

package/dist/telemetry/otlp-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=otlp-config.test.d.ts.map

package/dist/telemetry/otlp-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-config.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/otlp-config.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/otlp-config.test.js

@@ -0,0 +1,156 @@
+import * as http from "node:http";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { buildDeltaCounterPayload, deploymentEnvironment, emitOtlpCounter, otlpBaseUrl, otlpMetricsUrl, } from "./otlp-config.js";
+describe("otlpBaseUrl", () => {
+    it("returns <origin>/api for a valid base URL, dropping any path", () => {
+        expect(otlpBaseUrl("https://app.superblocks.com/some/path")).toBe("https://app.superblocks.com/api");
+    });
+    it("returns undefined when the base URL is missing", () => {
+        expect(otlpBaseUrl(undefined)).toBeUndefined();
+    });
+    it("returns undefined on an unparseable base URL", () => {
+        expect(otlpBaseUrl("not a url")).toBeUndefined();
+    });
+});
+describe("otlpMetricsUrl", () => {
+    it("derives <baseUrl origin>/api/v1/metrics from SUPERBLOCKS_BASE_URL", () => {
+        expect(otlpMetricsUrl({
+            SUPERBLOCKS_BASE_URL: "https://pr-19864.superblocks.dev/some/path",
+        })).toBe("https://pr-19864.superblocks.dev/api/v1/metrics");
+    });
+    it("always exports through the server proxy: SUPERBLOCKS_OTEL_COLLECTOR_URL alone is ignored", () => {
+        // There is no direct-to-collector path anymore; the server proxies OTLP.
+        expect(otlpMetricsUrl({
+            SUPERBLOCKS_OTEL_COLLECTOR_URL: "http://localhost:4318",
+        })).toBeNull();
+    });
+    it("returns null when no base URL is present (emission is skipped)", () => {
+        expect(otlpMetricsUrl({})).toBeNull();
+    });
+    it("returns null on an unparseable base URL", () => {
+        expect(otlpMetricsUrl({ SUPERBLOCKS_BASE_URL: "not a url" })).toBeNull();
+    });
+});
+describe("warnIfCollectorUrlIgnored", () => {
+    it("warns once (and only once) when the retired direct-export var is set", async () => {
+        // The module-level call in otlp-config.ts latches the once-flag against
+        // the real process.env at import time, so a shell that exports the var
+        // would make the statically imported instance a no-op here. Import a
+        // fresh instance with the var stubbed away.
+        vi.stubEnv("SUPERBLOCKS_OTEL_COLLECTOR_URL", "");
+        vi.resetModules();
+        const { warnIfCollectorUrlIgnored } = await import("./otlp-config.js");
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        warnIfCollectorUrlIgnored({});
+        expect(warn).not.toHaveBeenCalled();
+        warnIfCollectorUrlIgnored({
+            SUPERBLOCKS_OTEL_COLLECTOR_URL: "http://localhost:4318",
+        });
+        warnIfCollectorUrlIgnored({
+            SUPERBLOCKS_OTEL_COLLECTOR_URL: "http://localhost:4318",
+        });
+        expect(warn).toHaveBeenCalledTimes(1);
+        expect(warn.mock.calls[0][0]).toContain("SUPERBLOCKS_OTEL_COLLECTOR_URL");
+        warn.mockRestore();
+        vi.unstubAllEnvs();
+    });
+});
+describe("deploymentEnvironment", () => {
+    it("maps an ephemeral pr-<n> host to 'ephemeral'", () => {
+        expect(deploymentEnvironment({
+            SUPERBLOCKS_BASE_URL: "https://pr-19864.superblocks.dev",
+        })).toBe("ephemeral");
+    });
+    it("maps localhost to 'local'", () => {
+        expect(deploymentEnvironment({ SUPERBLOCKS_BASE_URL: "http://localhost:3000" })).toBe("local");
+    });
+    it("maps the production host to 'prod'", () => {
+        expect(deploymentEnvironment({
+            SUPERBLOCKS_BASE_URL: "https://app.superblocks.com",
+        })).toBe("prod");
+    });
+    it("falls back to 'other' when no base URL is available", () => {
+        expect(deploymentEnvironment({})).toBe("other");
+    });
+});
+describe("buildDeltaCounterPayload", () => {
+    it("builds a monotonic DELTA sum with one int data point and the given attributes", () => {
+        const payload = buildDeltaCounterPayload({
+            name: "dev_server_child_respawn_completed_total",
+            description: "desc",
+            attributes: { reason: "flip_restart" },
+            environment: "ephemeral",
+            nowMs: 1_730_000_000_000,
+        });
+        const rm = payload.resourceMetrics[0];
+        const resourceAttrs = Object.fromEntries(rm.resource.attributes.map((a) => [a.key, a.value.stringValue]));
+        expect(resourceAttrs["service.name"]).toBe("sdk-dev-server");
+        expect(resourceAttrs["deployment.environment.name"]).toBe("ephemeral");
+        const metric = rm.scopeMetrics[0].metrics[0];
+        expect(metric.sum.isMonotonic).toBe(true);
+        expect(metric.sum.aggregationTemporality).toBe(1); // DELTA
+        const dp = metric.sum.dataPoints[0];
+        expect(dp.asInt).toBe("1");
+        const dpAttrs = Object.fromEntries(dp.attributes.map((a) => [a.key, a.value.stringValue]));
+        expect(dpAttrs.reason).toBe("flip_restart");
+        // Nanosecond timestamps must be decimal strings, start <= time.
+        expect(typeof dp.timeUnixNano).toBe("string");
+        expect(BigInt(dp.startTimeUnixNano) <= BigInt(dp.timeUnixNano)).toBe(true);
+        expect(dp.timeUnixNano).toBe((BigInt(1_730_000_000_000) * 1000000n).toString());
+    });
+});
+describe("emitOtlpCounter (integration: listens on the OTLP endpoint)", () => {
+    let server;
+    let received;
+    let port;
+    beforeEach(async () => {
+        received = null;
+        server = http.createServer((req, res) => {
+            let body = "";
+            req.on("data", (c) => (body += c));
+            req.on("end", () => {
+                received = {
+                    url: req.url,
+                    contentType: req.headers["content-type"],
+                    body,
+                };
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end("{}");
+            });
+        });
+        await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+        port = server.address().port;
+    });
+    afterEach(async () => {
+        await new Promise((resolve) => server.close(() => resolve()));
+    });
+    it("POSTs the counter as OTLP JSON to the server proxy's /api/v1/metrics", async () => {
+        await emitOtlpCounter({
+            name: "dev_server_child_respawn_completed_total",
+            description: "desc",
+            attributes: { reason: "flip_restart" },
+            env: { SUPERBLOCKS_BASE_URL: `http://127.0.0.1:${port}` },
+            // Tests must observe the request, so keep the socket alive (no unref) and
+            // await the POST instead of fire-and-forget.
+            unref: false,
+            timeoutMs: 5000,
+        });
+        expect(received).not.toBeNull();
+        expect(received.url).toBe("/api/v1/metrics");
+        expect(received.contentType).toContain("application/json");
+        const parsed = JSON.parse(received.body);
+        const metric = parsed.resourceMetrics[0].scopeMetrics[0].metrics[0];
+        expect(metric.sum.dataPoints[0].asInt).toBe("1");
+    });
+    it("resolves without throwing and sends nothing when no base URL is configured", async () => {
+        await expect(emitOtlpCounter({
+            name: "dev_server_child_respawn_completed_total",
+            description: "desc",
+            attributes: { reason: "flip_restart" },
+            env: {},
+            unref: false,
+        })).resolves.toBeUndefined();
+        expect(received).toBeNull();
+    });
+});
+//# sourceMappingURL=otlp-config.test.js.map

package/dist/telemetry/otlp-config.test.js.map

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

package/dist/telemetry/preload.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Early telemetry preload for the dev-server child.
+ *
+ * This module has ONE job: start the OpenTelemetry SDK before any instrumented
+ * module (node:http, express, the ai-service) is loaded. OTel auto-instrumentation
+ * patches modules at require time, so if the SDK starts late — as it did when the
+ * only init was `configureTelemetry` at connect time — those modules load
+ * unpatched and the dev-server exports nothing. The child entry (`dev.mts`)
+ * imports this as its very first import so it runs before the SDK barrel.
+ *
+ * It intentionally does NOT init dd-trace/LLMObs. Those spans are created during
+ * generation (after connect) and need the application id that is only known then,
+ * so `configureTelemetry` still owns LLMObs. `configureTelemetry`'s own
+ * `initNodeTelemetry` call becomes a no-op here: `initNodeTelemetry` returns the
+ * already-created instance, so we init once, early.
+ *
+ * Config comes from the environment (available at process start), not the auth
+ * file, so nothing here has to await a network/disk read. The endpoint and
+ * environment tag are resolved by the shared `otlp-config` module, the same one
+ * the lightweight parent uses, so parent and child agree on where telemetry goes.
+ */
+export {};
+//# sourceMappingURL=preload.d.ts.map

package/dist/telemetry/preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../src/telemetry/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/telemetry/preload.js

@@ -0,0 +1,92 @@
+/**
+ * Early telemetry preload for the dev-server child.
+ *
+ * This module has ONE job: start the OpenTelemetry SDK before any instrumented
+ * module (node:http, express, the ai-service) is loaded. OTel auto-instrumentation
+ * patches modules at require time, so if the SDK starts late — as it did when the
+ * only init was `configureTelemetry` at connect time — those modules load
+ * unpatched and the dev-server exports nothing. The child entry (`dev.mts`)
+ * imports this as its very first import so it runs before the SDK barrel.
+ *
+ * It intentionally does NOT init dd-trace/LLMObs. Those spans are created during
+ * generation (after connect) and need the application id that is only known then,
+ * so `configureTelemetry` still owns LLMObs. `configureTelemetry`'s own
+ * `initNodeTelemetry` call becomes a no-op here: `initNodeTelemetry` returns the
+ * already-created instance, so we init once, early.
+ *
+ * Config comes from the environment (available at process start), not the auth
+ * file, so nothing here has to await a network/disk read. The endpoint and
+ * environment tag are resolved by the shared `otlp-config` module, the same one
+ * the lightweight parent uses, so parent and child agree on where telemetry goes.
+ */
+import os from "node:os";
+import { ExpressInstrumentation } from "@opentelemetry/instrumentation-express";
+import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
+import { DeploymentTypeEnum } from "@superblocksteam/shared";
+import { getDefaultPolicy, initNodeTelemetry, parseDeploymentType, } from "@superblocksteam/telemetry";
+import packageJson from "../../package.json" with { type: "json" };
+import { ATTR_SUPERBLOCKS_BASE_URL, ATTR_SUPERBLOCKS_CSB_ID, ATTR_SUPERBLOCKS_IS_CSB, getEnvironmentFromHostname, } from "./attributes.js";
+import { getTelemetryIdentity } from "./identity.js";
+import { applyLocalObsEnvVars } from "./local-obs.js";
+import { otlpBaseUrl, SERVICE_NAME } from "./otlp-config.js";
+// Apply local-obs env defaults first so deployment type / export policy are set
+// before we read them below (mirrors the module-scope call in index.ts).
+applyLocalObsEnvVars();
+const baseUrl = process.env.SUPERBLOCKS_BASE_URL;
+const otlpUrl = otlpBaseUrl(baseUrl);
+// Without a base URL we have no proxy to export to; skip early init and let the
+// later configureTelemetry path (which resolves config from the auth file) run.
+// Warn so the fallback is visible: by then http/express are already loaded
+// unpatched, so auto-instrumented traces are missing for this run.
+if (!otlpUrl) {
+    console.warn("[Telemetry] SUPERBLOCKS_BASE_URL is not set; skipping early OpenTelemetry init. Auto-instrumented HTTP/Express traces will be missing for this run.");
+}
+else {
+    const hostname = (() => {
+        try {
+            return baseUrl ? new URL(baseUrl).hostname : "";
+        }
+        catch {
+            return "";
+        }
+    })();
+    const isCsb = !!process.env.SUPERBLOCKS_IS_CSB;
+    // A typo'd SUPERBLOCKS_DEPLOYMENT_TYPE must not abort early init; default to
+    // CLOUD like the connect-time path in index.ts does.
+    const deploymentType = (() => {
+        try {
+            return parseDeploymentType(process.env.SUPERBLOCKS_DEPLOYMENT_TYPE);
+        }
+        catch (error) {
+            console.warn("[Telemetry] Invalid SUPERBLOCKS_DEPLOYMENT_TYPE, defaulting to CLOUD:", error);
+            return DeploymentTypeEnum.CLOUD;
+        }
+    })();
+    try {
+        initNodeTelemetry({
+            serviceName: SERVICE_NAME,
+            serviceVersion: packageJson.version,
+            environment: getEnvironmentFromHostname(hostname),
+            otlpUrl,
+            resourceAttributes: {
+                [ATTR_SUPERBLOCKS_BASE_URL]: hostname,
+                [ATTR_SUPERBLOCKS_IS_CSB]: String(isCsb),
+                ...(isCsb && { [ATTR_SUPERBLOCKS_CSB_ID]: os.hostname() }),
+            },
+            instrumentations: [
+                new HttpInstrumentation(),
+                new ExpressInstrumentation(),
+            ],
+            logsEnabled: true,
+            // Identity (application/user/org) is only known at connect;
+            // configureTelemetry fills it in and every span and exported log
+            // record picks it up here.
+            dynamicAttributes: getTelemetryIdentity,
+        }, getDefaultPolicy(deploymentType));
+    }
+    catch (error) {
+        // Never let telemetry init crash the dev-server boot.
+        console.error("[Telemetry] Early preload failed to initialize:", error);
+    }
+}
+//# sourceMappingURL=preload.js.map

package/dist/telemetry/preload.js.map

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

package/dist/telemetry/util.d.ts

@@ -1,9 +1,9 @@
-export declare const SERVICE_NAME = "sdk-dev-server";
+import { SERVICE_NAME } from "./otlp-config.js";
+export { SERVICE_NAME };
 export declare function getConfiguration(): Promise<{
     superblocksBaseUrl: import("url").URL;
-    otlpBaseUrl: string;
+    otlpBaseUrl: string | undefined;
     superblocksHostname: string;
     serviceName: string;
-    token: string;
 }>;
 //# sourceMappingURL=util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,mBAAmB,CAAC;AA2B7C,wBAAsB,gBAAgB;;;;;;GAwBrC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI7D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,wBAAsB,gBAAgB;;;;;GAmBrC"}

package/dist/telemetry/util.js

@@ -1,45 +1,19 @@
 import { getLocalTokenWithUrl } from "@superblocksteam/util";
-export const SERVICE_NAME = "sdk-dev-server";
-/**
- * Get the OTLP base URL for telemetry export.
- *
- * Priority:
- * 1. SUPERBLOCKS_OTEL_COLLECTOR_URL env var (for local obs mode)
- * 2. Superblocks API endpoint derived from base URL
- *
- * When SUPERBLOCKS_OTEL_COLLECTOR_URL is set (e.g., http://localhost:4318),
- * telemetry is sent directly to the local OTEL collector.
- *
- * Note: This returns the BASE URL. The telemetry library appends /v1/traces,
- * /v1/metrics, /v1/logs to this URL.
- */
-function getOtlpBaseUrl(superblocksBaseUrl) {
-    const localOtelUrl = process.env.SUPERBLOCKS_OTEL_COLLECTOR_URL;
-    if (localOtelUrl) {
-        // Remove trailing /v1/traces etc. if present (just use base URL)
-        return localOtelUrl.replace(/\/v1\/(traces|metrics|logs)$/, "");
-    }
-    // Default: Superblocks API proxies OTLP requests
-    // The server expects /api/v1/traces but the telemetry lib adds /v1/traces,
-    // so we return /api and let telemetry lib append /v1/traces
-    return superblocksBaseUrl.origin + "/api";
-}
+import { otlpBaseUrl, SERVICE_NAME } from "./otlp-config.js";
+// Re-exported so existing importers of `./util.js` keep resolving SERVICE_NAME
+// from the single source of truth in otlp-config.
+export { SERVICE_NAME };
 export async function getConfiguration() {
     try {
         const tokenWithUrl = await getLocalTokenWithUrl();
         const superblocksBaseUrl = new URL(tokenWithUrl.superblocksBaseUrl);
-        const otlpBaseUrl = getOtlpBaseUrl(superblocksBaseUrl);
+        const otlpBase = otlpBaseUrl(superblocksBaseUrl);
         const superblocksHostname = superblocksBaseUrl.hostname;
-        let token = "";
-        if ("token" in tokenWithUrl) {
-            token = tokenWithUrl.token.substring(0, 8);
-        }
         return {
             superblocksBaseUrl,
-            otlpBaseUrl,
+            otlpBaseUrl: otlpBase,
             superblocksHostname,
             serviceName: SERVICE_NAME,
-            token,
         };
     }
     catch (e) {

package/dist/telemetry/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,kBAAuB;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAChE,IAAI,YAAY,EAAE,CAAC;QACjB,iEAAiE;QACjE,OAAO,YAAY,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,iDAAiD;IACjD,2EAA2E;IAC3E,4DAA4D;IAC5D,OAAO,kBAAkB,CAAC,MAAM,GAAG,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QACxD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO;YACL,kBAAkB;YAClB,WAAW;YACX,mBAAmB;YACnB,WAAW,EAAE,YAAY;YACzB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,4FAA4F,EAC5F,CAAC,CACF,CAAC;QACF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,+EAA+E;AAC/E,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;QACjD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QACxD,OAAO;YACL,kBAAkB;YAClB,WAAW,EAAE,QAAQ;YACrB,mBAAmB;YACnB,WAAW,EAAE,YAAY;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,4FAA4F,EAC5F,CAAC,CACF,CAAC;QACF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk",
-  "version": "2.0.139-next.1",
+  "version": "2.0.140-next.0",
   "description": "Superblocks JS SDK",
   "homepage": "https://www.superblocks.com",
   "license": "Superblocks Community Software License",
@@ -9,10 +9,18 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./otlp-config": {
+      "types": "./dist/telemetry/otlp-config.d.ts",
+      "import": "./dist/telemetry/otlp-config.js"
+    },
+    "./telemetry-preload": {
+      "types": "./dist/telemetry/preload.d.ts",
+      "import": "./dist/telemetry/preload.js"
     }
   },
   "dependencies": {
-    "@babel/core": "7.24.0",
+    "@babel/core": "7.29.6",
     "@babel/parser": "^7.25.8",
     "@babel/plugin-proposal-decorators": "^7.28.0",
     "@babel/plugin-transform-typescript": "7.28.0",
@@ -35,24 +43,25 @@
     "dd-trace": "^5.57.1",
     "express": "^4.21.1",
     "fast-glob": "^3.3.3",
-    "form-data": "^4.0.5",
+    "form-data": "^4.0.6",
     "fs-extra": "^11.3.0",
     "jwt-decode": "^4.0.0",
     "lodash-es": "^4.18.1",
     "package-manager-detector": "^1.3.0",
+    "react-compiler-runtime": "1.0.0",
     "read-pkg": "^9.0.1",
     "semver": "^7.5.4",
     "simple-git": "^3.36.0",
     "slugify": "^1.6.6",
-    "vite": "6.4.2",
+    "vite": "6.4.3",
     "vite-tsconfig-paths": "^6.0.4",
     "winston": "^3.17.0",
     "yaml": "^2.7.1",
-    "@superblocksteam/library-shared": "2.0.139-next.1",
-    "@superblocksteam/shared": "0.9595.4",
-    "@superblocksteam/vite-plugin-file-sync": "2.0.139-next.1",
-    "@superblocksteam/util": "2.0.139-next.1",
-    "@superblocksteam/telemetry": "2.0.139-next.1"
+    "@superblocksteam/library-shared": "2.0.140-next.0",
+    "@superblocksteam/shared": "0.9597.0",
+    "@superblocksteam/telemetry": "2.0.140-next.0",
+    "@superblocksteam/util": "2.0.140-next.0",
+    "@superblocksteam/vite-plugin-file-sync": "2.0.140-next.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/src/application-build.mts

@@ -10,6 +10,7 @@ import { injectIndexVitePlugin } from "@superblocksteam/vite-plugin-file-sync/in
 
 import { customComponentsPlugin } from "./dev-utils/custom-build.mjs";
 import { ddRumPlugin } from "./dev-utils/vite-plugin-dd-rum.mjs";
+import { reactCompilerRuntimeAlias } from "./react-compiler-runtime-shim.mjs";
 import { getLogger } from "./telemetry/logging.js";
 import { generateApiBuildManifestPlugin } from "./vite-plugin-generate-api-build-manifest.mjs";
 import { injectSuperblocksIdsPlugin } from "./vite-plugin-inject-sb-ids-transform.mjs";
@@ -95,12 +96,15 @@ async function buildWithVite({
 
   const customFolder = path.join(root, "custom");
 
+  const compilerRuntimeAlias = reactCompilerRuntimeAlias();
+
   await build({
     root,
     mode,
     appType: "spa",
     clearScreen: true,
     resolve: {
+      alias: compilerRuntimeAlias ? [compilerRuntimeAlias] : [],
       // Deduplicate these packages to prevent multiple instances in the bundle.
       // This is critical for React context providers like react-router to work correctly.
       dedupe: ["react", "react-dom", "react-router"],

package/src/dev-utils/dev-server-resolve-config.test.mts

@@ -0,0 +1,29 @@
+import { existsSync } from "node:fs";
+import { isAbsolute } from "node:path";
+
+import { describe, expect, it } from "vitest";
+
+import { buildResolveConfig } from "./dev-server.mjs";
+
+describe("buildResolveConfig", () => {
+  it("aliases react/compiler-runtime to an existing shim file", () => {
+    const config = buildResolveConfig();
+    const aliases = config?.alias as unknown as Array<{
+      find: string;
+      replacement: string;
+    }>;
+
+    const entry = aliases.find((a) => a.find === "react/compiler-runtime");
+    expect(entry).toBeDefined();
+    expect(isAbsolute(entry!.replacement)).toBe(true);
+    expect(existsSync(entry!.replacement)).toBe(true);
+  });
+
+  it("does not alias bare react or react/jsx-runtime", () => {
+    const aliases = buildResolveConfig()?.alias as unknown as Array<{
+      find: string;
+    }>;
+    expect(aliases.some((a) => a.find === "react")).toBe(false);
+    expect(aliases.some((a) => a.find === "react/jsx-runtime")).toBe(false);
+  });
+});

package/src/dev-utils/dev-server-tracing.test.mts

@@ -0,0 +1,32 @@
+import type { Tracer } from "@opentelemetry/api";
+import { describe, expect, it, vi } from "vitest";
+
+import type * as TelemetryModule from "../telemetry/index.js";
+
+const { firstTracer, getTracerMock, secondTracer } = vi.hoisted(() => ({
+  firstTracer: { name: "first-tracer" } as unknown as Tracer,
+  getTracerMock: vi.fn(),
+  secondTracer: { name: "second-tracer" } as unknown as Tracer,
+}));
+
+vi.mock("../telemetry/index.js", async (importOriginal) => {
+  const actual = await importOriginal<typeof TelemetryModule>();
+
+  return {
+    ...actual,
+    getTracer: getTracerMock,
+  };
+});
+
+import { getDevServerTracer } from "./dev-server.mjs";
+
+describe("getDevServerTracer", () => {
+  it("resolves the SDK tracer at call time", () => {
+    getTracerMock
+      .mockReturnValueOnce(firstTracer)
+      .mockReturnValueOnce(secondTracer);
+
+    expect(getDevServerTracer()).toBe(firstTracer);
+    expect(getDevServerTracer()).toBe(secondTracer);
+  });
+});

package/src/dev-utils/dev-server.mts

@@ -41,6 +41,7 @@ import type { SyncService } from "@superblocksteam/vite-plugin-file-sync/sync-se
 
 import pkg from "../../package.json" with { type: "json" };
 import { flagOrEnv } from "../flag.js";
+import { reactCompilerRuntimeAlias } from "../react-compiler-runtime-shim.mjs";
 import type { SuperblocksSdk } from "../sdk.js";
 import { getTracer } from "../telemetry/index.js";
 import { getErrorMeta, getLogger } from "../telemetry/logging.js";
@@ -78,9 +79,12 @@ import {
 import { buildManifestStubPlugin } from "./vite-plugin-build-manifest-stub.mjs";
 import { ddRumPlugin } from "./vite-plugin-dd-rum.mjs";
 
-const tracer = getTracer();
 const logger = getLogger();
 
+export function getDevServerTracer() {
+  return getTracer();
+}
+
 /**
  * Maps a dev-server request URL onto a low-cardinality endpoint label for
  * metrics. Returns undefined for non-`/_sb_*` URLs (Vite-proxied traffic).
@@ -162,6 +166,20 @@ const OPTIMIZE_DEPS_CONFIG: UserConfig["optimizeDeps"] = {
   },
 };
 
+/**
+ * Vite `resolve` config shared by both the activation and pre-warm servers.
+ *
+ * Applies the `react/compiler-runtime` → shim alias via `reactCompilerRuntimeAlias()`.
+ * Must stay identical across both `createServer()` calls — Vite hashes this
+ * config into the dep-optimization cache (see OPTIMIZE_DEPS_CONFIG note).
+ */
+export function buildResolveConfig(): UserConfig["resolve"] {
+  const alias = reactCompilerRuntimeAlias();
+  return {
+    alias: alias ? [alias] : [],
+  };
+}
+
 /**
  * Builds the Vite plugin list shared by both pre-warm and activation.
  *
@@ -1449,6 +1467,7 @@ async function startVite({
   dispose: () => void;
   routeIndex: number;
 }> {
+  const tracer = getDevServerTracer();
   return tracer.startActiveSpan("startVite", async (startViteSpan) => {
     try {
       const logger = getLogger(loggerOverride);
@@ -1541,6 +1560,7 @@ async function startVite({
               clearScreen: process.env.SUPERBLOCKS_CLI_ENV !== "local",
               customLogger: viteLogger,
               optimizeDeps: OPTIMIZE_DEPS_CONFIG,
+              resolve: buildResolveConfig(),
               server: {
                 middlewareMode: true,
                 watch: {
@@ -1638,6 +1658,7 @@ export async function preWarmViteCache(root: string): Promise<void> {
       plugins: vitePlugins(root, { fileSync: fileSyncVitePlugin().plugin }),
       logLevel: "warn",
       optimizeDeps: OPTIMIZE_DEPS_CONFIG,
+      resolve: buildResolveConfig(),
     });
     const depsDir = path.join(root, "node_modules", ".vite", "deps");
     const pollMs = 100;