@morsehq-dev/sdk 0.4.1 → 0.5.0-rc.2

package/dist/browser/{chunk-DXWHT3HK.cjs → chunk-A5EYWAOT.cjs}

@@ -120,53 +120,6 @@ var init_env = __esm({
   }
 });
 
-// src/_internal/otel-provider.browser.ts
-function noteBrowserRuntime() {
-  if (warned) return;
-  warned = true;
-  try {
-    console.info(
-      "[morse] Browser build active: OpenTelemetry span export and database capture are Node-only, so traces are sent via Morse's JSON transport instead. Everything else \u2014 run()/span()/track() and W3C traceparent propagation \u2014 behaves identically. Server-side code (Next.js route handlers, RSC, Node services) automatically gets the full OTel pipeline."
-    );
-  } catch {
-  }
-}
-function getEngine() {
-  return engine;
-}
-function withOtelSpanContext(traceIdHex, spanIdHex, fn) {
-  return fn();
-}
-var warned, OtelEngine, engine;
-var init_otel_provider_browser = __esm({
-  "src/_internal/otel-provider.browser.ts"() {
-    warned = false;
-    OtelEngine = class {
-      // Params are declared (not dropped) so this class stays signature-compatible
-      // with the real `OtelEngine` — the build swaps the modules, but anything
-      // type-checking against this one must see the same shape. `void x` marks the
-      // deliberate non-use for @typescript-eslint/no-unused-vars.
-      configure(opts) {
-        noteBrowserRuntime();
-      }
-      shutdown() {
-      }
-      resetForTesting() {
-        warned = false;
-      }
-      async flush() {
-      }
-      resolveSampled(traceIdHex) {
-        return true;
-      }
-      registerInstrumentations(instrumentations) {
-        return null;
-      }
-    };
-    engine = new OtelEngine();
-  }
-});
-
 // src/_internal/redaction.ts
 function buildRedactionConfig(options) {
   const opts = options ?? {};
@@ -355,6 +308,377 @@ var init_redaction = __esm({
   }
 });
 
