bitfab 0.36.3 → 0.36.5

package/dist/index.cjs

@@ -51,7 +51,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.36.3";
+    __version__ = "0.36.5";
   }
 });
 
@@ -5777,7 +5777,7 @@ var Bitfab = class {
           }
         };
         executeWithContext = () => {
-          const result = fn(...args);
+          const result = fn.apply(this, args);
           if (result instanceof Promise) {
             return result.then((resolvedResult) => {
               recordSpan(resolvedResult);
@@ -5807,7 +5807,7 @@ var Bitfab = class {
           `withSpan-setup:${traceFunctionKey}`,
           `tracing setup failed for "${traceFunctionKey}"; running it untraced. The function still runs and returns normally; no span is recorded.`
         );
-        return fn(...args);
+        return fn.apply(this, args);
       }
       return runWithSpanStack(newStack, executeWithContext);
     };
@@ -5816,6 +5816,40 @@ var Bitfab = class {
     });
     return wrappedFn;
   }
+  /**
+   * Create a standard ECMAScript method decorator that records each invocation
+   * as a span.
+   *
+   * It supports instance, static, and private methods; use
+   * {@link Bitfab.withSpan} for standalone functions, class fields, and
+   * accessors.
+   *
+   * @example
+   * ```typescript
+   * const bitfab = new Bitfab({ apiKey: process.env.BITFAB_API_KEY });
+   *
+   * class OrderService {
+   *   @bitfab.span("order-processing", { type: "agent" })
+   *   async process(orderId: string) {
+   *     return { orderId };
+   *   }
+   * }
+   * ```
+   *
+   * @param traceFunctionKey - A string identifier for grouping spans
+   * @param options - Span configuration applied to the decorated method
+   * @returns A standard ECMAScript method decorator
+   */
+  span(traceFunctionKey, options = {}) {
+    return (originalMethod, context) => {
+      if (context.kind !== "method") {
+        throw new BitfabError(
+          `Bitfab span decorators can only decorate methods; ${String(context.name)} is a ${context.kind}`
+        );
+      }
+      return this.withSpan(traceFunctionKey, options, originalMethod);
+    };
+  }
   /**
    * Get a detached handle to a previously-created trace, looked up by the
    * canonical Bitfab trace ID.
@@ -6092,6 +6126,27 @@ var BitfabFunction = class {
     const fn = typeof optionsOrFn === "function" ? optionsOrFn : maybeFn;
     return this.client.withSpan(this.traceFunctionKey, options, fn);
   }
+  /**
+   * Create a standard ECMAScript method decorator bound to this function key.
+   *
+   * @example
+   * ```typescript
+   * const orders = client.getFunction("order-processing");
+   *
+   * class OrderService {
+   *   @orders.span({ type: "agent" })
+   *   async process(orderId: string) {
+   *     return { orderId };
+   *   }
+   * }
+   * ```
+   *
+   * @param options - Span configuration applied to the decorated method
+   * @returns A standard ECMAScript method decorator
+   */
+  span(options = {}) {
+    return this.client.span(this.traceFunctionKey, options);
+  }
   /**
    * Get a Vercel AI SDK language-model middleware bound to this function's key.
    *