@ariestools/sdk 7.0.7 → 7.0.8

package/dist/neutral/telemetry.mjs

@@ -1 +1,159 @@
-export * from '../_pkg/telemetry/neutral/index.mjs'
+// src/modules/telemetry/span.ts
+import {
+  context,
+  propagation,
+  ROOT_CONTEXT,
+  SpanStatusCode,
+  trace as TRACE_API
+} from "@opentelemetry/api";
+
+// src/modules/typeof/is.ts
+function isUndefined(value) {
+  return value === void 0;
+}
+function isDefined(value) {
+  return !isUndefined(value);
+}
+
+// src/modules/telemetry/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 === void 0 && budget > 0 && duration > budget) {
+    logger?.warn(`Function [${name}] execution exceeded budget: ${duration}ms > ${budget}ms`);
+  }
+  if (timer !== void 0) {
+    clearInterval(timer);
+  }
+  return result;
+}
+
+// src/modules/telemetry/span.ts
+function cloneContextWithoutSpan(activeCtx, configKeys = []) {
+  let newCtx = ROOT_CONTEXT;
+  const baggage = propagation.getBaggage(activeCtx);
+  if (baggage) {
+    newCtx = propagation.setBaggage(newCtx, baggage);
+  }
+  for (const key of configKeys) {
+    const value = activeCtx.getValue(key);
+    if (value !== void 0) {
+      newCtx = newCtx.setValue(key, value);
+    }
+  }
+  return newCtx;
+}
+function span(name, fn, traceProvider = TRACE_API) {
+  const activeTracer = traceProvider.getTracer(name);
+  if (isDefined(activeTracer)) {
+    const span2 = activeTracer.startSpan(name);
+    return context.with(TRACE_API.setSpan(context.active(), span2), () => {
+      try {
+        const result = fn();
+        span2.setStatus({ code: SpanStatusCode.OK });
+        return result;
+      } catch (ex) {
+        const error = ex;
+        span2.recordException(error);
+        span2.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        throw ex;
+      } finally {
+        span2.end();
+      }
+    });
+  }
+  return fn();
+}
+function spanRoot(name, fn, tracer) {
+  const activeTracer = tracer ?? TRACE_API.getTracer(name);
+  if (isDefined(activeTracer)) {
+    const activeContext = context.active();
+    const noSpanContext = cloneContextWithoutSpan(activeContext);
+    const span2 = activeTracer.startSpan(name, {}, noSpanContext);
+    return context.with(TRACE_API.setSpan(noSpanContext, span2), () => {
+      try {
+        const result = fn();
+        span2.setStatus({ code: SpanStatusCode.OK });
+        return result;
+      } catch (ex) {
+        const error = ex;
+        span2.recordException(error);
+        span2.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        throw ex;
+      } finally {
+        span2.end();
+      }
+    });
+  }
+  return fn();
+}
+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 funcToRun();
+        span2.setStatus({ code: SpanStatusCode.OK });
+        return result;
+      } catch (ex) {
+        const error = ex;
+        span2.recordException(error);
+        span2.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        throw ex;
+      } finally {
+        span2.end();
+      }
+    });
+  }
+  return await funcToRun();
+}
+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();
+    const noSpanContext = cloneContextWithoutSpan(activeContext);
+    const span2 = activeTracer.startSpan(name, {}, noSpanContext);
+    return await context.with(TRACE_API.setSpan(noSpanContext, span2), async () => {
+      try {
+        const result = await funcToRun();
+        span2.setStatus({ code: SpanStatusCode.OK });
+        return result;
+      } catch (ex) {
+        const error = ex;
+        span2.recordException(error);
+        span2.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        throw ex;
+      } finally {
+        span2.end();
+      }
+    });
+  }
+  return await funcToRun();
+}
+export {
+  cloneContextWithoutSpan,
+  span,
+  spanAsync,
+  spanRoot,
+  spanRootAsync,
+  timeBudget
+};
+//# sourceMappingURL=telemetry.mjs.map

