ramda-adjunct 2.32.0 → 2.33.0

package/package.json

@@ -14,7 +14,7 @@
     "cookbook",
     "functional"
   ],
-  "version": "2.32.0",
+  "version": "2.33.0",
   "homepage": "https://github.com/char0n/ramda-adjunct",
   "license": "BSD-3-Clause",
   "repository": {
@@ -78,7 +78,6 @@
     "build:es": "better-npm-run build:es",
     "build:commonjs": "better-npm-run build:commonjs",
     "build:umd": "better-npm-run build:umd",
-    "prepublishOnly": "better-npm-run prepublishOnly",
     "clean": "better-npm-run clean"
   },
   "betterScripts": {
@@ -139,47 +138,47 @@
     "ramda": ">= 0.19.0 <= 0.27.1"
   },
   "devDependencies": {
-    "@babel/cli": "7.13.14",
-    "@babel/core": "7.13.15",
-    "@babel/plugin-transform-modules-commonjs": "7.13.8",
-    "@babel/preset-env": "7.12.11",
-    "@babel/register": "7.13.14",
-    "@commitlint/cli": "=12.1.1",
-    "@commitlint/config-conventional": "=12.1.1",
+    "@babel/cli": "7.14.3",
+    "@babel/core": "=7.14.3",
+    "@babel/plugin-transform-modules-commonjs": "7.14.0",
+    "@babel/preset-env": "=7.14.2",
+    "@babel/register": "7.13.16",
+    "@commitlint/cli": "=12.1.4",
+    "@commitlint/config-conventional": "=12.1.4",
     "assert": "=2.0.0",
     "babel-loader": "8.2.2",
     "babel-plugin-annotate-pure-calls": "0.4.0",
     "babel-plugin-istanbul": "6.0.0",
     "better-npm-run": "0.1.1",
     "chai": "4.3.4",
-    "codecov": "3.8.1",
+    "codecov": "3.8.2",
     "conventional-changelog-cli": "2.1.1",
-    "core-js": "=3.10.1",
+    "core-js": "=3.12.1",
     "docdash": "git+https://github.com/char0n/docdash.git#534b44382138a55dd8d93642c979e51e46471185",
     "dtslint": "=4.0.9",
-    "eslint": "7.23.0",
+    "eslint": "7.26.0",
     "eslint-config-airbnb-base": "14.2.1",
-    "eslint-config-prettier": "=8.1.0",
-    "eslint-plugin-import": "2.22.1",
+    "eslint-config-prettier": "=8.3.0",
+    "eslint-plugin-import": "2.23.2",
     "eslint-plugin-mocha": "8.1.0",
-    "eslint-plugin-prettier": "3.3.1",
+    "eslint-plugin-prettier": "3.4.0",
     "eslint-plugin-ramda": "2.5.1",
-    "fantasy-land": "4.1.0",
+    "fantasy-land": "5.0.0",
     "fantasy-laws": "=1.2.0",
     "folktale": "=2.3.2",
-    "glob": "7.1.6",
+    "glob": "7.1.7",
     "husky": "6.0.0",
     "istanbul": "=0.4.5",
-    "jsdoc": "3.6.6",
+    "jsdoc": "=3.6.7",
     "jsverify": "0.8.4",
     "license-cli": "1.1.6",
-    "lint-staged": "10.5.4",
-    "mocha": "=8.3.2",
+    "lint-staged": "11.0.0",
+    "mocha": "=8.4.0",
     "mocha-junit-reporter": "2.0.0",
     "mocha-multi-reporters": "1.5.1",
     "monet": "0.9.2",
     "nyc": "15.1.0",
-    "prettier": "=2.2.1",
+    "prettier": "=2.3.0",
     "process": "=0.11.10",
     "ramda": "0.27.1",
     "ramda-fantasy": "=0.8.0",
@@ -187,12 +186,12 @@
     "rimraf": "3.0.2",
     "sanctuary-show": "2.0.0",
     "sinon": "10.0.1",
-    "terser-webpack-plugin": "5.1.1",
-    "testem": "=3.4.0",
+    "terser-webpack-plugin": "5.1.2",
+    "testem": "=3.4.1",
     "tslint": "=6.1.3",
     "typescript": "=4.2.4",
-    "webpack": "=5.31.0",
-    "webpack-cli": "4.6.0"
+    "webpack": "=5.37.1",
+    "webpack-cli": "4.7.0"
   },
   "browserslist": "> 0.25%, ie 10, ie 11, not op_mini all",
   "tonicExampleFilename": "tonicExample.js",

