@autter/runtime-node 1.7.0 → 1.8.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { b as RedactOptions, c as Redactor$1, d as RuntimeLogLevel, e as RuntimeOperationKind, f as RuntimeSink, F as FileSinkOptions, g as RuntimeLogContext, a as RuntimeOutcome, h as RuntimeCarrier, B as BreadcrumbInput } from './sinks-CPGDyfU8.cjs';
-export { i as Breadcrumb, j as BreadcrumbLevel, k as BreadcrumbType, l as CODE_PATTERN, n as ClientErrorBody, o as ConsoleSinkOptions, O as OtlpSinkOptions, p as RuntimeError, q as RuntimeErrorCatalog, r as RuntimeErrorDefinition, s as RuntimeErrorExtras, t as RuntimeErrorFactory, u as RuntimeErrorLike, v as RuntimeErrorOptions, R as RuntimeEvent, w as RuntimeLogContextValue, x as RuntimeSinkContext, y as consoleSink, z as defineRuntimeErrors, A as errorAttributes, D as fileSink, E as isRuntimeErrorLike, G as otlpSink, H as redactAttributes, I as redactText, J as toClientError } from './sinks-CPGDyfU8.cjs';
+import { b as RedactOptions, c as Redactor$1, d as RuntimeLogLevel, e as RuntimeOperationKind, f as RuntimeSink, F as FileSinkOptions, g as RuntimeLogContext, a as RuntimeOutcome, h as RuntimeCarrier, I as IgnoreErrorPattern, B as BreadcrumbInput } from './sinks-CIdlmYwy.cjs';
+export { i as Breadcrumb, j as BreadcrumbLevel, k as BreadcrumbType, l as CODE_PATTERN, n as ClientErrorBody, o as ConsoleSinkOptions, O as OtlpSinkOptions, p as RuntimeError, q as RuntimeErrorCatalog, r as RuntimeErrorDefinition, s as RuntimeErrorExtras, t as RuntimeErrorFactory, u as RuntimeErrorLike, v as RuntimeErrorOptions, R as RuntimeEvent, w as RuntimeLogContextValue, x as RuntimeSinkContext, y as consoleSink, z as defineRuntimeErrors, A as errorAttributes, D as fileSink, E as isRuntimeErrorLike, G as otlpSink, H as redactAttributes, J as redactText, K as toClientError } from './sinks-CIdlmYwy.cjs';
 import { Attributes } from '@opentelemetry/api';
 
 /**
@@ -227,6 +227,25 @@ interface AutterServerOptions {
     release?: string;
     /** Head-sampling ratio for regular traces. Default 0.01 (1%). */
     traceSampleRate?: number;
+    /**
+     * Share of captured errors reported, 0..1 (default 1: all). Applies to
+     * `captureException`, error-severity `captureMessage` and `reportOutcome`.
+     * Never samples out a fatal message, a crash (uncaught exception) or an
+     * unhandled rejection; warnings and info are never sampled. One thrown
+     * value is decided once, however many hooks report it. What is sampled
+     * out is not counted anywhere: for counted volume control use
+     * suppression rules in Autter (ingester 1.9.0). Not `traceSampleRate`,
+     * which samples healthy traces.
+     */
+    sampleRate?: number;
+    /**
+     * Errors never reported: strings match when the error's type or message
+     * contains them (case-sensitive), RegExps are tested against the type,
+     * the message and `"<type>: <message>"`. Applies to every capture path,
+     * crashes included. A request that failed still records its failed
+     * span and summary: leave those out with a suppression rule in Autter.
+     */
+    ignoreErrors?: IgnoreErrorPattern[];
     /**
      * Keep the FULL trace whenever it contains an error: an ERROR-status
      * span (e.g. a 5xx request), a recorded exception, or a
@@ -783,6 +802,10 @@ interface AutterLoggingOptions {
      * (use when the app's own spans are not exported to Autter).
      */
     exceptions?: "auto" | "log";