package/dist/neutral/telemetry.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/telemetry/span.ts", "../../src/modules/typeof/is.ts", "../../src/modules/telemetry/timeBudget.ts"],
+  "sourcesContent": ["import type {\n  Context,\n  Tracer,\n  TracerProvider,\n} from '@opentelemetry/api'\nimport {\n  context, propagation, ROOT_CONTEXT, SpanStatusCode, trace as TRACE_API,\n} from '@opentelemetry/api'\n\nimport type { Logger } from '#logger'\nimport { isDefined } from '#typeof'\n\nimport { timeBudget } from './timeBudget.ts'\n\ndeclare const console: Logger\n\n/** Configuration options for span creation and execution. */\nexport interface SpanConfig {\n  /** Optional logger for time budget warnings. Falls back to console if not provided. */\n  logger?: Logger | null\n  /** Maximum allowed execution time in milliseconds before logging a warning. */\n  timeBudgetLimit?: number\n  /** OpenTelemetry tracer to use. Defaults to a tracer named after the span. */\n  tracer?: Tracer\n}\n\n/**\n * Creates a new OpenTelemetry context that preserves baggage and custom keys but has no active span.\n * @param activeCtx - The context to clone from.\n * @param configKeys - Additional context keys to copy.\n * @returns A new context with baggage but no parent span.\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\n/**\n * Executes a synchronous function within an OpenTelemetry span, recording status and exceptions.\n * @param name - The span name.\n * @param fn - The function to execute.\n * @param tracer - Optional tracer to use.\n * @returns The return value of `fn`.\n */\nexport function span<T>(name: string, fn: () => T, traceProvider: TracerProvider = TRACE_API): T {\n  const activeTracer = traceProvider.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  }\n  return fn()\n}\n\n/**\n * Executes a synchronous function within a new root span that has no parent, even if a span is already active.\n * @param name - The span name.\n * @param fn - The function to execute.\n * @param tracer - Optional tracer to use.\n * @returns The return value of `fn`.\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  }\n  return fn()\n}\n\n/**\n * Executes an async function within an OpenTelemetry span, with optional time budget monitoring.\n * @param name - The span name.\n * @param fn - The async function to execute.\n * @param config - Optional span configuration (tracer, logger, time budget).\n * @returns The resolved value of `fn`.\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  }\n  return await funcToRun()\n}\n\n/**\n * Executes an async function within a new root span (no parent), with optional time budget monitoring.\n * @param name - The span name.\n * @param fn - The async function to execute.\n * @param config - Optional span configuration (tracer, logger, time budget).\n * @returns The resolved value of `fn`.\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  }\n  return await funcToRun()\n}\n", "/// <reference lib=\"dom\" />\n\n/** A function type that accepts any arguments and returns unknown. */\nexport type AnyFunction = (...args: unknown[]) => unknown\n\n/** A union of valid object key types. */\nexport type RecordKey = string | number | symbol\n\n/** Type guard that checks whether a value is undefined. */\nexport function isUndefined(value: unknown): value is undefined\nexport function isUndefined<T>(value: T): value is Extract<T, undefined>\nexport function isUndefined(value: unknown): value is undefined {\n  return value === undefined\n}\n\n/** Type guard that checks whether a value is not undefined. */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n  return !isUndefined(value)\n}\n\n/** Type guard that checks whether a value is null. */\nexport function isNull(value: unknown): value is null\nexport function isNull<T>(value: T): value is Extract<T, null>\nexport function isNull(value: unknown): value is null {\n  return value === null\n}\n\n/** Type guard that checks whether a value is neither undefined nor null. */\nexport function isDefinedNotNull<T>(value: T): value is Exclude<T, undefined | null> {\n  return !isUndefined(value) && !isNull(value)\n}\n\n/** Type guard that checks whether a value is undefined or null. */\nexport function isUndefinedOrNull(value: unknown): value is undefined | null\nexport function isUndefinedOrNull<T>(value: T): value is Extract<T, undefined | null>\nexport function isUndefinedOrNull(value: unknown): value is undefined | null {\n  return isUndefined(value) || isNull(value)\n}\n\n/** Type guard that checks whether a value is a bigint. */\nexport function isBigInt(value: unknown): value is bigint\nexport function isBigInt<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isBigInt(value: unknown): value is bigint {\n  return typeof value === 'bigint'\n}\n\n/** Type guard that checks whether a value is a string. */\nexport function isString(value: unknown): value is string\nexport function isString<T extends string>(value: T): value is Extract<T, string>\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string'\n}\n\n/** Type guard that checks whether a value is a number. */\nexport function isNumber(value: unknown): value is number\nexport function isNumber<T extends number>(value: T): value is Extract<T, number>\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number'\n}\n\n/** Type guard that checks whether a value is a plain object (not null and not an array). */\nexport function isObject(value: unknown): value is object\nexport function isObject<T extends object>(value: T): value is Extract<T, object>\nexport function isObject(value: unknown): value is object {\n  return (typeof value === 'object') && (value !== null) && !Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is an array. */\nexport function isArray(value: unknown): value is readonly unknown[]\nexport function isArray<T>(value: T): value is Extract<T, readonly unknown[]>\nexport function isArray(value: unknown): value is readonly unknown[] {\n  return Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is a function. */\nexport function isFunction(value: unknown): value is AnyFunction\nexport function isFunction<T extends AnyFunction>(value: T): value is Extract<T, AnyFunction>\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === 'function'\n}\n\n/** Type guard that checks whether a value is a symbol. */\nexport function isSymbol(value: unknown): value is symbol\nexport function isSymbol<T extends symbol>(value: T): value is Extract<T, symbol>\nexport function isSymbol(value: unknown): value is symbol {\n  return typeof value === 'symbol'\n}\n\n/** Type guard that checks whether a value is an object with no own keys. */\nexport function isEmptyObject(value: unknown): value is {}\nexport function isEmptyObject<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmptyObject(value: unknown): value is {} {\n  return isObject(value) && Object.keys(value).length === 0\n}\n\n/** Type guard that checks whether a value is an empty string. */\nexport function isEmptyString(value: unknown): value is ''\nexport function isEmptyString<T extends string>(value: T): value is Extract<T, ''>\nexport function isEmptyString(value: unknown): value is '' {\n  return isString(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is an empty array. */\nexport function isEmptyArray(value: unknown): value is []\nexport function isEmptyArray<T extends unknown[]>(value: T): value is Extract<T, unknown[]>\nexport function isEmptyArray(value: unknown): value is [] {\n  return isArray(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is a non-empty array. */\nexport function isPopulatedArray(value: unknown): value is readonly unknown[]\nexport function isPopulatedArray<T extends unknown[]>(value: T): value is Extract<T, readonly unknown[]>\nexport function isPopulatedArray(value: unknown): value is readonly unknown[] {\n  return isArray(value) && value.length > 0\n}\n\n/** Type guard that checks whether a value is empty (empty string, empty array, or empty object). */\nexport function isEmpty<T>(value: unknown): value is T\nexport function isEmpty<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmpty<T extends unknown[]>(value: T): value is Extract<T, never[]>\nexport function isEmpty<T>(value: unknown): value is T {\n  return isEmptyString(value) || isEmptyArray(value) || isEmptyObject(value)\n}\n\n/** Type guard that checks whether a value is falsy (0, null, undefined, false, '', or 0n). */\nexport function isFalsy<T>(value: T): value is Extract<T, 0 | null | undefined | false | '' | 0n>\nexport function isFalsy<T extends boolean>(value: T): value is Extract<T, false>\nexport function isFalsy<T extends number>(value: T): value is Extract<T, 0>\nexport function isFalsy<T extends bigint>(value: T): value is Extract<T, 0n>\nexport function isFalsy<T extends null>(value: T): value is Extract<T, null>\nexport function isFalsy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isFalsy<T extends string>(value: T): value is Extract<T, ''>\nexport function isFalsy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript falsy semantics (incl. NaN)\n  return !value\n}\n\n/** Type guard that checks whether a value is truthy (not 0, null, undefined, false, '', or 0n). */\nexport function isTruthy<T>(value: T): value is Exclude<T, 0 | null | undefined | false | '' | 0n>\nexport function isTruthy<T extends boolean>(value: T): value is Extract<T, true>\nexport function isTruthy<T extends number>(value: T): value is Extract<T, number>\nexport function isTruthy<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isTruthy<T extends null>(value: T): value is Extract<T, null>\nexport function isTruthy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isTruthy<T extends string>(value: T): value is Extract<T, string>\nexport function isTruthy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript truthy semantics\n  return !!value\n}\n\n/** Type guard that checks whether a value is a boolean. */\nexport function isBoolean(value: unknown): value is boolean\nexport function isBoolean<T extends boolean>(value: T): value is Extract<T, boolean>\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean'\n}\n\n/** Type guard that checks whether a value is a string that can be parsed as a valid date. */\nexport function isDateString(value: unknown): value is string\nexport function isDateString<T>(value: T): value is Extract<T, string>\nexport function isDateString(value: unknown): value is string {\n  return isString(value) && !Number.isNaN(Date.parse(value))\n}\n\n/** Type guard that checks whether a value is a Date instance. */\nexport function isDate(value: unknown): value is Date\nexport function isDate<T>(value: T): value is Extract<T, Date>\nexport function isDate(value: unknown): value is Date {\n  return value instanceof Date\n}\n\n/** Type guard that checks whether a value is a RegExp instance. */\nexport function isRegExp(value: unknown): value is RegExp\nexport function isRegExp<T extends RegExp>(value: T): value is Extract<T, RegExp>\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp\n}\n\n/** Type guard that checks whether a value is an Error instance. */\nexport function isError(value: unknown): value is Error\nexport function isError<T>(value: T): value is Extract<T, Error>\nexport function isError(value: unknown): value is Error {\n  return value instanceof Error\n}\n\n/** Type guard that checks whether a value is a Promise instance. */\nexport function isPromise(value: unknown): value is Promise<unknown>\nexport function isPromise<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  return value instanceof Promise\n}\n\n/** Type guard that checks whether a value is promise-like (has a `then` method). */\nexport function isPromiseLike(value: unknown): value is Promise<unknown>\nexport function isPromiseLike<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromiseLike(value: unknown): value is Promise<unknown> {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && typeof (value as Record<string, unknown>).then === 'function'\n  )\n}\n\n/** Type guard that checks whether a value is a Map instance. */\nexport function isMap(value: unknown): value is Map<unknown, unknown>\nexport function isMap<K, V, T extends Map<K, V>>(value: T): value is Extract<T, Map<K, V>>\nexport function isMap(value: unknown): value is Map<unknown, unknown> {\n  return value instanceof Map\n}\n\n/** Type guard that checks whether a value is an ArrayBufferView (e.g., TypedArray or DataView). */\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView\nexport function isArrayBufferView<T extends ArrayBufferView>(value: T): value is Extract<T, ArrayBufferView>\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView {\n  return ArrayBuffer.isView(value)\n}\n\n/** Type guard that checks whether a value is a Set instance. */\nexport function isSet(value: unknown): value is Set<unknown>\nexport function isSet<T extends Set<unknown>>(value: T): value is Extract<T, Set<unknown>>\nexport function isSet(value: unknown): value is Set<unknown> {\n  return value instanceof Set\n}\n\n/** Type guard that checks whether a value is a WeakMap instance. */\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown>\nexport function isWeakMap<K extends WeakKey, V, T extends WeakMap<K, V>>(value: T): value is Extract<T, WeakMap<K, V>>\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown> {\n  return value instanceof WeakMap\n}\n\n/** Type guard that checks whether a value is a WeakSet instance. */\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey>\nexport function isWeakSet<K extends WeakKey, T extends WeakSet<K>>(value: T): value is Extract<T, WeakSet<K>>\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey> {\n  return value instanceof WeakSet\n}\n\n/** Type guard that checks whether a value is a DataView instance. */\nexport function isDataView(value: unknown): value is DataView\nexport function isDataView<T>(value: T): value is Extract<T, DataView>\nexport function isDataView(value: unknown): value is DataView {\n  return value instanceof DataView\n}\n\n/** Type guard that checks whether a value is a Blob instance. */\nexport function isBlob(value: unknown): value is Blob\nexport function isBlob<T extends Blob>(value: T): value is Extract<T, Blob>\nexport function isBlob(value: unknown): value is Blob {\n  return typeof Blob !== 'undefined' && value instanceof Blob\n}\n\n/** Type guard that checks whether a value is a File instance. */\nexport function isFile(value: unknown): value is File\nexport function isFile<T extends File>(value: T): value is Extract<T, File>\nexport function isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File\n}\n", "import type { Logger } from '#logger'\n\ndeclare function setInterval(handler: () => void, timeout?: number): unknown\ndeclare function clearInterval(intervalId: ReturnType<typeof setInterval>): void\n\n/**\n * Executes an async function and logs a warning if it exceeds the given time budget.\n * @param name - A label for the function, used in warning messages.\n * @param logger - The logger to use for budget-exceeded warnings.\n * @param func - The async function to execute.\n * @param budget - The time budget in milliseconds.\n * @param status - If true, logs periodic warnings while the function is still running.\n * @returns The result of the executed function.\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 === undefined && (budget > 0) && (duration > budget)) {\n    logger?.warn(`Function [${name}] execution exceeded budget: ${duration}ms > ${budget}ms`)\n  }\n  if (timer !== undefined) {\n    clearInterval(timer)\n  }\n  return result\n}\n"],
+  "mappings": "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",
+  "names": ["duration", "span"]
+}

