@vrtmrz/livesync-commonlib 0.2.0 → 0.2.2

package/dist/services/lib/HandlerUtils.js

@@ -326,6 +326,30 @@ class FirstResultHandler extends MultiBinder {
     return false;
   }
 }
+class FirstHandledHandler extends MultiBinder {
+  /**
+   * Whether at least one callback is currently registered.
+   */
+  get hasHandlers() {
+    return this._callbackMap.size > 0;
+  }
+  /**
+   * Invokes handlers until one returns a completed or veto outcome.
+   * @param args The arguments to pass to the handlers.
+   * @returns The first handled outcome, or a not-applicable outcome when no handler applies.
+   * @throws Any synchronous callback error or rejected callback value, unchanged.
+   */
+  async invoke(...args) {
+    const callbacks = [...this._callbacks];
+    for (const callback of callbacks) {
+      const outcome = await Promise.resolve(callback(...args));
+      if (outcome.kind !== "not-applicable") {
+        return outcome;
+      }
+    }
+    return { kind: "not-applicable" };
+  }
+}
 function getMultipleBound(handler) {
   const _handler = "invoke" in handler ? handler.invoke : handler.dispatch;
   const __handler = _handler.bind(handler);
@@ -367,6 +391,17 @@ function firstResultFunction(name) {
   const handler = new FirstResultHandler(name ?? "firstResultFunction");
   return getMultipleBound(handler);
 }
+function firstHandledFunction(name) {
+  const handler = new FirstHandledHandler(
+    name ?? "firstHandledFunction"
+  );
+  const toHandlerCallback = (callback) => callback;
+  const bound = (...args) => handler.invoke(...args);
+  bound.addHandler = (callback, priority) => handler.addHandler(toHandlerCallback(callback), priority);
+  bound.removeHandler = (callback) => handler.removeHandler(toHandlerCallback(callback));
+  Object.defineProperty(bound, "hasHandlers", { get: () => handler.hasHandlers });
+  return bound;
+}
 function dispatchParallelFunction(name) {
   const handler = new DispatchParallel(
     name ?? "dispatchParallelFunction"
@@ -452,6 +487,15 @@ function handlers() {
     firstResult(name) {
       return firstResultFunction(String(name));
     },
+    /**
+     * Create a handler that invokes registered handlers until one completes or vetoes.
+     * Callback errors and rejections propagate unchanged.
+     * @param name The name of the callback on `T`.
+     * @returns A bound handler with a live `hasHandlers` property.
+     */
+    firstHandled(name) {
+      return firstHandledFunction(String(name));
+    },
     /**
      * Create a handler that invokes all added handler functions in parallel.
      * @param name
@@ -481,6 +525,7 @@ export {
   BooleanHandlerBase,
   Dispatch,
   DispatchParallel,
+  FirstHandledHandler,
   FirstResultHandler,
   LazyBinder,
   MultiBinder,
@@ -494,6 +539,7 @@ export {
   bailFirstFailureWithResultFunction,
   bindableFunction,
   dispatchParallelFunction,
+  firstHandledFunction,
   firstResultFunction,
   handlers,
   lazyBindableFunction