@glasstrace/sdk 1.1.2 → 1.2.0

package/dist/index.d.cts

@@ -88,15 +88,18 @@ declare function getOrCreateAnonKey(projectRoot?: string): Promise<AnonApiKey>;
  */
 declare function loadCachedConfig(projectRoot?: string): SdkInitResponse | null;
 /**
- * Persists the init response to `.glasstrace/config` using atomic
- * write-temp + rename semantics. Silently skipped when `node:fs` is
- * unavailable (non-Node environments). On I/O failure, logs a warning.
- *
- * Atomicity: the payload is written to `.glasstrace/config.tmp` and then
- * renamed into place. `rename` is atomic on POSIX filesystems, so readers
- * either see the previous valid config or the new valid config — never a
- * truncated or partially-written file (DISC-1247 Scenario 5). If the
- * rename fails, the temp file is cleaned up on a best-effort basis.
+ * Persists the init response to `.glasstrace/config` using the SDK 2.0
+ * atomic-write protocol (`tmp + fsync(tmp) + rename + fsync(parent)`).
+ * Silently skipped when `node:fs` is unavailable (non-Node environments).
+ * On I/O failure, logs a warning.
+ *
+ * Atomicity: the payload is written to `.glasstrace/config.tmp`, fsynced
+ * to durable storage, then renamed into place; the parent directory is
+ * fsynced last so the rename survives an immediate crash. `rename` is
+ * atomic on POSIX filesystems, so readers either see the previous valid
+ * config or the new valid config — never a truncated or partially-written
+ * file (DISC-1247 Scenario 5). If any step fails, the temp file is
+ * cleaned up on a best-effort basis.
  */
 declare function saveCachedConfig(response: SdkInitResponse, projectRoot?: string): Promise<void>;
 /**

package/dist/index.d.ts

@@ -88,15 +88,18 @@ declare function getOrCreateAnonKey(projectRoot?: string): Promise<AnonApiKey>;
  */
 declare function loadCachedConfig(projectRoot?: string): SdkInitResponse | null;
 /**
- * Persists the init response to `.glasstrace/config` using atomic
- * write-temp + rename semantics. Silently skipped when `node:fs` is
- * unavailable (non-Node environments). On I/O failure, logs a warning.
- *
- * Atomicity: the payload is written to `.glasstrace/config.tmp` and then
- * renamed into place. `rename` is atomic on POSIX filesystems, so readers
- * either see the previous valid config or the new valid config — never a
- * truncated or partially-written file (DISC-1247 Scenario 5). If the
- * rename fails, the temp file is cleaned up on a best-effort basis.
+ * Persists the init response to `.glasstrace/config` using the SDK 2.0
+ * atomic-write protocol (`tmp + fsync(tmp) + rename + fsync(parent)`).
+ * Silently skipped when `node:fs` is unavailable (non-Node environments).
+ * On I/O failure, logs a warning.
+ *
+ * Atomicity: the payload is written to `.glasstrace/config.tmp`, fsynced
+ * to durable storage, then renamed into place; the parent directory is
+ * fsynced last so the rename survives an immediate crash. `rename` is
+ * atomic on POSIX filesystems, so readers either see the previous valid
+ * config or the new valid config — never a truncated or partially-written
+ * file (DISC-1247 Scenario 5). If any step fails, the temp file is
+ * cleaned up on a best-effort basis.
  */
 declare function saveCachedConfig(response: SdkInitResponse, projectRoot?: string): Promise<void>;
 /**

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   registerGlasstrace,
   waitForReady,
   withGlasstraceConfig
-} from "./chunk-Z35HKVSO.js";
+} from "./chunk-6RIH6SFM.js";
 import {
   GlasstraceSpanProcessor,
   SdkError,
@@ -27,7 +27,7 @@ import {
   performInit,
   saveCachedConfig,
   sendInitRequest
-} from "./chunk-C567H5EQ.js";
+} from "./chunk-JKI4OCFV.js";
 import {
   isAnonymousMode,
   isProductionDisabled,
@@ -37,7 +37,7 @@ import {
 import {
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-3LILTM3T.js";
+} from "./chunk-TWTWRJ25.js";
 import {
   deriveSessionId
 } from "./chunk-X5MAXP5T.js";

package/dist/node-entry.cjs

@@ -17495,6 +17495,208 @@ function sleep(ms, scheduler, signal) {
 // src/mcp-runtime.ts
 var import_node_crypto = require("node:crypto");
 init_dist();
+
+// src/atomic-write.ts
+function parentDir(filePath) {
+  const lastSlash = filePath.lastIndexOf("/");
+  const lastBackslash = filePath.lastIndexOf("\\");
+  const lastSep = Math.max(lastSlash, lastBackslash);
+  if (lastSep < 0) return ".";
+  if (lastSep === 0) return filePath.slice(0, 1);
+  return filePath.slice(0, lastSep);
+}
+var PARENT_FSYNC_SWALLOWED_CODES = /* @__PURE__ */ new Set([
+  "EISDIR",
+  "EINVAL",
+  "EPERM",
+  "ENOTSUP"
+]);
+function errnoCodeOf(err) {
+  if (err === null || typeof err !== "object") return void 0;
+  const code = err.code;
+  return typeof code === "string" ? code : void 0;
+}
+function defaultTmpPath(targetPath) {
+  return `${targetPath}.tmp`;
+}
+var fsPromisesCache;
+var fsSyncCache;
+async function loadFsPromises() {
+  if (fsPromisesCache !== void 0) {
+    if (fsPromisesCache === null) {
+      throw new Error(
+        "node:fs/promises is unavailable in this environment; atomicWriteFile cannot be used here."
+      );
+    }
+    return fsPromisesCache;
+  }
+  try {
+    fsPromisesCache = await import("node:fs/promises");
+    return fsPromisesCache;
+  } catch {
+    fsPromisesCache = null;
+    throw new Error(
+      "node:fs/promises is unavailable in this environment; atomicWriteFile cannot be used here."
+    );
+  }
+}
+function loadFsSync() {
+  if (fsSyncCache !== void 0) {
+    if (fsSyncCache === null) {
+      throw new Error(
+        "node:fs is unavailable in this environment; atomicWriteFileSync cannot be used here."
+      );
+    }
+    return fsSyncCache;
+  }
+  try {
+    fsSyncCache = require("node:fs");
+    return fsSyncCache;
+  } catch {
+    fsSyncCache = null;
+    throw new Error(
+      "node:fs is unavailable in this environment; atomicWriteFileSync cannot be used here."
+    );
+  }
+}
+async function atomicWriteFile(targetPath, payload, options = {}) {
+  return atomicWriteFileWithTmp(targetPath, defaultTmpPath(targetPath), payload, options);
+}
+async function atomicWriteFileWithTmp(targetPath, tmpPath, payload, options = {}) {
+  const mode = options.mode ?? 384;
+  const encoding = options.encoding ?? "utf-8";
+  const fsp = await loadFsPromises();
+  let handle = null;
+  try {
+    if (typeof payload === "string") {
+      await fsp.writeFile(tmpPath, payload, { encoding, mode });
+    } else {
+      await fsp.writeFile(tmpPath, payload, { mode });
+    }
+    await fsp.chmod(tmpPath, mode);
+    handle = await fsp.open(tmpPath, "r");
+    await handle.sync();
+    await handle.close();
+    handle = null;
+    await fsp.rename(tmpPath, targetPath);
+  } catch (err) {
+    if (handle !== null) {
+      try {
+        await handle.close();
+      } catch {
+      }
+    }
+    await removeTmpResidueAsync(fsp, tmpPath);
+    throw err;
+  }
+  await fsyncParentDirAsync(targetPath, fsp);
+}
+async function removeTmpResidueAsync(fsp, tmpPath) {
+  try {
+    await fsp.unlink(tmpPath);
+    return;
+  } catch (err) {
+    const code = errnoCodeOf(err);
+    if (code !== "EISDIR" && code !== "EPERM") {
+      return;
+    }
+  }
+  try {
+    await fsp.rmdir(tmpPath);
+  } catch {
+  }
+}
+async function fsyncParentDirAsync(targetPath, fsp) {
+  const parent = parentDir(targetPath);
+  let handle = null;
+  try {
+    handle = await fsp.open(parent, "r");
+    await handle.sync();
+  } catch (err) {
+    const code = errnoCodeOf(err);
+    if (code !== void 0 && PARENT_FSYNC_SWALLOWED_CODES.has(code)) {
+      return;
+    }
+    throw err;
+  } finally {
+    if (handle !== null) {
+      try {
+        await handle.close();
+      } catch {
+      }
+    }
+  }
+}
+function atomicWriteFileSync(targetPath, payload, options = {}) {
+  atomicWriteFileSyncWithTmp(targetPath, defaultTmpPath(targetPath), payload, options);
+}
+function atomicWriteFileSyncWithTmp(targetPath, tmpPath, payload, options = {}) {
+  const mode = options.mode ?? 384;
+  const encoding = options.encoding ?? "utf-8";
+  const fs4 = loadFsSync();
+  let fd = null;
+  try {
+    if (typeof payload === "string") {
+      fs4.writeFileSync(tmpPath, payload, { encoding, mode });
+    } else {
+      fs4.writeFileSync(tmpPath, payload, { mode });
+    }
+    fs4.chmodSync(tmpPath, mode);
+    fd = fs4.openSync(tmpPath, "r");
+    fs4.fsyncSync(fd);
+    fs4.closeSync(fd);
+    fd = null;
+    fs4.renameSync(tmpPath, targetPath);
+  } catch (err) {
+    if (fd !== null) {
+      try {
+        fs4.closeSync(fd);
+      } catch {
+      }
+    }
+    removeTmpResidueSync(fs4, tmpPath);
+    throw err;
+  }
+  fsyncParentDirSyncWithFs(targetPath, fs4);
+}
+function removeTmpResidueSync(fs4, tmpPath) {
+  try {
+    fs4.unlinkSync(tmpPath);
+    return;
+  } catch (err) {
+    const code = errnoCodeOf(err);
+    if (code !== "EISDIR" && code !== "EPERM") {
+      return;
+    }
+  }
+  try {
+    fs4.rmdirSync(tmpPath);
+  } catch {
+  }
+}
+function fsyncParentDirSyncWithFs(targetPath, fs4) {
+  const parent = parentDir(targetPath);
+  let fd = null;
+  try {
+    fd = fs4.openSync(parent, "r");
+    fs4.fsyncSync(fd);
+  } catch (err) {
+    const code = errnoCodeOf(err);
+    if (code !== void 0 && PARENT_FSYNC_SWALLOWED_CODES.has(code)) {
+      return;
+    }
+    throw err;
+  } finally {
+    if (fd !== null) {
+      try {
+        fs4.closeSync(fd);
+      } catch {
+      }
+    }
+  }
+}
+
+// src/mcp-runtime.ts
 var MCP_ENDPOINT = "https://api.glasstrace.dev/mcp";
 var fsPathCache2;
 async function loadFsPath2() {
@@ -17708,7 +17910,6 @@ async function refreshGenericMcpConfigAtRuntime(projectRoot, effective, anonKeyO
   if (!modules) return { action: "absent" };
   const dirPath = modules.path.join(projectRoot, GLASSTRACE_DIR2);
   const configPath = modules.path.join(dirPath, MCP_CONFIG_FILE);
-  const tmpPath = configPath + ".tmp";
   let existing;
   try {
     existing = await modules.fs.readFile(configPath, "utf-8");
@@ -17725,18 +17926,12 @@ async function refreshGenericMcpConfigAtRuntime(projectRoot, effective, anonKeyO
   }
   const replacement = genericMcpConfigContent(MCP_ENDPOINT, effective.key);
   try {
-    await modules.fs.writeFile(tmpPath, replacement, { mode: 384 });
-    await modules.fs.chmod(tmpPath, 384);
-    await modules.fs.rename(tmpPath, configPath);
+    await atomicWriteFile(configPath, replacement, { mode: 384 });
     await writeMcpMarker(projectRoot, {
       credentialSource: effective.source,
       credentialHash: identityFingerprint(effective.key)
     });
   } catch {
-    try {
-      await modules.fs.unlink(tmpPath);
-    } catch {
-    }
     return { action: "preserved" };
   }
   emitRefreshNudge(effective.source);
@@ -17809,7 +18004,6 @@ async function saveCachedConfig(response, projectRoot) {
   const root = projectRoot ?? process.cwd();
   const dirPath = modules.path.join(root, GLASSTRACE_DIR3);
   const configPath = modules.path.join(dirPath, CONFIG_FILE);
-  const tmpPath = `${configPath}.tmp`;
   try {
     await modules.fs.mkdir(dirPath, { recursive: true, mode: 448 });
     await modules.fs.chmod(dirPath, 448);
@@ -17817,20 +18011,10 @@ async function saveCachedConfig(response, projectRoot) {
       response,
       cachedAt: Date.now()
     };
-    await modules.fs.writeFile(tmpPath, JSON.stringify(cached2), {
+    await atomicWriteFile(configPath, JSON.stringify(cached2), {
       encoding: "utf-8",
       mode: 384
     });
-    try {
-      await modules.fs.chmod(tmpPath, 384);
-      await modules.fs.rename(tmpPath, configPath);
-    } catch (renameErr) {
-      try {
-        await modules.fs.unlink(tmpPath);
-      } catch {
-      }
-      throw renameErr;
-    }
     await modules.fs.chmod(configPath, 384);
   } catch (err) {
     console.warn(
@@ -22076,8 +22260,51 @@ async function runRegistrationPath(config2, sessionManager) {
 // src/context-manager.ts
 var import_node_async_hooks = require("node:async_hooks");
 init_esm();
+var GLASSTRACE_BRAND = 1;
+var GUARD = /* @__PURE__ */ Symbol.for("glasstrace.context-manager.installed");
+var OTEL_API_KEY = /* @__PURE__ */ Symbol.for("opentelemetry.js.api.1");
+function isOtelContextManager(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return typeof candidate.active === "function" && typeof candidate.with === "function" && typeof candidate.bind === "function" && typeof candidate.enable === "function" && typeof candidate.disable === "function";
+}
+function isInstallationRecord(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  if (candidate.glasstraceContextManagerBrand !== GLASSTRACE_BRAND) return false;
+  return candidate.manager === null || isOtelContextManager(candidate.manager);
+}
+function getOtelRegisteredContextManager() {
+  const otelSlot = globalThis[OTEL_API_KEY];
+  if (typeof otelSlot !== "object" || otelSlot === null) return void 0;
+  const ctx = otelSlot.context;
+  return isOtelContextManager(ctx) ? ctx : void 0;
+}
 function installContextManager() {
   try {
+    const slot = globalThis;
+    const existing = slot[GUARD];
+    const otelCurrent = getOtelRegisteredContextManager();
+    if (isInstallationRecord(existing) && existing.manager !== null && existing.manager === otelCurrent) {
+      return true;
+    }
+    if (isInstallationRecord(existing) && existing.manager === null && otelCurrent !== void 0) {
+      return false;
+    }
+    if (isInstallationRecord(existing) && existing.manager !== null) {
+      const reSuccess = context.setGlobalContextManager(existing.manager);
+      if (!reSuccess) {
+        console.warn(
+          "[glasstrace] Another context manager is already registered. Trace context propagation may not work as expected."
+        );
+      }
+      const reRecord = {
+        glasstraceContextManagerBrand: GLASSTRACE_BRAND,
+        manager: reSuccess ? existing.manager : null
+      };
+      slot[GUARD] = reRecord;
+      return reSuccess;
+    }
     const als = new import_node_async_hooks.AsyncLocalStorage();
     const contextManager = {
       active: () => als.getStore() ?? ROOT_CONTEXT,
@@ -22098,6 +22325,11 @@ function installContextManager() {
         "[glasstrace] Another context manager is already registered. Trace context propagation may not work as expected."
       );
     }
+    const record2 = {
+      glasstraceContextManagerBrand: GLASSTRACE_BRAND,
+      manager: success2 ? contextManager : null
+    };
+    slot[GUARD] = record2;
     return success2;
   } catch {
     return false;
@@ -22287,12 +22519,10 @@ function writeStateNow() {
     };
     const dir = (0, import_node_path.join)(_projectRoot, ".glasstrace");
     const filePath = (0, import_node_path.join)(dir, "runtime-state.json");
-    const tmpPath = (0, import_node_path.join)(dir, "runtime-state.json.tmp");
     (0, import_node_fs.mkdirSync)(dir, { recursive: true, mode: 448 });
-    (0, import_node_fs.writeFileSync)(tmpPath, JSON.stringify(runtimeState, null, 2) + "\n", {
+    atomicWriteFileSync(filePath, JSON.stringify(runtimeState, null, 2) + "\n", {
       mode: 384
     });
-    (0, import_node_fs.renameSync)(tmpPath, filePath);
   } catch (err) {
     sdkLog(
       "warn",
@@ -22331,7 +22561,7 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.1.2"
+      sdkVersion: "1.2.0"
     });
     const config2 = resolveConfig(options);
     if (config2.verbose) {
@@ -22497,8 +22727,8 @@ async function backgroundInit(config2, anonKeyForInit, generation) {
   if (config2.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.1.2");
-  const initResult = await performInit(config2, anonKeyForInit, "1.1.2", healthReport);
+  const healthReport = collectHealthReport("1.2.0");
+  const initResult = await performInit(config2, anonKeyForInit, "1.2.0", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -22521,7 +22751,7 @@ async function backgroundInit(config2, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config2, anonKeyForInit, "1.1.2", generation, (newApiKey, accountId) => {
+    startHeartbeat(config2, anonKeyForInit, "1.2.0", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);