autotel 3.0.3 → 3.0.4

package/dist/index.js

@@ -1,19 +1,19 @@
 export { createDrainPipeline } from './chunk-KFOHQK7X.js';
-export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-K7HSRLP5.js';
+export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-4LF6FV2V.js';
 export { attrs, autoRedactPII, dbClient, httpClient, httpServer, identify, mergeAttrs, mergeServiceResource, request, safeSetAttributes, setDevice, setError, setException, setSession, setUser, validateAttribute } from './chunk-DDXIUZEG.js';
 export { httpRequestHeaderAttribute, httpResponseHeaderAttribute } from './chunk-7552UTQW.js';
 export { HTTPAttributes, ServiceAttributes, URLAttributes } from './chunk-4A53YIAX.js';
 export { parseError } from './chunk-J7VGRIAJ.js';
-export { traceConsumer, traceProducer } from './chunk-TFRZOUTV.js';
+export { traceConsumer, traceProducer } from './chunk-34X3TKHA.js';
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
 export { BusinessBaggage, createSafeBaggageSchema } from './chunk-4IFSYQVX.js';
 import { resetMetrics } from './chunk-7SAWIN74.js';
 export { Metric, getMetrics, resetMetrics } from './chunk-7SAWIN74.js';
 import './chunk-5ZN622AO.js';
 export { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter } from './chunk-TQ5UWA7S.js';
-export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-52PUSFC2.js';
-import { trace as trace$1 } from './chunk-PMRWMRXY.js';
-export { ctx, instrument, span, withBaggage, withNewContext, withTracing } from './chunk-PMRWMRXY.js';
+export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-HBLWOI6P.js';
+import { trace as trace$1 } from './chunk-F3TNRW2P.js';
+export { ctx, instrument, span, withBaggage, withNewContext, withTracing } from './chunk-F3TNRW2P.js';
 export { createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan } from './chunk-DSMSIVTG.js';
 import { resetEvents } from './chunk-OM4OSBOP.js';
 export { Event, getEvents, resetEvents } from './chunk-OM4OSBOP.js';

package/dist/messaging.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkHKZHUGGN_cjs = require('./chunk-HKZHUGGN.cjs');
+var chunkLMFPZHI4_cjs = require('./chunk-LMFPZHI4.cjs');
 require('./chunk-4P6ZOARG.cjs');
-require('./chunk-QPH5ZKP5.cjs');
+require('./chunk-WSGAHSZQ.cjs');
 require('./chunk-NCSMD3TK.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-KKGM42RQ.cjs');
@@ -25,15 +25,15 @@ require('./chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "clearOrderingState", {
   enumerable: true,
-  get: function () { return chunkHKZHUGGN_cjs.clearOrderingState; }
+  get: function () { return chunkLMFPZHI4_cjs.clearOrderingState; }
 });
 Object.defineProperty(exports, "traceConsumer", {
   enumerable: true,
-  get: function () { return chunkHKZHUGGN_cjs.traceConsumer; }
+  get: function () { return chunkLMFPZHI4_cjs.traceConsumer; }
 });
 Object.defineProperty(exports, "traceProducer", {
   enumerable: true,
-  get: function () { return chunkHKZHUGGN_cjs.traceProducer; }
+  get: function () { return chunkLMFPZHI4_cjs.traceProducer; }
 });
 //# sourceMappingURL=messaging.cjs.map
 //# sourceMappingURL=messaging.cjs.map

package/dist/messaging.js

@@ -1,6 +1,6 @@
-export { clearOrderingState, traceConsumer, traceProducer } from './chunk-TFRZOUTV.js';
+export { clearOrderingState, traceConsumer, traceProducer } from './chunk-34X3TKHA.js';
 import './chunk-KIL5CUN6.js';
-import './chunk-PMRWMRXY.js';
+import './chunk-F3TNRW2P.js';
 import './chunk-DSMSIVTG.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-Z7VAOK5X.js';

package/dist/semantic-helpers.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk7SMNC4LS_cjs = require('./chunk-7SMNC4LS.cjs');
-require('./chunk-QPH5ZKP5.cjs');
+var chunkAAYCDHH6_cjs = require('./chunk-AAYCDHH6.cjs');
+require('./chunk-WSGAHSZQ.cjs');
 require('./chunk-NCSMD3TK.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-KKGM42RQ.cjs');
