@blackbyte/sugar 1.0.0-beta.1

package/dist/node/is/isCommandExists.js

@@ -0,0 +1,49 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { spawnSync } from 'child_process';
+/**
+ * @name            isCommandExists
+ * @namespace       node.is
+ * @type            Function
+ * @async
+ * @platform        node
+ * @status          stable
+ *
+ * This function allows you to check if a command exists on the system where the script is running
+ *
+ * @todo        tests
+ *
+ * @param       {String}            command         The command to check like "ls", "node", etc...
+ * @return      {Promise}                           A promise fullfiled once the check has finished with true of false as value
+ *
+ * @snippet         isCommandExists($1)
+ * await isCommandExists($1)
+ *
+ * @example         js
+ * import { isCommandExists } from '@blackbyte/sugar/is';
+ * await  isCommandExists('ls'); // => true
+ *
+ * @since       1.0.0
+ * @author      Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function isCommandExists(command) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const isWin = process.platform === 'win32';
+        const where = isWin ? 'where' : 'whereis';
+        const out = spawnSync(where + ' ' + command, [], {
+            encoding: 'utf8',
+            shell: true,
+        });
+        if (!out.stdout)
+            return false;
+        return out.stdout.replace(`${command}:`, '').trim() !== '';
+    });
+}
+//# sourceMappingURL=isCommandExists.js.map

package/dist/node/is/isCommandExists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isCommandExists.js","sourceRoot":"","sources":["../../../src/node/is/isCommandExists.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAgB,eAAe,CAC3C,OAAe;;QAEf,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1C,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,GAAG,GAAG,GAAG,OAAO,EAAE,EAAE,EAAE;YAC/C,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC9B,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;CAAA"}

package/dist/node/is/isDirectory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            isDirectory
+ * @namespace       node.is
+ * @type            Function
+ * @platform        node
+ * @status          stable
+ *
+ * This function check if the passed string path is a directory or not
+ *
+ * @param     {String}        path        The path to check
+ * @return    {Boolean}                   true if is a directory, false if not
+ *
+ * @todo      interface
+ * @todo      doc
+ * @todo      tests
+ *
+ * @snippet         isDirectory($1)
+ *
+ * @example     js
+ * import { isDirectory } from '@blackbyte/sugar/is';
+ * isDirectory('something/cool');
+ *
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TIsDirectorySettings = {
+    symlink?: boolean;
+};
+export default function isDirectory(path: string, settings?: TIsDirectorySettings): boolean;

package/dist/node/is/isDirectory.js

@@ -0,0 +1,16 @@
+import * as __fs from 'fs';
+export default function isDirectory(path, settings = {}) {
+    settings = Object.assign({ symlink: true }, settings);
+    let isMatching = __fs.existsSync(path);
+    if (!isMatching)
+        return false;
+    if (settings.symlink && __fs.lstatSync(path).isSymbolicLink()) {
+        const realPath = __fs.realpathSync(path);
+        isMatching = isMatching && __fs.lstatSync(realPath).isDirectory();
+    }
+    else {
+        isMatching = isMatching && __fs.lstatSync(path).isDirectory();
+    }
+    return isMatching;
+}
+//# sourceMappingURL=isDirectory.js.map

package/dist/node/is/isDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDirectory.js","sourceRoot":"","sources":["../../../src/node/is/isDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,IAAI,CAAC;AA+B3B,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,IAAY,EACZ,WAAiC,EAAE;IAEnC,QAAQ,mBACN,OAAO,EAAE,IAAI,IACV,QAAQ,CACZ,CAAC;IAEF,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/node/is/isFile.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @name            isFile
+ * @namespace       node.is
+ * @type            Function
+ * @platform        node
+ * @status          stable
+ *
+ * This function check if the passed string path is a file or not
+ *
+ * @param     {String}        path        The path to check
+ * @return    {Boolean}                   true if is a file, false if not
+ *
+ * @todo      tests
+ *
+ * @snippet         isFile($1);
+ *
+ * @example     js
+ * import { isFile } from '@blackbyte/sugar/is';
+ * isFile('something/cool');
+ *
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TIsFileSettings = {
+    symlink?: boolean;
+};
+export default function isFile(path: string, settings?: TIsFileSettings): boolean;

package/dist/node/is/isFile.js

@@ -0,0 +1,16 @@
+import * as __fs from 'fs';
+export default function isFile(path, settings = {}) {
+    settings = Object.assign({ symlink: true }, settings);
+    let isMatching = __fs.existsSync(path);
+    if (!isMatching)
+        return false;
+    if (settings.symlink && __fs.lstatSync(path).isSymbolicLink()) {
+        const realPath = __fs.realpathSync(path);
+        isMatching = isMatching && __fs.lstatSync(realPath).isFile();
+    }
+    else {
+        isMatching = isMatching && __fs.lstatSync(path).isFile();
+    }
+    return isMatching;
+}
+//# sourceMappingURL=isFile.js.map

package/dist/node/is/isFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isFile.js","sourceRoot":"","sources":["../../../src/node/is/isFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,IAAI,CAAC;AA8B3B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,IAAY,EAAE,WAA4B,EAAE;IACzE,QAAQ,mBACN,OAAO,EAAE,IAAI,IACV,QAAQ,CACZ,CAAC;IAEF,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/node/is/isFolder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @name            isFfolder
+ * @namespace       node.is
+ * @type            Function
+ * @platform        node
+ * @status          stable
+ *
+ * This function check if the passed string path is a folder or not
+ *
+ * @param     {String}        path        The path to check
+ * @return    {Boolean}                   true if is a folder, false if not
+ *
+ * @todo      tests
+ *
+ * @snippet         isFolder($1)
+ *
+ * @example     js
+ * import { isfolder } from '@blackbyte/sugar/is';
+ * isfolder('something/cool');
+ *
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TIsFolderSettings = {
+    symlink?: boolean;
+};
+export default function isfolder(path: string, settings?: TIsFolderSettings): boolean;

package/dist/node/is/isFolder.js

@@ -0,0 +1,16 @@
+import * as __fs from 'fs';
+export default function isfolder(path, settings = {}) {
+    settings = Object.assign({ symlink: true }, settings);
+    let isMatching = __fs.existsSync(path);
+    if (!isMatching)
+        return false;
+    if (settings.symlink && __fs.lstatSync(path).isSymbolicLink()) {
+        const realPath = __fs.realpathSync(path);
+        isMatching = isMatching && __fs.lstatSync(realPath).isDirectory();
+    }
+    else {
+        isMatching = isMatching && __fs.lstatSync(path).isDirectory();
+    }
+    return isMatching;
+}
+//# sourceMappingURL=isFolder.js.map

package/dist/node/is/isFolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isFolder.js","sourceRoot":"","sources":["../../../src/node/is/isFolder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,IAAI,CAAC;AA6B3B,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,IAAY,EACZ,WAA8B,EAAE;IAEhC,QAAQ,mBACN,OAAO,EAAE,IAAI,IACV,QAAQ,CACZ,CAAC;IAEF,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/node/is/isSymlink.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name            isSymlink
+ * @namespace       node.is
+ * @type            Function
+ * @platform        node
+ * @status          stable
+ *
+ * This function check if the passed string path is a sySlink or not
+ *
+ * @param     {String}        path        The path to check
+ * @return    {Boolean}                   true if is a sySlink, false if not
+ *
+ * @todo      tests
+ *
+ * @snippet         isSymlink($1)
+ *
+ * @example     js
+ * import { isSymlink } from '@blackbyte/sugar/is';
+ * isSymlink('something/cool');
+ *
+ * @todo        Tests
+ *
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function isSymlink(path: string): boolean;

package/dist/node/is/isSymlink.js

@@ -0,0 +1,30 @@
+import * as __fs from 'fs';
+/**
+ * @name            isSymlink
+ * @namespace       node.is
+ * @type            Function
+ * @platform        node
+ * @status          stable
+ *
+ * This function check if the passed string path is a sySlink or not
+ *
+ * @param     {String}        path        The path to check
+ * @return    {Boolean}                   true if is a sySlink, false if not
+ *
+ * @todo      tests
+ *
+ * @snippet         isSymlink($1)
+ *
+ * @example     js
+ * import { isSymlink } from '@blackbyte/sugar/is';
+ * isSymlink('something/cool');
+ *
+ * @todo        Tests
+ *
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function isSymlink(path) {
+    return __fs.existsSync(path) && __fs.lstatSync(path).isSymbolicLink();
+}
+//# sourceMappingURL=isSymlink.js.map

package/dist/node/is/isSymlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSymlink.js","sourceRoot":"","sources":["../../../src/node/is/isSymlink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;AACxE,CAAC"}

package/dist/node/package/_exports.d.ts

@@ -0,0 +1,6 @@
+import addPackageDependencies from './addPackageDependencies.js';
+import nodeModulesDir from './nodeModulesDir.js';
+import packageDir from './packageDir.js';
+import packageJsonSync from './packageJsonSync.js';
+import packageRootDir from './packageRootDir.js';
+export { addPackageDependencies as __addPackageDependencies, nodeModulesDir as __nodeModulesDir, packageDir as __packageDir, packageJsonSync as __packageJsonSync, packageRootDir as __packageRootDir, addPackageDependencies, nodeModulesDir, packageDir, packageJsonSync, packageRootDir, };

package/dist/node/package/_exports.js

@@ -0,0 +1,7 @@
+import addPackageDependencies from './addPackageDependencies.js';
+import nodeModulesDir from './nodeModulesDir.js';
+import packageDir from './packageDir.js';
+import packageJsonSync from './packageJsonSync.js';
+import packageRootDir from './packageRootDir.js';
+export { addPackageDependencies as __addPackageDependencies, nodeModulesDir as __nodeModulesDir, packageDir as __packageDir, packageJsonSync as __packageJsonSync, packageRootDir as __packageRootDir, addPackageDependencies, nodeModulesDir, packageDir, packageJsonSync, packageRootDir, };
+//# sourceMappingURL=_exports.js.map

package/dist/node/package/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/node/package/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,6BAA6B,CAAC;AACjE,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,sBAAsB,IAAI,wBAAwB,EAClD,cAAc,IAAI,gBAAgB,EAClC,UAAU,IAAI,YAAY,EAC1B,eAAe,IAAI,iBAAiB,EACpC,cAAc,IAAI,gBAAgB,EAClC,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,GACf,CAAC"}

package/dist/node/package/addPackageDependencies.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @name                    addPackageDependencies
+ * @namespace               node.package
+ * @type                    Function
+ * @platform                node
+ * @status                  beta
+ * @async
+ *
+ * This function allows you to add some dependencies to a package.json file
+ *
+ * @param       {Object}                              deps                      The dependencies to add
+ * @param       {TAddPackageDependenciesSettings}     [settings={}]             Some settings to configure your process
+ * @return      {Promise<any>}                                                  A promise with the package.json content as object
+ *
+ * @setting     {String}        [cwd=process.cwd()]       The directory in which you want to start the research
+ * @setting     {Boolean}       [dev=false]               Specify if you want to add the dependencies to the devDependencies
+ * @setting     {Boolean}       [global=false]            Specify if you want to add the dependencies to the global package.json
+ * @setting     {Boolean}       [install=false]           Specify if you want to install the dependencies after adding them
+ * @setting     {Boolean}       [override=false]          Specify if you want to override the dependencies if they already exists
+ *
+ * @snippet         addPackageDependencies($1, $2)
+ *
+ * @example         js
+ * import { addPackageDependencies } from '@blackbyte/sugar/package`;
+ * addPackageDependencies('lodash');
+ *
+ * @since       1.0.0
+ * @author      Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TAddPackageDependenciesSettings = {
+    cwd: string;
+    dev: boolean;
+    global: boolean;
+    install: boolean;
+    override: boolean;
+};
+export default function addPackageDependencies(deps: Record<string, string>, settings: Partial<TAddPackageDependenciesSettings>): any;

package/dist/node/package/addPackageDependencies.js

@@ -0,0 +1,62 @@
+import childProcess from 'child_process';
+import fs from 'fs';
+import * as semver from 'semver';
+import readJsonSync from '../fs/readJsonSync.js';
+import writeJsonSync from '../fs/writeJsonSync.js';
+import packageRootDir from './packageRootDir.js';
+export default function addPackageDependencies(deps, settings) {
+    settings = Object.assign({ cwd: process.cwd(), dev: false, global: false, install: false }, (settings !== null && settings !== void 0 ? settings : {}));
+    return new Promise((resolve, reject) => {
+        // get the package.json file path
+        const packageJsonPath = `${packageRootDir(settings.cwd)}/package.json`;
+        if (!fs.existsSync(packageJsonPath)) {
+            throw new Error(`No package.json file found at "<yellow>${packageJsonPath}</yellow>"`);
+        }
+        // read the current package.json file
+        const packageJson = readJsonSync(packageJsonPath);
+        const depProp = settings.dev
+            ? 'devDependencies'
+            : settings.global
+                ? 'globalDependencies'
+                : 'dependencies';
+        // loop on the deps to add
+        for (let [name, version] of Object.entries(deps)) {
+            // make sure requested stack exists
+            if (!packageJson[depProp]) {
+                packageJson[depProp] = {};
+            }
+            // if the dependency des not exists, add it
+            if (!packageJson[depProp][name]) {
+                packageJson[depProp][name] = version;
+                continue;
+            }
+            // if override
+            if (settings.override) {
+                packageJson[depProp][name] = version;
+                continue;
+            }
+            const componentVersion = semver.minVersion(version), projectVersion = semver.coerce(packageJson[depProp][name]);
+            // check if the dependency satifdy the semver range
+            if (componentVersion &&
+                projectVersion &&
+                componentVersion.major < projectVersion.major) {
+                throw new Error(`The dependency "<yellow>${name}</yellow>"@<magenta>${version}</magenta> that you want to add already exists in the package.json and does not satisfy the version <magenta>${packageJson[depProp][name]}</magenta> required by the project...`);
+            }
+        }
+        // write the new package.json file
+        writeJsonSync(packageJsonPath, packageJson);
+        // check if we need to install the dependencies
+        if (settings.install) {
+            const res = childProcess.spawnSync('npm install', [], {
+                cwd: packageRootDir(settings.cwd),
+                shell: true,
+            });
+            if (res.stderr.toString() !== '') {
+                throw new Error(res.stderr.toString());
+            }
+        }
+        // resolve the promise with the new package.json content
+        resolve(packageJson);
+    });
+}
+//# sourceMappingURL=addPackageDependencies.js.map

package/dist/node/package/addPackageDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addPackageDependencies.js","sourceRoot":"","sources":["../../../src/node/package/addPackageDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAwCjD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,IAA4B,EAC5B,QAAkD;IAElD,QAAQ,mBACN,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAClB,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,KAAK,EACb,OAAO,EAAE,KAAK,IACX,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,iCAAiC;QACjC,MAAM,eAAe,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;QAEvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,0CAA0C,eAAe,YAAY,CACtE,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG;YAC1B,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,QAAQ,CAAC,MAAM;gBACf,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,cAAc,CAAC;QAErB,0BAA0B;QAC1B,KAAK,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,mCAAmC;YACnC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC;YAED,2CAA2C;YAC3C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,cAAc;YACd,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EACjD,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAE7D,mDAAmD;YACnD,IACE,gBAAgB;gBAChB,cAAc;gBACd,gBAAgB,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,EAC7C,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,uBAAuB,OAAO,gHAAgH,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,uCAAuC,CAC/O,CAAC;YACJ,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAE5C,+CAA+C;QAC/C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE;gBACpD,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACjC,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,OAAO,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/node/package/nodeModulesDir.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @name                    nodeModulesDir
+ * @namespace               node.package
+ * @type                    Function
+ * @platform                node
+ * @status                  beta
+ *
+ * This function simply returns the "node_modules" directory path
+ *
+ * @param       {TNodeModulesDirSettings}      [settings={}]        Some settings to configure your process
+ * @return      {String}                                            The package path
+ *
+ * @setting     {String}        [cwd=process.cwd()]      The directory in which you want to start the research
+ * @setting     {Boolean}       [monorepo=false]         Specify if you are in a monorepo context
+ * @setting     {Boolean}       [checkExistence=true]    Specify if you want to check if the vendor dir exists
+ *
+ * @snippet         nodeModulesDir($1)
+ *
+ * @example         js
+ * import { nodeModulesDir } from '@blackbyte/sugar/composer`;
+ * nodeModulesDir('lodash');
+ *
+ * @since       1.0.0
+ * @author      Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TNodeModulesDirSettings = {
+    cwd: string;
+    monorepo: boolean;
+    checkExistence: boolean;
+};
+export default function nodeModulesDir(settings?: Partial<TNodeModulesDirSettings>): any;

package/dist/node/package/nodeModulesDir.js

@@ -0,0 +1,13 @@
+import fs from 'fs';
+import packageRootDir from './packageRootDir.js';
+export default function nodeModulesDir(settings) {
+    const set = Object.assign({ cwd: process.cwd(), monorepo: false, checkExistence: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    let nodeModulesDir = `${packageRootDir(set.cwd, {
+        highest: set.monorepo,
+    })}/node_modules`;
+    if (set.checkExistence && !fs.existsSync(nodeModulesDir)) {
+        throw new Error(`The NPM node_modules directory "<yellow>${nodeModulesDir}</yellow>" does not exists...`);
+    }
+    return nodeModulesDir;
+}
+//# sourceMappingURL=nodeModulesDir.js.map

package/dist/node/package/nodeModulesDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeModulesDir.js","sourceRoot":"","sources":["../../../src/node/package/nodeModulesDir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAiCjD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,QAA2C;IAE3C,MAAM,GAAG,GAAG,gBACV,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAClB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,IAAI,IACjB,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,IAAI,cAAc,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE;QAC9C,OAAO,EAAE,GAAG,CAAC,QAAQ;KACtB,CAAC,eAAe,CAAC;IAElB,IAAI,GAAG,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,2CAA2C,cAAc,+BAA+B,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/node/package/packageDir.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @name                    packageDir
+ * @namespace               node.package
+ * @type                    Function
+ * @platform                node
+ * @status                  beta
+ *
+ * This function simply take a package name as parameter, and return the corresponding
+ * package direcory path
+ *
+ * @param       {String}                  [nameOrPath=process.cwd()]        the package name or path wanted
+ * @param       {TPackageDirSettings}     [settings={}]                     Some settings to configure your process
+ * @return      {String}                                                    The package path
+ *
+ * @setting     {String}        [cwd=process.cwd()]      The directory in which you want to start the research
+ * @setting     {Boolean}       [monorepo=false]         Specify if you are in a monorepo context
+ * @setting     {Boolean}       [checkExistence=true]    Specify if you want to check if the vendor dir exists
+ *
+ * @snippet         packageDir($1, $2)
+ *
+ * @example         js
+ * import { packageDir } from '@blackbyte/sugar/package`;
+ * packageDir('lodash');
+ *
+ * @todo        Implement a cache strategy to avoid making same process again and again
+ *
+ * @since       1.0.0
+ * @author      Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TPackageDirSettings = {
+    cwd: string;
+    monorepo: boolean;
+    checkExistence: boolean;
+};
+export default function packageDir(nameOrPath: string, settings: Partial<TPackageDirSettings>): any;

package/dist/node/package/packageDir.js

@@ -0,0 +1,21 @@
+import fs from 'fs';
+import path from 'path';
+import nodeModulesDir from './nodeModulesDir.js';
+export default function packageDir(nameOrPath, settings) {
+    settings = Object.assign({ cwd: process.cwd(), monorepo: false, checkExistence: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    // absolute path
+    if (fs.existsSync(`${nameOrPath}/package.json`)) {
+        return path.resolve(nameOrPath);
+    }
+    const vendorDir = nodeModulesDir(settings);
+    // current package dir "."
+    if (nameOrPath === '.') {
+        return path.resolve(`${vendorDir}/../`);
+    }
+    if (settings.checkExistence &&
+        !fs.existsSync(`${vendorDir}/${nameOrPath}/package.json`)) {
+        throw new Error(`The NPM package "<yellow>${nameOrPath}</yellow>" seems to not exists...`);
+    }
+    return `${vendorDir}/${nameOrPath}`;
+}
+//# sourceMappingURL=packageDir.js.map

package/dist/node/package/packageDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageDir.js","sourceRoot":"","sources":["../../../src/node/package/packageDir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAsCjD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,UAAkB,EAClB,QAAsC;IAEtC,QAAQ,mBACN,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAClB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,IAAI,IACjB,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,gBAAgB;IAChB,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,UAAU,eAAe,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C,0BAA0B;IAC1B,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IACE,QAAQ,CAAC,cAAc;QACvB,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,SAAS,IAAI,UAAU,eAAe,CAAC,EACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,mCAAmC,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;AACtC,CAAC"}

package/dist/node/package/packageJsonSync.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @name                    packageJsonSync
+ * @namespace               node.package
+ * @type                    Function
+ * @platform                node
+ * @status                  beta
+ *
+ * This function simply take a package name (or "." for the current package) as parameter, and return the corresponding
+ * package.json JSON content
+ *
+ * @param       {String}                          [nameOrPath=process.cwd()]            The package name or path wanted
+ * @param       {TComposerVendorDirSettings}      [settings={}]                         Some settings to configure your process
+ * @return      {JSON}                                                                  The package.json content
+ *
+ * @setting     {String}        [cwd=process.cwd()]      The directory in which you want to start the research
+ * @setting     {Boolean}       [monorepo=false]         Specify if you are in a monorepo context
+ * @setting     {Boolean}       [checkExistence=true]    Specify if you want to check if the vendor dir exists
+ *
+ * @snippet         packageJsonSync($1)
+ *
+ * @example         js
+ * import { packageJsonSync } from '@blackbyte/sugar/package`;
+ * packageJsonSync('blackbyte/sugar');
+ *
+ * @todo        Implement a cache strategy to avoid making same process again and again
+ *
+ * @since       1.0.0
+ * @author      Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TPackageJsonSyncSettings = {
+    cwd: string;
+    monorepo: boolean;
+    checkExistence: boolean;
+};
+export default function packageJsonSync(nameOrPath: string, settings?: Partial<TPackageJsonSyncSettings>): any;

package/dist/node/package/packageJsonSync.js

@@ -0,0 +1,8 @@
+import fs from 'fs';
+import __packageDir from './packageDir.js';
+export default function packageJsonSync(nameOrPath, settings) {
+    settings = Object.assign({ cwd: process.cwd(), monorepo: false, checkExistence: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    const packageDir = __packageDir(nameOrPath, settings);
+    return JSON.parse(fs.readFileSync(`${packageDir}/package.json`, 'utf8'));
+}
+//# sourceMappingURL=packageJsonSync.js.map

package/dist/node/package/packageJsonSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageJsonSync.js","sourceRoot":"","sources":["../../../src/node/package/packageJsonSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAsC3C,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,UAAkB,EAClB,QAA4C;IAE5C,QAAQ,mBACN,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAClB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,IAAI,IACjB,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,UAAU,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/node/package/packageRootDir.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @name                    packageRootDir
+ * @namespace               node.path
+ * @type                    Function
+ * @platform                node
+ * @status                  beta
+ *
+ * Return the path to either the first finded package root going up the folders, or the highest package root finded
+ *
+ * @feature         Support file path as input
+ * @feature         Allows you to specify if you want the highest package.json founded using the ```highest``` parameter
+ *
+ * @param           {String}              [from=process.cwd()]        Specify from where the research has to be done
+ * @param           {Boolean}             [settings={}]               Some settings to configure the research
+ * @return          {String}                                          The finded package path or false if not finded
+ *
+ * @setting         {Boolean}           [highest=false]                                     Specify if you want the highest package possible
+ * @setting         {Number}            [upCount=undefined]                                 Specify a number of packages to go up. Cannot be used alongside the `highest` setting
+ * @setting         {String[]}          [requiredProperties=['name','version']]             Specify some required properties that MUST be present in the package.json to be considered as a valid package
+ *
+ * @snippet         packageRootDir()
+ *
+ * @example         js
+ * import { packageRootDir } from '@blackbyte/sugar/path';
+ * const root = packageRootDir();
+ *
+ * @see       https://www.npmjs.com/package/find-package-json
+ * @since     1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TPackageRootSettings = {
+    highest: boolean;
+    upCount: number | undefined;
+    requiredProperties: string[];
+};
+export default function packageRootDir(from?: string, settings?: Partial<TPackageRootSettings>): any;