@one-paragon/angular-utilities 2.3.3 → 2.3.4

package/fesm2022/one-paragon-angular-utilities.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Input, Directive, inject, Injector, TemplateRef, ViewContainerRef, NgModule, assertInInjectionContext, DestroyRef, signal, computed, isSignal, InjectionToken, Injectable, runInInjectionContext, input, Renderer2, ElementRef, booleanAttribute, Pipe, makeEnvironmentProviders, ChangeDetectionStrategy, Component, HostListener, EventEmitter, untracked, Output, effect, ContentChildren, ChangeDetectorRef, output, viewChild, EnvironmentInjector, createComponent, linkedSignal, contentChild, forwardRef, contentChildren, provideAppInitializer } from '@angular/core';
+import { Input, Directive, inject, Injector, TemplateRef, ViewContainerRef, NgModule, assertInInjectionContext, DestroyRef, signal, computed, isSignal, effect, untracked, InjectionToken, Injectable, runInInjectionContext, input, Renderer2, ElementRef, booleanAttribute, Pipe, makeEnvironmentProviders, ChangeDetectionStrategy, Component, HostListener, EventEmitter, Output, ContentChildren, ChangeDetectorRef, output, viewChild, EnvironmentInjector, createComponent, linkedSignal, contentChild, forwardRef, contentChildren, provideAppInitializer } from '@angular/core';
 import { shareReplay, map, switchAll, filter, tap, catchError, startWith, switchMap, mergeMap, concatMap as concatMap$1, takeUntil, distinctUntilChanged, debounceTime } from 'rxjs/operators';
 import * as i1 from 'rxjs';
 import { isObservable, Subject, of, ReplaySubject, filter as filter$1, first, map as map$1, Observable, combineLatest, Subscription, startWith as startWith$1, pairwise, pipe, concatMap, merge, delay, fromEvent, takeUntil as takeUntil$1, tap as tap$1, switchMap as switchMap$1, scan, timestamp } from 'rxjs';
@@ -594,6 +594,10 @@ class RequestStateStore {
          * @deprecated use the standalone subscriber helper function
          */
         this.on = this.subscriber;
+        /**
+         * @param params An observable or signal that returns an array to be spread into the request function.
+         * If undefined is returned, the request will not be made.
+         */
         this.requestWith = (params) => {
             if (isSignal(params)) {
                 params = toObservable(params, { injector: this.injector }).pipe(notNull());
@@ -601,6 +605,32 @@ class RequestStateStore {
             params.pipe(takeUntil(this.destroy$)).subscribe((p) => this.request(...p));
             return this;
         };
+        /**
+         * @param params The parameters to be passed to the request function.
+         * The parameters can be either actual values or wrapped in a signal.
+         * If any of the parameters are a signal, it will be unwrapped and passed to the request.
+         * It will be tracked and the request will be made whenever its value changes.
+         * If any of the signals return undefined, the request will not be made.
+         */
+        this.requestOn = (...params) => {
+            const paramsArr = computed(() => {
+                const p = params.map(param => isSignal(param)
+                    ? ({ param, isSignal: true })
+                    : ({ param, isSignal: false }));
+                const allVals = p.every(({ param, isSignal }) => !isSignal || param() != undefined);
+                if (allVals)
+                    return p.map(({ param, isSignal }) => isSignal ? param() : param);
+                return undefined;
+            });
+            effect(() => {
+                const vals = paramsArr();
+                untracked(() => {
+                    if (vals)
+                        this.request(...vals);
+                });
+            }, { injector: this.injector });
+            return this;
+        };
         this.assertInjectionContext();
         this.injector.get(DestroyRef).onDestroy(() => this.destroy$.next());
         this.project = project;
@@ -688,6 +718,7 @@ class RequestStateStore {
 class CancellationToken {
 }
 /**
+ * @param sigOrObs An array of signals or observables to be wrapped in an array to be spread into the request function.
  * If any values from the array of signals or observables are null or undefined, all values will be filtered
  */
 function wrapInArr(...sigOrObs) {