@autter/runtime-node 1.4.0 → 1.6.0

package/dist/testing.cjs

@@ -0,0 +1,121 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+
+var _chunkUKYTXZOQcjs = require('./chunk-UKYTXZOQ.cjs');
+require('./chunk-ARN26OK6.cjs');
+
+// src/testing.ts
+function captureRuntime() {
+  const sink = _chunkUKYTXZOQcjs.memorySink.call(void 0, );
+  const remove = _chunkUKYTXZOQcjs.addRuntimeSink.call(void 0, sink);
+  return {
+    get events() {
+      return [...sink.events];
+    },
+    get operations() {
+      return sink.events.filter(_chunkUKYTXZOQcjs.isSummary);
+    },
+    get logs() {
+      return sink.events.filter((event) => !_chunkUKYTXZOQcjs.isSummary.call(void 0, event));
+    },
+    get exceptions() {
+      return [...sink.exceptions];
+    },
+    byRequestId: (requestId) => sink.events.filter((event) => event.attributes["autter.request.id"] === requestId),
+    clear: () => sink.clear(),
+    stop: () => {
+      remove();
+    }
+  };
+}
+function partialMatch(actual, expected) {
+  if (expected && typeof expected === "object" && !Array.isArray(expected)) {
+    if (!actual || typeof actual !== "object") return false;
+    return Object.entries(expected).every(
+      ([key, value]) => partialMatch(actual[key], value)
+    );
+  }
+  if (Array.isArray(expected))
+    return Array.isArray(actual) && expected.length === actual.length && expected.every((item, i) => partialMatch(actual[i], item));
+  return Object.is(actual, expected);
+}
+var OperationExpectation = class {
+  constructor(event) {
+    this.event = event;
+  }
+  
+  get attributes() {
+    return this.event.attributes;
+  }
+  fail(message) {
+    const error = new Error(
+      `expectOperation(${JSON.stringify(this.attributes["autter.operation.name"])}): ${message}`
+    );
+    error.name = "AssertionError";
+    throw error;
+  }
+  toHaveOutcome(outcome) {
+    const actual = this.attributes["autter.operation.outcome"];
+    if (actual !== outcome) this.fail(`expected outcome ${outcome}, got ${String(actual)}`);
+    return this;
+  }
+  toHaveKind(kind) {
+    const actual = this.attributes["autter.operation.kind"];
+    if (actual !== kind) this.fail(`expected kind ${kind}, got ${String(actual)}`);
+    return this;
+  }
+  /** Deep partial match against the summary attributes. */
+  toHaveContext(expected) {
+    if (!partialMatch(this.attributes, expected))
+      this.fail(`context does not match ${JSON.stringify(expected)}`);
+    return this;
+  }
+  toHaveStep(name, status) {
+    const steps = _nullishCoalesce(this.attributes["autter.operation.steps"], () => ( []));
+    if (!steps.some((step) => step.name === name && (!status || step.status === status)))
+      this.fail(`no step ${name}${status ? ` (${status})` : ""}`);
+    return this;
+  }
+  toHaveErrorCode(code) {
+    const actual = this.attributes["autter.error.code"];
+    if (actual !== code) this.fail(`expected error code ${code}, got ${String(actual)}`);
+    return this;
+  }
+  toHaveLog(message, level) {
+    const logs = _nullishCoalesce(this.attributes["autter.operation.logs"], () => ( []));
+    const ok = logs.some(
+      (log) => (typeof message === "string" ? log.message === message : message.test(log.message)) && (!level || log.level === level)
+    );
+    if (!ok) this.fail(`no inline log ${String(message)}`);
+    return this;
+  }
+  toHaveRequestId(requestId) {
+    const actual = this.attributes["autter.request.id"];
+    if (requestId === void 0 ? typeof actual !== "string" : actual !== requestId)
+      this.fail(`expected request id ${_nullishCoalesce(requestId, () => ( "(any)"))}, got ${String(actual)}`);
+    return this;
+  }
+};
+function expectOperation(source, name) {
+  const events = Array.isArray(source) ? source.filter(_chunkUKYTXZOQcjs.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);
+  });
+  const event = matches[matches.length - 1];
+  if (!event) {
+    const seen = events.map((e) => e.attributes["autter.operation.name"]);
+    const error = new Error(
+      `expectOperation: no operation named ${String(name)} (saw ${JSON.stringify(seen)})`
+    );
+    error.name = "AssertionError";
+    throw error;
+  }
+  return new OperationExpectation(event);
+}
+
+
+
+
+exports.captureRuntime = captureRuntime; exports.expectOperation = expectOperation; exports.memorySink = _chunkUKYTXZOQcjs.memorySink;

