@loggerjs/browser 0.5.0 → 0.5.1

package/dist/reporting-integration.cjs

@@ -0,0 +1,110 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loggerjs_core = require("@loggerjs/core");
+//#region src/reporting-integration.ts
+const defaultReportTypes = [
+	"csp-violation",
+	"deprecation",
+	"intervention",
+	"crash"
+];
+function levelFor(level, report) {
+	if (typeof level === "function") return level(report);
+	if (level) return level;
+	return report.type === "deprecation" ? "info" : "warn";
+}
+function maybeSanitize(url, sanitizeUrl) {
+	return url && sanitizeUrl ? sanitizeUrl(url) : url;
+}
+function normalizeReport(report, sanitizeUrl) {
+	const raw = typeof report.toJSON === "function" ? report.toJSON() : report;
+	const record = raw && typeof raw === "object" ? raw : {};
+	const body = "body" in record ? record.body : report.body;
+	const url = typeof record.url === "string" ? record.url : report.url;
+	return {
+		type: typeof record.type === "string" ? record.type : report.type ?? "unknown",
+		url: maybeSanitize(url, sanitizeUrl),
+		body: (0, _loggerjs_core.normalizeValue)(body, {
+			maxDepth: 6,
+			maxObjectKeys: 80
+		})
+	};
+}
+function normalizeCspViolation(event, sanitizeUrl) {
+	return {
+		type: "securitypolicyviolation",
+		blockedURI: maybeSanitize(event.blockedURI, sanitizeUrl),
+		documentURI: maybeSanitize(event.documentURI, sanitizeUrl),
+		effectiveDirective: event.effectiveDirective,
+		violatedDirective: event.violatedDirective,
+		disposition: event.disposition,
+		sourceFile: maybeSanitize(event.sourceFile, sanitizeUrl),
+		lineNumber: event.lineNumber,
+		columnNumber: event.columnNumber,
+		statusCode: event.statusCode,
+		sample: event.sample
+	};
+}
+function captureReportingIntegration(options = {}) {
+	const captureSecurityPolicyViolation = options.captureSecurityPolicyViolation ?? true;
+	const captureReportingObserver = options.captureReportingObserver ?? true;
+	const reportTypes = options.reportTypes ?? defaultReportTypes;
+	const buffered = options.buffered ?? true;
+	return {
+		name: "capture-reporting",
+		setup(api) {
+			const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);
+			const remove = options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);
+			const Observer = options.ReportingObserver ?? globalThis.ReportingObserver;
+			const disposers = [];
+			let disposed = false;
+			const captureReport = api.guard((report) => {
+				if (disposed) return;
+				api.capture({
+					level: levelFor(options.level, report),
+					message: `Browser report ${report.type}`,
+					props: { browser: {
+						kind: "report",
+						report
+					} }
+				});
+			});
+			if (captureSecurityPolicyViolation && add && remove) {
+				const onViolation = api.guard((event) => {
+					const report = normalizeCspViolation(event, options.sanitizeUrl);
+					api.capture({
+						level: levelFor(options.level, report),
+						message: `Security policy violation: ${report.effectiveDirective ?? report.violatedDirective ?? "unknown"}`,
+						props: { browser: {
+							kind: "securitypolicyviolation",
+							report
+						} }
+					});
+				});
+				add("securitypolicyviolation", onViolation);
+				disposers.push(() => remove("securitypolicyviolation", onViolation));
+			}
+			if (captureReportingObserver && Observer) try {
+				const observer = new Observer((reports) => {
+					for (const report of reports) captureReport(normalizeReport(report, options.sanitizeUrl));
+				}, {
+					buffered,
+					types: reportTypes
+				});
+				observer.observe();
+				disposers.push(() => {
+					for (const report of observer.takeRecords?.() ?? []) captureReport(normalizeReport(report, options.sanitizeUrl));
+					observer.disconnect();
+				});
+			} catch {}
+			return () => {
+				if (disposed) return;
+				for (const dispose of disposers) dispose();
+				disposed = true;
+			};
+		}
+	};
+}
+//#endregion
+exports.captureReportingIntegration = captureReportingIntegration;
+
+//# sourceMappingURL=reporting-integration.cjs.map

