@autter/runtime-node 1.8.0 → 1.9.0

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

@@ -166,10 +166,19 @@ declare function isRuntimeErrorLike(err: unknown): err is RuntimeErrorLike;
 interface ErrorAttributeOptions {
     /** Also emit `exception.cause.N.*` for the cause chain (default true). */
     causes?: boolean;
+    /**
+     * With `causes`, also emit what only an occurrence record needs (default
+     * true): each cause's stack (`exception.cause.N.stacktrace`, RF-06: a
+     * wrapped error groups with its root cause) and the debug ids of the
+     * bundles in the stacks (`autter.debug_ids`, RF-05: server source maps).
+     * Request and operation summaries pass false.
+     */
+    stacks?: boolean;
 }
 /**
- * Wire attributes for an error: `autter.error.code|why|fix|link|status|expected`
- * and `exception.cause.N.type|message|code` (N = 1..5). Never includes
+ * Wire attributes for an error: `autter.error.code|why|fix|link|status|expected`,
+ * `exception.cause.N.type|message|code|stacktrace` (N = 1..5) and
+ * `autter.debug_ids` (see ErrorAttributeOptions.stacks). Never includes
  * `internal` — see `errorInternal`.
  */
 declare function errorAttributes(err: unknown, options?: ErrorAttributeOptions): Record<string, string | number | boolean>;
@@ -250,6 +259,33 @@ interface BreadcrumbInput {
     at?: string | number | Date;
 }
 
+/**
+ * Handled errors (RF-01, RF-02): the building blocks every server SDK shares
+ * for errors the app caught instead of letting them crash.
+ *
+ * - Caught errors: an `Error` the app passes to `console.error`, a logger
+ *   (pino, winston, bunyan) or `runtimeLogger.error` is reported as an
+ *   occurrence at `error` severity, marked `autter.handled = true`,
+ *   `autter.handling = "caught"`, with the log line as context
+ *   (`autter.log.source`, `autter.log.message`).
+ * - Deliberate fallbacks: `runtimeContext.degraded(err, reason)` reports the
+ *   error at `warning` severity (never an incident), marked
+ *   `autter.handling = "deliberate"` with `autter.degraded.reason`.
+ *
+ * A burst limit keeps a looping error from flooding: per kind (error type
+ * and throw site) ten at once, then one every ten seconds. What it leaves
+ * out is counted, and the count rides on the next record of that kind as
+ * `autter.caught.dropped`, which the ingester adds to `runtime_ingest_drops`
+ * (reason `caught_limited`).
+ */
+type LoggedErrorSource = "console" | "pino" | "winston" | "bunyan" | "runtimeLogger";
+/**
+ * `captureLoggedErrors`: `true` (default) reports errors logged through
+ * every source the SDK supports, `false` none; an object turns single
+ * sources off, e.g. `{ console: false }`.
+ */
+type CaptureLoggedErrorsOption = boolean | Partial<Record<LoggedErrorSource, boolean>>;
+
 /**
  * Client-side volume control shared by the server SDKs (runtime-node,
  * runtime-edge; 1.8.0 / 1.2.0, EI-38): `ignoreErrors` and `sampleRate`.
@@ -358,4 +394,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, 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 };
+export { defineRuntimeErrors as A, type BreadcrumbInput as B, type CapturedException as C, errorAttributes as D, fileSink as E, type FileSinkOptions as F, isRuntimeErrorLike as G, otlpSink as H, type IgnoreErrorPattern as I, redactAttributes as J, redactText as K, type LoggedErrorSource as L, type MemorySink as M, toClientError as N, 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 CaptureLoggedErrorsOption as i, type Breadcrumb as j, type BreadcrumbLevel as k, type BreadcrumbType as l, memorySink as m, CODE_PATTERN as n, type ClientErrorBody as o, type ConsoleSinkOptions as p, RuntimeError as q, type RuntimeErrorCatalog as r, type RuntimeErrorDefinition as s, type RuntimeErrorExtras as t, type RuntimeErrorFactory as u, type RuntimeErrorLike as v, type RuntimeErrorOptions as w, type RuntimeLogContextValue as x, type RuntimeSinkContext as y, consoleSink as z };

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

@@ -166,10 +166,19 @@ declare function isRuntimeErrorLike(err: unknown): err is RuntimeErrorLike;
 interface ErrorAttributeOptions {
     /** Also emit `exception.cause.N.*` for the cause chain (default true). */
     causes?: boolean;
