• ObjectExtension<T>:
  • Added method when that returns this if a condition evaluates to true, otherwise null.
• FutureOrExtension<T>:
  • Added method whenAsync as an async-aware version of when, returning this or null based on a condition evaluation.

• ObjectExtension<T>:
  • Added method when that returns this if a condition evaluates to true, otherwise null.
• FutureOrExtension<T>:
  • Added method whenAsync as an async-aware version of when, returning this or null based on a condition evaluation.

v1.2.22 Latest

Latest

Compare

Choose a tag to compare

• ComputeOnceCache:

  • Added callsLength getter to return the number of cached computations.

• ComputeOnceCachedIDs:

  • Made compare field non-nullable and always initialized with a comparator (defaulting to _Comparer._defaultCompare).
  • Updated internal logic to consistently use non-null compare.
  • Improved sorting and deduplication logic in ComputeIDs constructor.
  • Enhanced computeIDs and getByIDs methods to correctly merge and order results by IDs.
  • Added detailed handling to preserve order and sorting of IDs and results.

• ComputeIDs:

  • Made compare field non-nullable and always initialized.
  • Added checkIDsSorted method to verify internal ID ordering.
  • Simplified and unified binary search and intersection logic to rely on non-null comparator.
  • Improved intersection method to preserve input order of IDs.
  • Improved getValuesByIndexes to handle cases where values list length differs from IDs length and ensure sorted output.
  • Simplified equalsIDs to always use comparator.

• ListIdValuePairExtension:

  • Updated binarySearchIndex and binarySearch methods to require non-null comparator argument.

• _Comparer:

  • Updated binarySearchIndex to require non-null comparator argument.

• ComputeOnceCache:

  • Added callsLength getter to return the number of cached computations.

• ComputeOnceCachedIDs:

  • Made compare field non-nullable and always initialized with a comparator (defaulting to _Comparer._defaultCompare).
  • Updated internal logic to consistently use non-null compare.
  • Improved sorting and deduplication logic in ComputeIDs constructor.
  • Enhanced computeIDs and getByIDs methods to correctly merge and order results by IDs.
  • Added detailed handling to preserve order and sorting of IDs and results.

• ComputeIDs:

  • Made compare field non-nullable and always initialized.
  • Added checkIDsSorted method to verify internal ID ordering.
  • Simplified and unified binary search and intersection logic to rely on non-null comparator.
  • Improved intersection method to preserve input order of IDs.
  • Improved getValuesByIndexes to handle cases where values list length differs from IDs length and ensure sorted output.
  • Simplified equalsIDs to always use comparator.

• ListIdValuePairExtension:

  • Updated binarySearchIndex and binarySearch methods to require non-null comparator argument.

• _Comparer:

  • Updated binarySearchIndex to require non-null comparator argument.

v1.2.21

Compare

Choose a tag to compare

• ComputeOnce:

  • Renamed ComputeOnceCall to ComputeCall.
  • Added PosComputeCall callback invoked after computation completes, receiving success or error results.
  • Added posCompute field to invoke post-computation callback.
  • Updated resolve and resolveAsync to apply posCompute on success or error.

• TimedComputeOnce:

  • Added support for posCompute callback.

• Added ComputeOnceCache:

  • Caches TimedComputeOnce instances by key.
  • Supports retention duration for cached entries with automatic eviction.
  • Provides get method to retrieve or create cached computations.

• Added ComputeOnceCachedIDs:

  • Extends ComputeOnceCache for batched computations by ID sets.
  • Supports ID ordering, hashing, and deduplication.
  • Shares in-flight computations for overlapping ID sets.
  • Provides getByIDs to get computations for subsets of IDs.
  • Provides computeIDs to compute and merge results for requested IDs, preserving order.

• Added ComputeIDs:

  • Represents an ordered, comparable, and hashable set of IDs.
  • Supports binary search, intersection, equality, and hashing.

• Added extensions:

  • IterableComputeOnceExtension for resolving multiple ComputeOnce instances.
  • MapComputeIDsExtension for resolving maps of TimedComputeOnce keyed by ComputeIDs.
  • ListIdValuePairExtension for binary searching (ID, value) pairs sorted by ID.

