feat(asyncKeyLastByOnce): add asyncKeyLastByOnce function

Author: djcsdy

index.test.ts

@@ -28,6 +28,7 @@ import {
     asyncIterator,
     asyncKeyByOnce,
     asyncKeyFirstByOnce,
+    asyncKeyLastByOnce,
     asyncLastOnce,
     asyncMapOnce,
     asyncMaximumByOnce,
@@ -660,3 +661,13 @@ test("asyncKeyFirstByOnce", async t => {
         ["even", 4]
     ]);
 });
+
+test("asyncKeyLastByOnce", async t => {
+    const map = await asyncKeyLastByOnce(asyncIterator([1, 3, 4, 2, 5, 6]), e =>
+        e % 2 === 0 ? "even" : "odd"
+    );
+    t.deepEqual(Array.from(map.entries()), [
+        ["odd", 5],
+        ["even", 6]
+    ]);
+});

index.ts

@@ -1249,3 +1249,25 @@ export function asyncKeyFirstByOnceFn<TKey, TElement>(
 ): (iterator: AsyncIteratorLike<TElement>) => Promise<Map<TKey, TElement>> {
     return async iterator => asyncKeyFirstByOnce(iterator, f);
 }
+
+export async function asyncKeyLastByOnce<TKey, TElement>(
+    iterator: AsyncIteratorLike<TElement>,
+    f: (element: TElement, index: number) => TKey | Promise<TKey>
+): Promise<Map<TKey, TElement>> {
+    const it = asyncIterator(iterator);
+    const map = new Map<TKey, TElement>();
+    for (
+        let i = 0, element = await it.next();
+        element.done !== true;
+        ++i, element = await it.next()
+    ) {
+        map.set(await f(element.value, i), element.value);
+    }
+    return map;
+}
+
+export function asyncKeyLastByOnceFn<TKey, TElement>(
+    f: (element: TElement, index: number) => TKey | Promise<TKey>
+): (iterator: AsyncIteratorLike<TElement>) => Promise<Map<TKey, TElement>> {
+    return async iterator => asyncKeyLastByOnce(iterator, f);
+}