import { AsyncIterableX } from '../asynciterablex.js'; import { identityAsync } from '../../util/identity.js'; import { createGrouping } from './_grouping.js'; import { OperatorAsyncFunction } from '../../interfaces.js'; import { throwIfAborted } from '../../aborterror.js'; /** @ignore */ /** @ignore */ export class GroupedAsyncIterable extends AsyncIterableX { public readonly key: TKey; private _source: Iterable; constructor(key: TKey, source: Iterable) { super(); this.key = key; this._source = source; } async *[Symbol.asyncIterator](signal?: AbortSignal) { throwIfAborted(signal); for (const item of this._source) { yield item; } } } /** @ignore */ export class GroupByAsyncIterable extends AsyncIterableX< GroupedAsyncIterable > { private _source: AsyncIterable; private _keySelector: (value: TSource, signal?: AbortSignal) => TKey | Promise; private _elementSelector: (value: TSource, signal?: AbortSignal) => TValue | Promise; constructor( source: AsyncIterable, keySelector: (value: TSource, signal?: AbortSignal) => TKey | Promise, elementSelector: (value: TSource, signal?: AbortSignal) => TValue | Promise ) { super(); this._source = source; this._keySelector = keySelector; this._elementSelector = elementSelector; } async *[Symbol.asyncIterator](signal?: AbortSignal) { throwIfAborted(signal); const map = await createGrouping( this._source, this._keySelector, this._elementSelector, signal ); for (const [key, values] of map) { yield new GroupedAsyncIterable(key, values); } } } export function groupBy( keySelector: (value: TSource, signal?: AbortSignal) => TKey | Promise ): OperatorAsyncFunction>; export function groupBy( keySelector: (value: TSource, signal?: AbortSignal) => TKey | Promise, elementSelector?: (value: TSource, signal?: AbortSignal) => TValue | Promise ): OperatorAsyncFunction>; /** * Groups the elements of an async-iterable sequence and selects the resulting elements by using a specified function. * * @template TSource The type of the elements in the source sequence. * @template TKey The type of the grouping key computed for each element in the source sequence. * @template TValue The type of the elements within the groups computed for each element in the source sequence. * @param {((value: TSource, signal?: AbortSignal) => TKey | Promise)} keySelector A function to extract the key for each element. * @param {(( * value: TSource, * signal?: AbortSignal * ) => TValue | Promise)} [elementSelector=identityAsync] A function to map each source element to an element in an async-enumerable group. * @returns {OperatorAsyncFunction} A sequence of async-iterable groups, each of which corresponds to a unique key value, * containing all elements that share that same key value. */ export function groupBy( keySelector: (value: TSource, signal?: AbortSignal) => TKey | Promise, elementSelector: ( value: TSource, signal?: AbortSignal ) => TValue | Promise = identityAsync ): OperatorAsyncFunction> { return function groupByOperatorFunction( source: AsyncIterable ): AsyncIterableX> { return new GroupByAsyncIterable(source, keySelector, elementSelector); }; }