@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/utils/decorators/debounce.js

@@ -1,21 +1,18 @@
-import { debounce as _debounce } from '../debounce.js';
-export function debounce(wait, options) {
-    return (_target, key, descriptor) => {
-        if (typeof descriptor.value !== 'function') {
-            throw new Error(`@debounce can only be used on methods, not on ${typeof descriptor.value}`);
-        }
-        const original = descriptor.value;
-        // Replace the descriptor value with a function that creates a debounced version
-        // of the original method for each instance
-        descriptor.value = function (...args) {
-            // Instance-specific storage key
-            const debounceKey = `__debounced_${key}`;
-            // Create the debounced function if it doesn't exist on this instance
-            this[debounceKey] ??= _debounce((...innerArgs) => original.apply(this, innerArgs), wait, options);
-            // Call the per-instance debounced function
-            return this[debounceKey](...args);
-        };
-        return descriptor;
-    };
+import { debounce as debounce$1 } from "../debounce.js";
+//#region ../utils/src/decorators/debounce.ts
+function debounce(wait, options) {
+	return (_target, key, descriptor) => {
+		if (typeof descriptor.value !== "function") throw new Error(`@debounce can only be used on methods, not on ${typeof descriptor.value}`);
+		const original = descriptor.value;
+		descriptor.value = function(...args) {
+			const debounceKey = `__debounced_${key}`;
+			this[debounceKey] ??= debounce$1((...innerArgs) => original.apply(this, innerArgs), wait, options);
+			return this[debounceKey](...args);
+		};
+		return descriptor;
+	};
 }
+//#endregion
+export { debounce };
+
 //# sourceMappingURL=debounce.js.map

package/dist/utils/decorators/debounce.js.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/utils/decorators/debounce.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,UAAU,QAAQ,CAA8C,IAAY,EAAE,OAA4B;IAC/G,OAAO,CAAC,OAAY,EAAE,GAAW,EAAE,UAAoD,EAAsB,EAAE;QAC9G,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAElC,gFAAgF;QAChF,2CAA2C;QAC3C,UAAU,CAAC,KAAK,GAAG,UAAU,GAAG,IAAW;YAC1C,gCAAgC;YAChC,MAAM,WAAW,GAAG,eAAe,GAAG,EAAE,CAAC;YAEzC,qEAAqE;YACrE,IAAI,CAAC,WAAW,CAAC,KAAK,SAAS,CAC9B,CAAC,GAAG,SAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAkB,EACzE,IAAI,EACJ,OAAO,CACP,CAAC;YAEF,2CAA2C;YAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAkB,CAAC;QACpD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACnB,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"debounce.js","names":["_debounce"],"sources":["../../../../utils/src/decorators/debounce.ts"],"sourcesContent":["import type { DebounceOptions } from '../debounce.js';\nimport { debounce as _debounce } from '../debounce.js';\n\nexport function debounce<F extends (...args: any[]) => ReturnType<F>>(wait: number, options?: DebounceOptions<F>) {\n\treturn (_target: any, key: string, descriptor: PropertyDescriptor & Record<string, any>): PropertyDescriptor => {\n\t\tif (typeof descriptor.value !== 'function') {\n\t\t\tthrow new Error(`@debounce can only be used on methods, not on ${typeof descriptor.value}`);\n\t\t}\n\n\t\tconst original = descriptor.value;\n\n\t\t// Replace the descriptor value with a function that creates a debounced version\n\t\t// of the original method for each instance\n\t\tdescriptor.value = function (...args: any[]) {\n\t\t\t// Instance-specific storage key\n\t\t\tconst debounceKey = `__debounced_${key}`;\n\n\t\t\t// Create the debounced function if it doesn't exist on this instance\n\t\t\tthis[debounceKey] ??= _debounce(\n\t\t\t\t(...innerArgs: any[]) => original.apply(this, innerArgs) as ReturnType<F>,\n\t\t\t\twait,\n\t\t\t\toptions,\n\t\t\t);\n\n\t\t\t// Call the per-instance debounced function\n\t\t\treturn this[debounceKey](...args) as ReturnType<F>;\n\t\t};\n\n\t\treturn descriptor;\n\t};\n}\n"],"mappings":";;AAGA,SAAgB,SAAsD,MAAc,SAA8B;CACjH,QAAQ,SAAc,KAAa,eAA6E;EAC/G,IAAI,OAAO,WAAW,UAAU,YAC/B,MAAM,IAAI,MAAM,iDAAiD,OAAO,WAAW,OAAO;EAG3F,MAAM,WAAW,WAAW;EAI5B,WAAW,QAAQ,SAAU,GAAG,MAAa;GAE5C,MAAM,cAAc,eAAe;GAGnC,KAAK,iBAAiBA,YACpB,GAAG,cAAqB,SAAS,MAAM,MAAM,SAAS,GACvD,MACA,OACD;GAGA,OAAO,KAAK,YAAY,CAAC,GAAG,IAAI;EACjC;EAEA,OAAO;CACR;AACD"}

