js-build-tools 2.1.2 → 2.2.0

package/README.md

@@ -23,6 +23,9 @@ module.exports = {
 
   // The output directory for browser-bundled files.
   browserPath: 'browser',
+  
+  // The paths for directories to delete before build.
+  cleanPaths: ['dist', 'browser'],
 
   // The name of entry the distribution file.
   distMain: 'dist/main',
@@ -156,8 +159,8 @@ Export these functions to your own project in order to customize your build pipe
     * [.watchTest()](#module_js-build-tools.watchTest) ⇒ <code>\*</code>
     * [.watchFull()](#module_js-build-tools.watchFull) ⇒ <code>FSWatcher</code>
     * [.typeScript()](#module_js-build-tools.typeScript) ⇒ <code>stream.Stream</code>
-    * [.testQuick([done], [testPath])](#module_js-build-tools.testQuick) ⇒ <code>Promise.&lt;\*&gt;</code>
-    * [.testFull([done], [testPath])](#module_js-build-tools.testFull) ⇒ <code>Promise.&lt;\*&gt;</code>
+    * [.testQuick()](#module_js-build-tools.testQuick) ⇒ <code>Promise.&lt;\*&gt;</code>
+    * [.testFull()](#module_js-build-tools.testFull) ⇒ <code>Promise.&lt;\*&gt;</code>
     * [.distMinify()](#module_js-build-tools.distMinify) ⇒ <code>\*</code>
     * [.distLint()](#module_js-build-tools.distLint) ⇒ <code>\*</code>
     * [.dist()](#module_js-build-tools.dist) ⇒ <code>\*</code>
@@ -193,28 +196,16 @@ Simplified typescript task using tsFor.
 **Kind**: static method of [<code>js-build-tools</code>](#module_js-build-tools)  
 <a name="module_js-build-tools.testQuick"></a>
 
-### js-build-tools.testQuick([done], [testPath]) ⇒ <code>Promise.&lt;\*&gt;</code>
-Run the Jest tests for files which have been modified (based on git status).
+### js-build-tools.testQuick() ⇒ <code>Promise.&lt;\*&gt;</code>
+Run the Jest tests for files which have been modified (based on git status).
 
 **Kind**: static method of [<code>js-build-tools</code>](#module_js-build-tools)  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [done] | <code>function</code> | <code></code> | 
-| [testPath] | <code>Array.&lt;string&gt;</code> \| <code>string</code> | <code>&#x27;path/config/test/files&#x27;</code> | 
-
 <a name="module_js-build-tools.testFull"></a>
 
-### js-build-tools.testFull([done], [testPath]) ⇒ <code>Promise.&lt;\*&gt;</code>
-Run all tests with jest.
+### js-build-tools.testFull() ⇒ <code>Promise.&lt;\*&gt;</code>
+Run all tests with jest.
 
 **Kind**: static method of [<code>js-build-tools</code>](#module_js-build-tools)  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [done] | <code>function</code> | <code></code> | 
-| [testPath] | <code>Array.&lt;string&gt;</code> \| <code>string</code> | <code>&#x27;path/config/test/files&#x27;</code> | 
-
 <a name="module_js-build-tools.distMinify"></a>
 
 ### js-build-tools.distMinify() ⇒ <code>\*</code>
@@ -554,14 +545,15 @@ Micro-functions used as components for the main gulp functions.
     * [.tsFor([srcPath], [distPath])](#module_partials.tsFor) ⇒ <code>stream.Stream</code>
     * [.runOnChange(path)](#module_partials.runOnChange) ⇒ <code>stream.Stream</code>
         * [~pathRegex](#module_partials.runOnChange..pathRegex)
+    * [.removeDirectory(dirPath)](#module_partials.removeDirectory) ⇒ <code>Promise.&lt;\*&gt;</code>
     * [.readmeTemplate()](#module_partials.readmeTemplate) ⇒ <code>\*</code>
     * [.minifyFor()](#module_partials.minifyFor) ⇒ <code>\*</code>
     * [.distSeries([srcPath], [distFinalPath], [tsSearch])](#module_partials.distSeries) ⇒ <code>function</code>
     * [.distForSrc([useTs])](#module_partials.distForSrc) ⇒ <code>string</code>
     * [.distFor([srcPath], [destPath])](#module_partials.distFor) ⇒ <code>stream.Stream</code>
-    * [.clean([done], [paths])](#module_partials.clean) ⇒ <code>Promise.&lt;Array.&lt;string&gt;&gt;</code> \| <code>\*</code>
+    * [.clean()](#module_partials.clean) ⇒ <code>Promise.&lt;Array.&lt;string&gt;&gt;</code> \| <code>\*</code>
     * [.beginWatcher()](#module_partials.beginWatcher) ⇒ <code>FSWatcher</code>
-    * [.addToReadme([done])](#module_partials.addToReadme) ⇒ <code>string</code> \| <code>Uint8Array</code>
+    * [.addToReadme()](#module_partials.addToReadme) ⇒ <code>string</code> \| <code>Uint8Array</code>
 
 <a name="module_partials.tsFor"></a>
 
@@ -597,6 +589,17 @@ Run this function when the watched files are modified.
 1. The original path comes in from src and is a .ts
 
 **Kind**: inner constant of [<code>runOnChange</code>](#module_partials.runOnChange)  
+<a name="module_partials.removeDirectory"></a>
+
+### partials.removeDirectory(dirPath) ⇒ <code>Promise.&lt;\*&gt;</code>
+Return a promise to be completed once the specified directory is deleted.
+
+**Kind**: static method of [<code>partials</code>](#module_partials)  
+
+| Param | Type |
+| --- | --- |
+| dirPath | <code>string</code> | 
+
 <a name="module_partials.readmeTemplate"></a>
 
 ### partials.readmeTemplate() ⇒ <code>\*</code>
@@ -647,16 +650,10 @@ Build the distribution for a given source pattern.
 
 <a name="module_partials.clean"></a>
 
-### partials.clean([done], [paths]) ⇒ <code>Promise.&lt;Array.&lt;string&gt;&gt;</code> \| <code>\*</code>
-Deletes all the distribution and browser files (used before create a new build).
+### partials.clean() ⇒ <code>Promise.&lt;Array.&lt;string&gt;&gt;</code> \| <code>\*</code>
+Deletes all the distribution and browser files (used before create a new build).
 
 **Kind**: static method of [<code>partials</code>](#module_partials)  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [done] | <code>function</code> | <code></code> | 
-| [paths] | <code>Array.&lt;string&gt;</code> | <code>[&#x27;dist/config/path&#x27;, &#x27;browser/config/path&#x27;]</code> | 
-
 <a name="module_partials.beginWatcher"></a>
 
 ### partials.beginWatcher() ⇒ <code>FSWatcher</code>
@@ -665,12 +662,7 @@ Create a chokidar instance which watches and triggers change when the globed fil
 **Kind**: static method of [<code>partials</code>](#module_partials)  
 <a name="module_partials.addToReadme"></a>
 
-### partials.addToReadme([done]) ⇒ <code>string</code> \| <code>Uint8Array</code>
-Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
+### partials.addToReadme() ⇒ <code>string</code> \| <code>Uint8Array</code>
+Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
 
 **Kind**: static method of [<code>partials</code>](#module_partials)  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [done] | <code>function</code> \| <code>null</code> | <code></code> | 
-

package/dist/partials/addToReadme.js

@@ -8,18 +8,16 @@ var _require = require('glob'),
 
 /**
  * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
+ * Configure this with 'readmeSearch', 'readmePath', 'readmeFile', and 'readmeOptions'.
  * @function
  * @memberOf module:partials
- * @param {function|null} [done=null]
  * @returns {string|Uint8Array}
  */
 var addToReadme = function addToReadme() {
-  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
-  var files = globSync(gulpConfig.get('readmeSearch'));
-  var readme = jsdoc2md.renderSync({
-    files: files
+  return jsdoc2md.render({
+    files: globSync(gulpConfig.get('readmeSearch'))
+  }).then(function (readme) {
+    return fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'));
   });
-  fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'));
-  return done && done();
 };
 module.exports = addToReadme;

package/dist/partials/clean.js

@@ -1,21 +1,26 @@
 "use strict";
 
-var del = require('del');
+require("core-js/modules/es.array.reduce.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/esnext.async-iterator.reduce.js");
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.reduce.js");
+require("core-js/modules/es.promise.js");
 var gulpConfig = require('../../gulp.config.js');
+var removeDirectory = require('./removeDirectory');
 
 /**
  * Deletes all the distribution and browser files (used before create a new build).
+ * Configure array of directories to remove with 'cleanPaths'.
  * @function
  * @memberOf module:partials
- * @param {function} [done=null]
- * @param {string[]} [paths=['dist/config/path', 'browser/config/path']]
  * @returns {Promise<string[]> | *}
  */
 var clean = function clean() {
-  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
-  var paths = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [gulpConfig.get('distPath'), gulpConfig.get('browserPath')];
-  return del(paths).then(function () {
-    return done && done();
-  });
+  return gulpConfig.get('cleanPaths').reduce(function (promise, path) {
+    return promise.then(function () {
+      return removeDirectory(path);
+    });
+  }, Promise.resolve());
 };
 module.exports = clean;

package/dist/partials/distSeries.js

@@ -14,7 +14,7 @@ var tsFor = require('./tsFor');
  * @param {string} [srcPath='src/config/path/dist/for']
  * @param {string} [distFinalPath='dist/config/path']
  * @param {string} [tsSearch='ts/search/config/path']
- * @returns {Function}
+ * @returns {function(null=): stream.Stream}
  */
 var distSeries = function distSeries() {
   var srcPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : distForSrc();

package/dist/partials/removeDirectory.js

@@ -0,0 +1,27 @@
+"use strict";
+
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.promise.js");
+var _require = require('fs'),
+  rm = _require.rm,
+  exists = _require.exists;
+
+/**
+ * Return a promise to be completed once the specified directory is deleted.
+ * @function
+ * @memberOf module:partials
+ * @param {string} dirPath
+ * @returns {Promise<*>}
+ */
+var removeDirectory = function removeDirectory(dirPath) {
+  return new Promise(function (resolve, reject) {
+    return exists(dirPath, function (doesExist) {
+      return doesExist ? rm(dirPath, {
+        recursive: true
+      }, function (error) {
+        return error ? reject(error) : resolve(dirPath);
+      }) : resolve(dirPath);
+    });
+  });
+};
+module.exports = removeDirectory;

package/dist/partials.js

@@ -17,6 +17,7 @@ var distForSrc = require('./partials/distForSrc')
 var distSeries = require('./partials/distSeries')
 var minifyFor = require('./partials/minifyFor')
 var readmeTemplate = require('./partials/readmeTemplate')
+var removeDirectory = require('./partials/removeDirectory')
 var runOnChange = require('./partials/runOnChange')
 var tsFor = require('./partials/tsFor')
 module.exports = {
@@ -28,6 +29,7 @@ module.exports = {
   distSeries: distSeries,
   minifyFor: minifyFor,
   readmeTemplate: readmeTemplate,
+  removeDirectory: removeDirectory,
   runOnChange: runOnChange,
   tsFor: tsFor
 }

package/dist/partials.min.js

@@ -1 +1 @@
-"use strict";var addToReadme=require("./partials/addToReadme"),beginWatcher=require("./partials/beginWatcher"),clean=require("./partials/clean"),distFor=require("./partials/distFor"),distForSrc=require("./partials/distForSrc"),distSeries=require("./partials/distSeries"),minifyFor=require("./partials/minifyFor"),readmeTemplate=require("./partials/readmeTemplate"),runOnChange=require("./partials/runOnChange"),tsFor=require("./partials/tsFor");module.exports={addToReadme:addToReadme,beginWatcher:beginWatcher,clean:clean,distFor:distFor,distForSrc:distForSrc,distSeries:distSeries,minifyFor:minifyFor,readmeTemplate:readmeTemplate,runOnChange:runOnChange,tsFor:tsFor};
+"use strict";var addToReadme=require("./partials/addToReadme"),beginWatcher=require("./partials/beginWatcher"),clean=require("./partials/clean"),distFor=require("./partials/distFor"),distForSrc=require("./partials/distForSrc"),distSeries=require("./partials/distSeries"),minifyFor=require("./partials/minifyFor"),readmeTemplate=require("./partials/readmeTemplate"),removeDirectory=require("./partials/removeDirectory"),runOnChange=require("./partials/runOnChange"),tsFor=require("./partials/tsFor");module.exports={addToReadme:addToReadme,beginWatcher:beginWatcher,clean:clean,distFor:distFor,distForSrc:distForSrc,distSeries:distSeries,minifyFor:minifyFor,readmeTemplate:readmeTemplate,removeDirectory:removeDirectory,runOnChange:runOnChange,tsFor:tsFor};

package/dist/test-helpers/setUp.js

@@ -25,9 +25,10 @@ function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyri
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 var fs = require('fs');
-var del = require('del');
 // Import the configurations and override some of them in order to direct to the temp directory.
 var gulpConfig = require('../../gulp.config.js');
+var _require = require('../partials'),
+  removeDirectory = _require.removeDirectory;
 var tempDir = 'test-temp/';
 var srcPath = "".concat(tempDir, "src");
 
@@ -42,6 +43,7 @@ var setDefaults = function setDefaults() {
   tempDir = "".concat(testDir, "/");
   srcPath = "".concat(tempDir, "src");
   gulpConfig.set('browserPath', "".concat(tempDir, "browser"));
+  gulpConfig.set('cleanPaths', [srcPath]);
   gulpConfig.set('distMain', "".concat(tempDir, "dist/main"));
   gulpConfig.set('distPath', "".concat(tempDir, "dist"));
   gulpConfig.set('distSearch', "".concat(tempDir, "dist/**/*.js"));
@@ -75,15 +77,16 @@ var createTempDir = /*#__PURE__*/function () {
             _context.next = 3;
             break;
           }
-          return _context.abrupt("return", del(tempDir).then(function () {
-            return createTempDir(fs.existsSync(tempDir));
+          return _context.abrupt("return", removeDirectory(tempDir).then(function (removedDir) {
+            return createTempDir(fs.existsSync(removedDir));
+          }).catch(function (error) {
+            return console.error('Error: ', error);
           }));
         case 3:
-          _context.next = 5;
-          return fs.mkdirSync(tempDir);
-        case 5:
-          return _context.abrupt("return", fs.mkdirSync(srcPath));
-        case 6:
+          return _context.abrupt("return", fs.mkdirSync(srcPath, {
+            recursive: true
+          }));
+        case 4:
         case "end":
           return _context.stop();
       }
@@ -111,17 +114,6 @@ exports.beforeEach = function () {
  * @memberOf module:testHelpers
  * @returns {Promise<*>}
  */
-exports.afterEach = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
-  return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-    while (1) switch (_context2.prev = _context2.next) {
-      case 0:
-        _context2.next = 2;
-        return del(tempDir);
-      case 2:
-        return _context2.abrupt("return", _context2.sent);
-      case 3:
-      case "end":
-        return _context2.stop();
-    }
-  }, _callee2);
-}));
+exports.afterEach = function () {
+  return removeDirectory(tempDir);
+};

package/dist/testFull.js

@@ -6,15 +6,13 @@ var runCLI = _require.runCLI
 
 /**
  * Run all tests with jest.
+ * Configure where tests are located by using 'testPath'.
  * @function
  * @memberOf module:js-build-tools
- * @param {function} [done=null]
- * @param {Array.<string>|string} [testPath='path/config/test/files']
  * @returns {Promise<*>}
  */
 var testFull = function testFull () {
-  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null
-  var testPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('testPath')
+  var testPath = gulpConfig.get('testPath')
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
     testPath = [testPath]

package/dist/testFull.min.js

@@ -1 +1 @@
-"use strict";var gulpConfig=require("../gulp.config.js"),_require=require("jest"),runCLI=_require.runCLI,testFull=function(){var r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:gulpConfig.get("testPath");return Array.isArray(r)||(r=[r]),runCLI(gulpConfig.get("testOptions"),r)};module.exports=testFull;
+"use strict";var gulpConfig=require("../gulp.config.js"),_require=require("jest"),runCLI=_require.runCLI,testFull=function(){var r=gulpConfig.get("testPath");return Array.isArray(r)||(r=[r]),runCLI(gulpConfig.get("testOptions"),r)};module.exports=testFull;

package/dist/testQuick.js

@@ -6,15 +6,13 @@ var runCLI = _require.runCLI
 
 /**
  * Run the Jest tests for files which have been modified (based on git status).
+ * Configure where tests are located by using 'testPath'.
  * @function
  * @memberOf module:js-build-tools
- * @param {function} [done=null]
- * @param {Array.<string>|string} [testPath='path/config/test/files']
  * @returns {Promise<*>}
  */
 var testQuick = function testQuick () {
-  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null
-  var testPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('testPath')
+  var testPath = gulpConfig.get('testPath')
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
     testPath = [testPath]

package/dist/testQuick.min.js

@@ -1 +1 @@
-"use strict";var gulpConfig=require("../gulp.config.js"),_require=require("jest"),runCLI=_require.runCLI,testQuick=function(){var r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:gulpConfig.get("testPath");return Array.isArray(r)||(r=[r]),runCLI({onlyChanged:!0},r)};module.exports=testQuick;
+"use strict";var gulpConfig=require("../gulp.config.js"),_require=require("jest"),runCLI=_require.runCLI,testQuick=function(){var r=gulpConfig.get("testPath");return Array.isArray(r)||(r=[r]),runCLI({onlyChanged:!0},r)};module.exports=testQuick;

package/functions/bundle.test.js

@@ -64,5 +64,5 @@ describe('bundle', () => {
         console.error('Encountered error', error)
         done()
       })
-  }, 500)
+  })
 })

package/functions/partials/addToReadme.js

@@ -5,16 +5,15 @@ const { globSync } = require('glob')
 
 /**
  * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
+ * Configure this with 'readmeSearch', 'readmePath', 'readmeFile', and 'readmeOptions'.
  * @function
  * @memberOf module:partials
- * @param {function|null} [done=null]
  * @returns {string|Uint8Array}
  */
-const addToReadme = (done = null) => {
-  const files = globSync(gulpConfig.get('readmeSearch'))
-  const readme = jsdoc2md.renderSync({ files: files })
-  fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'))
-  return done && done()
-}
+const addToReadme = () => jsdoc2md
+  .render({ files: globSync(gulpConfig.get('readmeSearch')) })
+  .then(
+    readme => fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'))
+  )
 
 module.exports = addToReadme

package/functions/partials/addToReadme.test.js

@@ -15,14 +15,13 @@ beforeEach(() => setUp.beforeEach()
 afterEach(setUp.afterEach)
 
 describe('addToReadme', () => {
-  test('generates the documentation', () => {
+  test('generates the documentation', async () => {
     const readmeFilePath = gulpConfig.get('readmePath') + gulpConfig.get('readmeFile')
     expect.assertions(2)
-    addToReadme(async () => {
-      await expect(fs.existsSync(readmeFilePath)).toBeTruthy()
-      const readme = await fs.readFileSync(readmeFilePath)
-      // At least the documentation will have the addToReadme documentation
-      await expect(readme.includes('addToReadme')).toBeTruthy()
-    })
+    await addToReadme()
+    await expect(fs.existsSync(readmeFilePath)).toBeTruthy()
+    const readme = await fs.readFileSync(readmeFilePath)
+    // At least the documentation will have the addToReadme documentation
+    await expect(readme.includes('addToReadme')).toBeTruthy()
   })
 })

package/functions/partials/clean.js

@@ -1,14 +1,16 @@
-const del = require('del')
 const gulpConfig = require('../../gulp.config.js')
+const removeDirectory = require('./removeDirectory')
 
 /**
  * Deletes all the distribution and browser files (used before create a new build).
+ * Configure array of directories to remove with 'cleanPaths'.
  * @function
  * @memberOf module:partials
- * @param {function} [done=null]
- * @param {string[]} [paths=['dist/config/path', 'browser/config/path']]
  * @returns {Promise<string[]> | *}
  */
-const clean = (done = null, paths = [gulpConfig.get('distPath'), gulpConfig.get('browserPath')]) => del(paths).then(() => done && done())
+const clean = () => gulpConfig.get('cleanPaths').reduce(
+    (promise, path) => promise.then(() => removeDirectory(path)),
+    Promise.resolve()
+  )
 
 module.exports = clean

package/functions/partials/clean.test.js

@@ -14,7 +14,7 @@ describe('clean', () => {
     const srcPath = gulpConfig.get('srcPath')
     expect(fs.readdirSync(srcPath)).toBeTruthy()
     // Run the clean script to empty the directories
-    await clean(null, [srcPath])
+    await clean()
     expect(fs.existsSync(srcPath)).toBeFalsy()
   })
 })

package/functions/partials/distFor.test.js

@@ -89,7 +89,7 @@ describe('distFor', () => {
         console.error('Encountered error', error)
         done()
       })
-  })
+  }, 60000)
 
   test('can process typescript before babel', done => {
     const srcPath = gulpConfig.get('srcPath')
@@ -121,5 +121,5 @@ describe('distFor', () => {
         console.error('Encountered error with typeScript', error)
         done()
       })
-  }, 30000)
+  }, 60000)
 })

package/functions/partials/removeDirectory.js

@@ -0,0 +1,23 @@
+const { rm, exists } = require('fs')
+
+/**
+ * Return a promise to be completed once the specified directory is deleted.
+ * @function
+ * @memberOf module:partials
+ * @param {string} dirPath
+ * @returns {Promise<*>}
+ */
+const removeDirectory = dirPath => new Promise(
+  (resolve, reject) => exists(
+    dirPath,
+    doesExist => doesExist
+      ? rm(
+        dirPath,
+        { recursive: true },
+        error => error ? reject(error) : resolve(dirPath)
+      )
+      : resolve(dirPath)
+  )
+)
+
+module.exports = removeDirectory

package/functions/partials/removeDirectory.test.js

@@ -0,0 +1,28 @@
+const fs = require('fs')
+const removeDirectory = require('./removeDirectory')
+
+describe('removeDirectory', () => {
+  test('able to delete the remove-directory',  async () => {
+    const dirPath = 'remove-directory'
+    fs.mkdirSync(dirPath)
+    expect(fs.existsSync(dirPath)).toBeTruthy()
+    await removeDirectory(dirPath)
+    expect(fs.existsSync(dirPath)).toBeFalsy()
+  })
+
+  test('able to delete directory with sub-directories',  async () => {
+    const dirPath = 'remove-directory'
+    fs.mkdirSync(dirPath)
+    const subDir = `${dirPath}/sub`
+    fs.mkdirSync(subDir)
+    expect(fs.existsSync(subDir)).toBeTruthy()
+    await removeDirectory(dirPath)
+    expect(fs.existsSync(subDir)).toBeFalsy()
+  })
+
+  test('ends cleanly if directory does not exist',  async () => {
+    const dirPath = 'remove-directory'
+    expect(fs.existsSync(dirPath)).toBeFalsy()
+    expect(await removeDirectory(dirPath)).toBe(dirPath)
+  })
+})

package/functions/partials/tsFor.test.js

@@ -40,5 +40,5 @@ describe('tsFor', () => {
         console.error('Encountered error', error)
         done()
       })
-  }, 30000)
+  }, 60000)
 })

package/functions/partials.js

@@ -15,6 +15,7 @@ const distForSrc = require('./partials/distForSrc')
 const distSeries = require('./partials/distSeries')
 const minifyFor = require('./partials/minifyFor')
 const readmeTemplate = require('./partials/readmeTemplate')
+const removeDirectory = require('./partials/removeDirectory')
 const runOnChange = require('./partials/runOnChange')
 const tsFor = require('./partials/tsFor')
 
@@ -27,6 +28,7 @@ module.exports = {
   distSeries,
   minifyFor,
   readmeTemplate,
+  removeDirectory,
   runOnChange,
   tsFor,
 }

package/functions/partials.test.js

@@ -2,6 +2,6 @@ const partials = require('./partials')
 
 describe('partials', () => {
   test('is object with all partial exports', () => {
-    expect(Object.keys(partials).length).toBe(10)
+    expect(Object.keys(partials).length).toBe(11)
   })
 })

package/functions/test-helpers/setUp.js

@@ -1,7 +1,7 @@
 const fs = require('fs')
-const del = require('del')
 // Import the configurations and override some of them in order to direct to the temp directory.
 const gulpConfig = require('../../gulp.config.js')
+const { removeDirectory } = require('../partials')
 
 let tempDir = 'test-temp/'
 let srcPath = `${tempDir}src`
@@ -16,6 +16,7 @@ const setDefaults = (testDir = 'test-temp') => {
   tempDir = `${testDir}/`
   srcPath = `${tempDir}src`
   gulpConfig.set('browserPath', `${tempDir}browser`)
+  gulpConfig.set('cleanPaths', [srcPath])
   gulpConfig.set('distMain', `${tempDir}dist/main`)
   gulpConfig.set('distPath', `${tempDir}dist`)
   gulpConfig.set('distSearch', `${tempDir}dist/**/*.js`)
@@ -41,11 +42,11 @@ exports.gulpConfig = gulpConfig
  */
 const createTempDir = async (exists = true) => {
   if (exists) {
-    return del(tempDir)
-      .then(() => createTempDir(fs.existsSync(tempDir)))
+    return removeDirectory(tempDir)
+      .then(removedDir => createTempDir(fs.existsSync(removedDir)))
+      .catch(error => console.error('Error: ', error))
   }
-  await fs.mkdirSync(tempDir)
-  return fs.mkdirSync(srcPath)
+  return fs.mkdirSync(srcPath, { recursive: true })
 }
 
 exports.createTempDir = createTempDir
@@ -64,4 +65,4 @@ exports.beforeEach = () => createTempDir()
  * @memberOf module:testHelpers
  * @returns {Promise<*>}
  */
-exports.afterEach = async () => await del(tempDir)
+exports.afterEach = () => removeDirectory(tempDir)

package/functions/test-helpers/setUp.test.js

@@ -1,5 +1,5 @@
-import { afterEach, createTempDir, gulpConfig, setDefaults } from './setUp'
-import fs from 'fs'
+const { afterEach, createTempDir, gulpConfig, setDefaults } = require('./setUp')
+const fs = require('fs')
 
 setDefaults()
 
@@ -10,7 +10,7 @@ describe('setUp', () => {
     expect(fs.existsSync(gulpConfig.get('srcPath'))).toBeTruthy()
   })
 
-  test('able to delete the test-temp/src directory', async () => {
+  test('able to delete the test-temp/src directory',  async () => {
     expect(fs.existsSync(gulpConfig.get('srcPath'))).toBeTruthy()
     await afterEach()
     expect(fs.existsSync(gulpConfig.get('srcPath'))).toBeFalsy()

package/functions/testFull.js

@@ -3,13 +3,13 @@ const { runCLI } = require('jest')
 
 /**
  * Run all tests with jest.
+ * Configure where tests are located by using 'testPath'.
  * @function
  * @memberOf module:js-build-tools
- * @param {function} [done=null]
- * @param {Array.<string>|string} [testPath='path/config/test/files']
  * @returns {Promise<*>}
  */
-const testFull = (done = null, testPath = gulpConfig.get('testPath')) => {
+const testFull = () => {
+  let testPath = gulpConfig.get('testPath')
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
     testPath = [testPath]

package/functions/testQuick.js

@@ -3,13 +3,13 @@ const { runCLI } = require('jest')
 
 /**
  * Run the Jest tests for files which have been modified (based on git status).
+ * Configure where tests are located by using 'testPath'.
  * @function
  * @memberOf module:js-build-tools
- * @param {function} [done=null]
- * @param {Array.<string>|string} [testPath='path/config/test/files']
  * @returns {Promise<*>}
  */
-const testQuick = (done = null, testPath = gulpConfig.get('testPath')) => {
+const testQuick = () => {
+  let testPath = gulpConfig.get('testPath')
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
     testPath = [testPath]

package/gulp.config.js

@@ -112,6 +112,7 @@ try {
 const setDefaults = {
   browserName: 'default',
   browserPath: 'browser',
+  cleanPaths: ['dist', 'browser'],
   distMain: 'dist/main',
   distPath: 'dist',
   distSearch: 'dist/**/*.js',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-build-tools",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Standardised build process with gulp.",
   "main": "gulpfile.base.js",
   "scripts": {
@@ -40,7 +40,6 @@
     "babel-jest": "^29.6.4",
     "browserify": "^17.0.0",
     "core-js": "^3.32.1",
-    "del": "^6.1.1",
     "fs": "^0.0.1-security",
     "glob": "^10.3.4",
     "gulp": "^4.0.2",