@dereekb/rxjs 12.4.4 → 12.5.0

package/index.cjs.js

@@ -1979,6 +1979,92 @@ function filterIfObjectValuesUnchanged(input) {
   }
 }
 
+var classof = classofRaw$2;
+
+// `IsArray` abstract operation
+// https://tc39.es/ecma262/#sec-isarray
+// eslint-disable-next-line es/no-array-isarray -- safe
+var isArray$1 = Array.isArray || function isArray(argument) {
+  return classof(argument) === 'Array';
+};
+
+var DESCRIPTORS = descriptors;
+var isArray = isArray$1;
+
+var $TypeError$1 = TypeError;
+// eslint-disable-next-line es/no-object-getownpropertydescriptor -- safe
+var getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+
+// Safari < 13 does not throw an error in this case
+var SILENT_ON_NON_WRITABLE_LENGTH_SET = DESCRIPTORS && !function () {
+  // makes no sense without proper strict mode support
+  if (this !== undefined) return true;
+  try {
+    // eslint-disable-next-line es/no-object-defineproperty -- safe
+    Object.defineProperty([], 'length', { writable: false }).length = 1;
+  } catch (error) {
+    return error instanceof TypeError;
+  }
+}();
+
+var arraySetLength = SILENT_ON_NON_WRITABLE_LENGTH_SET ? function (O, length) {
+  if (isArray(O) && !getOwnPropertyDescriptor(O, 'length').writable) {
+    throw new $TypeError$1('Cannot set read only .length');
+  } return O.length = length;
+} : function (O, length) {
+  return O.length = length;
+};
+
+var $TypeError = TypeError;
+var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
+
+var doesNotExceedSafeInteger$1 = function (it) {
+  if (it > MAX_SAFE_INTEGER) throw $TypeError('Maximum allowed index exceeded');
+  return it;
+};
+
+var $ = _export;
+var toObject = toObject$3;
+var lengthOfArrayLike = lengthOfArrayLike$3;
+var setArrayLength = arraySetLength;
+var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
+var fails = fails$c;
+
+var INCORRECT_TO_LENGTH = fails(function () {
+  return [].push.call({ length: 0x100000000 }, 1) !== 4294967297;
+});
+
+// V8 <= 121 and Safari <= 15.4; FF < 23 throws InternalError
+// https://bugs.chromium.org/p/v8/issues/detail?id=12681
+var properErrorOnNonWritableLength = function () {
+  try {
+    // eslint-disable-next-line es/no-object-defineproperty -- safe
+    Object.defineProperty([], 'length', { writable: false }).push();
+  } catch (error) {
+    return error instanceof TypeError;
+  }
+};
+
+var FORCED = INCORRECT_TO_LENGTH || !properErrorOnNonWritableLength();
+
+// `Array.prototype.push` method
+// https://tc39.es/ecma262/#sec-array.prototype.push
+$({ target: 'Array', proto: true, arity: 1, forced: FORCED }, {
+  // eslint-disable-next-line no-unused-vars -- required for `.length`
+  push: function push(item) {
+    var O = toObject(this);
+    var len = lengthOfArrayLike(O);
+    var argCount = arguments.length;
+    doesNotExceedSafeInteger(len + argCount);
+    for (var i = 0; i < argCount; i++) {
+      O[len] = arguments[i];
+      len++;
+    }
+    setArrayLength(O, len);
+    return len;
+  }
+});
+
 /**
  * Destroyable object that wraps an Unsubscribable.
  */
@@ -2031,6 +2117,15 @@ class MultiSubscriptionObject {
     this.unsub();
     this._subscriptions = util.convertToArray(subs);
   }
+  addSubs(subs) {
+    const nextSubscriptions = [...(this._subscriptions ?? [])];
+    util.convertToArray(subs).forEach(sub => {
+      if (!nextSubscriptions.includes(sub)) {
+        nextSubscriptions.push(sub);
+      }
+    });
+    this._subscriptions = nextSubscriptions;
+  }
   unsub() {
     if (this._subscriptions) {
       this._subscriptions.forEach(x => x.unsubscribe());
@@ -2349,92 +2444,6 @@ function iteratorNextPageUntilPage(iteration, page) {
   });
 }
 