package/dist/utils/decorators/gate.d.ts

@@ -1,15 +1,17 @@
+//#region ../utils/src/decorators/gate.d.ts
 export interface GateOptions {
-    /** Timeout in milliseconds after which the gate is force-cleared and the promise resolves/rejects */
-    timeout?: number;
-    /** Whether to reject the promise on timeout (default: true) */
-    rejectOnTimeout?: boolean;
-    /** Optional callback invoked on deadlock warnings and timeout aborts */
-    onDeadlock?: (info: {
-        key: string;
-        prop: string;
-        timeout: number;
-        status: 'warning' | 'aborted';
-    }) => void;
+  /** Timeout in milliseconds after which the gate is force-cleared and the promise resolves/rejects */
+  timeout?: number;
+  /** Whether to reject the promise on timeout (default: true) */
+  rejectOnTimeout?: boolean;
+  /** Optional callback invoked on deadlock warnings and timeout aborts */
+  onDeadlock?: (info: {
+    key: string;
+    prop: string;
+    timeout: number;
+    status: 'warning' | 'aborted';
+  }) => void;
 }
 export declare function gate<T extends (...args: any[]) => any>(getGroupingKey?: (...args: Parameters<T>) => string, options?: GateOptions): (_target: any, key: string, descriptor: TypedPropertyDescriptor<T>) => void;
+//#endregion
 //# sourceMappingURL=gate.d.ts.map

package/dist/utils/decorators/gate.js

