rubico 2.3.5 → 2.3.8

package/dist/x/unless.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/x/unless.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/x/unless.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/x/unless.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/x/values.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/x/values.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/x/values.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/x/values.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/x/values.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/x/when.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/x/when.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/x/when.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/x/when.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/x/when.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/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.
@@ -859,19 +859,31 @@ const map = (...args) => {
   return _map(collection, mapper)
 }
 
-map.entries = function mapEntries(mapper) {
-  return function mappingEntries(value) {
-    if (value == null) {
-      throw new TypeError('value is not an Object or Map')
-    }
-    if (value.constructor == Object) {
-      return objectMapEntries(value, mapper)
-    }
-    if (value.constructor == Map) {
-      return mapMapEntries(value, mapper)
-    }
+// _mapEntries(value Object|Map, mapper function) -> Object|Map
+const _mapEntries = (value, mapper) => {
+  if (value == null) {
     throw new TypeError('value is not an Object or Map')
   }
+  if (value.constructor == Object) {
+    return objectMapEntries(value, mapper)
+  }
+  if (value.constructor == Map) {
+    return mapMapEntries(value, mapper)
+  }
+  throw new TypeError('value is not an Object or Map')
+}
+
+map.entries = function mapEntries(...args) {
+  const mapper = args.pop()
+  if (args.length == 0) {
+    return curry2(_mapEntries, __, mapper)
+  }
+
+  const collection = args[0]
+  if (isPromise(collection)) {
+    return collection.then(curry2(_mapEntries, __, mapper))
+  }
+  return _mapEntries(collection, mapper)
 }
 
 map.series = mapper => function mappingInSeries(value) {
@@ -1890,6 +1902,103 @@ const iteratorForEach = function (iterator, callback) {
   return promises.length == 0 ? iterator : promiseAll(promises).then(always(iterator))
 }
 
+// _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
+}
+
+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
+}
+
+// _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
+}
+
+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
+}
+
+// _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
+}
+
+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
+}
+
+const asyncIteratorForEachSeries = async function (asyncIterator, callback) {
+  for await (const item of asyncIterator) {
+    const operation = callback(item)
+    if (isPromise(operation)) {
+      await operation
+    }
+  }
+  return asyncIterator
+}
+
 // type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
 // _forEach(collection Collection, callback function) -> collection Collection
 const _forEach = function (collection, callback) {
@@ -1914,15 +2023,41 @@ const _forEach = function (collection, callback) {
   return collection
 }
 
-const forEach = function (...args) {
-  const callback = args.pop()
-  if (args.length == 0) {
-    return curry2(_forEach, __, callback)
+const forEach = function (arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEach, __, arg0)
   }
-  const collection = args[0]
-  return isPromise(collection)
-    ? collection.then(curry2(_forEach, __, callback))
-    : _forEach(collection, callback)
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEach, __, arg1))
+    : _forEach(arg0, arg1)
+}
+
+const _forEachSeries = function (collection, callback) {
+  if (isArray(collection)) {
+    return arrayForEachSeries(collection, callback)
+  }
+  if (collection == null) {
+    throw new Error(`invalid collection ${collection}`)
+  }
+  if (typeof collection[symbolIterator] == 'function') {
+    return iteratorForEachSeries(collection[symbolIterator](), callback)
+  }
+  if (typeof collection[symbolAsyncIterator] == 'function') {
+    return asyncIteratorForEachSeries(collection[symbolAsyncIterator](), callback)
+  }
+  if (collection.constructor == Object) {
+    return objectForEachSeries(collection, callback)
+  }
+  throw new Error(`invalid collection ${collection}`)
+}
+
+forEach.series = function forEachSeries(arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEachSeries, __, arg0)
+  }
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEachSeries, __, arg1))
+    : _forEachSeries(arg0, arg1)
 }
 
 const SelfReferencingPromise = function (basePromise) {

package/forEach.js

@@ -10,6 +10,10 @@ const iteratorForEach = require('./_internal/iteratorForEach')
 const asyncIteratorForEach = require('./_internal/asyncIteratorForEach')
 const symbolIterator = require('./_internal/symbolIterator')
 const symbolAsyncIterator = require('./_internal/symbolAsyncIterator')
+const arrayForEachSeries = require('./_internal/arrayForEachSeries')
+const objectForEachSeries = require('./_internal/objectForEachSeries')
+const iteratorForEachSeries = require('./_internal/iteratorForEachSeries')
+const asyncIteratorForEachSeries = require('./_internal/asyncIteratorForEachSeries')
 
 // type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
 // _forEach(collection Collection, callback function) -> collection Collection
@@ -42,16 +46,16 @@ const _forEach = function (collection, callback) {
  * ```coffeescript [specscript]
  * type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
  *
- * forEach(collection Collection, callback function) -> collection Collection
+ * forEach(collection Collection, callback function) -> collection Promise|Collection
  *
- * forEach(callback function)(collection Collection) -> collection Collection
+ * forEach(callback function)(collection Collection) -> collection Promise|Collection
  * ```
  *
  * @description
- * Execute a callback for each item of a collection, returning a Promise if the execution is asynchronous.
+ * Execute a callback for each item of a collection, returning a Promise if the execution is asynchronous. Asynchronous execution happens concurrently.
  *
  * ```javascript [playground]
- * forEach([1, 2, 3, 4, 5l], console.log) // 1 2 3 4 5
+ * forEach([1, 2, 3, 4, 5], console.log) // 1 2 3 4 5
  *
  * forEach({ a: 1, b: 2, c: 3 }, console.log) // 1 2 3
  * ```
@@ -68,15 +72,72 @@ const _forEach = function (collection, callback) {
  * ])
  * ```
  */
-const forEach = function (...args) {
-  const callback = args.pop()
-  if (args.length == 0) {
-    return curry2(_forEach, __, callback)
+const forEach = function (arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEach, __, arg0)
   }
-  const collection = args[0]
-  return isPromise(collection)
-    ? collection.then(curry2(_forEach, __, callback))
-    : _forEach(collection, callback)
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEach, __, arg1))
+    : _forEach(arg0, arg1)
+}
+
+/**
+ * @name _forEachSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
+ *
+ * _forEachSeries(collection Collection, callback function) -> collection Promise|Collection
+ * ```
+ */
+const _forEachSeries = function (collection, callback) {
+  if (isArray(collection)) {
+    return arrayForEachSeries(collection, callback)
+  }
+  if (collection == null) {
+    throw new Error(`invalid collection ${collection}`)
+  }
+  if (typeof collection[symbolIterator] == 'function') {
+    return iteratorForEachSeries(collection[symbolIterator](), callback)
+  }
+  if (typeof collection[symbolAsyncIterator] == 'function') {
+    return asyncIteratorForEachSeries(collection[symbolAsyncIterator](), callback)
+  }
+  if (collection.constructor == Object) {
+    return objectForEachSeries(collection, callback)
+  }
+  throw new Error(`invalid collection ${collection}`)
+}
+
+/**
+ * @name forEach.series
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
+ *
+ * forEach.series(collection Collection, callback function) -> collection Promise|Collection
+ *
+ * forEach.series(callback function)(collection Collection) -> collection Promise|Collection
+ * ```
+ *
+ * @description
+ * Execute a callback for each item of a collection, returning a Promise if the execution is asynchronous. Asynchronous execution happens in series.
+ *
+ * ```javascript [playground]
+ * forEach.series([1, 2, 3, 4, 5], console.log) // 1 2 3 4 5
+ *
+ * forEach.series({ a: 1, b: 2, c: 3 }, console.log) // 1 2 3
+ * ```
+ */
+forEach.series = function forEachSeries(arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEachSeries, __, arg0)
+  }
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEachSeries, __, arg1))
+    : _forEachSeries(arg0, arg1)
 }
 
 module.exports = forEach

