autotel 6.5.0 → 7.0.0

package/dist/values-DApyq53y.cjs

@@ -0,0 +1,267 @@
+
+//#region src/values.ts
+/** The value as an object, or undefined when it is anything else. */
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+/** The string the value carries, or undefined when it carries anything else. */
+function asString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+/**
+* The value as a map of strings - a header bag, say - or undefined when it is
+* not an object at all. Entries whose value is not a string are left out.
+*/
+function asStringRecord(value) {
+	const record = asRecord(value);
+	if (record === void 0) return void 0;
+	const strings = {};
+	for (const [key, entry] of Object.entries(record)) {
+		const text = asString(entry);
+		if (text !== void 0) strings[key] = text;
+	}
+	return strings;
+}
+/** The scalar the value carries - string, number or boolean - or undefined. */
+function asScalar(value) {
+	return asString(value) ?? asNumber(value) ?? asBoolean(value);
+}
+/** The numbers the value carries as a list, or undefined when it is not one. */
+function asNumberArray(value) {
+	return Array.isArray(value) && value.every((v) => asNumber(v) !== void 0) ? value.map(Number) : void 0;
+}
+/** The booleans the value carries as a list, or undefined when it is not one. */
+function asBooleanArray(value) {
+	return Array.isArray(value) && value.every((v) => asBoolean(v) !== void 0) ? value.map(Boolean) : void 0;
+}
+/** The strings the value carries as a list, or undefined when it is not one. */
+function asStringArray(value) {
+	return Array.isArray(value) && value.every((v) => asString(v) !== void 0) ? value.map(String) : void 0;
+}
+/** A string with something in it - a blank one counts as absent. */
+function nonEmptyString(value) {
+	const text = asString(value);
+	return text !== void 0 && text.trim() !== "" ? text : void 0;
+}
+/** The number the value carries, or undefined when it carries anything else. */
+function asNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/** The boolean the value carries, or undefined when it carries anything else. */
+function asBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+/** Whether the value is callable. */
+function isFunction(value) {
+	return typeof value === "function";
+}
+/**
+* A config field that may be given as a value or as a function producing one,
+* resolved to the value.
+*/
+function resolveValue(source) {
+	return typeof source === "function" ? source() : source;
+}
+/**
+* An overloaded first argument that is either a name or an options object,
+* split into the two.
+*/
+function splitNameOrOptions(value) {
+	return typeof value === "string" ? { name: value } : { options: value };
+}
+/** The value as a callable, or undefined when it is not one. */
+function asFunction(value) {
+	if (typeof value !== "function") return void 0;
+	return value;
+}
+/**
+* The value as a plain object - one built from a literal, not an instance of
+* some class that has its own idea of what it is.
+*/
+function asPlainRecord(value) {
+	const record = asRecord(value);
+	return record !== void 0 && Object.getPrototypeOf(record) === Object.prototype ? record : void 0;
+}
+/** One field of a value, when the value is an object at all. */
+function readProperty(source, key) {
+	return asRecord(source)?.[key];
+}
+/**
+* What a value is, for a diagnostic message: the same words `typeof` uses,
+* plus `null` and `array`, which are the two cases `typeof` answers uselessly.
+*/
+function describeValue(value) {
+	if (value === null) return "null";
+	return Array.isArray(value) ? "array" : typeof value;
+}
+/**
+* The Error a caller's callback expects, wrapping whatever was actually
+* thrown - a string, a number, an object with no stack.
+*/
+function toError(cause) {
+	return cause instanceof Error ? cause : new Error(String(cause));
+}
+/**
+* A value as an OTel attribute, or undefined when it cannot be one.
+*
+* OTel accepts scalars and homogeneous arrays of scalars. Anything else - a
+* nested object, a mixed array - is stringified rather than dropped, because
+* a caller that attached it wanted to see it.
+*/
+function toAttributeValue(value) {
+	if (value === void 0 || value === null) return void 0;
+	const scalar = asString(value) ?? asNumber(value) ?? asBoolean(value);
+	if (scalar !== void 0) return scalar;
+	if (Array.isArray(value)) return toAttributeArray(value);
+	return JSON.stringify(value);
+}
+/** The scalars in an array, dropping the entries OTel cannot carry. */
+function toAttributeArray(values) {
+	const strings = values.filter((v) => typeof v === "string");
+	if (strings.length === values.length) return strings;
+	const numbers = values.filter((v) => typeof v === "number");
+	if (numbers.length === values.length) return numbers;
+	const booleans = values.filter((v) => typeof v === "boolean");
+	if (booleans.length === values.length) return booleans;
+	return values.length > 0 ? JSON.stringify(values) : void 0;
+}
+/** Whether a Node-style `process` global exists at all - edge runtimes have none. */
+function hasProcess() {
+	return typeof process !== "undefined";
+}
+/**
+* Whether this build is running outside production, for warnings meant to
+* help during development. `process` is probed because the same code runs in
+* edge runtimes that have no such global.
+*/
+function isDevelopment() {
+	return hasProcess() && process.env.NODE_ENV !== "production";
+}
+
+//#endregion
+Object.defineProperty(exports, 'asBoolean', {
+  enumerable: true,
+  get: function () {
+    return asBoolean;
+  }
+});
+Object.defineProperty(exports, 'asBooleanArray', {
+  enumerable: true,
+  get: function () {
+    return asBooleanArray;
+  }
+});
+Object.defineProperty(exports, 'asFunction', {
+  enumerable: true,
+  get: function () {
+    return asFunction;
+  }
+});
+Object.defineProperty(exports, 'asNumber', {
+  enumerable: true,
+  get: function () {
+    return asNumber;
+  }
+});
+Object.defineProperty(exports, 'asNumberArray', {
+  enumerable: true,
+  get: function () {
+    return asNumberArray;
+  }
+});
+Object.defineProperty(exports, 'asPlainRecord', {
+  enumerable: true,
+  get: function () {
+    return asPlainRecord;
+  }
+});
+Object.defineProperty(exports, 'asRecord', {
+  enumerable: true,
+  get: function () {
+    return asRecord;
+  }
+});
+Object.defineProperty(exports, 'asScalar', {
+  enumerable: true,
+  get: function () {
+    return asScalar;
+  }
+});
+Object.defineProperty(exports, 'asString', {
+  enumerable: true,
+  get: function () {
+    return asString;
+  }
+});
+Object.defineProperty(exports, 'asStringArray', {
+  enumerable: true,
+  get: function () {
+    return asStringArray;
+  }
+});
+Object.defineProperty(exports, 'asStringRecord', {
+  enumerable: true,
+  get: function () {
+    return asStringRecord;
+  }
+});
+Object.defineProperty(exports, 'describeValue', {
+  enumerable: true,
+  get: function () {
+    return describeValue;
+  }
+});
+Object.defineProperty(exports, 'hasProcess', {
+  enumerable: true,
+  get: function () {
+    return hasProcess;
+  }
+});
+Object.defineProperty(exports, 'isDevelopment', {
+  enumerable: true,
+  get: function () {
+    return isDevelopment;
+  }
+});
+Object.defineProperty(exports, 'isFunction', {
+  enumerable: true,
+  get: function () {
+    return isFunction;
+  }
+});
+Object.defineProperty(exports, 'nonEmptyString', {
+  enumerable: true,
+  get: function () {
+    return nonEmptyString;
+  }
+});
+Object.defineProperty(exports, 'readProperty', {
+  enumerable: true,
+  get: function () {
+    return readProperty;
+  }
+});
+Object.defineProperty(exports, 'resolveValue', {
+  enumerable: true,
+  get: function () {
+    return resolveValue;
+  }
+});
+Object.defineProperty(exports, 'splitNameOrOptions', {
+  enumerable: true,
+  get: function () {
+    return splitNameOrOptions;
+  }
+});
+Object.defineProperty(exports, 'toAttributeValue', {
+  enumerable: true,
+  get: function () {
+    return toAttributeValue;
+  }
+});
+Object.defineProperty(exports, 'toError', {
+  enumerable: true,
+  get: function () {
+    return toError;
+  }
+});

