autotel 6.5.0 → 7.0.0

package/dist/workflow.d.cts

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.cjs";
+import { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
 import { Attributes, SpanContext } from "@opentelemetry/api";
 //#region src/workflow.d.ts
 /**
@@ -106,33 +106,6 @@ interface StepContext extends TraceContext {
   /** Get workflow context */
   getWorkflowContext(): WorkflowContext | null;
 }
-/**
- * Create a traced workflow function
- *
- * Wraps business logic in a workflow span with automatic step tracking,
- * correlation via workflow ID, and compensation support.
- *
- * @param config - Workflow configuration
- * @returns Factory function that wraps your workflow logic
- *
- * @example Order fulfillment workflow
- * ```typescript
- * export const fulfillOrder = traceWorkflow({
- *   name: 'OrderFulfillment',
- *   workflowId: (order) => order.id,
- *   version: '2.0',
- * })(ctx => async (order: Order) => {
- *   ctx.setAttribute('order.total', order.total);
- *
- *   await validateOrder(order);
- *   await processPayment(order);
- *   await fulfillItems(order);
- *   await notifyCustomer(order);
- *
- *   return { success: true, orderId: order.id };
- * });
- * ```
- */
 declare function traceWorkflow<TConfigArgs extends unknown[] = unknown[]>(config: WorkflowConfig<TConfigArgs>): <TArgs extends TConfigArgs, TReturn>(fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Create a traced workflow step

package/dist/workflow.d.ts

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.js";
+import { n as TraceContext } from "./trace-context-f89xPJbK.js";
 import { Attributes, SpanContext } from "@opentelemetry/api";
 //#region src/workflow.d.ts
 /**
@@ -106,33 +106,6 @@ interface StepContext extends TraceContext {
   /** Get workflow context */
   getWorkflowContext(): WorkflowContext | null;
 }
