@bitfab/sdk 0.36.4 → 0.36.5

package/dist/index.d.cts

@@ -1878,6 +1878,27 @@ interface SpanOptions {
      */
     finalize?: (result: any) => unknown | Promise<unknown>;
 }
+/**
+ * The standard method context passed to a decorator.
+ *
+ * Defined structurally instead of referencing TypeScript's built-in
+ * `ClassMethodDecoratorContext`, which was added in TypeScript 5.0. This keeps
+ * the SDK's non-decorator APIs consumable by projects on older compilers.
+ */
+interface SpanMethodDecoratorContext<TThis, TValue> {
+    readonly kind: "method";
+    readonly name: string | symbol;
+    readonly static: boolean;
+    readonly private: boolean;
+    readonly access: {
+        has(object: TThis): boolean;
+        get(object: TThis): TValue;
+    };
+    addInitializer(initializer: (this: TThis) => void): void;
+    readonly metadata?: Record<PropertyKey, unknown>;
+}
+/** A standard ECMAScript method decorator produced by {@link Bitfab.span}. */
+type SpanMethodDecorator = <TThis, TArgs extends unknown[], TReturn>(originalMethod: (this: TThis, ...args: TArgs) => TReturn, context: SpanMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => TReturn>) => (this: TThis, ...args: TArgs) => TReturn;
 
 /**
  * Client for making provider-based API calls via BAML.
@@ -2148,6 +2169,31 @@ declare class Bitfab {
      * @returns A wrapped function with the same signature that creates spans for inputs and outputs
      */
     withSpan<TArgs extends unknown[], TReturn>(traceFunctionKey: string, optionsOrFn: SpanOptions | ((...args: TArgs) => TReturn), maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+    /**
+     * 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: string, options?: SpanOptions): SpanMethodDecorator;
     /**
      * Get a detached handle to a previously-created trace, looked up by the
      * canonical Bitfab trace ID.
@@ -2292,6 +2338,25 @@ declare class BitfabFunction {
      * @returns A wrapped function with the same signature that creates spans
      */
     withSpan<TArgs extends unknown[], TReturn>(optionsOrFn: SpanOptions | ((...args: TArgs) => TReturn), maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+    /**
+     * 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?: SpanOptions): SpanMethodDecorator;
     /**
      * Get a Vercel AI SDK language-model middleware bound to this function's key.
      *
@@ -2399,7 +2464,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.4";
+declare const __version__ = "0.36.5";
 
 /**
  * Constants for the Bitfab SDK.
@@ -2467,4 +2532,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };

package/dist/index.d.ts

@@ -1878,6 +1878,27 @@ interface SpanOptions {
      */
     finalize?: (result: any) => unknown | Promise<unknown>;
 }
+/**
+ * The standard method context passed to a decorator.
+ *
+ * Defined structurally instead of referencing TypeScript's built-in
+ * `ClassMethodDecoratorContext`, which was added in TypeScript 5.0. This keeps
+ * the SDK's non-decorator APIs consumable by projects on older compilers.
+ */
+interface SpanMethodDecoratorContext<TThis, TValue> {
+    readonly kind: "method";
+    readonly name: string | symbol;
+    readonly static: boolean;
+    readonly private: boolean;
+    readonly access: {
+        has(object: TThis): boolean;
+        get(object: TThis): TValue;
+    };
+    addInitializer(initializer: (this: TThis) => void): void;
+    readonly metadata?: Record<PropertyKey, unknown>;
+}
+/** A standard ECMAScript method decorator produced by {@link Bitfab.span}. */
+type SpanMethodDecorator = <TThis, TArgs extends unknown[], TReturn>(originalMethod: (this: TThis, ...args: TArgs) => TReturn, context: SpanMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => TReturn>) => (this: TThis, ...args: TArgs) => TReturn;
 
 /**
  * Client for making provider-based API calls via BAML.
@@ -2148,6 +2169,31 @@ declare class Bitfab {
      * @returns A wrapped function with the same signature that creates spans for inputs and outputs
      */
     withSpan<TArgs extends unknown[], TReturn>(traceFunctionKey: string, optionsOrFn: SpanOptions | ((...args: TArgs) => TReturn), maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+    /**
+     * 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: string, options?: SpanOptions): SpanMethodDecorator;
     /**
      * Get a detached handle to a previously-created trace, looked up by the
      * canonical Bitfab trace ID.
@@ -2292,6 +2338,25 @@ declare class BitfabFunction {
      * @returns A wrapped function with the same signature that creates spans
      */
     withSpan<TArgs extends unknown[], TReturn>(optionsOrFn: SpanOptions | ((...args: TArgs) => TReturn), maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+    /**
+     * 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?: SpanOptions): SpanMethodDecorator;
     /**
      * Get a Vercel AI SDK language-model middleware bound to this function's key.
      *
@@ -2399,7 +2464,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.4";
+declare const __version__ = "0.36.5";
 
 /**
  * Constants for the Bitfab SDK.
@@ -2467,4 +2532,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-5NT3VGCB.js";
+} from "./chunk-IYHBVIPJ.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
@@ -23,7 +23,7 @@ import {
   flushTraces,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-6AXY24UL.js";
+} from "./chunk-FLP6CNRE.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.36.4";
+    __version__ = "0.36.5";
   }
 });
 
@@ -5782,7 +5782,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);
@@ -5812,7 +5812,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);
     };
@@ -5821,6 +5821,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.
@@ -6097,6 +6131,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.
    *