@ariestools/sdk 7.0.7 → 7.0.8

package/dist/_pkg/telemetry/neutral/span.d.ts

@@ -1,50 +0,0 @@
-import type { Logger } from '../../logger/neutral/index.ts';
-import type { Context, Tracer, TracerProvider } from '@opentelemetry/api';
-/** Configuration options for span creation and execution. */
-export interface SpanConfig {
-    /** Optional logger for time budget warnings. Falls back to console if not provided. */
-    logger?: Logger | null;
-    /** Maximum allowed execution time in milliseconds before logging a warning. */
-    timeBudgetLimit?: number;
-    /** OpenTelemetry tracer to use. Defaults to a tracer named after the span. */
-    tracer?: Tracer;
-}
-/**
- * Creates a new OpenTelemetry context that preserves baggage and custom keys but has no active span.
- * @param activeCtx - The context to clone from.
- * @param configKeys - Additional context keys to copy.
- * @returns A new context with baggage but no parent span.
- */
-export declare function cloneContextWithoutSpan(activeCtx: Context, configKeys?: symbol[]): Context;
-/**
- * Executes a synchronous function within an OpenTelemetry span, recording status and exceptions.
- * @param name - The span name.
- * @param fn - The function to execute.
- * @param tracer - Optional tracer to use.
- * @returns The return value of `fn`.
- */
-export declare function span<T>(name: string, fn: () => T, traceProvider?: TracerProvider): T;
-/**
- * Executes a synchronous function within a new root span that has no parent, even if a span is already active.
- * @param name - The span name.
- * @param fn - The function to execute.
- * @param tracer - Optional tracer to use.
- * @returns The return value of `fn`.
- */
-export declare function spanRoot<T>(name: string, fn: () => T, tracer?: Tracer): T;
-/**
- * Executes an async function within an OpenTelemetry span, with optional time budget monitoring.
- * @param name - The span name.
- * @param fn - The async function to execute.
- * @param config - Optional span configuration (tracer, logger, time budget).
- * @returns The resolved value of `fn`.
- */
-export declare function spanAsync<T>(name: string, fn: () => Promise<T>, { timeBudgetLimit, logger, tracer, }?: SpanConfig): Promise<T>;
-/**
- * Executes an async function within a new root span (no parent), with optional time budget monitoring.
- * @param name - The span name.
- * @param fn - The async function to execute.
- * @param config - Optional span configuration (tracer, logger, time budget).
- * @returns The resolved value of `fn`.
- */
-export declare function spanRootAsync<T>(name: string, fn: () => Promise<T>, { timeBudgetLimit, logger, tracer, }?: SpanConfig): Promise<T>;

package/dist/_pkg/telemetry/neutral/timeBudget.d.ts

@@ -1,11 +0,0 @@
-import type { Logger } from '../../logger/neutral/index.ts';
-/**
- * Executes an async function and logs a warning if it exceeds the given time budget.
- * @param name - A label for the function, used in warning messages.
- * @param logger - The logger to use for budget-exceeded warnings.
- * @param func - The async function to execute.
- * @param budget - The time budget in milliseconds.
- * @param status - If true, logs periodic warnings while the function is still running.
- * @returns The result of the executed function.
- */
-export declare function timeBudget<TResult>(name: string, logger: Logger | undefined, func: () => Promise<TResult>, budget: number, status?: boolean): Promise<TResult>;

package/dist/_pkg/telemetry-exporter/neutral/XyConsoleSpanExporter.d.ts

