@loggerjs/node 0.5.2 → 0.5.3

package/README.md

@@ -111,6 +111,8 @@ diagnostics to Node `diagnostics_channel` channels such as `loggerjs.dispatch`,
 
 `captureProcessIntegration()` turns uncaught exceptions (fatal), unhandled rejections, warnings, and exit into log events; with `exitOnUncaught` it captures the fatal record, calls `flushSync()`, waits for bounded async `flush()`, then exits. Every integration is tagged `source: "integration:<name>"` and guarded against capture loops.
 
+Coverage notes: `prismaIntegration()` wraps `$queryRaw` / `$executeRaw` raw-query variants only; it does not subscribe to `$on("query")` or capture typed model calls. `bullMqIntegration()` wraps Queue-like `add`, `addBulk`, and legacy `process` methods; it does not hook `Worker` or `QueueEvents` completed/failed/stalled events. `nestMiddlewareIntegration()` is Express-compatible middleware, not a Nest exception-filter/interceptor integration.
+
 ### Context manager
 
 ```ts

package/dist/bullmq-integration.cjs.map

@@ -1 +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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"}
+{"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  /**\n   * Queue-like BullMQ object. By default LoggerJS wraps `add`, `addBulk`, and a\n   * legacy `process` method when present; it does not hook `Worker` or\n   * `QueueEvents` lifecycle events such as `completed`, `failed`, or `stalled`.\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.d.ts

@@ -1,5 +1,10 @@
 import { type QueueClientLike, type QueueIntegrationOptions } from "./queue-integration.js";
 export interface BullMqIntegrationOptions extends Omit<QueueIntegrationOptions, "client" | "system" | "methods" | "getQueueName"> {
+    /**
+     * Queue-like BullMQ object. By default LoggerJS wraps `add`, `addBulk`, and a
+     * legacy `process` method when present; it does not hook `Worker` or
+     * `QueueEvents` lifecycle events such as `completed`, `failed`, or `stalled`.
+     */
     client: QueueClientLike & {
         name?: string;
     };

package/dist/bullmq-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bullmq-integration.d.ts","sourceRoot":"","sources":["../src/bullmq-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,uBAAuB,EACvB,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,CACjD;IACC,MAAM,EAAE,eAAe,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AASD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,wCASlE"}
+{"version":3,"file":"bullmq-integration.d.ts","sourceRoot":"","sources":["../src/bullmq-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,uBAAuB,EACvB,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,CACjD;IACC;;;;OAIG;IACH,MAAM,EAAE,eAAe,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AASD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,wCASlE"}

package/dist/bullmq-integration.js.map

@@ -1 +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":"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"}
+{"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  /**\n   * Queue-like BullMQ object. By default LoggerJS wraps `add`, `addBulk`, and a\n   * legacy `process` method when present; it does not hook `Worker` or\n   * `QueueEvents` lifecycle events such as `completed`, `failed`, or `stalled`.\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/index.cjs

@@ -1633,6 +1633,11 @@ function koaIntegration(logger, options = {}) {
 }
 //#endregion
 //#region src/nest-integration.ts
+/**
+* Express-compatible Nest middleware adapter. It observes the same request and
+* response completion surface as `expressIntegration`; it does not hook Nest
+* exception filters, interceptors, guards, or the original thrown `Error`.
+*/
 function nestMiddlewareIntegration(logger, options = {}) {
 	return expressIntegration(logger, {
 		name: "nestjs",