@zelgadis87/utils-core 5.4.6 → 5.4.7

package/.rollup/index.d.ts

@@ -1369,7 +1369,15 @@ declare class Semaphore {
     constructor(availableSlots: number);
     private _awaitSlot;
     private _releaseSlot;
+    submit<T>(fn: TAsyncProducer<T> | TProducer<T>, cooldown?: TimeDuration): Promise<T>;
+    /** @deprecated[2026.04.01]: Use {@link submit} instead. */
     execute<T>(fn: TAsyncProducer<T> | TProducer<T>, cooldown?: TimeDuration): Promise<T>;
+    /** Called when a task is added to the queue or immediately starts. Override in subclasses. */
+    protected onTaskAdded(): void;
+    /** Called when a task starts executing (acquires a slot). Override in subclasses. */
+    protected onTaskStarted(): void;
+    /** Called when a task completes and releases its slot. Override in subclasses. */
+    protected onTaskCompleted(): void;
     get availableSlots(): number;
     get queueSize(): number;
     get inProgressSize(): number;

package/.rollup/index.mjs

@@ -151,9 +151,27 @@ class Semaphore {
             this._inProgress -= 1;
         }
     }
-    async execute(fn, cooldown = TimeDuration.ZERO) {
-        return this._awaitSlot().then(fn).finally(() => { void cooldown.delay(() => this._releaseSlot()); });
-    }
+    async submit(fn, cooldown = TimeDuration.ZERO) {
+        this.onTaskAdded();
+        await this._awaitSlot();
+        this.onTaskStarted();
+        const [result, error] = await withTryCatchAsync(async () => fn());
+        this.onTaskCompleted();
+        void cooldown.delay(() => this._releaseSlot());
+        if (error)
+            throw error;
+        return result;
+    }
+    /** @deprecated[2026.04.01]: Use {@link submit} instead. */
+    execute(fn, cooldown = TimeDuration.ZERO) {
+        return this.submit(fn, cooldown);
+    }
+    /** Called when a task is added to the queue or immediately starts. Override in subclasses. */
+    onTaskAdded() { }
+    /** Called when a task starts executing (acquires a slot). Override in subclasses. */
+    onTaskStarted() { }
+    /** Called when a task completes and releases its slot. Override in subclasses. */
+    onTaskCompleted() { }
     get availableSlots() {
         return this._availableSlots;
     }