package/dist/webhook.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_structured_error = require('./structured-error-CHg7DoIQ.cjs');
-const require_functional = require('./functional-C0uAZq2X.cjs');
-const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
+const require_structured_error = require('./structured-error--_wXpd_C.cjs');
+const require_functional = require('./functional-Da6Yv64r.cjs');
+const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/webhook.ts

package/dist/webhook.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 { Link, SpanContext } from "@opentelemetry/api";
 //#region src/webhook.d.ts
 /**

package/dist/webhook.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 { Link, SpanContext } from "@opentelemetry/api";
 //#region src/webhook.d.ts
 /**

package/dist/webhook.js

@@ -1,6 +1,6 @@
-import { r as recordStructuredError } from "./structured-error-9--cxBay.js";
-import { c as withTracing } from "./functional-DX7Zvag0.js";
-import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
+import { r as recordStructuredError } from "./structured-error-YIuka-FE.js";
+import { c as withTracing } from "./functional-uSbNnnxK.js";
+import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { SpanKind, trace } from "@opentelemetry/api";
 
 //#region src/webhook.ts

package/dist/workflow-distributed.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_functional = require('./functional-C0uAZq2X.cjs');
-const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
+const require_values = require('./values-DApyq53y.cjs');
+const require_functional = require('./functional-Da6Yv64r.cjs');
+const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_business_baggage = require('./business-baggage.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
@@ -239,10 +240,10 @@ function traceDistributedWorkflow(config) {
 					require_correlated_events.emitCorrelatedEvent(baseCtx, "workflow.completed", { "workflow.id": workflowId });
 					return result;
 				} catch (error) {
-					config.onError?.(workflowCtx, error);
+					config.onError?.(workflowCtx, require_values.toError(error));
 					require_correlated_events.emitCorrelatedEvent(baseCtx, "workflow.failed", {
 						"workflow.id": workflowId,
-						"workflow.error": error.message
+						"workflow.error": error instanceof Error ? error.message : String(error)
 					});
 					throw error;
 				}
@@ -299,7 +300,8 @@ function traceDistributedStep(config) {
 			return async (...args) => {
 				let baggageValues = null;
 				const extractBaggage = config.extractBaggage ?? true;
-				if (typeof extractBaggage === "function") baggageValues = extractBaggage(args);
+				const readBaggage = require_values.isFunction(extractBaggage) ? extractBaggage : void 0;
+				if (readBaggage) baggageValues = readBaggage(args);
 				else if (extractBaggage) {
 					const extracted = WorkflowBaggage.get(baseCtx);
 					if (extracted.workflowId && extracted.workflowName) baggageValues = extracted;
@@ -367,10 +369,10 @@ function traceDistributedStep(config) {
 					require_correlated_events.emitCorrelatedEvent(baseCtx, "workflow.step.completed", { "workflow.step.name": config.name });
 					return result;
 				} catch (error) {
-					config.onError?.(stepCtx, error);
+					config.onError?.(stepCtx, require_values.toError(error));
 					require_correlated_events.emitCorrelatedEvent(baseCtx, "workflow.step.failed", {
 						"workflow.step.name": config.name,
-						"workflow.step.error": error.message,
+						"workflow.step.error": error instanceof Error ? error.message : String(error),
 						...compensationData && { "workflow.step.requires_compensation": true }
 					});
 					throw error;

package/dist/workflow-distributed.d.cts

@@ -1,4 +1,5 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.cjs";
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
+import { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
 import { SafeBaggageSchema } from "./business-baggage.cjs";
 //#region src/workflow-distributed.d.ts
 /**
@@ -98,7 +99,7 @@ type WorkflowBaggageValues = {
 /**
  * Configuration for distributed workflow tracing
  */
