@furystack/utils 8.1.9 → 8.2.0

package/esm/semaphore.spec.js

@@ -0,0 +1,356 @@
+import { describe, expect, it, vi } from 'vitest';
+import { sleepAsync } from './sleep-async.js';
+import { using } from './using.js';
+import { Semaphore, SemaphoreDisposedError } from './semaphore.js';
+export const semaphoreTests = describe('Semaphore', () => {
+    it('should be constructed with a given concurrency limit', () => {
+        using(new Semaphore(3), (s) => {
+            expect(s).toBeInstanceOf(Semaphore);
+            expect(s.getMaxConcurrent()).toBe(3);
+            expect(s.pendingCount.getValue()).toBe(0);
+            expect(s.runningCount.getValue()).toBe(0);
+            expect(s.completedCount.getValue()).toBe(0);
+            expect(s.failedCount.getValue()).toBe(0);
+        });
+    });
+    it('should execute a single task and return its result', async () => {
+        const s = new Semaphore(2);
+        const result = await s.execute(async () => 42);
+        expect(result).toBe(42);
+        expect(s.completedCount.getValue()).toBe(1);
+        expect(s.runningCount.getValue()).toBe(0);
+        s[Symbol.dispose]();
+    });
+    it('should execute up to N tasks concurrently and queue the rest', async () => {
+        const s = new Semaphore(2);
+        const running = [];
+        const resolvers = [];
+        const createTask = (name) => s.execute(async () => {
+            running.push(name);
+            await new Promise((resolve) => resolvers.push(resolve));
+            return name;
+        });
+        const p1 = createTask('a');
+        const p2 = createTask('b');
+        const p3 = createTask('c');
+        await sleepAsync(10);
+        expect(running).toEqual(['a', 'b']);
+        expect(s.runningCount.getValue()).toBe(2);
+        expect(s.pendingCount.getValue()).toBe(1);
+        resolvers[0]();
+        await p1;
+        await sleepAsync(10);
+        expect(running).toEqual(['a', 'b', 'c']);
+        expect(s.runningCount.getValue()).toBe(2);
+        expect(s.pendingCount.getValue()).toBe(0);
+        resolvers[1]();
+        resolvers[2]();
+        await Promise.all([p2, p3]);
+        expect(s.completedCount.getValue()).toBe(3);
+        expect(s.runningCount.getValue()).toBe(0);
+        s[Symbol.dispose]();
+    });
+    it('should propagate task rejection to the caller and continue processing', async () => {
+        const s = new Semaphore(1);
+        const taskError = new Error('task failed');
+        const p1 = s.execute(async () => {
+            throw taskError;
+        });
+        const p2 = s.execute(async () => 'ok');
+        await expect(p1).rejects.toThrow('task failed');
+        const result = await p2;
+        expect(result).toBe('ok');
+        expect(s.failedCount.getValue()).toBe(1);
+        expect(s.completedCount.getValue()).toBe(1);
+        s[Symbol.dispose]();
+    });
+    describe('ObservableValue counters', () => {
+        it('should update pendingCount and runningCount on transitions', async () => {
+            const s = new Semaphore(1);
+            const pendingChanges = [];
+            const runningChanges = [];
+            s.pendingCount.subscribe((v) => {
+                pendingChanges.push(v);
+            });
+            s.runningCount.subscribe((v) => {
+                runningChanges.push(v);
+            });
+            let resolve;
+            const p1 = s.execute(async () => {
+                await new Promise((r) => (resolve = r));
+            });
+            const p2 = s.execute(async () => 'done');
+            await sleepAsync(10);
+            expect(pendingChanges).toContain(1);
+            expect(runningChanges).toContain(1);
+            resolve();
+            await p1;
+            await sleepAsync(10);
+            await p2;
+            expect(s.pendingCount.getValue()).toBe(0);
+            expect(s.runningCount.getValue()).toBe(0);
+            expect(s.completedCount.getValue()).toBe(2);
+            s[Symbol.dispose]();
+        });
+        it('should update completedCount and failedCount correctly', async () => {
+            const s = new Semaphore(2);
+            await s.execute(async () => 'ok');
+            await s
+                .execute(async () => {
+                throw new Error('fail');
+            })
+                .catch(() => { });
+            expect(s.completedCount.getValue()).toBe(1);
+            expect(s.failedCount.getValue()).toBe(1);
+            s[Symbol.dispose]();
+        });
+    });
+    describe('AbortSignal support', () => {
+        it('should abort a pending task when the caller signal aborts', async () => {
+            const s = new Semaphore(1);
+            let resolve;
+            const p1 = s.execute(async () => {
+                await new Promise((r) => (resolve = r));
+            });
+            const controller = new AbortController();
+            const p2 = s.execute(async () => 'should not run', { signal: controller.signal });
+            await sleepAsync(10);
+            expect(s.pendingCount.getValue()).toBe(1);
+            controller.abort(new Error('cancelled'));
+            await expect(p2).rejects.toThrow('cancelled');
+            expect(s.pendingCount.getValue()).toBe(0);
+            resolve();
+            await p1;
+            s[Symbol.dispose]();
+        });
+        it('should reject immediately if the caller signal is already aborted', async () => {
+            const s = new Semaphore(1);
+            const controller = new AbortController();
+            controller.abort(new Error('pre-aborted'));
+            await expect(s.execute(async () => 'should not run', { signal: controller.signal })).rejects.toThrow('pre-aborted');
+            expect(s.pendingCount.getValue()).toBe(0);
+            expect(s.runningCount.getValue()).toBe(0);
+            s[Symbol.dispose]();
+        });
+        it('should clean up the caller signal listener when the task completes normally', async () => {
+            const s = new Semaphore(1);
+            const controller = new AbortController();
+            const removeSpy = vi.spyOn(controller.signal, 'removeEventListener');
+            await s.execute(async () => 'done', { signal: controller.signal });
+            expect(removeSpy).toHaveBeenCalledWith('abort', expect.any(Function));
+            removeSpy.mockRestore();
+            s[Symbol.dispose]();
+        });
+        it('should abort the signal passed to a running task when the caller signal aborts', async () => {
+            const s = new Semaphore(1);
+            const signalAborted = vi.fn();
+            const controller = new AbortController();
+            const p = s.execute(async ({ signal }) => {
+                signal.addEventListener('abort', signalAborted);
+                await new Promise((resolve) => {
+                    signal.addEventListener('abort', () => resolve());
+                });
+                throw signal.reason;
+            }, { signal: controller.signal });
+            await sleepAsync(10);
+            expect(s.runningCount.getValue()).toBe(1);
+            controller.abort(new Error('stop'));
+            await expect(p).rejects.toThrow('stop');
+            expect(signalAborted).toBeCalledTimes(1);
+            s[Symbol.dispose]();
+        });
+    });
+    describe('EventHub events', () => {
+        it('should emit taskStarted when a task begins running', async () => {
+            const s = new Semaphore(1);
+            const listener = vi.fn();
+            s.subscribe('taskStarted', listener);
+            await s.execute(async () => 'done');
+            expect(listener).toBeCalledTimes(1);
+            s[Symbol.dispose]();
+        });
+        it('should emit taskCompleted when a task resolves', async () => {
+            const s = new Semaphore(1);
+            const listener = vi.fn();
+            s.subscribe('taskCompleted', listener);
+            await s.execute(async () => 'done');
+            expect(listener).toBeCalledTimes(1);
+            s[Symbol.dispose]();
+        });
+        it('should emit taskFailed with the error when a task rejects', async () => {
+            const s = new Semaphore(1);
+            const listener = vi.fn();
+            s.subscribe('taskFailed', listener);
+            const taskError = new Error('boom');
+            await s
+                .execute(async () => {
+                throw taskError;
+            })
+                .catch(() => { });
+            expect(listener).toBeCalledTimes(1);
+            expect(listener).toBeCalledWith({ error: taskError });
+            s[Symbol.dispose]();
+        });
+        it('should emit events in correct order for queued tasks', async () => {
+            const s = new Semaphore(1);
+            const events = [];
+            s.subscribe('taskStarted', () => {
+                events.push('started');
+            });
+            s.subscribe('taskCompleted', () => {
+                events.push('completed');
+            });
+            await Promise.all([s.execute(async () => 'a'), s.execute(async () => 'b')]);
+            await sleepAsync(10);
+            expect(events).toEqual(['started', 'completed', 'started', 'completed']);
+            s[Symbol.dispose]();
+        });
+    });
+    describe('setMaxConcurrent', () => {
+        it('should return the updated value from getMaxConcurrent', () => {
+            const s = new Semaphore(2);
+            s.setMaxConcurrent(5);
+            expect(s.getMaxConcurrent()).toBe(5);
+            s[Symbol.dispose]();
+        });
+        it('should throw when given a non-positive integer', () => {
+            const s = new Semaphore(2);
+            expect(() => s.setMaxConcurrent(0)).toThrow('maxConcurrent must be a positive integer');
+            expect(() => s.setMaxConcurrent(-1)).toThrow('maxConcurrent must be a positive integer');
+            expect(() => s.setMaxConcurrent(1.5)).toThrow('maxConcurrent must be a positive integer');
+            s[Symbol.dispose]();
+        });
+        it('should immediately start queued tasks when increased', async () => {
+            const s = new Semaphore(1);
+            const running = [];
+            const resolvers = [];
+            const createTask = (name) => s.execute(async () => {
+                running.push(name);
+                await new Promise((resolve) => resolvers.push(resolve));
+                return name;
+            });
+            const p1 = createTask('a');
+            const p2 = createTask('b');
+            const p3 = createTask('c');
+            await sleepAsync(10);
+            expect(running).toEqual(['a']);
+            expect(s.runningCount.getValue()).toBe(1);
+            expect(s.pendingCount.getValue()).toBe(2);
+            s.setMaxConcurrent(3);
+            await sleepAsync(10);
+            expect(running).toEqual(['a', 'b', 'c']);
+            expect(s.runningCount.getValue()).toBe(3);
+            expect(s.pendingCount.getValue()).toBe(0);
+            resolvers.forEach((r) => r());
+            await Promise.all([p1, p2, p3]);
+            s[Symbol.dispose]();
+        });
+        it('should not abort running tasks when decreased', async () => {
+            const s = new Semaphore(3);
+            const resolvers = [];
+            const createTask = () => s.execute(async () => {
+                await new Promise((resolve) => resolvers.push(resolve));
+            });
+            const p1 = createTask();
+            const p2 = createTask();
+            const p3 = createTask();
+            await sleepAsync(10);
+            expect(s.runningCount.getValue()).toBe(3);
+            s.setMaxConcurrent(1);
+            expect(s.runningCount.getValue()).toBe(3);
+            resolvers.forEach((r) => r());
+            await Promise.all([p1, p2, p3]);
+            expect(s.completedCount.getValue()).toBe(3);
+            s[Symbol.dispose]();
+        });
+        it('should not start new tasks until running count drops below new lower limit', async () => {
+            const s = new Semaphore(2);
+            const running = [];
+            const resolvers = [];
+            const createTask = (name) => s.execute(async () => {
+                running.push(name);
+                await new Promise((resolve) => resolvers.push(resolve));
+                return name;
+            });
+            const p1 = createTask('a');
+            const p2 = createTask('b');
+            const p3 = createTask('c');
+            await sleepAsync(10);
+            expect(running).toEqual(['a', 'b']);
+            expect(s.pendingCount.getValue()).toBe(1);
+            s.setMaxConcurrent(1);
+            resolvers[0]();
+            await p1;
+            await sleepAsync(10);
+            expect(running).toEqual(['a', 'b']);
+            expect(s.pendingCount.getValue()).toBe(1);
+            resolvers[1]();
+            await p2;
+            await sleepAsync(10);
+            expect(running).toEqual(['a', 'b', 'c']);
+            expect(s.pendingCount.getValue()).toBe(0);
+            resolvers[2]();
+            await p3;
+            s[Symbol.dispose]();
+        });
+    });
+    describe('Disposal', () => {
+        it('should reject all pending tasks with SemaphoreDisposedError', async () => {
+            const s = new Semaphore(1);
+            let resolve;
+            const p1 = s.execute(async () => {
+                await new Promise((r) => (resolve = r));
+            });
+            const p2 = s.execute(async () => 'pending1');
+            const p3 = s.execute(async () => 'pending2');
+            await sleepAsync(10);
+            expect(s.pendingCount.getValue()).toBe(2);
+            s[Symbol.dispose]();
+            await expect(p2).rejects.toThrow('Semaphore already disposed');
+            await expect(p3).rejects.toThrow('Semaphore already disposed');
+            await expect(p2).rejects.toBeInstanceOf(SemaphoreDisposedError);
+            await expect(p3).rejects.toBeInstanceOf(SemaphoreDisposedError);
+            resolve();
+            await p1;
+        });
+        it('should abort signals of running tasks on disposal', async () => {
+            const s = new Semaphore(1);
+            const signalAborted = vi.fn();
+            const p = s.execute(async ({ signal }) => {
+                signal.addEventListener('abort', signalAborted);
+                await new Promise((resolve) => {
+                    signal.addEventListener('abort', () => resolve());
+                });
+                throw signal.reason;
+            });
+            await sleepAsync(10);
+            expect(s.runningCount.getValue()).toBe(1);
+            s[Symbol.dispose]();
+            await expect(p).rejects.toBeInstanceOf(SemaphoreDisposedError);
+            expect(signalAborted).toBeCalledTimes(1);
+        });
+        it('should throw SemaphoreDisposedError when calling execute() after disposal', () => {
+            const s = new Semaphore(1);
+            s[Symbol.dispose]();
+            expect(() => s.execute(async () => 'too late')).toThrow('Semaphore already disposed');
+            expect(() => s.execute(async () => 'too late')).toThrow(SemaphoreDisposedError);
+        });
+        it('should dispose all ObservableValues', () => {
+            const s = new Semaphore(1);
+            s[Symbol.dispose]();
+            expect(s.pendingCount.isDisposed).toBe(true);
+            expect(s.runningCount.isDisposed).toBe(true);
+            expect(s.completedCount.isDisposed).toBe(true);
+            expect(s.failedCount.isDisposed).toBe(true);
+        });
+        it('should clear event listeners via super', () => {
+            const s = new Semaphore(1);
+            const listener = vi.fn();
+            s.subscribe('taskStarted', listener);
+            s[Symbol.dispose]();
+            s.emit('taskStarted', undefined);
+            expect(listener).not.toBeCalled();
+        });
+    });
+});
+//# sourceMappingURL=semaphore.spec.js.map