@@ -24,19 +24,19 @@ require('./chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "traceDB", {
   enumerable: true,
-  get: function () { return chunk7SMNC4LS_cjs.traceDB; }
+  get: function () { return chunkAAYCDHH6_cjs.traceDB; }
 });
 Object.defineProperty(exports, "traceHTTP", {
   enumerable: true,
-  get: function () { return chunk7SMNC4LS_cjs.traceHTTP; }
+  get: function () { return chunkAAYCDHH6_cjs.traceHTTP; }
 });
 Object.defineProperty(exports, "traceLLM", {
   enumerable: true,
-  get: function () { return chunk7SMNC4LS_cjs.traceLLM; }
+  get: function () { return chunkAAYCDHH6_cjs.traceLLM; }
 });
 Object.defineProperty(exports, "traceMessaging", {
   enumerable: true,
-  get: function () { return chunk7SMNC4LS_cjs.traceMessaging; }
+  get: function () { return chunkAAYCDHH6_cjs.traceMessaging; }
 });
 //# sourceMappingURL=semantic-helpers.cjs.map
 //# sourceMappingURL=semantic-helpers.cjs.map

package/dist/semantic-helpers.js

@@ -1,5 +1,5 @@
-export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-52PUSFC2.js';
-import './chunk-PMRWMRXY.js';
+export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-HBLWOI6P.js';
+import './chunk-F3TNRW2P.js';
 import './chunk-DSMSIVTG.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-Z7VAOK5X.js';