package/dist/neutral/telemetry.model.d.ts

@@ -1 +1,2 @@
-export type * from '../_pkg/telemetry/neutral/model.ts'
+export type * from './modules/telemetry/model.js';
+//# sourceMappingURL=telemetry.model.d.ts.map

package/dist/neutral/telemetry.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.model.d.ts","sourceRoot":"","sources":["../../src/telemetry.model.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAA"}

package/dist/neutral/telemetry.model.mjs

@@ -1 +1 @@
-export * from '../_pkg/telemetry/neutral/model.mjs'
+//# sourceMappingURL=telemetry.model.mjs.map

package/dist/neutral/telemetry.model.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/neutral/timer.d.ts

@@ -1 +1,2 @@
-export * from '../_pkg/timer/neutral/index.ts'
+export * from './modules/timer/index.js';
+//# sourceMappingURL=timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/timer.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA"}

package/dist/neutral/timer.mjs

@@ -1 +1,87 @@
-export * from '../_pkg/timer/neutral/index.mjs'
+// src/modules/assert/assertEx.ts
+function assertEx(expr, func) {
+  if (expr !== void 0 && expr !== null && expr !== false && expr !== 0 && expr !== "" && expr !== 0n) return expr;
+  if (typeof func === "function") {
+    const errorOrMessage = func(expr);
+    throw typeof errorOrMessage === "string" ? new Error(errorOrMessage) : errorOrMessage;
+  }
+  if (func !== void 0) {
+    throw new Error("Invalid assertEx usage: second argument must be a function or undefined");
+  }
+  throw new Error("Assertion failed");
+}
+
+// src/modules/timer/setTimeoutEx.ts
+var TimerScheduler = class {
+  currentTimeout;
+  interval = -1;
+  timeouts = [];
+  /**
+   * Cancels a timeout previously created with setTimeoutEx.
+   * @param id - The timeout ID returned by setTimeoutEx.
+   */
+  clearTimeoutEx(id) {
+    this.timeouts = this.timeouts.filter((timeout) => timeout.id !== id);
+    this.update(this.timeouts);
+  }
+  /** Clears all scheduled timeouts and resets internal state. */
+  reset() {
+    this.interval = -1;
+    clearTimeout(this.currentTimeout);
+    this.currentTimeout = void 0;
+    this.timeouts = [];
+  }
+  /**
+   * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.
+   * @param func - The function to call after the delay.
+   * @param delay - The delay in milliseconds (must be >= 0).
+   * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.
+   */
+  setTimeoutEx(func, delay) {
+    assertEx(delay >= 0, () => "delay must be >= 0");
+    const id = `${Date.now()}|${Math.random() * 9999999999}`;
+    this.timeouts.push({
+      delay,
+      func,
+      id
+    });
+    this.update();
+    return id;
+  }
+  timerFunc() {
+    const notFiring = this.timeouts.filter((timeout) => timeout.delay > this.interval);
+    const firing = this.timeouts.filter((timeout) => timeout.delay <= this.interval);
+    this.update(notFiring, this.interval);
+    for (const timeout of firing) {
+      timeout.func();
+    }
+  }
+  update(newTimeouts = this.timeouts, delayPassed = 0) {
+    if (newTimeouts.length === 0) {
+      this.reset();
+    } else {
+      const newInterval = Math.min(...newTimeouts.map((timeout) => timeout.delay));
+      if (newInterval === this.interval && this.currentTimeout !== void 0) {
+        return;
+      }
+      clearTimeout(this.currentTimeout);
+      this.timeouts = newTimeouts.map((timeout) => ({
+        delay: timeout.delay - delayPassed,
+        func: timeout.func,
+        id: timeout.id
+      }));
+      this.interval = newInterval;
+      this.currentTimeout = setTimeout(() => this.timerFunc(), this.interval);
+    }
+  }
+};
+var defaultTimerScheduler = new TimerScheduler();
+var setTimeoutEx = (func, delay) => defaultTimerScheduler.setTimeoutEx(func, delay);
+var clearTimeoutEx = (id) => defaultTimerScheduler.clearTimeoutEx(id);
+export {
+  TimerScheduler,
+  clearTimeoutEx,
+  defaultTimerScheduler,
+  setTimeoutEx
+};
+//# sourceMappingURL=timer.mjs.map