package/esm/semaphore.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.spec.js","sourceRoot":"","sources":["../src/semaphore.spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/utils",
-  "version": "8.1.9",
+  "version": "8.2.0",
   "description": "Utility functions and helpers for FuryStack including observables, events, and disposables",
   "type": "module",
   "scripts": {
@@ -39,7 +39,7 @@
   "homepage": "https://github.com/furystack/furystack",
   "devDependencies": {
     "typescript": "^5.9.3",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=22.0.0"

package/src/event-hub.spec.ts

@@ -1,5 +1,7 @@
 import { describe, expect, it, vi } from 'vitest'
+import type { ListenerErrorPayload } from './event-hub.js'
 import { EventHub } from './event-hub.js'
+import { sleepAsync } from './sleep-async.js'
 
 describe('EventHub', () => {
   it('Should fail on type errors', () => {
@@ -97,4 +99,155 @@ describe('EventHub', () => {
     hub.emit('test', 'test')
     expect(listener).not.toBeCalled()
   })
+
+  describe('Error resilience', () => {
+    it('should catch sync throws from listeners and still notify other listeners', () => {
+      const hub = new EventHub<{ test: number }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      const throwingListener = () => {
+        throw new Error('listener error')
+      }
+      const goodListener = vi.fn()
+
+      hub.addListener('test', throwingListener)
+      hub.addListener('test', goodListener)
+
+      hub.emit('test', 42)
+
+      expect(goodListener).toBeCalledWith(42)
+      expect(goodListener).toBeCalledTimes(1)
+      expect(consoleErrorSpy).toHaveBeenCalled()
+
+      consoleErrorSpy.mockRestore()
+    })
+
+    it('should catch async rejections from listeners', async () => {
+      const hub = new EventHub<{ test: number }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      const rejectingListener = async () => {
+        throw new Error('async listener error')
+      }
+
+      hub.addListener('test', rejectingListener)
+      hub.emit('test', 42)
+
+      await sleepAsync(10)
+
+      expect(consoleErrorSpy).toHaveBeenCalledWith('Unhandled EventHub listener error', {
+        event: 'test',
+        error: expect.any(Error) as Error,
+      })
+
+      consoleErrorSpy.mockRestore()
+    })
+
+    it('should route sync errors to onListenerError listeners when registered', () => {
+      const hub = new EventHub<{ test: number; onListenerError: ListenerErrorPayload }>()
+      const errorHandler = vi.fn()
+
+      hub.addListener('onListenerError', errorHandler)
+      hub.addListener('test', () => {
+        throw new Error('boom')
+      })
+
+      hub.emit('test', 1)
+
+      expect(errorHandler).toBeCalledTimes(1)
+      expect(errorHandler).toBeCalledWith({
+        event: 'test',
+        error: expect.any(Error) as Error,
+      })
+    })
+
+    it('should route async rejections to onListenerError listeners when registered', async () => {
+      const hub = new EventHub<{ test: number; onListenerError: ListenerErrorPayload }>()
+      const errorHandler = vi.fn()
+
+      hub.addListener('onListenerError', errorHandler)
+      hub.addListener('test', async () => {
+        throw new Error('async boom')
+      })
+
+      hub.emit('test', 1)
+      await sleepAsync(10)
+
+      expect(errorHandler).toBeCalledTimes(1)
+      expect(errorHandler).toBeCalledWith({
+        event: 'test',
+        error: expect.any(Error) as Error,
+      })
+    })
+
+    it('should fall back to console.error if onListenerError handler returns a rejected promise', async () => {
+      const hub = new EventHub<{ test: number; onListenerError: ListenerErrorPayload }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      hub.addListener('onListenerError', async () => {
+        throw new Error('async error handler fails')
+      })
+      hub.addListener('test', () => {
+        throw new Error('original error')
+      })
+
+      hub.emit('test', 1)
+      await sleepAsync(10)
+
+      expect(consoleErrorSpy).toHaveBeenCalledWith('Error in onListenerError handler', expect.any(Error))
+
+      consoleErrorSpy.mockRestore()
+    })
+
+    it('should fall back to console.error if onListenerError handler itself throws', () => {
+      const hub = new EventHub<{ test: number; onListenerError: ListenerErrorPayload }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      hub.addListener('onListenerError', () => {
+        throw new Error('error handler also fails')
+      })
+      hub.addListener('test', () => {
+        throw new Error('original error')
+      })
+
+      hub.emit('test', 1)
+
+      expect(consoleErrorSpy).toHaveBeenCalledWith('Error in onListenerError handler', expect.any(Error))
+
+      consoleErrorSpy.mockRestore()
+    })
+
+    it('should go straight to console.error when onListenerError event itself has a failing listener', () => {
+      const hub = new EventHub<{ onListenerError: ListenerErrorPayload }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      hub.addListener('onListenerError', () => {
+        throw new Error('meta error')
+      })
+
+      hub.emit('onListenerError', { event: 'test', error: new Error('original') })
+
+      expect(consoleErrorSpy).toHaveBeenCalledWith('Error in onListenerError handler', expect.any(Error))
+
+      consoleErrorSpy.mockRestore()
+    })
+
+    it('should fall back to console.error when no onListenerError listeners are registered', () => {
+      const hub = new EventHub<{ test: number }>()
+      const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+      hub.addListener('test', () => {
+        throw new Error('no handler')
+      })
+
+      hub.emit('test', 1)
+
+      expect(consoleErrorSpy).toHaveBeenCalledWith('Unhandled EventHub listener error', {
+        event: 'test',
+        error: expect.any(Error) as Error,
+      })
+
+      consoleErrorSpy.mockRestore()
+    })
+  })
 })

package/src/event-hub.ts

@@ -2,10 +2,25 @@ type ListenerFunction<EventTypeMap extends object, T extends keyof EventTypeMap>
   arg: EventTypeMap[T],
 ) => void | PromiseLike<void>
 
+/**
+ * Payload emitted when a listener throws or rejects during {@link EventHub.emit}.
+ * Subscribe to the `onListenerError` event to receive these.
+ */
+export type ListenerErrorPayload = {
+  /** The event name that was being emitted when the error occurred */
+  event: string | number | symbol
+  /** The error thrown or rejected by the listener */
+  error: unknown
+}
+
 /**
  * A typed event emitter that provides type-safe event subscription and emission.
  * Use this to create strongly-typed pub/sub patterns in your application.
  *
+ * Listener errors (sync throws and async rejections) are caught automatically.
+ * If `onListenerError` listeners are registered, errors are routed there.
+ * Otherwise, they are logged via `console.error`.
+ *
  * @typeParam EventTypeMap - An object type where keys are event names and values are event payload types
  * @example
  * ```ts
@@ -13,6 +28,7 @@ type ListenerFunction<EventTypeMap extends object, T extends keyof EventTypeMap>
  *   userLoggedIn: { userId: string }
  *   userLoggedOut: { userId: string }
  *   dataUpdated: { items: string[] }
+ *   onListenerError: ListenerErrorPayload
  * }
  *
  * const hub = new EventHub<MyEvents>()
@@ -22,6 +38,11 @@ type ListenerFunction<EventTypeMap extends object, T extends keyof EventTypeMap>
  *   console.log('User logged in:', event.userId)
  * })
  *
+ * // Handle listener errors
+ * hub.subscribe('onListenerError', ({ event, error }) => {
+ *   console.error(`Listener for "${String(event)}" failed:`, error)
+ * })
+ *
  * // Emit events
  * hub.emit('userLoggedIn', { userId: '123' })
  *
@@ -59,9 +80,44 @@ export class EventHub<EventTypeMap extends object> implements Disposable {
     return { [Symbol.dispose]: () => this.removeListener(event, listener) }
   }
 
+  private handleListenerError(event: keyof EventTypeMap, error: unknown) {
+    if (event === 'onListenerError') {
+      console.error('Error in onListenerError handler', error)
+      return
+    }
+    const errorListeners = this.listeners.get('onListenerError' as keyof EventTypeMap)
+    if (errorListeners?.size) {
+      for (const errorListener of errorListeners) {
+        try {
+          const result = errorListener({ event, error } as EventTypeMap[keyof EventTypeMap])
+          if (result && typeof result.then === 'function') {
+            result.then(undefined, (err: unknown) => {
+              console.error('Error in onListenerError handler', err)
+            })
+          }
+        } catch (err) {
+          console.error('Error in onListenerError handler', err)
+        }
+      }
+    } else {
+      console.error('Unhandled EventHub listener error', { event, error })
+    }
+  }
+
   public emit<TEvent extends keyof EventTypeMap>(event: TEvent, arg: EventTypeMap[TEvent]) {
     if (this.listeners.has(event)) {
-      this.listeners.get(event)!.forEach((listener) => void listener(arg))
+      this.listeners.get(event)!.forEach((listener) => {
+        try {
+          const result = listener(arg)
+          if (result && typeof result.then === 'function') {
+            result.then(undefined, (error: unknown) => {
+              this.handleListenerError(event, error)
+            })
+          }
+        } catch (error) {
+          this.handleListenerError(event, error)
+        }
+      })
     }
   }
 

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './is-async-disposable.js'
 export * from './is-disposable.js'
 export * from './observable-value.js'
 export * from './path-helper.js'
+export * from './semaphore.js'
 export * from './sleep-async.js'
 export * from './sort-by.js'
 export * from './tuple.js'