-var classof = classofRaw$2;
-
-// `IsArray` abstract operation
-// https://tc39.es/ecma262/#sec-isarray
-// eslint-disable-next-line es/no-array-isarray -- safe
-var isArray$1 = Array.isArray || function isArray(argument) {
-  return classof(argument) === 'Array';
-};
-
-var DESCRIPTORS = descriptors;
-var isArray = isArray$1;
-
-var $TypeError$1 = TypeError;
-// eslint-disable-next-line es/no-object-getownpropertydescriptor -- safe
-var getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
-
-// Safari < 13 does not throw an error in this case
-var SILENT_ON_NON_WRITABLE_LENGTH_SET = DESCRIPTORS && !function () {
-  // makes no sense without proper strict mode support
-  if (this !== undefined) return true;
-  try {
-    // eslint-disable-next-line es/no-object-defineproperty -- safe
-    Object.defineProperty([], 'length', { writable: false }).length = 1;
-  } catch (error) {
-    return error instanceof TypeError;
-  }
-}();
-
-var arraySetLength = SILENT_ON_NON_WRITABLE_LENGTH_SET ? function (O, length) {
-  if (isArray(O) && !getOwnPropertyDescriptor(O, 'length').writable) {
-    throw new $TypeError$1('Cannot set read only .length');
-  } return O.length = length;
-} : function (O, length) {
-  return O.length = length;
-};
-
-var $TypeError = TypeError;
-var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
-
-var doesNotExceedSafeInteger$1 = function (it) {
-  if (it > MAX_SAFE_INTEGER) throw $TypeError('Maximum allowed index exceeded');
-  return it;
-};
-
-var $ = _export;
-var toObject = toObject$3;
-var lengthOfArrayLike = lengthOfArrayLike$3;
-var setArrayLength = arraySetLength;
-var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
-var fails = fails$c;
-
-var INCORRECT_TO_LENGTH = fails(function () {
-  return [].push.call({ length: 0x100000000 }, 1) !== 4294967297;
-});
-
-// V8 <= 121 and Safari <= 15.4; FF < 23 throws InternalError
-// https://bugs.chromium.org/p/v8/issues/detail?id=12681
-var properErrorOnNonWritableLength = function () {
-  try {
-    // eslint-disable-next-line es/no-object-defineproperty -- safe
-    Object.defineProperty([], 'length', { writable: false }).push();
-  } catch (error) {
-    return error instanceof TypeError;
-  }
-};
-
-var FORCED = INCORRECT_TO_LENGTH || !properErrorOnNonWritableLength();
-
-// `Array.prototype.push` method
-// https://tc39.es/ecma262/#sec-array.prototype.push
-$({ target: 'Array', proto: true, arity: 1, forced: FORCED }, {
-  // eslint-disable-next-line no-unused-vars -- required for `.length`
-  push: function push(item) {
-    var O = toObject(this);
-    var len = lengthOfArrayLike(O);
-    var argCount = arguments.length;
-    doesNotExceedSafeInteger(len + argCount);
-    for (var i = 0; i < argCount; i++) {
-      O[len] = arguments[i];
-      len++;
-    }
-    setArrayLength(O, len);
-    return len;
-  }
-});
-
 function distinctUntilArrayLengthChanges(inputGetArray) {
   const getArray = inputGetArray ?? (value => util.asArray(value));
   return rxjs.distinctUntilChanged((a, b) => a === b, x => getArray(x).length);
@@ -3125,6 +3134,16 @@ function switchMapMaybeLoadingContextStream() {
   return rxjs.switchMap(x => x != null ? x.stream$ : rxjs.of(undefined));
 }
 
+/**
+ * Returns true if the two LoadingStates are considered equal, by comparing the loading, loadingProgress, error, and value properties.
+ *
+ * @param a LoadingState a
+ * @param b LoadingState b
+ * @returns Returns true if the input LoadingStates are considered equal.
+ */
+function isLoadingStateEqual(a, b) {
+  return a.loading === b.loading && a.loadingProgress === b.loadingProgress && a.error === b.error && a.value === b.value;
+}
 /**
  * Returns true if the input LoadingErrorPair has the same loading (truthy vs falsy) and error values as the other LoadingErrorPair.
  *
@@ -3133,7 +3152,7 @@ function switchMapMaybeLoadingContextStream() {
  * @returns Returns true if the input's metadata is considered equivalent.
  */
 function isLoadingStateMetadataEqual(a, b) {
-  return a.loading == b.loading && util.valuesAreBothNullishOrEquivalent(a.error, b.error);
+  return a.loading == b.loading && util.valuesAreBothNullishOrEquivalent(a.loadingProgress, b.loadingProgress) && util.valuesAreBothNullishOrEquivalent(a.error, b.error);
 }
 // MARK: Utility
 /**
@@ -3377,6 +3396,7 @@ function mergeLoadingStates(...args) {
     const currentLoadings = loadingStates.map(x => x?.error ? x.loading : false);
     const nonMaybeLoadings = currentLoadings.filter(x => x != null);
     const loading = nonMaybeLoadings.length > 0 ? util.reduceBooleansWithOr(nonMaybeLoadings) : undefined;
+    // TODO: Merge loadingProgress values, probably only if they're all defined though, otherwise undefined
     result = {
       // Evaluate both for the loading state.
       loading,
@@ -3583,7 +3603,7 @@ function combineLoadingStates(...args) {
   );
 }
 /**
- * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes.
+ * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes, or the loading state progress.
  *
  * @param sources
  * @returns
@@ -3603,7 +3623,7 @@ function combineLoadingStatesStatus(sources) {
       }
     }
     return result;
-  }), rxjs.distinctUntilChanged((x, y) => loadingStateType(x) === loadingStateType(y)), rxjs.shareReplay(1));
+  }), rxjs.distinctUntilChanged((x, y) => loadingStateType(x) === loadingStateType(y) && x.loadingProgress === y.loadingProgress), rxjs.shareReplay(1));
 }
 function startWithBeginLoading(state) {
   return rxjs.startWith(beginLoading(state));
@@ -3789,7 +3809,8 @@ const DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION = (state, input) => {
   } = input;
   const {
     error,
-    value
+    value,
+    loadingProgress
   } = state;
   let loading = false;
   if (!util.hasNonNullValue(error)) {
@@ -3801,6 +3822,7 @@ const DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION = (state, input) => {
   }
   return {
     loading,
+    loadingProgress: loading ? loadingProgress : undefined,
     error,
     value
   };
@@ -3832,7 +3854,7 @@ function loadingStateContext(input) {
       result = rxjs.of(beginLoading());
     }
     return result;
-  }), rxjs.distinctUntilChanged((a, b) => a.loading === b.loading && a.error === b.error && a?.value === b?.value), rxjs.shareReplay(1));
+  }), rxjs.distinctUntilChanged(isLoadingStateEqual), rxjs.shareReplay(1));
   const currentState$ = currentStateStream$.pipe(rxjs.switchMap(x => x ? x : rxjs.of(undefined)));
   const state$ = currentState$.pipe(filterMaybe(), rxjs.shareReplay(1));
   const loading$ = eventStream$.pipe(rxjs.map(isLoadingStateLoading));
@@ -4970,6 +4992,7 @@ exports.isItemPageIteratorResultEndResult = isItemPageIteratorResultEndResult;
 exports.isListLoadingStateEmpty = isListLoadingStateEmpty;
 exports.isListLoadingStateWithEmptyValue = isListLoadingStateWithEmptyValue;
 exports.isLoading = isLoading;
+exports.isLoadingStateEqual = isLoadingStateEqual;
 exports.isLoadingStateFinishedLoading = isLoadingStateFinishedLoading;
 exports.isLoadingStateFinishedLoadingWithDefinedValue = isLoadingStateFinishedLoadingWithDefinedValue;
 exports.isLoadingStateFinishedLoadingWithError = isLoadingStateFinishedLoadingWithError;

package/index.esm.js

@@ -1977,6 +1977,92 @@ function filterIfObjectValuesUnchanged(input) {
   }
 }
 
+var classof = classofRaw$2;
+
+// `IsArray` abstract operation
+// https://tc39.es/ecma262/#sec-isarray
+// eslint-disable-next-line es/no-array-isarray -- safe
+var isArray$1 = Array.isArray || function isArray(argument) {
+  return classof(argument) === 'Array';
+};
+
+var DESCRIPTORS = descriptors;
+var isArray = isArray$1;
+
+var $TypeError$1 = TypeError;
+// eslint-disable-next-line es/no-object-getownpropertydescriptor -- safe
+var getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+
+// Safari < 13 does not throw an error in this case
+var SILENT_ON_NON_WRITABLE_LENGTH_SET = DESCRIPTORS && !function () {
+  // makes no sense without proper strict mode support
+  if (this !== undefined) return true;
+  try {
+    // eslint-disable-next-line es/no-object-defineproperty -- safe
+    Object.defineProperty([], 'length', { writable: false }).length = 1;
+  } catch (error) {
+    return error instanceof TypeError;
+  }
+}();
+
+var arraySetLength = SILENT_ON_NON_WRITABLE_LENGTH_SET ? function (O, length) {
+  if (isArray(O) && !getOwnPropertyDescriptor(O, 'length').writable) {
+    throw new $TypeError$1('Cannot set read only .length');
+  } return O.length = length;
+} : function (O, length) {
+  return O.length = length;
+};
+
+var $TypeError = TypeError;
+var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
+
+var doesNotExceedSafeInteger$1 = function (it) {
+  if (it > MAX_SAFE_INTEGER) throw $TypeError('Maximum allowed index exceeded');
+  return it;
+};
+
+var $ = _export;
+var toObject = toObject$3;
+var lengthOfArrayLike = lengthOfArrayLike$3;
+var setArrayLength = arraySetLength;
+var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
+var fails = fails$c;
+
+var INCORRECT_TO_LENGTH = fails(function () {
+  return [].push.call({ length: 0x100000000 }, 1) !== 4294967297;
+});
+
+// V8 <= 121 and Safari <= 15.4; FF < 23 throws InternalError
+// https://bugs.chromium.org/p/v8/issues/detail?id=12681
+var properErrorOnNonWritableLength = function () {
+  try {
+    // eslint-disable-next-line es/no-object-defineproperty -- safe
+    Object.defineProperty([], 'length', { writable: false }).push();
+  } catch (error) {
+    return error instanceof TypeError;
+  }
+};
+
+var FORCED = INCORRECT_TO_LENGTH || !properErrorOnNonWritableLength();
+
+// `Array.prototype.push` method
+// https://tc39.es/ecma262/#sec-array.prototype.push
+$({ target: 'Array', proto: true, arity: 1, forced: FORCED }, {
+  // eslint-disable-next-line no-unused-vars -- required for `.length`
+  push: function push(item) {
+    var O = toObject(this);
+    var len = lengthOfArrayLike(O);
+    var argCount = arguments.length;
+    doesNotExceedSafeInteger(len + argCount);
+    for (var i = 0; i < argCount; i++) {
+      O[len] = arguments[i];
+      len++;
+    }
+    setArrayLength(O, len);
+    return len;
+  }
+});
+
 /**
  * Destroyable object that wraps an Unsubscribable.
  */
@@ -2029,6 +2115,15 @@ class MultiSubscriptionObject {
     this.unsub();
     this._subscriptions = convertToArray(subs);
   }
+  addSubs(subs) {
+    const nextSubscriptions = [...(this._subscriptions ?? [])];
+    convertToArray(subs).forEach(sub => {
+      if (!nextSubscriptions.includes(sub)) {
+        nextSubscriptions.push(sub);
+      }
+    });
+    this._subscriptions = nextSubscriptions;
+  }
   unsub() {
     if (this._subscriptions) {
       this._subscriptions.forEach(x => x.unsubscribe());
@@ -2347,92 +2442,6 @@ function iteratorNextPageUntilPage(iteration, page) {
   });
 }
 
-var classof = classofRaw$2;
-
-// `IsArray` abstract operation
-// https://tc39.es/ecma262/#sec-isarray
-// eslint-disable-next-line es/no-array-isarray -- safe
-var isArray$1 = Array.isArray || function isArray(argument) {
-  return classof(argument) === 'Array';
-};
-
-var DESCRIPTORS = descriptors;
-var isArray = isArray$1;
-
-var $TypeError$1 = TypeError;
-// eslint-disable-next-line es/no-object-getownpropertydescriptor -- safe
-var getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
-
-// Safari < 13 does not throw an error in this case
-var SILENT_ON_NON_WRITABLE_LENGTH_SET = DESCRIPTORS && !function () {
-  // makes no sense without proper strict mode support
-  if (this !== undefined) return true;
-  try {
-    // eslint-disable-next-line es/no-object-defineproperty -- safe
-    Object.defineProperty([], 'length', { writable: false }).length = 1;
-  } catch (error) {
-    return error instanceof TypeError;
-  }
-}();
-
-var arraySetLength = SILENT_ON_NON_WRITABLE_LENGTH_SET ? function (O, length) {
-  if (isArray(O) && !getOwnPropertyDescriptor(O, 'length').writable) {
-    throw new $TypeError$1('Cannot set read only .length');
-  } return O.length = length;
-} : function (O, length) {
-  return O.length = length;
-};
-
-var $TypeError = TypeError;
-var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
-
-var doesNotExceedSafeInteger$1 = function (it) {
-  if (it > MAX_SAFE_INTEGER) throw $TypeError('Maximum allowed index exceeded');
-  return it;
-};
-
-var $ = _export;
-var toObject = toObject$3;
-var lengthOfArrayLike = lengthOfArrayLike$3;
-var setArrayLength = arraySetLength;
-var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
-var fails = fails$c;
-
-var INCORRECT_TO_LENGTH = fails(function () {
-  return [].push.call({ length: 0x100000000 }, 1) !== 4294967297;
-});
-
-// V8 <= 121 and Safari <= 15.4; FF < 23 throws InternalError
-// https://bugs.chromium.org/p/v8/issues/detail?id=12681
-var properErrorOnNonWritableLength = function () {
-  try {
-    // eslint-disable-next-line es/no-object-defineproperty -- safe
-    Object.defineProperty([], 'length', { writable: false }).push();
-  } catch (error) {
-    return error instanceof TypeError;
-  }
-};
-
-var FORCED = INCORRECT_TO_LENGTH || !properErrorOnNonWritableLength();
-
-// `Array.prototype.push` method
-// https://tc39.es/ecma262/#sec-array.prototype.push
-$({ target: 'Array', proto: true, arity: 1, forced: FORCED }, {
-  // eslint-disable-next-line no-unused-vars -- required for `.length`
-  push: function push(item) {
-    var O = toObject(this);
-    var len = lengthOfArrayLike(O);
-    var argCount = arguments.length;
-    doesNotExceedSafeInteger(len + argCount);
-    for (var i = 0; i < argCount; i++) {
-      O[len] = arguments[i];
-      len++;
-    }
-    setArrayLength(O, len);
-    return len;
-  }
-});
-
 function distinctUntilArrayLengthChanges(inputGetArray) {
   const getArray = inputGetArray ?? (value => asArray(value));
   return distinctUntilChanged((a, b) => a === b, x => getArray(x).length);
@@ -3123,6 +3132,16 @@ function switchMapMaybeLoadingContextStream() {
   return switchMap(x => x != null ? x.stream$ : of(undefined));
 }
 
+/**
+ * Returns true if the two LoadingStates are considered equal, by comparing the loading, loadingProgress, error, and value properties.
+ *
+ * @param a LoadingState a
+ * @param b LoadingState b
+ * @returns Returns true if the input LoadingStates are considered equal.
+ */
+function isLoadingStateEqual(a, b) {
+  return a.loading === b.loading && a.loadingProgress === b.loadingProgress && a.error === b.error && a.value === b.value;
+}
 /**
  * Returns true if the input LoadingErrorPair has the same loading (truthy vs falsy) and error values as the other LoadingErrorPair.
  *
@@ -3131,7 +3150,7 @@ function switchMapMaybeLoadingContextStream() {
  * @returns Returns true if the input's metadata is considered equivalent.
  */
 function isLoadingStateMetadataEqual(a, b) {
-  return a.loading == b.loading && valuesAreBothNullishOrEquivalent(a.error, b.error);
+  return a.loading == b.loading && valuesAreBothNullishOrEquivalent(a.loadingProgress, b.loadingProgress) && valuesAreBothNullishOrEquivalent(a.error, b.error);
 }
 // MARK: Utility
 /**
@@ -3375,6 +3394,7 @@ function mergeLoadingStates(...args) {
     const currentLoadings = loadingStates.map(x => x?.error ? x.loading : false);
     const nonMaybeLoadings = currentLoadings.filter(x => x != null);
     const loading = nonMaybeLoadings.length > 0 ? reduceBooleansWithOr(nonMaybeLoadings) : undefined;
+    // TODO: Merge loadingProgress values, probably only if they're all defined though, otherwise undefined
     result = {
       // Evaluate both for the loading state.
       loading,
@@ -3581,7 +3601,7 @@ function combineLoadingStates(...args) {
   );
 }
 /**
- * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes.
+ * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes, or the loading state progress.
  *
  * @param sources
  * @returns
@@ -3601,7 +3621,7 @@ function combineLoadingStatesStatus(sources) {
       }
     }
     return result;
-  }), distinctUntilChanged((x, y) => loadingStateType(x) === loadingStateType(y)), shareReplay(1));
+  }), distinctUntilChanged((x, y) => loadingStateType(x) === loadingStateType(y) && x.loadingProgress === y.loadingProgress), shareReplay(1));
 }
 function startWithBeginLoading(state) {
   return startWith(beginLoading(state));
@@ -3787,7 +3807,8 @@ const DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION = (state, input) => {
   } = input;
   const {
     error,
-    value
+    value,
+    loadingProgress
   } = state;
   let loading = false;
   if (!hasNonNullValue(error)) {
@@ -3799,6 +3820,7 @@ const DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION = (state, input) => {
   }
   return {
     loading,
+    loadingProgress: loading ? loadingProgress : undefined,
     error,
     value
   };
@@ -3830,7 +3852,7 @@ function loadingStateContext(input) {
       result = of(beginLoading());
     }
     return result;
-  }), distinctUntilChanged((a, b) => a.loading === b.loading && a.error === b.error && a?.value === b?.value), shareReplay(1));
+  }), distinctUntilChanged(isLoadingStateEqual), shareReplay(1));
   const currentState$ = currentStateStream$.pipe(switchMap(x => x ? x : of(undefined)));
   const state$ = currentState$.pipe(filterMaybe(), shareReplay(1));
   const loading$ = eventStream$.pipe(map$1(isLoadingStateLoading));
@@ -4891,4 +4913,4 @@ function workFactoryForConfigFactory(configFactory) {
   };
 }
 
-export { DEFAULT_ASYNC_PUSHER_THROTTLE, DEFAULT_FACTORY_TIMER_INTERVAL, DEFAULT_ITEM_PAGE_ITERATOR_MAX, DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION, DEFAULT_LOCK_SET_TIME_LOCK_KEY, FilterMap, FilterMapKeyInstance, FilterSource, FilterSourceConnector, FilterSourceInstance, ItemPageIterationInstance, ItemPageIterator, LoadingStateType, LockSet, MultiSubscriptionObject, PresetFilterSource, SimpleLoadingContext, SubscriptionObject, ValuesLoadingContext, WorkInstance, accumulatorCurrentPageListLoadingState, accumulatorFlattenPageListLoadingState, allLoadingStatesHaveFinishedLoading, areAllLoadingStatesFinishedLoading, arrayValueFromFinishedLoadingState, asObservable, asObservableFromGetter, asyncPusher, asyncPusherCache, beginLoading, beginLoadingPage, catchLoadingStateErrorWithOperator, checkIs, cleanup, cleanupDestroyable, combineLatestFromArrayObsFn, combineLatestFromMapValuesObsFn, combineLatestFromObject, combineLatestMapFrom, combineLoadingStates, combineLoadingStatesStatus, currentValueFromLoadingState, distinctLoadingState, distinctUntilArrayLengthChanges, distinctUntilHasDifferentValues, distinctUntilItemsHaveDifferentValues, distinctUntilItemsValueChanges, distinctUntilKeysChange, distinctUntilMapHasDifferentKeys, distinctUntilModelIdChange, distinctUntilModelKeyChange, distinctUntilObjectKeyChange, distinctUntilObjectValuesChanged, emitAfterDelay, emitDelayObs, errorFromLoadingState, errorOnEmissionsInPeriod, errorPageResult, errorResult, factoryTimer, filterIfObjectValuesUnchanged, filterItemsWithObservableDecision, filterMaybe, filterMaybeArray, filterMaybeStrict, filterUnique, filterWithSearchString, flattenAccumulatorResultItemArray, idleLoadingState, incrementingNumberTimer, initialize, invertObservableDecision, isAnyLoadingStateInLoadingState, isErrorLoadingState, isItemPageIteratorResultEndResult, isListLoadingStateEmpty, isListLoadingStateWithEmptyValue, isLoading, isLoadingStateFinishedLoading, isLoadingStateFinishedLoadingWithDefinedValue, isLoadingStateFinishedLoadingWithError, isLoadingStateInErrorState, isLoadingStateInIdleState, isLoadingStateInLoadingState, isLoadingStateInSuccessState, isLoadingStateLoading, isLoadingStateMetadataEqual, isLoadingStateWithDefinedValue, isLoadingStateWithError, isLoadingStateWithStateType, isNot, isPageLoadingStateMetadataEqual, isSuccessLoadingState, itemAccumulator, itemAccumulatorNextPageUntilResultsCount, iterationHasNextAndCanLoadMore, iteratorNextPageUntilMaxPageLoadLimit, iteratorNextPageUntilPage, keyValueMap, lazyFrom, listLoadingStateContext, listLoadingStateIsEmpty, loadingStateContext, loadingStateFromObs, loadingStateHasError, loadingStateHasFinishedLoading, loadingStateHasFinishedLoadingWithError, loadingStateHasFinishedLoadingWithValue, loadingStateHasValue, loadingStateIsIdle, loadingStateIsLoading, loadingStateType, loadingStatesHaveEquivalentMetadata, makeCheckIsFunction, makeIsModifiedFunction, makeIsModifiedFunctionObservable, makeMapFilterWithPresetFn, makeReturnIfIsFunction, mapEachAsync, mapFilterWithPreset, mapForEach, mapIf, mapIsListLoadingStateWithEmptyValue, mapItemIteration, mapKeysIntersectionToArray, mapLoadingState, mapLoadingStateResults, mapLoadingStateValueFunction, mapLoadingStateValueWithOperator, mapMaybe, mapMultipleLoadingStateResults, mapPageItemIteration, mappedPageItemIteration, maybeValueFromObservableOrValue, maybeValueFromObservableOrValueGetter, mergeLoadingStateWithError, mergeLoadingStateWithLoading, mergeLoadingStateWithValue, mergeLoadingStates, multiKeyValueMap, onFalseToTrue, onLockSetNextUnlock, onMatchDelta, onTrueToFalse, pageItemAccumulatorCurrentPage, pageLoadingStateFromObs, pipeIf, preventComplete, promiseFromLoadingState, randomDelay, randomDelayWithRandomFunction, returnIfIs, scanBuildArray, scanCount, scanIntoArray, setContainsAllValuesFrom, setContainsAnyValueFrom, setContainsNoValueFrom, skipAllInitialMaybe, skipFirstMaybe, skipInitialMaybe, skipMaybes, startWithBeginLoading, successPageResult, successResult, switchMapFilterMaybe, switchMapMaybe, switchMapMaybeDefault, switchMapMaybeLoadingContextStream, switchMapMaybeObs, switchMapObject, switchMapOnBoolean, switchMapToDefault, switchMapWhileFalse, switchMapWhileTrue, tapAfterTimeout, tapFirst, tapLog, tapOnLoadingStateSuccess, tapOnLoadingStateType, throwErrorAfterTimeout, timeoutStartWith, unknownLoadingStatesIsLoading, updatedStateForSetError, updatedStateForSetLoading, updatedStateForSetValue, useAsObservable, useFirst, valueFromFinishedLoadingState, valueFromLoadingState, valueFromObservableOrValue, valueFromObservableOrValueGetter, workFactory, workFactoryForConfigFactory };
+export { DEFAULT_ASYNC_PUSHER_THROTTLE, DEFAULT_FACTORY_TIMER_INTERVAL, DEFAULT_ITEM_PAGE_ITERATOR_MAX, DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION, DEFAULT_LOCK_SET_TIME_LOCK_KEY, FilterMap, FilterMapKeyInstance, FilterSource, FilterSourceConnector, FilterSourceInstance, ItemPageIterationInstance, ItemPageIterator, LoadingStateType, LockSet, MultiSubscriptionObject, PresetFilterSource, SimpleLoadingContext, SubscriptionObject, ValuesLoadingContext, WorkInstance, accumulatorCurrentPageListLoadingState, accumulatorFlattenPageListLoadingState, allLoadingStatesHaveFinishedLoading, areAllLoadingStatesFinishedLoading, arrayValueFromFinishedLoadingState, asObservable, asObservableFromGetter, asyncPusher, asyncPusherCache, beginLoading, beginLoadingPage, catchLoadingStateErrorWithOperator, checkIs, cleanup, cleanupDestroyable, combineLatestFromArrayObsFn, combineLatestFromMapValuesObsFn, combineLatestFromObject, combineLatestMapFrom, combineLoadingStates, combineLoadingStatesStatus, currentValueFromLoadingState, distinctLoadingState, distinctUntilArrayLengthChanges, distinctUntilHasDifferentValues, distinctUntilItemsHaveDifferentValues, distinctUntilItemsValueChanges, distinctUntilKeysChange, distinctUntilMapHasDifferentKeys, distinctUntilModelIdChange, distinctUntilModelKeyChange, distinctUntilObjectKeyChange, distinctUntilObjectValuesChanged, emitAfterDelay, emitDelayObs, errorFromLoadingState, errorOnEmissionsInPeriod, errorPageResult, errorResult, factoryTimer, filterIfObjectValuesUnchanged, filterItemsWithObservableDecision, filterMaybe, filterMaybeArray, filterMaybeStrict, filterUnique, filterWithSearchString, flattenAccumulatorResultItemArray, idleLoadingState, incrementingNumberTimer, initialize, invertObservableDecision, isAnyLoadingStateInLoadingState, isErrorLoadingState, isItemPageIteratorResultEndResult, isListLoadingStateEmpty, isListLoadingStateWithEmptyValue, isLoading, isLoadingStateEqual, isLoadingStateFinishedLoading, isLoadingStateFinishedLoadingWithDefinedValue, isLoadingStateFinishedLoadingWithError, isLoadingStateInErrorState, isLoadingStateInIdleState, isLoadingStateInLoadingState, isLoadingStateInSuccessState, isLoadingStateLoading, isLoadingStateMetadataEqual, isLoadingStateWithDefinedValue, isLoadingStateWithError, isLoadingStateWithStateType, isNot, isPageLoadingStateMetadataEqual, isSuccessLoadingState, itemAccumulator, itemAccumulatorNextPageUntilResultsCount, iterationHasNextAndCanLoadMore, iteratorNextPageUntilMaxPageLoadLimit, iteratorNextPageUntilPage, keyValueMap, lazyFrom, listLoadingStateContext, listLoadingStateIsEmpty, loadingStateContext, loadingStateFromObs, loadingStateHasError, loadingStateHasFinishedLoading, loadingStateHasFinishedLoadingWithError, loadingStateHasFinishedLoadingWithValue, loadingStateHasValue, loadingStateIsIdle, loadingStateIsLoading, loadingStateType, loadingStatesHaveEquivalentMetadata, makeCheckIsFunction, makeIsModifiedFunction, makeIsModifiedFunctionObservable, makeMapFilterWithPresetFn, makeReturnIfIsFunction, mapEachAsync, mapFilterWithPreset, mapForEach, mapIf, mapIsListLoadingStateWithEmptyValue, mapItemIteration, mapKeysIntersectionToArray, mapLoadingState, mapLoadingStateResults, mapLoadingStateValueFunction, mapLoadingStateValueWithOperator, mapMaybe, mapMultipleLoadingStateResults, mapPageItemIteration, mappedPageItemIteration, maybeValueFromObservableOrValue, maybeValueFromObservableOrValueGetter, mergeLoadingStateWithError, mergeLoadingStateWithLoading, mergeLoadingStateWithValue, mergeLoadingStates, multiKeyValueMap, onFalseToTrue, onLockSetNextUnlock, onMatchDelta, onTrueToFalse, pageItemAccumulatorCurrentPage, pageLoadingStateFromObs, pipeIf, preventComplete, promiseFromLoadingState, randomDelay, randomDelayWithRandomFunction, returnIfIs, scanBuildArray, scanCount, scanIntoArray, setContainsAllValuesFrom, setContainsAnyValueFrom, setContainsNoValueFrom, skipAllInitialMaybe, skipFirstMaybe, skipInitialMaybe, skipMaybes, startWithBeginLoading, successPageResult, successResult, switchMapFilterMaybe, switchMapMaybe, switchMapMaybeDefault, switchMapMaybeLoadingContextStream, switchMapMaybeObs, switchMapObject, switchMapOnBoolean, switchMapToDefault, switchMapWhileFalse, switchMapWhileTrue, tapAfterTimeout, tapFirst, tapLog, tapOnLoadingStateSuccess, tapOnLoadingStateType, throwErrorAfterTimeout, timeoutStartWith, unknownLoadingStatesIsLoading, updatedStateForSetError, updatedStateForSetLoading, updatedStateForSetValue, useAsObservable, useFirst, valueFromFinishedLoadingState, valueFromLoadingState, valueFromObservableOrValue, valueFromObservableOrValueGetter, workFactory, workFactoryForConfigFactory };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/rxjs",
-  "version": "12.4.4",
+  "version": "12.5.0",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/iterator/iterator.page.d.ts

@@ -62,7 +62,7 @@ export interface ItemPageIteratorDelegate<V, F, C extends ItemPageIterationConfi
      *
      * If the input goes out of bounds, the result should be an empty array.
      */
-    loadItemsForPage: (request: ItemPageIteratorRequest<V, F, C>) => Observable<ItemPageIteratorResult<V>>;
+    loadItemsForPage(request: ItemPageIteratorRequest<V, F, C>): Observable<ItemPageIteratorResult<V>>;
 }
 export interface ItemPageIterationConfig<F = unknown> extends Filter<F>, ItemPageLimit {
 }

package/src/lib/loading/index.d.ts

@@ -7,3 +7,4 @@ export * from './loading.context.value';
 export * from './loading.state.list';
 export * from './loading.state';
 export * from './loading.state.rxjs';
+export * from './loading';

package/src/lib/loading/loading.context.d.ts

@@ -1,10 +1,16 @@
 import { type Observable } from 'rxjs';
 import { type LoadingState, type LoadingErrorPair } from './loading.state';
+import { LoadingProgress } from './loading';
+import { Maybe } from '@dereekb/util';
 /**
  * A LoadingErrorPair that always defines a loading value.
  */
 export interface LoadingContextEvent extends LoadingErrorPair {
     readonly loading: boolean;
+    /**
+     * Optional loading progress value.
+     */
+    readonly loadingProgress?: Maybe<LoadingProgress>;
 }
 /**
  * An observable LoadingContext that provides a stream of LoadingContextEvents.

package/src/lib/loading/loading.d.ts

@@ -0,0 +1,7 @@
+import { PercentNumber } from '@dereekb/util';
+/**
+ * Used to denote the percent progress of loading.
+ *
+ * This is a PercentNumber, a number between 0 and 100.
+ */
+export type LoadingProgress = PercentNumber;

package/src/lib/loading/loading.state.d.ts

@@ -1,4 +1,5 @@
 import { type Maybe, type ReadableError, type ReadableDataError, type Page, type FilteredPage, type PageNumber, type MapFunction, type ErrorInput } from '@dereekb/util';
+import { type LoadingProgress } from './loading';
 /**
  * A value/error pair used in loading situations.
  */
@@ -9,11 +10,23 @@ export interface LoadingErrorPair {
      * Not being specified is considered not being loaded.
      */
     readonly loading?: Maybe<boolean>;
+    /**
+     * Optional loading progress value.
+     */
+    readonly loadingProgress?: Maybe<LoadingProgress>;
     /**
      * A Readable server error.
      */
     readonly error?: Maybe<ReadableError>;
 }
+/**
+ * Returns true if the two LoadingStates are considered equal, by comparing the loading, loadingProgress, error, and value properties.
+ *
+ * @param a LoadingState a
+ * @param b LoadingState b
+ * @returns Returns true if the input LoadingStates are considered equal.
+ */
+export declare function isLoadingStateEqual<T extends LoadingState>(a: T, b: T): boolean;
 /**
  * Returns true if the input LoadingErrorPair has the same loading (truthy vs falsy) and error values as the other LoadingErrorPair.
  *

package/src/lib/loading/loading.state.rxjs.d.ts

@@ -20,7 +20,7 @@ export declare function combineLoadingStates<A extends object, B extends object,
 export declare function combineLoadingStates<A extends object, B extends object, C extends object, D extends object, E extends object, O>(obsA: Observable<LoadingState<A>>, obsB: Observable<LoadingState<B>>, obsC: Observable<LoadingState<C>>, obsD: Observable<LoadingState<D>>, obsE: Observable<LoadingState<E>>, mergeFn: (a: A, b: B, c: C, d: D, e: E) => O): Observable<LoadingState<O>>;
 export declare function combineLoadingStates<O>(...args: any[]): Observable<LoadingState<O>>;
 /**
- * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes.
+ * Combines the status of all loading states. Only emits when the LoadingStateType of the result changes, or the loading state progress.
  *
  * @param sources
  * @returns

package/src/lib/subscription.d.ts

@@ -23,6 +23,7 @@ export declare class MultiSubscriptionObject<T extends Unsubscribable = Unsubscr
     get hasSubscription(): boolean;
     set subscriptions(subs: ArrayOrValue<T>);
     setSubs(subs: ArrayOrValue<T>): void;
+    addSubs(subs: ArrayOrValue<T>): void;
     unsub(): void;
     destroy(): void;
 }