kmind-apm-web 0.1.0

package/dist/index.cjs

@@ -0,0 +1,490 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key3 of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key3) && key3 !== except)
+        __defProp(to, key3, { get: () => from[key3], enumerable: !(desc = __getOwnPropDesc(from, key3)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getActiveTraceId: () => getActiveTraceId,
+  init: () => init,
+  logger: () => logger,
+  recordMetric: () => recordMetric
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+function resolveConfig(input) {
+  if (!input.serviceName.trim()) throw new Error("serviceName is required");
+  if (!input.clientKey.trim()) throw new Error("clientKey is required");
+  const sampleRate = input.sampleRate ?? 1;
+  if (sampleRate < 0 || sampleRate > 1) throw new Error("sampleRate must be between 0 and 1");
+  return {
+    serviceName: input.serviceName.trim(),
+    clientKey: input.clientKey.trim(),
+    enabled: input.enabled ?? true,
+    sampleRate,
+    debugHttp: input.debugHttp ?? false,
+    debugTrace: input.debugTrace ?? false,
+    captureConsole: input.captureConsole ?? false,
+    propagateTraceTo: input.propagateTraceTo ?? [],
+    endpoint: (input.endpoint ?? "https://ingest.kmind.com.br/v1").replace(/\/$/, ""),
+    statusEndpoint: input.statusEndpoint ?? "https://ingest.kmind.com.br/v1/apm/status",
+    scrub: input.scrub ?? ((value) => value),
+    privacy: { redactAttributeKeys: input.privacy?.redactAttributeKeys ?? ["token", "email", "cpf", "password", "authorization", "cookie"], redactUrlQueryKeys: input.privacy?.redactUrlQueryKeys ?? ["token", "email", "cpf", "password"] },
+    slowTraceThresholdMs: input.slowTraceThresholdMs ?? 1e3
+  };
+}
+
+// src/utils.ts
+function safeRun(fn, debug = false) {
+  try {
+    fn();
+  } catch (error) {
+    if (debug) console.debug("[Kmind APM]", error);
+  }
+}
+function nanoNow() {
+  return String(BigInt(Date.now()) * 1000000n);
+}
+function randomHex(bytes) {
+  const data = new Uint8Array(bytes);
+  crypto.getRandomValues(data);
+  return Array.from(data, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function attributes(values) {
+  return Object.entries(values).filter(([, value]) => value !== void 0 && value !== null).map(([key3, value]) => ({ key: key3, value: { stringValue: String(value) } }));
+}
+
+// src/session.ts
+var key = "kmind.apm.session.id";
+function sessionId() {
+  try {
+    const value = sessionStorage.getItem(key);
+    if (value) return value;
+    const next = randomHex(16);
+    sessionStorage.setItem(key, next);
+    return next;
+  } catch {
+    return randomHex(16);
+  }
+}
+
+// src/otlp.ts
+var resource = (serviceName) => ({ attributes: attributes({ "service.name": serviceName, "session.id": sessionId(), "telemetry.sdk.name": "kmind-apm-web" }) });
+function tracePayload(serviceName, span) {
+  return { resourceSpans: [{ resource: resource(serviceName), scopeSpans: [{ scope: { name: "kmind-apm-web" }, spans: [{ traceId: span.traceId, spanId: span.spanId, parentSpanId: span.parentSpanId, name: span.name, kind: 3, startTimeUnixNano: span.start, endTimeUnixNano: span.end ?? nanoNow(), attributes: attributes(span.attrs), status: span.status === "ERROR" ? { code: 2 } : { code: 1 } }] }] }] };
+}
+function metricPayload(serviceName, name, value, attrs) {
+  return { resourceMetrics: [{ resource: resource(serviceName), scopeMetrics: [{ scope: { name: "kmind-apm-web" }, metrics: [{ name, unit: "ms", gauge: { dataPoints: [{ asDouble: value, timeUnixNano: nanoNow(), attributes: attributes({ "url.path": location.pathname, "session.id": sessionId(), ...attrs }) }] } }] }] }] };
+}
+function logPayload(serviceName, severity, message2, attrs) {
+  return { resourceLogs: [{ resource: resource(serviceName), scopeLogs: [{ scope: { name: "kmind-apm-web" }, logRecords: [{ timeUnixNano: nanoNow(), severityText: severity, body: { stringValue: message2 }, attributes: attributes({ "session.id": sessionId(), ...attrs }) }] }] }] };
+}
+
+// src/privacy.ts
+var config;
+var defaultKeys = ["token", "email", "cpf", "password"];
+function configurePrivacy(next) {
+  config = next;
+}
+function scrub(value, key3 = "") {
+  const attributeKey = key3.toLowerCase();
+  const attributeKeys = config?.privacy.redactAttributeKeys ?? [...defaultKeys, "authorization", "cookie"];
+  const queryKeys = config?.privacy.redactUrlQueryKeys ?? defaultKeys;
+  if (attributeKeys.some((item) => item.toLowerCase() === attributeKey)) return "[redacted]";
+  let sanitized = value;
+  try {
+    const url = new URL(value, typeof location === "undefined" ? "https://kmind.invalid" : location.href);
+    queryKeys.forEach((queryKey) => {
+      if (url.searchParams.has(queryKey)) url.searchParams.set(queryKey, "[redacted]");
+    });
+    if (url.origin !== "https://kmind.invalid") sanitized = url.toString();
+    else if (value.startsWith("/")) sanitized = `${url.pathname}${url.search}${url.hash}`;
+  } catch {
+  }
+  sanitized = sanitized.replace(/(token|email|cpf|password)=([^&#\s]*)/gi, "$1=[redacted]");
+  try {
+    return config?.scrub(sanitized, key3) ?? sanitized;
+  } catch {
+    return sanitized;
+  }
+}
+function scrubAttributes(values) {
+  return Object.fromEntries(Object.entries(values).map(([key3, value]) => [key3, scrub(String(value), key3)]));
+}
+
+// src/transport.ts
+var MAX_QUEUED_EVENTS_PER_SIGNAL = 100;
+var MAX_BATCH_EVENTS = 20;
+var MAX_PAYLOAD_BYTES = 60 * 1024;
+var FLUSH_INTERVAL_MS = 5e3;
+var REQUEST_TIMEOUT_MS = 3e3;
+var queues = { traces: [], metrics: [], logs: [] };
+var nativeFetch = typeof window !== "undefined" ? window.fetch.bind(window) : void 0;
+var timer;
+var config2;
+var active = true;
+var inFlight = { traces: false, metrics: false, logs: false };
+function configureTransport(next) {
+  config2 = next;
+  active = next.enabled;
+}
+function disableTransport() {
+  active = false;
+  Object.keys(queues).forEach((key3) => {
+    queues[key3] = [];
+  });
+}
+function enqueue(signal, event) {
+  if (!active || !config2) return;
+  if (queues[signal].length >= MAX_QUEUED_EVENTS_PER_SIGNAL) return;
+  queues[signal].push(event);
+  if (queues[signal].length >= MAX_BATCH_EVENTS) scheduleFlush(0);
+  else if (!timer) scheduleFlush(FLUSH_INTERVAL_MS);
+}
+function scheduleFlush(delay) {
+  if (timer || typeof window === "undefined") return;
+  timer = window.setTimeout(() => {
+    timer = void 0;
+    void flushAll();
+  }, delay);
+}
+function payloadFor(signal, events) {
+  const collection = signal === "traces" ? "resourceSpans" : signal === "metrics" ? "resourceMetrics" : "resourceLogs";
+  try {
+    const payload = JSON.stringify({ [collection]: events.flatMap((event) => event[collection] ?? []), _kmind: { clientKey: config2?.clientKey } });
+    return new TextEncoder().encode(payload).byteLength <= MAX_PAYLOAD_BYTES ? payload : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function flush(signal) {
+  if (inFlight[signal] || !config2 || !active) return;
+  const events = queues[signal].splice(0, MAX_BATCH_EVENTS);
+  if (!events.length) return;
+  const payload = payloadFor(signal, events);
+  if (!payload) {
+    if (queues[signal].length) scheduleFlush(FLUSH_INTERVAL_MS);
+    return;
+  }
+  const url = `${config2.endpoint}/${signal}`;
+  inFlight[signal] = true;
+  try {
+    const beaconSender = typeof navigator === "undefined" ? void 0 : navigator.sendBeacon.bind(navigator);
+    const body = new Blob([payload], { type: "application/json" });
+    if (body.size < 64 * 1024 && beaconSender?.(url, body)) return;
+    if (!nativeFetch) return;
+    const controller = new AbortController();
+    const timeout = window.setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      await nativeFetch(url, { method: "POST", keepalive: true, headers: { "Content-Type": "application/json", "X-Kmind-Client-Key": config2.clientKey }, body: payload, signal: controller.signal });
+    } finally {
+      window.clearTimeout(timeout);
+    }
+  } catch {
+  } finally {
+    inFlight[signal] = false;
+    if (queues[signal].length) scheduleFlush(FLUSH_INTERVAL_MS);
+  }
+}
+async function flushAll() {
+  await Promise.all(Object.keys(queues).map(flush));
+}
+function installPageFlush() {
+  window.addEventListener("pagehide", () => void flushAll(), { once: false });
+}
+
+// src/sampling.ts
+function shouldSample(rate) {
+  return rate >= 1 || rate > 0 && Math.random() < rate;
+}
+function shouldPromoteTrace(error, durationMs, slowThresholdMs) {
+  return error || durationMs >= slowThresholdMs;
+}
+
+// src/tracing.ts
+var config3;
+var current;
+var traceStates = /* @__PURE__ */ new Map();
+function configureTracing(next) {
+  config3 = next;
+}
+function getActiveTraceId() {
+  return current?.traceId;
+}
+function getActiveSpanContext() {
+  return current ? { traceId: current.traceId, spanId: current.spanId } : void 0;
+}
+function startSpan(name, attrs = {}) {
+  const parent = current;
+  const traceId = parent?.traceId ?? randomHex(16);
+  if (!traceStates.has(traceId)) traceStates.set(traceId, { sampled: shouldSample(config3.sampleRate), pending: [] });
+  return { traceId, spanId: randomHex(8), parentSpanId: parent?.spanId, name, start: nanoNow(), attrs: scrubAttributes(attrs) };
+}
+function endSpan(span, error = false) {
+  span.end = nanoNow();
+  span.status = error ? "ERROR" : "OK";
+  const state = traceStates.get(span.traceId) ?? { sampled: true, pending: [] };
+  const durationMs = Number(BigInt(span.end) - BigInt(span.start)) / 1e6;
+  const promoted = shouldPromoteTrace(error, durationMs, config3.slowTraceThresholdMs);
+  if (state.sampled || promoted) {
+    state.pending.forEach((item) => enqueue("traces", tracePayload(config3.serviceName, item)));
+    state.pending = [];
+    state.sampled = true;
+    enqueue("traces", tracePayload(config3.serviceName, span));
+  } else state.pending.push(span);
+  if (!span.parentSpanId) traceStates.delete(span.traceId);
+}
+function withActive(span, fn) {
+  const previous = current;
+  current = span;
+  try {
+    return fn();
+  } finally {
+    current = previous;
+  }
+}
+function installPageTracing() {
+  safeRun(() => {
+    const page = startSpan("documentLoad", { "url.full": location.href });
+    current = page;
+    window.addEventListener("pagehide", () => endSpan(page));
+    document.addEventListener("click", () => {
+      const span = startSpan("user.click");
+      endSpan(span);
+    }, true);
+    document.addEventListener("submit", () => {
+      const span = startSpan("form.submit");
+      endSpan(span);
+    }, true);
+  }, config3.debugTrace);
+}
+function recordError(message2, attrs = {}) {
+  safeRun(() => {
+    const span = startSpan("exception", { "exception.message": message2, ...attrs });
+    endSpan(span, true);
+  }, config3.debugTrace);
+}
+
+// src/logger.ts
+var config4;
+function configureLogger(next) {
+  config4 = next;
+}
+function normalizeAttributes(input) {
+  return Object.fromEntries(Object.entries(input).map(([key3, value]) => [key3, scrub(typeof value === "string" ? value : JSON.stringify(value), key3)]));
+}
+function write(severity, message2, attributes2 = {}) {
+  safeRun(() => {
+    if (!config4) return;
+    const context = getActiveSpanContext();
+    enqueue("logs", logPayload(config4.serviceName, severity, scrub(message2), {
+      ...normalizeAttributes(attributes2),
+      trace_id: context?.traceId,
+      span_id: context?.spanId
+    }));
+  }, config4?.debugTrace);
+}
+var logger = {
+  info: (message2, attributes2) => write("INFO", message2, attributes2),
+  warn: (message2, attributes2) => write("WARN", message2, attributes2),
+  error: (message2, attributes2) => write("ERROR", message2, attributes2)
+};
+
+// src/errors.ts
+function installErrorCapture(config6) {
+  window.addEventListener("error", (event) => safeRun(() => {
+    const message2 = scrub(event.message || "Unhandled error");
+    const stack = scrub(event.error?.stack ?? "");
+    recordError(message2, { "exception.stacktrace": stack });
+    logger.error(message2, { "exception.stacktrace": stack, "log.source": "window.onerror" });
+  }, config6.debugTrace));
+  window.addEventListener("unhandledrejection", (event) => safeRun(() => {
+    const message2 = scrub(String(event.reason?.message ?? event.reason ?? "Unhandled rejection"));
+    recordError(message2);
+    logger.error(message2, { "log.source": "unhandledrejection" });
+  }, config6.debugTrace));
+}
+
+// src/heartbeat.ts
+var key2 = "kmind.apm.status";
+var interval = 36e5;
+var nativeFetch2 = typeof window !== "undefined" ? window.fetch.bind(window) : void 0;
+async function heartbeat(config6) {
+  try {
+    if (!nativeFetch2) return;
+    const cached = JSON.parse(sessionStorage.getItem(key2) || "null");
+    if (cached && Date.now() - cached.at < interval) {
+      if (!cached.active) disableTransport();
+      return;
+    }
+    const controller = new AbortController();
+    const timeout = window.setTimeout(() => controller.abort(), 3e3);
+    try {
+      const response = await nativeFetch2(config6.statusEndpoint, { headers: { "X-Kmind-Client-Key": config6.clientKey }, signal: controller.signal });
+      const data = await response.json();
+      const active2 = data.active !== false;
+      sessionStorage.setItem(key2, JSON.stringify({ at: Date.now(), active: active2 }));
+      if (!active2) disableTransport();
+    } finally {
+      window.clearTimeout(timeout);
+    }
+  } catch {
+  }
+}
+
+// src/network.ts
+function shouldPropagate(url, config6) {
+  try {
+    return config6.propagateTraceTo.includes(new URL(url, location.href).hostname);
+  } catch {
+    return false;
+  }
+}
+function traceparent(span) {
+  return `00-${span.traceId}-${span.spanId}-01`;
+}
+function installFetchInstrumentation(config6) {
+  const original = window.fetch.bind(window);
+  window.fetch = (input, init2 = {}) => {
+    let span;
+    let requestInit = init2;
+    try {
+      const isRequest = typeof Request !== "undefined" && input instanceof Request;
+      const url = typeof input === "string" ? input : isRequest ? input.url : String(input);
+      const method = init2.method ?? (isRequest ? input.method : "GET");
+      span = startSpan("HTTP " + method, { "http.request.method": method, "url.full": url, "server.address": new URL(url, location.href).hostname });
+      if (shouldPropagate(url, config6)) {
+        const headers = new Headers(init2.headers ?? (isRequest ? input.headers : void 0));
+        headers.set("traceparent", traceparent(span));
+        requestInit = { ...init2, headers };
+      }
+    } catch {
+      return original(input, init2);
+    }
+    let request;
+    try {
+      request = withActive(span, () => original(input, requestInit));
+    } catch (error) {
+      safeRun(() => endSpan(span, true), config6.debugTrace);
+      throw error;
+    }
+    return request.then(
+      (response) => {
+        safeRun(() => endSpan(span, response.status >= 400), config6.debugTrace);
+        return response;
+      },
+      (error) => {
+        safeRun(() => endSpan(span, true), config6.debugTrace);
+        throw error;
+      }
+    );
+  };
+}
+function installXhrInstrumentation(config6) {
+  const open = XMLHttpRequest.prototype.open;
+  const send = XMLHttpRequest.prototype.send;
+  XMLHttpRequest.prototype.open = function(method, url, ...rest) {
+    safeRun(() => {
+      this.__kmind = { method, url: String(url) };
+    }, config6.debugTrace);
+    return open.apply(this, [method, url, ...rest]);
+  };
+  XMLHttpRequest.prototype.send = function(...args) {
+    const meta = this.__kmind;
+    if (!meta) return send.apply(this, args);
+    let span;
+    safeRun(() => {
+      span = startSpan("HTTP " + meta.method, { "http.request.method": meta.method, "url.full": meta.url });
+      if (shouldPropagate(meta.url, config6)) this.setRequestHeader("traceparent", traceparent(span));
+      this.addEventListener("loadend", () => safeRun(() => endSpan(span, this.status >= 400), config6.debugTrace), { once: true });
+    }, config6.debugTrace);
+    return send.apply(this, args);
+  };
+}
+
+// src/vitals.ts
+var import_web_vitals = require("web-vitals");
+function installWebVitals(config6) {
+  const report = (metric) => enqueue("metrics", metricPayload(config6.serviceName, `web.vital.${metric.name.toLowerCase()}`, metric.value, {}));
+  safeRun(() => {
+    (0, import_web_vitals.onCLS)(report);
+    (0, import_web_vitals.onFCP)(report);
+    (0, import_web_vitals.onINP)(report);
+    (0, import_web_vitals.onLCP)(report);
+    (0, import_web_vitals.onTTFB)(report);
+  }, config6.debugTrace);
+}
+
+// src/consoleCapture.ts
+function message(args) {
+  return args.map((value) => {
+    if (value instanceof Error) return value.stack || value.message;
+    if (typeof value === "string") return value;
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  }).join(" ");
+}
+function installConsoleCapture(config6) {
+  ["warn", "error"].forEach((level) => {
+    const original = console[level].bind(console);
+    console[level] = (...args) => {
+      original(...args);
+      safeRun(() => logger[level](message(args), { "log.source": "console" }), config6.debugTrace);
+    };
+  });
+}
+
+// src/index.ts
+var initialized = false;
+var config5;
+function init(input) {
+  safeRun(() => {
+    if (initialized || typeof window === "undefined") return;
+    config5 = resolveConfig(input);
+    if (!config5.enabled) return;
+    initialized = true;
+    configurePrivacy(config5);
+    configureTransport(config5);
+    configureTracing(config5);
+    configureLogger(config5);
+    installPageFlush();
+    installPageTracing();
+    installFetchInstrumentation(config5);
+    installXhrInstrumentation(config5);
+    installWebVitals(config5);
+    installErrorCapture(config5);
+    if (config5.captureConsole) installConsoleCapture(config5);
+    void heartbeat(config5);
+  }, input.debugTrace);
+}
+function recordMetric(name, value, attributes2 = {}) {
+  safeRun(() => {
+    if (config5 && Number.isFinite(value)) enqueue("metrics", metricPayload(config5.serviceName, name, value, attributes2));
+  }, config5?.debugTrace);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getActiveTraceId,
+  init,
+  logger,
+  recordMetric
+});

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+type PrivacyRules = {
+    redactAttributeKeys?: string[];
+    redactUrlQueryKeys?: string[];
+};
+type KmindConfig = {
+    serviceName: string;
+    clientKey: string;
+    enabled?: boolean;
+    sampleRate?: number;
+    debugHttp?: boolean;
+    debugTrace?: boolean;
+    /** Capture console.warn/error. Disabled by default because it patches global console methods. */
+    captureConsole?: boolean;
+    propagateTraceTo?: string[];
+    endpoint?: string;
+    statusEndpoint?: string;
+    scrub?: (value: string, key: string) => string;
+    privacy?: PrivacyRules;
+    slowTraceThresholdMs?: number;
+};
+
+declare function getActiveTraceId(): string | undefined;
+
+type KmindLogger = {
+    info(message: string, attributes?: Record<string, unknown>): void;
+    warn(message: string, attributes?: Record<string, unknown>): void;
+    error(message: string, attributes?: Record<string, unknown>): void;
+};
+declare const logger: KmindLogger;
+
+declare function init(input: KmindConfig): void;
+declare function recordMetric(name: string, value: number, attributes?: Record<string, string>): void;
+
+export { type KmindConfig, type KmindLogger, getActiveTraceId, init, logger, recordMetric };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+type PrivacyRules = {
+    redactAttributeKeys?: string[];
+    redactUrlQueryKeys?: string[];
+};
+type KmindConfig = {
+    serviceName: string;
+    clientKey: string;
+    enabled?: boolean;
+    sampleRate?: number;
+    debugHttp?: boolean;
+    debugTrace?: boolean;
+    /** Capture console.warn/error. Disabled by default because it patches global console methods. */
+    captureConsole?: boolean;
+    propagateTraceTo?: string[];
+    endpoint?: string;
+    statusEndpoint?: string;
+    scrub?: (value: string, key: string) => string;
+    privacy?: PrivacyRules;
+    slowTraceThresholdMs?: number;
+};
+
+declare function getActiveTraceId(): string | undefined;
+
+type KmindLogger = {
+    info(message: string, attributes?: Record<string, unknown>): void;
+    warn(message: string, attributes?: Record<string, unknown>): void;
+    error(message: string, attributes?: Record<string, unknown>): void;
+};
+declare const logger: KmindLogger;
+
+declare function init(input: KmindConfig): void;
+declare function recordMetric(name: string, value: number, attributes?: Record<string, string>): void;
+
+export { type KmindConfig, type KmindLogger, getActiveTraceId, init, logger, recordMetric };

package/dist/index.js

@@ -0,0 +1,460 @@
+// src/config.ts
+function resolveConfig(input) {
+  if (!input.serviceName.trim()) throw new Error("serviceName is required");
+  if (!input.clientKey.trim()) throw new Error("clientKey is required");
+  const sampleRate = input.sampleRate ?? 1;
+  if (sampleRate < 0 || sampleRate > 1) throw new Error("sampleRate must be between 0 and 1");
+  return {
+    serviceName: input.serviceName.trim(),
+    clientKey: input.clientKey.trim(),
+    enabled: input.enabled ?? true,
+    sampleRate,
+    debugHttp: input.debugHttp ?? false,
+    debugTrace: input.debugTrace ?? false,
+    captureConsole: input.captureConsole ?? false,
+    propagateTraceTo: input.propagateTraceTo ?? [],
+    endpoint: (input.endpoint ?? "https://ingest.kmind.com.br/v1").replace(/\/$/, ""),
+    statusEndpoint: input.statusEndpoint ?? "https://ingest.kmind.com.br/v1/apm/status",
+    scrub: input.scrub ?? ((value) => value),
+    privacy: { redactAttributeKeys: input.privacy?.redactAttributeKeys ?? ["token", "email", "cpf", "password", "authorization", "cookie"], redactUrlQueryKeys: input.privacy?.redactUrlQueryKeys ?? ["token", "email", "cpf", "password"] },
+    slowTraceThresholdMs: input.slowTraceThresholdMs ?? 1e3
+  };
+}
+
+// src/utils.ts
+function safeRun(fn, debug = false) {
+  try {
+    fn();
+  } catch (error) {
+    if (debug) console.debug("[Kmind APM]", error);
+  }
+}
+function nanoNow() {
+  return String(BigInt(Date.now()) * 1000000n);
+}
+function randomHex(bytes) {
+  const data = new Uint8Array(bytes);
+  crypto.getRandomValues(data);
+  return Array.from(data, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function attributes(values) {
+  return Object.entries(values).filter(([, value]) => value !== void 0 && value !== null).map(([key3, value]) => ({ key: key3, value: { stringValue: String(value) } }));
+}
+
+// src/session.ts
+var key = "kmind.apm.session.id";
+function sessionId() {
+  try {
+    const value = sessionStorage.getItem(key);
+    if (value) return value;
+    const next = randomHex(16);
+    sessionStorage.setItem(key, next);
+    return next;
+  } catch {
+    return randomHex(16);
+  }
+}
+
+// src/otlp.ts
+var resource = (serviceName) => ({ attributes: attributes({ "service.name": serviceName, "session.id": sessionId(), "telemetry.sdk.name": "kmind-apm-web" }) });
+function tracePayload(serviceName, span) {
+  return { resourceSpans: [{ resource: resource(serviceName), scopeSpans: [{ scope: { name: "kmind-apm-web" }, spans: [{ traceId: span.traceId, spanId: span.spanId, parentSpanId: span.parentSpanId, name: span.name, kind: 3, startTimeUnixNano: span.start, endTimeUnixNano: span.end ?? nanoNow(), attributes: attributes(span.attrs), status: span.status === "ERROR" ? { code: 2 } : { code: 1 } }] }] }] };
+}
+function metricPayload(serviceName, name, value, attrs) {
+  return { resourceMetrics: [{ resource: resource(serviceName), scopeMetrics: [{ scope: { name: "kmind-apm-web" }, metrics: [{ name, unit: "ms", gauge: { dataPoints: [{ asDouble: value, timeUnixNano: nanoNow(), attributes: attributes({ "url.path": location.pathname, "session.id": sessionId(), ...attrs }) }] } }] }] }] };
+}
+function logPayload(serviceName, severity, message2, attrs) {
+  return { resourceLogs: [{ resource: resource(serviceName), scopeLogs: [{ scope: { name: "kmind-apm-web" }, logRecords: [{ timeUnixNano: nanoNow(), severityText: severity, body: { stringValue: message2 }, attributes: attributes({ "session.id": sessionId(), ...attrs }) }] }] }] };
+}
+
+// src/privacy.ts
+var config;
+var defaultKeys = ["token", "email", "cpf", "password"];
+function configurePrivacy(next) {
+  config = next;
+}
+function scrub(value, key3 = "") {
+  const attributeKey = key3.toLowerCase();
+  const attributeKeys = config?.privacy.redactAttributeKeys ?? [...defaultKeys, "authorization", "cookie"];
+  const queryKeys = config?.privacy.redactUrlQueryKeys ?? defaultKeys;
+  if (attributeKeys.some((item) => item.toLowerCase() === attributeKey)) return "[redacted]";
+  let sanitized = value;
+  try {
+    const url = new URL(value, typeof location === "undefined" ? "https://kmind.invalid" : location.href);
+    queryKeys.forEach((queryKey) => {
+      if (url.searchParams.has(queryKey)) url.searchParams.set(queryKey, "[redacted]");
+    });
+    if (url.origin !== "https://kmind.invalid") sanitized = url.toString();
+    else if (value.startsWith("/")) sanitized = `${url.pathname}${url.search}${url.hash}`;
+  } catch {
+  }
+  sanitized = sanitized.replace(/(token|email|cpf|password)=([^&#\s]*)/gi, "$1=[redacted]");
+  try {
+    return config?.scrub(sanitized, key3) ?? sanitized;
+  } catch {
+    return sanitized;
+  }
+}
+function scrubAttributes(values) {
+  return Object.fromEntries(Object.entries(values).map(([key3, value]) => [key3, scrub(String(value), key3)]));
+}
+
+// src/transport.ts
+var MAX_QUEUED_EVENTS_PER_SIGNAL = 100;
+var MAX_BATCH_EVENTS = 20;
+var MAX_PAYLOAD_BYTES = 60 * 1024;
+var FLUSH_INTERVAL_MS = 5e3;
+var REQUEST_TIMEOUT_MS = 3e3;
+var queues = { traces: [], metrics: [], logs: [] };
+var nativeFetch = typeof window !== "undefined" ? window.fetch.bind(window) : void 0;
+var timer;
+var config2;
+var active = true;
+var inFlight = { traces: false, metrics: false, logs: false };
+function configureTransport(next) {
+  config2 = next;
+  active = next.enabled;
+}
+function disableTransport() {
+  active = false;
+  Object.keys(queues).forEach((key3) => {
+    queues[key3] = [];
+  });
+}
+function enqueue(signal, event) {
+  if (!active || !config2) return;
+  if (queues[signal].length >= MAX_QUEUED_EVENTS_PER_SIGNAL) return;
+  queues[signal].push(event);
+  if (queues[signal].length >= MAX_BATCH_EVENTS) scheduleFlush(0);
+  else if (!timer) scheduleFlush(FLUSH_INTERVAL_MS);
+}
+function scheduleFlush(delay) {
+  if (timer || typeof window === "undefined") return;
+  timer = window.setTimeout(() => {
+    timer = void 0;
+    void flushAll();
+  }, delay);
+}
+function payloadFor(signal, events) {
+  const collection = signal === "traces" ? "resourceSpans" : signal === "metrics" ? "resourceMetrics" : "resourceLogs";
+  try {
+    const payload = JSON.stringify({ [collection]: events.flatMap((event) => event[collection] ?? []), _kmind: { clientKey: config2?.clientKey } });
+    return new TextEncoder().encode(payload).byteLength <= MAX_PAYLOAD_BYTES ? payload : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function flush(signal) {
+  if (inFlight[signal] || !config2 || !active) return;
+  const events = queues[signal].splice(0, MAX_BATCH_EVENTS);
+  if (!events.length) return;
+  const payload = payloadFor(signal, events);
+  if (!payload) {
+    if (queues[signal].length) scheduleFlush(FLUSH_INTERVAL_MS);
+    return;
+  }
+  const url = `${config2.endpoint}/${signal}`;
+  inFlight[signal] = true;
+  try {
+    const beaconSender = typeof navigator === "undefined" ? void 0 : navigator.sendBeacon.bind(navigator);
+    const body = new Blob([payload], { type: "application/json" });
+    if (body.size < 64 * 1024 && beaconSender?.(url, body)) return;
+    if (!nativeFetch) return;
+    const controller = new AbortController();
+    const timeout = window.setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      await nativeFetch(url, { method: "POST", keepalive: true, headers: { "Content-Type": "application/json", "X-Kmind-Client-Key": config2.clientKey }, body: payload, signal: controller.signal });
+    } finally {
+      window.clearTimeout(timeout);
+    }
+  } catch {
+  } finally {
+    inFlight[signal] = false;
+    if (queues[signal].length) scheduleFlush(FLUSH_INTERVAL_MS);
+  }
+}
+async function flushAll() {
+  await Promise.all(Object.keys(queues).map(flush));
+}
+function installPageFlush() {
+  window.addEventListener("pagehide", () => void flushAll(), { once: false });
+}
+
+// src/sampling.ts
+function shouldSample(rate) {
+  return rate >= 1 || rate > 0 && Math.random() < rate;
+}
+function shouldPromoteTrace(error, durationMs, slowThresholdMs) {
+  return error || durationMs >= slowThresholdMs;
+}
+
+// src/tracing.ts
+var config3;
+var current;
+var traceStates = /* @__PURE__ */ new Map();
+function configureTracing(next) {
+  config3 = next;
+}
+function getActiveTraceId() {
+  return current?.traceId;
+}
+function getActiveSpanContext() {
+  return current ? { traceId: current.traceId, spanId: current.spanId } : void 0;
+}
+function startSpan(name, attrs = {}) {
+  const parent = current;
+  const traceId = parent?.traceId ?? randomHex(16);
+  if (!traceStates.has(traceId)) traceStates.set(traceId, { sampled: shouldSample(config3.sampleRate), pending: [] });
+  return { traceId, spanId: randomHex(8), parentSpanId: parent?.spanId, name, start: nanoNow(), attrs: scrubAttributes(attrs) };
+}
+function endSpan(span, error = false) {
+  span.end = nanoNow();
+  span.status = error ? "ERROR" : "OK";
+  const state = traceStates.get(span.traceId) ?? { sampled: true, pending: [] };
+  const durationMs = Number(BigInt(span.end) - BigInt(span.start)) / 1e6;
+  const promoted = shouldPromoteTrace(error, durationMs, config3.slowTraceThresholdMs);
+  if (state.sampled || promoted) {
+    state.pending.forEach((item) => enqueue("traces", tracePayload(config3.serviceName, item)));
+    state.pending = [];
+    state.sampled = true;
+    enqueue("traces", tracePayload(config3.serviceName, span));
+  } else state.pending.push(span);
+  if (!span.parentSpanId) traceStates.delete(span.traceId);
+}
+function withActive(span, fn) {
+  const previous = current;
+  current = span;
+  try {
+    return fn();
+  } finally {
+    current = previous;
+  }
+}
+function installPageTracing() {
+  safeRun(() => {
+    const page = startSpan("documentLoad", { "url.full": location.href });
+    current = page;
+    window.addEventListener("pagehide", () => endSpan(page));
+    document.addEventListener("click", () => {
+      const span = startSpan("user.click");
+      endSpan(span);
+    }, true);
+    document.addEventListener("submit", () => {
+      const span = startSpan("form.submit");
+      endSpan(span);
+    }, true);
+  }, config3.debugTrace);
+}
+function recordError(message2, attrs = {}) {
+  safeRun(() => {
+    const span = startSpan("exception", { "exception.message": message2, ...attrs });
+    endSpan(span, true);
+  }, config3.debugTrace);
+}
+
+// src/logger.ts
+var config4;
+function configureLogger(next) {
+  config4 = next;
+}
+function normalizeAttributes(input) {
+  return Object.fromEntries(Object.entries(input).map(([key3, value]) => [key3, scrub(typeof value === "string" ? value : JSON.stringify(value), key3)]));
+}
+function write(severity, message2, attributes2 = {}) {
+  safeRun(() => {
+    if (!config4) return;
+    const context = getActiveSpanContext();
+    enqueue("logs", logPayload(config4.serviceName, severity, scrub(message2), {
+      ...normalizeAttributes(attributes2),
+      trace_id: context?.traceId,
+      span_id: context?.spanId
+    }));
+  }, config4?.debugTrace);
+}
+var logger = {
+  info: (message2, attributes2) => write("INFO", message2, attributes2),
+  warn: (message2, attributes2) => write("WARN", message2, attributes2),
+  error: (message2, attributes2) => write("ERROR", message2, attributes2)
+};
+
+// src/errors.ts
+function installErrorCapture(config6) {
+  window.addEventListener("error", (event) => safeRun(() => {
+    const message2 = scrub(event.message || "Unhandled error");
+    const stack = scrub(event.error?.stack ?? "");
+    recordError(message2, { "exception.stacktrace": stack });
+    logger.error(message2, { "exception.stacktrace": stack, "log.source": "window.onerror" });
+  }, config6.debugTrace));
+  window.addEventListener("unhandledrejection", (event) => safeRun(() => {
+    const message2 = scrub(String(event.reason?.message ?? event.reason ?? "Unhandled rejection"));
+    recordError(message2);
+    logger.error(message2, { "log.source": "unhandledrejection" });
+  }, config6.debugTrace));
+}
+
+// src/heartbeat.ts
+var key2 = "kmind.apm.status";
+var interval = 36e5;
+var nativeFetch2 = typeof window !== "undefined" ? window.fetch.bind(window) : void 0;
+async function heartbeat(config6) {
+  try {
+    if (!nativeFetch2) return;
+    const cached = JSON.parse(sessionStorage.getItem(key2) || "null");
+    if (cached && Date.now() - cached.at < interval) {
+      if (!cached.active) disableTransport();
+      return;
+    }
+    const controller = new AbortController();
+    const timeout = window.setTimeout(() => controller.abort(), 3e3);
+    try {
+      const response = await nativeFetch2(config6.statusEndpoint, { headers: { "X-Kmind-Client-Key": config6.clientKey }, signal: controller.signal });
+      const data = await response.json();
+      const active2 = data.active !== false;
+      sessionStorage.setItem(key2, JSON.stringify({ at: Date.now(), active: active2 }));
+      if (!active2) disableTransport();
+    } finally {
+      window.clearTimeout(timeout);
+    }
+  } catch {
+  }
+}
+
+// src/network.ts
+function shouldPropagate(url, config6) {
+  try {
+    return config6.propagateTraceTo.includes(new URL(url, location.href).hostname);
+  } catch {
+    return false;
+  }
+}
+function traceparent(span) {
+  return `00-${span.traceId}-${span.spanId}-01`;
+}
+function installFetchInstrumentation(config6) {
+  const original = window.fetch.bind(window);
+  window.fetch = (input, init2 = {}) => {
+    let span;
+    let requestInit = init2;
+    try {
+      const isRequest = typeof Request !== "undefined" && input instanceof Request;
+      const url = typeof input === "string" ? input : isRequest ? input.url : String(input);
+      const method = init2.method ?? (isRequest ? input.method : "GET");
+      span = startSpan("HTTP " + method, { "http.request.method": method, "url.full": url, "server.address": new URL(url, location.href).hostname });
+      if (shouldPropagate(url, config6)) {
+        const headers = new Headers(init2.headers ?? (isRequest ? input.headers : void 0));
+        headers.set("traceparent", traceparent(span));
+        requestInit = { ...init2, headers };
+      }
+    } catch {
+      return original(input, init2);
+    }
+    let request;
+    try {
+      request = withActive(span, () => original(input, requestInit));
+    } catch (error) {
+      safeRun(() => endSpan(span, true), config6.debugTrace);
+      throw error;
+    }
+    return request.then(
+      (response) => {
+        safeRun(() => endSpan(span, response.status >= 400), config6.debugTrace);
+        return response;
+      },
+      (error) => {
+        safeRun(() => endSpan(span, true), config6.debugTrace);
+        throw error;
+      }
+    );
+  };
+}
+function installXhrInstrumentation(config6) {
+  const open = XMLHttpRequest.prototype.open;
+  const send = XMLHttpRequest.prototype.send;
+  XMLHttpRequest.prototype.open = function(method, url, ...rest) {
+    safeRun(() => {
+      this.__kmind = { method, url: String(url) };
+    }, config6.debugTrace);
+    return open.apply(this, [method, url, ...rest]);
+  };
+  XMLHttpRequest.prototype.send = function(...args) {
+    const meta = this.__kmind;
+    if (!meta) return send.apply(this, args);
+    let span;
+    safeRun(() => {
+      span = startSpan("HTTP " + meta.method, { "http.request.method": meta.method, "url.full": meta.url });
+      if (shouldPropagate(meta.url, config6)) this.setRequestHeader("traceparent", traceparent(span));
+      this.addEventListener("loadend", () => safeRun(() => endSpan(span, this.status >= 400), config6.debugTrace), { once: true });
+    }, config6.debugTrace);
+    return send.apply(this, args);
+  };
+}
+
+// src/vitals.ts
+import { onCLS, onFCP, onINP, onLCP, onTTFB } from "web-vitals";
+function installWebVitals(config6) {
+  const report = (metric) => enqueue("metrics", metricPayload(config6.serviceName, `web.vital.${metric.name.toLowerCase()}`, metric.value, {}));
+  safeRun(() => {
+    onCLS(report);
+    onFCP(report);
+    onINP(report);
+    onLCP(report);
+    onTTFB(report);
+  }, config6.debugTrace);
+}
+
+// src/consoleCapture.ts
+function message(args) {
+  return args.map((value) => {
+    if (value instanceof Error) return value.stack || value.message;
+    if (typeof value === "string") return value;
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  }).join(" ");
+}
+function installConsoleCapture(config6) {
+  ["warn", "error"].forEach((level) => {
+    const original = console[level].bind(console);
+    console[level] = (...args) => {
+      original(...args);
+      safeRun(() => logger[level](message(args), { "log.source": "console" }), config6.debugTrace);
+    };
+  });
+}
+
+// src/index.ts
+var initialized = false;
+var config5;
+function init(input) {
+  safeRun(() => {
+    if (initialized || typeof window === "undefined") return;
+    config5 = resolveConfig(input);
+    if (!config5.enabled) return;
+    initialized = true;
+    configurePrivacy(config5);
+    configureTransport(config5);
+    configureTracing(config5);
+    configureLogger(config5);
+    installPageFlush();
+    installPageTracing();
+    installFetchInstrumentation(config5);
+    installXhrInstrumentation(config5);
+    installWebVitals(config5);
+    installErrorCapture(config5);
+    if (config5.captureConsole) installConsoleCapture(config5);
+    void heartbeat(config5);
+  }, input.debugTrace);
+}
+function recordMetric(name, value, attributes2 = {}) {
+  safeRun(() => {
+    if (config5 && Number.isFinite(value)) enqueue("metrics", metricPayload(config5.serviceName, name, value, attributes2));
+  }, config5?.debugTrace);
+}
+export {
+  getActiveTraceId,
+  init,
+  logger,
+  recordMetric
+};

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "kmind-apm-web",
+  "version": "0.1.0",
+  "description": "Framework-agnostic browser observability SDK for Kmind.",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js", "require": "./dist/index.cjs" } },
+  "files": ["dist"],
+  "scripts": { "build": "tsup && node scripts/check-size.mjs", "test": "vitest run" },
+  "dependencies": { "web-vitals": "^5.1.0" },
+  "devDependencies": { "@types/node": "^22.15.3", "tsup": "^8.5.0", "typescript": "^5.8.3", "vitest": "^3.1.3" }
+}