@oconde/radar 0.1.0 → 0.2.0

package/dist/browser/index.cjs

@@ -0,0 +1,173 @@
+"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 key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser/index.ts
+var browser_exports = {};
+__export(browser_exports, {
+  DEFAULT_CLIENT_ERRORS_ENDPOINT: () => DEFAULT_CLIENT_ERRORS_ENDPOINT,
+  handleErrorWithRadar: () => handleErrorWithRadar,
+  listenForClientErrors: () => listenForClientErrors,
+  reportClientError: () => reportClientError
+});
+module.exports = __toCommonJS(browser_exports);
+var DEFAULT_CLIENT_ERRORS_ENDPOINT = "/api/radar/client-errors";
+var MAX_REPORTS = 10;
+var MAX_MESSAGE = 2e3;
+var MAX_STACK = 12e3;
+var ACTION_WINDOW_MS = 1e4;
+var MAX_LABEL = 60;
+var MAX_TEXT_READ = 500;
+var MAX_LINK_TEXT = 40;
+var LINK_TAGS = /* @__PURE__ */ new Set(["a", "label"]);
+var LINK_ROLES = /* @__PURE__ */ new Set(["link"]);
+var INTERACTIVE = 'button, a, [role="button"], [role="link"], [role="menuitem"], [role="tab"], [role="checkbox"], [role="switch"], input, select, textarea, summary, label';
+var BUTTON_INPUTS = /* @__PURE__ */ new Set(["button", "submit", "reset", "image"]);
+var FIELDS = /* @__PURE__ */ new Set(["input", "select", "textarea"]);
+var ELEMENT_NAMES = { a: "link", button: "button", input: "input", select: "select", textarea: "textarea", summary: "summary", label: "label", form: "form" };
+var sent = { count: 0, keys: /* @__PURE__ */ new Set() };
+var lastAction = null;
+function browser() {
+  return globalThis;
+}
+function describe(error, path) {
+  if (error instanceof Error) {
+    return { name: error.name || "Error", message: String(error.message ?? "").slice(0, MAX_MESSAGE), ...error.stack ? { stack: error.stack.slice(0, MAX_STACK) } : {}, path };
+  }
+  if (typeof error === "object" && error !== null) {
+    const record = error;
+    const name = typeof record.name === "string" && record.name ? record.name : "Error";
+    const message = typeof record.message === "string" ? record.message : safeString(error);
+    return { name, message: message.slice(0, MAX_MESSAGE), ...typeof record.stack === "string" ? { stack: record.stack.slice(0, MAX_STACK) } : {}, path };
+  }
+  return { name: "Error", message: String(error).slice(0, MAX_MESSAGE), path };
+}
+function attribute(node, name) {
+  try {
+    const value = node.getAttribute?.(name);
+    return typeof value === "string" && value.trim() ? value : null;
+  } catch {
+    return null;
+  }
+}
+function cleanLabel(text) {
+  return (text ?? "").replace(/\s+/g, " ").trim().slice(0, MAX_LABEL);
+}
+function describeElement(target, kind) {
+  const node = target;
+  if (!node || typeof node !== "object" || typeof node.tagName !== "string") return null;
+  const found = kind === "click" && typeof node.closest === "function" ? node.closest(INTERACTIVE) : node;
+  const element = found ?? node;
+  const control = found !== null;
+  const tag = (element.tagName ?? "").toLowerCase();
+  const type = (attribute(element, "type") ?? "").toLowerCase();
+  const role = attribute(element, "role");
+  const name = role ?? (tag === "input" && BUTTON_INPUTS.has(type) ? "button" : ELEMENT_NAMES[tag] ?? (/^[a-z][a-z0-9-]*$/.test(tag) ? tag : "element"));
+  const named = attribute(element, "aria-label") ?? attribute(element, "title");
+  const fieldLabel = FIELDS.has(tag) && !BUTTON_INPUTS.has(type) ? attribute(element, "name") ?? attribute(element, "placeholder") ?? attribute(element, "id") : null;
+  const buttonValue = tag === "input" && BUTTON_INPUTS.has(type) ? attribute(element, "value") : null;
+  const rawText = !control || FIELDS.has(tag) || tag === "form" ? null : cleanLabel((element.textContent ?? "").slice(0, MAX_TEXT_READ));
+  const linkLike = LINK_TAGS.has(tag) || role !== null && LINK_ROLES.has(role);
+  const text = rawText && linkLike && (rawText.length > MAX_LINK_TEXT || /[\d@]/.test(rawText)) ? null : rawText;
+  const formLabel = tag === "form" ? attribute(element, "name") ?? attribute(element, "id") : null;
+  const label = cleanLabel(named ?? fieldLabel ?? buttonValue ?? formLabel ?? (cleanLabel(text) || attribute(element, "id")));
+  return { element: name.slice(0, 24), label };
+}
+function recordAction(kind) {
+  return (event) => {
+    try {
+      const described = describeElement(event?.target, kind);
+      if (described) lastAction = { kind, ...described, at: Date.now() };
+    } catch {
+      return;
+    }
+  };
+}
+function recentAction() {
+  if (!lastAction) return void 0;
+  const msBefore = Date.now() - lastAction.at;
+  if (msBefore < 0 || msBefore > ACTION_WINDOW_MS) return void 0;
+  return { kind: lastAction.kind, element: lastAction.element, label: lastAction.label, msBefore };
+}
+function safeString(value) {
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function send(endpoint, body) {
+  const globals = browser();
+  if (typeof globals.fetch === "function") {
+    globals.fetch(endpoint, { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true, credentials: "same-origin" }).catch(() => void 0);
+    return;
+  }
+  if (typeof globals.navigator?.sendBeacon === "function") globals.navigator.sendBeacon(endpoint, new Blob([body], { type: "application/json" }));
+}
+function reportClientError(error, options = {}) {
+  try {
+    const globals = browser();
+    if (!globals.window || !globals.location) return;
+    if (sent.count >= MAX_REPORTS) return;
+    const action = recentAction();
+    const payload = { ...describe(error, `${globals.location.pathname}${globals.location.search}`), ...action ? { action } : {} };
+    const key = `${payload.name}|${payload.message}|${(payload.stack ?? "").slice(0, 300)}`;
+    if (sent.keys.has(key)) return;
+    sent.keys.add(key);
+    sent.count += 1;
+    send(options.endpoint ?? DEFAULT_CLIENT_ERRORS_ENDPOINT, JSON.stringify(payload));
+  } catch {
+    return;
+  }
+}
+function handleErrorWithRadar(handler, options = {}) {
+  return (input) => {
+    const unexpected = (input.status ?? 500) >= 500;
+    if (unexpected) reportClientError(input.error, options);
+    if (handler) return handler(input);
+    if (unexpected) console.error(input.error);
+    return void 0;
+  };
+}
+function listenForClientErrors(options = {}) {
+  const target = browser().window;
+  if (!target) return () => void 0;
+  const onClick = recordAction("click");
+  const onSubmit = recordAction("submit");
+  const captureActions = options.captureActions !== false;
+  const onError = (event) => {
+    const record = event ?? {};
+    reportClientError(record.error ?? record.message, options);
+  };
+  const onRejection = (event) => reportClientError((event ?? {}).reason, options);
+  target.addEventListener("error", onError);
+  target.addEventListener("unhandledrejection", onRejection);
+  if (captureActions) {
+    target.addEventListener("click", onClick, true);
+    target.addEventListener("submit", onSubmit, true);
+  }
+  return () => {
+    target.removeEventListener("error", onError);
+    target.removeEventListener("unhandledrejection", onRejection);
+    if (captureActions) {
+      target.removeEventListener("click", onClick, true);
+      target.removeEventListener("submit", onSubmit, true);
+    }
+  };
+}
+//# sourceMappingURL=index.cjs.map

package/dist/browser/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/browser/index.ts"],"sourcesContent":["export type ReportOptions = { endpoint?: string };\nexport type ListenOptions = ReportOptions & { captureActions?: boolean };\n\nexport type UiAction = { kind: 'click' | 'submit'; element: string; label: string; msBefore: number };\nexport type ClientErrorPayload = { name: string; message: string; stack?: string; path: string; action?: UiAction };\n\nexport const DEFAULT_CLIENT_ERRORS_ENDPOINT = '/api/radar/client-errors';\n\ntype Listener = (event: unknown) => void;\n\ntype ElementLike = { tagName?: string; textContent?: string | null; closest?(selector: string): ElementLike | null; getAttribute?(name: string): string | null };\n\ntype BrowserGlobals = {\n  window?: { addEventListener(type: string, listener: Listener, capture?: boolean): void; removeEventListener(type: string, listener: Listener, capture?: boolean): void };\n  location?: { pathname: string; search: string };\n  navigator?: { sendBeacon?: (url: string, data: Blob) => boolean };\n  fetch?: (input: string, init: RequestInit) => Promise<unknown>;\n};\n\ntype ErrorHandlerInput = { error: unknown; status?: number; message: string };\n\nconst MAX_REPORTS = 10;\nconst MAX_MESSAGE = 2000;\nconst MAX_STACK = 12_000;\nconst ACTION_WINDOW_MS = 10_000;\nconst MAX_LABEL = 60;\nconst MAX_TEXT_READ = 500;\nconst MAX_LINK_TEXT = 40;\nconst LINK_TAGS = new Set(['a', 'label']);\nconst LINK_ROLES = new Set(['link']);\nconst INTERACTIVE = 'button, a, [role=\"button\"], [role=\"link\"], [role=\"menuitem\"], [role=\"tab\"], [role=\"checkbox\"], [role=\"switch\"], input, select, textarea, summary, label';\nconst BUTTON_INPUTS = new Set(['button', 'submit', 'reset', 'image']);\nconst FIELDS = new Set(['input', 'select', 'textarea']);\nconst ELEMENT_NAMES: Record<string, string> = { a: 'link', button: 'button', input: 'input', select: 'select', textarea: 'textarea', summary: 'summary', label: 'label', form: 'form' };\n\nconst sent = { count: 0, keys: new Set<string>() };\nlet lastAction: { kind: UiAction['kind']; element: string; label: string; at: number } | null = null;\n\nfunction browser(): BrowserGlobals {\n  return globalThis as unknown as BrowserGlobals;\n}\n\nfunction describe(error: unknown, path: string): ClientErrorPayload {\n  if (error instanceof Error) {\n    return { name: error.name || 'Error', message: String(error.message ?? '').slice(0, MAX_MESSAGE), ...(error.stack ? { stack: error.stack.slice(0, MAX_STACK) } : {}), path };\n  }\n  if (typeof error === 'object' && error !== null) {\n    const record = error as Record<string, unknown>;\n    const name = typeof record.name === 'string' && record.name ? record.name : 'Error';\n    const message = typeof record.message === 'string' ? record.message : safeString(error);\n    return { name, message: message.slice(0, MAX_MESSAGE), ...(typeof record.stack === 'string' ? { stack: record.stack.slice(0, MAX_STACK) } : {}), path };\n  }\n  return { name: 'Error', message: String(error).slice(0, MAX_MESSAGE), path };\n}\n\nfunction attribute(node: ElementLike, name: string): string | null {\n  try {\n    const value = node.getAttribute?.(name);\n    return typeof value === 'string' && value.trim() ? value : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction cleanLabel(text: string | null | undefined): string {\n  return (text ?? '').replace(/\\s+/g, ' ').trim().slice(0, MAX_LABEL);\n}\n\nfunction describeElement(target: unknown, kind: UiAction['kind']): { element: string; label: string } | null {\n  const node = target as ElementLike | null;\n  if (!node || typeof node !== 'object' || typeof node.tagName !== 'string') return null;\n  const found = kind === 'click' && typeof node.closest === 'function' ? node.closest(INTERACTIVE) : node;\n  const element = found ?? node;\n  const control = found !== null;\n  const tag = (element.tagName ?? '').toLowerCase();\n  const type = (attribute(element, 'type') ?? '').toLowerCase();\n  const role = attribute(element, 'role');\n  const name = role ?? (tag === 'input' && BUTTON_INPUTS.has(type) ? 'button' : (ELEMENT_NAMES[tag] ?? (/^[a-z][a-z0-9-]*$/.test(tag) ? tag : 'element')));\n  const named = attribute(element, 'aria-label') ?? attribute(element, 'title');\n  const fieldLabel = FIELDS.has(tag) && !BUTTON_INPUTS.has(type) ? (attribute(element, 'name') ?? attribute(element, 'placeholder') ?? attribute(element, 'id')) : null;\n  const buttonValue = tag === 'input' && BUTTON_INPUTS.has(type) ? attribute(element, 'value') : null;\n  const rawText = !control || FIELDS.has(tag) || tag === 'form' ? null : cleanLabel((element.textContent ?? '').slice(0, MAX_TEXT_READ));\n  const linkLike = LINK_TAGS.has(tag) || (role !== null && LINK_ROLES.has(role));\n  const text = rawText && linkLike && (rawText.length > MAX_LINK_TEXT || /[\\d@]/.test(rawText)) ? null : rawText;\n  const formLabel = tag === 'form' ? (attribute(element, 'name') ?? attribute(element, 'id')) : null;\n  const label = cleanLabel(named ?? fieldLabel ?? buttonValue ?? formLabel ?? (cleanLabel(text) || attribute(element, 'id')));\n  return { element: name.slice(0, 24), label };\n}\n\nfunction recordAction(kind: UiAction['kind']): Listener {\n  return (event) => {\n    try {\n      const described = describeElement((event as { target?: unknown } | null)?.target, kind);\n      if (described) lastAction = { kind, ...described, at: Date.now() };\n    } catch {\n      return;\n    }\n  };\n}\n\nfunction recentAction(): UiAction | undefined {\n  if (!lastAction) return undefined;\n  const msBefore = Date.now() - lastAction.at;\n  if (msBefore < 0 || msBefore > ACTION_WINDOW_MS) return undefined;\n  return { kind: lastAction.kind, element: lastAction.element, label: lastAction.label, msBefore };\n}\n\nfunction safeString(value: unknown): string {\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction send(endpoint: string, body: string): void {\n  const globals = browser();\n  if (typeof globals.fetch === 'function') {\n    globals.fetch(endpoint, { method: 'POST', headers: { 'content-type': 'application/json' }, body, keepalive: true, credentials: 'same-origin' }).catch(() => undefined);\n    return;\n  }\n  if (typeof globals.navigator?.sendBeacon === 'function') globals.navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }));\n}\n\nexport function reportClientError(error: unknown, options: ReportOptions = {}): void {\n  try {\n    const globals = browser();\n    if (!globals.window || !globals.location) return;\n    if (sent.count >= MAX_REPORTS) return;\n    const action = recentAction();\n    const payload = { ...describe(error, `${globals.location.pathname}${globals.location.search}`), ...(action ? { action } : {}) };\n    const key = `${payload.name}|${payload.message}|${(payload.stack ?? '').slice(0, 300)}`;\n    if (sent.keys.has(key)) return;\n    sent.keys.add(key);\n    sent.count += 1;\n    send(options.endpoint ?? DEFAULT_CLIENT_ERRORS_ENDPOINT, JSON.stringify(payload));\n  } catch {\n    return;\n  }\n}\n\nexport function handleErrorWithRadar<Input extends ErrorHandlerInput, Output>(handler?: (input: Input) => Output, options: ReportOptions = {}): (input: Input) => Output | undefined {\n  return (input) => {\n    const unexpected = (input.status ?? 500) >= 500;\n    if (unexpected) reportClientError(input.error, options);\n    if (handler) return handler(input);\n    if (unexpected) console.error(input.error);\n    return undefined;\n  };\n}\n\nexport function listenForClientErrors(options: ListenOptions = {}): () => void {\n  const target = browser().window;\n  if (!target) return () => undefined;\n  const onClick = recordAction('click');\n  const onSubmit = recordAction('submit');\n  const captureActions = options.captureActions !== false;\n  const onError: Listener = (event) => {\n    const record = (event ?? {}) as { error?: unknown; message?: unknown };\n    reportClientError(record.error ?? record.message, options);\n  };\n  const onRejection: Listener = (event) => reportClientError(((event ?? {}) as { reason?: unknown }).reason, options);\n  target.addEventListener('error', onError);\n  target.addEventListener('unhandledrejection', onRejection);\n  if (captureActions) {\n    target.addEventListener('click', onClick, true);\n    target.addEventListener('submit', onSubmit, true);\n  }\n  return () => {\n    target.removeEventListener('error', onError);\n    target.removeEventListener('unhandledrejection', onRejection);\n    if (captureActions) {\n      target.removeEventListener('click', onClick, true);\n      target.removeEventListener('submit', onSubmit, true);\n    }\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/browser/index.d.cts

@@ -0,0 +1,30 @@
+type ReportOptions = {
+    endpoint?: string;
+};
+type ListenOptions = ReportOptions & {
+    captureActions?: boolean;
+};
+type UiAction = {
+    kind: 'click' | 'submit';
+    element: string;
+    label: string;
+    msBefore: number;
+};
+type ClientErrorPayload = {
+    name: string;
+    message: string;
+    stack?: string;
+    path: string;
+    action?: UiAction;
+};
+declare const DEFAULT_CLIENT_ERRORS_ENDPOINT = "/api/radar/client-errors";
+type ErrorHandlerInput = {
+    error: unknown;
+    status?: number;
+    message: string;
+};
+declare function reportClientError(error: unknown, options?: ReportOptions): void;
+declare function handleErrorWithRadar<Input extends ErrorHandlerInput, Output>(handler?: (input: Input) => Output, options?: ReportOptions): (input: Input) => Output | undefined;
+declare function listenForClientErrors(options?: ListenOptions): () => void;
+
+export { type ClientErrorPayload, DEFAULT_CLIENT_ERRORS_ENDPOINT, type ListenOptions, type ReportOptions, type UiAction, handleErrorWithRadar, listenForClientErrors, reportClientError };

package/dist/browser/index.d.ts

@@ -0,0 +1,30 @@
+type ReportOptions = {
+    endpoint?: string;
+};
+type ListenOptions = ReportOptions & {
+    captureActions?: boolean;
+};
+type UiAction = {
+    kind: 'click' | 'submit';
+    element: string;
+    label: string;
+    msBefore: number;
+};
+type ClientErrorPayload = {
+    name: string;
+    message: string;
+    stack?: string;
+    path: string;
+    action?: UiAction;
+};
+declare const DEFAULT_CLIENT_ERRORS_ENDPOINT = "/api/radar/client-errors";
+type ErrorHandlerInput = {
+    error: unknown;
+    status?: number;
+    message: string;
+};
+declare function reportClientError(error: unknown, options?: ReportOptions): void;
+declare function handleErrorWithRadar<Input extends ErrorHandlerInput, Output>(handler?: (input: Input) => Output, options?: ReportOptions): (input: Input) => Output | undefined;
+declare function listenForClientErrors(options?: ListenOptions): () => void;
+
+export { type ClientErrorPayload, DEFAULT_CLIENT_ERRORS_ENDPOINT, type ListenOptions, type ReportOptions, type UiAction, handleErrorWithRadar, listenForClientErrors, reportClientError };

package/dist/browser/index.js

@@ -0,0 +1,152 @@
+// src/browser/index.ts
+var DEFAULT_CLIENT_ERRORS_ENDPOINT = "/api/radar/client-errors";
+var MAX_REPORTS = 10;
+var MAX_MESSAGE = 2e3;
+var MAX_STACK = 12e3;
+var ACTION_WINDOW_MS = 1e4;
+var MAX_LABEL = 60;
+var MAX_TEXT_READ = 500;
+var MAX_LINK_TEXT = 40;
+var LINK_TAGS = /* @__PURE__ */ new Set(["a", "label"]);
+var LINK_ROLES = /* @__PURE__ */ new Set(["link"]);
+var INTERACTIVE = 'button, a, [role="button"], [role="link"], [role="menuitem"], [role="tab"], [role="checkbox"], [role="switch"], input, select, textarea, summary, label';
+var BUTTON_INPUTS = /* @__PURE__ */ new Set(["button", "submit", "reset", "image"]);
+var FIELDS = /* @__PURE__ */ new Set(["input", "select", "textarea"]);
+var ELEMENT_NAMES = { a: "link", button: "button", input: "input", select: "select", textarea: "textarea", summary: "summary", label: "label", form: "form" };
+var sent = { count: 0, keys: /* @__PURE__ */ new Set() };
+var lastAction = null;
+function browser() {
+  return globalThis;
+}
+function describe(error, path) {
+  if (error instanceof Error) {
+    return { name: error.name || "Error", message: String(error.message ?? "").slice(0, MAX_MESSAGE), ...error.stack ? { stack: error.stack.slice(0, MAX_STACK) } : {}, path };
+  }
+  if (typeof error === "object" && error !== null) {
+    const record = error;
+    const name = typeof record.name === "string" && record.name ? record.name : "Error";
+    const message = typeof record.message === "string" ? record.message : safeString(error);
+    return { name, message: message.slice(0, MAX_MESSAGE), ...typeof record.stack === "string" ? { stack: record.stack.slice(0, MAX_STACK) } : {}, path };
+  }
+  return { name: "Error", message: String(error).slice(0, MAX_MESSAGE), path };
+}
+function attribute(node, name) {
+  try {
+    const value = node.getAttribute?.(name);
+    return typeof value === "string" && value.trim() ? value : null;
+  } catch {
+    return null;
+  }
+}
+function cleanLabel(text) {
+  return (text ?? "").replace(/\s+/g, " ").trim().slice(0, MAX_LABEL);
+}
+function describeElement(target, kind) {
+  const node = target;
+  if (!node || typeof node !== "object" || typeof node.tagName !== "string") return null;
+  const found = kind === "click" && typeof node.closest === "function" ? node.closest(INTERACTIVE) : node;
+  const element = found ?? node;
+  const control = found !== null;
+  const tag = (element.tagName ?? "").toLowerCase();
+  const type = (attribute(element, "type") ?? "").toLowerCase();
+  const role = attribute(element, "role");
+  const name = role ?? (tag === "input" && BUTTON_INPUTS.has(type) ? "button" : ELEMENT_NAMES[tag] ?? (/^[a-z][a-z0-9-]*$/.test(tag) ? tag : "element"));
+  const named = attribute(element, "aria-label") ?? attribute(element, "title");
+  const fieldLabel = FIELDS.has(tag) && !BUTTON_INPUTS.has(type) ? attribute(element, "name") ?? attribute(element, "placeholder") ?? attribute(element, "id") : null;
+  const buttonValue = tag === "input" && BUTTON_INPUTS.has(type) ? attribute(element, "value") : null;
+  const rawText = !control || FIELDS.has(tag) || tag === "form" ? null : cleanLabel((element.textContent ?? "").slice(0, MAX_TEXT_READ));
+  const linkLike = LINK_TAGS.has(tag) || role !== null && LINK_ROLES.has(role);
+  const text = rawText && linkLike && (rawText.length > MAX_LINK_TEXT || /[\d@]/.test(rawText)) ? null : rawText;
+  const formLabel = tag === "form" ? attribute(element, "name") ?? attribute(element, "id") : null;
+  const label = cleanLabel(named ?? fieldLabel ?? buttonValue ?? formLabel ?? (cleanLabel(text) || attribute(element, "id")));
+  return { element: name.slice(0, 24), label };
+}
+function recordAction(kind) {
+  return (event) => {
+    try {
+      const described = describeElement(event?.target, kind);
+      if (described) lastAction = { kind, ...described, at: Date.now() };
+    } catch {
+      return;
+    }
+  };
+}
+function recentAction() {
+  if (!lastAction) return void 0;
+  const msBefore = Date.now() - lastAction.at;
+  if (msBefore < 0 || msBefore > ACTION_WINDOW_MS) return void 0;
+  return { kind: lastAction.kind, element: lastAction.element, label: lastAction.label, msBefore };
+}
+function safeString(value) {
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function send(endpoint, body) {
+  const globals = browser();
+  if (typeof globals.fetch === "function") {
+    globals.fetch(endpoint, { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true, credentials: "same-origin" }).catch(() => void 0);
+    return;
+  }
+  if (typeof globals.navigator?.sendBeacon === "function") globals.navigator.sendBeacon(endpoint, new Blob([body], { type: "application/json" }));
+}
+function reportClientError(error, options = {}) {
+  try {
+    const globals = browser();
+    if (!globals.window || !globals.location) return;
+    if (sent.count >= MAX_REPORTS) return;
+    const action = recentAction();
+    const payload = { ...describe(error, `${globals.location.pathname}${globals.location.search}`), ...action ? { action } : {} };
+    const key = `${payload.name}|${payload.message}|${(payload.stack ?? "").slice(0, 300)}`;
+    if (sent.keys.has(key)) return;
+    sent.keys.add(key);
+    sent.count += 1;
+    send(options.endpoint ?? DEFAULT_CLIENT_ERRORS_ENDPOINT, JSON.stringify(payload));
+  } catch {
+    return;
+  }
+}
+function handleErrorWithRadar(handler, options = {}) {
+  return (input) => {
+    const unexpected = (input.status ?? 500) >= 500;
+    if (unexpected) reportClientError(input.error, options);
+    if (handler) return handler(input);
+    if (unexpected) console.error(input.error);
+    return void 0;
+  };
+}
+function listenForClientErrors(options = {}) {
+  const target = browser().window;
+  if (!target) return () => void 0;
+  const onClick = recordAction("click");
+  const onSubmit = recordAction("submit");
+  const captureActions = options.captureActions !== false;
+  const onError = (event) => {
+    const record = event ?? {};
+    reportClientError(record.error ?? record.message, options);
+  };
+  const onRejection = (event) => reportClientError((event ?? {}).reason, options);
+  target.addEventListener("error", onError);
+  target.addEventListener("unhandledrejection", onRejection);
+  if (captureActions) {
+    target.addEventListener("click", onClick, true);
+    target.addEventListener("submit", onSubmit, true);
+  }
+  return () => {
+    target.removeEventListener("error", onError);
+    target.removeEventListener("unhandledrejection", onRejection);
+    if (captureActions) {
+      target.removeEventListener("click", onClick, true);
+      target.removeEventListener("submit", onSubmit, true);
+    }
+  };
+}
+export {
+  DEFAULT_CLIENT_ERRORS_ENDPOINT,
+  handleErrorWithRadar,
+  listenForClientErrors,
+  reportClientError
+};
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/browser/index.ts"],"sourcesContent":["export type ReportOptions = { endpoint?: string };\nexport type ListenOptions = ReportOptions & { captureActions?: boolean };\n\nexport type UiAction = { kind: 'click' | 'submit'; element: string; label: string; msBefore: number };\nexport type ClientErrorPayload = { name: string; message: string; stack?: string; path: string; action?: UiAction };\n\nexport const DEFAULT_CLIENT_ERRORS_ENDPOINT = '/api/radar/client-errors';\n\ntype Listener = (event: unknown) => void;\n\ntype ElementLike = { tagName?: string; textContent?: string | null; closest?(selector: string): ElementLike | null; getAttribute?(name: string): string | null };\n\ntype BrowserGlobals = {\n  window?: { addEventListener(type: string, listener: Listener, capture?: boolean): void; removeEventListener(type: string, listener: Listener, capture?: boolean): void };\n  location?: { pathname: string; search: string };\n  navigator?: { sendBeacon?: (url: string, data: Blob) => boolean };\n  fetch?: (input: string, init: RequestInit) => Promise<unknown>;\n};\n\ntype ErrorHandlerInput = { error: unknown; status?: number; message: string };\n\nconst MAX_REPORTS = 10;\nconst MAX_MESSAGE = 2000;\nconst MAX_STACK = 12_000;\nconst ACTION_WINDOW_MS = 10_000;\nconst MAX_LABEL = 60;\nconst MAX_TEXT_READ = 500;\nconst MAX_LINK_TEXT = 40;\nconst LINK_TAGS = new Set(['a', 'label']);\nconst LINK_ROLES = new Set(['link']);\nconst INTERACTIVE = 'button, a, [role=\"button\"], [role=\"link\"], [role=\"menuitem\"], [role=\"tab\"], [role=\"checkbox\"], [role=\"switch\"], input, select, textarea, summary, label';\nconst BUTTON_INPUTS = new Set(['button', 'submit', 'reset', 'image']);\nconst FIELDS = new Set(['input', 'select', 'textarea']);\nconst ELEMENT_NAMES: Record<string, string> = { a: 'link', button: 'button', input: 'input', select: 'select', textarea: 'textarea', summary: 'summary', label: 'label', form: 'form' };\n\nconst sent = { count: 0, keys: new Set<string>() };\nlet lastAction: { kind: UiAction['kind']; element: string; label: string; at: number } | null = null;\n\nfunction browser(): BrowserGlobals {\n  return globalThis as unknown as BrowserGlobals;\n}\n\nfunction describe(error: unknown, path: string): ClientErrorPayload {\n  if (error instanceof Error) {\n    return { name: error.name || 'Error', message: String(error.message ?? '').slice(0, MAX_MESSAGE), ...(error.stack ? { stack: error.stack.slice(0, MAX_STACK) } : {}), path };\n  }\n  if (typeof error === 'object' && error !== null) {\n    const record = error as Record<string, unknown>;\n    const name = typeof record.name === 'string' && record.name ? record.name : 'Error';\n    const message = typeof record.message === 'string' ? record.message : safeString(error);\n    return { name, message: message.slice(0, MAX_MESSAGE), ...(typeof record.stack === 'string' ? { stack: record.stack.slice(0, MAX_STACK) } : {}), path };\n  }\n  return { name: 'Error', message: String(error).slice(0, MAX_MESSAGE), path };\n}\n\nfunction attribute(node: ElementLike, name: string): string | null {\n  try {\n    const value = node.getAttribute?.(name);\n    return typeof value === 'string' && value.trim() ? value : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction cleanLabel(text: string | null | undefined): string {\n  return (text ?? '').replace(/\\s+/g, ' ').trim().slice(0, MAX_LABEL);\n}\n\nfunction describeElement(target: unknown, kind: UiAction['kind']): { element: string; label: string } | null {\n  const node = target as ElementLike | null;\n  if (!node || typeof node !== 'object' || typeof node.tagName !== 'string') return null;\n  const found = kind === 'click' && typeof node.closest === 'function' ? node.closest(INTERACTIVE) : node;\n  const element = found ?? node;\n  const control = found !== null;\n  const tag = (element.tagName ?? '').toLowerCase();\n  const type = (attribute(element, 'type') ?? '').toLowerCase();\n  const role = attribute(element, 'role');\n  const name = role ?? (tag === 'input' && BUTTON_INPUTS.has(type) ? 'button' : (ELEMENT_NAMES[tag] ?? (/^[a-z][a-z0-9-]*$/.test(tag) ? tag : 'element')));\n  const named = attribute(element, 'aria-label') ?? attribute(element, 'title');\n  const fieldLabel = FIELDS.has(tag) && !BUTTON_INPUTS.has(type) ? (attribute(element, 'name') ?? attribute(element, 'placeholder') ?? attribute(element, 'id')) : null;\n  const buttonValue = tag === 'input' && BUTTON_INPUTS.has(type) ? attribute(element, 'value') : null;\n  const rawText = !control || FIELDS.has(tag) || tag === 'form' ? null : cleanLabel((element.textContent ?? '').slice(0, MAX_TEXT_READ));\n  const linkLike = LINK_TAGS.has(tag) || (role !== null && LINK_ROLES.has(role));\n  const text = rawText && linkLike && (rawText.length > MAX_LINK_TEXT || /[\\d@]/.test(rawText)) ? null : rawText;\n  const formLabel = tag === 'form' ? (attribute(element, 'name') ?? attribute(element, 'id')) : null;\n  const label = cleanLabel(named ?? fieldLabel ?? buttonValue ?? formLabel ?? (cleanLabel(text) || attribute(element, 'id')));\n  return { element: name.slice(0, 24), label };\n}\n\nfunction recordAction(kind: UiAction['kind']): Listener {\n  return (event) => {\n    try {\n      const described = describeElement((event as { target?: unknown } | null)?.target, kind);\n      if (described) lastAction = { kind, ...described, at: Date.now() };\n    } catch {\n      return;\n    }\n  };\n}\n\nfunction recentAction(): UiAction | undefined {\n  if (!lastAction) return undefined;\n  const msBefore = Date.now() - lastAction.at;\n  if (msBefore < 0 || msBefore > ACTION_WINDOW_MS) return undefined;\n  return { kind: lastAction.kind, element: lastAction.element, label: lastAction.label, msBefore };\n}\n\nfunction safeString(value: unknown): string {\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction send(endpoint: string, body: string): void {\n  const globals = browser();\n  if (typeof globals.fetch === 'function') {\n    globals.fetch(endpoint, { method: 'POST', headers: { 'content-type': 'application/json' }, body, keepalive: true, credentials: 'same-origin' }).catch(() => undefined);\n    return;\n  }\n  if (typeof globals.navigator?.sendBeacon === 'function') globals.navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }));\n}\n\nexport function reportClientError(error: unknown, options: ReportOptions = {}): void {\n  try {\n    const globals = browser();\n    if (!globals.window || !globals.location) return;\n    if (sent.count >= MAX_REPORTS) return;\n    const action = recentAction();\n    const payload = { ...describe(error, `${globals.location.pathname}${globals.location.search}`), ...(action ? { action } : {}) };\n    const key = `${payload.name}|${payload.message}|${(payload.stack ?? '').slice(0, 300)}`;\n    if (sent.keys.has(key)) return;\n    sent.keys.add(key);\n    sent.count += 1;\n    send(options.endpoint ?? DEFAULT_CLIENT_ERRORS_ENDPOINT, JSON.stringify(payload));\n  } catch {\n    return;\n  }\n}\n\nexport function handleErrorWithRadar<Input extends ErrorHandlerInput, Output>(handler?: (input: Input) => Output, options: ReportOptions = {}): (input: Input) => Output | undefined {\n  return (input) => {\n    const unexpected = (input.status ?? 500) >= 500;\n    if (unexpected) reportClientError(input.error, options);\n    if (handler) return handler(input);\n    if (unexpected) console.error(input.error);\n    return undefined;\n  };\n}\n\nexport function listenForClientErrors(options: ListenOptions = {}): () => void {\n  const target = browser().window;\n  if (!target) return () => undefined;\n  const onClick = recordAction('click');\n  const onSubmit = recordAction('submit');\n  const captureActions = options.captureActions !== false;\n  const onError: Listener = (event) => {\n    const record = (event ?? {}) as { error?: unknown; message?: unknown };\n    reportClientError(record.error ?? record.message, options);\n  };\n  const onRejection: Listener = (event) => reportClientError(((event ?? {}) as { reason?: unknown }).reason, options);\n  target.addEventListener('error', onError);\n  target.addEventListener('unhandledrejection', onRejection);\n  if (captureActions) {\n    target.addEventListener('click', onClick, true);\n    target.addEventListener('submit', onSubmit, true);\n  }\n  return () => {\n    target.removeEventListener('error', onError);\n    target.removeEventListener('unhandledrejection', onRejection);\n    if (captureActions) {\n      target.removeEventListener('click', onClick, true);\n      target.removeEventListener('submit', onSubmit, true);\n    }\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{client-ZpQHpeAu.d.ts → client-CZHtsQAd.d.cts}

@@ -1,10 +1,11 @@
-import { UserInfo, LogLevel } from './protocol/index.js';
+import { UserInfo, LogLevel, RequestInfo, RuntimeInfo, CheckInStatus, ExceptionInfo } from './protocol/index.cjs';
 
 type HeaderValue = string | string[] | number | undefined;
 type RequestLike = {
     method?: string;
     url?: string;
     originalUrl?: string;
+    baseUrl?: string;
     route?: {
         path?: unknown;
     };
@@ -65,11 +66,29 @@ type ResolvedOptions = {
     debug: boolean;
 };
 
+type MapLocator = (file: string) => string | null;
+type EnrichOptions = {
+    mapLocator?: MapLocator;
+    inferFunctionNames?: boolean;
+};
+
 type Attributes = Record<string, unknown>;
 type LogRequestOptions = {
     level?: LogLevel;
     redact?: RedactMode;
 };
+type CheckInOptions = {
+    checkInId?: string;
+    durationMs?: number;
+};
+type CaptureExceptionOptions = {
+    handled?: boolean;
+    level?: 'error' | 'fatal';
+    request?: RequestInfo | null;
+    attrs?: Attributes;
+    runtime?: RuntimeInfo | null;
+    enrich?: EnrichOptions;
+};
 declare class RadarClient {
     private options;
     private transport;
@@ -88,17 +107,24 @@ declare class RadarClient {
     captureUnhandled(error: unknown, level: 'error' | 'fatal'): void;
     setUser(user: UserInfo): void;
     track<T>(name: string, fn: () => T | Promise<T>, data?: Attributes): Promise<T>;
+    withContext<T>(fn: () => T, options?: {
+        requestId?: string;
+    }): T;
+    checkIn(slug: string, status: CheckInStatus, options?: CheckInOptions): Promise<void>;
+    cron<T>(slug: string, fn: () => T | Promise<T>): Promise<T>;
     middleware(): RadarMiddleware;
     shouldLogRequest(req: RequestLike): boolean;
     logHttpRequest(context: RadarContext, status: number): void;
     flush(timeoutMs?: number): Promise<void>;
     close(timeoutMs?: number): Promise<void>;
     private emitLog;
+    captureException(exception: ExceptionInfo, options?: CaptureExceptionOptions): void;
     private emitError;
+    private emitException;
     private print;
     private safely;
     private debugWarn;
     private writeWarning;
 }
 
-export { type Attributes as A, type LogRequestOptions as L, RadarClient as R, type RadarMiddleware as a, type RadarOptions as b, type RedactMode as c, type RequestLike as d, type ResponseLike as e };
+export { type Attributes as A, type CaptureExceptionOptions as C, type EnrichOptions as E, type LogRequestOptions as L, type MapLocator as M, RadarClient as R, type CheckInOptions as a, type RadarMiddleware as b, type RadarOptions as c, type RedactMode as d, type RequestLike as e, type ResponseLike as f };

package/dist/{client-DbNex6tj.d.cts → client-DbBsXgpj.d.ts}

@@ -1,10 +1,11 @@
-import { UserInfo, LogLevel } from './protocol/index.cjs';
+import { UserInfo, LogLevel, RequestInfo, RuntimeInfo, CheckInStatus, ExceptionInfo } from './protocol/index.js';
 
 type HeaderValue = string | string[] | number | undefined;
 type RequestLike = {
     method?: string;
     url?: string;
     originalUrl?: string;
+    baseUrl?: string;
     route?: {
         path?: unknown;
     };
@@ -65,11 +66,29 @@ type ResolvedOptions = {
     debug: boolean;
 };
 
+type MapLocator = (file: string) => string | null;
+type EnrichOptions = {
+    mapLocator?: MapLocator;
+    inferFunctionNames?: boolean;
+};
+
 type Attributes = Record<string, unknown>;
 type LogRequestOptions = {
     level?: LogLevel;
     redact?: RedactMode;
 };
+type CheckInOptions = {
+    checkInId?: string;
+    durationMs?: number;
+};
+type CaptureExceptionOptions = {
+    handled?: boolean;
+    level?: 'error' | 'fatal';
+    request?: RequestInfo | null;
+    attrs?: Attributes;
+    runtime?: RuntimeInfo | null;
+    enrich?: EnrichOptions;
+};
 declare class RadarClient {
     private options;
     private transport;
@@ -88,17 +107,24 @@ declare class RadarClient {
     captureUnhandled(error: unknown, level: 'error' | 'fatal'): void;
     setUser(user: UserInfo): void;
     track<T>(name: string, fn: () => T | Promise<T>, data?: Attributes): Promise<T>;
+    withContext<T>(fn: () => T, options?: {
+        requestId?: string;
+    }): T;
+    checkIn(slug: string, status: CheckInStatus, options?: CheckInOptions): Promise<void>;
+    cron<T>(slug: string, fn: () => T | Promise<T>): Promise<T>;
     middleware(): RadarMiddleware;
     shouldLogRequest(req: RequestLike): boolean;
     logHttpRequest(context: RadarContext, status: number): void;
     flush(timeoutMs?: number): Promise<void>;
     close(timeoutMs?: number): Promise<void>;
     private emitLog;
+    captureException(exception: ExceptionInfo, options?: CaptureExceptionOptions): void;
     private emitError;
+    private emitException;
     private print;
     private safely;
     private debugWarn;
     private writeWarning;
 }
 
-export { type Attributes as A, type LogRequestOptions as L, RadarClient as R, type RadarMiddleware as a, type RadarOptions as b, type RedactMode as c, type RequestLike as d, type ResponseLike as e };
+export { type Attributes as A, type CaptureExceptionOptions as C, type EnrichOptions as E, type LogRequestOptions as L, type MapLocator as M, RadarClient as R, type CheckInOptions as a, type RadarMiddleware as b, type RadarOptions as c, type RedactMode as d, type RequestLike as e, type ResponseLike as f };