package/dist/neutral/timer.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/assert/assertEx.ts", "../../src/modules/timer/setTimeoutEx.ts"],
+  "sourcesContent": ["import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'\n\n/**\n * Asserts that an expression is truthy and returns the value.\n * Throws an error if the expression is falsy.\n *\n * @template T - The type of value to check\n * @param expr - Expression to be evaluated for truthiness\n * @param messageFunc - Function that returns a message for the error if expression is falsy\n * @throws Error with the message returned by messageFunc\n * @returns The value of the expression (guaranteed to be truthy)\n * @example\n * ```typescript\n * // Simple usage with a message function\n * const value = assertEx(possiblyFalsy, () => 'Value must be truthy')\n *\n * // Using with type narrowing\n * const config: Config | null = loadConfig()\n * const safeConfig = assertEx(config, () => 'Config failed to load')\n * // safeConfig is now type Config (not Config | null)\n * ```\n */\nfunction assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T\n\n/**\n * Asserts that an expression is truthy and returns the value.\n * Throws a custom error if the expression is falsy.\n *\n * @template T - The type of value to check\n * @template R - The type of error to throw\n * @param expr - Expression to be evaluated for truthiness\n * @param errorFunc - Function that returns a custom error instance if expression is falsy\n * @throws Custom error returned by errorFunc\n * @returns The value of the expression (guaranteed to be truthy)\n * @example\n * ```typescript\n * // Using with a custom error\n * const user = assertEx(getUser(), () => new UserNotFoundError('User not found'))\n * ```\n */\nfunction assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T\n\n/**\n * Implementation of assertEx that handles all overloads.\n */\nfunction assertEx<T, R extends Error, P extends AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(\n  expr: T | null | undefined,\n  func?: P,\n): T {\n  if (expr !== undefined && expr !== null && expr !== false && expr !== 0 && expr !== '' && expr !== 0n) return expr\n  if (typeof func === 'function') {\n    const errorOrMessage = func(expr)\n    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage\n  }\n  if (func !== undefined) {\n    throw new Error('Invalid assertEx usage: second argument must be a function or undefined')\n  }\n  throw new Error('Assertion failed')\n}\n\nexport { assertEx }\n", "import { assertEx } from '#assert'\n\ntype TimeoutHandle = object | number\n\ndeclare function setTimeout(handler: () => void, timeout?: number): TimeoutHandle\ndeclare function clearTimeout(timeoutId: TimeoutHandle | undefined): void\n\ninterface TimeoutInfo {\n  delay: number\n  func: () => void\n  id: string\n}\n\n/** Coalesces multiple logical timeouts into a single native timer. */\nexport class TimerScheduler {\n  private currentTimeout: TimeoutHandle | undefined\n  private interval = -1\n  private timeouts: TimeoutInfo[] = []\n\n  /**\n   * Cancels a timeout previously created with setTimeoutEx.\n   * @param id - The timeout ID returned by setTimeoutEx.\n   */\n  clearTimeoutEx(id: string) {\n    this.timeouts = this.timeouts.filter(timeout => timeout.id !== id)\n    this.update(this.timeouts)\n  }\n\n  /** Clears all scheduled timeouts and resets internal state. */\n  reset() {\n    this.interval = -1\n    clearTimeout(this.currentTimeout)\n    this.currentTimeout = undefined\n    this.timeouts = []\n  }\n\n  /**\n   * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.\n   * @param func - The function to call after the delay.\n   * @param delay - The delay in milliseconds (must be >= 0).\n   * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.\n   */\n  setTimeoutEx(func: () => void, delay: number) {\n    assertEx(delay >= 0, () => 'delay must be >= 0')\n    const id = `${Date.now()}|${Math.random() * 9_999_999_999}`\n    this.timeouts.push({\n      delay, func, id,\n    })\n    this.update()\n    return id\n  }\n\n  private timerFunc() {\n    const notFiring = this.timeouts.filter(timeout => timeout.delay > this.interval)\n    const firing = this.timeouts.filter(timeout => timeout.delay <= this.interval)\n\n    this.update(notFiring, this.interval)\n\n    for (const timeout of firing) {\n      timeout.func()\n    }\n  }\n\n  private update(newTimeouts = this.timeouts, delayPassed = 0) {\n    if (newTimeouts.length === 0) {\n      this.reset()\n    } else {\n      const newInterval = Math.min(...newTimeouts.map(timeout => timeout.delay))\n\n      if (newInterval === this.interval && this.currentTimeout !== undefined) {\n        return\n      }\n      clearTimeout(this.currentTimeout)\n      this.timeouts = newTimeouts.map(timeout => ({\n        delay: timeout.delay - delayPassed, func: timeout.func, id: timeout.id,\n      }))\n      this.interval = newInterval\n      this.currentTimeout = setTimeout(() => this.timerFunc(), this.interval)\n    }\n  }\n}\n\n/** Default scheduler used by the module-level timeout helpers. */\nexport const defaultTimerScheduler = new TimerScheduler()\n\n/**\n * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.\n * @param func - The function to call after the delay.\n * @param delay - The delay in milliseconds (must be >= 0).\n * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.\n */\nexport const setTimeoutEx = (func: () => void, delay: number) => defaultTimerScheduler.setTimeoutEx(func, delay)\n\n/**\n * Cancels a timeout previously created with setTimeoutEx.\n * @param id - The timeout ID returned by setTimeoutEx.\n */\nexport const clearTimeoutEx = (id: string) => defaultTimerScheduler.clearTimeoutEx(id)\n"],
+  "mappings": ";AA6CA,SAAS,SACP,MACA,MACG;AACH,MAAI,SAAS,UAAa,SAAS,QAAQ,SAAS,SAAS,SAAS,KAAK,SAAS,MAAM,SAAS,GAAI,QAAO;AAC9G,MAAI,OAAO,SAAS,YAAY;AAC9B,UAAM,iBAAiB,KAAK,IAAI;AAChC,UAAM,OAAO,mBAAmB,WAAW,IAAI,MAAM,cAAc,IAAI;AAAA,EACzE;AACA,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,yEAAyE;AAAA,EAC3F;AACA,QAAM,IAAI,MAAM,kBAAkB;AACpC;;;AC5CO,IAAM,iBAAN,MAAqB;AAAA,EAClB;AAAA,EACA,WAAW;AAAA,EACX,WAA0B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,eAAe,IAAY;AACzB,SAAK,WAAW,KAAK,SAAS,OAAO,aAAW,QAAQ,OAAO,EAAE;AACjE,SAAK,OAAO,KAAK,QAAQ;AAAA,EAC3B;AAAA;AAAA,EAGA,QAAQ;AACN,SAAK,WAAW;AAChB,iBAAa,KAAK,cAAc;AAChC,SAAK,iBAAiB;AACtB,SAAK,WAAW,CAAC;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa,MAAkB,OAAe;AAC5C,aAAS,SAAS,GAAG,MAAM,oBAAoB;AAC/C,UAAM,KAAK,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,UAAa;AACzD,SAAK,SAAS,KAAK;AAAA,MACjB;AAAA,MAAO;AAAA,MAAM;AAAA,IACf,CAAC;AACD,SAAK,OAAO;AACZ,WAAO;AAAA,EACT;AAAA,EAEQ,YAAY;AAClB,UAAM,YAAY,KAAK,SAAS,OAAO,aAAW,QAAQ,QAAQ,KAAK,QAAQ;AAC/E,UAAM,SAAS,KAAK,SAAS,OAAO,aAAW,QAAQ,SAAS,KAAK,QAAQ;AAE7E,SAAK,OAAO,WAAW,KAAK,QAAQ;AAEpC,eAAW,WAAW,QAAQ;AAC5B,cAAQ,KAAK;AAAA,IACf;AAAA,EACF;AAAA,EAEQ,OAAO,cAAc,KAAK,UAAU,cAAc,GAAG;AAC3D,QAAI,YAAY,WAAW,GAAG;AAC5B,WAAK,MAAM;AAAA,IACb,OAAO;AACL,YAAM,cAAc,KAAK,IAAI,GAAG,YAAY,IAAI,aAAW,QAAQ,KAAK,CAAC;AAEzE,UAAI,gBAAgB,KAAK,YAAY,KAAK,mBAAmB,QAAW;AACtE;AAAA,MACF;AACA,mBAAa,KAAK,cAAc;AAChC,WAAK,WAAW,YAAY,IAAI,cAAY;AAAA,QAC1C,OAAO,QAAQ,QAAQ;AAAA,QAAa,MAAM,QAAQ;AAAA,QAAM,IAAI,QAAQ;AAAA,MACtE,EAAE;AACF,WAAK,WAAW;AAChB,WAAK,iBAAiB,WAAW,MAAM,KAAK,UAAU,GAAG,KAAK,QAAQ;AAAA,IACxE;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB,IAAI,eAAe;AAQjD,IAAM,eAAe,CAAC,MAAkB,UAAkB,sBAAsB,aAAa,MAAM,KAAK;AAMxG,IAAM,iBAAiB,CAAC,OAAe,sBAAsB,eAAe,EAAE;",
+  "names": []
+}