+// src/_internal/diagnostics.ts
+function setRedactionConfig(config) {
+  activeRedactionConfig = config;
+}
+function setLevel(raw) {
+  if (!raw) return;
+  const value = String(raw).trim().toLowerCase();
+  if (!VALID_LEVELS.has(value)) return;
+  level = value;
+}
+function transmissionAllowed() {
+  if (isTelemetryDisabled() || isDisabled()) return false;
+  return level !== LEVEL_OFF;
+}
+function checkBucket(buckets, key, limit, windowMs) {
+  const now = Date.now();
+  const bucket = buckets.get(key) ?? [];
+  const cutoff = now - windowMs;
+  while (bucket.length > 0 && bucket[0] < cutoff) bucket.shift();
+  if (bucket.length >= limit) {
+    buckets.set(key, bucket);
+    return false;
+  }
+  bucket.push(now);
+  buckets.set(key, bucket);
+  return true;
+}
+function checkRateLimit(fingerprint) {
+  const limit = level === LEVEL_DEBUG ? RATE_LIMIT_PER_WINDOW_DEBUG : RATE_LIMIT_PER_WINDOW;
+  return checkBucket(rateBuckets, fingerprint, limit, RATE_WINDOW_MS);
+}
+function isMorseFrame(line) {
+  return MORSE_PATH_MARKERS.some((marker) => line.includes(marker));
+}
+function parseFrame(line) {
+  const withParens = /^\s*at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)\s*$/.exec(line);
+  if (withParens) {
+    return {
+      fn: withParens[1],
+      file: withParens[2],
+      lineNo: Number(withParens[3])
+    };
+  }
+  const bare = /^\s*at\s+(.+?):(\d+):(\d+)\s*$/.exec(line);
+  if (bare) return { file: bare[1], lineNo: Number(bare[2]) };
+  return {};
+}
+function buildScopedStack(error) {
+  const frames = [];
+  try {
+    const stack = error instanceof Error ? error.stack ?? "" : "";
+    if (!stack) return frames;
+    let elided = 0;
+    for (const raw of stack.split("\n")) {
+      if (!raw.trim().startsWith("at ")) continue;
+      if (isMorseFrame(raw)) {
+        if (elided > 0) {
+          frames.push({ elided });
+          elided = 0;
+        }
+        const { file, lineNo, fn } = parseFrame(raw);
+        const frame = {};
+        if (file) frame.file = file.split(/[\\/]/).slice(-3).join("/");
+        if (typeof lineNo === "number" && !Number.isNaN(lineNo)) frame.line = lineNo;
+        if (fn) frame.function = fn.slice(0, 255);
+        frames.push(frame);
+      } else {
+        elided += 1;
+      }
+    }
+    if (elided > 0) frames.push({ elided });
+  } catch {
+  }
+  return frames.length > MAX_STACK_ENTRIES ? frames.slice(-MAX_STACK_ENTRIES) : frames;
+}
+function redactedMessage(error) {
+  let raw;
+  try {
+    raw = error instanceof Error ? error.message : String(error);
+  } catch {
+    return "";
+  }
+  try {
+    if (activeRedactionConfig) {
+      const out = redactValue(raw, activeRedactionConfig);
+      raw = typeof out === "string" ? out : String(out);
+    }
+  } catch {
+    return "<redaction unavailable>";
+  }
+  return raw.slice(0, MAX_MESSAGE_CHARS);
+}
+function scrubExtra(extra) {
+  const out = {};
+  if (!extra) return out;
+  for (const [key, value] of Object.entries(extra)) {
+    if (ALLOWED_EXTRA_KEYS.has(key) && value != null) {
+      out[key] = String(value).slice(0, 255);
+    }
+  }
+  return out;
+}
+function recordDrop(reason, category, quantity = 1) {
+  try {
+    if (quantity <= 0) return;
+    const key = `${reason}:${category}`;
+    const existing = counters.get(key);
+    if (existing) existing.quantity += quantity;
+    else counters.set(key, { reason, category, quantity });
+    if (checkBucket(localLogBuckets, `drop:${key}`, LOCAL_LOG_LIMIT_PER_WINDOW, LOCAL_LOG_WINDOW_MS)) {
+      console.warn(`morse: dropped ${quantity} ${category} (${reason}) \u2014 telemetry is being lost`);
+    }
+  } catch {
+  }
+}
+function drainCounters() {
+  if (counters.size === 0) return [];
+  const drained = [...counters.values()];
+  counters.clear();
+  return drained;
+}
+function report(error, options) {
+  if (reporting) return;
+  reporting = true;
+  try {
+    const errClass = error instanceof Error ? error.name : "Error";
+    const errMessage = error instanceof Error ? error.message : String(error);
+    if (checkBucket(
+      localLogBuckets,
+      options.fingerprint,
+      LOCAL_LOG_LIMIT_PER_WINDOW,
+      LOCAL_LOG_WINDOW_MS
+    )) {
+      const line = `morse internal error [${options.fingerprint}]: ${errClass}: ${errMessage}`;
+      if (isDebug()) console.error(line, error);
+      else console.warn(line);
+    }
+    if (!transmissionAllowed()) return;
+    if (!checkRateLimit(options.fingerprint)) return;
+    enqueue({
+      kind: "error",
+      fingerprint: options.fingerprint.slice(0, 255),
+      error_type: errClass.slice(0, 255),
+      message: redactedMessage(error),
+      stack: buildScopedStack(error),
+      sdk_language: "typescript",
+      sdk_version: sdkVersion(),
+      runtime_version: runtimeVersion(),
+      platform: platformLabel(),
+      extra: scrubExtra(options.extra)
+    });
+  } catch {
+  } finally {
+    reporting = false;
+  }
+}
+function sdkVersion() {
+  return SDK_VERSION;
+}
+function runtimeVersion() {
+  try {
+    const proc = globalThis.process;
+    return proc?.version ? String(proc.version) : "";
+  } catch {
+    return "";
+  }
+}
+function platformLabel() {
+  try {
+    const proc = globalThis.process;
+    if (proc?.platform) return `${proc.platform}-${proc.arch ?? ""}`.slice(0, 128);
+    return "browser";
+  } catch {
+    return "";
+  }
+}
+function enqueue(event) {
+  pending.push(event);
+  while (pending.length > MAX_PENDING) pending.shift();
+  ensureTimer();
+}
+function ensureTimer() {
+  if (timer !== null) return;
+  try {
+    timer = setInterval(() => {
+      void flushOnce();
+    }, FLUSH_INTERVAL_MS);
+    timer?.unref?.();
+  } catch {
+    timer = null;
+  }
+}
+function breakerBlocks() {
+  return breakerOpenUntil > 0 && Date.now() < breakerOpenUntil;
+}
+function recordResult(ok) {
+  if (ok) {
+    consecutiveFailures = 0;
+    breakerOpenUntil = 0;
+    return;
+  }
+  consecutiveFailures += 1;
+  if (consecutiveFailures >= BREAKER_THRESHOLD) {
+    breakerOpenUntil = Date.now() + BREAKER_COOLDOWN_MS;
+  }
+}
+async function flushOnce() {
+  try {
+    const batch = pending.splice(0, MAX_BATCH_EVENTS);
+    const drained = drainCounters();
+    if (drained.length > 0) {
+      batch.push({
+        kind: "counters",
+        fingerprint: "morse.transport.delivery",
+        counters: drained,
+        sdk_language: "typescript",
+        sdk_version: sdkVersion()
+      });
+    }
+    if (batch.length === 0) return;
+    if (breakerBlocks() || !transmissionAllowed()) return;
+    const target = resolveTarget();
+    if (target === null) return;
+    let response;
+    try {
+      response = await fetch(target.url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${target.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ events: batch })
+      });
+    } catch {
+      recordResult(false);
+      return;
+    }
+    setLevel(response.headers.get("X-Morse-Diagnostics"));
+    recordResult(response.ok);
+  } catch {
+  }
+}
+function resolveTarget() {
+  try {
+    const apiKey = getApiKey();
+    if (!apiKey) return null;
+    const url = deriveDiagnosticsUrl(String(getEndpoint() ?? ""));
+    if (!url) return null;
+    return { apiKey: String(apiKey), url };
+  } catch {
+    return null;
+  }
+}
+function deriveDiagnosticsUrl(tracesEndpoint) {
+  try {
+    const parsed = new URL(tracesEndpoint);
+    return `${parsed.protocol}//${parsed.host}${DIAGNOSTICS_PATH}`;
+  } catch {
+    return null;
+  }
+}
+function _resetForTesting() {
+  rateBuckets.clear();
+  localLogBuckets.clear();
+  counters.clear();
+  pending = [];
+  if (timer !== null) {
+    clearInterval(timer);
+    timer = null;
+  }
+  consecutiveFailures = 0;
+  breakerOpenUntil = 0;
+  reporting = false;
+  level = LEVEL_ERROR;
+  activeRedactionConfig = null;
+}
+var SDK_VERSION, LEVEL_OFF, LEVEL_ERROR, LEVEL_DEBUG, VALID_LEVELS, level, RATE_WINDOW_MS, RATE_LIMIT_PER_WINDOW, RATE_LIMIT_PER_WINDOW_DEBUG, rateBuckets, LOCAL_LOG_WINDOW_MS, LOCAL_LOG_LIMIT_PER_WINDOW, localLogBuckets, MAX_STACK_ENTRIES, MAX_MESSAGE_CHARS, MAX_BATCH_EVENTS, ALLOWED_EXTRA_KEYS, DIAGNOSTICS_PATH, MAX_PENDING, FLUSH_INTERVAL_MS, BREAKER_THRESHOLD, BREAKER_COOLDOWN_MS; exports.REASON_QUEUE_FULL = void 0; exports.REASON_RETRY_EXHAUSTED = void 0; exports.REASON_QUOTA_REJECTED = void 0; exports.REASON_SHUTDOWN_DROP = void 0; var counters, activeRedactionConfig, pending, timer, consecutiveFailures, breakerOpenUntil, reporting, MORSE_PATH_MARKERS;
+var init_diagnostics = __esm({
+  "src/_internal/diagnostics.ts"() {
+    init_env();
+    init_redaction();
+    SDK_VERSION = "0.5.0-rc.2" ;
+    LEVEL_OFF = "off";
+    LEVEL_ERROR = "error";
+    LEVEL_DEBUG = "debug";
+    VALID_LEVELS = /* @__PURE__ */ new Set([LEVEL_OFF, LEVEL_ERROR, LEVEL_DEBUG]);
+    level = LEVEL_ERROR;
+    RATE_WINDOW_MS = 6e4;
+    RATE_LIMIT_PER_WINDOW = 100;
+    RATE_LIMIT_PER_WINDOW_DEBUG = 1e3;
+    rateBuckets = /* @__PURE__ */ new Map();
+    LOCAL_LOG_WINDOW_MS = 6e4;
+    LOCAL_LOG_LIMIT_PER_WINDOW = 10;
+    localLogBuckets = /* @__PURE__ */ new Map();
+    MAX_STACK_ENTRIES = 64;
+    MAX_MESSAGE_CHARS = 4096;
+    MAX_BATCH_EVENTS = 32;
+    ALLOWED_EXTRA_KEYS = /* @__PURE__ */ new Set([
+      "adapter",
+      "module",
+      "function",
+      "operation",
+      "endpoint_host"
+    ]);
+    DIAGNOSTICS_PATH = "/api/v1/diagnostics/sdk";
+    MAX_PENDING = 100;
+    FLUSH_INTERVAL_MS = 5e3;
+    BREAKER_THRESHOLD = 3;
+    BREAKER_COOLDOWN_MS = 3e5;
+    exports.REASON_QUEUE_FULL = "queue_full";
+    exports.REASON_RETRY_EXHAUSTED = "retry_exhausted";
+    exports.REASON_QUOTA_REJECTED = "quota_rejected";
+    exports.REASON_SHUTDOWN_DROP = "shutdown_drop";
+    counters = /* @__PURE__ */ new Map();
+    activeRedactionConfig = null;
+    pending = [];
+    timer = null;
+    consecutiveFailures = 0;
+    breakerOpenUntil = 0;
+    reporting = false;
+    MORSE_PATH_MARKERS = ["@morsehq/sdk", "morse-sdk", "/morse/", "morse_ai"];
+  }
+});
+
+// src/_internal/otel-provider.browser.ts
+function noteBrowserRuntime() {
+  if (warned) return;
+  warned = true;
+  try {
+    console.info(
+      "[morse] Browser build active: OpenTelemetry span export and database capture are Node-only, so traces are sent via Morse's JSON transport instead. Everything else \u2014 run()/span()/track() and W3C traceparent propagation \u2014 behaves identically. Server-side code (Next.js route handlers, RSC, Node services) automatically gets the full OTel pipeline."
+    );
+  } catch {
+  }
+}
+function getEngine() {
+  return engine;
+}
+function withOtelSpanContext(traceIdHex, spanIdHex, fn) {
+  return fn();
+}
+var warned, OtelEngine, engine;
+var init_otel_provider_browser = __esm({
+  "src/_internal/otel-provider.browser.ts"() {
+    warned = false;
+    OtelEngine = class {
+      // Params are declared (not dropped) so this class stays signature-compatible
+      // with the real `OtelEngine` — the build swaps the modules, but anything
+      // type-checking against this one must see the same shape. `void x` marks the
+      // deliberate non-use for @typescript-eslint/no-unused-vars.
+      configure(opts) {
+        noteBrowserRuntime();
+      }
+      shutdown() {
+      }
+      resetForTesting() {
+        warned = false;
+      }
+      async flush() {
+      }
+      resolveSampled(traceIdHex) {
+        return true;
+      }
+      registerInstrumentations(instrumentations) {
+        return null;
+      }
+    };
+    engine = new OtelEngine();
+  }
+});
+
 // src/_internal/spans.ts
 function generateTraceId() {
   return randomHex(32);
@@ -423,6 +747,17 @@ function tryLoadAls() {
     als = null;
     return als;
   }
+  try {
+    const getBuiltin = process?.getBuiltinModule;
+    if (typeof getBuiltin === "function") {
+      const mod = getBuiltin("node:async_hooks");
+      if (mod?.AsyncLocalStorage) {
+        als = new mod.AsyncLocalStorage();
+        return als;
+      }
+    }
+  } catch {
+  }
   try {
     const dynamicRequire = Function("m", "return require(m)");
     const mod = dynamicRequire("node:async_hooks");
@@ -455,8 +790,9 @@ function setTransport(t) {
 function getTransport() {
   return transport;
 }
-function setRedactionConfig(config) {
+function setRedactionConfig2(config) {
   redactionConfig = config;
+  setRedactionConfig(config);
 }
 function getRedactionConfig() {
   return redactionConfig;
@@ -545,8 +881,15 @@ function buildTraceDict(state, rootSpan) {
     spans: spans.map((s) => redactSpanDict(s, config))
   };
   const effectiveSource = state.sourceOverride || _source;
+  const resource = {};
   if (effectiveSource) {
-    out.resource = { "morse_ai.source": effectiveSource };
+    resource["morse_ai.source"] = effectiveSource;
+  }
+  if (state.framework) {
+    resource["morse_ai.framework"] = state.framework;
+  }
+  if (Object.keys(resource).length > 0) {
+    out.resource = resource;
   }
   return out;
 }
@@ -638,16 +981,37 @@ function errToString(e) {
   if (e instanceof Error) return e.message;
   return String(e);
 }
+function isThenable(v) {
+  return v !== null && (typeof v === "object" || typeof v === "function") && typeof v.then === "function";
+}
 function runSync(opts, fn) {
   const { state, rootSpan, startMono } = startTrace(opts);
   const handle = buildRunHandle(state);
   const store = tryLoadAls();
   const runFn = () => withDbCaptureContext(state.traceId, rootSpan.span_id, () => fn(handle));
-  if (store) {
-    try {
-      const result = store.run(state, runFn);
+  const settle = (result, onDone) => {
+    if (!isThenable(result)) {
       endTrace(state, rootSpan, startMono, void 0);
+      onDone();
       return result;
+    }
+    return result.then(
+      (value) => {
+        endTrace(state, rootSpan, startMono, void 0);
+        onDone();
+        return value;
+      },
+      (err) => {
+        endTrace(state, rootSpan, startMono, err);
+        onDone();
+        throw err;
+      }
+    );
+  };
+  if (store) {
+    try {
+      return settle(store.run(state, runFn), () => {
+      });
     } catch (err) {
       endTrace(state, rootSpan, startMono, err);
       throw err;
@@ -655,14 +1019,11 @@ function runSync(opts, fn) {
   } else {
     const reset = setActiveTraceState(state);
     try {
-      const result = runFn();
-      endTrace(state, rootSpan, startMono, void 0);
-      return result;
+      return settle(runFn(), reset);
     } catch (err) {
       endTrace(state, rootSpan, startMono, err);
-      throw err;
-    } finally {
       reset();
+      throw err;
     }
   }
 }
@@ -763,7 +1124,7 @@ async function spanAsync(opts, fn) {
     throw err;
   }
 }
-function _resetForTesting() {
+function _resetForTesting2() {
   browserState = null;
   lastTrace = null;
   redactionConfig = buildRedactionConfig();
@@ -773,6 +1134,7 @@ var init_tracing = __esm({
   "src/_internal/tracing.ts"() {
     init_env();
     init_otel_provider_browser();
+    init_diagnostics();
     init_redaction();
     init_spans();
     als = null;
@@ -891,6 +1253,7 @@ var init_propagation = __esm({
 });
 
 exports._resetForTesting = _resetForTesting;
+exports._resetForTesting2 = _resetForTesting2;
 exports.buildRedactionConfig = buildRedactionConfig;
 exports.buildTraceEntry = buildTraceEntry;
 exports.extractTraceparent = extractTraceparent;
@@ -910,6 +1273,7 @@ exports.getMaxQueueSize = getMaxQueueSize;
 exports.getRedactionConfig = getRedactionConfig;
 exports.getSampleRate = getSampleRate;
 exports.getTransport = getTransport;
+exports.init_diagnostics = init_diagnostics;
 exports.init_env = init_env;
 exports.init_otel_provider_browser = init_otel_provider_browser;
 exports.init_propagation = init_propagation;
@@ -918,21 +1282,22 @@ exports.init_spans = init_spans;
 exports.init_tracing = init_tracing;
 exports.injectIntoRequestInit = injectIntoRequestInit;
 exports.injectTraceparent = injectTraceparent;
-exports.isDebug = isDebug;
 exports.isDisabled = isDisabled;
-exports.isTelemetryDisabled = isTelemetryDisabled;
 exports.isValidInternalSource = isValidInternalSource;
 exports.nowIso = nowIso;
+exports.recordDrop = recordDrop;
 exports.redactValue = redactValue;
+exports.report = report;
 exports.runAsync = runAsync;
 exports.runSync = runSync;
 exports.sendTrace = sendTrace;
 exports.setContext = setContext;
-exports.setRedactionConfig = setRedactionConfig;
+exports.setLevel = setLevel;
+exports.setRedactionConfig = setRedactionConfig2;
 exports.setSource = setSource;
 exports.setTransport = setTransport;
 exports.spanAsync = spanAsync;
 exports.spanSync = spanSync;
 exports.startSpan = startSpan;
-//# sourceMappingURL=chunk-DXWHT3HK.cjs.map
-//# sourceMappingURL=chunk-DXWHT3HK.cjs.map
+//# sourceMappingURL=chunk-A5EYWAOT.cjs.map
+//# sourceMappingURL=chunk-A5EYWAOT.cjs.map