• Typedefs:

  • ComputeCallIDs for batched ID computations.
  • ComputeIDCompare and ComputeIDHash for ID comparison and hashing.

• ComputeOnce:

  • Renamed ComputeOnceCall to ComputeCall.
  • Added PosComputeCall callback invoked after computation completes, receiving success or error results.
  • Added posCompute field to invoke post-computation callback.
  • Updated resolve and resolveAsync to apply posCompute on success or error.

• TimedComputeOnce:

  • Added support for posCompute callback.

• Added ComputeOnceCache:

  • Caches TimedComputeOnce instances by key.
  • Supports retention duration for cached entries with automatic eviction.
  • Provides get method to retrieve or create cached computations.

• Added ComputeOnceCachedIDs:

  • Extends ComputeOnceCache for batched computations by ID sets.
  • Supports ID ordering, hashing, and deduplication.
  • Shares in-flight computations for overlapping ID sets.
  • Provides getByIDs to get computations for subsets of IDs.
  • Provides computeIDs to compute and merge results for requested IDs, preserving order.

• Added ComputeIDs:

  • Represents an ordered, comparable, and hashable set of IDs.
  • Supports binary search, intersection, equality, and hashing.

• Added extensions:

  • IterableComputeOnceExtension for resolving multiple ComputeOnce instances.
  • MapComputeIDsExtension for resolving maps of TimedComputeOnce keyed by ComputeIDs.
  • ListIdValuePairExtension for binary searching (ID, value) pairs sorted by ID.

• Typedefs:

  • ComputeCallIDs for batched ID computations.
  • ComputeIDCompare and ComputeIDHash for ID comparison and hashing.

v1.2.20

Compare

Choose a tag to compare

• FunctionArgs0Extension, FunctionArgs1Extension, FunctionArgs2Extension:

  • tryCall: updated to catch errors from synchronous or asynchronous results and apply onError via Future.catchError if the result is a Future.

• ComputeOnce<V>:

  • Constructor:
    • Added static helper _resolveCall to widen callbacks returning Future<Never> to FutureOr<V>.
    • Wrap _call with _resolveCall to fix Future<Never> callbacks.
  • Added isResolving getter to indicate if computation is in progress.
  • Enhanced resolve method:
    • Added parameters throwError, onError, and onErrorValue to control error handling behavior.
    • Supports returning fallback values or invoking error handlers instead of always throwing.
    • Calls onCompute callback on completion with value or error.
  • Enhanced resolveAsync method:
    • Added parameters throwError, onError, and onErrorValue for asynchronous error handling.
    • Calls onCompute callback on completion.
  • Added onCompute callback method invoked once computation completes.
  • Added className getter and improved toString to reflect current state (resolving, resolved with value, or error).

• Added TimedComputeOnce<V> subclass:

  • Records the timestamp when computation resolves (success or failure).
  • Provides resolvedAt timestamp and elapsedTime since resolution.
  • Overrides onCompute to set resolution time.
  • Overrides className for identification.

• FunctionArgs0Extension, FunctionArgs1Extension, FunctionArgs2Extension:

  • tryCall: updated to catch errors from synchronous or asynchronous results and apply onError via Future.catchError if the result is a Future.

• ComputeOnce<V>:

  • Constructor:
    • Added static helper _resolveCall to widen callbacks returning Future<Never> to FutureOr<V>.
    • Wrap _call with _resolveCall to fix Future<Never> callbacks.
  • Added isResolving getter to indicate if computation is in progress.
  • Enhanced resolve method:
    • Added parameters throwError, onError, and onErrorValue to control error handling behavior.
    • Supports returning fallback values or invoking error handlers instead of always throwing.
    • Calls onCompute callback on completion with value or error.
  • Enhanced resolveAsync method:
    • Added parameters throwError, onError, and onErrorValue for asynchronous error handling.
    • Calls onCompute callback on completion.
  • Added onCompute callback method invoked once computation completes.
  • Added className getter and improved toString to reflect current state (resolving, resolved with value, or error).

