@xylabs/telemetry 5.0.60 → 5.0.62

package/dist/neutral/index.d.ts

@@ -1,2 +1,3 @@
 export * from './span.ts';
+export * from './timeBudget.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}

package/dist/neutral/index.mjs

@@ -7,6 +7,28 @@ import {
   trace as TRACE_API
 } from "@opentelemetry/api";
 import { isDefined } from "@xylabs/typeof";
+
+// src/timeBudget.ts
+async function timeBudget(name, logger, func, budget, status = false) {
+  const start = Date.now();
+  const timer = status ? setInterval(() => {
+    const duration2 = Date.now() - start;
+    if (budget > 0 && duration2 > budget) {
+      logger?.warn(`Function [${name}] execution is exceeding budget: ${duration2}ms > ${budget}ms`);
+    }
+  }, Math.max(100, budget)) : void 0;
+  const result = await func();
+  const duration = Date.now() - start;
+  if (!timer && budget > 0 && duration > budget) {
+    logger?.warn(`Function [${name}] execution exceeded budget: ${duration}ms > ${budget}ms`);
+  }
+  if (timer) {
+    clearInterval(timer);
+  }
+  return result;
+}
+
+// src/span.ts
 function cloneContextWithoutSpan(activeCtx, configKeys = []) {
   let newCtx = ROOT_CONTEXT;
   const baggage = propagation.getBaggage(activeCtx);
@@ -67,13 +89,18 @@ function spanRoot(name, fn, tracer) {
     return fn();
   }
 }