package/dist/testing.d.cts

@@ -0,0 +1,57 @@
+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';
+
+/**
+ * Test helpers — `@autter/runtime-node/testing`. No ingester, no network:
+ * every record the SDK would export is kept in memory.
+ *
+ *   import { captureRuntime, expectOperation } from "@autter/runtime-node/testing";
+ *
+ *   const runtime = captureRuntime();
+ *   await request(app).post("/checkout").expect(402);
+ *   expectOperation(runtime, "POST /checkout")
+ *     .toHaveOutcome("degraded")
+ *     .toHaveErrorCode("billing.declined");
+ *   runtime.stop();
+ *
+ * Works with or without initAutterServer/initAutterLogging; before init it
+ * replaces the default console output instead of adding to it.
+ */
+
+interface RuntimeCapture {
+    /** Every record, in emission order. */
+    readonly events: RuntimeEvent[];
+    /** Operation and request summaries. */
+    readonly operations: RuntimeEvent[];
+    /** Plain log records (warn/error and records outside operations). */
+    readonly logs: RuntimeEvent[];
+    /** Every captureException call (including boundary captures). */
+    readonly exceptions: CapturedException[];
+    /** All records stamped with this request id. */
+    byRequestId(requestId: string): RuntimeEvent[];
+    clear(): void;
+    /** Detach from the logger. */
+    stop(): void;
+}
+declare function captureRuntime(): RuntimeCapture;
+declare class OperationExpectation {
+    readonly event: RuntimeEvent;
+    constructor(event: RuntimeEvent);
+    get attributes(): Record<string, unknown>;
+    private fail;
+    toHaveOutcome(outcome: RuntimeOutcome): this;
+    toHaveKind(kind: "request" | "operation"): this;
+    /** Deep partial match against the summary attributes. */
+    toHaveContext(expected: Record<string, unknown>): this;
+    toHaveStep(name: string, status?: "succeeded" | "failed"): this;
+    toHaveErrorCode(code: string): this;
+    toHaveLog(message: string | RegExp, level?: string): this;
+    toHaveRequestId(requestId?: string): this;
+}
+/**
+ * Find the most recent summary named `name` (exact string or RegExp) and
+ * return chainable assertions. Throws when no such summary exists.
+ */
+declare function expectOperation(source: RuntimeCapture | RuntimeEvent[], name: string | RegExp): OperationExpectation;
+
+export { CapturedException, OperationExpectation, type RuntimeCapture, RuntimeEvent, captureRuntime, expectOperation };

package/dist/testing.d.ts