package/dist/reporting-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-integration.cjs","names":[],"sources":["../src/reporting-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface BrowserReportLike {\n  type?: string;\n  url?: string;\n  body?: unknown;\n  toJSON?: () => unknown;\n}\n\nexport interface BrowserReportingObserverLike {\n  observe: () => void;\n  disconnect: () => void;\n  takeRecords?: () => BrowserReportLike[];\n}\n\nexport interface BrowserReportingObserverConstructor {\n  new (\n    callback: (reports: BrowserReportLike[], observer: BrowserReportingObserverLike) => void,\n    options?: { buffered?: boolean; types?: readonly string[] },\n  ): BrowserReportingObserverLike;\n}\n\nexport interface BrowserReportPayload {\n  type: string;\n  url?: string;\n  body?: unknown;\n}\n\nexport interface BrowserCspViolationPayload {\n  type: \"securitypolicyviolation\";\n  blockedURI?: string;\n  documentURI?: string;\n  effectiveDirective?: string;\n  violatedDirective?: string;\n  disposition?: string;\n  sourceFile?: string;\n  lineNumber?: number;\n  columnNumber?: number;\n  statusCode?: number;\n  sample?: string;\n}\n\nexport interface CaptureReportingOptions {\n  captureSecurityPolicyViolation?: boolean;\n  captureReportingObserver?: boolean;\n  reportTypes?: readonly string[];\n  level?:\n    | LoggerLevel\n    | ((report: BrowserReportPayload | BrowserCspViolationPayload) => LoggerLevel);\n  buffered?: boolean;\n  sanitizeUrl?: (url: string) => string;\n  ReportingObserver?: BrowserReportingObserverConstructor;\n  addEventListener?: typeof globalThis.addEventListener;\n  removeEventListener?: typeof globalThis.removeEventListener;\n}\n\nconst defaultReportTypes = [\"csp-violation\", \"deprecation\", \"intervention\", \"crash\"] as const;\n\nfunction levelFor(\n  level: CaptureReportingOptions[\"level\"],\n  report: BrowserReportPayload | BrowserCspViolationPayload,\n): LoggerLevel {\n  if (typeof level === \"function\") return level(report);\n  if (level) return level;\n  return report.type === \"deprecation\" ? \"info\" : \"warn\";\n}\n\nfunction maybeSanitize(\n  url: string | undefined,\n  sanitizeUrl: ((url: string) => string) | undefined,\n) {\n  return url && sanitizeUrl ? sanitizeUrl(url) : url;\n}\n\nfunction normalizeReport(\n  report: BrowserReportLike,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): BrowserReportPayload {\n  const raw = typeof report.toJSON === \"function\" ? report.toJSON() : report;\n  const record = raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n  const body = \"body\" in record ? record.body : report.body;\n  const url = typeof record.url === \"string\" ? record.url : report.url;\n  const type = typeof record.type === \"string\" ? record.type : (report.type ?? \"unknown\");\n  return {\n    type,\n    url: maybeSanitize(url, sanitizeUrl),\n    body: normalizeValue(body, { maxDepth: 6, maxObjectKeys: 80 }),\n  };\n}\n\nfunction normalizeCspViolation(\n  event: SecurityPolicyViolationEvent,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): BrowserCspViolationPayload {\n  return {\n    type: \"securitypolicyviolation\",\n    blockedURI: maybeSanitize(event.blockedURI, sanitizeUrl),\n    documentURI: maybeSanitize(event.documentURI, sanitizeUrl),\n    effectiveDirective: event.effectiveDirective,\n    violatedDirective: event.violatedDirective,\n    disposition: event.disposition,\n    sourceFile: maybeSanitize(event.sourceFile, sanitizeUrl),\n    lineNumber: event.lineNumber,\n    columnNumber: event.columnNumber,\n    statusCode: event.statusCode,\n    sample: event.sample,\n  };\n}\n\nexport function captureReportingIntegration(options: CaptureReportingOptions = {}): Integration {\n  const captureSecurityPolicyViolation = options.captureSecurityPolicyViolation ?? true;\n  const captureReportingObserver = options.captureReportingObserver ?? true;\n  const reportTypes = options.reportTypes ?? defaultReportTypes;\n  const buffered = options.buffered ?? true;\n\n  return {\n    name: \"capture-reporting\",\n    setup(api: IntegrationSetupContext) {\n      const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);\n      const remove =\n        options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);\n      const Observer =\n        options.ReportingObserver ??\n        (globalThis as unknown as { ReportingObserver?: BrowserReportingObserverConstructor })\n          .ReportingObserver;\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const captureReport = api.guard((report: BrowserReportPayload) => {\n        if (disposed) return;\n        api.capture({\n          level: levelFor(options.level, report),\n          message: `Browser report ${report.type}`,\n          props: { browser: { kind: \"report\", report } },\n        });\n      });\n\n      if (captureSecurityPolicyViolation && add && remove) {\n        const onViolation = api.guard((event: SecurityPolicyViolationEvent) => {\n          const report = normalizeCspViolation(event, options.sanitizeUrl);\n          api.capture({\n            level: levelFor(options.level, report),\n            message: `Security policy violation: ${report.effectiveDirective ?? report.violatedDirective ?? \"unknown\"}`,\n            props: { browser: { kind: \"securitypolicyviolation\", report } },\n          });\n        });\n        add(\"securitypolicyviolation\", onViolation);\n        disposers.push(() => remove(\"securitypolicyviolation\", onViolation));\n      }\n\n      if (captureReportingObserver && Observer) {\n        try {\n          const observer = new Observer(\n            (reports) => {\n              for (const report of reports)\n                captureReport(normalizeReport(report, options.sanitizeUrl));\n            },\n            { buffered, types: reportTypes },\n          );\n          observer.observe();\n          disposers.push(() => {\n            for (const report of observer.takeRecords?.() ?? [])\n              captureReport(normalizeReport(report, options.sanitizeUrl));\n            observer.disconnect();\n          });\n        } catch {\n          // ReportingObserver is still uneven across browsers; failures should not break setup.\n        }\n      }\n\n      return () => {\n        if (disposed) return;\n        for (const dispose of disposers) dispose();\n        disposed = true;\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/reporting-integration.js

@@ -0,0 +1,109 @@
+import { normalizeValue } from "@loggerjs/core";
+//#region src/reporting-integration.ts
+const defaultReportTypes = [
+	"csp-violation",
+	"deprecation",
+	"intervention",
+	"crash"
+];
+function levelFor(level, report) {
+	if (typeof level === "function") return level(report);
+	if (level) return level;
+	return report.type === "deprecation" ? "info" : "warn";
+}
+function maybeSanitize(url, sanitizeUrl) {
+	return url && sanitizeUrl ? sanitizeUrl(url) : url;
+}
+function normalizeReport(report, sanitizeUrl) {
+	const raw = typeof report.toJSON === "function" ? report.toJSON() : report;
+	const record = raw && typeof raw === "object" ? raw : {};
+	const body = "body" in record ? record.body : report.body;
+	const url = typeof record.url === "string" ? record.url : report.url;
+	return {
+		type: typeof record.type === "string" ? record.type : report.type ?? "unknown",
+		url: maybeSanitize(url, sanitizeUrl),
+		body: normalizeValue(body, {
+			maxDepth: 6,
+			maxObjectKeys: 80
+		})
+	};
+}
+function normalizeCspViolation(event, sanitizeUrl) {
+	return {
+		type: "securitypolicyviolation",
+		blockedURI: maybeSanitize(event.blockedURI, sanitizeUrl),
+		documentURI: maybeSanitize(event.documentURI, sanitizeUrl),
+		effectiveDirective: event.effectiveDirective,
+		violatedDirective: event.violatedDirective,
+		disposition: event.disposition,
+		sourceFile: maybeSanitize(event.sourceFile, sanitizeUrl),
+		lineNumber: event.lineNumber,
+		columnNumber: event.columnNumber,
+		statusCode: event.statusCode,
+		sample: event.sample
+	};
+}
+function captureReportingIntegration(options = {}) {
+	const captureSecurityPolicyViolation = options.captureSecurityPolicyViolation ?? true;
+	const captureReportingObserver = options.captureReportingObserver ?? true;
+	const reportTypes = options.reportTypes ?? defaultReportTypes;
+	const buffered = options.buffered ?? true;
+	return {
+		name: "capture-reporting",
+		setup(api) {
+			const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);
+			const remove = options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);
+			const Observer = options.ReportingObserver ?? globalThis.ReportingObserver;
+			const disposers = [];
+			let disposed = false;
+			const captureReport = api.guard((report) => {
+				if (disposed) return;
+				api.capture({
+					level: levelFor(options.level, report),
+					message: `Browser report ${report.type}`,
+					props: { browser: {
+						kind: "report",
+						report
+					} }
+				});
+			});
+			if (captureSecurityPolicyViolation && add && remove) {
+				const onViolation = api.guard((event) => {
+					const report = normalizeCspViolation(event, options.sanitizeUrl);
+					api.capture({
+						level: levelFor(options.level, report),
+						message: `Security policy violation: ${report.effectiveDirective ?? report.violatedDirective ?? "unknown"}`,
+						props: { browser: {
+							kind: "securitypolicyviolation",
+							report
+						} }
+					});
+				});
+				add("securitypolicyviolation", onViolation);
+				disposers.push(() => remove("securitypolicyviolation", onViolation));
+			}
+			if (captureReportingObserver && Observer) try {
+				const observer = new Observer((reports) => {
+					for (const report of reports) captureReport(normalizeReport(report, options.sanitizeUrl));
+				}, {
+					buffered,
+					types: reportTypes
+				});
+				observer.observe();
+				disposers.push(() => {
+					for (const report of observer.takeRecords?.() ?? []) captureReport(normalizeReport(report, options.sanitizeUrl));
+					observer.disconnect();
+				});
+			} catch {}
+			return () => {
+				if (disposed) return;
+				for (const dispose of disposers) dispose();
+				disposed = true;
+			};
+		}
+	};
+}
+//#endregion
+export { captureReportingIntegration };
+
+//# sourceMappingURL=reporting-integration.js.map