@@ -1,129 +1,102 @@
-/* oxlint-disable typescript/no-unsafe-return */
-import { CancellationError } from '../cancellation.js';
-import { createDisposable } from '../disposable.js';
-import { Logger } from '../logger.js';
-import { isPromise } from '../promise.js';
-import { resolveProp } from './resolver.js';
-// Warning thresholds in seconds for potential deadlock detection
-const deadlockWarningThresholds = [90, 180]; // 1.5 min, 3 min
-export function gate(getGroupingKey, options) {
-    let { timeout, rejectOnTimeout = true, onDeadlock } = options ?? {};
-    // Use default timeout of 5 minutes if not specified
-    timeout ??= 300000;
-    return (_target, key, descriptor) => {
-        // oxlint-disable-next-line typescript/no-unsafe-function-type
-        let fn;
-        if (typeof descriptor.value === 'function') {
-            fn = descriptor.value;
-        }
-        else if (typeof descriptor.get === 'function') {
-            fn = descriptor.get;
-        }
-        if (fn == null)
-            throw new Error('Not supported');
-        const gateKey = `$gate$${key}`;
-        descriptor.value = function (...args) {
-            const prop = resolveProp(gateKey, getGroupingKey, ...args);
-            if (!Object.hasOwn(this, prop)) {
-                Object.defineProperty(this, prop, {
-                    configurable: false,
-                    enumerable: false,
-                    writable: true,
-                    value: undefined,
-                });
-            }
-            let promise = this[prop];
-            if (promise === undefined) {
-                const originalPromise = fn.apply(this, args);
-                if (originalPromise == null || !isPromise(originalPromise)) {
-                    return originalPromise;
-                }
-                if (timeout > 0) {
-                    // Apply timeout if configured - this prevents indefinite hangs
-                    const timeoutPromise = new Promise((resolve, reject) => {
-                        const timeoutId = setTimeout(() => {
-                            Logger.warn(`[gate] ${key} timeout after ${timeout}ms, forcing gate clear`, `prop=${prop}`);
-                            onDeadlock?.({ key: key, prop: prop, timeout: timeout, status: 'aborted' });
-                            // Clear the gate to allow future calls
-                            this[prop] = undefined;
-                            if (rejectOnTimeout) {
-                                reject(new CancellationError(new Error(`Gate timeout: ${key} exceeded ${timeout}ms`)));
-                            }
-                            else {
-                                // Retry the operation now that the gate is cleared
-                                const retryResult = fn.apply(this, args);
-                                if (isPromise(retryResult)) {
-                                    retryResult.then(resolve, reject);
-                                }
-                                else {
-                                    resolve(retryResult);
-                                }
-                            }
-                        }, timeout);
-                        originalPromise.then((result) => {
-                            clearTimeout(timeoutId);
-                            resolve(result);
-                        }, (error) => {
-                            clearTimeout(timeoutId);
-                            reject(error instanceof Error ? error : new Error(String(error)));
-                        });
-                    });
-                    promise = timeoutPromise;
-                }
-                else {
-                    promise = originalPromise;
-                }
-                this[prop] = promise;
-                const p = promise;
-                void p
-                    .finally(() => {
-                    if (this[prop] === p) {
-                        this[prop] = undefined;
-                    }
-                })
-                    .catch(() => { });
-                // Set up deadlock warning timeouts (only for warnings that would fire before the timeout)
-                const warningsDisposable = scheduleDeadlockWarnings(key, prop, timeout, onDeadlock);
-                void promise.finally(() => warningsDisposable.dispose()).catch(() => { });
-            }
-            return promise;
-        };
-    };
+import { CancellationError } from "../cancellation.js";
+import { Logger as _logger } from "../logger.js";
+import { isPromise } from "../promise.js";
+import { resolveProp } from "./resolver.js";
+import { createDisposable } from "../disposable.js";
+//#region ../utils/src/decorators/gate.ts
+const deadlockWarningThresholds = [90, 180];
+function gate(getGroupingKey, options) {
+	let { timeout, rejectOnTimeout = true, onDeadlock } = options ?? {};
+	timeout ??= 3e5;
+	return (_target, key, descriptor) => {
+		let fn;
+		if (typeof descriptor.value === "function") fn = descriptor.value;
+		else if (typeof descriptor.get === "function") fn = descriptor.get;
+		if (fn == null) throw new Error("Not supported");
+		const gateKey = `$gate$${key}`;
+		descriptor.value = function(...args) {
+			const prop = resolveProp(gateKey, getGroupingKey, ...args);
+			if (!Object.hasOwn(this, prop)) Object.defineProperty(this, prop, {
+				configurable: false,
+				enumerable: false,
+				writable: true,
+				value: void 0
+			});
+			let promise = this[prop];
+			if (promise === void 0) {
+				const originalPromise = fn.apply(this, args);
+				if (originalPromise == null || !isPromise(originalPromise)) return originalPromise;
+				if (timeout > 0) promise = new Promise((resolve, reject) => {
+					const timeoutId = setTimeout(() => {
+						_logger.warn(`[gate] ${key} timeout after ${timeout}ms, forcing gate clear`, `prop=${prop}`);
+						onDeadlock?.({
+							key,
+							prop,
+							timeout,
+							status: "aborted"
+						});
+						this[prop] = void 0;
+						if (rejectOnTimeout) reject(new CancellationError(/* @__PURE__ */ new Error(`Gate timeout: ${key} exceeded ${timeout}ms`)));
+						else {
+							const retryResult = fn.apply(this, args);
+							if (isPromise(retryResult)) retryResult.then(resolve, reject);
+							else resolve(retryResult);
+						}
+					}, timeout);
+					originalPromise.then((result) => {
+						clearTimeout(timeoutId);
+						resolve(result);
+					}, (error) => {
+						clearTimeout(timeoutId);
+						reject(error instanceof Error ? error : new Error(String(error)));
+					});
+				});
+				else promise = originalPromise;
+				this[prop] = promise;
+				const p = promise;
+				p.finally(() => {
+					if (this[prop] === p) this[prop] = void 0;
+				}).catch(() => {});
+				const warningsDisposable = scheduleDeadlockWarnings(key, prop, timeout, onDeadlock);
+				promise.finally(() => warningsDisposable.dispose()).catch(() => {});
+			}
+			return promise;
+		};
+	};
 }
 /**
- * Schedules escalating warning timeouts for potential deadlock detection.
- * Uses chained timers to minimize overhead - only one timer active at a time.
- * Returns a Disposable to cancel any pending timer.
- */
+* Schedules escalating warning timeouts for potential deadlock detection.
+* Uses chained timers to minimize overhead - only one timer active at a time.
+* Returns a Disposable to cancel any pending timer.
+*/
 function scheduleDeadlockWarnings(key, prop, abortTimeoutMs, onDeadlock) {
-    // Filter to only warnings that would fire before the abort timeout
-    const thresholds = abortTimeoutMs != null
-        ? deadlockWarningThresholds.filter(t => t * 1000 < abortTimeoutMs)
-        : deadlockWarningThresholds;
-    if (!thresholds.length)
-        return createDisposable(() => { });
-    let currentTimeout;
-    let thresholdIndex = 0;
-    function scheduleNext(delayMs) {
-        currentTimeout = setTimeout(() => {
-            const thresholdSecs = thresholds[thresholdIndex];
-            Logger.warn(`[gate] ${key} has been pending for ${thresholdSecs}+ seconds (possible deadlock)`, `prop=${prop}`);
-            onDeadlock?.({ key: key, prop: prop, timeout: thresholdSecs * 1000, status: 'warning' });
-            // Schedule next warning if there are more thresholds
-            thresholdIndex++;
-            if (thresholdIndex < thresholds.length) {
-                const nextDelayMs = (thresholds[thresholdIndex] - thresholdSecs) * 1000;
-                scheduleNext(nextDelayMs);
-            }
-        }, delayMs);
-    }
-    // Start with the first threshold
-    scheduleNext(thresholds[0] * 1000);
-    return createDisposable(() => {
-        if (currentTimeout != null) {
-            clearTimeout(currentTimeout);
-            currentTimeout = undefined;
-        }
-    });
+	const thresholds = abortTimeoutMs != null ? deadlockWarningThresholds.filter((t) => t * 1e3 < abortTimeoutMs) : deadlockWarningThresholds;
+	if (!thresholds.length) return createDisposable(() => {});
+	let currentTimeout;
+	let thresholdIndex = 0;
+	function scheduleNext(delayMs) {
+		currentTimeout = setTimeout(() => {
+			const thresholdSecs = thresholds[thresholdIndex];
+			_logger.warn(`[gate] ${key} has been pending for ${thresholdSecs}+ seconds (possible deadlock)`, `prop=${prop}`);
+			onDeadlock?.({
+				key,
+				prop,
+				timeout: thresholdSecs * 1e3,
+				status: "warning"
+			});
+			thresholdIndex++;
+			if (thresholdIndex < thresholds.length) scheduleNext((thresholds[thresholdIndex] - thresholdSecs) * 1e3);
+		}, delayMs);
+	}
+	scheduleNext(thresholds[0] * 1e3);
+	return createDisposable(() => {
+		if (currentTimeout != null) {
+			clearTimeout(currentTimeout);
+			currentTimeout = void 0;
+		}
+	});
 }
+//#endregion
+export { gate };
+
 //# sourceMappingURL=gate.js.map

package/dist/utils/decorators/gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../src/utils/decorators/gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gate.js","names":[],"sources":["../../../../utils/src/decorators/gate.ts"],"sourcesContent":["/* oxlint-disable typescript/no-unsafe-return */\nimport { CancellationError } from '../cancellation.js';\nimport type { UnifiedDisposable } from '../disposable.js';\nimport { createDisposable } from '../disposable.js';\nimport { Logger } from '../logger.js';\nimport { isPromise } from '../promise.js';\nimport { resolveProp } from './resolver.js';\n\nexport interface GateOptions {\n\t/** Timeout in milliseconds after which the gate is force-cleared and the promise resolves/rejects */\n\ttimeout?: number;\n\t/** Whether to reject the promise on timeout (default: true) */\n\trejectOnTimeout?: boolean;\n\t/** Optional callback invoked on deadlock warnings and timeout aborts */\n\tonDeadlock?: (info: { key: string; prop: string; timeout: number; status: 'warning' | 'aborted' }) => void;\n}\n\n// Warning thresholds in seconds for potential deadlock detection\nconst deadlockWarningThresholds = [90, 180]; // 1.5 min, 3 min\n\nexport function gate<T extends (...args: any[]) => any>(\n\tgetGroupingKey?: (...args: Parameters<T>) => string,\n\toptions?: GateOptions,\n): (_target: any, key: string, descriptor: TypedPropertyDescriptor<T>) => void {\n\tlet { timeout, rejectOnTimeout = true, onDeadlock } = options ?? {};\n\n\t// Use default timeout of 5 minutes if not specified\n\ttimeout ??= 300000;\n\n\treturn (_target: any, key: string, descriptor: PropertyDescriptor): void => {\n\t\t// oxlint-disable-next-line typescript/no-unsafe-function-type\n\t\tlet fn: Function | undefined;\n\t\tif (typeof descriptor.value === 'function') {\n\t\t\tfn = descriptor.value;\n\t\t} else if (typeof descriptor.get === 'function') {\n\t\t\tfn = descriptor.get;\n\t\t}\n\t\tif (fn == null) throw new Error('Not supported');\n\n\t\tconst gateKey = `$gate$${key}`;\n\n\t\tdescriptor.value = function (this: any, ...args: any[]) {\n\t\t\tconst prop = resolveProp(gateKey, getGroupingKey, ...(args as Parameters<T>));\n\t\t\tif (!Object.hasOwn(this, prop)) {\n\t\t\t\tObject.defineProperty(this, prop, {\n\t\t\t\t\tconfigurable: false,\n\t\t\t\t\tenumerable: false,\n\t\t\t\t\twritable: true,\n\t\t\t\t\tvalue: undefined,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tlet promise = this[prop];\n\t\t\tif (promise === undefined) {\n\t\t\t\tconst originalPromise = fn.apply(this, args);\n\t\t\t\tif (originalPromise == null || !isPromise(originalPromise)) {\n\t\t\t\t\treturn originalPromise;\n\t\t\t\t}\n\n\t\t\t\tif (timeout > 0) {\n\t\t\t\t\t// Apply timeout if configured - this prevents indefinite hangs\n\t\t\t\t\tconst timeoutPromise = new Promise((resolve, reject) => {\n\t\t\t\t\t\tconst timeoutId = setTimeout(() => {\n\t\t\t\t\t\t\tLogger.warn(`[gate] ${key} timeout after ${timeout}ms, forcing gate clear`, `prop=${prop}`);\n\t\t\t\t\t\t\tonDeadlock?.({ key: key, prop: prop, timeout: timeout, status: 'aborted' });\n\n\t\t\t\t\t\t\t// Clear the gate to allow future calls\n\t\t\t\t\t\t\tthis[prop] = undefined;\n\n\t\t\t\t\t\t\tif (rejectOnTimeout) {\n\t\t\t\t\t\t\t\treject(new CancellationError(new Error(`Gate timeout: ${key} exceeded ${timeout}ms`)));\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t// Retry the operation now that the gate is cleared\n\t\t\t\t\t\t\t\tconst retryResult = fn.apply(this, args);\n\t\t\t\t\t\t\t\tif (isPromise(retryResult)) {\n\t\t\t\t\t\t\t\t\tretryResult.then(resolve, reject);\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\tresolve(retryResult);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}, timeout);\n\n\t\t\t\t\t\toriginalPromise.then(\n\t\t\t\t\t\t\t(result: any) => {\n\t\t\t\t\t\t\t\tclearTimeout(timeoutId);\n\t\t\t\t\t\t\t\tresolve(result);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(error: unknown) => {\n\t\t\t\t\t\t\t\tclearTimeout(timeoutId);\n\t\t\t\t\t\t\t\treject(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t\tpromise = timeoutPromise;\n\t\t\t\t} else {\n\t\t\t\t\tpromise = originalPromise;\n\t\t\t\t}\n\n\t\t\t\tthis[prop] = promise;\n\t\t\t\tconst p = promise;\n\t\t\t\tvoid p\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tif (this[prop] === p) {\n\t\t\t\t\t\t\tthis[prop] = undefined;\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.catch(() => {});\n\n\t\t\t\t// Set up deadlock warning timeouts (only for warnings that would fire before the timeout)\n\t\t\t\tconst warningsDisposable = scheduleDeadlockWarnings(key, prop, timeout, onDeadlock);\n\t\t\t\tvoid promise.finally(() => warningsDisposable.dispose()).catch(() => {});\n\t\t\t}\n\n\t\t\treturn promise;\n\t\t};\n\t};\n}\n\n/**\n * Schedules escalating warning timeouts for potential deadlock detection.\n * Uses chained timers to minimize overhead - only one timer active at a time.\n * Returns a Disposable to cancel any pending timer.\n */\nfunction scheduleDeadlockWarnings(\n\tkey: string,\n\tprop: string,\n\tabortTimeoutMs?: number,\n\tonDeadlock?: GateOptions['onDeadlock'],\n): UnifiedDisposable {\n\t// Filter to only warnings that would fire before the abort timeout\n\tconst thresholds =\n\t\tabortTimeoutMs != null\n\t\t\t? deadlockWarningThresholds.filter(t => t * 1000 < abortTimeoutMs)\n\t\t\t: deadlockWarningThresholds;\n\tif (!thresholds.length) return createDisposable(() => {});\n\n\tlet currentTimeout: ReturnType<typeof setTimeout> | undefined;\n\tlet thresholdIndex = 0;\n\n\tfunction scheduleNext(delayMs: number): void {\n\t\tcurrentTimeout = setTimeout(() => {\n\t\t\tconst thresholdSecs = thresholds[thresholdIndex];\n\t\t\tLogger.warn(\n\t\t\t\t`[gate] ${key} has been pending for ${thresholdSecs}+ seconds (possible deadlock)`,\n\t\t\t\t`prop=${prop}`,\n\t\t\t);\n\t\t\tonDeadlock?.({ key: key, prop: prop, timeout: thresholdSecs * 1000, status: 'warning' });\n\n\t\t\t// Schedule next warning if there are more thresholds\n\t\t\tthresholdIndex++;\n\t\t\tif (thresholdIndex < thresholds.length) {\n\t\t\t\tconst nextDelayMs = (thresholds[thresholdIndex] - thresholdSecs) * 1000;\n\t\t\t\tscheduleNext(nextDelayMs);\n\t\t\t}\n\t\t}, delayMs);\n\t}\n\n\t// Start with the first threshold\n\tscheduleNext(thresholds[0] * 1000);\n\n\treturn createDisposable(() => {\n\t\tif (currentTimeout != null) {\n\t\t\tclearTimeout(currentTimeout);\n\t\t\tcurrentTimeout = undefined;\n\t\t}\n\t});\n}\n"],"mappings":"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"}

package/dist/utils/decorators/log.d.ts

@@ -1,31 +1,32 @@
+//#region ../utils/src/decorators/log.d.ts
 export declare const defaultSlowCallWarningThreshold = 1500;
 export interface LogContext {
-    id: number;
-    instance: any;
-    instanceName: string;
-    name: string;
-    prefix: string;
+  id: number;
+  instance: any;
+  instanceName: string;
+  name: string;
+  prefix: string;
 }
 interface LogOptions<T extends (...args: any[]) => any> {
-    /** Controls parameter formatting in log output. `false` suppresses all params. A function receives the method args and returns named fields to log (or `false` to suppress). When omitted, params are auto-formatted from parameter names. */
-    args?: false | ((...args: Parameters<T>) => Record<string, unknown> | false);
-    /** Conditionally skips logging entirely (scope, timing, everything). Must use a `function` expression (not arrow) — `this` is bound to the class instance via `.apply()`. Annotate `this` with the class type for type safety. */
-    when?(this: unknown, ...args: Parameters<T>): boolean;
-    /** Controls exit/result logging. `true` logs the return value. A function receives the result and returns a custom exit string. */
-    exit?: ((result: PromiseType<ReturnType<T>>) => string) | true;
-    /** Overrides the log line prefix. Receives a {@link LogContext} and the method args. */
-    prefix?(context: LogContext, ...args: Parameters<T>): string;
-    /** Suppresses the entry log line and only logs on exit. `{ after: N }` further suppresses exit unless duration exceeds N ms. */
-    onlyExit?: true | {
-        after: number;
-    };
-    /** Controls duration timing. `false` disables timing. `{ warnAfter: N }` overrides the slow call warning threshold (default 500ms). */
-    timing?: boolean | {
-        warnAfter: number;
-    };
+  /** Controls parameter formatting in log output. `false` suppresses all params. A function receives the method args and returns named fields to log (or `false` to suppress). When omitted, params are auto-formatted from parameter names. */
+  args?: false | ((...args: Parameters<T>) => Record<string, unknown> | false);
+  /** Conditionally skips logging entirely (scope, timing, everything). Must use a `function` expression (not arrow) — `this` is bound to the class instance via `.apply()`. Annotate `this` with the class type for type safety. */
+  when?(this: unknown, ...args: Parameters<T>): boolean;
+  /** Controls exit/result logging. `true` logs the return value. A function receives the result and returns a custom exit string. */
+  exit?: ((result: PromiseType<ReturnType<T>>) => string) | true;
+  /** Overrides the log line prefix. Receives a {@link LogContext} and the method args. */
+  prefix?(context: LogContext, ...args: Parameters<T>): string;
+  /** Suppresses the entry log line and only logs on exit. `{ after: N }` further suppresses exit unless duration exceeds N ms. */
+  onlyExit?: true | {
+    after: number;
+  };
+  /** Controls duration timing. `false` disables timing. `{ warnAfter: N }` overrides the slow call warning threshold (default 500ms). */
+  timing?: boolean | {
+    warnAfter: number;
+  };
 }
 export declare function logName<T>(fn: (c: T, name: string) => string): (target: Function & {
-    prototype: T;
+  prototype: T;
 }) => void;
 /**
  * Class decorator that adds a `toLoggable()` method to the prototype at runtime,
@@ -36,11 +37,11 @@ export declare function logName<T>(fn: (c: T, name: string) => string): (target:
  * Defaults to `id` if the instance has one, otherwise just `ClassName`.
  */
 export declare function loggable<T extends object>(fn?: (instance: T) => string): (target: (abstract new (...args: any[]) => T) | (Function & {
-    prototype: T;
+  prototype: T;
 })) => void;
 export declare function info<T extends (...arg: any[]) => any>(options?: LogOptions<T>): (_target: any, key: string, descriptor: TypedPropertyDescriptor<T>) => void;
 export declare function debug<T extends (...arg: any[]) => any>(options?: LogOptions<T>): (_target: any, key: string, descriptor: TypedPropertyDescriptor<T>) => void;
 export declare function trace<T extends (...arg: any[]) => any>(options?: LogOptions<T>): (_target: any, key: string, descriptor: TypedPropertyDescriptor<T>) => void;
 type PromiseType<T> = T extends Promise<infer U> ? U : T;
-export {};
+//#endregion
 //# sourceMappingURL=log.d.ts.map