• Added TimedComputeOnce<V> subclass:

  • Records the timestamp when computation resolves (success or failure).
  • Provides resolvedAt timestamp and elapsedTime since resolution.
  • Overrides onCompute to set resolution time.
  • Overrides className for identification.

v1.2.19

Compare

Choose a tag to compare

• FutureExtension:

  • Added method whenResolved to invoke a callback on future resolution (success or error) and map the outcome to a new result without automatically rethrowing errors.

• ComputeOnce:

  • Added method whenComplete to register a callback executed when resolution completes, regardless of success or failure.
  • Added method whenResolved to invoke a callback on resolution (success or error) and map the outcome to a new result, delegating to resolveAsync and Future.whenResolved.

• FutureExtension:

  • Added method whenResolved to invoke a callback on future resolution (success or error) and map the outcome to a new result without automatically rethrowing errors.

• ComputeOnce:

  • Added method whenComplete to register a callback executed when resolution completes, regardless of success or failure.
  • Added method whenResolved to invoke a callback on resolution (success or error) and map the outcome to a new result, delegating to resolveAsync and Future.whenResolved.

v1.2.18

Compare

Choose a tag to compare

• ComputeOnce:
  • Added typedef ComputeOnceCall<V> for the computation callback signature.
  • Changed _call field type to nullable ComputeOnceCall<V>? and clear it after computation completes to release references and prevent re-invocation.

• ComputeOnce:
  • Added typedef ComputeOnceCall<V> for the computation callback signature.
  • Changed _call field type to nullable ComputeOnceCall<V>? and clear it after computation completes to release references and prevent re-invocation.

v1.2.17

Compare

Choose a tag to compare

• async_extension:

  • Added export of src/async_extension_compute_once.dart to library.
  • New ComputeOnce.

• Dependencies:

  • Updated test dependency from ^1.26.0 to ^1.26.3.
  • Updated coverage dependency from ^1.13.1 to ^1.15.0.

• Update GitHub Actions to use checkout@v6 and codecov-action@v5.

• async_extension:

  • Added export of src/async_extension_compute_once.dart to library.
  • New ComputeOnce.

• Dependencies:

  • Updated test dependency from ^1.26.0 to ^1.26.3.
  • Updated coverage dependency from ^1.13.1 to ^1.15.0.

• Update GitHub Actions to use checkout@v6 and codecov-action@v5.

v1.2.16

Compare

Choose a tag to compare

• New FunctionArgs0Extension, FunctionArgs1Extension, FunctionArgs2Extension:

  • Added tryCall, tryCallThen and asFutureOr.

• test: ^1.26.0

• dependency_validator: ^4.1.3

• coverage: ^1.13.1

• New FunctionArgs0Extension, FunctionArgs1Extension, FunctionArgs2Extension:

  • Added tryCall, tryCallThen and asFutureOr.

• test: ^1.26.0

• dependency_validator: ^4.1.3

• coverage: ^1.13.1

v1.2.15

Compare

Choose a tag to compare

• Added Function extension: retry and retryWith.

• Added Function extension: retry and retryWith.

v1.2.14

Compare

Choose a tag to compare

• Added asyncRetry.

• Improved asyncTry documentation.

• lints: ^4.0.0

• test: ^1.25.13

• dependency_validator: ^4.1.2

• coverage: ^1.11.1

• Added asyncRetry.

• Improved asyncTry documentation.

• lints: ^4.0.0

• test: ^1.25.13

• dependency_validator: ^4.1.2

• coverage: ^1.11.1

v1.2.13

Compare

Choose a tag to compare

• New IterableMapEntryFutureValueExtension:

  • Added resolveAllValues.

• New IterableMapEntryFutureKeyExtension:

  • Added resolveAllKeys.

• New IterableMapEntryFutureExtension:

  • Added resolveAllEntries.

• New IterableAsyncExtension:
  • Added forEachAsync.

• New CompleterExtension:
  • Added completeSafe, completeErrorSafe.