+    /** Same semantics as initAutterServer: share of captured errors reported (crashes never sampled). */
+    sampleRate?: number;
+    /** Same semantics as initAutterServer: errors never reported (type or message). */
+    ignoreErrors?: IgnoreErrorPattern[];
 }
 interface AutterLogging {
     captureException(error: unknown, attributes?: Attributes): void;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { b as RedactOptions, c as Redactor$1, d as RuntimeLogLevel, e as RuntimeOperationKind, f as RuntimeSink, F as FileSinkOptions, g as RuntimeLogContext, a as RuntimeOutcome, h as RuntimeCarrier, B as BreadcrumbInput } from './sinks-CPGDyfU8.js';
-export { i as Breadcrumb, j as BreadcrumbLevel, k as BreadcrumbType, l as CODE_PATTERN, n as ClientErrorBody, o as ConsoleSinkOptions, O as OtlpSinkOptions, p as RuntimeError, q as RuntimeErrorCatalog, r as RuntimeErrorDefinition, s as RuntimeErrorExtras, t as RuntimeErrorFactory, u as RuntimeErrorLike, v as RuntimeErrorOptions, R as RuntimeEvent, w as RuntimeLogContextValue, x as RuntimeSinkContext, y as consoleSink, z as defineRuntimeErrors, A as errorAttributes, D as fileSink, E as isRuntimeErrorLike, G as otlpSink, H as redactAttributes, I as redactText, J as toClientError } from './sinks-CPGDyfU8.js';
+import { b as RedactOptions, c as Redactor$1, d as RuntimeLogLevel, e as RuntimeOperationKind, f as RuntimeSink, F as FileSinkOptions, g as RuntimeLogContext, a as RuntimeOutcome, h as RuntimeCarrier, I as IgnoreErrorPattern, B as BreadcrumbInput } from './sinks-CIdlmYwy.js';
+export { i as Breadcrumb, j as BreadcrumbLevel, k as BreadcrumbType, l as CODE_PATTERN, n as ClientErrorBody, o as ConsoleSinkOptions, O as OtlpSinkOptions, p as RuntimeError, q as RuntimeErrorCatalog, r as RuntimeErrorDefinition, s as RuntimeErrorExtras, t as RuntimeErrorFactory, u as RuntimeErrorLike, v as RuntimeErrorOptions, R as RuntimeEvent, w as RuntimeLogContextValue, x as RuntimeSinkContext, y as consoleSink, z as defineRuntimeErrors, A as errorAttributes, D as fileSink, E as isRuntimeErrorLike, G as otlpSink, H as redactAttributes, J as redactText, K as toClientError } from './sinks-CIdlmYwy.js';
 import { Attributes } from '@opentelemetry/api';
 
 /**
@@ -227,6 +227,25 @@ interface AutterServerOptions {
     release?: string;
     /** Head-sampling ratio for regular traces. Default 0.01 (1%). */
     traceSampleRate?: number;
+    /**
+     * Share of captured errors reported, 0..1 (default 1: all). Applies to
+     * `captureException`, error-severity `captureMessage` and `reportOutcome`.
+     * Never samples out a fatal message, a crash (uncaught exception) or an
+     * unhandled rejection; warnings and info are never sampled. One thrown
+     * value is decided once, however many hooks report it. What is sampled
+     * out is not counted anywhere: for counted volume control use
+     * suppression rules in Autter (ingester 1.9.0). Not `traceSampleRate`,
+     * which samples healthy traces.
+     */
+    sampleRate?: number;
+    /**
+     * Errors never reported: strings match when the error's type or message
+     * contains them (case-sensitive), RegExps are tested against the type,
+     * the message and `"<type>: <message>"`. Applies to every capture path,
+     * crashes included. A request that failed still records its failed
+     * span and summary: leave those out with a suppression rule in Autter.
+     */
+    ignoreErrors?: IgnoreErrorPattern[];
     /**
      * Keep the FULL trace whenever it contains an error: an ERROR-status
      * span (e.g. a 5xx request), a recorded exception, or a
@@ -783,6 +802,10 @@ interface AutterLoggingOptions {
      * (use when the app's own spans are not exported to Autter).
      */
     exceptions?: "auto" | "log";
+    /** Same semantics as initAutterServer: share of captured errors reported (crashes never sampled). */
+    sampleRate?: number;
+    /** Same semantics as initAutterServer: errors never reported (type or message). */
+    ignoreErrors?: IgnoreErrorPattern[];
 }
 interface AutterLogging {
     captureException(error: unknown, attributes?: Attributes): void;

package/dist/index.js

@@ -8,6 +8,7 @@ import {
   compileIgnore,
   configureRuntimeLogger,
   consoleSink,
+  createErrorFilter,
   createRequestState,
   createRuntimeLogger,
   currentOperation,
@@ -45,10 +46,10 @@ import {
   splitFingerprint,
   toClientError,
   withRuntimeOperation
-} from "./chunk-KA4AOZX2.js";
+} from "./chunk-QKY2OQSO.js";
 import {
   runDoctor
-} from "./chunk-QUC6OUE7.js";
+} from "./chunk-UC3QH4PC.js";
 import {
   COMPAT_MANIFEST,
   CountingExporter,
@@ -70,7 +71,7 @@ import {
   sharedSlot,
   telemetryStats,
   unregisterFlushTargets
-} from "./chunk-LG52CW3V.js";
+} from "./chunk-B5ZMOCEM.js";
 
 // src/relay.ts
 var IpWindow = class {
@@ -1718,6 +1719,7 @@ function initAutterServer(options) {
     // its span-fed per-route counts.
     "autter.metrics_routes": true
   });