-async function spanAsync(name, fn, tracer) {
+async function spanAsync(name, fn, {
+  timeBudgetLimit,
+  logger,
+  tracer
+} = {}) {
   const activeTracer = tracer ?? TRACE_API.getTracer(name);
+  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn;
   if (isDefined(activeTracer)) {
     const span2 = activeTracer.startSpan(name);
     return await context.with(TRACE_API.setSpan(context.active(), span2), async () => {
       try {
-        const result = await fn();
+        const result = await funcToRun();
         span2.setStatus({ code: SpanStatusCode.OK });
         return result;
       } catch (ex) {
@@ -86,10 +113,15 @@ async function spanAsync(name, fn, tracer) {
       }
     });
   } else {
-    return await fn();
+    return await funcToRun();
   }
 }
-async function spanRootAsync(name, fn, tracer) {
+async function spanRootAsync(name, fn, {
+  timeBudgetLimit,
+  logger,
+  tracer
+} = {}) {
+  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn;
   const activeTracer = tracer ?? TRACE_API.getTracer(name);
   if (isDefined(activeTracer)) {
     const activeContext = context.active();
@@ -97,7 +129,7 @@ async function spanRootAsync(name, fn, tracer) {
     const span2 = activeTracer.startSpan(name, {}, noSpanContext);
     return await context.with(TRACE_API.setSpan(noSpanContext, span2), async () => {
       try {
-        const result = await fn();
+        const result = await funcToRun();
         span2.setStatus({ code: SpanStatusCode.OK });
         return result;
       } catch (ex) {
@@ -110,7 +142,7 @@ async function spanRootAsync(name, fn, tracer) {
       }
     });
   } else {
-    return await fn();
+    return await funcToRun();
   }
 }
 export {
@@ -118,6 +150,7 @@ export {
   span,
   spanAsync,
   spanRoot,
-  spanRootAsync
+  spanRootAsync,
+  timeBudget
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/span.ts"],"sourcesContent":["import type {\n  Context,\n  Tracer,\n} from '@opentelemetry/api'\nimport {\n  context, propagation, ROOT_CONTEXT, SpanStatusCode, trace as TRACE_API,\n} from '@opentelemetry/api'\nimport { isDefined } from '@xylabs/typeof'\n\nexport function cloneContextWithoutSpan(activeCtx: Context, configKeys: symbol[] = []): Context {\n  // Start from root to ensure no span is propagated\n  let newCtx = ROOT_CONTEXT\n\n  // Copy baggage\n  const baggage = propagation.getBaggage(activeCtx)\n  if (baggage) {\n    newCtx = propagation.setBaggage(newCtx, baggage)\n  }\n\n  // Copy custom config keys\n  for (const key of configKeys) {\n    const value = activeCtx.getValue(key)\n    if (value !== undefined) {\n      newCtx = newCtx.setValue(key, value)\n    }\n  }\n\n  return newCtx\n}\n\nexport function span<T>(name: string, fn: () => T, tracer?: Tracer): T {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    const span = activeTracer.startSpan(name)\n    return context.with(TRACE_API.setSpan(context.active(), span), () => {\n      try {\n        const result = fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return fn()\n  }\n}\n\nexport function spanRoot<T>(name: string, fn: () => T, tracer?: Tracer): T {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    // Get current active context for configuration\n    const activeContext = context.active()\n\n    // Create a new context with no active span\n    const noSpanContext = cloneContextWithoutSpan(activeContext)\n\n    // Create a new span in the context without an active span\n    const span = activeTracer.startSpan(name, {}, noSpanContext)\n\n    // Use the active context but replace its span with our new root span\n    return context.with(TRACE_API.setSpan(noSpanContext, span), () => {\n      try {\n        const result = fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return fn()\n  }\n}\n\nexport async function spanAsync<T>(\n  name: string,\n  fn: () => Promise<T>,\n  tracer?: Tracer,\n): Promise<T> {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    const span = activeTracer.startSpan(name)\n    return await context.with(TRACE_API.setSpan(context.active(), span), async () => {\n      try {\n        const result = await fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return await fn()\n  }\n}\n\nexport async function spanRootAsync<T>(\n  name: string,\n  fn: () => Promise<T>,\n  tracer?: Tracer,\n): Promise<T> {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    const activeContext = context.active()\n\n    const noSpanContext = cloneContextWithoutSpan(activeContext)\n\n    // Create a new span in the context without an active span\n    const span = activeTracer.startSpan(name, {}, noSpanContext)\n\n    // Use the active context but replace its span with our new root span\n    return await context.with(TRACE_API.setSpan(noSpanContext, span), async () => {\n      try {\n        const result = await fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return await fn()\n  }\n}\n"],"mappings":"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","names":["span"]}
+{"version":3,"sources":["../../src/span.ts","../../src/timeBudget.ts"],"sourcesContent":["import type {\n  Context,\n  Tracer,\n} from '@opentelemetry/api'\nimport {\n  context, propagation, ROOT_CONTEXT, SpanStatusCode, trace as TRACE_API,\n} from '@opentelemetry/api'\nimport type { Logger } from '@xylabs/logger'\nimport { isDefined } from '@xylabs/typeof'\n\nimport { timeBudget } from './timeBudget.ts'\n\nexport interface SpanConfig {\n  logger?: Logger | null\n  timeBudgetLimit?: number\n  tracer?: Tracer\n}\n\nexport function cloneContextWithoutSpan(activeCtx: Context, configKeys: symbol[] = []): Context {\n  // Start from root to ensure no span is propagated\n  let newCtx = ROOT_CONTEXT\n\n  // Copy baggage\n  const baggage = propagation.getBaggage(activeCtx)\n  if (baggage) {\n    newCtx = propagation.setBaggage(newCtx, baggage)\n  }\n\n  // Copy custom config keys\n  for (const key of configKeys) {\n    const value = activeCtx.getValue(key)\n    if (value !== undefined) {\n      newCtx = newCtx.setValue(key, value)\n    }\n  }\n\n  return newCtx\n}\n\nexport function span<T>(name: string, fn: () => T, tracer?: Tracer): T {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    const span = activeTracer.startSpan(name)\n    return context.with(TRACE_API.setSpan(context.active(), span), () => {\n      try {\n        const result = fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return fn()\n  }\n}\n\nexport function spanRoot<T>(name: string, fn: () => T, tracer?: Tracer): T {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    // Get current active context for configuration\n    const activeContext = context.active()\n\n    // Create a new context with no active span\n    const noSpanContext = cloneContextWithoutSpan(activeContext)\n\n    // Create a new span in the context without an active span\n    const span = activeTracer.startSpan(name, {}, noSpanContext)\n\n    // Use the active context but replace its span with our new root span\n    return context.with(TRACE_API.setSpan(noSpanContext, span), () => {\n      try {\n        const result = fn()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return fn()\n  }\n}\n\nexport async function spanAsync<T>(\n  name: string,\n  fn: () => Promise<T>,\n  {\n    timeBudgetLimit, logger, tracer,\n  }: SpanConfig = {},\n): Promise<T> {\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn\n  if (isDefined(activeTracer)) {\n    const span = activeTracer.startSpan(name)\n    return await context.with(TRACE_API.setSpan(context.active(), span), async () => {\n      try {\n        const result = await funcToRun()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return await funcToRun()\n  }\n}\n\nexport async function spanRootAsync<T>(\n  name: string,\n  fn: () => Promise<T>,\n  {\n    timeBudgetLimit, logger, tracer,\n  }: SpanConfig = {},\n): Promise<T> {\n  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn\n  const activeTracer = tracer ?? TRACE_API.getTracer(name)\n  if (isDefined(activeTracer)) {\n    const activeContext = context.active()\n\n    const noSpanContext = cloneContextWithoutSpan(activeContext)\n\n    // Create a new span in the context without an active span\n    const span = activeTracer.startSpan(name, {}, noSpanContext)\n\n    // Use the active context but replace its span with our new root span\n    return await context.with(TRACE_API.setSpan(noSpanContext, span), async () => {\n      try {\n        const result = await funcToRun()\n        span.setStatus({ code: SpanStatusCode.OK })\n        return result\n      } catch (ex) {\n        const error = ex as Error\n        span.recordException(error)\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n        throw ex\n      } finally {\n        span.end()\n      }\n    })\n  } else {\n    return await funcToRun()\n  }\n}\n","import type { Logger } from '@xylabs/logger'\n\nexport async function timeBudget<TResult>(\n  name: string,\n  logger: Logger | undefined,\n  func: () => Promise<TResult>,\n  budget: number,\n  status = false,\n): Promise<TResult> {\n  const start = Date.now()\n  const timer = status\n    ? setInterval(() => {\n        const duration = Date.now() - start\n        if ((budget > 0) && (duration > budget)) {\n          logger?.warn(`Function [${name}] execution is exceeding budget: ${duration}ms > ${budget}ms`)\n        }\n      }, Math.max(100, budget))\n    : undefined\n\n  const result = await func()\n  const duration = Date.now() - start\n\n  if (!timer && (budget > 0) && (duration > budget)) {\n    logger?.warn(`Function [${name}] execution exceeded budget: ${duration}ms > ${budget}ms`)\n  }\n  if (timer) {\n    clearInterval(timer)\n  }\n  return result\n}\n"],"mappings":"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","names":["duration","span"]}

package/dist/neutral/span.d.ts

@@ -1,7 +1,13 @@
 import type { Context, Tracer } from '@opentelemetry/api';
+import type { Logger } from '@xylabs/logger';
+export interface SpanConfig {
+    logger?: Logger | null;
+    timeBudgetLimit?: number;
+    tracer?: Tracer;
+}
 export declare function cloneContextWithoutSpan(activeCtx: Context, configKeys?: symbol[]): Context;
 export declare function span<T>(name: string, fn: () => T, tracer?: Tracer): T;
 export declare function spanRoot<T>(name: string, fn: () => T, tracer?: Tracer): T;
-export declare function spanAsync<T>(name: string, fn: () => Promise<T>, tracer?: Tracer): Promise<T>;
-export declare function spanRootAsync<T>(name: string, fn: () => Promise<T>, tracer?: Tracer): Promise<T>;
+export declare function spanAsync<T>(name: string, fn: () => Promise<T>, { timeBudgetLimit, logger, tracer, }?: SpanConfig): Promise<T>;
+export declare function spanRootAsync<T>(name: string, fn: () => Promise<T>, { timeBudgetLimit, logger, tracer, }?: SpanConfig): Promise<T>;
 //# sourceMappingURL=span.d.ts.map

package/dist/neutral/span.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../src/span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACP,MAAM,oBAAoB,CAAA;AAM3B,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,OAAO,CAmB9F;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAqBrE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CA8BzE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CA4BZ"}
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../src/span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACP,MAAM,oBAAoB,CAAA;AAI3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAK5C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,OAAO,CAmB9F;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAqBrE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CA8BzE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,EACE,eAAe,EAAE,MAAM,EAAE,MAAM,GAChC,GAAE,UAAe,GACjB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,EACE,eAAe,EAAE,MAAM,EAAE,MAAM,GAChC,GAAE,UAAe,GACjB,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/neutral/timeBudget.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '@xylabs/logger';
+export declare function timeBudget<TResult>(name: string, logger: Logger | undefined, func: () => Promise<TResult>, budget: number, status?: boolean): Promise<TResult>;
+//# sourceMappingURL=timeBudget.d.ts.map

package/dist/neutral/timeBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeBudget.d.ts","sourceRoot":"","sources":["../../src/timeBudget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE5C,wBAAsB,UAAU,CAAC,OAAO,EACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,UAAQ,GACb,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/telemetry",
-  "version": "5.0.60",
+  "version": "5.0.62",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "keywords": [
     "hex",
@@ -46,7 +46,8 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@xylabs/typeof": "~5.0.60"
+    "@xylabs/logger": "~5.0.62",
+    "@xylabs/typeof": "~5.0.62"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "~7.2.32",
@@ -59,4 +60,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/index.ts

@@ -1 +1,2 @@
 export * from './span.ts'
+export * from './timeBudget.ts'

package/src/span.ts

@@ -5,8 +5,17 @@ import type {
 import {
   context, propagation, ROOT_CONTEXT, SpanStatusCode, trace as TRACE_API,
 } from '@opentelemetry/api'
+import type { Logger } from '@xylabs/logger'
 import { isDefined } from '@xylabs/typeof'
 
+import { timeBudget } from './timeBudget.ts'
+
+export interface SpanConfig {
+  logger?: Logger | null
+  timeBudgetLimit?: number
+  tracer?: Tracer
+}
+
 export function cloneContextWithoutSpan(activeCtx: Context, configKeys: symbol[] = []): Context {
   // Start from root to ensure no span is propagated
   let newCtx = ROOT_CONTEXT
@@ -86,14 +95,17 @@ export function spanRoot<T>(name: string, fn: () => T, tracer?: Tracer): T {
 export async function spanAsync<T>(
   name: string,
   fn: () => Promise<T>,
-  tracer?: Tracer,
+  {
+    timeBudgetLimit, logger, tracer,
+  }: SpanConfig = {},
 ): Promise<T> {
   const activeTracer = tracer ?? TRACE_API.getTracer(name)
+  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn
   if (isDefined(activeTracer)) {
     const span = activeTracer.startSpan(name)
     return await context.with(TRACE_API.setSpan(context.active(), span), async () => {
       try {
-        const result = await fn()
+        const result = await funcToRun()
         span.setStatus({ code: SpanStatusCode.OK })
         return result
       } catch (ex) {
@@ -106,15 +118,18 @@ export async function spanAsync<T>(
       }
     })
   } else {
-    return await fn()
+    return await funcToRun()
   }
 }
 
 export async function spanRootAsync<T>(
   name: string,
   fn: () => Promise<T>,
-  tracer?: Tracer,
+  {
+    timeBudgetLimit, logger, tracer,
+  }: SpanConfig = {},
 ): Promise<T> {
+  const funcToRun = isDefined(timeBudgetLimit) ? () => timeBudget(name, logger ?? console, fn, timeBudgetLimit) : fn
   const activeTracer = tracer ?? TRACE_API.getTracer(name)
   if (isDefined(activeTracer)) {
     const activeContext = context.active()
@@ -127,7 +142,7 @@ export async function spanRootAsync<T>(
     // Use the active context but replace its span with our new root span
     return await context.with(TRACE_API.setSpan(noSpanContext, span), async () => {
       try {
-        const result = await fn()
+        const result = await funcToRun()
         span.setStatus({ code: SpanStatusCode.OK })
         return result
       } catch (ex) {
@@ -140,6 +155,6 @@ export async function spanRootAsync<T>(
       }
     })
   } else {
-    return await fn()
+    return await funcToRun()
   }
 }

package/src/timeBudget.ts

@@ -0,0 +1,30 @@
+import type { Logger } from '@xylabs/logger'
+
+export async function timeBudget<TResult>(
+  name: string,
+  logger: Logger | undefined,
+  func: () => Promise<TResult>,
+  budget: number,
+  status = false,
+): Promise<TResult> {
+  const start = Date.now()
+  const timer = status
+    ? setInterval(() => {
+        const duration = Date.now() - start
+        if ((budget > 0) && (duration > budget)) {
+          logger?.warn(`Function [${name}] execution is exceeding budget: ${duration}ms > ${budget}ms`)
+        }
+      }, Math.max(100, budget))
+    : undefined
+
+  const result = await func()
+  const duration = Date.now() - start
+
+  if (!timer && (budget > 0) && (duration > budget)) {
+    logger?.warn(`Function [${name}] execution exceeded budget: ${duration}ms > ${budget}ms`)
+  }
+  if (timer) {
+    clearInterval(timer)
+  }
+  return result
+}