package/dist/neutral/typeof.d.ts

@@ -1 +1,2 @@
-export * from '../_pkg/typeof/neutral/index.ts'
+export * from './modules/typeof/index.js';
+//# sourceMappingURL=typeof.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typeof.d.ts","sourceRoot":"","sources":["../../src/typeof.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/dist/neutral/typeof.mjs

@@ -1 +1,255 @@
-export * from '../_pkg/typeof/neutral/index.mjs'
+// src/modules/typeof/typeOf.ts
+var typeOf = (item) => {
+  return Array.isArray(item) ? "array" : typeof item;
+};
+
+// src/modules/typeof/ifDefined.ts
+var ifDefined = (value, func) => {
+  switch (typeOf(value)) {
+    case "undefined":
+    case "null": {
+      break;
+    }
+    default: {
+      func(value);
+      return value;
+    }
+  }
+};
+
+// src/modules/typeof/ifTypeOf.ts
+var ifTypeOf = (typeName, value, trueFunc, isFunc) => {
+  switch (typeOf(value)) {
+    case typeName: {
+      return !isFunc || isFunc(value) ? trueFunc(value) : void 0;
+    }
+  }
+};
+
+// src/modules/typeof/is.ts
+function isUndefined(value) {
+  return value === void 0;
+}
+function isDefined(value) {
+  return !isUndefined(value);
+}
+function isNull(value) {
+  return value === null;
+}
+function isDefinedNotNull(value) {
+  return !isUndefined(value) && !isNull(value);
+}
+function isUndefinedOrNull(value) {
+  return isUndefined(value) || isNull(value);
+}
+function isBigInt(value) {
+  return typeof value === "bigint";
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isArray(value) {
+  return Array.isArray(value);
+}
+function isFunction(value) {
+  return typeof value === "function";
+}
+function isSymbol(value) {
+  return typeof value === "symbol";
+}
+function isEmptyObject(value) {
+  return isObject(value) && Object.keys(value).length === 0;
+}
+function isEmptyString(value) {
+  return isString(value) && value.length === 0;
+}
+function isEmptyArray(value) {
+  return isArray(value) && value.length === 0;
+}
+function isPopulatedArray(value) {
+  return isArray(value) && value.length > 0;
+}
+function isEmpty(value) {
+  return isEmptyString(value) || isEmptyArray(value) || isEmptyObject(value);
+}
+function isFalsy(value) {
+  return !value;
+}
+function isTruthy(value) {
+  return !!value;
+}
+function isBoolean(value) {
+  return typeof value === "boolean";
+}
+function isDateString(value) {
+  return isString(value) && !Number.isNaN(Date.parse(value));
+}
+function isDate(value) {
+  return value instanceof Date;
+}
+function isRegExp(value) {
+  return value instanceof RegExp;
+}
+function isError(value) {
+  return value instanceof Error;
+}
+function isPromise(value) {
+  return value instanceof Promise;
+}
+function isPromiseLike(value) {
+  return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+function isMap(value) {
+  return value instanceof Map;
+}
+function isArrayBufferView(value) {
+  return ArrayBuffer.isView(value);
+}
+function isSet(value) {
+  return value instanceof Set;
+}
+function isWeakMap(value) {
+  return value instanceof WeakMap;
+}
+function isWeakSet(value) {
+  return value instanceof WeakSet;
+}
+function isDataView(value) {
+  return value instanceof DataView;
+}
+function isBlob(value) {
+  return typeof Blob !== "undefined" && value instanceof Blob;
+}
+function isFile(value) {
+  return typeof File !== "undefined" && value instanceof File;
+}
+
+// src/modules/typeof/isType.ts
+var isType = (value, expectedType) => {
+  const typeofValue = typeof value;
+  switch (expectedType) {
+    case "array": {
+      return Array.isArray(value);
+    }
+    case "null": {
+      return value === null;
+    }
+    case "undefined": {
+      return value === void 0;
+    }
+    case "object": {
+      if (value === null) {
+        return false;
+      }
+      return typeofValue === "object" && !Array.isArray(value);
+    }
+    default: {
+      return typeofValue === expectedType;
+    }
+  }
+};
+
+// src/modules/typeof/Typed.ts
+var isTypedKey = (value) => {
+  switch (typeof value) {
+    case "string":
+    case "bigint":
+    case "number":
+    case "symbol": {
+      return true;
+    }
+    default: {
+      return false;
+    }
+  }
+};
+var isTypedValue = (value) => {
+  switch (typeof value) {
+    case "string":
+    case "number":
+    case "boolean": {
+      return true;
+    }
+    default: {
+      return value === null || isTypedObject(value) || isTypedArray(value);
+    }
+  }
+};
+var isTypedArray = (value) => {
+  return Array.isArray(value) && value.every((item) => isTypedValue(item));
+};
+var isValidTypedFieldPair = (pair) => {
+  const [key, value] = pair;
+  return isTypedKey(key) && isTypedValue(value);
+};
+var isTypedObject = (value) => {
+  return isType(value, "object") && Object.entries(value).every((item) => isValidTypedFieldPair(item));
+};
+
+// src/modules/typeof/validateType.ts
+var validateType = (typeName, value, optional = false) => {
+  switch (typeOf(value)) {
+    case typeName: {
+      return [value, []];
+    }
+    default: {
+      if (optional && typeOf(value) === "undefined") {
+        return [value, []];
+      }
+      return [void 0, [new Error(`value type is not '${typeName}:${typeof value}'`)]];
+    }
+  }
+};
+export {
+  ifDefined,
+  ifTypeOf,
+  isArray,
+  isArrayBufferView,
+  isBigInt,
+  isBlob,
+  isBoolean,
+  isDataView,
+  isDate,
+  isDateString,
+  isDefined,
+  isDefinedNotNull,
+  isEmpty,
+  isEmptyArray,
+  isEmptyObject,
+  isEmptyString,
+  isError,
+  isFalsy,
+  isFile,
+  isFunction,
+  isMap,
+  isNull,
+  isNumber,
+  isObject,
+  isPopulatedArray,
+  isPromise,
+  isPromiseLike,
+  isRegExp,
+  isSet,
+  isString,
+  isSymbol,
+  isTruthy,
+  isType,
+  isTypedArray,
+  isTypedKey,
+  isTypedObject,
+  isTypedValue,
+  isUndefined,
+  isUndefinedOrNull,
+  isValidTypedFieldPair,
+  isWeakMap,
+  isWeakSet,
+  typeOf,
+  validateType
+};
+//# sourceMappingURL=typeof.mjs.map