@@ -0,0 +1,57 @@
+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';
+
+/**
+ * Test helpers — `@autter/runtime-node/testing`. No ingester, no network:
+ * every record the SDK would export is kept in memory.
+ *
+ *   import { captureRuntime, expectOperation } from "@autter/runtime-node/testing";
+ *
+ *   const runtime = captureRuntime();
+ *   await request(app).post("/checkout").expect(402);
+ *   expectOperation(runtime, "POST /checkout")
+ *     .toHaveOutcome("degraded")
+ *     .toHaveErrorCode("billing.declined");
+ *   runtime.stop();
+ *
+ * Works with or without initAutterServer/initAutterLogging; before init it
+ * replaces the default console output instead of adding to it.
+ */
+
+interface RuntimeCapture {
+    /** Every record, in emission order. */
+    readonly events: RuntimeEvent[];
+    /** Operation and request summaries. */
+    readonly operations: RuntimeEvent[];
+    /** Plain log records (warn/error and records outside operations). */
+    readonly logs: RuntimeEvent[];
+    /** Every captureException call (including boundary captures). */
+    readonly exceptions: CapturedException[];
+    /** All records stamped with this request id. */
+    byRequestId(requestId: string): RuntimeEvent[];
+    clear(): void;
+    /** Detach from the logger. */
+    stop(): void;
+}
+declare function captureRuntime(): RuntimeCapture;
+declare class OperationExpectation {
+    readonly event: RuntimeEvent;
+    constructor(event: RuntimeEvent);
+    get attributes(): Record<string, unknown>;
+    private fail;
+    toHaveOutcome(outcome: RuntimeOutcome): this;
+    toHaveKind(kind: "request" | "operation"): this;
+    /** Deep partial match against the summary attributes. */
+    toHaveContext(expected: Record<string, unknown>): this;
+    toHaveStep(name: string, status?: "succeeded" | "failed"): this;
+    toHaveErrorCode(code: string): this;
+    toHaveLog(message: string | RegExp, level?: string): this;
+    toHaveRequestId(requestId?: string): this;
+}
+/**
+ * Find the most recent summary named `name` (exact string or RegExp) and
+ * return chainable assertions. Throws when no such summary exists.
+ */
+declare function expectOperation(source: RuntimeCapture | RuntimeEvent[], name: string | RegExp): OperationExpectation;
+
+export { CapturedException, OperationExpectation, type RuntimeCapture, RuntimeEvent, captureRuntime, expectOperation };

package/dist/testing.js