@@ -1,39 +0,0 @@
-import type { Logger } from '../../logger/neutral/index.ts';
-import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
-import { ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base';
-type LogColor = (value: string) => string;
-/**
- * Calculates the duration of a span in milliseconds from its high-resolution time tuple.
- * @param span - The span to measure.
- * @returns The span duration in milliseconds.
- */
-export declare function spanDurationInMillis(span: ReadableSpan): number;
-/**
- * A console span exporter that formats spans with color-coded durations using chalk.
- * Spans are filtered by a configurable log level based on their duration.
- */
-export declare class XyConsoleSpanExporter extends ConsoleSpanExporter {
-    /** Duration thresholds (in ms) that map to increasing log levels. */
-    static readonly durationToLogLevel: number[];
-    /** Chalk color functions corresponding to each log level. */
-    static readonly logLevelToChalkColor: LogColor[];
-    logger: Logger;
-    private _logLevel;
-    constructor(logLevel?: number, logger?: Logger);
-    /** The minimum log level required for a span to be exported. */
-    get logLevel(): number;
-    export(spans: ReadableSpan[]): void;
-    /**
-     * Returns the chalk color function for the given log level.
-     * @param level - The log level index.
-     * @returns A chalk color function.
-     */
-    logColor(level: number): LogColor;
-    /**
-     * Determines the log level of a span based on its duration.
-     * @param span - The span to evaluate.
-     * @returns The numeric log level (index into durationToLogLevel).
-     */
-    spanLevel(span: ReadableSpan): number;
-}
-export {};

package/dist/_pkg/telemetry-exporter/neutral/index.d.ts

@@ -1 +0,0 @@
-export * from './XyConsoleSpanExporter.ts';

package/dist/_pkg/telemetry-exporter/neutral/index.mjs

@@ -1,87 +0,0 @@
-// src/XyConsoleSpanExporter.ts
-import { ConsoleSpanExporter } from "@opentelemetry/sdk-trace-base";
-var color = (open, close = 39) => {
-  return (value) => `\x1B[${open}m${value}\x1B[${close}m`;
-};
-var logColors = {
-  green: color(32),
-  grey: color(90),
-  magenta: color(35),
-  red: color(31),
-  white: color(37),
-  yellow: color(33)
-};
-function spanDurationInMillis(span) {
-  return span.duration[0] * 1e3 + span.duration[1] / 1e6;
-}
-var XyConsoleSpanExporter = class _XyConsoleSpanExporter extends ConsoleSpanExporter {
-  /** Duration thresholds (in ms) that map to increasing log levels. */
-  static durationToLogLevel = [
-    0,
-    1,
-    10,
-    100,
-    1e3
-  ];
-  /** Chalk color functions corresponding to each log level. */
-  static logLevelToChalkColor = [
-    logColors.grey,
-    logColors.white,
-    logColors.green,
-    logColors.yellow,
-    logColors.red
-  ];
-  logger;
-  _logLevel;
-  constructor(logLevel = 0, logger = console) {
-    super();
-    this._logLevel = logLevel;
-    this.logger = logger;
-  }
-  /** The minimum log level required for a span to be exported. */
-  get logLevel() {
-    return this._logLevel;
-  }
-  export(spans) {
-    for (const span of spans) {
-      const spanLevel = this.spanLevel(span);
-      if (spanLevel < this.logLevel) {
-        continue;
-      }
-      const duration = spanDurationInMillis(span);
-      this.logger.log(logColors.grey([
-        `Span [${span.name}]`,
-        this.logColor(spanLevel)(`${duration}ms`),
-        `TraceId: ${span.spanContext().traceId}`
-      ].join(", ")));
-    }
-  }
-  /**
-   * Returns the chalk color function for the given log level.
-   * @param level - The log level index.
-   * @returns A chalk color function.
-   */
-  logColor(level) {
-    return _XyConsoleSpanExporter.logLevelToChalkColor[level] ?? logColors.magenta;
-  }
-  /**
-   * Determines the log level of a span based on its duration.
-   * @param span - The span to evaluate.
-   * @returns The numeric log level (index into durationToLogLevel).
-   */
-  spanLevel(span) {
-    let logLevel = 0;
-    const duration = spanDurationInMillis(span);
-    for (let x = _XyConsoleSpanExporter.durationToLogLevel.length - 1; x >= 0; x--) {
-      if (duration > _XyConsoleSpanExporter.durationToLogLevel[x]) {
-        logLevel = x;
-        break;
-      }
-    }
-    return logLevel;
-  }
-};
-export {
-  XyConsoleSpanExporter,
-  spanDurationInMillis
-};

package/dist/_pkg/timer/neutral/index.d.ts

@@ -1 +0,0 @@
-export { clearTimeoutEx, defaultTimerScheduler, setTimeoutEx, TimerScheduler, } from './setTimeoutEx.ts';

package/dist/_pkg/timer/neutral/index.mjs

@@ -1,74 +0,0 @@
-// src/setTimeoutEx.ts
-import { assertEx } from "../../assert/neutral/index.mjs";
-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
-};

