@loggerjs/node 0.5.0 → 0.5.1

package/README.md

@@ -4,10 +4,14 @@
 
 [![npm](https://img.shields.io/npm/v/@loggerjs/node.svg)](https://www.npmjs.com/package/@loggerjs/node)
 [![license](https://img.shields.io/npm/l/@loggerjs/node)](../../LICENSE)
-[![Node](https://img.shields.io/badge/Node-%E2%89%A522.13-339933?logo=node.js&logoColor=white)](package.json)
+[![Node runtime](https://img.shields.io/badge/runtime_Node-%E2%89%A520.19-339933?logo=node.js&logoColor=white)](../../.github/workflows/ci.yml)
 
 The Node platform package for [LoggerJS](../../README.md). It re-exports the entire `@loggerjs/core` API and adds stdout/stderr/file/HTTP/syslog/worker transports, an AsyncLocalStorage context bridge, and integrations that turn process crashes, HTTP frameworks, clients, and queues into structured logs — all opt-in.
 
+`@loggerjs/node` is smoke-tested from packed packages on Node 20.19.0, 22, and
+24. The repository development toolchain uses Node >=22.13.0; that root
+requirement does not raise the published package runtime floor.
+
 ## Install
 
 ```bash

package/dist/bullmq-integration.cjs

@@ -0,0 +1,169 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loggerjs_core = require("@loggerjs/core");
+//#region src/queue-integration.ts
+const defaultMethods = [
+	"add",
+	"ack",
+	"consume",
+	"dequeue",
+	"nack",
+	"process",
+	"publish",
+	"receive",
+	"send",
+	"sendToQueue"
+];
+const defaultRandom = () => Math.random();
+function defaultLevel(_durationMs, error) {
+	return error ? "error" : "debug";
+}
+function isPromiseLike(value) {
+	return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+function defaultOperation(method) {
+	switch (method) {
+		case "add":
+		case "publish":
+		case "send":
+		case "sendToQueue": return "publish";
+		case "consume":
+		case "dequeue":
+		case "process":
+		case "receive": return "consume";
+		case "ack": return "ack";
+		case "nack": return "nack";
+		default: return "other";
+	}
+}
+function defaultPayload(args) {
+	return typeof args[0] === "string" && args.length > 1 ? args[1] : args[0];
+}
+function defaultMessageId(args) {
+	const payload = defaultPayload(args);
+	if (typeof payload !== "object" || payload === null) return void 0;
+	const value = payload.messageId ?? payload.id;
+	return value === void 0 ? void 0 : String(value);
+}
+function payloadFor(args, method, options) {
+	if (!options.capturePayload) return void 0;
+	const payload = options.getPayload?.(args, method) ?? defaultPayload(args);
+	return payload === void 0 ? void 0 : (0, _loggerjs_core.normalizeValue)(payload, {
+		maxDepth: 4,
+		maxObjectKeys: 80
+	});
+}
+function queueIntegration(options = {}) {
+	const targets = options.targets ?? (options.client ? [{
+		client: options.client,
+		name: options.name,
+		system: options.system,
+		queueName: options.queueName,
+		methods: options.methods
+	}] : []);
+	const captureAll = options.captureAll ?? options.captureSuccessful ?? false;
+	const sampleRate = options.sampleRate ?? 1;
+	const random = options.random ?? defaultRandom;
+	const levelFor = options.level ?? defaultLevel;
+	const shouldCapture = (durationMs, error) => {
+		if (error) return true;
+		if (options.minDurationMs !== void 0 && durationMs >= options.minDurationMs) return true;
+		if (!captureAll) return false;
+		return sampleRate >= 1 || random() < sampleRate;
+	};
+	return {
+		name: "queue",
+		setup(api) {
+			const capture = api.guard((input) => api.capture(input));
+			const disposers = [];
+			let disposed = false;
+			const captureResult = (info, started, args, error) => {
+				const durationMs = Date.now() - started;
+				if (disposed || !shouldCapture(durationMs, error)) return;
+				capture({
+					level: levelFor(durationMs, error, info),
+					message: error ? `Queue error ${info.operation} ${info.queueName ?? info.method}` : `Queue ${info.operation} ${info.queueName ?? info.method}`,
+					error,
+					props: { queue: {
+						kind: info.target,
+						system: info.system,
+						queueName: info.queueName,
+						method: info.method,
+						operation: info.operation,
+						durationMs,
+						messageId: options.getMessageId?.(args, info.method) ?? defaultMessageId(args),
+						payload: payloadFor(args, info.method, options)
+					} }
+				});
+			};
+			for (const target of targets) {
+				const methods = target.methods ?? options.methods ?? defaultMethods;
+				for (const method of methods) {
+					const original = target.client[method];
+					if (typeof original !== "function") continue;
+					const originalMethod = original;
+					const targetName = target.name ?? options.name ?? "queue";
+					const system = target.system ?? options.system;
+					target.client[method] = function wrappedQueueMethod(...args) {
+						const started = Date.now();
+						const operation = options.getOperation?.(method, args) ?? defaultOperation(method);
+						const info = {
+							target: targetName,
+							system,
+							queueName: options.getQueueName?.(args, method) ?? target.queueName ?? options.queueName ?? (typeof args[0] === "string" ? args[0] : void 0),
+							method,
+							operation
+						};
+						try {
+							const result = originalMethod.apply(this, args);
+							if (isPromiseLike(result)) return result.then((value) => {
+								captureResult(info, started, args, void 0);
+								return value;
+							}, (error) => {
+								captureResult(info, started, args, error);
+								throw error;
+							});
+							captureResult(info, started, args, void 0);
+							return result;
+						} catch (error) {
+							captureResult(info, started, args, error);
+							throw error;
+						}
+					};
+					disposers.push(() => {
+						target.client[method] = originalMethod;
+					});
+				}
+			}
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const dispose of disposers) dispose();
+			};
+		}
+	};
+}
+//#endregion
+//#region src/bullmq-integration.ts
+const bullMqMethods = [
+	"add",
+	"addBulk",
+	"process"
+];
+function queueName(args, fallback) {
+	const first = args[0];
+	return typeof first === "string" ? first : fallback;
+}
+function bullMqIntegration(options) {
+	return queueIntegration({
+		...options,
+		name: options.name ?? "bullmq",
+		system: "bullmq",
+		methods: options.methods ?? bullMqMethods,
+		queueName: options.queueName ?? options.client.name,
+		getQueueName: (args) => queueName(args, options.queueName ?? options.client.name)
+	});
+}
+//#endregion
+exports.bullMqIntegration = bullMqIntegration;
+
+//# sourceMappingURL=bullmq-integration.cjs.map

package/dist/bullmq-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq-integration.cjs","names":[],"sources":["../src/queue-integration.ts","../src/bullmq-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type CaptureInput,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport type QueueOperation = \"publish\" | \"consume\" | \"ack\" | \"nack\" | \"other\";\n\nexport interface QueueClientLike {\n  [method: string]: unknown;\n}\n\nexport interface QueueIntegrationTarget {\n  client: QueueClientLike;\n  name?: string;\n  system?: string;\n  queueName?: string;\n  methods?: readonly string[];\n}\n\nexport interface QueueOperationInfo {\n  target: string;\n  system?: string;\n  queueName?: string;\n  method: string;\n  operation: QueueOperation;\n}\n\nexport interface QueueIntegrationOptions {\n  client?: QueueClientLike;\n  targets?: readonly QueueIntegrationTarget[];\n  name?: string;\n  system?: string;\n  queueName?: string;\n  methods?: readonly string[];\n  captureAll?: boolean;\n  captureSuccessful?: boolean;\n  minDurationMs?: number;\n  sampleRate?: number;\n  random?: () => number;\n  capturePayload?: boolean;\n  getOperation?: (method: string, args: readonly unknown[]) => QueueOperation;\n  getQueueName?: (args: readonly unknown[], method: string) => string | undefined;\n  getMessageId?: (args: readonly unknown[], method: string) => string | undefined;\n  getPayload?: (args: readonly unknown[], method: string) => unknown;\n  level?: (durationMs: number, error: unknown, info: QueueOperationInfo) => LoggerLevel;\n}\n\ntype QueueMethod = (this: unknown, ...args: unknown[]) => unknown;\n\nconst defaultMethods = [\n  \"add\",\n  \"ack\",\n  \"consume\",\n  \"dequeue\",\n  \"nack\",\n  \"process\",\n  \"publish\",\n  \"receive\",\n  \"send\",\n  \"sendToQueue\",\n] as const;\nconst defaultRandom = () => Math.random();\n\nfunction defaultLevel(_durationMs: number, error: unknown): LoggerLevel {\n  return error ? \"error\" : \"debug\";\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === \"function\"\n  );\n}\n\nfunction defaultOperation(method: string): QueueOperation {\n  switch (method) {\n    case \"add\":\n    case \"publish\":\n    case \"send\":\n    case \"sendToQueue\":\n      return \"publish\";\n    case \"consume\":\n    case \"dequeue\":\n    case \"process\":\n    case \"receive\":\n      return \"consume\";\n    case \"ack\":\n      return \"ack\";\n    case \"nack\":\n      return \"nack\";\n    default:\n      return \"other\";\n  }\n}\n\nfunction defaultPayload(args: readonly unknown[]) {\n  return typeof args[0] === \"string\" && args.length > 1 ? args[1] : args[0];\n}\n\nfunction defaultMessageId(args: readonly unknown[]) {\n  const payload = defaultPayload(args);\n  if (typeof payload !== \"object\" || payload === null) return undefined;\n  const value =\n    (payload as { id?: unknown; messageId?: unknown }).messageId ??\n    (payload as { id?: unknown }).id;\n  return value === undefined ? undefined : String(value);\n}\n\nfunction payloadFor(args: readonly unknown[], method: string, options: QueueIntegrationOptions) {\n  if (!options.capturePayload) return undefined;\n  const payload = options.getPayload?.(args, method) ?? defaultPayload(args);\n  return payload === undefined\n    ? undefined\n    : normalizeValue(payload, { maxDepth: 4, maxObjectKeys: 80 });\n}\n\nexport function queueIntegration(options: QueueIntegrationOptions = {}): Integration {\n  const targets =\n    options.targets ??\n    (options.client\n      ? [\n          {\n            client: options.client,\n            name: options.name,\n            system: options.system,\n            queueName: options.queueName,\n            methods: options.methods,\n          },\n        ]\n      : []);\n  const captureAll = options.captureAll ?? options.captureSuccessful ?? false;\n  const sampleRate = options.sampleRate ?? 1;\n  const random = options.random ?? defaultRandom;\n  const levelFor = options.level ?? defaultLevel;\n\n  const shouldCapture = (durationMs: number, error: unknown) => {\n    if (error) return true;\n    if (options.minDurationMs !== undefined && durationMs >= options.minDurationMs) return true;\n    if (!captureAll) return false;\n    return sampleRate >= 1 || random() < sampleRate;\n  };\n\n  return {\n    name: \"queue\",\n    setup(api: IntegrationSetupContext) {\n      const capture = api.guard((input: CaptureInput) => api.capture(input));\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const captureResult = (\n        info: QueueOperationInfo,\n        started: number,\n        args: readonly unknown[],\n        error: unknown,\n      ) => {\n        const durationMs = Date.now() - started;\n        if (disposed || !shouldCapture(durationMs, error)) return;\n        capture({\n          level: levelFor(durationMs, error, info),\n          message: error\n            ? `Queue error ${info.operation} ${info.queueName ?? info.method}`\n            : `Queue ${info.operation} ${info.queueName ?? info.method}`,\n          error,\n          props: {\n            queue: {\n              kind: info.target,\n              system: info.system,\n              queueName: info.queueName,\n              method: info.method,\n              operation: info.operation,\n              durationMs,\n              messageId: options.getMessageId?.(args, info.method) ?? defaultMessageId(args),\n              payload: payloadFor(args, info.method, options),\n            },\n          },\n        });\n      };\n\n      for (const target of targets) {\n        const methods = target.methods ?? options.methods ?? defaultMethods;\n        for (const method of methods) {\n          const original = target.client[method];\n          if (typeof original !== \"function\") continue;\n          const originalMethod = original as QueueMethod;\n          const targetName = target.name ?? options.name ?? \"queue\";\n          const system = target.system ?? options.system;\n\n          target.client[method] = function wrappedQueueMethod(this: unknown, ...args: unknown[]) {\n            const started = Date.now();\n            const operation = options.getOperation?.(method, args) ?? defaultOperation(method);\n            const info: QueueOperationInfo = {\n              target: targetName,\n              system,\n              queueName:\n                options.getQueueName?.(args, method) ??\n                target.queueName ??\n                options.queueName ??\n                (typeof args[0] === \"string\" ? args[0] : undefined),\n              method,\n              operation,\n            };\n            try {\n              const result = originalMethod.apply(this, args);\n              if (isPromiseLike(result)) {\n                return result.then(\n                  (value) => {\n                    captureResult(info, started, args, undefined);\n                    return value;\n                  },\n                  (error) => {\n                    captureResult(info, started, args, error);\n                    throw error;\n                  },\n                );\n              }\n              captureResult(info, started, args, undefined);\n              return result;\n            } catch (error) {\n              captureResult(info, started, args, error);\n              throw error;\n            }\n          };\n\n          disposers.push(() => {\n            target.client[method] = originalMethod;\n          });\n        }\n      }\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        for (const dispose of disposers) dispose();\n      };\n    },\n  };\n}\n","import {\n  queueIntegration,\n  type QueueClientLike,\n  type QueueIntegrationOptions,\n} from \"./queue-integration\";\n\nexport interface BullMqIntegrationOptions extends Omit<\n  QueueIntegrationOptions,\n  \"client\" | \"system\" | \"methods\" | \"getQueueName\"\n> {\n  client: QueueClientLike & { name?: string };\n  methods?: readonly string[];\n}\n\nconst bullMqMethods = [\"add\", \"addBulk\", \"process\"] as const;\n\nfunction queueName(args: readonly unknown[], fallback: string | undefined) {\n  const first = args[0];\n  return typeof first === \"string\" ? first : fallback;\n}\n\nexport function bullMqIntegration(options: BullMqIntegrationOptions) {\n  return queueIntegration({\n    ...options,\n    name: options.name ?? \"bullmq\",\n    system: \"bullmq\",\n    methods: options.methods ?? bullMqMethods,\n    queueName: options.queueName ?? options.client.name,\n    getQueueName: (args) => queueName(args, options.queueName ?? options.client.name),\n  });\n}\n"],"mappings":"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"}

package/dist/bullmq-integration.js

@@ -0,0 +1,168 @@
+import { normalizeValue } from "@loggerjs/core";
+//#region src/queue-integration.ts
+const defaultMethods = [
+	"add",
+	"ack",
+	"consume",
+	"dequeue",
+	"nack",
+	"process",
+	"publish",
+	"receive",
+	"send",
+	"sendToQueue"
+];
+const defaultRandom = () => Math.random();
+function defaultLevel(_durationMs, error) {
+	return error ? "error" : "debug";
+}
+function isPromiseLike(value) {
+	return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+function defaultOperation(method) {
+	switch (method) {
+		case "add":
+		case "publish":
+		case "send":
+		case "sendToQueue": return "publish";
+		case "consume":
+		case "dequeue":
+		case "process":
+		case "receive": return "consume";
+		case "ack": return "ack";
+		case "nack": return "nack";
+		default: return "other";
+	}
+}
+function defaultPayload(args) {
+	return typeof args[0] === "string" && args.length > 1 ? args[1] : args[0];
+}
+function defaultMessageId(args) {
+	const payload = defaultPayload(args);
+	if (typeof payload !== "object" || payload === null) return void 0;
+	const value = payload.messageId ?? payload.id;
+	return value === void 0 ? void 0 : String(value);
+}
+function payloadFor(args, method, options) {
+	if (!options.capturePayload) return void 0;
+	const payload = options.getPayload?.(args, method) ?? defaultPayload(args);
+	return payload === void 0 ? void 0 : normalizeValue(payload, {
+		maxDepth: 4,
+		maxObjectKeys: 80
+	});
+}
+function queueIntegration(options = {}) {
+	const targets = options.targets ?? (options.client ? [{
+		client: options.client,
+		name: options.name,
+		system: options.system,
+		queueName: options.queueName,
+		methods: options.methods
+	}] : []);
+	const captureAll = options.captureAll ?? options.captureSuccessful ?? false;
+	const sampleRate = options.sampleRate ?? 1;
+	const random = options.random ?? defaultRandom;
+	const levelFor = options.level ?? defaultLevel;
+	const shouldCapture = (durationMs, error) => {
+		if (error) return true;
+		if (options.minDurationMs !== void 0 && durationMs >= options.minDurationMs) return true;
+		if (!captureAll) return false;
+		return sampleRate >= 1 || random() < sampleRate;
+	};
+	return {
+		name: "queue",
+		setup(api) {
+			const capture = api.guard((input) => api.capture(input));
+			const disposers = [];
+			let disposed = false;
+			const captureResult = (info, started, args, error) => {
+				const durationMs = Date.now() - started;
+				if (disposed || !shouldCapture(durationMs, error)) return;
+				capture({
+					level: levelFor(durationMs, error, info),
+					message: error ? `Queue error ${info.operation} ${info.queueName ?? info.method}` : `Queue ${info.operation} ${info.queueName ?? info.method}`,
+					error,
+					props: { queue: {
+						kind: info.target,
+						system: info.system,
+						queueName: info.queueName,
+						method: info.method,
+						operation: info.operation,
+						durationMs,
+						messageId: options.getMessageId?.(args, info.method) ?? defaultMessageId(args),
+						payload: payloadFor(args, info.method, options)
+					} }
+				});
+			};
+			for (const target of targets) {
+				const methods = target.methods ?? options.methods ?? defaultMethods;
+				for (const method of methods) {
+					const original = target.client[method];
+					if (typeof original !== "function") continue;
+					const originalMethod = original;
+					const targetName = target.name ?? options.name ?? "queue";
+					const system = target.system ?? options.system;
+					target.client[method] = function wrappedQueueMethod(...args) {
+						const started = Date.now();
+						const operation = options.getOperation?.(method, args) ?? defaultOperation(method);
+						const info = {
+							target: targetName,
+							system,
+							queueName: options.getQueueName?.(args, method) ?? target.queueName ?? options.queueName ?? (typeof args[0] === "string" ? args[0] : void 0),
+							method,
+							operation
+						};
+						try {
+							const result = originalMethod.apply(this, args);
+							if (isPromiseLike(result)) return result.then((value) => {
+								captureResult(info, started, args, void 0);
+								return value;
+							}, (error) => {
+								captureResult(info, started, args, error);
+								throw error;
+							});
+							captureResult(info, started, args, void 0);
+							return result;
+						} catch (error) {
+							captureResult(info, started, args, error);
+							throw error;
+						}
+					};
+					disposers.push(() => {
+						target.client[method] = originalMethod;
+					});
+				}
+			}
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const dispose of disposers) dispose();
+			};
+		}
+	};
+}
+//#endregion
+//#region src/bullmq-integration.ts
+const bullMqMethods = [
+	"add",
+	"addBulk",
+	"process"
+];
+function queueName(args, fallback) {
+	const first = args[0];
+	return typeof first === "string" ? first : fallback;
+}
+function bullMqIntegration(options) {
+	return queueIntegration({
+		...options,
+		name: options.name ?? "bullmq",
+		system: "bullmq",
+		methods: options.methods ?? bullMqMethods,
+		queueName: options.queueName ?? options.client.name,
+		getQueueName: (args) => queueName(args, options.queueName ?? options.client.name)
+	});
+}
+//#endregion
+export { bullMqIntegration };
+
+//# sourceMappingURL=bullmq-integration.js.map

package/dist/bullmq-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq-integration.js","names":[],"sources":["../src/queue-integration.ts","../src/bullmq-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type CaptureInput,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport type QueueOperation = \"publish\" | \"consume\" | \"ack\" | \"nack\" | \"other\";\n\nexport interface QueueClientLike {\n  [method: string]: unknown;\n}\n\nexport interface QueueIntegrationTarget {\n  client: QueueClientLike;\n  name?: string;\n  system?: string;\n  queueName?: string;\n  methods?: readonly string[];\n}\n\nexport interface QueueOperationInfo {\n  target: string;\n  system?: string;\n  queueName?: string;\n  method: string;\n  operation: QueueOperation;\n}\n\nexport interface QueueIntegrationOptions {\n  client?: QueueClientLike;\n  targets?: readonly QueueIntegrationTarget[];\n  name?: string;\n  system?: string;\n  queueName?: string;\n  methods?: readonly string[];\n  captureAll?: boolean;\n  captureSuccessful?: boolean;\n  minDurationMs?: number;\n  sampleRate?: number;\n  random?: () => number;\n  capturePayload?: boolean;\n  getOperation?: (method: string, args: readonly unknown[]) => QueueOperation;\n  getQueueName?: (args: readonly unknown[], method: string) => string | undefined;\n  getMessageId?: (args: readonly unknown[], method: string) => string | undefined;\n  getPayload?: (args: readonly unknown[], method: string) => unknown;\n  level?: (durationMs: number, error: unknown, info: QueueOperationInfo) => LoggerLevel;\n}\n\ntype QueueMethod = (this: unknown, ...args: unknown[]) => unknown;\n\nconst defaultMethods = [\n  \"add\",\n  \"ack\",\n  \"consume\",\n  \"dequeue\",\n  \"nack\",\n  \"process\",\n  \"publish\",\n  \"receive\",\n  \"send\",\n  \"sendToQueue\",\n] as const;\nconst defaultRandom = () => Math.random();\n\nfunction defaultLevel(_durationMs: number, error: unknown): LoggerLevel {\n  return error ? \"error\" : \"debug\";\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === \"function\"\n  );\n}\n\nfunction defaultOperation(method: string): QueueOperation {\n  switch (method) {\n    case \"add\":\n    case \"publish\":\n    case \"send\":\n    case \"sendToQueue\":\n      return \"publish\";\n    case \"consume\":\n    case \"dequeue\":\n    case \"process\":\n    case \"receive\":\n      return \"consume\";\n    case \"ack\":\n      return \"ack\";\n    case \"nack\":\n      return \"nack\";\n    default:\n      return \"other\";\n  }\n}\n\nfunction defaultPayload(args: readonly unknown[]) {\n  return typeof args[0] === \"string\" && args.length > 1 ? args[1] : args[0];\n}\n\nfunction defaultMessageId(args: readonly unknown[]) {\n  const payload = defaultPayload(args);\n  if (typeof payload !== \"object\" || payload === null) return undefined;\n  const value =\n    (payload as { id?: unknown; messageId?: unknown }).messageId ??\n    (payload as { id?: unknown }).id;\n  return value === undefined ? undefined : String(value);\n}\n\nfunction payloadFor(args: readonly unknown[], method: string, options: QueueIntegrationOptions) {\n  if (!options.capturePayload) return undefined;\n  const payload = options.getPayload?.(args, method) ?? defaultPayload(args);\n  return payload === undefined\n    ? undefined\n    : normalizeValue(payload, { maxDepth: 4, maxObjectKeys: 80 });\n}\n\nexport function queueIntegration(options: QueueIntegrationOptions = {}): Integration {\n  const targets =\n    options.targets ??\n    (options.client\n      ? [\n          {\n            client: options.client,\n            name: options.name,\n            system: options.system,\n            queueName: options.queueName,\n            methods: options.methods,\n          },\n        ]\n      : []);\n  const captureAll = options.captureAll ?? options.captureSuccessful ?? false;\n  const sampleRate = options.sampleRate ?? 1;\n  const random = options.random ?? defaultRandom;\n  const levelFor = options.level ?? defaultLevel;\n\n  const shouldCapture = (durationMs: number, error: unknown) => {\n    if (error) return true;\n    if (options.minDurationMs !== undefined && durationMs >= options.minDurationMs) return true;\n    if (!captureAll) return false;\n    return sampleRate >= 1 || random() < sampleRate;\n  };\n\n  return {\n    name: \"queue\",\n    setup(api: IntegrationSetupContext) {\n      const capture = api.guard((input: CaptureInput) => api.capture(input));\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const captureResult = (\n        info: QueueOperationInfo,\n        started: number,\n        args: readonly unknown[],\n        error: unknown,\n      ) => {\n        const durationMs = Date.now() - started;\n        if (disposed || !shouldCapture(durationMs, error)) return;\n        capture({\n          level: levelFor(durationMs, error, info),\n          message: error\n            ? `Queue error ${info.operation} ${info.queueName ?? info.method}`\n            : `Queue ${info.operation} ${info.queueName ?? info.method}`,\n          error,\n          props: {\n            queue: {\n              kind: info.target,\n              system: info.system,\n              queueName: info.queueName,\n              method: info.method,\n              operation: info.operation,\n              durationMs,\n              messageId: options.getMessageId?.(args, info.method) ?? defaultMessageId(args),\n              payload: payloadFor(args, info.method, options),\n            },\n          },\n        });\n      };\n\n      for (const target of targets) {\n        const methods = target.methods ?? options.methods ?? defaultMethods;\n        for (const method of methods) {\n          const original = target.client[method];\n          if (typeof original !== \"function\") continue;\n          const originalMethod = original as QueueMethod;\n          const targetName = target.name ?? options.name ?? \"queue\";\n          const system = target.system ?? options.system;\n\n          target.client[method] = function wrappedQueueMethod(this: unknown, ...args: unknown[]) {\n            const started = Date.now();\n            const operation = options.getOperation?.(method, args) ?? defaultOperation(method);\n            const info: QueueOperationInfo = {\n              target: targetName,\n              system,\n              queueName:\n                options.getQueueName?.(args, method) ??\n                target.queueName ??\n                options.queueName ??\n                (typeof args[0] === \"string\" ? args[0] : undefined),\n              method,\n              operation,\n            };\n            try {\n              const result = originalMethod.apply(this, args);\n              if (isPromiseLike(result)) {\n                return result.then(\n                  (value) => {\n                    captureResult(info, started, args, undefined);\n                    return value;\n                  },\n                  (error) => {\n                    captureResult(info, started, args, error);\n                    throw error;\n                  },\n                );\n              }\n              captureResult(info, started, args, undefined);\n              return result;\n            } catch (error) {\n              captureResult(info, started, args, error);\n              throw error;\n            }\n          };\n\n          disposers.push(() => {\n            target.client[method] = originalMethod;\n          });\n        }\n      }\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        for (const dispose of disposers) dispose();\n      };\n    },\n  };\n}\n","import {\n  queueIntegration,\n  type QueueClientLike,\n  type QueueIntegrationOptions,\n} from \"./queue-integration\";\n\nexport interface BullMqIntegrationOptions extends Omit<\n  QueueIntegrationOptions,\n  \"client\" | \"system\" | \"methods\" | \"getQueueName\"\n> {\n  client: QueueClientLike & { name?: string };\n  methods?: readonly string[];\n}\n\nconst bullMqMethods = [\"add\", \"addBulk\", \"process\"] as const;\n\nfunction queueName(args: readonly unknown[], fallback: string | undefined) {\n  const first = args[0];\n  return typeof first === \"string\" ? first : fallback;\n}\n\nexport function bullMqIntegration(options: BullMqIntegrationOptions) {\n  return queueIntegration({\n    ...options,\n    name: options.name ?? \"bullmq\",\n    system: \"bullmq\",\n    methods: options.methods ?? bullMqMethods,\n    queueName: options.queueName ?? options.client.name,\n    getQueueName: (args) => queueName(args, options.queueName ?? options.client.name),\n  });\n}\n"],"mappings":";;AAoDA,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AACA,MAAM,sBAAsB,KAAK,OAAO;AAExC,SAAS,aAAa,aAAqB,OAA6B;CACtE,OAAO,QAAQ,UAAU;AAC3B;AAEA,SAAS,cAAc,OAA+C;CACpE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAA6B,SAAS;AAElD;AAEA,SAAS,iBAAiB,QAAgC;CACxD,QAAQ,QAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,eACH,OAAO;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,WACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAEA,SAAS,eAAe,MAA0B;CAChD,OAAO,OAAO,KAAK,OAAO,YAAY,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;AACzE;AAEA,SAAS,iBAAiB,MAA0B;CAClD,MAAM,UAAU,eAAe,IAAI;CACnC,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO,KAAA;CAC5D,MAAM,QACH,QAAkD,aAClD,QAA6B;CAChC,OAAO,UAAU,KAAA,IAAY,KAAA,IAAY,OAAO,KAAK;AACvD;AAEA,SAAS,WAAW,MAA0B,QAAgB,SAAkC;CAC9F,IAAI,CAAC,QAAQ,gBAAgB,OAAO,KAAA;CACpC,MAAM,UAAU,QAAQ,aAAa,MAAM,MAAM,KAAK,eAAe,IAAI;CACzE,OAAO,YAAY,KAAA,IACf,KAAA,IACA,eAAe,SAAS;EAAE,UAAU;EAAG,eAAe;CAAG,CAAC;AAChE;AAEA,SAAgB,iBAAiB,UAAmC,CAAC,GAAgB;CACnF,MAAM,UACJ,QAAQ,YACP,QAAQ,SACL,CACE;EACE,QAAQ,QAAQ;EAChB,MAAM,QAAQ;EACd,QAAQ,QAAQ;EAChB,WAAW,QAAQ;EACnB,SAAS,QAAQ;CACnB,CACF,IACA,CAAC;CACP,MAAM,aAAa,QAAQ,cAAc,QAAQ,qBAAqB;CACtE,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,WAAW,QAAQ,SAAS;CAElC,MAAM,iBAAiB,YAAoB,UAAmB;EAC5D,IAAI,OAAO,OAAO;EAClB,IAAI,QAAQ,kBAAkB,KAAA,KAAa,cAAc,QAAQ,eAAe,OAAO;EACvF,IAAI,CAAC,YAAY,OAAO;EACxB,OAAO,cAAc,KAAK,OAAO,IAAI;CACvC;CAEA,OAAO;EACL,MAAM;EACN,MAAM,KAA8B;GAClC,MAAM,UAAU,IAAI,OAAO,UAAwB,IAAI,QAAQ,KAAK,CAAC;GACrE,MAAM,YAA+B,CAAC;GACtC,IAAI,WAAW;GAEf,MAAM,iBACJ,MACA,SACA,MACA,UACG;IACH,MAAM,aAAa,KAAK,IAAI,IAAI;IAChC,IAAI,YAAY,CAAC,cAAc,YAAY,KAAK,GAAG;IACnD,QAAQ;KACN,OAAO,SAAS,YAAY,OAAO,IAAI;KACvC,SAAS,QACL,eAAe,KAAK,UAAU,GAAG,KAAK,aAAa,KAAK,WACxD,SAAS,KAAK,UAAU,GAAG,KAAK,aAAa,KAAK;KACtD;KACA,OAAO,EACL,OAAO;MACL,MAAM,KAAK;MACX,QAAQ,KAAK;MACb,WAAW,KAAK;MAChB,QAAQ,KAAK;MACb,WAAW,KAAK;MAChB;MACA,WAAW,QAAQ,eAAe,MAAM,KAAK,MAAM,KAAK,iBAAiB,IAAI;MAC7E,SAAS,WAAW,MAAM,KAAK,QAAQ,OAAO;KAChD,EACF;IACF,CAAC;GACH;GAEA,KAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,UAAU,OAAO,WAAW,QAAQ,WAAW;IACrD,KAAK,MAAM,UAAU,SAAS;KAC5B,MAAM,WAAW,OAAO,OAAO;KAC/B,IAAI,OAAO,aAAa,YAAY;KACpC,MAAM,iBAAiB;KACvB,MAAM,aAAa,OAAO,QAAQ,QAAQ,QAAQ;KAClD,MAAM,SAAS,OAAO,UAAU,QAAQ;KAExC,OAAO,OAAO,UAAU,SAAS,mBAAkC,GAAG,MAAiB;MACrF,MAAM,UAAU,KAAK,IAAI;MACzB,MAAM,YAAY,QAAQ,eAAe,QAAQ,IAAI,KAAK,iBAAiB,MAAM;MACjF,MAAM,OAA2B;OAC/B,QAAQ;OACR;OACA,WACE,QAAQ,eAAe,MAAM,MAAM,KACnC,OAAO,aACP,QAAQ,cACP,OAAO,KAAK,OAAO,WAAW,KAAK,KAAK,KAAA;OAC3C;OACA;MACF;MACA,IAAI;OACF,MAAM,SAAS,eAAe,MAAM,MAAM,IAAI;OAC9C,IAAI,cAAc,MAAM,GACtB,OAAO,OAAO,MACX,UAAU;QACT,cAAc,MAAM,SAAS,MAAM,KAAA,CAAS;QAC5C,OAAO;OACT,IACC,UAAU;QACT,cAAc,MAAM,SAAS,MAAM,KAAK;QACxC,MAAM;OACR,CACF;OAEF,cAAc,MAAM,SAAS,MAAM,KAAA,CAAS;OAC5C,OAAO;MACT,SAAS,OAAO;OACd,cAAc,MAAM,SAAS,MAAM,KAAK;OACxC,MAAM;MACR;KACF;KAEA,UAAU,WAAW;MACnB,OAAO,OAAO,UAAU;KAC1B,CAAC;IACH;GACF;GAEA,aAAa;IACX,IAAI,UAAU;IACd,WAAW;IACX,KAAK,MAAM,WAAW,WAAW,QAAQ;GAC3C;EACF;CACF;AACF;;;AClOA,MAAM,gBAAgB;CAAC;CAAO;CAAW;AAAS;AAElD,SAAS,UAAU,MAA0B,UAA8B;CACzE,MAAM,QAAQ,KAAK;CACnB,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,iBAAiB;EACtB,GAAG;EACH,MAAM,QAAQ,QAAQ;EACtB,QAAQ;EACR,SAAS,QAAQ,WAAW;EAC5B,WAAW,QAAQ,aAAa,QAAQ,OAAO;EAC/C,eAAe,SAAS,UAAU,MAAM,QAAQ,aAAa,QAAQ,OAAO,IAAI;CAClF,CAAC;AACH"}

package/dist/cli-integration.cjs

@@ -0,0 +1,116 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/cli-integration.ts
+const defaultSignals = ["SIGINT", "SIGTERM"];
+function defaultProcess() {
+	return globalThis.process;
+}
+function defaultSanitizeArg(arg) {
+	if (/^(--?[^=\s]*(token|password|passwd|secret|key)[^=\s]*=)/i.test(arg)) return arg.replace(/=.*/, "=[redacted]");
+	return arg;
+}
+function defaultCommand(argv) {
+	return argv[1] ?? argv[0];
+}
+function levelFor(level, event, code) {
+	if (typeof level === "function") return level(event, code);
+	if (level) return level;
+	if (event === "signal") return "warn";
+	if (event === "exit" && Number(code ?? 0) !== 0) return "error";
+	return "info";
+}
+function pickEnv(env, names) {
+	if (!env || !names || names.length === 0) return void 0;
+	const out = {};
+	for (const name of names) {
+		const value = env[name];
+		if (value !== void 0) out[name] = value;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+function removeListener(processLike, event, listener) {
+	if (processLike.off) {
+		processLike.off(event, listener);
+		return;
+	}
+	processLike.removeListener?.(event, listener);
+}
+function captureCliIntegration(options = {}) {
+	const name = options.name ?? "cli";
+	const captureStart = options.captureStart ?? true;
+	const captureExit = options.captureExit ?? true;
+	const captureSignals = options.captureSignals ?? true;
+	const captureCwd = options.captureCwd ?? true;
+	const signals = options.signals ?? defaultSignals;
+	const sanitizeArg = options.sanitizeArg ?? defaultSanitizeArg;
+	const commandFor = options.getCommand ?? defaultCommand;
+	return {
+		name: "capture-cli",
+		setup(api) {
+			const processLike = options.process ?? defaultProcess();
+			if (!processLike) return;
+			const argv = processLike.argv ?? [];
+			const command = commandFor(argv);
+			const sanitizedArgv = argv.map((arg, index) => sanitizeArg(arg, index, argv));
+			const disposers = [];
+			let disposed = false;
+			const capture = api.guard((input) => {
+				if (!disposed) api.capture(input);
+			});
+			const cliBase = {
+				kind: name,
+				command,
+				argv: sanitizedArgv,
+				cwd: captureCwd ? processLike.cwd?.() : void 0,
+				env: pickEnv(processLike.env, options.captureEnv)
+			};
+			if (captureStart) capture({
+				level: levelFor(options.level, "start"),
+				message: `CLI start${command ? ` ${command}` : ""}`,
+				props: { cli: {
+					...cliBase,
+					lifecycle: "start"
+				} }
+			});
+			if (captureExit && processLike.on) {
+				const onExit = (code) => {
+					const exitCode = code ?? processLike.exitCode ?? 0;
+					capture({
+						level: levelFor(options.level, "exit", exitCode),
+						message: `CLI exit ${String(exitCode)}`,
+						props: { cli: {
+							...cliBase,
+							lifecycle: "exit",
+							exitCode
+						} }
+					});
+				};
+				processLike.on("exit", onExit);
+				disposers.push(() => removeListener(processLike, "exit", onExit));
+			}
+			if (captureSignals && processLike.on) for (const signal of signals) {
+				const onSignal = () => {
+					capture({
+						level: levelFor(options.level, "signal", signal),
+						message: `CLI signal ${signal}`,
+						props: { cli: {
+							...cliBase,
+							lifecycle: "signal",
+							signal
+						} }
+					});
+				};
+				processLike.on(signal, onSignal);
+				disposers.push(() => removeListener(processLike, signal, onSignal));
+			}
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const dispose of disposers) dispose();
+			};
+		}
+	};
+}
+//#endregion
+exports.captureCliIntegration = captureCliIntegration;
+
+//# sourceMappingURL=cli-integration.cjs.map

package/dist/cli-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-integration.cjs","names":[],"sources":["../src/cli-integration.ts"],"sourcesContent":["import {\n  type CaptureInput,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface CliProcessLike {\n  argv?: readonly string[];\n  env?: Record<string, string | undefined>;\n  exitCode?: number | string | null;\n  cwd?: () => string;\n  on?: (event: string, listener: (...args: unknown[]) => void) => unknown;\n  off?: (event: string, listener: (...args: unknown[]) => void) => unknown;\n  removeListener?: (event: string, listener: (...args: unknown[]) => void) => unknown;\n}\n\nexport interface CaptureCliOptions {\n  name?: string;\n  process?: CliProcessLike;\n  captureStart?: boolean;\n  captureExit?: boolean;\n  captureSignals?: boolean;\n  captureCwd?: boolean;\n  captureEnv?: readonly string[];\n  signals?: readonly string[];\n  level?:\n    | LoggerLevel\n    | ((event: \"start\" | \"exit\" | \"signal\", code?: number | string) => LoggerLevel);\n  getCommand?: (argv: readonly string[]) => string | undefined;\n  sanitizeArg?: (arg: string, index: number, argv: readonly string[]) => string;\n}\n\nconst defaultSignals = [\"SIGINT\", \"SIGTERM\"] as const;\n\nfunction defaultProcess(): CliProcessLike | undefined {\n  return (globalThis as unknown as { process?: CliProcessLike }).process;\n}\n\nfunction defaultSanitizeArg(arg: string) {\n  if (/^(--?[^=\\s]*(token|password|passwd|secret|key)[^=\\s]*=)/i.test(arg)) {\n    return arg.replace(/=.*/, \"=[redacted]\");\n  }\n  return arg;\n}\n\nfunction defaultCommand(argv: readonly string[]): string | undefined {\n  return argv[1] ?? argv[0];\n}\n\nfunction levelFor(\n  level: CaptureCliOptions[\"level\"],\n  event: \"start\" | \"exit\" | \"signal\",\n  code?: number | string,\n): LoggerLevel {\n  if (typeof level === \"function\") return level(event, code);\n  if (level) return level;\n  if (event === \"signal\") return \"warn\";\n  if (event === \"exit\" && Number(code ?? 0) !== 0) return \"error\";\n  return \"info\";\n}\n\nfunction pickEnv(\n  env: Record<string, string | undefined> | undefined,\n  names: readonly string[] | undefined,\n) {\n  if (!env || !names || names.length === 0) return undefined;\n  const out: Record<string, string> = {};\n  for (const name of names) {\n    const value = env[name];\n    if (value !== undefined) out[name] = value;\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nfunction removeListener(\n  processLike: CliProcessLike,\n  event: string,\n  listener: (...args: unknown[]) => void,\n) {\n  if (processLike.off) {\n    processLike.off(event, listener);\n    return;\n  }\n  processLike.removeListener?.(event, listener);\n}\n\nexport function captureCliIntegration(options: CaptureCliOptions = {}): Integration {\n  const name = options.name ?? \"cli\";\n  const captureStart = options.captureStart ?? true;\n  const captureExit = options.captureExit ?? true;\n  const captureSignals = options.captureSignals ?? true;\n  const captureCwd = options.captureCwd ?? true;\n  const signals = options.signals ?? defaultSignals;\n  const sanitizeArg = options.sanitizeArg ?? defaultSanitizeArg;\n  const commandFor = options.getCommand ?? defaultCommand;\n\n  return {\n    name: \"capture-cli\",\n    setup(api: IntegrationSetupContext) {\n      const processLike = options.process ?? defaultProcess();\n      if (!processLike) return;\n      const argv = processLike.argv ?? [];\n      const command = commandFor(argv);\n      const sanitizedArgv = argv.map((arg, index) => sanitizeArg(arg, index, argv));\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const capture = api.guard((input: CaptureInput) => {\n        if (!disposed) api.capture(input);\n      });\n      const cliBase = {\n        kind: name,\n        command,\n        argv: sanitizedArgv,\n        cwd: captureCwd ? processLike.cwd?.() : undefined,\n        env: pickEnv(processLike.env, options.captureEnv),\n      };\n\n      if (captureStart) {\n        capture({\n          level: levelFor(options.level, \"start\"),\n          message: `CLI start${command ? ` ${command}` : \"\"}`,\n          props: {\n            cli: {\n              ...cliBase,\n              lifecycle: \"start\",\n            },\n          },\n        });\n      }\n\n      if (captureExit && processLike.on) {\n        const onExit = (code: unknown) => {\n          const exitCode = code ?? processLike.exitCode ?? 0;\n          capture({\n            level: levelFor(options.level, \"exit\", exitCode as number | string),\n            message: `CLI exit ${String(exitCode)}`,\n            props: {\n              cli: {\n                ...cliBase,\n                lifecycle: \"exit\",\n                exitCode,\n              },\n            },\n          });\n        };\n        processLike.on(\"exit\", onExit);\n        disposers.push(() => removeListener(processLike, \"exit\", onExit));\n      }\n\n      if (captureSignals && processLike.on) {\n        for (const signal of signals) {\n          const onSignal = () => {\n            capture({\n              level: levelFor(options.level, \"signal\", signal),\n              message: `CLI signal ${signal}`,\n              props: {\n                cli: {\n                  ...cliBase,\n                  lifecycle: \"signal\",\n                  signal,\n                },\n              },\n            });\n          };\n          processLike.on(signal, onSignal);\n          disposers.push(() => removeListener(processLike, signal, onSignal));\n        }\n      }\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        for (const dispose of disposers) dispose();\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/cli-integration.js

@@ -0,0 +1,115 @@
+//#region src/cli-integration.ts
+const defaultSignals = ["SIGINT", "SIGTERM"];
+function defaultProcess() {
+	return globalThis.process;
+}
+function defaultSanitizeArg(arg) {
+	if (/^(--?[^=\s]*(token|password|passwd|secret|key)[^=\s]*=)/i.test(arg)) return arg.replace(/=.*/, "=[redacted]");
+	return arg;
+}
+function defaultCommand(argv) {
+	return argv[1] ?? argv[0];
+}
+function levelFor(level, event, code) {
+	if (typeof level === "function") return level(event, code);
+	if (level) return level;
+	if (event === "signal") return "warn";
+	if (event === "exit" && Number(code ?? 0) !== 0) return "error";
+	return "info";
+}
+function pickEnv(env, names) {
+	if (!env || !names || names.length === 0) return void 0;
+	const out = {};
+	for (const name of names) {
+		const value = env[name];
+		if (value !== void 0) out[name] = value;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+function removeListener(processLike, event, listener) {
+	if (processLike.off) {
+		processLike.off(event, listener);
+		return;
+	}
+	processLike.removeListener?.(event, listener);
+}
+function captureCliIntegration(options = {}) {
+	const name = options.name ?? "cli";
+	const captureStart = options.captureStart ?? true;
+	const captureExit = options.captureExit ?? true;
+	const captureSignals = options.captureSignals ?? true;
+	const captureCwd = options.captureCwd ?? true;
+	const signals = options.signals ?? defaultSignals;
+	const sanitizeArg = options.sanitizeArg ?? defaultSanitizeArg;
+	const commandFor = options.getCommand ?? defaultCommand;
+	return {
+		name: "capture-cli",
+		setup(api) {
+			const processLike = options.process ?? defaultProcess();
+			if (!processLike) return;
+			const argv = processLike.argv ?? [];
+			const command = commandFor(argv);
+			const sanitizedArgv = argv.map((arg, index) => sanitizeArg(arg, index, argv));
+			const disposers = [];
+			let disposed = false;
+			const capture = api.guard((input) => {
+				if (!disposed) api.capture(input);
+			});
+			const cliBase = {
+				kind: name,
+				command,
+				argv: sanitizedArgv,
+				cwd: captureCwd ? processLike.cwd?.() : void 0,
+				env: pickEnv(processLike.env, options.captureEnv)
+			};
+			if (captureStart) capture({
+				level: levelFor(options.level, "start"),
+				message: `CLI start${command ? ` ${command}` : ""}`,
+				props: { cli: {
+					...cliBase,
+					lifecycle: "start"
+				} }
+			});
+			if (captureExit && processLike.on) {
+				const onExit = (code) => {
+					const exitCode = code ?? processLike.exitCode ?? 0;
+					capture({
+						level: levelFor(options.level, "exit", exitCode),
+						message: `CLI exit ${String(exitCode)}`,
+						props: { cli: {
+							...cliBase,
+							lifecycle: "exit",
+							exitCode
+						} }
+					});
+				};
+				processLike.on("exit", onExit);
+				disposers.push(() => removeListener(processLike, "exit", onExit));
+			}
+			if (captureSignals && processLike.on) for (const signal of signals) {
+				const onSignal = () => {
+					capture({
+						level: levelFor(options.level, "signal", signal),
+						message: `CLI signal ${signal}`,
+						props: { cli: {
+							...cliBase,
+							lifecycle: "signal",
+							signal
+						} }
+					});
+				};
+				processLike.on(signal, onSignal);
+				disposers.push(() => removeListener(processLike, signal, onSignal));
+			}
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const dispose of disposers) dispose();
+			};
+		}
+	};
+}
+//#endregion
+export { captureCliIntegration };
+
+//# sourceMappingURL=cli-integration.js.map