Class TaskNotesPerformanceProfiler

src/utils/PerformanceProfiler.ts:143–434

}

export class TaskNotesPerformanceProfiler {
	private namespace: string;
	private isEnabledCallback: () => boolean;
	private logger: TaskNotesLogger;
	private now: () => number;
	private sampleLimit: number;
	private slowThresholdMs: number;
	private enabledOverride: boolean | null = null;
	private metrics = new Map<string, MetricAggregate>();
	private counters = new Map<string, CounterAggregate>();
	private gauges = new Map<string, GaugeAggregate>();

	constructor(options: PerformanceProfilerOptions = {}) {
		this.namespace = options.namespace?.trim() || "tasknotes";
		this.isEnabledCallback = options.isEnabled || (() => false);
		this.logger = options.logger || defaultLogger;
		this.now = options.now || defaultNow;
		this.sampleLimit = Math.max(1, options.sampleLimit || DEFAULT_SAMPLE_LIMIT);
		this.slowThresholdMs = Math.max(0, options.slowThresholdMs ?? DEFAULT_SLOW_THRESHOLD_MS);
	}

	isEnabled(): boolean {
		return this.enabledOverride ?? this.isEnabledCallback();
	}

	enable(): void {
		this.enabledOverride = true;
	}

	disable(): void {
		this.enabledOverride = false;
	}

	clearEnabledOverride(): void {
		this.enabledOverride = null;
	}

	child(namespace: string): TaskNotesPerformanceProfiler {
		return new TaskNotesPerformanceProfiler({
			namespace: [this.namespace, namespace].filter(Boolean).join("."),
			isEnabled: () => this.isEnabled(),
			logger: this.logger,
			now: this.now,
			sampleLimit: this.sampleLimit,
			slowThresholdMs: this.slowThresholdMs,
		});
	}

	start(name: string, details?: PerformanceProfilerDetails): PerformanceProfilerSpan {
		if (!this.isEnabled()) {
			return { end: () => 0 };
		}

		const startedAt = this.now();
		let ended = false;

		return {
			end: (endDetails?: PerformanceProfilerDetails): number => {