package/src/catchP.js

@@ -0,0 +1,25 @@
+import { invoker } from 'ramda';
+
+/**
+ * Composable shortcut for `Promise.catch`.
+ * The catchP function returns a Promise. It takes two arguments: a callback function for the failure of the Promise
+ * and the promise instance itself.
+ *
+ * @func catchP
+ * @memberOf RA
+ * @since {@link https://char0n.github.io/ramda-adjunct/2.29.0|v2.29.0}
+ * @category Function
+ * @sig (a -> Promise b | b) -> Promise b
+ * @param {Function} onRejected A Function called if the Promise is rejected. This function has one argument, the rejection reason.
+ * @param {Promise} promise Any Promise
+ * @return {Promise} Returns a Promise with dealt rejected cases
+ * @see {@link RA.thenP|thenP}, {@link RA.resolveP|resolveP}, {@link RA.rejectP|rejectP}, {@link RA.allP|allP}
+ *
+ * @example
+ *
+ * RA.catchP(() => 'b', Promise.resolve('a')); //=> Promise('a')
+ * RA.catchP(() => 'b', Promise.reject('a')); //=> Promise('b')
+ */
+const catchP = invoker(1, 'catch');
+
+export default catchP;

package/src/fantasy-land/Identity.js

@@ -1,6 +1,6 @@
 import { empty as emptyR } from 'ramda';
 