+    /**
+     * With `causes`, also emit what only an occurrence record needs (default
+     * true): each cause's stack (`exception.cause.N.stacktrace`, RF-06: a
+     * wrapped error groups with its root cause) and the debug ids of the
+     * bundles in the stacks (`autter.debug_ids`, RF-05: server source maps).
+     * Request and operation summaries pass false.
+     */
+    stacks?: boolean;
 }
 /**
- * Wire attributes for an error: `autter.error.code|why|fix|link|status|expected`
- * and `exception.cause.N.type|message|code` (N = 1..5). Never includes
+ * Wire attributes for an error: `autter.error.code|why|fix|link|status|expected`,
+ * `exception.cause.N.type|message|code|stacktrace` (N = 1..5) and
+ * `autter.debug_ids` (see ErrorAttributeOptions.stacks). Never includes
  * `internal` — see `errorInternal`.
  */
 declare function errorAttributes(err: unknown, options?: ErrorAttributeOptions): Record<string, string | number | boolean>;
@@ -250,6 +259,33 @@ interface BreadcrumbInput {
     at?: string | number | Date;
 }
 
+/**
+ * Handled errors (RF-01, RF-02): the building blocks every server SDK shares
+ * for errors the app caught instead of letting them crash.
+ *
+ * - Caught errors: an `Error` the app passes to `console.error`, a logger
+ *   (pino, winston, bunyan) or `runtimeLogger.error` is reported as an
+ *   occurrence at `error` severity, marked `autter.handled = true`,
+ *   `autter.handling = "caught"`, with the log line as context
+ *   (`autter.log.source`, `autter.log.message`).
+ * - Deliberate fallbacks: `runtimeContext.degraded(err, reason)` reports the
+ *   error at `warning` severity (never an incident), marked
+ *   `autter.handling = "deliberate"` with `autter.degraded.reason`.
+ *
+ * A burst limit keeps a looping error from flooding: per kind (error type
+ * and throw site) ten at once, then one every ten seconds. What it leaves
+ * out is counted, and the count rides on the next record of that kind as
+ * `autter.caught.dropped`, which the ingester adds to `runtime_ingest_drops`
+ * (reason `caught_limited`).
+ */
+type LoggedErrorSource = "console" | "pino" | "winston" | "bunyan" | "runtimeLogger";
+/**
+ * `captureLoggedErrors`: `true` (default) reports errors logged through
+ * every source the SDK supports, `false` none; an object turns single
+ * sources off, e.g. `{ console: false }`.
+ */
+type CaptureLoggedErrorsOption = boolean | Partial<Record<LoggedErrorSource, boolean>>;
+
 /**
  * Client-side volume control shared by the server SDKs (runtime-node,
  * runtime-edge; 1.8.0 / 1.2.0, EI-38): `ignoreErrors` and `sampleRate`.
@@ -358,4 +394,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, 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 };
+export { defineRuntimeErrors as A, type BreadcrumbInput as B, type CapturedException as C, errorAttributes as D, fileSink as E, type FileSinkOptions as F, isRuntimeErrorLike as G, otlpSink as H, type IgnoreErrorPattern as I, redactAttributes as J, redactText as K, type LoggedErrorSource as L, type MemorySink as M, toClientError as N, 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 CaptureLoggedErrorsOption as i, type Breadcrumb as j, type BreadcrumbLevel as k, type BreadcrumbType as l, memorySink as m, CODE_PATTERN as n, type ClientErrorBody as o, type ConsoleSinkOptions as p, RuntimeError as q, type RuntimeErrorCatalog as r, type RuntimeErrorDefinition as s, type RuntimeErrorExtras as t, type RuntimeErrorFactory as u, type RuntimeErrorLike as v, type RuntimeErrorOptions as w, type RuntimeLogContextValue as x, type RuntimeSinkContext as y, consoleSink as z };

package/dist/testing.cjs

@@ -2,22 +2,22 @@
 
 
 
-var _chunk37W7YYXOcjs = require('./chunk-37W7YYXO.cjs');
-require('./chunk-MOZOUEMA.cjs');
+var _chunkYWTIKZSIcjs = require('./chunk-YWTIKZSI.cjs');
+require('./chunk-BHYHORUD.cjs');
 
 // src/testing.ts
 function captureRuntime() {
-  const sink = _chunk37W7YYXOcjs.memorySink.call(void 0, );
-  const remove = _chunk37W7YYXOcjs.addRuntimeSink.call(void 0, sink);
+  const sink = _chunkYWTIKZSIcjs.memorySink.call(void 0, );
+  const remove = _chunkYWTIKZSIcjs.addRuntimeSink.call(void 0, sink);
   return {
     get events() {
       return [...sink.events];
     },
     get operations() {
-      return sink.events.filter(_chunk37W7YYXOcjs.isSummary);
+      return sink.events.filter(_chunkYWTIKZSIcjs.isSummary);
     },
     get logs() {
-      return sink.events.filter((event) => !_chunk37W7YYXOcjs.isSummary.call(void 0, event));
+      return sink.events.filter((event) => !_chunkYWTIKZSIcjs.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(_chunk37W7YYXOcjs.isSummary) : source.operations;
+  const events = Array.isArray(source) ? source.filter(_chunkYWTIKZSIcjs.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 = _chunk37W7YYXOcjs.memorySink;
+exports.captureRuntime = captureRuntime; exports.expectOperation = expectOperation; exports.memorySink = _chunkYWTIKZSIcjs.memorySink;

package/dist/testing.d.cts

@@ -1,5 +1,5 @@
-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';
+import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CLtQFPnn.cjs';
+export { M as MemorySink, m as memorySink } from './sinks-CLtQFPnn.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-CIdlmYwy.js';
-export { M as MemorySink, m as memorySink } from './sinks-CIdlmYwy.js';
+import { R as RuntimeEvent, a as RuntimeOutcome, C as CapturedException } from './sinks-CLtQFPnn.js';
+export { M as MemorySink, m as memorySink } from './sinks-CLtQFPnn.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-QKY2OQSO.js";
-import "./chunk-B5ZMOCEM.js";
+} from "./chunk-HHKQ3UCH.js";
+import "./chunk-ZKM76SDP.js";
 
 // src/testing.ts
 function captureRuntime() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@autter/runtime-node",
-	"version": "1.8.0",
+	"version": "1.9.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",
@@ -45,16 +45,20 @@
 		"@opentelemetry/sdk-metrics": "^1.30.1",
 		"@opentelemetry/sdk-node": "^0.57.1",
 		"@opentelemetry/sdk-trace-base": "^1.30.1",
-		"@opentelemetry/semantic-conventions": "^1.28.0"
+		"@opentelemetry/semantic-conventions": "^1.28.0",
+		"require-in-the-middle": "^7.5.2"
 	},
 	"devDependencies": {
 		"@autter/runtime-core": "0.0.0",
 		"@types/node": "^22.10.0",
+		"bunyan": "^1.8.15",
 		"express": "^4.21.2",
 		"fastify": "^5.12.5",
 		"koa": "^3.2.1",
+		"pino": "^10.4.0",
 		"tsup": "^8.3.5",
-		"typescript": "^5.7.0"
+		"typescript": "^5.7.0",
+		"winston": "^3.19.0"
 	},
 	"engines": {
 		"node": ">=20"