+  const errorFilter = createErrorFilter({ ignoreErrors: options.ignoreErrors, sampleRate: options.sampleRate });
   const rootSampler = new TraceIdRatioBasedSampler(options.traceSampleRate ?? 0.01);
   const headSampler = new ParentBasedSampler({
     root: rootSampler,
@@ -1793,6 +1795,16 @@ function initAutterServer(options) {
   const processTracer = alwaysOnProvider.getTracer("autter-processes");
   const llmTracer = alwaysOnProvider.getTracer("autter-llm");
   function captureException2(error, attributes) {
+    const isErrValue = isError(error);
+    const reported = errorFilter({
+      type: isErrValue ? String(error.name ?? "") : "Error",
+      message: isErrValue ? String(error.message ?? "") : String(error),
+      crash: attributes?.["autter.unhandled"] === true || attributes?.["autter.unhandled_rejection"] === true
+    });
+    if (!reported) {
+      markCaptured(error);
+      return;
+    }
     errorTraceBuffer?.retainActiveTrace();
     telemetryStats.markCaptured();
     const isErr = isError(error);
@@ -1845,6 +1857,7 @@ function initAutterServer(options) {
     if (!reuseActive) span.end();
   }
   function captureMessage2(message, severity = "warning", attributes) {
+    if (!errorFilter({ type: "Message", message: String(message), severity })) return;
     if (severity === "error" || severity === "fatal") {
       errorTraceBuffer?.retainActiveTrace();
     }
@@ -1865,6 +1878,7 @@ function initAutterServer(options) {
     span.end();
   }
   function reportOutcome2(name, message, attributes) {
+    if (!errorFilter({ type: "OutcomeFailure", message: `${name}: ${message}` })) return;
     errorTraceBuffer?.retainActiveTrace();
     telemetryStats.markCaptured();
     const activeSpan = trace2.getActiveSpan();
@@ -2418,8 +2432,16 @@ function initAutterLogging(options) {
   const redact = makeRedactor(options.redactAttributes ?? true);
   const mode = options.exceptions ?? "auto";
   debugLog(`initialising logger-only service=${options.service} endpoint=${endpoint}`);
+  const errorFilter = createErrorFilter({ ignoreErrors: options.ignoreErrors, sampleRate: options.sampleRate });
   function captureException2(error, attributes) {
     markCaptured(error);
+    const isErrValue = isError(error);
+    const reported = errorFilter({
+      type: isErrValue ? String(error.name ?? "") : "Error",
+      message: isErrValue ? String(error.message ?? "") : String(error),
+      crash: attributes?.["autter.unhandled"] === true || attributes?.["autter.unhandled_rejection"] === true
+    });
+    if (!reported) return;
     const split = splitFingerprint(attributes);
     const fingerprint = fingerprintEventAttributes(split.fingerprint, redact.text);
     const redacted = redact(split.attributes);

package/dist/{sinks-CPGDyfU8.d.cts → sinks-CIdlmYwy.d.cts}

@@ -250,6 +250,26 @@ interface BreadcrumbInput {
     at?: string | number | Date;
 }
 
+/**
+ * Client-side volume control shared by the server SDKs (runtime-node,
+ * runtime-edge; 1.8.0 / 1.2.0, EI-38): `ignoreErrors` and `sampleRate`.
+ * The browser has its own copy in `@autter/runtime-browser/filters`.
+ *
+ * - `ignoreErrors`: strings or RegExps. A string matches when the error's
+ *   type or message contains it (case-sensitive, like the message itself);
+ *   a RegExp is tested against the type, the message and
+ *   `"<type>: <message>"`. A match is never reported, whatever its severity.
+ * - `sampleRate`: 0..1, the share of errors reported. Errors only: warnings
+ *   and info messages are never sampled, and neither is a fatal error, a
+ *   crash (uncaught exception) or an unhandled rejection, which may be one.
+ *   Out of range or not a number: everything is reported.
+ *
+ * What is filtered here never leaves the process and is counted nowhere.
+ * To leave errors out of every SDK at once, and see how many were left out,
+ * use suppression rules in Autter (applied by the ingester, 1.9.0).
+ */
+type IgnoreErrorPattern = string | RegExp;
+
 /**
  * Where runtime records go. The logger pipeline is
  * `enrich → redact/bound → sinks[]`; each sink receives the same immutable
@@ -338,4 +358,4 @@ interface MemorySink extends RuntimeSink {
 /** Keeps every record in memory — for tests (`@autter/runtime-node/testing`). */
 declare function memorySink(): MemorySink;
 
-export { errorAttributes as A, type BreadcrumbInput as B, type CapturedException as C, fileSink as D, isRuntimeErrorLike as E, type FileSinkOptions as F, otlpSink as G, redactAttributes as H, redactText as I, toClientError as J, type MemorySink as M, type OtlpSinkOptions as O, type RuntimeEvent as R, type RuntimeOutcome as a, type RedactOptions as b, type Redactor$1 as c, type RuntimeLogLevel as d, type RuntimeOperationKind as e, type RuntimeSink as f, type RuntimeLogContext as g, type RuntimeCarrier as h, type Breadcrumb as i, type BreadcrumbLevel as j, type BreadcrumbType as k, CODE_PATTERN as l, memorySink as m, type ClientErrorBody as n, type ConsoleSinkOptions as o, RuntimeError as p, type RuntimeErrorCatalog as q, type RuntimeErrorDefinition as r, type RuntimeErrorExtras as s, type RuntimeErrorFactory as t, type RuntimeErrorLike as u, type RuntimeErrorOptions as v, type RuntimeLogContextValue as w, type RuntimeSinkContext as x, consoleSink as y, defineRuntimeErrors as z };
+export { errorAttributes as A, type BreadcrumbInput as B, type CapturedException as C, fileSink as D, isRuntimeErrorLike as E, type FileSinkOptions as F, otlpSink as G, redactAttributes as H, type IgnoreErrorPattern as I, redactText as J, toClientError as K, type MemorySink as M, type OtlpSinkOptions as O, type RuntimeEvent as R, type RuntimeOutcome as a, type RedactOptions as b, type Redactor$1 as c, type RuntimeLogLevel as d, type RuntimeOperationKind as e, type RuntimeSink as f, type RuntimeLogContext as g, type RuntimeCarrier as h, type Breadcrumb as i, type BreadcrumbLevel as j, type BreadcrumbType as k, CODE_PATTERN as l, memorySink as m, type ClientErrorBody as n, type ConsoleSinkOptions as o, RuntimeError as p, type RuntimeErrorCatalog as q, type RuntimeErrorDefinition as r, type RuntimeErrorExtras as s, type RuntimeErrorFactory as t, type RuntimeErrorLike as u, type RuntimeErrorOptions as v, type RuntimeLogContextValue as w, type RuntimeSinkContext as x, consoleSink as y, defineRuntimeErrors as z };

package/dist/{sinks-CPGDyfU8.d.ts → sinks-CIdlmYwy.d.ts}

@@ -250,6 +250,26 @@ interface BreadcrumbInput {
     at?: string | number | Date;
 }
 
+/**
+ * Client-side volume control shared by the server SDKs (runtime-node,
+ * runtime-edge; 1.8.0 / 1.2.0, EI-38): `ignoreErrors` and `sampleRate`.
+ * The browser has its own copy in `@autter/runtime-browser/filters`.
+ *
+ * - `ignoreErrors`: strings or RegExps. A string matches when the error's
+ *   type or message contains it (case-sensitive, like the message itself);
+ *   a RegExp is tested against the type, the message and
+ *   `"<type>: <message>"`. A match is never reported, whatever its severity.
+ * - `sampleRate`: 0..1, the share of errors reported. Errors only: warnings
+ *   and info messages are never sampled, and neither is a fatal error, a
+ *   crash (uncaught exception) or an unhandled rejection, which may be one.
+ *   Out of range or not a number: everything is reported.
+ *
+ * What is filtered here never leaves the process and is counted nowhere.
+ * To leave errors out of every SDK at once, and see how many were left out,
+ * use suppression rules in Autter (applied by the ingester, 1.9.0).
+ */
+type IgnoreErrorPattern = string | RegExp;
+
 /**
  * Where runtime records go. The logger pipeline is
  * `enrich → redact/bound → sinks[]`; each sink receives the same immutable
@@ -338,4 +358,4 @@ interface MemorySink extends RuntimeSink {
 /** Keeps every record in memory — for tests (`@autter/runtime-node/testing`). */
 declare function memorySink(): MemorySink;
 
-export { errorAttributes as A, type BreadcrumbInput as B, type CapturedException as C, fileSink as D, isRuntimeErrorLike as E, type FileSinkOptions as F, otlpSink as G, redactAttributes as H, redactText as I, toClientError as J, type MemorySink as M, type OtlpSinkOptions as O, type RuntimeEvent as R, type RuntimeOutcome as a, type RedactOptions as b, type Redactor$1 as c, type RuntimeLogLevel as d, type RuntimeOperationKind as e, type RuntimeSink as f, type RuntimeLogContext as g, type RuntimeCarrier as h, type Breadcrumb as i, type BreadcrumbLevel as j, type BreadcrumbType as k, CODE_PATTERN as l, memorySink as m, type ClientErrorBody as n, type ConsoleSinkOptions as o, RuntimeError as p, type RuntimeErrorCatalog as q, type RuntimeErrorDefinition as r, type RuntimeErrorExtras as s, type RuntimeErrorFactory as t, type RuntimeErrorLike as u, type RuntimeErrorOptions as v, type RuntimeLogContextValue as w, type RuntimeSinkContext as x, consoleSink as y, defineRuntimeErrors as z };
+export { errorAttributes as A, type BreadcrumbInput as B, type CapturedException as C, fileSink as D, isRuntimeErrorLike as E, type FileSinkOptions as F, otlpSink as G, redactAttributes as H, type IgnoreErrorPattern as I, redactText as J, toClientError as K, type MemorySink as M, type OtlpSinkOptions as O, type RuntimeEvent as R, type RuntimeOutcome as a, type RedactOptions as b, type Redactor$1 as c, type RuntimeLogLevel as d, type RuntimeOperationKind as e, type RuntimeSink as f, type RuntimeLogContext as g, type RuntimeCarrier as h, type Breadcrumb as i, type BreadcrumbLevel as j, type BreadcrumbType as k, CODE_PATTERN as l, memorySink as m, type ClientErrorBody as n, type ConsoleSinkOptions as o, RuntimeError as p, type RuntimeErrorCatalog as q, type RuntimeErrorDefinition as r, type RuntimeErrorExtras as s, type RuntimeErrorFactory as t, type RuntimeErrorLike as u, type RuntimeErrorOptions as v, type RuntimeLogContextValue as w, type RuntimeSinkContext as x, consoleSink as y, defineRuntimeErrors as z };

package/dist/testing.cjs

@@ -2,22 +2,22 @@
 
 
 
-var _chunkRV4MJNM2cjs = require('./chunk-RV4MJNM2.cjs');
-require('./chunk-GYTQLITW.cjs');
+var _chunk37W7YYXOcjs = require('./chunk-37W7YYXO.cjs');
+require('./chunk-MOZOUEMA.cjs');
 
 // src/testing.ts
 function captureRuntime() {
-  const sink = _chunkRV4MJNM2cjs.memorySink.call(void 0, );
-  const remove = _chunkRV4MJNM2cjs.addRuntimeSink.call(void 0, sink);
+  const sink = _chunk37W7YYXOcjs.memorySink.call(void 0, );
+  const remove = _chunk37W7YYXOcjs.addRuntimeSink.call(void 0, sink);
   return {
     get events() {
       return [...sink.events];
     },
     get operations() {
-      return sink.events.filter(_chunkRV4MJNM2cjs.isSummary);
+      return sink.events.filter(_chunk37W7YYXOcjs.isSummary);
     },
     get logs() {
-      return sink.events.filter((event) => !_chunkRV4MJNM2cjs.isSummary.call(void 0, event));
+      return sink.events.filter((event) => !_chunk37W7YYXOcjs.isSummary.call(void 0, event));
     },
     get exceptions() {
       return [...sink.exceptions];
@@ -98,7 +98,7 @@ var OperationExpectation = class {
   }
 };
 function expectOperation(source, name) {
-  const events = Array.isArray(source) ? source.filter(_chunkRV4MJNM2cjs.isSummary) : source.operations;
+  const events = Array.isArray(source) ? source.filter(_chunk37W7YYXOcjs.isSummary) : source.operations;
   const matches = events.filter((event2) => {
     const actual = String(_nullishCoalesce(event2.attributes["autter.operation.name"], () => ( "")));
     return typeof name === "string" ? actual === name : name.test(actual);
@@ -118,4 +118,4 @@ function expectOperation(source, name) {
 
 
 
-exports.captureRuntime = captureRuntime; exports.expectOperation = expectOperation; exports.memorySink = _chunkRV4MJNM2cjs.memorySink;
+exports.captureRuntime = captureRuntime; exports.expectOperation = expectOperation; exports.memorySink = _chunk37W7YYXOcjs.memorySink;

package/dist/testing.d.cts

@@ -1,5 +1,5 @@
-import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CPGDyfU8.cjs';
-export { M as MemorySink, m as memorySink } from './sinks-CPGDyfU8.cjs';
+import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CIdlmYwy.cjs';
+export { M as MemorySink, m as memorySink } from './sinks-CIdlmYwy.cjs';
 
 /**
  * Test helpers — `@autter/runtime-node/testing`. No ingester, no network:

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CPGDyfU8.js';
-export { M as MemorySink, m as memorySink } from './sinks-CPGDyfU8.js';
+import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CIdlmYwy.js';
+export { M as MemorySink, m as memorySink } from './sinks-CIdlmYwy.js';
 
 /**
  * Test helpers — `@autter/runtime-node/testing`. No ingester, no network:

package/dist/testing.js

@@ -2,8 +2,8 @@ import {
   addRuntimeSink,
   isSummary,
   memorySink
-} from "./chunk-KA4AOZX2.js";
-import "./chunk-LG52CW3V.js";
+} from "./chunk-QKY2OQSO.js";
+import "./chunk-B5ZMOCEM.js";
 
 // src/testing.ts
 function captureRuntime() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@autter/runtime-node",
-	"version": "1.7.0",
+	"version": "1.8.0",
 	"description": "Autter Runtime for Node.js: request wide events, coded errors, operation logging, same-origin browser relay and a curated OpenTelemetry server tracker",
 	"license": "MIT",
 	"type": "module",