-import fl from './mapping';
+import * as fl from './mapping';
 import {
   applyTrait,
   functorTrait,
@@ -10,9 +10,6 @@ import {
   ordTrait,
 } from './traits';
 
-// we do this here for jsdocs generate properly
-const { of, ap, map, equals, concat, chain, lte, empty, contramap } = fl;
-
 /**
  * The simplest {@link https://github.com/fantasyland/fantasy-land|fantasy-land}
  * compatible monad which attaches no information to values.
@@ -48,7 +45,7 @@ class Identity {
    *
    * const a = Identity.of(1); //=> Identity(1)
    */
-  static [of](value) {
+  static [fl.of](value) {
     return new Identity(value);
   }
 
@@ -98,12 +95,12 @@ class Identity {
    *
    * a.ap(b); //=> Identity(2)
    */
-  [ap](applyWithFn) {
-    return applyTrait[ap].call(this, applyWithFn);
+  [fl.ap](applyWithFn) {
+    return applyTrait[fl.ap].call(this, applyWithFn);
   }
 
   ap(applyWithFn) {
-    return this[ap](applyWithFn);
+    return this[fl.ap](applyWithFn);
   }
 
   /**
@@ -117,12 +114,12 @@ class Identity {
    * const a = Identity.of(1);
    * a.map(a => a + 1); //=> Identity(2)
    */
-  [map](fn) {
-    return functorTrait[map].call(this, fn);
+  [fl.map](fn) {
+    return functorTrait[fl.map].call(this, fn);
   }
 
   map(fn) {
-    return this[map](fn);
+    return this[fl.map](fn);
   }
 
   /**
@@ -140,12 +137,12 @@ class Identity {
    * a.equals(b); //=> true
    * a.equals(c); //=> false
    */
-  [equals](setoid) {
-    return setoidTrait[equals].call(this, setoid);
+  [fl.equals](setoid) {
+    return setoidTrait[fl.equals].call(this, setoid);
   }
 
   equals(setoid) {
-    return this[equals](setoid);
+    return this[fl.equals](setoid);
   }
 
   /**
@@ -168,12 +165,12 @@ class Identity {
    * const f = Identity.of(['f']);
    * e.concat(f); //=> ['e', 'f']
    */
-  [concat](semigroup) {
-    return semigroupTrait[concat].call(this, semigroup);
+  [fl.concat](semigroup) {
+    return semigroupTrait[fl.concat].call(this, semigroup);
   }
 
   concat(semigroup) {
-    return this[concat](semigroup);
+    return this[fl.concat](semigroup);
   }
 
   /**
@@ -189,12 +186,12 @@ class Identity {
    *
    * a.chain(fn).chain(fn); //=> Identity(3)
    */
-  [chain](fn) {
-    return chainTrait[chain].call(this, fn);
+  [fl.chain](fn) {
+    return chainTrait[fl.chain].call(this, fn);
   }
 
   chain(fn) {
-    return this[chain](fn);
+    return this[fl.chain](fn);
   }
 
   /**
@@ -213,12 +210,12 @@ class Identity {
    * a.lte(c); //=> true
    * c.lte(a); //=> false
    */
-  [lte](ord) {
-    return ordTrait[lte].call(this, ord);
+  [fl.lte](ord) {
+    return ordTrait[fl.lte].call(this, ord);
   }
 
   lte(ord) {
-    return this[lte](ord);
+    return this[fl.lte](ord);
   }
 
   /**
@@ -237,12 +234,12 @@ class Identity {
    * a.concat(i); //=> Identity('string');
    * i.concat(a); //=> Identity('string');
    */
-  [empty]() {
+  [fl.empty]() {
     return this.constructor.of(emptyR(this.value));
   }
 
   empty() {
-    return this[empty]();
+    return this[fl.empty]();
   }
 
   /**
@@ -261,12 +258,12 @@ class Identity {
    * Identity.of(identity).contramap(divide2).contramap(add1).get()(3); //=> 2
    * Identity.of(identity).contramap(a => divide2(add1(a))).get()(3); //=> 2
    */
-  [contramap](fn) {
+  [fl.contramap](fn) {
     return this.constructor.of((value) => this.value(fn(value)));
   }
 
   contramap(fn) {
-    return this[contramap](fn);
+    return this[fl.contramap](fn);
   }
 }
 

package/src/fantasy-land/mapping.js

@@ -1,24 +1,20 @@
-const mapping = Object.freeze({
-  equals: 'fantasy-land/equals',
-  lte: 'fantasy-land/lte',
-  compose: 'fantasy-land/compose',
-  id: 'fantasy-land/id',
-  concat: 'fantasy-land/concat',
-  empty: 'fantasy-land/empty',
-  map: 'fantasy-land/map',
-  contramap: 'fantasy-land/contramap',
-  ap: 'fantasy-land/ap',
-  of: 'fantasy-land/of',
-  alt: 'fantasy-land/alt',
-  zero: 'fantasy-land/zero',
-  reduce: 'fantasy-land/reduce',
-  traverse: 'fantasy-land/traverse',
-  chain: 'fantasy-land/chain',
-  chainRec: 'fantasy-land/chainRec',
-  extend: 'fantasy-land/extend',
-  extract: 'fantasy-land/extract',
-  bimap: 'fantasy-land/bimap',
-  promap: 'fantasy-land/promap',
-});
-
-export default mapping;
+export const equals = 'fantasy-land/equals';
+export const lte = 'fantasy-land/lte';
+export const compose = 'fantasy-land/compose';
+export const id = 'fantasy-land/id';
+export const concat = 'fantasy-land/concat';
+export const empty = 'fantasy-land/empty';
+export const map = 'fantasy-land/map';
+export const contramap = 'fantasy-land/contramap';
+export const ap = 'fantasy-land/ap';
+export const of = 'fantasy-land/of';
+export const alt = 'fantasy-land/alt';
+export const zero = 'fantasy-land/zero';
+export const reduce = 'fantasy-land/reduce';
+export const traverse = 'fantasy-land/traverse';
+export const chain = 'fantasy-land/chain';
+export const chainRec = 'fantasy-land/chainRec';
+export const extend = 'fantasy-land/extend';
+export const extract = 'fantasy-land/extract';
+export const bimap = 'fantasy-land/bimap';
+export const promap = 'fantasy-land/promap';

package/src/fantasy-land/traits.js

@@ -4,7 +4,7 @@ import isString from '../isString';
 import isNumber from '../isNumber';
 import isFunction from '../isFunction';
 import { isSameType } from './util';
-import fl from './mapping';
+import * as fl from './mapping';
 
 export const functorTrait = {
   [fl.map](fn) {

package/src/index.js

@@ -91,6 +91,7 @@ export { default as isError } from './isError';
 export { default as isNaturalNumber } from './isNaturalNumber';
 export { default as isPrimitive } from './isPrimitive';
 export { default as isNotPrimitive } from './isNotPrimitive';
+export { default as isSentinelValue } from './isSentinelValue';
 // Function
 export { default as stubUndefined } from './stubUndefined';
 export { default as stubNull } from './stubNull';
@@ -107,6 +108,7 @@ export { default as weaveLazy } from './weaveLazy';
 export { default as curryRightN } from './curryRightN';
 export { default as curryRight } from './curryRight';
 export { default as allP } from './allP';
+export { default as catchP } from './catchP';
 export { default as noneP } from './noneP';
 export { default as resolveP } from './resolveP';
 export { default as rejectP } from './rejectP';

package/src/internal/ap.js

@@ -1,7 +1,7 @@
 import { ap as apR, curryN, pathSatisfies, both, either } from 'ramda';
 
 import isFunction from '../isFunction';
-import fl from '../fantasy-land/mapping';
+import * as fl from '../fantasy-land/mapping';
 
 const isFunctor = either(
   pathSatisfies(isFunction, ['map']),

package/src/internal/ponyfills/Promise.allSettled.js

@@ -7,9 +7,10 @@ const onFulfill = (value) => ({ status: 'fulfilled', value });
 const onReject = (reason) => ({ status: 'rejected', reason });
 
 const allSettledPonyfill = (iterable) => {
-  const array = map((p) => resolveP(p).then(onFulfill).catch(onReject), [
-    ...iterable,
-  ]);
+  const array = map(
+    (p) => resolveP(p).then(onFulfill).catch(onReject),
+    [...iterable]
+  );
 
   return allP(array);
 };

package/src/isSentinelValue.js

@@ -0,0 +1,26 @@
+import { curryN } from 'ramda';
+
+import isInteger32 from './isInteger32';
+
+/**
+ * Checks whether the passed value is {@link https://github.com/getify/You-Dont-Know-JS/blob/9959fc904d584bbf0b02cf41c192f74ff4238581/types-grammar/ch4.md#the-curious-case-of-the-|a sentinel value}.
+ *
+ * @func isSentinelValue
+ * @memberOf RA
+ * @since {@link https://char0n.github.io/ramda-adjunct/2.33.0|v2.33.0}
+ * @category Type
+ * @sig * -> Boolean
+ * @param {*} val The value to test
+ * @return {boolean}
+ * @example
+ *
+ * RA.isSentinelValue(-1); //=> true
+ *
+ * RA.isSentinelValue('-1'); //=> false
+ * RA.isSentinelValue(1); //=> false
+ * RA.isSentinelValue([-1]); //=> false
+ */
+// eslint-disable-next-line no-bitwise
+const isSentinelValue = curryN(1, (val) => isInteger32(val) && ~val === 0);
+
+export default isSentinelValue;

package/types/index.d.ts

@@ -455,6 +455,12 @@ declare namespace RamdaAdjunct {
          */
         isSparseArray(val: any): boolean;
 
+        /**
+         * Checks whether the passed value is
+         * {@link https://github.com/getify/You-Dont-Know-JS/blob/9959fc904d584bbf0b02cf41c192f74ff4238581/types-grammar/ch4.md#the-curious-case-of-the-|a sentinel value}.
+         */
+        isSentinelValue(val: any): boolean;
+
         /**
          * A function that returns `undefined`.
          */
@@ -996,6 +1002,14 @@ declare namespace RamdaAdjunct {
             reject<T>(options: { timeout: number, value: T }): Promise<T>
         };
 
+        /**
+         * Composable shortcut for `Promise.catch`.
+         * The catchP function returns a Promise. It takes two arguments: a callback function for the rejections of the Promise
+         * and the promise instance itself.
+         */
+        catchP<A, B = unknown>(onRejected: (error: any) => B | Promise<B>, promise: Promise<A>): Promise<A | B>;
+        catchP<A, B = unknown>(onRejected: (error: any) => B | Promise<B>): (promise: Promise<A>) => Promise<A | B>;
+
         /**
          * Composable shortcut for `Promise.then`.
          * The thenP function returns a Promise. It takes two arguments: a callback function for the success of the Promise