package/dist/webhook.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk4P6ZOARG_cjs = require('./chunk-4P6ZOARG.cjs');
-var chunkQPH5ZKP5_cjs = require('./chunk-QPH5ZKP5.cjs');
+var chunkWSGAHSZQ_cjs = require('./chunk-WSGAHSZQ.cjs');
 require('./chunk-NCSMD3TK.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 var chunkKKGM42RQ_cjs = require('./chunk-KKGM42RQ.cjs');
@@ -158,7 +158,7 @@ function createParkingLot(config) {
     },
     traceCallback(callbackConfig) {
       return (fnFactory) => {
-        return chunkQPH5ZKP5_cjs.trace(
+        return chunkWSGAHSZQ_cjs.trace(
           {
             name: callbackConfig.name,
             spanKind: api.SpanKind.SERVER

package/dist/webhook.js

@@ -1,5 +1,5 @@
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
-import { trace } from './chunk-PMRWMRXY.js';
+import { trace } from './chunk-F3TNRW2P.js';
 import './chunk-DSMSIVTG.js';
 import './chunk-SEO6NAQT.js';
 import { recordStructuredError } from './chunk-Z7VAOK5X.js';

package/dist/workflow-distributed.cjs

@@ -2,7 +2,7 @@
 
 var chunk4P6ZOARG_cjs = require('./chunk-4P6ZOARG.cjs');
 var chunkINJD3G4K_cjs = require('./chunk-INJD3G4K.cjs');
-var chunkQPH5ZKP5_cjs = require('./chunk-QPH5ZKP5.cjs');
+var chunkWSGAHSZQ_cjs = require('./chunk-WSGAHSZQ.cjs');
 require('./chunk-NCSMD3TK.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-KKGM42RQ.cjs');
@@ -59,7 +59,7 @@ var WorkflowBaggage = chunkINJD3G4K_cjs.createSafeBaggageSchema(workflowBaggageF
 function traceDistributedWorkflow(config) {
   const spanName = `workflow.${config.name}`;
   return (fnFactory) => {
-    return chunkQPH5ZKP5_cjs.trace(
+    return chunkWSGAHSZQ_cjs.trace(
       { name: spanName, spanKind: api.SpanKind.INTERNAL },
       (baseCtx) => {
         return async (...args) => {
@@ -158,7 +158,7 @@ function traceDistributedWorkflow(config) {
 function traceDistributedStep(config) {
   const spanName = `workflow.step.${config.name}`;
   return (fnFactory) => {
-    return chunkQPH5ZKP5_cjs.trace(
+    return chunkWSGAHSZQ_cjs.trace(
       { name: spanName, spanKind: api.SpanKind.INTERNAL },
       (baseCtx) => {
         return async (...args) => {

package/dist/workflow-distributed.js

@@ -1,6 +1,6 @@
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
 import { createSafeBaggageSchema } from './chunk-4IFSYQVX.js';
-import { trace } from './chunk-PMRWMRXY.js';
+import { trace } from './chunk-F3TNRW2P.js';
 import './chunk-DSMSIVTG.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-Z7VAOK5X.js';

package/dist/workflow.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkMOO75VE4_cjs = require('./chunk-MOO75VE4.cjs');
+var chunkAY2SY3MO_cjs = require('./chunk-AY2SY3MO.cjs');
 require('./chunk-4P6ZOARG.cjs');
-require('./chunk-QPH5ZKP5.cjs');
+require('./chunk-WSGAHSZQ.cjs');
 require('./chunk-NCSMD3TK.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-KKGM42RQ.cjs');
@@ -25,19 +25,19 @@ require('./chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "getCurrentWorkflowContext", {
   enumerable: true,
-  get: function () { return chunkMOO75VE4_cjs.getCurrentWorkflowContext; }
+  get: function () { return chunkAY2SY3MO_cjs.getCurrentWorkflowContext; }
 });
 Object.defineProperty(exports, "isInWorkflow", {
   enumerable: true,
-  get: function () { return chunkMOO75VE4_cjs.isInWorkflow; }
+  get: function () { return chunkAY2SY3MO_cjs.isInWorkflow; }
 });
 Object.defineProperty(exports, "traceStep", {
   enumerable: true,
-  get: function () { return chunkMOO75VE4_cjs.traceStep; }
+  get: function () { return chunkAY2SY3MO_cjs.traceStep; }
 });
 Object.defineProperty(exports, "traceWorkflow", {
   enumerable: true,
-  get: function () { return chunkMOO75VE4_cjs.traceWorkflow; }
+  get: function () { return chunkAY2SY3MO_cjs.traceWorkflow; }
 });
 //# sourceMappingURL=workflow.cjs.map
 //# sourceMappingURL=workflow.cjs.map

package/dist/workflow.js

@@ -1,6 +1,6 @@
-export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-K7HSRLP5.js';
+export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-4LF6FV2V.js';
 import './chunk-KIL5CUN6.js';
-import './chunk-PMRWMRXY.js';
+import './chunk-F3TNRW2P.js';
 import './chunk-DSMSIVTG.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-Z7VAOK5X.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "description": "Write Once, Observe Anywhere",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/functional.test.ts

@@ -62,6 +62,24 @@ describe('Functional API', () => {
       expect(promise).toBeInstanceOf(Promise);
       await expect(promise).resolves.toBe(84);
     });
+
+    it('accepts a string name as first argument (sync)', () => {
+      const result = span('sync-name-shorthand', () => 'ok');
+      expect(result).toBe('ok');
+    });
+
+    it('accepts a string name as first argument (async)', async () => {
+      await expect(
+        span('async-name-shorthand', async () => 'ok'),
+      ).resolves.toBe('ok');
+    });
+
+    it('records spans created via the string-name shorthand', async () => {
+      const collector = createTraceCollector();
+      await span('shorthand.recorded', async () => undefined);
+      const names = collector.getSpans().map((s) => s.name);
+      expect(names).toContain('shorthand.recorded');
+    });
   });
 
   describe('trace()', () => {

package/src/functional.ts

@@ -2124,44 +2124,56 @@ export interface SpanOptions {
  * Useful for adding tracing to specific code blocks without wrapping
  * the entire function. Supports both synchronous and asynchronous functions.
  *
+ * Mirrors `trace()`: pass a span name as the first argument for the common
+ * case, or full `SpanOptions` when you need to attach attributes.
+ *
  * @example
  * ```typescript
- * // Async function
- * async function processOrder(order: Order) {
- *   await span({
- *     name: 'payment.charge',
- *     attributes: { amount: order.total }
- *   }, async (span) => {
+ * // Name shorthand
+ * await span('payment.charge', async (span) => {
+ *   await chargeCustomer(order);
+ * })
+ *
+ * // Full options when attributes are needed
+ * await span(
+ *   { name: 'payment.charge', attributes: { amount: order.total } },
+ *   async (span) => {
  *     await chargeCustomer(order);
- *   })
- * }
+ *   },
+ * )
  *
- * // Sync function
- * function calculateTotal(items: Item[]) {
- *   return span({
- *     name: 'calculateTotal',
- *     attributes: { itemCount: items.length }
- *   }, (span) => {
- *     return items.reduce((sum, item) => sum + item.price, 0);
- *   })
- * }
+ * // Sync
+ * const total = span('calculateTotal', (span) => {
+ *   return items.reduce((sum, item) => sum + item.price, 0);
+ * })
  * ```
  */
-// Overload for sync functions (more specific - should come first)
+// Overloads — sync first (more specific match), then async.
+// Each shape is offered with a string name OR a full SpanOptions object so
+// span() aligns with trace()'s argument flexibility.
+export function span<T = unknown>(
+  name: string,
+  fn: (span: Span) => T,
+): T;
+export function span<T = unknown>(
+  name: string,
+  fn: (span: Span) => Promise<T>,
+): Promise<T>;
 export function span<T = unknown>(
   options: SpanOptions,
   fn: (span: Span) => T,
 ): T;
-// Overload for async functions
 export function span<T = unknown>(
   options: SpanOptions,
   fn: (span: Span) => Promise<T>,
 ): Promise<T>;
 // Implementation
 export function span<T = unknown>(
-  options: SpanOptions,
+  nameOrOptions: string | SpanOptions,
   fn: (span: Span) => T | Promise<T>,
 ): T | Promise<T> {
+  const options: SpanOptions =
+    typeof nameOrOptions === 'string' ? { name: nameOrOptions } : nameOrOptions;
   const config = getConfig();
   const tracer = config.tracer;
   const { name, attributes } = options;