rubico 2.4.2 → 2.5.0

package/README.md

@@ -265,3 +265,6 @@ rubico is [MIT Licensed](https://github.com/a-synchronous/rubico/blob/master/LIC
 [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 - Error Handling](https://dev.to/richytong/practical-functional-programming-in-javascript-error-handling-8g5)
+
+# Blog
+Check out the rubico blog at [https://rubico.land/blog](https://rubico.land/blog)

package/_internal/mapMapSeries.js

@@ -0,0 +1,62 @@
+const isPromise = require('./isPromise')
+const curry3 = require('./curry3')
+const thunkify3 = require('./thunkify3')
+const mapSet = require('./mapSet')
+const funcConcat = require('./funcConcat')
+const symbolIterator = require('./symbolIterator')
+
+// _mapMapSeriesAsync(
+//   iterator Iterator,
+//   f function,
+//   result Map,
+// ) -> Promise<Map>
+const _mapMapSeriesAsync = async function (iterator, f, result) {
+  let iteration = iterator.next()
+  while (!iteration.done) {
+    let resultItem = f(iteration.value[1])
+    if (isPromise(resultItem)) {
+      resultItem = await resultItem
+    }
+    result.set(iteration.value[0], resultItem)
+    iteration = iterator.next()
+  }
+  return result
+}
+
+/**
+ * @name mapMapSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type MapMapper = (
+ *   value any,
+ *   key any,
+ *   map Map
+ * )=>(resultItem Promise|any)
+ *
+ * mapMapSeries(map Map, f MapMapper) -> Promise|Map
+ * ```
+ *
+ * @description
+ * Apply a mapper in series to each value of a Map, returning a new Map of mapped items. Mapper may be asynchronous.
+ */
+const mapMapSeries = function (map, f) {
+  const result = new Map()
+  const iterator = map[symbolIterator]()
+  let iteration = iterator.next()
+  while (!iteration.done) {
+    const key = iteration.value[0]
+    const resultItem = f(iteration.value[1])
+    if (isPromise(resultItem)) {
+      return resultItem.then(funcConcat(
+        curry3(mapSet, result, key, __),
+        thunkify3(_mapMapSeriesAsync, iterator, f, result),
+      ))
+    }
+    result.set(key, resultItem)
+    iteration = iterator.next()
+  }
+  return result
+}
+
+module.exports = mapMapSeries

package/_internal/objectForEachSeries.js

@@ -4,11 +4,11 @@ const thunkify3 = require('./thunkify3')
 // _objectForEachSeriesAsync(
 //   object Object,
 //   callback function,
-//   firstKey string
+//   doneKeys Object,
 // ) -> Promise<object>
-const _objectForEachSeriesAsync = async function (object, callback, firstKey) {
+const _objectForEachSeriesAsync = async function (object, callback, doneKeys) {
   for (const key in object) {
-    if (key == firstKey) {
+    if (key in doneKeys) {
       continue
     }
     const operation = callback(object[key])
@@ -31,11 +31,13 @@ const _objectForEachSeriesAsync = async function (object, callback, firstKey) {
  * Execute a callback for each value of an object. Return a promise if any executions are asynchronous.
  */
 const objectForEachSeries = function (object, callback) {
+  const doneKeys = {}
   for (const key in object) {
+    doneKeys[key] = true
     const operation = callback(object[key])
     if (isPromise(operation)) {
       return operation
-        .then(thunkify3(_objectForEachSeriesAsync, object, callback, key))
+        .then(thunkify3(_objectForEachSeriesAsync, object, callback, doneKeys))
     }
   }
   return object

package/_internal/objectMapSeries.js

@@ -0,0 +1,61 @@
+const isPromise = require('./isPromise')
+const curry3 = require('./curry3')
+const thunkify4 = require('./thunkify4')
+const objectSet = require('./objectSet')
+const funcConcat = require('./funcConcat')
+const symbolIterator = require('./symbolIterator')
+
+// _objectMapSeriesAsync(
+//   object Object,
+//   f function,
+//   result Object,
+//   doneKeys Object
+// ) -> Promise<object>
+const _objectMapSeriesAsync = async function (object, f, result, doneKeys) {
+  for (const key in object) {
+    if (key in doneKeys) {
+      continue
+    }
+    let resultItem = f(object[key])
+    if (isPromise(resultItem)) {
+      resultItem = await resultItem
+    }
+    result[key] = resultItem
+  }
+  return result
+}
+
+/**
+ * @name objectMapSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type ObjectMapper = (
+ *   value any,
+ *   key string,
+ *   collection Object
+ * )=>(resultItem Promise|any)
+ *
+ * objectMapSeries(object Object, f ObjectMapper) -> Promise|Object
+ * ```
+ *
+ * @description
+ * Apply a function `f` in series to each value of an object, returning an object of results. `f` may be asynchronous.
+ */
+const objectMapSeries = function (object, f) {
+  const result = {}
+  const doneKeys = {}
+  for (const key in object) {
+    doneKeys[key] = true
+    const resultItem = f(object[key], key, object)
+    if (isPromise(resultItem)) {
+      return resultItem.then(funcConcat(
+        curry3(objectSet, result, key, __),
+        thunkify4(_objectMapSeriesAsync, object, f, result, doneKeys),
+      ))
+    }
+  }
+  return result
+}
+
+module.exports = objectMapSeries

package/_internal/setAdd.js

@@ -0,0 +1,14 @@
+/**
+ * @name setAdd
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * setAdd(set Set, value any) -> set
+ * ```
+ */
+const setAdd = function (set, value) {
+  set.add(value)
+  return set
+}
+
+module.exports = setAdd

package/_internal/setMapSeries.js

@@ -0,0 +1,61 @@
+const isPromise = require('./isPromise')
+const curry2 = require('./curry2')
+const thunkify3 = require('./thunkify3')
+const setAdd = require('./setAdd')
+const funcConcat = require('./funcConcat')
+const symbolIterator = require('./symbolIterator')
+
+// _setMapSeriesAsync(
+//   iterator Iterator,
+//   f function,
+//   result Set,
+// ) -> Promise<Set>
+const _setMapSeriesAsync = async function (iterator, f, result) {
+  let iteration = iterator.next()
+  while (!iteration.done) {
+    let resultItem = f(iteration.value)
+    if (isPromise(resultItem)) {
+      resultItem = await resultItem
+    }
+    result.add(resultItem)
+    iteration = iterator.next()
+  }
+  return result
+}
+
+/**
+ * @name setMapSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type SetMapper = (
+ *   value any,
+ *   key any,
+ *   collection Set
+ * )=>(resultItem Promise|any)
+ *
+ * setMapSeries(set Set, f SetMapper) -> Promise|Set
+ * ```
+ *
+ * @description
+ * Apply a mapper in series to each value of a set, returning a new set of mapped items. Mapper may be asynchronous.
+ */
+const setMapSeries = function (set, f) {
+  const result = new Set()
+  const iterator = set[symbolIterator]()
+  let iteration = iterator.next()
+  while (!iteration.done) {
+    const resultItem = f(iteration.value)
+    if (isPromise(resultItem)) {
+      return resultItem.then(funcConcat(
+        curry2(setAdd, result, __),
+        thunkify3(_setMapSeriesAsync, iterator, f, result),
+      ))
+    }
+    result.add(resultItem)
+    iteration = iterator.next()
+  }
+  return result
+}
+
+module.exports = setMapSeries

package/_internal/stringMap.js

@@ -17,7 +17,7 @@ const callPropUnary = require('./callPropUnary')
  * ```
  *
  * @description
- * Apply a mapper concurrently to each character of a string, returning a string result. `mapper` may be asynchronous.
+ * Apply a mapper concurrently to each character of a string, returning a string result. mapper function may be asynchronous.
  *
  * @related stringFlatMap
  */

package/_internal/stringMapSeries.js

@@ -0,0 +1,31 @@
+const isPromise = require('./isPromise')
+const curry3 = require('./curry3')
+const __ = require('./placeholder')
+const arrayMapSeries = require('./arrayMapSeries')
+const callPropUnary = require('./callPropUnary')
+
+/**
+ * @name stringMapSeries
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * stringMapSeries<
+ *   character string,
+ *   str String<character>,
+ *   mapper character=>Promise|string|any,
+ * >(str, mapper) -> stringWithCharactersMapped string
+ * ```
+ *
+ * @description
+ * Apply a mapper function in series to each character of a string, returning a string result. mapper function may be asynchronous.
+ *
+ * @related stringFlatMap
+ */
+const stringMapSeries = function (string, mapper) {
+  const result = arrayMapSeries(string, mapper)
+  return isPromise(result)
+    ? result.then(curry3(callPropUnary, __, 'join', ''))
+    : result.join('')
+}
+
+module.exports = stringMapSeries

package/dist/Transducer.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * 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.4.2
+ * rubico v2.5.0
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2024 Richard Tong
  * rubico may be freely distributed under the MIT license.