package/dist/reporting-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-integration.js","names":[],"sources":["../src/reporting-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface BrowserReportLike {\n  type?: string;\n  url?: string;\n  body?: unknown;\n  toJSON?: () => unknown;\n}\n\nexport interface BrowserReportingObserverLike {\n  observe: () => void;\n  disconnect: () => void;\n  takeRecords?: () => BrowserReportLike[];\n}\n\nexport interface BrowserReportingObserverConstructor {\n  new (\n    callback: (reports: BrowserReportLike[], observer: BrowserReportingObserverLike) => void,\n    options?: { buffered?: boolean; types?: readonly string[] },\n  ): BrowserReportingObserverLike;\n}\n\nexport interface BrowserReportPayload {\n  type: string;\n  url?: string;\n  body?: unknown;\n}\n\nexport interface BrowserCspViolationPayload {\n  type: \"securitypolicyviolation\";\n  blockedURI?: string;\n  documentURI?: string;\n  effectiveDirective?: string;\n  violatedDirective?: string;\n  disposition?: string;\n  sourceFile?: string;\n  lineNumber?: number;\n  columnNumber?: number;\n  statusCode?: number;\n  sample?: string;\n}\n\nexport interface CaptureReportingOptions {\n  captureSecurityPolicyViolation?: boolean;\n  captureReportingObserver?: boolean;\n  reportTypes?: readonly string[];\n  level?:\n    | LoggerLevel\n    | ((report: BrowserReportPayload | BrowserCspViolationPayload) => LoggerLevel);\n  buffered?: boolean;\n  sanitizeUrl?: (url: string) => string;\n  ReportingObserver?: BrowserReportingObserverConstructor;\n  addEventListener?: typeof globalThis.addEventListener;\n  removeEventListener?: typeof globalThis.removeEventListener;\n}\n\nconst defaultReportTypes = [\"csp-violation\", \"deprecation\", \"intervention\", \"crash\"] as const;\n\nfunction levelFor(\n  level: CaptureReportingOptions[\"level\"],\n  report: BrowserReportPayload | BrowserCspViolationPayload,\n): LoggerLevel {\n  if (typeof level === \"function\") return level(report);\n  if (level) return level;\n  return report.type === \"deprecation\" ? \"info\" : \"warn\";\n}\n\nfunction maybeSanitize(\n  url: string | undefined,\n  sanitizeUrl: ((url: string) => string) | undefined,\n) {\n  return url && sanitizeUrl ? sanitizeUrl(url) : url;\n}\n\nfunction normalizeReport(\n  report: BrowserReportLike,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): BrowserReportPayload {\n  const raw = typeof report.toJSON === \"function\" ? report.toJSON() : report;\n  const record = raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n  const body = \"body\" in record ? record.body : report.body;\n  const url = typeof record.url === \"string\" ? record.url : report.url;\n  const type = typeof record.type === \"string\" ? record.type : (report.type ?? \"unknown\");\n  return {\n    type,\n    url: maybeSanitize(url, sanitizeUrl),\n    body: normalizeValue(body, { maxDepth: 6, maxObjectKeys: 80 }),\n  };\n}\n\nfunction normalizeCspViolation(\n  event: SecurityPolicyViolationEvent,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): BrowserCspViolationPayload {\n  return {\n    type: \"securitypolicyviolation\",\n    blockedURI: maybeSanitize(event.blockedURI, sanitizeUrl),\n    documentURI: maybeSanitize(event.documentURI, sanitizeUrl),\n    effectiveDirective: event.effectiveDirective,\n    violatedDirective: event.violatedDirective,\n    disposition: event.disposition,\n    sourceFile: maybeSanitize(event.sourceFile, sanitizeUrl),\n    lineNumber: event.lineNumber,\n    columnNumber: event.columnNumber,\n    statusCode: event.statusCode,\n    sample: event.sample,\n  };\n}\n\nexport function captureReportingIntegration(options: CaptureReportingOptions = {}): Integration {\n  const captureSecurityPolicyViolation = options.captureSecurityPolicyViolation ?? true;\n  const captureReportingObserver = options.captureReportingObserver ?? true;\n  const reportTypes = options.reportTypes ?? defaultReportTypes;\n  const buffered = options.buffered ?? true;\n\n  return {\n    name: \"capture-reporting\",\n    setup(api: IntegrationSetupContext) {\n      const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);\n      const remove =\n        options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);\n      const Observer =\n        options.ReportingObserver ??\n        (globalThis as unknown as { ReportingObserver?: BrowserReportingObserverConstructor })\n          .ReportingObserver;\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const captureReport = api.guard((report: BrowserReportPayload) => {\n        if (disposed) return;\n        api.capture({\n          level: levelFor(options.level, report),\n          message: `Browser report ${report.type}`,\n          props: { browser: { kind: \"report\", report } },\n        });\n      });\n\n      if (captureSecurityPolicyViolation && add && remove) {\n        const onViolation = api.guard((event: SecurityPolicyViolationEvent) => {\n          const report = normalizeCspViolation(event, options.sanitizeUrl);\n          api.capture({\n            level: levelFor(options.level, report),\n            message: `Security policy violation: ${report.effectiveDirective ?? report.violatedDirective ?? \"unknown\"}`,\n            props: { browser: { kind: \"securitypolicyviolation\", report } },\n          });\n        });\n        add(\"securitypolicyviolation\", onViolation);\n        disposers.push(() => remove(\"securitypolicyviolation\", onViolation));\n      }\n\n      if (captureReportingObserver && Observer) {\n        try {\n          const observer = new Observer(\n            (reports) => {\n              for (const report of reports)\n                captureReport(normalizeReport(report, options.sanitizeUrl));\n            },\n            { buffered, types: reportTypes },\n          );\n          observer.observe();\n          disposers.push(() => {\n            for (const report of observer.takeRecords?.() ?? [])\n              captureReport(normalizeReport(report, options.sanitizeUrl));\n            observer.disconnect();\n          });\n        } catch {\n          // ReportingObserver is still uneven across browsers; failures should not break setup.\n        }\n      }\n\n      return () => {\n        if (disposed) return;\n        for (const dispose of disposers) dispose();\n        disposed = true;\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/router-integration.cjs

@@ -0,0 +1,97 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loggerjs_core = require("@loggerjs/core");
+//#region src/router-integration.ts
+function locationHref(location) {
+	if (!location) return "http://localhost/";
+	if (location.href) return location.href;
+	return `${location.pathname ?? "/"}${location.search ?? ""}${location.hash ?? ""}`;
+}
+function normalizeRouteUrl(url, location, mode, sanitizeUrl) {
+	const fallback = locationHref(location);
+	const raw = url === void 0 || url === null ? fallback : String(url);
+	let normalized = raw;
+	try {
+		const parsed = new URL(raw, fallback);
+		normalized = mode === "href" ? parsed.href : `${parsed.pathname}${parsed.search}${parsed.hash}`;
+	} catch {
+		normalized = raw;
+	}
+	return sanitizeUrl ? sanitizeUrl(normalized) : normalized;
+}
+function routeState(includeState, state, maxDepth) {
+	return includeState ? (0, _loggerjs_core.normalizeValue)(state, {
+		maxDepth,
+		maxObjectKeys: 80
+	}) : void 0;
+}
+function captureRouterIntegration(options = {}) {
+	const level = options.level ?? "info";
+	const captureInitial = options.captureInitial ?? true;
+	const includeState = options.includeState ?? false;
+	const stateMaxDepth = options.stateMaxDepth ?? 4;
+	const urlMode = options.urlMode ?? "path";
+	return {
+		name: "capture-router",
+		setup(api) {
+			const history = options.history ?? globalThis.history;
+			const location = options.location ?? globalThis.location;
+			const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);
+			const remove = options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);
+			const originalPushState = history?.pushState;
+			const originalReplaceState = history?.replaceState;
+			let current = normalizeRouteUrl(void 0, location, urlMode, options.sanitizeUrl);
+			let disposed = false;
+			const capture = (trigger, to, state) => {
+				if (disposed) return;
+				const previous = current;
+				current = to;
+				if (trigger !== "initial" && previous === to) return;
+				const route = {
+					trigger,
+					from: trigger === "initial" ? void 0 : previous,
+					to,
+					state: routeState(includeState, state, stateMaxDepth)
+				};
+				api.capture({
+					level,
+					message: trigger === "initial" ? `Route initial ${to}` : `Route change ${to}`,
+					props: { browser: {
+						kind: "route-change",
+						route
+					} }
+				});
+			};
+			if (captureInitial) capture("initial", current, history?.state);
+			if (history && originalPushState) history.pushState = function pushState(data, unused, url) {
+				const result = originalPushState.call(this, data, unused, url);
+				capture("pushState", normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl), data);
+				return result;
+			};
+			if (history && originalReplaceState) history.replaceState = function replaceState(data, unused, url) {
+				const result = originalReplaceState.call(this, data, unused, url);
+				capture("replaceState", normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl), data);
+				return result;
+			};
+			const onPopState = api.guard((event) => {
+				capture("popstate", normalizeRouteUrl(void 0, location, urlMode, options.sanitizeUrl), event.state);
+			});
+			const onHashChange = api.guard((event) => {
+				capture("hashchange", normalizeRouteUrl(event.newURL, location, urlMode, options.sanitizeUrl), history?.state);
+			});
+			add?.("popstate", onPopState);
+			add?.("hashchange", onHashChange);
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				if (history && originalPushState) history.pushState = originalPushState;
+				if (history && originalReplaceState) history.replaceState = originalReplaceState;
+				remove?.("popstate", onPopState);
+				remove?.("hashchange", onHashChange);
+			};
+		}
+	};
+}
+//#endregion
+exports.captureRouterIntegration = captureRouterIntegration;
+
+//# sourceMappingURL=router-integration.cjs.map