@@ -0,0 +1,121 @@
+import {
+  addRuntimeSink,
+  isSummary,
+  memorySink
+} from "./chunk-FBKYOHU2.js";
+import "./chunk-OY2HTUWY.js";
+
+// src/testing.ts
+function captureRuntime() {
+  const sink = memorySink();
+  const remove = addRuntimeSink(sink);
+  return {
+    get events() {
+      return [...sink.events];
+    },
+    get operations() {
+      return sink.events.filter(isSummary);
+    },
+    get logs() {
+      return sink.events.filter((event) => !isSummary(event));
+    },
+    get exceptions() {
+      return [...sink.exceptions];
+    },
+    byRequestId: (requestId) => sink.events.filter((event) => event.attributes["autter.request.id"] === requestId),
+    clear: () => sink.clear(),
+    stop: () => {
+      remove();
+    }
+  };
+}
+function partialMatch(actual, expected) {
+  if (expected && typeof expected === "object" && !Array.isArray(expected)) {
+    if (!actual || typeof actual !== "object") return false;
+    return Object.entries(expected).every(
+      ([key, value]) => partialMatch(actual[key], value)
+    );
+  }
+  if (Array.isArray(expected))
+    return Array.isArray(actual) && expected.length === actual.length && expected.every((item, i) => partialMatch(actual[i], item));
+  return Object.is(actual, expected);
+}
+var OperationExpectation = class {
+  constructor(event) {
+    this.event = event;
+  }
+  event;
+  get attributes() {
+    return this.event.attributes;
+  }
+  fail(message) {
+    const error = new Error(
+      `expectOperation(${JSON.stringify(this.attributes["autter.operation.name"])}): ${message}`
+    );
+    error.name = "AssertionError";
+    throw error;
+  }
+  toHaveOutcome(outcome) {
+    const actual = this.attributes["autter.operation.outcome"];
+    if (actual !== outcome) this.fail(`expected outcome ${outcome}, got ${String(actual)}`);
+    return this;
+  }
+  toHaveKind(kind) {
+    const actual = this.attributes["autter.operation.kind"];
+    if (actual !== kind) this.fail(`expected kind ${kind}, got ${String(actual)}`);
+    return this;
+  }
+  /** Deep partial match against the summary attributes. */
+  toHaveContext(expected) {
+    if (!partialMatch(this.attributes, expected))
+      this.fail(`context does not match ${JSON.stringify(expected)}`);
+    return this;
+  }
+  toHaveStep(name, status) {
+    const steps = this.attributes["autter.operation.steps"] ?? [];
+    if (!steps.some((step) => step.name === name && (!status || step.status === status)))
+      this.fail(`no step ${name}${status ? ` (${status})` : ""}`);
+    return this;
+  }
+  toHaveErrorCode(code) {
+    const actual = this.attributes["autter.error.code"];
+    if (actual !== code) this.fail(`expected error code ${code}, got ${String(actual)}`);
+    return this;
+  }
+  toHaveLog(message, level) {
+    const logs = this.attributes["autter.operation.logs"] ?? [];
+    const ok = logs.some(
+      (log) => (typeof message === "string" ? log.message === message : message.test(log.message)) && (!level || log.level === level)
+    );
+    if (!ok) this.fail(`no inline log ${String(message)}`);
+    return this;
+  }
+  toHaveRequestId(requestId) {
+    const actual = this.attributes["autter.request.id"];
+    if (requestId === void 0 ? typeof actual !== "string" : actual !== requestId)
+      this.fail(`expected request id ${requestId ?? "(any)"}, got ${String(actual)}`);
+    return this;
+  }
+};
+function expectOperation(source, name) {
+  const events = Array.isArray(source) ? source.filter(isSummary) : source.operations;
+  const matches = events.filter((event2) => {
+    const actual = String(event2.attributes["autter.operation.name"] ?? "");
+    return typeof name === "string" ? actual === name : name.test(actual);
+  });
+  const event = matches[matches.length - 1];
+  if (!event) {
+    const seen = events.map((e) => e.attributes["autter.operation.name"]);
+    const error = new Error(
+      `expectOperation: no operation named ${String(name)} (saw ${JSON.stringify(seen)})`
+    );
+    error.name = "AssertionError";
+    throw error;
+  }
+  return new OperationExpectation(event);
+}
+export {
+  captureRuntime,
+  expectOperation,
+  memorySink
+};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@autter/runtime-node",
-	"version": "1.4.0",
-	"description": "Autter Runtime for Node.js: same-origin browser relay handler + curated OpenTelemetry server tracker",
+	"version": "1.6.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",
 	"main": "./dist/index.cjs",
@@ -12,7 +12,16 @@
 			"types": "./dist/index.d.ts",
 			"import": "./dist/index.js",
 			"require": "./dist/index.cjs"
-		}
+		},
+		"./testing": {
+			"types": "./dist/testing.d.ts",
+			"import": "./dist/testing.js",
+			"require": "./dist/testing.cjs"
+		},
+		"./package.json": "./package.json"
+	},
+	"bin": {
+		"autter-runtime": "./dist/cli.js"
 	},
 	"files": [
 		"dist"
@@ -23,8 +32,8 @@
 		"directory": "packages/runtime-node"
 	},
 	"scripts": {
-		"build": "tsup src/index.ts --format esm,cjs --dts --target node20 --clean",
-		"test": "npm run build && npm run build -w @autter/otlp-ingester && node --test test/*.test.mjs"
+		"build": "node ../../scripts/ensure-built.mjs runtime-core && tsup",
+		"test": "npm run build -w @autter/runtime-core && npm run build && npm run build -w @autter/otlp-ingester && node --test test/*.test.mjs"
 	},
 	"dependencies": {
 		"@opentelemetry/api": "^1.9.0",
@@ -39,7 +48,11 @@
 		"@opentelemetry/semantic-conventions": "^1.28.0"
 	},
 	"devDependencies": {
+		"@autter/runtime-core": "0.0.0",
 		"@types/node": "^22.10.0",
+		"express": "^4.21.2",
+		"fastify": "^5.12.5",
+		"koa": "^3.2.1",
 		"tsup": "^8.3.5",
 		"typescript": "^5.7.0"
 	},