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

package/dist/browser/{chunk-F3B4UR64.js → chunk-6DOP3MTY.js}

@@ -118,53 +118,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 ?? {};
@@ -353,6 +306,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, REASON_QUEUE_FULL, REASON_RETRY_EXHAUSTED, REASON_QUOTA_REJECTED, REASON_SHUTDOWN_DROP, 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.1" ;
+    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;
+    REASON_QUEUE_FULL = "queue_full";
+    REASON_RETRY_EXHAUSTED = "retry_exhausted";
+    REASON_QUOTA_REJECTED = "quota_rejected";
+    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);
@@ -453,8 +777,9 @@ function setTransport(t) {
 function getTransport() {
   return transport;
 }
-function setRedactionConfig(config) {
+function setRedactionConfig2(config) {
   redactionConfig = config;
+  setRedactionConfig(config);
 }
 function getRedactionConfig() {
   return redactionConfig;
@@ -543,8 +868,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;
 }
@@ -761,7 +1093,7 @@ async function spanAsync(opts, fn) {
     throw err;
   }
 }
-function _resetForTesting() {
+function _resetForTesting2() {
   browserState = null;
   lastTrace = null;
   redactionConfig = buildRedactionConfig();
@@ -771,6 +1103,7 @@ var init_tracing = __esm({
   "src/_internal/tracing.ts"() {
     init_env();
     init_otel_provider_browser();
+    init_diagnostics();
     init_redaction();
     init_spans();
     als = null;
@@ -888,6 +1221,6 @@ var init_propagation = __esm({
   }
 });
 
-export { DEFAULT_ENDPOINT, SpanType, W3C_TRACEPARENT_HEADER, _resetForTesting, buildRedactionConfig, buildTraceEntry, extractTraceparent, formatTraceparent, generateSpanId, generateTraceId, getActiveTraceState, getApiKey, getEndpoint, getEngine, getFlushIntervalSeconds, getInternalSource, getLastTrace, getMaxBatchSize, getMaxFieldBytes, getMaxQueueSize, getRedactionConfig, getSampleRate, getTransport, init_env, init_otel_provider_browser, init_propagation, init_redaction, init_spans, init_tracing, injectIntoRequestInit, injectTraceparent, isDebug, isDisabled, isTelemetryDisabled, isValidInternalSource, nowIso, redactValue, runAsync, runSync, sendTrace, setContext, setRedactionConfig, setSource, setTransport, spanAsync, spanSync, startSpan };
-//# sourceMappingURL=chunk-F3B4UR64.js.map
-//# sourceMappingURL=chunk-F3B4UR64.js.map
+export { DEFAULT_ENDPOINT, REASON_QUEUE_FULL, REASON_QUOTA_REJECTED, REASON_RETRY_EXHAUSTED, REASON_SHUTDOWN_DROP, SpanType, W3C_TRACEPARENT_HEADER, _resetForTesting, _resetForTesting2, buildRedactionConfig, buildTraceEntry, extractTraceparent, formatTraceparent, generateSpanId, generateTraceId, getActiveTraceState, getApiKey, getEndpoint, getEngine, getFlushIntervalSeconds, getInternalSource, getLastTrace, getMaxBatchSize, getMaxFieldBytes, getMaxQueueSize, getRedactionConfig, getSampleRate, getTransport, init_diagnostics, init_env, init_otel_provider_browser, init_propagation, init_redaction, init_spans, init_tracing, injectIntoRequestInit, injectTraceparent, isDisabled, isValidInternalSource, nowIso, recordDrop, redactValue, report, runAsync, runSync, sendTrace, setContext, setLevel, setRedactionConfig2 as setRedactionConfig, setSource, setTransport, spanAsync, spanSync, startSpan };
+//# sourceMappingURL=chunk-6DOP3MTY.js.map
+//# sourceMappingURL=chunk-6DOP3MTY.js.map