@loggerjs/browser 0.5.0 → 0.5.1

package/dist/websocket-integration.js

@@ -0,0 +1,157 @@
+import { normalizeValue } from "@loggerjs/core";
+//#region src/http-capture-utils.ts
+function nowMs() {
+	return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+function durationMs(started) {
+	return nowMs() - started;
+}
+function sanitizeHttpUrl(rawUrl, sanitizer) {
+	const stripped = stripSensitiveUrlParts(rawUrl);
+	return sanitizer ? sanitizer(stripped) : stripped;
+}
+function shouldSample(sampleRate, random) {
+	if (sampleRate >= 1) return true;
+	if (sampleRate <= 0) return false;
+	return random() < sampleRate;
+}
+function stripSensitiveUrlParts(rawUrl) {
+	if (!/^[a-zA-Z][a-zA-Z\d+.-]*:/.test(rawUrl)) return rawUrl.split(/[?#]/, 1)[0] ?? rawUrl;
+	try {
+		const url = new URL(rawUrl);
+		url.search = "";
+		url.hash = "";
+		return url.toString();
+	} catch {
+		return rawUrl.split(/[?#]/, 1)[0] ?? rawUrl;
+	}
+}
+//#endregion
+//#region src/websocket-integration.ts
+const registryKey = "browser.WebSocket";
+const textEncoder = new TextEncoder();
+function dataType(data) {
+	if (typeof data === "string") return "string";
+	if (data instanceof ArrayBuffer) return "arraybuffer";
+	if (ArrayBuffer.isView(data)) return data.constructor.name;
+	return data?.constructor?.name ?? typeof data;
+}
+function dataByteLength(data) {
+	if (typeof data === "string") return textEncoder.encode(data).byteLength;
+	if (data instanceof ArrayBuffer) return data.byteLength;
+	if (ArrayBuffer.isView(data)) return data.byteLength;
+	const size = data?.size;
+	return typeof size === "number" && Number.isFinite(size) ? size : void 0;
+}
+function messagePayload(direction, data, captureMessageData) {
+	return {
+		direction,
+		dataType: dataType(data),
+		byteLength: dataByteLength(data),
+		data: captureMessageData ? normalizeValue(data, {
+			maxDepth: 4,
+			maxObjectKeys: 80
+		}) : void 0
+	};
+}
+function closeEventPayload(event) {
+	const close = event;
+	return {
+		code: close.code,
+		reason: close.reason,
+		wasClean: close.wasClean
+	};
+}
+function copyStaticConstants(target, source) {
+	for (const key of [
+		"CONNECTING",
+		"OPEN",
+		"CLOSING",
+		"CLOSED"
+	]) if (source[key] !== void 0) target[key] = source[key];
+}
+function captureWebSocketIntegration(options = {}) {
+	const level = options.level ?? "debug";
+	const captureConnect = options.captureConnect ?? true;
+	const captureOpen = options.captureOpen ?? true;
+	const captureClose = options.captureClose ?? true;
+	const captureError = options.captureError ?? true;
+	const captureMessages = options.captureMessages ?? false;
+	const captureSentMessages = options.captureSentMessages ?? false;
+	const captureMessageData = options.captureMessageData ?? false;
+	const sampleRate = options.sampleRate ?? 1;
+	const random = options.random ?? Math.random;
+	return {
+		name: "capture-websocket",
+		setup(api) {
+			const globalWebSocket = globalThis.WebSocket;
+			const current = options.WebSocket ?? globalWebSocket;
+			if (!current) return;
+			const original = api.unpatched.get(registryKey) ?? current;
+			api.unpatched.set(registryKey, original);
+			const capture = api.guard((input) => api.capture(input));
+			const PatchedWebSocket = function WebSocket(url, protocols) {
+				const started = nowMs();
+				const sanitizedUrl = sanitizeHttpUrl(String(url), options.sanitizeUrl);
+				const socket = new original(url, protocols);
+				const captureLifecycle = (event, extra = {}, error) => {
+					if (!shouldSample(sampleRate, random)) return;
+					capture({
+						level: event === "error" ? "error" : level,
+						message: `WebSocket ${event} ${sanitizedUrl}`,
+						error,
+						props: { websocket: {
+							kind: "websocket",
+							event,
+							url: sanitizedUrl,
+							durationMs: durationMs(started),
+							...extra
+						} }
+					});
+				};
+				if (captureConnect) captureLifecycle("connect");
+				if (captureOpen) socket.addEventListener?.("open", () => captureLifecycle("open"));
+				if (captureClose) socket.addEventListener?.("close", (event) => captureLifecycle("close", closeEventPayload(event)));
+				if (captureError) socket.addEventListener?.("error", (event) => captureLifecycle("error", { type: event.type }, event));
+				if (captureMessages) socket.addEventListener?.("message", (event) => {
+					const message = event;
+					capture({
+						level,
+						message: `WebSocket message ${sanitizedUrl}`,
+						props: { websocket: {
+							kind: "websocket-message",
+							url: sanitizedUrl,
+							message: messagePayload("incoming", message.data, captureMessageData)
+						} }
+					});
+				});
+				if (captureSentMessages && socket.send) {
+					const originalSend = socket.send.bind(socket);
+					socket.send = (data) => {
+						capture({
+							level,
+							message: `WebSocket send ${sanitizedUrl}`,
+							props: { websocket: {
+								kind: "websocket-message",
+								url: sanitizedUrl,
+								message: messagePayload("outgoing", data, captureMessageData)
+							} }
+						});
+						return originalSend(data);
+					};
+				}
+				return socket;
+			};
+			PatchedWebSocket.prototype = original.prototype;
+			copyStaticConstants(PatchedWebSocket, original);
+			globalThis.WebSocket = PatchedWebSocket;
+			return () => {
+				globalThis.WebSocket = current;
+			};
+		}
+	};
+}
+//#endregion
+export { captureWebSocketIntegration };
+
+//# sourceMappingURL=websocket-integration.js.map

package/dist/websocket-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-integration.js","names":["record"],"sources":["../src/http-capture-utils.ts","../src/websocket-integration.ts"],"sourcesContent":["export function nowMs(): number {\n  return typeof performance !== \"undefined\" ? performance.now() : Date.now();\n}\n\nexport function durationMs(started: number): number {\n  return nowMs() - started;\n}\n\nexport function sanitizeHttpUrl(rawUrl: string, sanitizer?: (url: string) => string): string {\n  const stripped = stripSensitiveUrlParts(rawUrl);\n  return sanitizer ? sanitizer(stripped) : stripped;\n}\n\nexport function pickAllowedHeaders(\n  headers: Headers | undefined,\n  allowList: readonly string[] | undefined,\n): Record<string, string> | undefined {\n  if (!headers || !allowList || allowList.length === 0) return undefined;\n  const out: Record<string, string> = {};\n  for (const name of allowList) {\n    const value = headers.get(name);\n    if (value !== null) out[name.toLowerCase()] = value;\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nexport function headersFromInit(headers: HeadersInit | undefined): Headers | undefined {\n  if (!headers) return undefined;\n  try {\n    return new Headers(headers);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function shouldSample(sampleRate: number, random: () => number): boolean {\n  if (sampleRate >= 1) return true;\n  if (sampleRate <= 0) return false;\n  return random() < sampleRate;\n}\n\nfunction stripSensitiveUrlParts(rawUrl: string): string {\n  if (!/^[a-zA-Z][a-zA-Z\\d+.-]*:/.test(rawUrl)) {\n    return rawUrl.split(/[?#]/, 1)[0] ?? rawUrl;\n  }\n\n  try {\n    const url = new URL(rawUrl);\n    url.search = \"\";\n    url.hash = \"\";\n    return url.toString();\n  } catch {\n    return rawUrl.split(/[?#]/, 1)[0] ?? rawUrl;\n  }\n}\n","import {\n  normalizeValue,\n  type CaptureInput,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\nimport { durationMs, nowMs, sanitizeHttpUrl, shouldSample } from \"./http-capture-utils\";\n\ntype BrowserWebSocketSendPayload = Parameters<WebSocket[\"send\"]>[0];\n\nexport interface BrowserCapturedWebSocketLike {\n  url?: string;\n  send?: (data: BrowserWebSocketSendPayload) => void;\n  close?: (code?: number, reason?: string) => void;\n  addEventListener?: (type: string, listener: EventListenerOrEventListenerObject) => void;\n  removeEventListener?: (type: string, listener: EventListenerOrEventListenerObject) => void;\n}\n\nexport interface BrowserCapturedWebSocketConstructor {\n  new (url: string | URL, protocols?: string | string[]): BrowserCapturedWebSocketLike;\n  prototype?: unknown;\n  CONNECTING?: number;\n  OPEN?: number;\n  CLOSING?: number;\n  CLOSED?: number;\n}\n\nexport type BrowserWebSocketDirection = \"incoming\" | \"outgoing\";\n\nexport interface BrowserWebSocketMessagePayload {\n  direction: BrowserWebSocketDirection;\n  dataType: string;\n  byteLength?: number;\n  data?: unknown;\n}\n\nexport interface CaptureWebSocketOptions {\n  level?: LoggerLevel;\n  captureConnect?: boolean;\n  captureOpen?: boolean;\n  captureClose?: boolean;\n  captureError?: boolean;\n  captureMessages?: boolean;\n  captureSentMessages?: boolean;\n  captureMessageData?: boolean;\n  sampleRate?: number;\n  random?: () => number;\n  sanitizeUrl?: (url: string) => string;\n  WebSocket?: BrowserCapturedWebSocketConstructor;\n}\n\nconst registryKey = \"browser.WebSocket\";\nconst textEncoder = new TextEncoder();\n\nfunction dataType(data: unknown): string {\n  if (typeof data === \"string\") return \"string\";\n  if (data instanceof ArrayBuffer) return \"arraybuffer\";\n  if (ArrayBuffer.isView(data)) return data.constructor.name;\n  const record = data as { constructor?: { name?: string } } | undefined;\n  return record?.constructor?.name ?? typeof data;\n}\n\nfunction dataByteLength(data: unknown): number | undefined {\n  if (typeof data === \"string\") return textEncoder.encode(data).byteLength;\n  if (data instanceof ArrayBuffer) return data.byteLength;\n  if (ArrayBuffer.isView(data)) return data.byteLength;\n  const size = (data as { size?: unknown } | undefined)?.size;\n  return typeof size === \"number\" && Number.isFinite(size) ? size : undefined;\n}\n\nfunction messagePayload(\n  direction: BrowserWebSocketDirection,\n  data: unknown,\n  captureMessageData: boolean,\n): BrowserWebSocketMessagePayload {\n  return {\n    direction,\n    dataType: dataType(data),\n    byteLength: dataByteLength(data),\n    data: captureMessageData ? normalizeValue(data, { maxDepth: 4, maxObjectKeys: 80 }) : undefined,\n  };\n}\n\nfunction closeEventPayload(event: Event): Record<string, unknown> {\n  const close = event as CloseEvent;\n  return {\n    code: close.code,\n    reason: close.reason,\n    wasClean: close.wasClean,\n  };\n}\n\nfunction copyStaticConstants(\n  target: BrowserCapturedWebSocketConstructor,\n  source: BrowserCapturedWebSocketConstructor,\n) {\n  for (const key of [\"CONNECTING\", \"OPEN\", \"CLOSING\", \"CLOSED\"] as const) {\n    if (source[key] !== undefined) target[key] = source[key];\n  }\n}\n\nexport function captureWebSocketIntegration(options: CaptureWebSocketOptions = {}): Integration {\n  const level = options.level ?? \"debug\";\n  const captureConnect = options.captureConnect ?? true;\n  const captureOpen = options.captureOpen ?? true;\n  const captureClose = options.captureClose ?? true;\n  const captureError = options.captureError ?? true;\n  const captureMessages = options.captureMessages ?? false;\n  const captureSentMessages = options.captureSentMessages ?? false;\n  const captureMessageData = options.captureMessageData ?? false;\n  const sampleRate = options.sampleRate ?? 1;\n  const random = options.random ?? Math.random;\n\n  return {\n    name: \"capture-websocket\",\n    setup(api: IntegrationSetupContext) {\n      const globalWebSocket = globalThis.WebSocket as\n        | BrowserCapturedWebSocketConstructor\n        | undefined;\n      const current = options.WebSocket ?? globalWebSocket;\n      if (!current) return;\n      const original =\n        api.unpatched.get<BrowserCapturedWebSocketConstructor>(registryKey) ?? current;\n      api.unpatched.set(registryKey, original);\n      const capture = api.guard((input: CaptureInput) => api.capture(input));\n\n      const PatchedWebSocket = function WebSocket(\n        this: BrowserCapturedWebSocketLike,\n        url: string | URL,\n        protocols?: string | string[],\n      ) {\n        const started = nowMs();\n        const sanitizedUrl = sanitizeHttpUrl(String(url), options.sanitizeUrl);\n        const socket = new original(url, protocols);\n\n        const captureLifecycle = (\n          event: \"close\" | \"connect\" | \"error\" | \"open\",\n          extra: Record<string, unknown> = {},\n          error?: unknown,\n        ) => {\n          if (!shouldSample(sampleRate, random)) return;\n          capture({\n            level: event === \"error\" ? \"error\" : level,\n            message: `WebSocket ${event} ${sanitizedUrl}`,\n            error,\n            props: {\n              websocket: {\n                kind: \"websocket\",\n                event,\n                url: sanitizedUrl,\n                durationMs: durationMs(started),\n                ...extra,\n              },\n            },\n          });\n        };\n\n        if (captureConnect) captureLifecycle(\"connect\");\n\n        if (captureOpen) {\n          socket.addEventListener?.(\"open\", () => captureLifecycle(\"open\"));\n        }\n        if (captureClose) {\n          socket.addEventListener?.(\"close\", (event) =>\n            captureLifecycle(\"close\", closeEventPayload(event)),\n          );\n        }\n        if (captureError) {\n          socket.addEventListener?.(\"error\", (event) =>\n            captureLifecycle(\"error\", { type: event.type }, event),\n          );\n        }\n        if (captureMessages) {\n          socket.addEventListener?.(\"message\", (event) => {\n            const message = event as MessageEvent;\n            capture({\n              level,\n              message: `WebSocket message ${sanitizedUrl}`,\n              props: {\n                websocket: {\n                  kind: \"websocket-message\",\n                  url: sanitizedUrl,\n                  message: messagePayload(\"incoming\", message.data, captureMessageData),\n                },\n              },\n            });\n          });\n        }\n\n        if (captureSentMessages && socket.send) {\n          const originalSend = socket.send.bind(socket);\n          socket.send = (data: BrowserWebSocketSendPayload) => {\n            capture({\n              level,\n              message: `WebSocket send ${sanitizedUrl}`,\n              props: {\n                websocket: {\n                  kind: \"websocket-message\",\n                  url: sanitizedUrl,\n                  message: messagePayload(\"outgoing\", data, captureMessageData),\n                },\n              },\n            });\n            return originalSend(data);\n          };\n        }\n\n        return socket;\n      } as unknown as BrowserCapturedWebSocketConstructor;\n\n      PatchedWebSocket.prototype = original.prototype;\n      copyStaticConstants(PatchedWebSocket, original);\n      globalThis.WebSocket = PatchedWebSocket as unknown as typeof WebSocket;\n\n      return () => {\n        globalThis.WebSocket = current as unknown as typeof WebSocket;\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/websocket-transport.cjs

@@ -0,0 +1,187 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loggerjs_core = require("@loggerjs/core");
+//#region src/websocket-transport.ts
+const WS_CONNECTING = 0;
+const WS_OPEN = 1;
+function defaultWebSocketFactory(url, protocols) {
+	if (typeof WebSocket === "undefined") throw new Error("WebSocket is not available");
+	return new WebSocket(url, protocols);
+}
+function toSendPayload(payload) {
+	if (typeof payload === "string") return payload;
+	return Uint8Array.from(payload);
+}
+function browserWebSocketTransport(options) {
+	const transportName = options.name ?? "browser-websocket";
+	const codec = options.codec ?? (0, _loggerjs_core.safeJsonCodec)();
+	const maxQueueSize = options.maxQueueSize ?? 1e3;
+	const dropPolicy = options.dropPolicy ?? "drop-oldest";
+	const webSocketFactory = options.webSocketFactory ?? defaultWebSocketFactory;
+	const queue = [];
+	let active;
+	let closed = false;
+	let lastContext;
+	const reportDrop = (item, reason) => {
+		(0, _loggerjs_core.incrementLoggerMetaCounter)("transport.dropped", item.events.length);
+		(0, _loggerjs_core.incrementLoggerMetaCounter)(`transport.dropped.${reason}`, item.events.length);
+		for (const event of item.events) options.onDrop?.(event, reason);
+	};
+	const reportError = (error, context, detail) => {
+		try {
+			options.onError?.(error, detail);
+		} catch (onErrorError) {
+			context?.reportInternalError(onErrorError, {
+				operation: "on-error",
+				phase: "transport",
+				transport: transportName
+			});
+		}
+		context?.reportInternalError(error, {
+			operation: detail.operation,
+			phase: "transport",
+			transport: transportName
+		});
+	};
+	const detachSocket = () => {
+		if (!active) return;
+		const current = active;
+		current.socket.removeEventListener("open", current.onOpen);
+		current.socket.removeEventListener("close", current.onClose);
+		current.socket.removeEventListener("error", current.onError);
+		active = void 0;
+	};
+	const drainQueue = (context = lastContext) => {
+		const socket = active?.socket;
+		if (!socket || socket.readyState !== WS_OPEN) return;
+		while (queue.length > 0) {
+			const item = queue.shift();
+			if (!item) return;
+			try {
+				socket.send(toSendPayload(item.payload));
+			} catch (error) {
+				reportDrop(item, "send");
+				reportError(error, context, {
+					droppedEvents: item.events.length,
+					operation: "send"
+				});
+				return;
+			}
+		}
+	};
+	const createSocket = (context, droppedEvents) => {
+		if (closed) return void 0;
+		if (active && (active.socket.readyState === WS_CONNECTING || active.socket.readyState === WS_OPEN)) return active.socket;
+		detachSocket();
+		try {
+			const socket = webSocketFactory(options.url, options.protocols);
+			const nextActive = {
+				socket,
+				onOpen() {
+					drainQueue(context);
+				},
+				onClose() {
+					if (active?.socket === socket) detachSocket();
+				},
+				onError(errorEvent) {
+					reportError(errorEvent, context, {
+						droppedEvents: 0,
+						operation: "socket-error"
+					});
+				}
+			};
+			active = nextActive;
+			socket.addEventListener("open", nextActive.onOpen);
+			socket.addEventListener("close", nextActive.onClose);
+			socket.addEventListener("error", nextActive.onError);
+			return socket;
+		} catch (error) {
+			reportError(error, context, {
+				droppedEvents,
+				operation: "create-socket"
+			});
+			return;
+		}
+	};
+	const enqueue = (item) => {
+		if (queue.length >= maxQueueSize) {
+			if (dropPolicy === "drop-newest") {
+				reportDrop(item, "queue-full");
+				return false;
+			}
+			const dropped = queue.shift();
+			if (dropped) reportDrop(dropped, "queue-full");
+		}
+		queue.push(item);
+		return true;
+	};
+	const sendOrQueue = (item, context) => {
+		lastContext = context;
+		if (closed) {
+			reportDrop(item, "closed");
+			return;
+		}
+		const socket = createSocket(context, item.events.length);
+		if (!socket) {
+			reportDrop(item, "create-socket");
+			return;
+		}
+		if (socket.readyState === WS_OPEN) {
+			try {
+				socket.send(toSendPayload(item.payload));
+			} catch (error) {
+				reportDrop(item, "send");
+				reportError(error, context, {
+					droppedEvents: item.events.length,
+					operation: "send"
+				});
+			}
+			return;
+		}
+		enqueue(item);
+	};
+	return {
+		name: transportName,
+		minLevel: options.minLevel,
+		queueSize() {
+			return queue.length;
+		},
+		log(event, context) {
+			sendOrQueue({
+				events: [event],
+				payload: codec.encode(event)
+			}, context);
+		},
+		logBatch(events, context) {
+			if (events.length === 0) return;
+			sendOrQueue({
+				events,
+				payload: codec.encode(events)
+			}, context);
+		},
+		flush() {
+			drainQueue();
+		},
+		async close() {
+			closed = true;
+			while (queue.length > 0) {
+				const item = queue.shift();
+				if (item) reportDrop(item, "closed");
+			}
+			const socket = active?.socket;
+			detachSocket();
+			if (!socket) return;
+			try {
+				socket.close(options.closeCode, options.closeReason);
+			} catch (error) {
+				reportError(error, lastContext, {
+					droppedEvents: 0,
+					operation: "close-socket"
+				});
+			}
+		}
+	};
+}
+//#endregion
+exports.browserWebSocketTransport = browserWebSocketTransport;
+
+//# sourceMappingURL=websocket-transport.cjs.map

package/dist/websocket-transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.cjs","names":[],"sources":["../src/websocket-transport.ts"],"sourcesContent":["import {\n  incrementLoggerMetaCounter,\n  safeJsonCodec,\n  type Codec,\n  type LogEvent,\n  type LoggerLevel,\n  type Transport,\n  type TransportContext,\n} from \"@loggerjs/core\";\n\nexport type BrowserWebSocketDropPolicy = \"drop-oldest\" | \"drop-newest\";\nexport type BrowserWebSocketPayload = string | Uint8Array;\nexport type BrowserWebSocketEventType = \"close\" | \"error\" | \"open\";\ntype BrowserWebSocketSendPayload = Parameters<WebSocket[\"send\"]>[0];\n\nexport interface BrowserWebSocketLike {\n  readonly readyState: number;\n  send: (data: BrowserWebSocketSendPayload) => void;\n  close: (code?: number, reason?: string) => void;\n  addEventListener: (type: BrowserWebSocketEventType, listener: (event: Event) => void) => void;\n  removeEventListener: (type: BrowserWebSocketEventType, listener: (event: Event) => void) => void;\n}\n\nexport type BrowserWebSocketFactory = (\n  url: string,\n  protocols?: string | string[],\n) => BrowserWebSocketLike;\n\nexport interface BrowserWebSocketErrorDetail {\n  operation: \"close-socket\" | \"create-socket\" | \"send\" | \"socket-error\" | \"on-error\";\n  droppedEvents: number;\n}\n\nexport interface BrowserWebSocketTransportOptions {\n  url: string;\n  name?: string;\n  protocols?: string | string[];\n  minLevel?: LoggerLevel;\n  codec?: Codec<BrowserWebSocketPayload>;\n  maxQueueSize?: number;\n  dropPolicy?: BrowserWebSocketDropPolicy;\n  webSocketFactory?: BrowserWebSocketFactory;\n  closeCode?: number;\n  closeReason?: string;\n  onDrop?: (event: LogEvent, reason: string) => void;\n  onError?: (error: unknown, detail: BrowserWebSocketErrorDetail) => void;\n}\n\nexport interface BrowserWebSocketTransport extends Transport {\n  queueSize: () => number;\n}\n\ninterface QueueItem {\n  events: readonly LogEvent[];\n  payload: BrowserWebSocketPayload;\n}\n\ninterface ActiveSocket {\n  socket: BrowserWebSocketLike;\n  onOpen: (event: Event) => void;\n  onClose: (event: Event) => void;\n  onError: (event: Event) => void;\n}\n\nconst WS_CONNECTING = 0;\nconst WS_OPEN = 1;\n\nfunction defaultWebSocketFactory(url: string, protocols?: string | string[]): BrowserWebSocketLike {\n  if (typeof WebSocket === \"undefined\") {\n    throw new Error(\"WebSocket is not available\");\n  }\n  return new WebSocket(url, protocols);\n}\n\nfunction toSendPayload(payload: BrowserWebSocketPayload): BrowserWebSocketSendPayload {\n  if (typeof payload === \"string\") return payload;\n  return Uint8Array.from(payload);\n}\n\nexport function browserWebSocketTransport(\n  options: BrowserWebSocketTransportOptions,\n): BrowserWebSocketTransport {\n  const transportName = options.name ?? \"browser-websocket\";\n  const codec = options.codec ?? safeJsonCodec();\n  const maxQueueSize = options.maxQueueSize ?? 1000;\n  const dropPolicy = options.dropPolicy ?? \"drop-oldest\";\n  const webSocketFactory = options.webSocketFactory ?? defaultWebSocketFactory;\n  const queue: QueueItem[] = [];\n  let active: ActiveSocket | undefined;\n  let closed = false;\n  let lastContext: TransportContext | undefined;\n\n  const reportDrop = (item: QueueItem, reason: string) => {\n    incrementLoggerMetaCounter(\"transport.dropped\", item.events.length);\n    incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);\n    for (const event of item.events) options.onDrop?.(event, reason);\n  };\n\n  const reportError = (\n    error: unknown,\n    context: TransportContext | undefined,\n    detail: BrowserWebSocketErrorDetail,\n  ) => {\n    try {\n      options.onError?.(error, detail);\n    } catch (onErrorError) {\n      context?.reportInternalError(onErrorError, {\n        operation: \"on-error\",\n        phase: \"transport\",\n        transport: transportName,\n      });\n    }\n\n    context?.reportInternalError(error, {\n      operation: detail.operation,\n      phase: \"transport\",\n      transport: transportName,\n    });\n  };\n\n  const detachSocket = () => {\n    if (!active) return;\n    const current = active;\n    current.socket.removeEventListener(\"open\", current.onOpen);\n    current.socket.removeEventListener(\"close\", current.onClose);\n    current.socket.removeEventListener(\"error\", current.onError);\n    active = undefined;\n  };\n\n  const drainQueue = (context = lastContext) => {\n    const socket = active?.socket;\n    if (!socket || socket.readyState !== WS_OPEN) return;\n\n    while (queue.length > 0) {\n      const item = queue.shift();\n      if (!item) return;\n      try {\n        socket.send(toSendPayload(item.payload));\n      } catch (error) {\n        reportDrop(item, \"send\");\n        reportError(error, context, {\n          droppedEvents: item.events.length,\n          operation: \"send\",\n        });\n        return;\n      }\n    }\n  };\n\n  const createSocket = (context: TransportContext, droppedEvents: number) => {\n    if (closed) return undefined;\n    if (\n      active &&\n      (active.socket.readyState === WS_CONNECTING || active.socket.readyState === WS_OPEN)\n    ) {\n      return active.socket;\n    }\n\n    detachSocket();\n\n    try {\n      const socket = webSocketFactory(options.url, options.protocols);\n      const nextActive: ActiveSocket = {\n        socket,\n        onOpen() {\n          drainQueue(context);\n        },\n        onClose() {\n          if (active?.socket === socket) detachSocket();\n        },\n        onError(errorEvent) {\n          reportError(errorEvent, context, {\n            droppedEvents: 0,\n            operation: \"socket-error\",\n          });\n        },\n      };\n      active = nextActive;\n      socket.addEventListener(\"open\", nextActive.onOpen);\n      socket.addEventListener(\"close\", nextActive.onClose);\n      socket.addEventListener(\"error\", nextActive.onError);\n      return socket;\n    } catch (error) {\n      reportError(error, context, {\n        droppedEvents,\n        operation: \"create-socket\",\n      });\n      return undefined;\n    }\n  };\n\n  const enqueue = (item: QueueItem) => {\n    if (queue.length >= maxQueueSize) {\n      if (dropPolicy === \"drop-newest\") {\n        reportDrop(item, \"queue-full\");\n        return false;\n      }\n\n      const dropped = queue.shift();\n      if (dropped) reportDrop(dropped, \"queue-full\");\n    }\n\n    queue.push(item);\n    return true;\n  };\n\n  const sendOrQueue = (item: QueueItem, context: TransportContext) => {\n    lastContext = context;\n    if (closed) {\n      reportDrop(item, \"closed\");\n      return;\n    }\n\n    const socket = createSocket(context, item.events.length);\n    if (!socket) {\n      reportDrop(item, \"create-socket\");\n      return;\n    }\n\n    if (socket.readyState === WS_OPEN) {\n      try {\n        socket.send(toSendPayload(item.payload));\n      } catch (error) {\n        reportDrop(item, \"send\");\n        reportError(error, context, {\n          droppedEvents: item.events.length,\n          operation: \"send\",\n        });\n      }\n      return;\n    }\n\n    enqueue(item);\n  };\n\n  return {\n    name: transportName,\n    minLevel: options.minLevel,\n    queueSize() {\n      return queue.length;\n    },\n    log(event, context) {\n      sendOrQueue({ events: [event], payload: codec.encode(event) }, context);\n    },\n    logBatch(events, context) {\n      if (events.length === 0) return;\n      sendOrQueue({ events, payload: codec.encode(events) }, context);\n    },\n    flush() {\n      drainQueue();\n    },\n    async close() {\n      closed = true;\n      while (queue.length > 0) {\n        const item = queue.shift();\n        if (item) reportDrop(item, \"closed\");\n      }\n\n      const socket = active?.socket;\n      detachSocket();\n      if (!socket) return;\n\n      try {\n        socket.close(options.closeCode, options.closeReason);\n      } catch (error) {\n        reportError(error, lastContext, {\n          droppedEvents: 0,\n          operation: \"close-socket\",\n        });\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/websocket-transport.js

@@ -0,0 +1,186 @@
+import { incrementLoggerMetaCounter, safeJsonCodec } from "@loggerjs/core";
+//#region src/websocket-transport.ts
+const WS_CONNECTING = 0;
+const WS_OPEN = 1;
+function defaultWebSocketFactory(url, protocols) {
+	if (typeof WebSocket === "undefined") throw new Error("WebSocket is not available");
+	return new WebSocket(url, protocols);
+}
+function toSendPayload(payload) {
+	if (typeof payload === "string") return payload;
+	return Uint8Array.from(payload);
+}
+function browserWebSocketTransport(options) {
+	const transportName = options.name ?? "browser-websocket";
+	const codec = options.codec ?? safeJsonCodec();
+	const maxQueueSize = options.maxQueueSize ?? 1e3;
+	const dropPolicy = options.dropPolicy ?? "drop-oldest";
+	const webSocketFactory = options.webSocketFactory ?? defaultWebSocketFactory;
+	const queue = [];
+	let active;
+	let closed = false;
+	let lastContext;
+	const reportDrop = (item, reason) => {
+		incrementLoggerMetaCounter("transport.dropped", item.events.length);
+		incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);
+		for (const event of item.events) options.onDrop?.(event, reason);
+	};
+	const reportError = (error, context, detail) => {
+		try {
+			options.onError?.(error, detail);
+		} catch (onErrorError) {
+			context?.reportInternalError(onErrorError, {
+				operation: "on-error",
+				phase: "transport",
+				transport: transportName
+			});
+		}
+		context?.reportInternalError(error, {
+			operation: detail.operation,
+			phase: "transport",
+			transport: transportName
+		});
+	};
+	const detachSocket = () => {
+		if (!active) return;
+		const current = active;
+		current.socket.removeEventListener("open", current.onOpen);
+		current.socket.removeEventListener("close", current.onClose);
+		current.socket.removeEventListener("error", current.onError);
+		active = void 0;
+	};
+	const drainQueue = (context = lastContext) => {
+		const socket = active?.socket;
+		if (!socket || socket.readyState !== WS_OPEN) return;
+		while (queue.length > 0) {
+			const item = queue.shift();
+			if (!item) return;
+			try {
+				socket.send(toSendPayload(item.payload));
+			} catch (error) {
+				reportDrop(item, "send");
+				reportError(error, context, {
+					droppedEvents: item.events.length,
+					operation: "send"
+				});
+				return;
+			}
+		}
+	};
+	const createSocket = (context, droppedEvents) => {
+		if (closed) return void 0;
+		if (active && (active.socket.readyState === WS_CONNECTING || active.socket.readyState === WS_OPEN)) return active.socket;
+		detachSocket();
+		try {
+			const socket = webSocketFactory(options.url, options.protocols);
+			const nextActive = {
+				socket,
+				onOpen() {
+					drainQueue(context);
+				},
+				onClose() {
+					if (active?.socket === socket) detachSocket();
+				},
+				onError(errorEvent) {
+					reportError(errorEvent, context, {
+						droppedEvents: 0,
+						operation: "socket-error"
+					});
+				}
+			};
+			active = nextActive;
+			socket.addEventListener("open", nextActive.onOpen);
+			socket.addEventListener("close", nextActive.onClose);
+			socket.addEventListener("error", nextActive.onError);
+			return socket;
+		} catch (error) {
+			reportError(error, context, {
+				droppedEvents,
+				operation: "create-socket"
+			});
+			return;
+		}
+	};
+	const enqueue = (item) => {
+		if (queue.length >= maxQueueSize) {
+			if (dropPolicy === "drop-newest") {
+				reportDrop(item, "queue-full");
+				return false;
+			}
+			const dropped = queue.shift();
+			if (dropped) reportDrop(dropped, "queue-full");
+		}
+		queue.push(item);
+		return true;
+	};
+	const sendOrQueue = (item, context) => {
+		lastContext = context;
+		if (closed) {
+			reportDrop(item, "closed");
+			return;
+		}
+		const socket = createSocket(context, item.events.length);
+		if (!socket) {
+			reportDrop(item, "create-socket");
+			return;
+		}
+		if (socket.readyState === WS_OPEN) {
+			try {
+				socket.send(toSendPayload(item.payload));
+			} catch (error) {
+				reportDrop(item, "send");
+				reportError(error, context, {
+					droppedEvents: item.events.length,
+					operation: "send"
+				});
+			}
+			return;
+		}
+		enqueue(item);
+	};
+	return {
+		name: transportName,
+		minLevel: options.minLevel,
+		queueSize() {
+			return queue.length;
+		},
+		log(event, context) {
+			sendOrQueue({
+				events: [event],
+				payload: codec.encode(event)
+			}, context);
+		},
+		logBatch(events, context) {
+			if (events.length === 0) return;
+			sendOrQueue({
+				events,
+				payload: codec.encode(events)
+			}, context);
+		},
+		flush() {
+			drainQueue();
+		},
+		async close() {
+			closed = true;
+			while (queue.length > 0) {
+				const item = queue.shift();
+				if (item) reportDrop(item, "closed");
+			}
+			const socket = active?.socket;
+			detachSocket();
+			if (!socket) return;
+			try {
+				socket.close(options.closeCode, options.closeReason);
+			} catch (error) {
+				reportError(error, lastContext, {
+					droppedEvents: 0,
+					operation: "close-socket"
+				});
+			}
+		}
+	};
+}
+//#endregion
+export { browserWebSocketTransport };
+
+//# sourceMappingURL=websocket-transport.js.map

package/dist/websocket-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.js","names":[],"sources":["../src/websocket-transport.ts"],"sourcesContent":["import {\n  incrementLoggerMetaCounter,\n  safeJsonCodec,\n  type Codec,\n  type LogEvent,\n  type LoggerLevel,\n  type Transport,\n  type TransportContext,\n} from \"@loggerjs/core\";\n\nexport type BrowserWebSocketDropPolicy = \"drop-oldest\" | \"drop-newest\";\nexport type BrowserWebSocketPayload = string | Uint8Array;\nexport type BrowserWebSocketEventType = \"close\" | \"error\" | \"open\";\ntype BrowserWebSocketSendPayload = Parameters<WebSocket[\"send\"]>[0];\n\nexport interface BrowserWebSocketLike {\n  readonly readyState: number;\n  send: (data: BrowserWebSocketSendPayload) => void;\n  close: (code?: number, reason?: string) => void;\n  addEventListener: (type: BrowserWebSocketEventType, listener: (event: Event) => void) => void;\n  removeEventListener: (type: BrowserWebSocketEventType, listener: (event: Event) => void) => void;\n}\n\nexport type BrowserWebSocketFactory = (\n  url: string,\n  protocols?: string | string[],\n) => BrowserWebSocketLike;\n\nexport interface BrowserWebSocketErrorDetail {\n  operation: \"close-socket\" | \"create-socket\" | \"send\" | \"socket-error\" | \"on-error\";\n  droppedEvents: number;\n}\n\nexport interface BrowserWebSocketTransportOptions {\n  url: string;\n  name?: string;\n  protocols?: string | string[];\n  minLevel?: LoggerLevel;\n  codec?: Codec<BrowserWebSocketPayload>;\n  maxQueueSize?: number;\n  dropPolicy?: BrowserWebSocketDropPolicy;\n  webSocketFactory?: BrowserWebSocketFactory;\n  closeCode?: number;\n  closeReason?: string;\n  onDrop?: (event: LogEvent, reason: string) => void;\n  onError?: (error: unknown, detail: BrowserWebSocketErrorDetail) => void;\n}\n\nexport interface BrowserWebSocketTransport extends Transport {\n  queueSize: () => number;\n}\n\ninterface QueueItem {\n  events: readonly LogEvent[];\n  payload: BrowserWebSocketPayload;\n}\n\ninterface ActiveSocket {\n  socket: BrowserWebSocketLike;\n  onOpen: (event: Event) => void;\n  onClose: (event: Event) => void;\n  onError: (event: Event) => void;\n}\n\nconst WS_CONNECTING = 0;\nconst WS_OPEN = 1;\n\nfunction defaultWebSocketFactory(url: string, protocols?: string | string[]): BrowserWebSocketLike {\n  if (typeof WebSocket === \"undefined\") {\n    throw new Error(\"WebSocket is not available\");\n  }\n  return new WebSocket(url, protocols);\n}\n\nfunction toSendPayload(payload: BrowserWebSocketPayload): BrowserWebSocketSendPayload {\n  if (typeof payload === \"string\") return payload;\n  return Uint8Array.from(payload);\n}\n\nexport function browserWebSocketTransport(\n  options: BrowserWebSocketTransportOptions,\n): BrowserWebSocketTransport {\n  const transportName = options.name ?? \"browser-websocket\";\n  const codec = options.codec ?? safeJsonCodec();\n  const maxQueueSize = options.maxQueueSize ?? 1000;\n  const dropPolicy = options.dropPolicy ?? \"drop-oldest\";\n  const webSocketFactory = options.webSocketFactory ?? defaultWebSocketFactory;\n  const queue: QueueItem[] = [];\n  let active: ActiveSocket | undefined;\n  let closed = false;\n  let lastContext: TransportContext | undefined;\n\n  const reportDrop = (item: QueueItem, reason: string) => {\n    incrementLoggerMetaCounter(\"transport.dropped\", item.events.length);\n    incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);\n    for (const event of item.events) options.onDrop?.(event, reason);\n  };\n\n  const reportError = (\n    error: unknown,\n    context: TransportContext | undefined,\n    detail: BrowserWebSocketErrorDetail,\n  ) => {\n    try {\n      options.onError?.(error, detail);\n    } catch (onErrorError) {\n      context?.reportInternalError(onErrorError, {\n        operation: \"on-error\",\n        phase: \"transport\",\n        transport: transportName,\n      });\n    }\n\n    context?.reportInternalError(error, {\n      operation: detail.operation,\n      phase: \"transport\",\n      transport: transportName,\n    });\n  };\n\n  const detachSocket = () => {\n    if (!active) return;\n    const current = active;\n    current.socket.removeEventListener(\"open\", current.onOpen);\n    current.socket.removeEventListener(\"close\", current.onClose);\n    current.socket.removeEventListener(\"error\", current.onError);\n    active = undefined;\n  };\n\n  const drainQueue = (context = lastContext) => {\n    const socket = active?.socket;\n    if (!socket || socket.readyState !== WS_OPEN) return;\n\n    while (queue.length > 0) {\n      const item = queue.shift();\n      if (!item) return;\n      try {\n        socket.send(toSendPayload(item.payload));\n      } catch (error) {\n        reportDrop(item, \"send\");\n        reportError(error, context, {\n          droppedEvents: item.events.length,\n          operation: \"send\",\n        });\n        return;\n      }\n    }\n  };\n\n  const createSocket = (context: TransportContext, droppedEvents: number) => {\n    if (closed) return undefined;\n    if (\n      active &&\n      (active.socket.readyState === WS_CONNECTING || active.socket.readyState === WS_OPEN)\n    ) {\n      return active.socket;\n    }\n\n    detachSocket();\n\n    try {\n      const socket = webSocketFactory(options.url, options.protocols);\n      const nextActive: ActiveSocket = {\n        socket,\n        onOpen() {\n          drainQueue(context);\n        },\n        onClose() {\n          if (active?.socket === socket) detachSocket();\n        },\n        onError(errorEvent) {\n          reportError(errorEvent, context, {\n            droppedEvents: 0,\n            operation: \"socket-error\",\n          });\n        },\n      };\n      active = nextActive;\n      socket.addEventListener(\"open\", nextActive.onOpen);\n      socket.addEventListener(\"close\", nextActive.onClose);\n      socket.addEventListener(\"error\", nextActive.onError);\n      return socket;\n    } catch (error) {\n      reportError(error, context, {\n        droppedEvents,\n        operation: \"create-socket\",\n      });\n      return undefined;\n    }\n  };\n\n  const enqueue = (item: QueueItem) => {\n    if (queue.length >= maxQueueSize) {\n      if (dropPolicy === \"drop-newest\") {\n        reportDrop(item, \"queue-full\");\n        return false;\n      }\n\n      const dropped = queue.shift();\n      if (dropped) reportDrop(dropped, \"queue-full\");\n    }\n\n    queue.push(item);\n    return true;\n  };\n\n  const sendOrQueue = (item: QueueItem, context: TransportContext) => {\n    lastContext = context;\n    if (closed) {\n      reportDrop(item, \"closed\");\n      return;\n    }\n\n    const socket = createSocket(context, item.events.length);\n    if (!socket) {\n      reportDrop(item, \"create-socket\");\n      return;\n    }\n\n    if (socket.readyState === WS_OPEN) {\n      try {\n        socket.send(toSendPayload(item.payload));\n      } catch (error) {\n        reportDrop(item, \"send\");\n        reportError(error, context, {\n          droppedEvents: item.events.length,\n          operation: \"send\",\n        });\n      }\n      return;\n    }\n\n    enqueue(item);\n  };\n\n  return {\n    name: transportName,\n    minLevel: options.minLevel,\n    queueSize() {\n      return queue.length;\n    },\n    log(event, context) {\n      sendOrQueue({ events: [event], payload: codec.encode(event) }, context);\n    },\n    logBatch(events, context) {\n      if (events.length === 0) return;\n      sendOrQueue({ events, payload: codec.encode(events) }, context);\n    },\n    flush() {\n      drainQueue();\n    },\n    async close() {\n      closed = true;\n      while (queue.length > 0) {\n        const item = queue.shift();\n        if (item) reportDrop(item, \"closed\");\n      }\n\n      const socket = active?.socket;\n      detachSocket();\n      if (!socket) return;\n\n      try {\n        socket.close(options.closeCode, options.closeReason);\n      } catch (error) {\n        reportError(error, lastContext, {\n          droppedEvents: 0,\n          operation: \"close-socket\",\n        });\n      }\n    },\n  };\n}\n"],"mappings":"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"}