-interface DistributedWorkflowConfig {
+interface DistributedWorkflowConfig<TResult = unknown> {
   /** Workflow name/type (e.g., "OrderFulfillment", "UserOnboarding") */
   name: string;
   /**
@@ -135,14 +136,14 @@ interface DistributedWorkflowConfig {
   /** Callback on workflow start */
   onStart?: (ctx: DistributedWorkflowContext) => void;
   /** Callback on workflow completion */
-  onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;
+  onComplete?: (ctx: DistributedWorkflowContext, result: TResult) => void;
   /** Callback on workflow error */
   onError?: (ctx: DistributedWorkflowContext, error: Error) => void;
 }
 /**
  * Configuration for distributed workflow step
  */
-interface DistributedStepConfig {
+interface DistributedStepConfig<TResult = unknown> {
   /** Step name (e.g., "ReserveInventory", "ChargePayment") */
   name: string;
   /**
@@ -165,7 +166,7 @@ interface DistributedStepConfig {
   /** Callback on step start */
   onStart?: (ctx: DistributedStepContext) => void;
   /** Callback on step completion */
-  onComplete?: (ctx: DistributedStepContext, result: unknown) => void;
+  onComplete?: (ctx: DistributedStepContext, result: TResult) => void;
   /** Callback on step error */
   onError?: (ctx: DistributedStepContext, error: Error) => void;
 }
@@ -209,7 +210,7 @@ interface DistributedStepContext extends TraceContext {
   /** Get headers with updated workflow baggage for downstream calls */
   getWorkflowHeaders(): Record<string, string>;
   /** Mark step as requiring compensation on failure */
-  requiresCompensation(compensationData?: Record<string, unknown>): void;
+  requiresCompensation(compensationData?: UnknownRecord): void;
 }
 /**
  * Create a traced distributed workflow function
@@ -239,7 +240,7 @@ interface DistributedStepContext extends TraceContext {
  * });
  * ```
  */
-declare function traceDistributedWorkflow(config: DistributedWorkflowConfig): <TArgs extends unknown[], TReturn>(fnFactory: (ctx: DistributedWorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
+declare function traceDistributedWorkflow<TResult = unknown>(config: DistributedWorkflowConfig<TResult>): <TArgs extends unknown[], TReturn extends TResult>(fnFactory: (ctx: DistributedWorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Create a traced distributed workflow step
  *
@@ -279,7 +280,7 @@ declare function traceDistributedWorkflow(config: DistributedWorkflowConfig): <T
  * });
  * ```
  */
-declare function traceDistributedStep(config: DistributedStepConfig): <TArgs extends unknown[], TReturn>(fnFactory: (ctx: DistributedStepContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
+declare function traceDistributedStep<TResult = unknown>(config: DistributedStepConfig<TResult>): <TArgs extends unknown[], TReturn extends TResult>(fnFactory: (ctx: DistributedStepContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Generate a unique workflow ID
  *

package/dist/workflow-distributed.d.ts

@@ -1,4 +1,5 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.js";
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
+import { n as TraceContext } from "./trace-context-f89xPJbK.js";
 import { SafeBaggageSchema } from "./business-baggage.js";
 //#region src/workflow-distributed.d.ts
 /**
@@ -98,7 +99,7 @@ type WorkflowBaggageValues = {
 /**
  * Configuration for distributed workflow tracing
  */
-interface DistributedWorkflowConfig {
+interface DistributedWorkflowConfig<TResult = unknown> {
   /** Workflow name/type (e.g., "OrderFulfillment", "UserOnboarding") */
   name: string;
   /**
@@ -135,14 +136,14 @@ interface DistributedWorkflowConfig {
   /** Callback on workflow start */
   onStart?: (ctx: DistributedWorkflowContext) => void;
   /** Callback on workflow completion */
-  onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;
+  onComplete?: (ctx: DistributedWorkflowContext, result: TResult) => void;
   /** Callback on workflow error */
   onError?: (ctx: DistributedWorkflowContext, error: Error) => void;
 }
 /**
  * Configuration for distributed workflow step
  */
-interface DistributedStepConfig {
+interface DistributedStepConfig<TResult = unknown> {
   /** Step name (e.g., "ReserveInventory", "ChargePayment") */
   name: string;
   /**
@@ -165,7 +166,7 @@ interface DistributedStepConfig {
   /** Callback on step start */
   onStart?: (ctx: DistributedStepContext) => void;
   /** Callback on step completion */
-  onComplete?: (ctx: DistributedStepContext, result: unknown) => void;
+  onComplete?: (ctx: DistributedStepContext, result: TResult) => void;
   /** Callback on step error */
   onError?: (ctx: DistributedStepContext, error: Error) => void;
 }
@@ -209,7 +210,7 @@ interface DistributedStepContext extends TraceContext {
   /** Get headers with updated workflow baggage for downstream calls */
   getWorkflowHeaders(): Record<string, string>;
   /** Mark step as requiring compensation on failure */
-  requiresCompensation(compensationData?: Record<string, unknown>): void;
+  requiresCompensation(compensationData?: UnknownRecord): void;
 }
 /**
  * Create a traced distributed workflow function
@@ -239,7 +240,7 @@ interface DistributedStepContext extends TraceContext {
  * });
  * ```
  */
-declare function traceDistributedWorkflow(config: DistributedWorkflowConfig): <TArgs extends unknown[], TReturn>(fnFactory: (ctx: DistributedWorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
+declare function traceDistributedWorkflow<TResult = unknown>(config: DistributedWorkflowConfig<TResult>): <TArgs extends unknown[], TReturn extends TResult>(fnFactory: (ctx: DistributedWorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Create a traced distributed workflow step
  *
@@ -279,7 +280,7 @@ declare function traceDistributedWorkflow(config: DistributedWorkflowConfig): <T
  * });
  * ```
  */
-declare function traceDistributedStep(config: DistributedStepConfig): <TArgs extends unknown[], TReturn>(fnFactory: (ctx: DistributedStepContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
+declare function traceDistributedStep<TResult = unknown>(config: DistributedStepConfig<TResult>): <TArgs extends unknown[], TReturn extends TResult>(fnFactory: (ctx: DistributedStepContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
 /**
  * Generate a unique workflow ID
  *

package/dist/workflow-distributed.js

@@ -1,5 +1,6 @@
-import { c as withTracing } from "./functional-DX7Zvag0.js";
-import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
+import { h as isFunction, x as toError } from "./values-BenyvWKz.js";
+import { c as withTracing } from "./functional-uSbNnnxK.js";
+import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { createSafeBaggageSchema } from "./business-baggage.js";
 import { SpanKind, context, propagation } from "@opentelemetry/api";
 
@@ -238,10 +239,10 @@ function traceDistributedWorkflow(config) {
 					emitCorrelatedEvent(baseCtx, "workflow.completed", { "workflow.id": workflowId });
 					return result;
 				} catch (error) {
-					config.onError?.(workflowCtx, error);
+					config.onError?.(workflowCtx, toError(error));
 					emitCorrelatedEvent(baseCtx, "workflow.failed", {
 						"workflow.id": workflowId,
-						"workflow.error": error.message
+						"workflow.error": error instanceof Error ? error.message : String(error)
 					});
 					throw error;
 				}
@@ -298,7 +299,8 @@ function traceDistributedStep(config) {
 			return async (...args) => {
 				let baggageValues = null;
 				const extractBaggage = config.extractBaggage ?? true;
-				if (typeof extractBaggage === "function") baggageValues = extractBaggage(args);
+				const readBaggage = isFunction(extractBaggage) ? extractBaggage : void 0;
+				if (readBaggage) baggageValues = readBaggage(args);
 				else if (extractBaggage) {
 					const extracted = WorkflowBaggage.get(baseCtx);
 					if (extracted.workflowId && extracted.workflowName) baggageValues = extracted;
@@ -366,10 +368,10 @@ function traceDistributedStep(config) {
 					emitCorrelatedEvent(baseCtx, "workflow.step.completed", { "workflow.step.name": config.name });
 					return result;
 				} catch (error) {
-					config.onError?.(stepCtx, error);
+					config.onError?.(stepCtx, toError(error));
 					emitCorrelatedEvent(baseCtx, "workflow.step.failed", {
 						"workflow.step.name": config.name,
-						"workflow.step.error": error.message,
+						"workflow.step.error": error instanceof Error ? error.message : String(error),
 						...compensationData && { "workflow.step.requires_compensation": true }
 					});
 					throw error;

package/dist/workflow.cjs

@@ -1,8 +1,9 @@
 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_trace_helpers = require('./trace-helpers.cjs');
-const require_functional = require('./functional-C0uAZq2X.cjs');
-const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
+const require_functional = require('./functional-Da6Yv64r.cjs');
+const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_trace_factory_validation = require('./trace-factory-validation-Dc8epn87.cjs');
 let node_async_hooks = require("node:async_hooks");
 node_async_hooks = require_rolldown_runtime.__toESM(node_async_hooks, 1);
@@ -98,23 +99,31 @@ const workflowContextStorage = new node_async_hooks.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 (!require_values.asRecord(config)) throw new TypeError(`${fn}: config must be an object`);
+	if (require_values.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 (require_values.asString(config.workflowId) === void 0 && !require_values.isFunction(config.workflowId)) throw new TypeError("traceWorkflow: config.workflowId must be a string or function");
 	const spanName = `workflow.${config.name}`;
 	return (fnFactory) => {
 		require_trace_factory_validation.assertTraceFactory("traceWorkflow", fnFactory);
 		return require_functional.withTracing({ name: spanName })((baseCtx) => {
 			return async (...args) => {
-				const workflowId = typeof config.workflowId === "function" ? config.workflowId(...args) : config.workflowId;
+				const workflowId = require_values.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 = require_values.toAttributeValue(value);
+					if (attribute !== void 0) ctx.setAttribute(key, attribute);
 				}
 				return workflowContextStorage.run(ctx, async () => {
 					try {
@@ -126,13 +135,13 @@ function traceWorkflow(config) {
 						return result;
 					} catch (error) {
 						ctx.setWorkflowStatus("failed");
-						config.onFailed?.(ctx, error);
+						config.onFailed?.(ctx, require_values.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(require_values.toError(error));
 								ctx.setWorkflowStatus("compensated");
 							} catch (compensationError) {
 								ctx.setWorkflowStatus("compensation_failed");
@@ -147,10 +156,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 (!require_values.isFunction(handler)) throw new TypeError("traceStep(config)(handler): handler must be a function");
 		return require_functional.withTracing({ name: `step.${config.name}` })((baseCtx) => {
 			return async (...args) => {
 				const workflowCtx = workflowContextStorage.getStore() ?? null;
@@ -160,8 +168,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 = require_values.toAttributeValue(value);
+					if (attribute !== void 0) ctx.setAttribute(key, attribute);
 				}
 				await addStepLinks(ctx, config, workflowCtx);
 				if (config.compensate && workflowCtx) {
@@ -188,7 +197,7 @@ function traceStep(config) {
 					config.onComplete?.(ctx);
 					return result;
 				} catch (error) {
-					lastError = error;
+					lastError = require_values.toError(error);
 					if (attempt < maxAttempts) require_correlated_events.emitCorrelatedEvent(ctx, "step_retry_scheduled", {
 						"workflow.step.error": String(error),
 						"workflow.step.attempt": attempt
@@ -267,7 +276,7 @@ function createWorkflowContext(baseCtx, workflowName, workflowId) {
 					this.recordCompensation(stepName, true);
 					step.status = "compensated";
 				} catch (compensationError) {
-					this.recordCompensation(stepName, false, compensationError);
+					this.recordCompensation(stepName, false, require_values.toError(compensationError));
 					throw compensationError;
 				}
 			}