-/**
- * Create a traced workflow function
- *
- * Wraps business logic in a workflow span with automatic step tracking,
- * correlation via workflow ID, and compensation support.
- *
- * @param config - Workflow configuration
- * @returns Factory function that wraps your workflow logic
- *
- * @example Order fulfillment workflow
- * ```typescript
- * export const fulfillOrder = traceWorkflow({
- *   name: 'OrderFulfillment',
- *   workflowId: (order) => order.id,
- *   version: '2.0',
- * })(ctx => async (order: Order) => {
- *   ctx.setAttribute('order.total', order.total);
- *
- *   await validateOrder(order);
- *   await processPayment(order);
- *   await fulfillItems(order);
- *   await notifyCustomer(order);
- *
- *   return { success: true, orderId: order.id };
- * });
- * ```
- */
 declare function traceWorkflow<TConfigArgs extends unknown[] = unknown[]>(config: WorkflowConfig<TConfigArgs>): <TArgs extends TConfigArgs, TReturn>(fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Create a traced workflow step

package/dist/workflow.js

@@ -1,6 +1,7 @@
+import { b as toAttributeValue, g as nonEmptyString, h as isFunction, l as asString, s as asRecord, x as toError } from "./values-BenyvWKz.js";
 import { getActiveSpan } from "./trace-helpers.js";
-import { c as withTracing } from "./functional-DX7Zvag0.js";
-import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
+import { c as withTracing } from "./functional-uSbNnnxK.js";
+import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { t as assertTraceFactory } from "./trace-factory-validation-BjVAinz6.js";
 import * as nodeAsyncHooks from "node:async_hooks";
 
@@ -95,23 +96,31 @@ const workflowContextStorage = new nodeAsyncHooks.AsyncLocalStorage();
 * });
 * ```
 */
+/**
+* Check a config a JavaScript caller may have built by hand: TypeScript has
+* already checked it for everyone else.
+*/
+function assertNamedConfig(fn, config) {
+	if (!asRecord(config)) throw new TypeError(`${fn}: config must be an object`);
+	if (nonEmptyString(config.name) === void 0) throw new TypeError(`${fn}: config.name must be a non-empty string`);
+}
 function traceWorkflow(config) {
-	if (!config || typeof config !== "object") throw new TypeError("traceWorkflow: config must be an object");
-	if (typeof config.name !== "string" || config.name.trim() === "") throw new TypeError("traceWorkflow: config.name must be a non-empty string");
-	if (typeof config.workflowId !== "string" && typeof config.workflowId !== "function") throw new TypeError("traceWorkflow: config.workflowId must be a string or function");
+	assertNamedConfig("traceWorkflow", config);
+	if (asString(config.workflowId) === void 0 && !isFunction(config.workflowId)) throw new TypeError("traceWorkflow: config.workflowId must be a string or function");
 	const spanName = `workflow.${config.name}`;
 	return (fnFactory) => {
 		assertTraceFactory("traceWorkflow", fnFactory);
 		return withTracing({ name: spanName })((baseCtx) => {
 			return async (...args) => {
-				const workflowId = typeof config.workflowId === "function" ? config.workflowId(...args) : config.workflowId;
+				const workflowId = isFunction(config.workflowId) ? config.workflowId(...args) : config.workflowId;
 				const ctx = createWorkflowContext(baseCtx, config.name, workflowId);
 				ctx.setAttribute("workflow.name", config.name);
 				ctx.setAttribute("workflow.id", workflowId);
 				if (config.version) ctx.setAttribute("workflow.version", config.version);
 				ctx.setAttribute("workflow.status", "running");
-				if (config.attributes) {
-					for (const [key, value] of Object.entries(config.attributes)) if (value !== void 0) ctx.setAttribute(key, value);
+				if (config.attributes) for (const [key, value] of Object.entries(config.attributes)) {
+					const attribute = toAttributeValue(value);
+					if (attribute !== void 0) ctx.setAttribute(key, attribute);
 				}
 				return workflowContextStorage.run(ctx, async () => {
 					try {
@@ -123,13 +132,13 @@ function traceWorkflow(config) {
 						return result;
 					} catch (error) {
 						ctx.setWorkflowStatus("failed");
-						config.onFailed?.(ctx, error);
+						config.onFailed?.(ctx, toError(error));
 						const state = getWorkflowState();
 						if (state && state.compensations.size > 0) {
 							ctx.setWorkflowStatus("compensating");
 							config.onCompensating?.(ctx);
 							try {
-								await ctx.compensate(error);
+								await ctx.compensate(toError(error));
 								ctx.setWorkflowStatus("compensated");
 							} catch (compensationError) {
 								ctx.setWorkflowStatus("compensation_failed");
@@ -144,10 +153,9 @@ function traceWorkflow(config) {
 	};
 }
 function traceStep(config) {
-	if (!config || typeof config !== "object") throw new TypeError("traceStep: config must be an object");
-	if (typeof config.name !== "string" || config.name.trim() === "") throw new TypeError("traceStep: config.name must be a non-empty string");
+	assertNamedConfig("traceStep", config);
 	return ((handler) => {
-		if (typeof handler !== "function") throw new TypeError("traceStep(config)(handler): handler must be a function");
+		if (!isFunction(handler)) throw new TypeError("traceStep(config)(handler): handler must be a function");
 		return withTracing({ name: `step.${config.name}` })((baseCtx) => {
 			return async (...args) => {
 				const workflowCtx = workflowContextStorage.getStore() ?? null;
@@ -157,8 +165,9 @@ function traceStep(config) {
 				ctx.setAttribute("workflow.step.status", "running");
 				if (config.description) ctx.setAttribute("workflow.step.description", config.description);
 				if (config.idempotent) ctx.setAttribute("workflow.step.idempotent", true);
-				if (config.attributes) {
-					for (const [key, value] of Object.entries(config.attributes)) if (value !== void 0) ctx.setAttribute(key, value);
+				if (config.attributes) for (const [key, value] of Object.entries(config.attributes)) {
+					const attribute = toAttributeValue(value);
+					if (attribute !== void 0) ctx.setAttribute(key, attribute);
 				}
 				await addStepLinks(ctx, config, workflowCtx);
 				if (config.compensate && workflowCtx) {
@@ -185,7 +194,7 @@ function traceStep(config) {
 					config.onComplete?.(ctx);
 					return result;
 				} catch (error) {
-					lastError = error;
+					lastError = toError(error);
 					if (attempt < maxAttempts) emitCorrelatedEvent(ctx, "step_retry_scheduled", {
 						"workflow.step.error": String(error),
 						"workflow.step.attempt": attempt
@@ -264,7 +273,7 @@ function createWorkflowContext(baseCtx, workflowName, workflowId) {
 					this.recordCompensation(stepName, true);
 					step.status = "compensated";
 				} catch (compensationError) {
-					this.recordCompensation(stepName, false, compensationError);
+					this.recordCompensation(stepName, false, toError(compensationError));
 					throw compensationError;
 				}
 			}

package/dist/yaml-config.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
+const require_values = require('./values-DApyq53y.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_node_require = require('./node-require-PFqDihze.cjs');
+const require_node_require = require('./node-require-EifOMikz.cjs');
 let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -71,15 +72,31 @@ function substituteEnvVars(value) {
 * @param obj - Object to process
 * @returns Object with all string values having env vars substituted
 */
-function substituteEnvVarsDeep(obj) {
-	if (typeof obj === "string") return substituteEnvVars(obj);
-	if (Array.isArray(obj)) return obj.map((item) => substituteEnvVarsDeep(item));
-	if (obj && typeof obj === "object") {
+function substituteEnvVarsDeep(value) {
+	if (Array.isArray(value)) return value.map(substituteEnvVarsDeep);
+	const mapping = asYamlMapping(value);
+	if (mapping) {
 		const result = {};
-		for (const [key, value] of Object.entries(obj)) result[key] = substituteEnvVarsDeep(value);
+		for (const [key, entry] of Object.entries(mapping)) result[key] = substituteEnvVarsDeep(entry);
 		return result;
 	}
-	return obj;
+	const text = require_values.asString(value);
+	return text === void 0 ? value : substituteEnvVars(text);
+}
+/** The mapping a YAML value is, when it is one. */
+function asYamlMapping(value) {
+	return require_values.asRecord(value) === void 0 ? void 0 : value;
+}
+/**
+* A YAML document read into the config shape, with `${env:...}` placeholders
+* resolved.
+*
+* This is the boundary: the file is text until here. Every field of
+* YamlConfig is optional, so any document satisfies it, and
+* `yamlToAutotelConfig` picks out only the fields it understands.
+*/
+function parseYamlConfig(content) {
+	return asYamlMapping(substituteEnvVarsDeep(loadYamlParser()(content))) ?? {};
 }
 /**
 * Find YAML config file path
@@ -192,8 +209,7 @@ function loadYamlConfig() {
 	const filePath = findConfigFile();
 	if (!filePath) return null;
 	try {
-		const content = node_fs.readFileSync(filePath, "utf8");
-		return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+		return yamlToAutotelConfig(parseYamlConfig(node_fs.readFileSync(filePath, "utf8")));
 	} catch (error) {
 		console.error(`[autotel] Failed to load YAML config from ${filePath}:`, error);
 		return null;
@@ -217,8 +233,7 @@ function loadYamlConfig() {
 */
 function loadYamlConfigFromFile(filePath) {
 	const resolved = node_path.default.resolve(filePath);
-	const content = node_fs.readFileSync(resolved, "utf8");
-	return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+	return yamlToAutotelConfig(parseYamlConfig(node_fs.readFileSync(resolved, "utf8")));
 }
 /**
 * Check if a YAML config file exists (without loading it)

package/dist/yaml-config.d.cts

@@ -1,6 +1,12 @@
-import { h as SamplingPreset } from "./sampling-BR9fkSwx.cjs";
-import { a as AutotelConfig, o as OtlpSignal } from "./init-ncTMKZ-s.cjs";
+import { h as SamplingPreset } from "./sampling-CmRdnXUi.cjs";
+import { a as AutotelConfig, o as OtlpSignal } from "./init-DrlL1eis.cjs";
 //#region src/yaml-config.d.ts
+/** A value as a YAML document carries it: scalars, sequences, mappings. */
+type YamlValue = string | number | boolean | null | YamlValue[] | YamlMapping;
+/** A YAML mapping - keys the reader has not looked at yet. */
+interface YamlMapping {
+  [key: string]: YamlValue;
+}
 /**
  * YAML config structure
  * Maps to AutotelConfig with user-friendly naming
@@ -78,4 +84,4 @@ declare function loadYamlConfigFromFile(filePath: string): Partial<AutotelConfig
  */
 declare function hasYamlConfig(): boolean;
 //#endregion
-export { YamlConfig, hasYamlConfig, loadYamlConfig, loadYamlConfigFromFile };
+export { YamlConfig, YamlMapping, YamlValue, hasYamlConfig, loadYamlConfig, loadYamlConfigFromFile };

package/dist/yaml-config.d.ts

@@ -1,6 +1,12 @@
-import { h as SamplingPreset } from "./sampling-CP3e7-Yr.js";
-import { a as AutotelConfig, o as OtlpSignal } from "./init-pPI3JRRf.js";
+import { h as SamplingPreset } from "./sampling-CM5S2Lp3.js";
+import { a as AutotelConfig, o as OtlpSignal } from "./init-BgnYi2sm.js";
 //#region src/yaml-config.d.ts
+/** A value as a YAML document carries it: scalars, sequences, mappings. */
+type YamlValue = string | number | boolean | null | YamlValue[] | YamlMapping;
+/** A YAML mapping - keys the reader has not looked at yet. */
+interface YamlMapping {
+  [key: string]: YamlValue;
+}
 /**
  * YAML config structure
  * Maps to AutotelConfig with user-friendly naming
@@ -78,4 +84,4 @@ declare function loadYamlConfigFromFile(filePath: string): Partial<AutotelConfig
  */
 declare function hasYamlConfig(): boolean;
 //#endregion
-export { YamlConfig, hasYamlConfig, loadYamlConfig, loadYamlConfigFromFile };
+export { YamlConfig, YamlMapping, YamlValue, hasYamlConfig, loadYamlConfig, loadYamlConfigFromFile };

package/dist/yaml-config.js

@@ -1,5 +1,6 @@
+import { l as asString, s as asRecord } from "./values-BenyvWKz.js";
 import { AdaptiveSampler, AlwaysSampler, NeverSampler, RandomSampler } from "./sampling.js";
-import { t as requireModule } from "./node-require-vROmTeJ8.js";
+import { t as requireModule } from "./node-require-DSPjaw_l.js";
 import * as nodeFs from "node:fs";
 import path from "node:path";
 
@@ -67,15 +68,31 @@ function substituteEnvVars(value) {
 * @param obj - Object to process
 * @returns Object with all string values having env vars substituted
 */
-function substituteEnvVarsDeep(obj) {
-	if (typeof obj === "string") return substituteEnvVars(obj);
-	if (Array.isArray(obj)) return obj.map((item) => substituteEnvVarsDeep(item));
-	if (obj && typeof obj === "object") {
+function substituteEnvVarsDeep(value) {
+	if (Array.isArray(value)) return value.map(substituteEnvVarsDeep);
+	const mapping = asYamlMapping(value);
+	if (mapping) {
 		const result = {};
-		for (const [key, value] of Object.entries(obj)) result[key] = substituteEnvVarsDeep(value);
+		for (const [key, entry] of Object.entries(mapping)) result[key] = substituteEnvVarsDeep(entry);
 		return result;
 	}
-	return obj;
+	const text = asString(value);
+	return text === void 0 ? value : substituteEnvVars(text);
+}
+/** The mapping a YAML value is, when it is one. */
+function asYamlMapping(value) {
+	return asRecord(value) === void 0 ? void 0 : value;
+}
+/**
+* A YAML document read into the config shape, with `${env:...}` placeholders
+* resolved.
+*
+* This is the boundary: the file is text until here. Every field of
+* YamlConfig is optional, so any document satisfies it, and
+* `yamlToAutotelConfig` picks out only the fields it understands.
+*/
+function parseYamlConfig(content) {
+	return asYamlMapping(substituteEnvVarsDeep(loadYamlParser()(content))) ?? {};
 }
 /**
 * Find YAML config file path
@@ -188,8 +205,7 @@ function loadYamlConfig() {
 	const filePath = findConfigFile();
 	if (!filePath) return null;
 	try {
-		const content = nodeFs.readFileSync(filePath, "utf8");
-		return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+		return yamlToAutotelConfig(parseYamlConfig(nodeFs.readFileSync(filePath, "utf8")));
 	} catch (error) {
 		console.error(`[autotel] Failed to load YAML config from ${filePath}:`, error);
 		return null;
@@ -213,8 +229,7 @@ function loadYamlConfig() {
 */
 function loadYamlConfigFromFile(filePath) {
 	const resolved = path.resolve(filePath);
-	const content = nodeFs.readFileSync(resolved, "utf8");
-	return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+	return yamlToAutotelConfig(parseYamlConfig(nodeFs.readFileSync(resolved, "utf8")));
 }
 /**
 * Check if a YAML config file exists (without loading it)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel",
-  "version": "6.5.0",
+  "version": "7.0.0",
   "description": "Write Once, Observe Anywhere",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -125,6 +125,11 @@
       "import": "./dist/attribute-redacting-processor.js",
       "require": "./dist/attribute-redacting-processor.cjs"
     },
+    "./exception-fingerprint": {
+      "types": "./dist/exception-fingerprint.d.ts",
+      "import": "./dist/exception-fingerprint.js",
+      "require": "./dist/exception-fingerprint.cjs"
+    },
     "./functional": {
       "types": "./dist/functional.d.ts",
       "import": "./dist/functional.js",