autotel 6.4.1 → 7.0.0

package/README.md

@@ -237,9 +237,9 @@ export const createUser = trace(async function createUser(
 
 - Named function expressions automatically become span names (`code.function`).
 - Errors are recorded, spans are ended, and status is set automatically.
-- When inference may be unreliable, use `trace('user.create', fn)` or
-  `instrument({ key: 'user.create', fn })`. For a module-sized batch, use
-  `instrument({ functions: { createUser, updateUser } })`.
+- When inference may be unreliable, name the wrapper explicitly with
+  `trace('user.create', fn)` or `instrument({ key: 'user.create', fn })`. For a
+  module-sized batch, use `instrument({ functions: { createUser, updateUser } })`.
 
 ### 4. See the value everywhere
 
@@ -553,7 +553,7 @@ These use the `autotel.*` namespace intentionally. OpenTelemetry does not define
 Wrap any sync/async function to create spans automatically.
 
 ```typescript
-import { trace, span, withTracing } from 'autotel';
+import { trace, span, instrument, withTracing } from 'autotel';
 
 export const updateUser = trace(async function updateUser(
   id: string,
@@ -563,8 +563,9 @@ export const updateUser = trace(async function updateUser(
 });
 
 // Explicit name (useful for anonymous/arrow functions)
-export const deleteUser = trace('user.delete', async (id: string) => {
-  return db.users.delete(id);
+export const deleteUser = instrument({
+  key: 'user.delete',
+  fn: async (id: string) => db.users.delete(id),
 });
 
 // Explicit factory form exposes the `ctx` helper
@@ -575,19 +576,22 @@ export const createOrder = withTracing({ name: 'order.create' })(
   },
 );
 
-// For one-off work, create the wrapper and call it
+// For one-off work, run a named operation directly
 function timed<T>(operation: string, fn: () => Promise<T>): Promise<T> {
-  return trace(operation, async () => {
-    getActiveTraceContext()?.setAttribute('operation', operation);
+  return trace(operation, async (ctx) => {
+    ctx.setAttribute('operation', operation);
     return await fn();
-  })();
+  });
 }
 ```
 
 **Context access:**
 
-1. Plain `trace(name?, fn)` wrappers receive their real arguments; use `getActiveTraceContext()` inside.
-2. Explicit factories use `withTracing({ name })(ctx => (...args) => result)`.
+1. Plain `trace(fn)` wrappers receive their real arguments; use `getActiveTraceContext()` inside.
+2. Reusable named wrappers use `trace(name, fn)` or `instrument({ key, fn })`; explicit factories use `withTracing({ name })(ctx => (...args) => result)`.
+3. `trace.run(name, ctx => result)` runs one operation immediately with explicit context.
+
+**`trace` wraps, `trace.run` runs.** No `trace(...)` form executes your function, so importing a module of them has no side effects. Reach the span inside any traced body through the ambient `ctx` import.
 
 - Automatic span lifecycle (`start`, `end`, status, and error recording).
 - Function names feed `operation.name`, `code.function`, and events enrichment.
@@ -1528,20 +1532,23 @@ Track user behavior, conversion funnels, and business outcomes alongside your Op
 **Recommended: Configure subscribers in `init()`, use global `track()` function:**
 
 ```typescript
-import { init, track, trace, span, withTracing } from 'autotel';
-import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+import { init, instrument, track } from 'autotel';
+import { PostHogSubscriber } from 'autotel-posthog/subscriber';
 
 init({
   service: 'checkout',
   subscribers: [new PostHogSubscriber({ apiKey: process.env.POSTHOG_KEY! })],
 });
 
-export const signup = trace('user.signup', async (user) => {
-  // All events use subscribers from init() automatically
-  track('user.signup', { userId: user.id, plan: user.plan });
-  track.funnelStep('checkout', 'completed', { cartValue: user.cartTotal });
-  track.value('lifetimeValue', user.cartTotal, { currency: 'USD' });
-  track.outcome('user.signup', 'success', { cohort: user.cohort });
+export const signup = instrument({
+  key: 'user.signup',
+  fn: async (user) => {
+    // All events use subscribers from init() automatically
+    track('user.signup', { userId: user.id, plan: user.plan });
+    track.funnelStep('checkout', 'completed', { cartValue: user.cartTotal });
+    track.value('lifetimeValue', user.cartTotal, { currency: 'USD' });
+    track.outcome('user.signup', 'success', { cohort: user.cohort });
+  },
 });
 ```
 
@@ -2240,7 +2247,7 @@ Configure event subscribers globally to send product events to PostHog, Mixpanel
 
 ```typescript
 import { init } from 'autotel';
-import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+import { PostHogSubscriber } from 'autotel-posthog/subscriber';
 
 init({
   service: 'my-app',
@@ -2735,10 +2742,10 @@ export default wrapModule(
 ## API Reference
 
 - `init(config)` : Bootstraps the SDK (call once).
-- `trace(fn | name, fn)` : Wraps functions with spans and optional context access.
+- `trace(fn)` wraps a reusable inferred-name function; `trace(name, fn)` wraps under an explicit name; `trace.run(name, ctx => result)` runs named work immediately.
 - `span(options, fn)` : Creates nested spans for ad-hoc blocks.
 - `withTracing(options)` : Produces reusable wrappers with shared configuration.
-- `instrument(target, options)` : Batch-wraps an object of functions.
+- `instrument({ key, fn })` is the options form of `trace(name, fn)`; `instrument({ functions })` batch-wraps a module.
 - `Trace` decorator : Adds tracing to class methods (TypeScript 5+).
 - `instrumentDatabase(db, options)` : Adds automatic DB spans (Drizzle, etc.).
 - `Metric` class & helpers (`createHistogram`, etc.) : Emit OpenTelemetry metrics.

package/dist/{attribute-redacting-processor-Pk7lAzWd.d.cts → attribute-redacting-processor-CvBE0z1p.d.cts}

@@ -121,7 +121,39 @@ declare const builtinPatterns: {
 /**
  * Built-in redactor presets
  */
-declare const REDACTOR_PRESETS: Record<AttributeRedactorPreset, AttributeRedactorConfig>;
+declare const REDACTOR_PRESETS: {
+  /**
+   * Default preset - covers common PII patterns with smart masking
+   * Detects: emails (a***@***.com), phone numbers, SSNs, credit cards (****1111)
+   * Redacts keys: password, secret, token, apiKey, auth, credential
+   */
+  default: {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: true;
+    replacement: string;
+  };
+  /**
+   * Strict preset - more aggressive redaction for high-security environments
+   * Includes everything in default plus: Bearer tokens, JWTs, IBAN, API keys in values
+   */
+  strict: {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: true;
+    replacement: string;
+  };
+  /**
+   * PCI-DSS preset - focused on payment card industry compliance
+   * Redacts: credit card numbers (****1111), CVV-like patterns, card-related keys
+   */
+  'pci-dss': {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: "creditCard"[];
+    replacement: string;
+  };
+};
 /**
  * Normalize redactor config that may have been deserialized from JSON/YAML.
  * Converts regex-like values back to RegExp instances.

package/dist/{attribute-redacting-processor-Pk7lAzWd.d.ts → attribute-redacting-processor-CvBE0z1p.d.ts}

@@ -121,7 +121,39 @@ declare const builtinPatterns: {
 /**
  * Built-in redactor presets
  */
-declare const REDACTOR_PRESETS: Record<AttributeRedactorPreset, AttributeRedactorConfig>;
+declare const REDACTOR_PRESETS: {
+  /**
+   * Default preset - covers common PII patterns with smart masking
+   * Detects: emails (a***@***.com), phone numbers, SSNs, credit cards (****1111)
+   * Redacts keys: password, secret, token, apiKey, auth, credential
+   */
+  default: {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: true;
+    replacement: string;
+  };
+  /**
+   * Strict preset - more aggressive redaction for high-security environments
+   * Includes everything in default plus: Bearer tokens, JWTs, IBAN, API keys in values
+   */
+  strict: {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: true;
+    replacement: string;
+  };
+  /**
+   * PCI-DSS preset - focused on payment card industry compliance
+   * Redacts: credit card numbers (****1111), CVV-like patterns, card-related keys
+   */
+  'pci-dss': {
+    keyPatterns: RegExp[];
+    valuePatterns: ValuePatternConfig[];
+    builtins: "creditCard"[];
+    replacement: string;
+  };
+};
 /**
  * Normalize redactor config that may have been deserialized from JSON/YAML.
  * Converts regex-like values back to RegExp instances.

package/dist/attribute-redacting-processor.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_values = require('./values-DApyq53y.cjs');
 
 //#region src/attribute-redacting-processor.ts
 /**
@@ -82,16 +83,12 @@ const builtinPatterns = {
 function cloneRegex(re) {
 	return new RegExp(re.source, re.flags);
 }
-function isPlainObject(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function toRegExp(value) {
 	if (value instanceof RegExp) return value;
-	if (typeof value === "string") return new RegExp(value, "g");
-	if (isPlainObject(value) && typeof value.source === "string") {
-		const flags = typeof value.flags === "string" ? value.flags : "g";
-		return new RegExp(value.source, flags);
-	}
+	const literal = require_values.asString(value);
+	if (literal !== void 0) return new RegExp(literal, "g");
+	const source = require_values.asString(require_values.readProperty(value, "source"));
+	return source === void 0 ? void 0 : new RegExp(source, require_values.asString(require_values.readProperty(value, "flags")) ?? "g");
 }
 function toRegExpArray(value) {
 	if (!Array.isArray(value)) return void 0;
@@ -184,29 +181,34 @@ const REDACTOR_PRESETS = {
 */
 function normalizeAttributeRedactorConfig(raw) {
 	if (raw === void 0 || raw === null) return void 0;
-	if (typeof raw === "string") return raw;
-	if (!isPlainObject(raw)) return void 0;
+	const presetName = require_values.asString(raw);
+	if (presetName !== void 0) return presetName;
+	const record = require_values.asRecord(raw);
+	if (!record) return void 0;
 	const config = {};
-	if (Array.isArray(raw.paths)) config.paths = raw.paths.filter((value) => typeof value === "string");
-	if (typeof raw.replacement === "string") config.replacement = raw.replacement;
-	if (typeof raw.builtins === "boolean") config.builtins = raw.builtins;
-	else if (Array.isArray(raw.builtins)) config.builtins = raw.builtins.filter((name) => typeof name === "string");
-	if (typeof raw.redactor === "function") config.redactor = raw.redactor;
-	const keyPatterns = toRegExpArray(raw.keyPatterns);
+	if (Array.isArray(record.paths)) config.paths = record.paths.filter((value) => require_values.asString(value) !== void 0);
+	const replacement = require_values.asString(record.replacement);
+	if (replacement !== void 0) config.replacement = replacement;
+	const builtins = require_values.asBoolean(record.builtins);
+	if (builtins !== void 0) config.builtins = builtins;
+	else if (Array.isArray(record.builtins)) config.builtins = record.builtins.filter((name) => require_values.asString(name) !== void 0);
+	if (require_values.isFunction(record.redactor)) config.redactor = record.redactor;
+	const keyPatterns = toRegExpArray(record.keyPatterns);
 	if (keyPatterns) config.keyPatterns = keyPatterns;
-	const patterns = toRegExpArray(raw.patterns);
+	const patterns = toRegExpArray(record.patterns);
 	if (patterns) config.patterns = patterns;
-	if (Array.isArray(raw.valuePatterns)) {
+	if (Array.isArray(record.valuePatterns)) {
 		const valuePatterns = [];
-		for (const item of raw.valuePatterns) {
-			if (!isPlainObject(item) || typeof item.name !== "string") continue;
-			const pattern = toRegExp(item.pattern);
-			if (!pattern) continue;
+		for (const entry of record.valuePatterns) {
+			const item = require_values.asRecord(entry);
+			const name = require_values.asString(item?.name);
+			const pattern = toRegExp(item?.pattern);
+			if (!item || name === void 0 || !pattern) continue;
 			valuePatterns.push({
-				name: item.name,
+				name,
 				pattern,
-				replacement: typeof item.replacement === "string" ? item.replacement : void 0,
-				mask: typeof item.mask === "function" ? item.mask : void 0
+				replacement: require_values.asString(item.replacement),
+				mask: require_values.isFunction(item.mask) ? item.mask : void 0
 			});
 		}
 		config.valuePatterns = valuePatterns;
@@ -250,21 +252,22 @@ function createRedactorFromConfig(config) {
 	const defaultReplacement = config.replacement ?? "[REDACTED]";
 	const maskers = valuePatterns.filter((vp) => vp.mask).map((vp) => [cloneRegex(vp.pattern), vp.mask]);
 	return (key, value) => {
-		if (typeof value === "string") {
+		const text = require_values.asString(value);
+		if (text !== void 0) {
 			for (const pattern of keyPatterns) {
 				pattern.lastIndex = 0;
 				if (pattern.test(key)) return defaultReplacement;
 			}
 			if (pathSet.has(key)) return defaultReplacement;
 		}
-		if (typeof value !== "string") {
+		if (text === void 0) {
 			if (Array.isArray(value)) return value.map((item) => {
-				if (typeof item === "string") return redactStringValue(item, valuePatterns, maskers, customPatterns, defaultReplacement);
-				return item;
+				const itemText = require_values.asString(item);
+				return itemText === void 0 ? item : redactStringValue(itemText, valuePatterns, maskers, customPatterns, defaultReplacement);
 			});
 			return value;
 		}
-		return redactStringValue(value, valuePatterns, maskers, customPatterns, defaultReplacement);
+		return redactStringValue(text, valuePatterns, maskers, customPatterns, defaultReplacement);
 	};
 }
 /**
@@ -301,8 +304,7 @@ function createRedactedSpan(span, redactor) {
 	return new Proxy(span, { get(target, prop) {
 		if (prop === "attributes") return redactedAttributes;
 		const value = Reflect.get(target, prop);
-		if (typeof value === "function") return value.bind(target);
-		return value;
+		return require_values.isFunction(value) ? value.bind(target) : value;
 	} });
 }
 /**

package/dist/attribute-redacting-processor.d.cts

@@ -1,2 +1,2 @@
-import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-Pk7lAzWd.cjs";
+import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-CvBE0z1p.cjs";
 export { AttributeRedactingProcessor, AttributeRedactingProcessorOptions, AttributeRedactorConfig, AttributeRedactorFn, AttributeRedactorPreset, BuiltinPatternName, MaskFn, REDACTOR_PATTERNS, REDACTOR_PRESETS, ValuePatternConfig, builtinPatterns, createAttributeRedactor, createRedactedSpan, normalizeAttributeRedactorConfig };

package/dist/attribute-redacting-processor.d.ts

@@ -1,2 +1,2 @@
-import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-Pk7lAzWd.js";
+import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-CvBE0z1p.js";
 export { AttributeRedactingProcessor, AttributeRedactingProcessorOptions, AttributeRedactorConfig, AttributeRedactorFn, AttributeRedactorPreset, BuiltinPatternName, MaskFn, REDACTOR_PATTERNS, REDACTOR_PRESETS, ValuePatternConfig, builtinPatterns, createAttributeRedactor, createRedactedSpan, normalizeAttributeRedactorConfig };

package/dist/attribute-redacting-processor.js

@@ -1,3 +1,5 @@
+import { _ as readProperty, h as isFunction, l as asString, s as asRecord, t as asBoolean } from "./values-BenyvWKz.js";
+
 //#region src/attribute-redacting-processor.ts
 /**
 * Built-in patterns for detecting sensitive data
@@ -80,16 +82,12 @@ const builtinPatterns = {
 function cloneRegex(re) {
 	return new RegExp(re.source, re.flags);
 }
-function isPlainObject(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function toRegExp(value) {
 	if (value instanceof RegExp) return value;
-	if (typeof value === "string") return new RegExp(value, "g");
-	if (isPlainObject(value) && typeof value.source === "string") {
-		const flags = typeof value.flags === "string" ? value.flags : "g";
-		return new RegExp(value.source, flags);
-	}
+	const literal = asString(value);
+	if (literal !== void 0) return new RegExp(literal, "g");
+	const source = asString(readProperty(value, "source"));
+	return source === void 0 ? void 0 : new RegExp(source, asString(readProperty(value, "flags")) ?? "g");
 }
 function toRegExpArray(value) {
 	if (!Array.isArray(value)) return void 0;
@@ -182,29 +180,34 @@ const REDACTOR_PRESETS = {
 */
 function normalizeAttributeRedactorConfig(raw) {
 	if (raw === void 0 || raw === null) return void 0;
-	if (typeof raw === "string") return raw;
-	if (!isPlainObject(raw)) return void 0;
+	const presetName = asString(raw);
+	if (presetName !== void 0) return presetName;
+	const record = asRecord(raw);
+	if (!record) return void 0;
 	const config = {};
-	if (Array.isArray(raw.paths)) config.paths = raw.paths.filter((value) => typeof value === "string");
-	if (typeof raw.replacement === "string") config.replacement = raw.replacement;
-	if (typeof raw.builtins === "boolean") config.builtins = raw.builtins;
-	else if (Array.isArray(raw.builtins)) config.builtins = raw.builtins.filter((name) => typeof name === "string");
-	if (typeof raw.redactor === "function") config.redactor = raw.redactor;
-	const keyPatterns = toRegExpArray(raw.keyPatterns);
+	if (Array.isArray(record.paths)) config.paths = record.paths.filter((value) => asString(value) !== void 0);
+	const replacement = asString(record.replacement);
+	if (replacement !== void 0) config.replacement = replacement;
+	const builtins = asBoolean(record.builtins);
+	if (builtins !== void 0) config.builtins = builtins;
+	else if (Array.isArray(record.builtins)) config.builtins = record.builtins.filter((name) => asString(name) !== void 0);
+	if (isFunction(record.redactor)) config.redactor = record.redactor;
+	const keyPatterns = toRegExpArray(record.keyPatterns);
 	if (keyPatterns) config.keyPatterns = keyPatterns;
-	const patterns = toRegExpArray(raw.patterns);
+	const patterns = toRegExpArray(record.patterns);
 	if (patterns) config.patterns = patterns;
-	if (Array.isArray(raw.valuePatterns)) {
+	if (Array.isArray(record.valuePatterns)) {
 		const valuePatterns = [];
-		for (const item of raw.valuePatterns) {
-			if (!isPlainObject(item) || typeof item.name !== "string") continue;
-			const pattern = toRegExp(item.pattern);
-			if (!pattern) continue;
+		for (const entry of record.valuePatterns) {
+			const item = asRecord(entry);
+			const name = asString(item?.name);
+			const pattern = toRegExp(item?.pattern);
+			if (!item || name === void 0 || !pattern) continue;
 			valuePatterns.push({
-				name: item.name,
+				name,
 				pattern,
-				replacement: typeof item.replacement === "string" ? item.replacement : void 0,
-				mask: typeof item.mask === "function" ? item.mask : void 0
+				replacement: asString(item.replacement),
+				mask: isFunction(item.mask) ? item.mask : void 0
 			});
 		}
 		config.valuePatterns = valuePatterns;
@@ -248,21 +251,22 @@ function createRedactorFromConfig(config) {
 	const defaultReplacement = config.replacement ?? "[REDACTED]";
 	const maskers = valuePatterns.filter((vp) => vp.mask).map((vp) => [cloneRegex(vp.pattern), vp.mask]);
 	return (key, value) => {
-		if (typeof value === "string") {
+		const text = asString(value);
+		if (text !== void 0) {
 			for (const pattern of keyPatterns) {
 				pattern.lastIndex = 0;
 				if (pattern.test(key)) return defaultReplacement;
 			}
 			if (pathSet.has(key)) return defaultReplacement;
 		}
-		if (typeof value !== "string") {
+		if (text === void 0) {
 			if (Array.isArray(value)) return value.map((item) => {
-				if (typeof item === "string") return redactStringValue(item, valuePatterns, maskers, customPatterns, defaultReplacement);
-				return item;
+				const itemText = asString(item);
+				return itemText === void 0 ? item : redactStringValue(itemText, valuePatterns, maskers, customPatterns, defaultReplacement);
 			});
 			return value;
 		}
-		return redactStringValue(value, valuePatterns, maskers, customPatterns, defaultReplacement);
+		return redactStringValue(text, valuePatterns, maskers, customPatterns, defaultReplacement);
 	};
 }
 /**
@@ -299,8 +303,7 @@ function createRedactedSpan(span, redactor) {
 	return new Proxy(span, { get(target, prop) {
 		if (prop === "attributes") return redactedAttributes;
 		const value = Reflect.get(target, prop);
-		if (typeof value === "function") return value.bind(target);
-		return value;
+		return isFunction(value) ? value.bind(target) : value;
 	} });
 }
 /**

package/dist/{attributes-aDmJYral.cjs → attributes-Cxys8tgr.cjs}

@@ -1,3 +1,4 @@
+const require_values = require('./values-DApyq53y.cjs');
 const require_attribute_redacting_processor = require('./attribute-redacting-processor.cjs');
 const require_registry = require('./registry-DYgvb62e.cjs');
 let _opentelemetry_resources = require("@opentelemetry/resources");
@@ -330,34 +331,34 @@ const attrs = {
 //#endregion
 //#region src/attributes/validators.ts
 /**
-* Attribute validation, PII detection, and guardrails
-* Provides safe-by-default attribute handling with configurable policies
+* Attributes OpenTelemetry has renamed, mapped to their replacement - or to
+* `null` where the convention dropped them outright.
 */
-const DEPRECATED_ATTRIBUTES = {
-	"enduser.id": "user.id",
-	"enduser.role": "user.roles",
-	"enduser.scope": void 0,
-	"http.method": "http.request.method",
-	"http.host": "server.address",
-	"http.status_code": "http.response.status_code",
-	"http.target": "url.path",
-	"http.url": "url.full",
-	"http.user_agent": "user_agent.original",
-	"http.flavor": "network.protocol.name",
-	"http.scheme": "url.scheme",
-	"http.server_name": "server.address",
-	"db.name": "db.namespace",
-	"db.operation": "db.operation.name",
-	"db.statement": "db.query.text",
-	"db.system": "db.system.name",
-	"db.collection": "db.collection.name",
-	"db.instance.id": void 0,
-	"db.jdbc.driver_classname": void 0,
-	"db.mssql.instance_name": "mssql.instance.name",
-	"db.sql.table": "db.collection.name",
-	"http.client_ip": "client.address",
-	"user_agent.original": "user_agent.original"
-};
+const DEPRECATED_ATTRIBUTES = /* @__PURE__ */ new Map([
+	["enduser.id", "user.id"],
+	["enduser.role", "user.roles"],
+	["enduser.scope", null],
+	["http.method", "http.request.method"],
+	["http.host", "server.address"],
+	["http.status_code", "http.response.status_code"],
+	["http.target", "url.path"],
+	["http.url", "url.full"],
+	["http.user_agent", "user_agent.original"],
+	["http.flavor", "network.protocol.name"],
+	["http.scheme", "url.scheme"],
+	["http.server_name", "server.address"],
+	["db.name", "db.namespace"],
+	["db.operation", "db.operation.name"],
+	["db.statement", "db.query.text"],
+	["db.system", "db.system.name"],
+	["db.collection", "db.collection.name"],
+	["db.instance.id", null],
+	["db.jdbc.driver_classname", null],
+	["db.mssql.instance_name", "mssql.instance.name"],
+	["db.sql.table", "db.collection.name"],
+	["http.client_ip", "client.address"],
+	["user_agent.original", "user_agent.original"]
+]);
 const HTTP_METHODS = /* @__PURE__ */ new Set([
 	"GET",
 	"POST",
@@ -373,8 +374,8 @@ const HTTP_METHODS = /* @__PURE__ */ new Set([
 function validateAttribute(key, value, policy = {}) {
 	const { guardrails = {} } = policy;
 	if (value === void 0 || value === null) return;
-	if (typeof value !== "string") return value;
-	const stringValue = value;
+	const stringValue = require_values.asString(value);
+	if (stringValue === void 0) return value;
 	if (guardrails.pii) {
 		const piiResult = applyPIIPolicy(key, stringValue, guardrails.pii);
 		if (piiResult !== stringValue) return piiResult;
@@ -443,13 +444,11 @@ function checkDeprecatedAttribute(key, policy = {}) {
 	const { guardrails = {}, deprecatedWarnings = {} } = policy;
 	const { warnDeprecated = true } = guardrails;
 	if (!warnDeprecated) return null;
-	if (key in DEPRECATED_ATTRIBUTES) {
-		const replacement = DEPRECATED_ATTRIBUTES[key];
-		if (replacement === void 0) console.warn(`[autotel/attributes] Attribute "${key}" is deprecated and has no replacement. Remove or find a replacement in OpenTelemetry semantic conventions.`);
-		else console.warn(`[autotel/attributes] Attribute "${key}" is deprecated. Use "${replacement}" instead.`);
-	}
+	const replacement = DEPRECATED_ATTRIBUTES.get(key) ?? null;
+	if (DEPRECATED_ATTRIBUTES.has(key)) if (replacement === null) console.warn(`[autotel/attributes] Attribute "${key}" is deprecated and has no replacement. Remove or find a replacement in OpenTelemetry semantic conventions.`);
+	else console.warn(`[autotel/attributes] Attribute "${key}" is deprecated. Use "${replacement}" instead.`);
 	if (deprecatedWarnings[key]) console.warn(`[autotel/attributes] ${deprecatedWarnings[key]}`);
-	return DEPRECATED_ATTRIBUTES[key] ?? null;
+	return replacement;
 }
 function autoRedactPII(attributes, policy = {}) {
 	const { guardrails = { pii: "redact" } } = policy;