package/index.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.
@@ -865,19 +865,31 @@ const map = (...args) => {
   return _map(collection, mapper)
 }
 
-map.entries = function mapEntries(mapper) {
-  return function mappingEntries(value) {
-    if (value == null) {
-      throw new TypeError('value is not an Object or Map')
-    }
-    if (value.constructor == Object) {
-      return objectMapEntries(value, mapper)
-    }
-    if (value.constructor == Map) {
-      return mapMapEntries(value, mapper)
-    }
+// _mapEntries(value Object|Map, mapper function) -> Object|Map
+const _mapEntries = (value, mapper) => {
+  if (value == null) {
     throw new TypeError('value is not an Object or Map')
   }
+  if (value.constructor == Object) {
+    return objectMapEntries(value, mapper)
+  }
+  if (value.constructor == Map) {
+    return mapMapEntries(value, mapper)
+  }
+  throw new TypeError('value is not an Object or Map')
+}
+
+map.entries = function mapEntries(...args) {
+  const mapper = args.pop()
+  if (args.length == 0) {
+    return curry2(_mapEntries, __, mapper)
+  }
+
+  const collection = args[0]
+  if (isPromise(collection)) {
+    return collection.then(curry2(_mapEntries, __, mapper))
+  }
+  return _mapEntries(collection, mapper)
 }
 
 map.series = mapper => function mappingInSeries(value) {
@@ -1896,6 +1908,103 @@ const iteratorForEach = function (iterator, callback) {
   return promises.length == 0 ? iterator : promiseAll(promises).then(always(iterator))
 }
 
+// _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
+}
+
+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
+}
+
+// _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
+}
+
+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
+}
+
+// _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
+}
+
+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
+}
+
+const asyncIteratorForEachSeries = async function (asyncIterator, callback) {
+  for await (const item of asyncIterator) {
+    const operation = callback(item)
+    if (isPromise(operation)) {
+      await operation
+    }
+  }
+  return asyncIterator
+}
+
 // type Collection = Array|Iterable|AsyncIterable|{ forEach: function }|Object
 // _forEach(collection Collection, callback function) -> collection Collection
 const _forEach = function (collection, callback) {
@@ -1920,15 +2029,41 @@ const _forEach = function (collection, callback) {
   return collection
 }
 
-const forEach = function (...args) {
-  const callback = args.pop()
-  if (args.length == 0) {
-    return curry2(_forEach, __, callback)
+const forEach = function (arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEach, __, arg0)
   }
-  const collection = args[0]
-  return isPromise(collection)
-    ? collection.then(curry2(_forEach, __, callback))
-    : _forEach(collection, callback)
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEach, __, arg1))
+    : _forEach(arg0, arg1)
+}
+
+const _forEachSeries = function (collection, callback) {
+  if (isArray(collection)) {
+    return arrayForEachSeries(collection, callback)
+  }
+  if (collection == null) {
+    throw new Error(`invalid collection ${collection}`)
+  }
+  if (typeof collection[symbolIterator] == 'function') {
+    return iteratorForEachSeries(collection[symbolIterator](), callback)
+  }
+  if (typeof collection[symbolAsyncIterator] == 'function') {
+    return asyncIteratorForEachSeries(collection[symbolAsyncIterator](), callback)
+  }
+  if (collection.constructor == Object) {
+    return objectForEachSeries(collection, callback)
+  }
+  throw new Error(`invalid collection ${collection}`)
+}
+
+forEach.series = function forEachSeries(arg0, arg1) {
+  if (typeof arg0 == 'function') {
+    return curry2(_forEachSeries, __, arg0)
+  }
+  return isPromise(arg0)
+    ? arg0.then(curry2(_forEachSeries, __, arg1))
+    : _forEachSeries(arg0, arg1)
 }
 
 const SelfReferencingPromise = function (basePromise) {