package/dist/router-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-integration.cjs","names":[],"sources":["../src/router-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface BrowserHistoryLike {\n  state?: unknown;\n  pushState?: (data: unknown, unused: string, url?: string | URL | null) => unknown;\n  replaceState?: (data: unknown, unused: string, url?: string | URL | null) => unknown;\n}\n\nexport interface BrowserLocationLike {\n  href?: string;\n  pathname?: string;\n  search?: string;\n  hash?: string;\n}\n\nexport type BrowserRouteTrigger =\n  | \"initial\"\n  | \"pushState\"\n  | \"replaceState\"\n  | \"popstate\"\n  | \"hashchange\";\nexport type BrowserRouteUrlMode = \"path\" | \"href\";\n\nexport interface BrowserRouteChangePayload {\n  trigger: BrowserRouteTrigger;\n  from?: string;\n  to: string;\n  state?: unknown;\n}\n\nexport interface CaptureRouterOptions {\n  level?: LoggerLevel;\n  captureInitial?: boolean;\n  includeState?: boolean;\n  stateMaxDepth?: number;\n  urlMode?: BrowserRouteUrlMode;\n  sanitizeUrl?: (url: string) => string;\n  history?: BrowserHistoryLike;\n  location?: BrowserLocationLike;\n  addEventListener?: typeof globalThis.addEventListener;\n  removeEventListener?: typeof globalThis.removeEventListener;\n}\n\nfunction locationHref(location: BrowserLocationLike | undefined): string {\n  if (!location) return \"http://localhost/\";\n  if (location.href) return location.href;\n  return `${location.pathname ?? \"/\"}${location.search ?? \"\"}${location.hash ?? \"\"}`;\n}\n\nfunction normalizeRouteUrl(\n  url: string | URL | null | undefined,\n  location: BrowserLocationLike | undefined,\n  mode: BrowserRouteUrlMode,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): string {\n  const fallback = locationHref(location);\n  const raw = url === undefined || url === null ? fallback : String(url);\n  let normalized = raw;\n  try {\n    const parsed = new URL(raw, fallback);\n    normalized = mode === \"href\" ? parsed.href : `${parsed.pathname}${parsed.search}${parsed.hash}`;\n  } catch {\n    normalized = raw;\n  }\n  return sanitizeUrl ? sanitizeUrl(normalized) : normalized;\n}\n\nfunction routeState(includeState: boolean, state: unknown, maxDepth: number): unknown {\n  return includeState ? normalizeValue(state, { maxDepth, maxObjectKeys: 80 }) : undefined;\n}\n\nexport function captureRouterIntegration(options: CaptureRouterOptions = {}): Integration {\n  const level = options.level ?? \"info\";\n  const captureInitial = options.captureInitial ?? true;\n  const includeState = options.includeState ?? false;\n  const stateMaxDepth = options.stateMaxDepth ?? 4;\n  const urlMode = options.urlMode ?? \"path\";\n\n  return {\n    name: \"capture-router\",\n    setup(api: IntegrationSetupContext) {\n      const history = options.history ?? globalThis.history;\n      const location = options.location ?? globalThis.location;\n      const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);\n      const remove =\n        options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);\n      const originalPushState = history?.pushState;\n      const originalReplaceState = history?.replaceState;\n      let current = normalizeRouteUrl(undefined, location, urlMode, options.sanitizeUrl);\n      let disposed = false;\n\n      const capture = (trigger: BrowserRouteTrigger, to: string, state?: unknown) => {\n        if (disposed) return;\n        const previous = current;\n        current = to;\n        if (trigger !== \"initial\" && previous === to) return;\n        const route: BrowserRouteChangePayload = {\n          trigger,\n          from: trigger === \"initial\" ? undefined : previous,\n          to,\n          state: routeState(includeState, state, stateMaxDepth),\n        };\n        api.capture({\n          level,\n          message: trigger === \"initial\" ? `Route initial ${to}` : `Route change ${to}`,\n          props: { browser: { kind: \"route-change\", route } },\n        });\n      };\n\n      if (captureInitial) capture(\"initial\", current, history?.state);\n\n      if (history && originalPushState) {\n        history.pushState = function pushState(\n          data: unknown,\n          unused: string,\n          url?: string | URL | null,\n        ) {\n          const result = originalPushState.call(this, data, unused, url);\n          capture(\n            \"pushState\",\n            normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl),\n            data,\n          );\n          return result;\n        };\n      }\n\n      if (history && originalReplaceState) {\n        history.replaceState = function replaceState(\n          data: unknown,\n          unused: string,\n          url?: string | URL | null,\n        ) {\n          const result = originalReplaceState.call(this, data, unused, url);\n          capture(\n            \"replaceState\",\n            normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl),\n            data,\n          );\n          return result;\n        };\n      }\n\n      const onPopState = api.guard((event: PopStateEvent) => {\n        capture(\n          \"popstate\",\n          normalizeRouteUrl(undefined, location, urlMode, options.sanitizeUrl),\n          event.state,\n        );\n      });\n      const onHashChange = api.guard((event: HashChangeEvent) => {\n        capture(\n          \"hashchange\",\n          normalizeRouteUrl(event.newURL, location, urlMode, options.sanitizeUrl),\n          history?.state,\n        );\n      });\n\n      add?.(\"popstate\", onPopState);\n      add?.(\"hashchange\", onHashChange);\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        if (history && originalPushState) history.pushState = originalPushState;\n        if (history && originalReplaceState) history.replaceState = originalReplaceState;\n        remove?.(\"popstate\", onPopState);\n        remove?.(\"hashchange\", onHashChange);\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/router-integration.js

