rubico 2.3.5 → 2.3.8

package/README.md

@@ -254,8 +254,8 @@ rubico is [MIT Licensed](https://github.com/a-synchronous/rubico/blob/master/LIC
 # Awesome Resources
 [rubico simplifies asynchronous code](https://dev.to/richytong/rubico-a-synchrnous-functional-syntax-motivation-20hf)
 <br>
-[Practical Functional Programming in JavaScript - Error Handling](https://dev.to/richytong/practical-functional-programming-in-javascript-error-handling-8g5)
+[Practical Functional Programming in JavaScript - Side Effects and Purity](https://dev.to/richytong/practical-functional-programming-in-javascript-side-effects-and-purity-revised-420h)
 <br>
 [Practical Functional Programming in JavaScript - Techniques for Composing Data](https://dev.to/richytong/practical-functional-programming-in-javascript-techniques-for-composing-data-c39)
 <br>
-[Practical Functional Programming in JavaScript - Side Effects and Purity](https://dev.to/richytong/practical-functional-programming-in-javascript-side-effects-and-purity-revised-420h)
+[Practical Functional Programming in JavaScript - Error Handling](https://dev.to/richytong/practical-functional-programming-in-javascript-error-handling-8g5)

package/_internal/arrayForEachSeries.js

@@ -0,0 +1,48 @@
+const isPromise = require('./isPromise')
+const thunkify3 = require('./thunkify3')
+
+// _arrayForEachSeriesAsync(
+//   array Array,
+//   callback function,
+//   index number
+// ) -> Promise<array>
+const _arrayForEachSeriesAsync = async function (array, callback, index) {
+  const length = array.length
+  while (++index < length) {
+    const operation = callback(array[index])
+    if (isPromise(operation)) {
+      await operation
+    }
+  }
+  return array
+}
+
+/**
+ * @name arrayForEachSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * var T any,
+ *   array Array<T>,
+ *   callback T=>()
+ *
+ * arrayForEachSeries(array Array, callback function) -> array|Promise
+ * ```
+ *
+ * @description
+ * Call a callback for each item of an array in series. Return a promise if any executions are asynchronous.
+ */
+const arrayForEachSeries = function (array, callback) {
+  const length = array.length
+  let index = -1
+  while (++index < length) {
+    const operation = callback(array[index])
+    if (isPromise(operation)) {
+      return operation
+        .then(thunkify3(_arrayForEachSeriesAsync, array, callback, index))
+    }
+  }
+  return array
+}
+
+module.exports = arrayForEachSeries

package/_internal/asyncIteratorForEachSeries.js

@@ -0,0 +1,28 @@
+const isPromise = require('./isPromise')
+
+/**
+ * @name asyncIteratorForEachSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * var T any,
+ *   asyncIterator AsyncIterator<T>,
+ *   callback T=>()
+ *
+ * asyncIteratorForEachSeries(asyncIterator, callback) -> Promise<>
+ * ```
+ *
+ * @description
+ * Execute a callback function for each item of an async iterator in series.
+ */
+const asyncIteratorForEachSeries = async function (asyncIterator, callback) {
+  for await (const item of asyncIterator) {
+    const operation = callback(item)
+    if (isPromise(operation)) {
+      await operation
+    }
+  }
+  return asyncIterator
+}
+
+module.exports = asyncIteratorForEachSeries

package/_internal/iteratorForEachSeries.js

@@ -0,0 +1,46 @@
+const isPromise = require('./isPromise')
+const thunkify2 = require('./thunkify2')
+
+// _iteratorForEachSeriesAsync(
+//   iterator Iterator,
+//   callback function,
+// ) -> Promise<iterator>
+const _iteratorForEachSeriesAsync = async function (iterator, callback) {
+  let iteration = iterator.next()
+  while (!iteration.done) {
+    const operation = callback(iteration.value)
+    if (isPromise(operation)) {
+      await operation
+    }
+    iteration = iterator.next()
+  }
+  return iterator
+}
+
+/**
+ * @name iteratorForEachSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * iteratorForEachSeries(iterator Iterator, callback function) -> iterator
+ * ```
+ *
+ * @description
+ * Call a callback for each item of an iterator. Return a promise if any executions are asynchronous.
+ *
+ * Note: iterator is consumed
+ */
+const iteratorForEachSeries = function (iterator, callback) {
+  let iteration = iterator.next()
+  while (!iterator.done) {
+    const operation = callback(iteration.value)
+    if (isPromise(operation)) {
+      return operation
+        .then(thunkify2(_iteratorForEachSeriesAsync, iterator, callback))
+    }
+    iteration = iterator.next()
+  }
+  return iterator
+}
+
+module.exports = iteratorForEachSeries

package/_internal/objectForEachSeries.js

@@ -0,0 +1,44 @@
+const isPromise = require('./isPromise')
+const thunkify3 = require('./thunkify3')
+
+// _objectForEachSeriesAsync(
+//   object Object,
+//   callback function,
+//   firstKey string
+// ) -> Promise<object>
+const _objectForEachSeriesAsync = async function (object, callback, firstKey) {
+  for (const key in object) {
+    if (key == firstKey) {
+      continue
+    }
+    const operation = callback(object[key])
+    if (isPromise(operation)) {
+      await operation
+    }
+  }
+  return object
+}
+
+/**
+ * @name objectForEachSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * objectForEachSeries(object Object, callback function) -> Promise|object
+ * ```
+ *
+ * @description
+ * Execute a callback for each value of an object. Return a promise if any executions are asynchronous.
+ */
+const objectForEachSeries = function (object, callback) {
+  for (const key in object) {
+    const operation = callback(object[key])
+    if (isPromise(operation)) {
+      return operation
+        .then(thunkify3(_objectForEachSeriesAsync, object, callback, key))
+    }
+  }
+  return object
+}
+
+module.exports = objectForEachSeries

package/_internal/series.js

@@ -0,0 +1,4 @@
+const series = function (f) {
+  return function executesInSeries(...args) {
+  }
+}

package/dist/Transducer.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/Transducer.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/Transducer.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/Transducer.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/Transducer.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/__.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/__.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/__.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/__.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/__.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/all.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/all.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/all.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/all.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/all.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/always.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/always.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/always.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/always.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/always.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/and.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/and.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/and.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/and.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/and.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/assign.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/assign.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/assign.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/assign.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/assign.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/compose.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/compose.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/compose.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/compose.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/compose.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/curry.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/curry.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/curry.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/curry.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/curry.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/eq.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/eq.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/eq.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/eq.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/eq.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/every.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/every.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/every.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/every.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/every.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/filter.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/filter.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/filter.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/filter.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/filter.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/flatMap.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.3.5
+ * rubico v2.3.8
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.