rubico 2.8.6 → 2.10.0

package/README.md

@@ -137,7 +137,7 @@ pipe(helloPromise, [ // helloPromise is resolved for 'hello'
 ])
 ```
 
-All Rubico operators support both eager and lazy APIs. The eager API takes all required arguments and executes at once, while the lazy API takes only the setup arguments and returns a function that only expects the data arguments. This dual API supports a natural and composable code style.
+All Rubico operators support both eager and lazy interfaces. The eager interface takes all required arguments and executes at once, while the lazy interface takes only the setup arguments and returns a function that only expects the data arguments. This dual interface supports a natural and composable code style.
 
 ```javascript [playground]
 const myObj = { a: 1, b: 2, c: 3 }

package/_internal/FlatMappingAsyncIterator.js

@@ -22,8 +22,11 @@ const sleep = require('./sleep')
  * @muxing
  */
 const FlatMappingAsyncIterator = function (asyncIterator, flatMapper) {
-  const buffer = [],
-    promises = new Set()
+  const buffer = []
+  const promises = new Set()
+
+  let consumingAsyncIterator = false
+  let isAsyncIteratorDone = false
 
   return {
     isAsyncIteratorDone: false,
@@ -34,47 +37,55 @@ const FlatMappingAsyncIterator = function (asyncIterator, flatMapper) {
       return '[object FlatMappingAsyncIterator]'
     },
 
+    // _consumeAsyncIterator() -> Promise<>
+    async _consumeAsyncIterator() {
+      for await (const item of asyncIterator) {
+        const monad = flatMapper(item)
+        if (isPromise(monad)) {
+          const bufferLoading =
+            monad.then(curry3(genericReduce, __, arrayPush, buffer))
+          const promise = bufferLoading.then(() => promises.delete(promise))
+          promises.add(promise)
+        } else {
+          const bufferLoading = genericReduce(monad, arrayPush, buffer)
+          if (isPromise(bufferLoading)) {
+            const promise = bufferLoading.then(() => promises.delete(promise))
+            promises.add(promise)
+          }
+        }
+      }
+      isAsyncIteratorDone = true
+    },
+
     /**
-     * @name FlatMappingAsyncIterator.prototype.next
+     * @name next
      *
      * @synopsis
      * ```coffeescript [specscript]
-     * new FlatMappingAsyncIterator(
-     *   asyncIterator AsyncIterator, flatMapper function,
-     * ).next() -> Promise<{ value, done }>
+     * next() -> Promise<{ value, done }>
      * ```
      */
     async next() {
-      while (
-        !this.isAsyncIteratorDone || buffer.length > 0 || promises.size > 0
-      ) {
-        if (!this.isAsyncIteratorDone) {
-          const { value, done } = await asyncIterator.next()
-          if (done) {
-            this.isAsyncIteratorDone = done
-          } else {
-            const monad = flatMapper(value)
-            if (isPromise(monad)) {
-              const bufferLoading =
-                monad.then(curry3(genericReduce, __, arrayPush, buffer))
-              const promise = bufferLoading.then(() => promises.delete(promise))
-              promises.add(promise)
-            } else {
-              const bufferLoading = genericReduce(monad, arrayPush, buffer)
-              if (isPromise(bufferLoading)) {
-                const promise = bufferLoading.then(() => promises.delete(promise))
-                promises.add(promise)
-              }
-            }
-          }
-        }
+      if (!consumingAsyncIterator) {
+        this._consumeAsyncIterator()
+        consumingAsyncIterator = true
+      }
+
+      while (!isAsyncIteratorDone || promises.size > 0) {
         if (buffer.length > 0) {
           return { value: buffer.shift(), done: false }
         }
         if (promises.size > 0) {
-          await promiseRace([sleep(1000), ...promises])
+          await promiseRace(promises)
+        } else {
+          await sleep(10)
         }
       }
+
+      if (buffer.length > 0) {
+        return { value: buffer.shift(), done: false }
+      }
+
       return { value: undefined, done: true }
     },
   }

package/_internal/LinkedList.js

@@ -0,0 +1,54 @@
+/**
+ * @name LinkedList
+ *
+ * @docs
+ * ```coffeescript [specscript]
+ * new LinkedList() -> LinkedList
+ * ```
+ */
+class LinkedList {
+  constructor() {
+    this.first = null
+    this.last = null
+    this.length = 0
+  }
+
+  // popFirst() -> firstValue any
+  popFirst() {
+    const first = this.first
+
+    if (first == null) {
+      return undefined
+    }
+
+    if (first.next) {
+      this.first = first.next
+    } else {
+      this.first = null
+    }
+
+    this.length -= 1
+
+    return first.value
+  }
+
+  // append(value any) -> undefined
+  append(value) {
+    const node = { value }
+    if (this.first == null) {
+      this.first = node
+    }
+
+    if (this.last == null) {
+      this.last = node
+    } else {
+      this.last.next = node
+      this.last = node
+    }
+
+    this.length += 1
+  }
+
+}
+
+module.exports = LinkedList

package/_internal/LinkedList.test.js

@@ -0,0 +1,34 @@
+const LinkedList = require('./LinkedList')
+const assert = require('assert')
+
+describe('LinkedList', () => {
+  it('integration', async () => {
+    const ll = new LinkedList()
+
+    assert.strictEqual(ll.popFirst(), undefined)
+
+    ll.append('value1')
+    assert.strictEqual(ll.length, 1)
+
+    assert.strictEqual(ll.popFirst(), 'value1')
+    assert.strictEqual(ll.length, 0)
+    assert.strictEqual(ll.popFirst(), undefined)
+    assert.strictEqual(ll.length, 0)
+
+    ll.append('value1')
+    assert.strictEqual(ll.length, 1)
+    ll.append('value2')
+    assert.strictEqual(ll.length, 2)
+    ll.append('value3')
+    assert.strictEqual(ll.length, 3)
+
+    assert.strictEqual(ll.popFirst(), 'value1')
+    assert.strictEqual(ll.length, 2)
+    assert.strictEqual(ll.popFirst(), 'value2')
+    assert.strictEqual(ll.length, 1)
+    assert.strictEqual(ll.popFirst(), 'value3')
+    assert.strictEqual(ll.length, 0)
+    assert.strictEqual(ll.popFirst(), undefined)
+    assert.strictEqual(ll.length, 0)
+  })
+})

package/_internal/MappingAsyncIterator.js

@@ -1,6 +1,11 @@
-const NextIteration = require('./NextIteration')
+const promiseRace = require('./promiseRace')
+const __ = require('./placeholder')
+const curry2 = require('./curry2')
 const isPromise = require('./isPromise')
+const LinkedList = require('./LinkedList')
 const symbolAsyncIterator = require('./symbolAsyncIterator')
+const arrayPush = require('./arrayPush')
+const sleep = require('./sleep')
 
 /**
  * @name MappingAsyncIterator
@@ -15,20 +20,65 @@ const symbolAsyncIterator = require('./symbolAsyncIterator')
  * mappingAsyncIterator.next() -> Promise<{ value: any, done: boolean }>
  * ```
  */
-const MappingAsyncIterator = (asyncIterator, mapper) => ({
-  [symbolAsyncIterator]() {
-    return this
-  },
-  async next() {
-    const iteration = await asyncIterator.next()
-    if (iteration.done) {
-      return iteration
-    }
-    const mapped = mapper(iteration.value)
-    return isPromise(mapped)
-      ? mapped.then(NextIteration)
-      : { value: mapped, done: false }
+const MappingAsyncIterator = (asyncIterator, mapper) => {
+  const buffer = new LinkedList()
+
+  let index = -1
+  let consumingAsyncIterator = false
+  let isAsyncIteratorDone = false
+
+  return {
+    [symbolAsyncIterator]() {
+      return this
+    },
+
+    // _consumeAsyncIterator() -> Promise<>
+    async _consumeAsyncIterator() {
+      for await (const item of asyncIterator) {
+        index += 1
+        const mappedItem = mapper(item)
+        buffer.append(mappedItem)
+      }
+      isAsyncIteratorDone = true
+    },
+
+    /**
+     * @name next
+     *
+     * @synopsis
+     * ```coffeescript [specscript]
+     * next() -> Promise<{ value, done }>
+     * ```
+     */
+    async next() {
+      if (!consumingAsyncIterator) {
+        this._consumeAsyncIterator()
+        consumingAsyncIterator = true
+      }
+
+      while (!isAsyncIteratorDone) {
+        if (buffer.length > 0) {
+          let value = buffer.popFirst()
+          if (isPromise(value)) {
+            value = await value
+          }
+          return { value, done: false }
+        }
+        await sleep(10)
+      }
+
+      if (buffer.length > 0) {
+        let value = buffer.popFirst()
+        if (isPromise(value)) {
+          value = await value
+        }
+        return { value, done: false }
+      }
+
+      return { value: undefined, done: true }
+    },
+
   }
-})
+}
 
 module.exports = MappingAsyncIterator

package/_internal/SerialMappingAsyncIterator.js

@@ -0,0 +1,79 @@
+const promiseRace = require('./promiseRace')
+const __ = require('./placeholder')
+const curry2 = require('./curry2')
+const isPromise = require('./isPromise')
+const LinkedList = require('./LinkedList')
+const symbolAsyncIterator = require('./symbolAsyncIterator')
+const arrayPush = require('./arrayPush')
+const sleep = require('./sleep')
+
+/**
+ * @name SerialMappingAsyncIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * serialMappingAsyncIterator = new SerialMappingAsyncIterator(
+ *   asyncIter AsyncIterator<T>,
+ *   mapper T=>Promise|any,
+ * ) -> serialMappingAsyncIterator AsyncIterator
+ *
+ * serialMappingAsyncIterator.next() -> Promise<{ value: any, done: boolean }>
+ * ```
+ */
+const SerialMappingAsyncIterator = (asyncIterator, mapper) => {
+  const buffer = new LinkedList()
+
+  let index = -1
+  let consumingAsyncIterator = false
+  let isAsyncIteratorDone = false
+
+  return {
+    [symbolAsyncIterator]() {
+      return this
+    },
+
+    // _consumeAsyncIterator() -> Promise<>
+    async _consumeAsyncIterator() {
+      for await (const item of asyncIterator) {
+        index += 1
+        let mappedItem = mapper(item)
+        if (isPromise(mappedItem)) {
+          mappedItem = await mappedItem
+        }
+        buffer.append(mappedItem)
+      }
+      isAsyncIteratorDone = true
+    },
+
+    /**
+     * @name next
+     *
+     * @synopsis
+     * ```coffeescript [specscript]
+     * next() -> Promise<{ value, done }>
+     * ```
+     */
+    async next() {
+      if (!consumingAsyncIterator) {
+        this._consumeAsyncIterator()
+        consumingAsyncIterator = true
+      }
+
+      while (!isAsyncIteratorDone) {
+        if (buffer.length > 0) {
+          return { value: buffer.popFirst(), done: false }
+        }
+        await sleep(10)
+      }
+
+      if (buffer.length > 0) {
+        return { value: buffer.popFirst(), done: false }
+      }
+
+      return { value: undefined, done: true }
+    },
+
+  }
+}
+
+module.exports = SerialMappingAsyncIterator

package/_internal/iteratorFind.js

@@ -28,7 +28,6 @@ const iteratorFindAsync = async function (iterator, predicate) {
     }
     iteration = iterator.next()
   }
-  return undefined
 }
 
 /**
@@ -57,7 +56,6 @@ const iteratorFind = function (iterator, predicate) {
     }
     iteration = iterator.next()
   }
-  return undefined
 }
 
 module.exports = iteratorFind

package/_internal/iteratorForEachSeries.js

@@ -32,7 +32,7 @@ const _iteratorForEachSeriesAsync = async function (iterator, callback) {
  */
 const iteratorForEachSeries = function (iterator, callback) {
   let iteration = iterator.next()
-  while (!iterator.done) {
+  while (!iteration.done) {
     const operation = callback(iteration.value)
     if (isPromise(operation)) {
       return operation

package/_internal/objectFlatten.js

@@ -38,9 +38,12 @@ const objectFlatten = function (object) {
 
   for (const key in object) {
     const element = object[key]
+
     if (element == null) {
       continue
-    } else if (typeof element[symbolIterator] == 'function') {
+    }
+
+    if (typeof element[symbolIterator] == 'function') {
       for (const monadElement of element) {
         objectAssign(result, monadElement)
       }

package/all.js

@@ -60,8 +60,7 @@ const _allValues = function (values) {
  *
  * const arrayOfGreetings = createArrayOfGreetings('example')
  *
- * console.log(arrayOfGreetingsFor1)
- * // ['Hi example', 'Hello example', 'Gretings example']
+ * console.log(arrayOfGreetings)
  * ```
  *
  * If provided promises, `all` resolves those promises and returns a promise of the resolved values.
@@ -107,13 +106,13 @@ const _allValues = function (values) {
  * getAndLogUserById('1')
  * ```
  *
- * Any promises passed in argument position are resolved for their values before further execution.
+ * Any promises in `arguments` are resolved for their values before further execution for the eager interface only.
  *
  * ```javascript [playground]
- * all(Promise.resolve({ a: 1 }), [
- *   obj => obj.a + 1,
- *   obj => obj.a + 2,
- *   obj => obj.a + 3,
+ * all(Promise.resolve({ a: 1 }), Promise.resolve(2), [
+ *   (obj, n) => obj.a + n + 1,
+ *   (obj, n) => obj.a + n + 2,
+ *   (obj, n) => obj.a + n + 3,
  * ]).then(console.log)
  * ```
  *
@@ -169,7 +168,7 @@ const all = function (...args) {
  * ```
  *
  * @description
- * `all` with serial execution.
+ * [all](/docs/all) with serial execution.
  *
  * ```javascript [playground]
  * const sleep = ms => () => new Promise(resolve => setTimeout(resolve, ms))

package/and.js

@@ -145,7 +145,7 @@ const areAllPredicatesTruthy = function (args, predicates) {
  * console.log(condition) // true
  * ```
  *
- * Any promises passed in argument position are resolved for their values before further execution.
+ * Any promises passed in data argument position are resolved for their values before further execution.
  *
  * ```javascript [playground]
  * and(Promise.resolve(5), [

package/assign.js

@@ -61,7 +61,7 @@ const _assign = function (object, funcs) {
  * promise.then(console.log)
  * ```
  *
- * Any promises passed in argument position are resolved for their values before further execution.
+ * If the argument object is a promise, it is resolved for its value before further execution for the eager interface only.
  *
  * ```javascript [playground]
  * assign(Promise.resolve({}), {

package/compose.js

@@ -44,7 +44,7 @@ const funcConcat = require('./_internal/funcConcat')
  * console.log(composition(1))
  * ```
  *
- * Any promises passed in argument position are resolved for their values before further execution.
+ * Any promises in `arguments` are resolved for their values before further execution for the eager interface only.
  *
  * ```javascript [playground]
  * compose(Promise.resolve(1), 2, Promise.resolve(3), [

package/curry.js

@@ -37,7 +37,7 @@ const curryArity = require('./_internal/curryArity')
  * console.log(curry(add, __, __, 'c')(__, 'b')('a'))
  * ```
  *
- * Any promises passed in argument position are resolved for their values before further execution.
+ * Any promises passed in data argument position are resolved for their values before further execution.
  *
  * ```javascript [playground]
  * const add = (a, b, c) => a + b + c

package/dist/Transducer.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/all.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/all.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/all.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/all.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/all.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/always.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/always.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/always.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/always.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/always.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/and.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/and.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.6
+ * Rubico v2.10.0
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software