@@ -0,0 +1,96 @@
+import { normalizeValue } from "@loggerjs/core";
+//#region src/router-integration.ts
+function locationHref(location) {
+	if (!location) return "http://localhost/";
+	if (location.href) return location.href;
+	return `${location.pathname ?? "/"}${location.search ?? ""}${location.hash ?? ""}`;
+}
+function normalizeRouteUrl(url, location, mode, sanitizeUrl) {
+	const fallback = locationHref(location);
+	const raw = url === void 0 || url === null ? fallback : String(url);
+	let normalized = raw;
+	try {
+		const parsed = new URL(raw, fallback);
+		normalized = mode === "href" ? parsed.href : `${parsed.pathname}${parsed.search}${parsed.hash}`;
+	} catch {
+		normalized = raw;
+	}
+	return sanitizeUrl ? sanitizeUrl(normalized) : normalized;
+}
+function routeState(includeState, state, maxDepth) {
+	return includeState ? normalizeValue(state, {
+		maxDepth,
+		maxObjectKeys: 80
+	}) : void 0;
+}
+function captureRouterIntegration(options = {}) {
+	const level = options.level ?? "info";
+	const captureInitial = options.captureInitial ?? true;
+	const includeState = options.includeState ?? false;
+	const stateMaxDepth = options.stateMaxDepth ?? 4;
+	const urlMode = options.urlMode ?? "path";
+	return {
+		name: "capture-router",
+		setup(api) {
+			const history = options.history ?? globalThis.history;
+			const location = options.location ?? globalThis.location;
+			const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);
+			const remove = options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);
+			const originalPushState = history?.pushState;
+			const originalReplaceState = history?.replaceState;
+			let current = normalizeRouteUrl(void 0, location, urlMode, options.sanitizeUrl);
+			let disposed = false;
+			const capture = (trigger, to, state) => {
+				if (disposed) return;
+				const previous = current;
+				current = to;
+				if (trigger !== "initial" && previous === to) return;
+				const route = {
+					trigger,
+					from: trigger === "initial" ? void 0 : previous,
+					to,
+					state: routeState(includeState, state, stateMaxDepth)
+				};
+				api.capture({
+					level,
+					message: trigger === "initial" ? `Route initial ${to}` : `Route change ${to}`,
+					props: { browser: {
+						kind: "route-change",
+						route
+					} }
+				});
+			};
+			if (captureInitial) capture("initial", current, history?.state);
+			if (history && originalPushState) history.pushState = function pushState(data, unused, url) {
+				const result = originalPushState.call(this, data, unused, url);
+				capture("pushState", normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl), data);
+				return result;
+			};
+			if (history && originalReplaceState) history.replaceState = function replaceState(data, unused, url) {
+				const result = originalReplaceState.call(this, data, unused, url);
+				capture("replaceState", normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl), data);
+				return result;
+			};
+			const onPopState = api.guard((event) => {
+				capture("popstate", normalizeRouteUrl(void 0, location, urlMode, options.sanitizeUrl), event.state);
+			});
+			const onHashChange = api.guard((event) => {
+				capture("hashchange", normalizeRouteUrl(event.newURL, location, urlMode, options.sanitizeUrl), history?.state);
+			});
+			add?.("popstate", onPopState);
+			add?.("hashchange", onHashChange);
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				if (history && originalPushState) history.pushState = originalPushState;
+				if (history && originalReplaceState) history.replaceState = originalReplaceState;
+				remove?.("popstate", onPopState);
+				remove?.("hashchange", onHashChange);
+			};
+		}
+	};
+}
+//#endregion
+export { captureRouterIntegration };
+
+//# sourceMappingURL=router-integration.js.map