• onErrorReturn: added optional parameter onError.
• nullOnError: added optional parameters onError and onErrorOrNull.

• New AsyncExtensionErrorLogger and defaultAsyncExtensionErrorLogger:

• New FutureOnErrorExtension:

  • logError
  • onErrorReturn
  • nullOnError

• FutureNonNullOnErrorExtension:

  • onComplete

• FutureNullableOnErrorExtension:

  • onComplete
  • onCompleteNotNull

• lints: ^3.0.0

• IterableFutureOrNullableExtension:
  • whereFutureNullable, selectFuturesNullable: return Future<T?> for consistency with "Nullable" suffix.
  • waitFuturesNullable: return FutureOr<List<T?>> for consistency with "Nullable" suffix.

• New extension IterableFutureOrNullableExtension<T> on Iterable<FutureOr<T>?>:

  • whereFutureNullable, selectFuturesNullable, asFuturesNullable and waitFuturesNullable.

• test: ^1.25.2

• dependency_validator: ^3.2.3

• coverage: ^1.7.2

• New ExpandoFutureExtension and ExpandoFutureOrExtension:
  • putIfAbsentAsync

• New FutureOrIterableNullableExtension and FutureIterableNullableExtension.

• New FutureNullableExtension and FutureOrNullableExtension:
  • orElseAsync and orElseGeAsync.

• FutureOrIterableExtension and FutureIterableExtension.
  • Use suffix Async to avoid extension overwrite issues.

• New FutureOrIterableExtension and FutureIterableExtension.
• test: ^1.24.6

• sdk: '>=3.0.0 <4.0.0'
• lints: ^2.1.1
• test: ^1.24.4

• Optimize:

  • resolveMapped, resolveAllValuesNullable.
  • resolveAllValues, resolveAllValuesNullable, resolveAllKeys, resolveAllEntries.

• sdk: '>=2.18.0 <4.0.0'

• test: ^1.24.3

• Fix GitHub CI badge.
• sdk: '>=2.18.0 <3.0.0'
• lints: ^2.0.1
• test: ^1.23.0
• coverage: ^1.6.3

• asyncTry:
  • Fix issue when onError returns a Future with a type different from the main function.

• AsyncLoop:
  • Added AsyncLoop.forEach.
  • Optimize _runBody to avoid recursion.
• asyncTry:
  • Fix behavior when an error is rethrown inside an onError block.
  • Fix behavior when an error is thrown inside an onFinally block.
  • Ensures the same behavior of standard Dart try/catch blocks.

• FutureExtension and FutureOrExtension:
  • Renamed type getter to genericType to avoid issues with nullable variables.
• Update GitHub CI.
• lints: ^2.0.0
• test: ^1.17.12
• dependency_validator: ^3.2.2
• coverage: ^1.0.4

• whereNotNull renamed to whereNotNullSync to avoid conflict with package collection.

• Added asyncTry:
  • Executes a block in a try, then, catch and finally execution chain.
• Using standard Dart coverage.
• coverage: ^1.0.3

• New extension methods:
  • resolveOther
  • resolveAllNullable
• New Map extension methods:
  • resolveAllKeys
  • resolveAllEntries
  • resolveAllValues
  • resolveAllValuesNullable

• New extension methods for nullable types:
  • whereNotNull
  • whereNotNullResolved
  • resolveAllNotNull
• Fixed isResolved detection for when T is Object or dynamic.

• The package now exports dart:async.
• New extensions:
  • resolveWithValue
  • resolveAllWithValue
  • resolveAllThen
  • allAsList
• Optimized some resolutions
  • Now ensures that iterables won't be iterated more than once.
  • Ensures that List and Set won't be converted to List when not needed.

• Added AsyncLoop and AsyncSequenceLoop.

• Added FutureOr.then.

• Added resolveBoth for FutureOr and Future.
• Add Future and FutureOr arithmetic operators.
• Added Benchmarks:
  • async_extension_benchmark.dart
  • async_extension_benchmark2.dart

• Adjusted pubspec.yaml description.
• Added FOSSA scan and badges.

• Initial version.