package/dist/_pkg/timer/neutral/setTimeoutEx.d.ts

@@ -1,36 +0,0 @@
-/** Coalesces multiple logical timeouts into a single native timer. */
-export declare class TimerScheduler {
-    private currentTimeout;
-    private interval;
-    private timeouts;
-    /**
-     * Cancels a timeout previously created with setTimeoutEx.
-     * @param id - The timeout ID returned by setTimeoutEx.
-     */
-    clearTimeoutEx(id: string): void;
-    /** Clears all scheduled timeouts and resets internal state. */
-    reset(): void;
-    /**
-     * 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: () => void, delay: number): string;
-    private timerFunc;
-    private update;
-}
-/** Default scheduler used by the module-level timeout helpers. */
-export declare const defaultTimerScheduler: TimerScheduler;
-/**
- * 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.
- */
-export declare const setTimeoutEx: (func: () => void, delay: number) => string;
-/**
- * Cancels a timeout previously created with setTimeoutEx.
- * @param id - The timeout ID returned by setTimeoutEx.
- */
-export declare const clearTimeoutEx: (id: string) => void;

package/dist/_pkg/typeof/neutral/Brand.d.ts

@@ -1,4 +0,0 @@
-/** Creates a branded type by intersecting base type T with brand type B, enabling nominal typing in TypeScript. */
-export type Brand<T, B> = T & {
-    [K in keyof B]: B[K];
-};

package/dist/_pkg/typeof/neutral/IdentityFunction.d.ts

@@ -1,2 +0,0 @@
-/** A type guard function that narrows an unknown value to type T. */
-export type IdentityFunction<T> = (value: unknown) => value is T;

package/dist/_pkg/typeof/neutral/ObjectTypeShape.d.ts

@@ -1,4 +0,0 @@
-/** Union of string literals representing the possible types of an object field. */
-export type FieldType = 'string' | 'number' | 'object' | 'symbol' | 'undefined' | 'null' | 'array' | 'function';
-/** Describes the expected shape of an object by mapping each key to its expected field type. */
-export type ObjectTypeShape = Record<string | number | symbol, FieldType>;

package/dist/_pkg/typeof/neutral/TypeOfTypes.d.ts

@@ -1,2 +0,0 @@
-/** Union of string literals representing the possible results of the extended `typeOf` function. */
-export type TypeOfTypes = 'string' | 'number' | 'object' | 'array' | 'buffer' | 'null' | 'undefined' | 'bigint' | 'boolean' | 'function' | 'symbol';

package/dist/_pkg/typeof/neutral/Typed.d.ts

@@ -1,40 +0,0 @@
-/** A value that can appear in a typed object tree (primitives, objects, arrays, functions, and symbols). */
-export type TypedValue = bigint | string | number | boolean | null | TypedObject | TypedArray | Function | symbol | undefined;
-/** A valid key for a typed object. Defaults to string | number | symbol unless narrowed by T. */
-export type TypedKey<T extends string | void = void> = T extends string ? T : string | number | symbol;
-/** An object whose keys are TypedKey and whose values are TypedValue. */
-export type TypedObject = object | {
-    [key: TypedKey]: TypedValue;
-};
-/** An array of TypedValue elements. */
-export type TypedArray = TypedValue[];
-/**
- * Type guard that checks whether a value is a valid TypedKey (string, bigint, number, or symbol).
- * @param value - The value to check.
- * @returns True if the value is a valid TypedKey.
- */
-export declare const isTypedKey: (value: unknown) => value is TypedKey;
-/**
- * Type guard that checks whether a value is a valid TypedValue.
- * @param value - The value to check.
- * @returns True if the value is a string, number, boolean, null, TypedObject, or TypedArray.
- */
-export declare const isTypedValue: (value: unknown) => value is TypedValue;
-/**
- * Type guard that checks whether a value is a TypedArray (an array where every element is a TypedValue).
- * @param value - The value to check.
- * @returns True if the value is an array of TypedValue elements.
- */
-export declare const isTypedArray: (value: unknown) => value is TypedArray;
-/**
- * Type guard that checks whether a key-value pair has a valid TypedKey and TypedValue.
- * @param pair - A tuple of [key, value] to validate.
- * @returns True if the key is a TypedKey and the value is a TypedValue.
- */
-export declare const isValidTypedFieldPair: (pair: [key: unknown, value: unknown]) => pair is [key: TypedKey, value: TypedValue];
-/**
- * Type guard that checks whether a value is a TypedObject (an object with TypedKey keys and TypedValue values).
- * @param value - The value to check.
- * @returns True if the value is a valid TypedObject.
- */
-export declare const isTypedObject: (value: unknown) => value is TypedObject;

package/dist/_pkg/typeof/neutral/ifDefined.d.ts

@@ -1,7 +0,0 @@
-/**
- * Invokes the callback only if the value is neither null nor undefined.
- * @param value - The value to check.
- * @param func - The callback to invoke with the value if it is defined.
- * @returns The value if defined, or undefined otherwise.
- */
-export declare const ifDefined: <T>(value: T, func: (value: T) => void) => T | undefined;

package/dist/_pkg/typeof/neutral/ifTypeOf.d.ts

@@ -1,10 +0,0 @@
-import type { TypeOfTypes } from './TypeOfTypes.ts';
-/**
- * Invokes the callback if the value matches the specified type, with an optional additional predicate.
- * @param typeName - The expected type name to match against.
- * @param value - The value to check.
- * @param trueFunc - The callback to invoke if the type matches.
- * @param isFunc - Optional additional predicate that must also return true.
- * @returns The result of trueFunc if the type matches (and isFunc passes), or undefined.
- */
-export declare const ifTypeOf: <T, R>(typeName: TypeOfTypes, value: unknown, trueFunc: (value: T) => R, isFunc?: (value: T) => boolean) => R | undefined;

package/dist/_pkg/typeof/neutral/index.d.ts

@@ -1,11 +0,0 @@
-export * from './Brand.ts';
-export * from './IdentityFunction.ts';
-export * from './ifDefined.ts';
-export * from './ifTypeOf.ts';
-export * from './is.ts';
-export * from './isType.ts';
-export * from './ObjectTypeShape.ts';
-export * from './Typed.ts';
-export * from './typeOf.ts';
-export * from './TypeOfTypes.ts';
-export * from './validateType.ts';

package/dist/_pkg/typeof/neutral/index.mjs

@@ -1,254 +0,0 @@
-// src/typeOf.ts
-var typeOf = (item) => {
-  return Array.isArray(item) ? "array" : typeof item;
-};
-
-// src/ifDefined.ts
-var ifDefined = (value, func) => {
-  switch (typeOf(value)) {
-    case "undefined":
-    case "null": {
-      break;
-    }
-    default: {
-      func(value);
-      return value;
-    }
-  }
-};
-
-// src/ifTypeOf.ts
-var ifTypeOf = (typeName, value, trueFunc, isFunc) => {
-  switch (typeOf(value)) {
-    case typeName: {
-      return !isFunc || isFunc(value) ? trueFunc(value) : void 0;
-    }
-  }
-};
-
-// src/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/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/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/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
-};