package/dist/router-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-integration.js","names":[],"sources":["../src/router-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface BrowserHistoryLike {\n  state?: unknown;\n  pushState?: (data: unknown, unused: string, url?: string | URL | null) => unknown;\n  replaceState?: (data: unknown, unused: string, url?: string | URL | null) => unknown;\n}\n\nexport interface BrowserLocationLike {\n  href?: string;\n  pathname?: string;\n  search?: string;\n  hash?: string;\n}\n\nexport type BrowserRouteTrigger =\n  | \"initial\"\n  | \"pushState\"\n  | \"replaceState\"\n  | \"popstate\"\n  | \"hashchange\";\nexport type BrowserRouteUrlMode = \"path\" | \"href\";\n\nexport interface BrowserRouteChangePayload {\n  trigger: BrowserRouteTrigger;\n  from?: string;\n  to: string;\n  state?: unknown;\n}\n\nexport interface CaptureRouterOptions {\n  level?: LoggerLevel;\n  captureInitial?: boolean;\n  includeState?: boolean;\n  stateMaxDepth?: number;\n  urlMode?: BrowserRouteUrlMode;\n  sanitizeUrl?: (url: string) => string;\n  history?: BrowserHistoryLike;\n  location?: BrowserLocationLike;\n  addEventListener?: typeof globalThis.addEventListener;\n  removeEventListener?: typeof globalThis.removeEventListener;\n}\n\nfunction locationHref(location: BrowserLocationLike | undefined): string {\n  if (!location) return \"http://localhost/\";\n  if (location.href) return location.href;\n  return `${location.pathname ?? \"/\"}${location.search ?? \"\"}${location.hash ?? \"\"}`;\n}\n\nfunction normalizeRouteUrl(\n  url: string | URL | null | undefined,\n  location: BrowserLocationLike | undefined,\n  mode: BrowserRouteUrlMode,\n  sanitizeUrl: ((url: string) => string) | undefined,\n): string {\n  const fallback = locationHref(location);\n  const raw = url === undefined || url === null ? fallback : String(url);\n  let normalized = raw;\n  try {\n    const parsed = new URL(raw, fallback);\n    normalized = mode === \"href\" ? parsed.href : `${parsed.pathname}${parsed.search}${parsed.hash}`;\n  } catch {\n    normalized = raw;\n  }\n  return sanitizeUrl ? sanitizeUrl(normalized) : normalized;\n}\n\nfunction routeState(includeState: boolean, state: unknown, maxDepth: number): unknown {\n  return includeState ? normalizeValue(state, { maxDepth, maxObjectKeys: 80 }) : undefined;\n}\n\nexport function captureRouterIntegration(options: CaptureRouterOptions = {}): Integration {\n  const level = options.level ?? \"info\";\n  const captureInitial = options.captureInitial ?? true;\n  const includeState = options.includeState ?? false;\n  const stateMaxDepth = options.stateMaxDepth ?? 4;\n  const urlMode = options.urlMode ?? \"path\";\n\n  return {\n    name: \"capture-router\",\n    setup(api: IntegrationSetupContext) {\n      const history = options.history ?? globalThis.history;\n      const location = options.location ?? globalThis.location;\n      const add = options.addEventListener ?? globalThis.addEventListener?.bind(globalThis);\n      const remove =\n        options.removeEventListener ?? globalThis.removeEventListener?.bind(globalThis);\n      const originalPushState = history?.pushState;\n      const originalReplaceState = history?.replaceState;\n      let current = normalizeRouteUrl(undefined, location, urlMode, options.sanitizeUrl);\n      let disposed = false;\n\n      const capture = (trigger: BrowserRouteTrigger, to: string, state?: unknown) => {\n        if (disposed) return;\n        const previous = current;\n        current = to;\n        if (trigger !== \"initial\" && previous === to) return;\n        const route: BrowserRouteChangePayload = {\n          trigger,\n          from: trigger === \"initial\" ? undefined : previous,\n          to,\n          state: routeState(includeState, state, stateMaxDepth),\n        };\n        api.capture({\n          level,\n          message: trigger === \"initial\" ? `Route initial ${to}` : `Route change ${to}`,\n          props: { browser: { kind: \"route-change\", route } },\n        });\n      };\n\n      if (captureInitial) capture(\"initial\", current, history?.state);\n\n      if (history && originalPushState) {\n        history.pushState = function pushState(\n          data: unknown,\n          unused: string,\n          url?: string | URL | null,\n        ) {\n          const result = originalPushState.call(this, data, unused, url);\n          capture(\n            \"pushState\",\n            normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl),\n            data,\n          );\n          return result;\n        };\n      }\n\n      if (history && originalReplaceState) {\n        history.replaceState = function replaceState(\n          data: unknown,\n          unused: string,\n          url?: string | URL | null,\n        ) {\n          const result = originalReplaceState.call(this, data, unused, url);\n          capture(\n            \"replaceState\",\n            normalizeRouteUrl(url, location, urlMode, options.sanitizeUrl),\n            data,\n          );\n          return result;\n        };\n      }\n\n      const onPopState = api.guard((event: PopStateEvent) => {\n        capture(\n          \"popstate\",\n          normalizeRouteUrl(undefined, location, urlMode, options.sanitizeUrl),\n          event.state,\n        );\n      });\n      const onHashChange = api.guard((event: HashChangeEvent) => {\n        capture(\n          \"hashchange\",\n          normalizeRouteUrl(event.newURL, location, urlMode, options.sanitizeUrl),\n          history?.state,\n        );\n      });\n\n      add?.(\"popstate\", onPopState);\n      add?.(\"hashchange\", onHashChange);\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        if (history && originalPushState) history.pushState = originalPushState;\n        if (history && originalReplaceState) history.replaceState = originalReplaceState;\n        remove?.(\"popstate\", onPopState);\n        remove?.(\"hashchange\", onHashChange);\n      };\n    },\n  };\n}\n"],"mappings":"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"}