forceios 9.2.0

package/shared/createHelper.js

@@ -0,0 +1,368 @@
+/*
+ * Copyright (c) 2016-present, salesforce.com, inc.
+ * All rights reserved.
+ * Redistribution and use of this software in source and binary forms, with or
+ * without modification, are permitted provided that the following conditions
+ * are met:
+ * - Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of salesforce.com, inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission of salesforce.com, inc.
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+// Dependencies
+var path = require('path'),
+    SDK = require('./constants'),
+    utils = require('./utils'),
+    configHelper = require('./configHelper'),
+    prepareTemplate = require('./templateHelper').prepareTemplate,
+    getSDKTemplateURI = require('./templateHelper').getSDKTemplateURI,
+    fs = require('fs');
+
+// Constant
+var SERVER_PROJECT_DIR = 'server';    
+
+//
+// Helper for native application creation
+//
+function createNativeApp(config) {
+
+    // Copying template to projectDir
+    utils.copyFile(config.templateLocalPath, config.projectDir);
+
+    // Run prepare function of template
+    var prepareResult = prepareTemplate(config, config.projectDir);
+
+    if (config.platform === 'ios' && config.apptype === 'react_native') {
+        // Use legacy build
+        useLegacyBuild(config, 'ios');
+    }
+
+    // Cleanup
+    utils.removeFile(path.join(config.projectDir, 'template.js'));
+
+    // Done
+    return prepareResult;
+}
+
+//
+// Helper for hybrid application creation
+//
+function createHybridApp(config) {
+
+    // Create app with cordova
+    utils.runProcessThrowError('cordova create "' + config.projectDir + '" ' + config.packagename + ' ' + config.appname);
+    utils.runProcessThrowError('npm install shelljs@0.7.0', config.projectDir);
+
+    for (var platform of config.platform.split(',')) {
+        utils.runProcessThrowError('cordova platform add ' + platform + '@' + SDK.tools.cordova.platformVersion[platform], config.projectDir);
+    }
+    utils.runProcessThrowError('cordova plugin add ' + config.cordovaPluginRepoUri + ' --force', config.projectDir);
+
+    // Web directory - the home for the template
+    var webDir = path.join(config.projectDir, 'www');
+    
+    // Remove the default Cordova app.
+    utils.removeFile(webDir);
+
+    // Copying template to www
+    utils.copyFile(config.templateLocalPath, webDir);
+
+    // Run prepare function of template
+    var prepareResult = prepareTemplate(config, webDir);
+
+    // Cleanup
+    utils.removeFile(path.join(webDir, 'template.js'));
+
+    // If template includes server side files
+    // Create a fresh sfdx project
+    // Add cordova js and plugins at static resources
+    // Merge files from template into it
+    if (utils.dirExists(path.join(webDir, SERVER_PROJECT_DIR))) {
+        config.serverDir = path.join(config.projectDir, SERVER_PROJECT_DIR)
+        utils.runProcessThrowError('sfdx force:project:create -n ' + SERVER_PROJECT_DIR, config.projectDir);
+
+        // Copy cordova js to static resources
+        for (var platform of config.platform.split(',')) {
+            var cordovaStaticResourcesDir = path.join(config.serverDir, 'force-app', 'main', 'default', 'staticresources', 'cordova' + platform);
+            utils.mkDirIfNeeded(cordovaStaticResourcesDir);
+            utils.copyFile(path.join(config.projectDir, 'platforms', platform, 'platform_www', '*'), cordovaStaticResourcesDir);
+        }
+
+        // Merge server files from templates
+        utils.mergeFile(path.join(webDir, SERVER_PROJECT_DIR), config.serverDir);
+
+        // Remove server files from www
+        utils.removeFile(path.join(webDir, SERVER_PROJECT_DIR));
+    }
+
+    // Run cordova prepare
+    utils.runProcessThrowError('cordova prepare', config.projectDir);
+
+    if (config.platform === 'ios') {
+        // Use legacy build
+        useLegacyBuild(config, path.join('platforms', 'ios'));
+
+        // Removing libCordova.a from build (it causes issues e.g. CDVWKWebViewEngine won't register as plugin because it won't be recognized as a kind of CDVPlugin)
+        utils.logInfo('Updating xcode project file');
+        var xcodeProjectFile = path.join(config.projectDir,'platforms', 'ios', config.appname + '.xcodeproj', 'project.pbxproj')
+        var xcodeProjectFileContent = fs.readFileSync(xcodeProjectFile, 'utf8');
+        var newXcodeProjectFileContent = xcodeProjectFileContent.split('\n').filter(line => line.indexOf('libCordova.a in Frameworks') == -1).join('\n');
+        fs.writeFileSync(xcodeProjectFile, newXcodeProjectFileContent);
+        utils.logInfo('Updated  xcode project file');
+    }
+   
+    // Done
+    return prepareResult;
+
+}
+
+//
+// Use legacy build system in XCode
+//
+function useLegacyBuild(config, iosSubDir) {
+    var xcSettingsDir = path.join(config.projectDir, iosSubDir, config.appname + '.xcworkspace', 'xcshareddata')
+    var xcSettingsFile = path.join(xcSettingsDir, 'WorkspaceSettings.xcsettings');
+    var plistFileContent = '<?xml version="1.0" encoding="UTF-8"?>\n' +
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n' +
+        '<plist version="1.0">\n' + 
+        '<dict>\n'  +
+        '<key>BuildSystemType</key>\n' + 
+        '<string>Original</string>\n' +
+        '<key>DisableBuildSystemDeprecationDiagnostic</key>\n' + 
+	    '<true/>\n' +
+        '</dict>\n' + 
+        '</plist>\n';
+    utils.logInfo('Creating WorkspaceSettings.xcsettings for project. Setting the BuildSystemType to original in ' + xcSettingsFile);
+    utils.mkDirIfNeeded(xcSettingsDir)
+    fs.writeFileSync(xcSettingsFile,plistFileContent,'utf8');
+    utils.logInfo('Created WorkspaceSettings.xcsettings for project ' + config.appname);
+}
+
+//
+// Print details
+//
+function printDetails(config) {
+    // Printing out details
+    var details = ['Creating ' + config.platform.replace(',', ' and ') + ' ' + config.apptype + ' application using Salesforce Mobile SDK',
+                        '  with app name:        ' + config.appname,
+                        '       package name:    ' + config.packagename,
+                        '       organization:    ' + config.organization,
+                        '',
+                        '  in:                   ' + config.projectPath,
+                        '',
+                        '  from template repo:   ' + config.templaterepouri
+                  ];
+
+    if (config.templatepath) {
+        details = details.concat(['       template path:   ' + config.templatepath]);
+    }
+            
+
+    // Hybrid extra details
+    if (config.apptype.indexOf('hybrid') >= 0) {
+        if (config.apptype === 'hybrid_remote') {
+            details = details.concat(['       start page:      ' + config.startpage]);
+        }
+
+        details = details.concat(['       plugin repo:     ' + config.cordovaPluginRepoUri]);
+    }
+            
+    utils.logParagraph(details);
+}
+
+//
+// Print next steps
+//
+function printNextSteps(ide, projectPath, result) {
+    var workspacePath = path.join(projectPath, result.workspacePath);
+    var bootconfigFile =  path.join(projectPath, result.bootconfigFile);
+
+    // Printing out next steps
+    utils.logParagraph(['Next steps' + (result.platform ? ' for ' + result.platform : '') + ':',
+                        '',
+                        'Your application project is ready in ' + projectPath + '.',
+                        'To use your new application in ' + ide + ', do the following:', 
+                        '   - open ' + workspacePath + ' in ' + ide, 
+                        '   - build and run', 
+                        'Before you ship, make sure to plug your OAuth Client ID and Callback URI,',
+                        'and OAuth Scopes into ' + bootconfigFile,
+                       ]);
+
+};    
+
+//
+// Print next steps for server project if present
+//
+function printNextStepsForServerProjectIfNeeded(projectPath) {
+    var serverProjectPath = path.join(projectPath, SERVER_PROJECT_DIR);
+    var hasServerProject = utils.dirExists(serverProjectPath);
+        // Extra steps if there is a server project
+    if (hasServerProject) {
+        utils.logParagraph(['Your application also has a server project in ' + serverProjectPath + '.',
+                            'Make sure to deploy it to your org before running your application.',
+                            '',
+                            'From ' + projectPath + ' do the following to setup a scratch org, push the server code:',
+                            '   - sfdx force:org:create -f server/config/project-scratch-def.json -a MyOrg',
+                            '   - cd server',
+                            '   - sfdx force:source:push -u MyOrg',
+                            'You also need a password to login to the scratch org from the mobile app:',
+                            '   - sfdx force:user:password:generate -u MyOrg'                            
+                            ]);
+    }
+
+
+}
+
+//
+// Check tools
+//
+function checkTools(toolNames) {
+    try {
+        utils.log("Checking tools");
+        for (var toolName of toolNames) {
+            utils.checkToolVersion(SDK.tools[toolName].checkCmd, SDK.tools[toolName].minVersion, SDK.tools[toolName].maxVersion);
+        }
+    }
+    catch (error) {
+        utils.logError('Missing tools\n', error);
+        process.exit(1);
+    }
+}
+
+//
+// Create app - check tools, read config then actually create app
+//
+function createApp(forcecli, config) {
+
+    // Can't target ios or run pod if not on a mac
+    if (process.platform != 'darwin') {
+        forcecli.platforms = forcecli.platforms.filter(p=>p!='ios');
+        forcecli.toolNames = forcecli.toolNames.filter(t=>t!='pod');
+
+        if (forcecli.platforms.length == 0) {
+            utils.logError('You can only run ' + forcecli.name + ' on a Mac');
+            process.exit(1);
+        }
+    }
+
+    // Check tools
+    checkTools(forcecli.toolNames);
+
+    if (config === undefined) {
+        // Read parameters from command line
+        configHelper.readConfig(process.argv, forcecli, function(config) { actuallyCreateApp(forcecli, config); });
+    }
+    else {
+        // Use parameters passed through
+        actuallyCreateApp(forcecli, config);
+    }
+}
+
+//
+// Actually create app
+//
+function actuallyCreateApp(forcecli, config) {
+    try {
+        // Adding platform
+        if (forcecli.platforms.length == 1) {
+            config.platform = forcecli.platforms[0];
+        }
+
+        // Adding app type
+        if (forcecli.appTypes.length == 1 || config.apptype === undefined || config.apptype === '') {
+            config.apptype = forcecli.appTypes[0];
+        }
+
+        // Setting log level
+        if (config.verbose) {
+            utils.setLogLevel(utils.LOG_LEVELS.DEBUG);
+        }
+        else {
+            utils.setLogLevel(utils.LOG_LEVELS.INFO);
+        }
+
+        // Computing projectDir
+        config.projectDir = config.outputdir ? path.resolve(config.outputdir) : path.join(process.cwd(),config.appname)
+        config.projectPath = path.relative(process.cwd(), config.projectDir);
+
+        // Adding version
+        config.version = SDK.version;
+        
+        // Figuring out template repo uri and path
+        if (config.templaterepouri) {
+            if (!config.templaterepouri.startsWith("https://")) {
+                // Given a Mobile SDK template name
+                config.templatepath = config.templaterepouri;
+                config.templaterepouri = SDK.templatesRepoUri;
+            } else {
+                // Given a full URI
+                var templateUriParsed = utils.separateRepoUrlPathBranch(config.templaterepouri);
+                config.templaterepouri = templateUriParsed.repo + '#' + templateUriParsed.branch;
+                config.templatepath = templateUriParsed.path;
+            }
+        }
+        else {
+            config.templaterepouri = SDK.templatesRepoUri;
+            config.templatepath = forcecli.appTypesToPath[config.apptype];
+        }
+
+        // Creating tmp dir for template clone
+        var tmpDir = utils.mkTmpDir();
+
+        // Cloning template repo
+        var repoDir = utils.cloneRepo(tmpDir, config.templaterepouri);
+        config.templateLocalPath = path.join(repoDir, config.templatepath);
+
+        // Getting apptype from template
+        config.apptype = require(path.join(config.templateLocalPath, 'template.js')).appType;
+
+        var isNative = config.apptype.indexOf('native') >= 0;
+
+        // Adding hybrid only config
+        if (!isNative) {
+            config.cordovaPluginRepoUri = config.pluginrepouri || SDK.tools.cordova.pluginRepoUri;
+        }
+
+        // Print details
+        printDetails(config);
+
+        // Creating application
+        var results = isNative ? createNativeApp(config) : createHybridApp(config);
+
+        // Cleanup
+        utils.removeFile(tmpDir);
+        
+        // Printing next steps
+        if (!(results instanceof Array)) { results = [results] };
+        for (var result of results) {
+            var ide = SDK.ides[result.platform || config.platform.split(',')[0]];
+            printNextSteps(ide, config.projectPath, result);
+        }
+        printNextStepsForServerProjectIfNeeded(config.projectPath);
+
+    }
+    catch (error) {
+        utils.logError(forcecli.name + ' failed\n', error);
+        process.exit(1);
+    }
+}
+
+module.exports = {
+    createApp
+};

package/shared/example.userstore.json

@@ -0,0 +1,24 @@
+{
+  "soups": [
+    {
+      "soupName": "userSoup1",
+      "indexes": [
+        { "path": "stringField1", "type": "string"},
+        { "path": "integerField1", "type": "integer"},
+        { "path": "floatingField1", "type": "floating"},
+        { "path": "json1Field1", "type": "json1"},
+        { "path": "ftsField1", "type": "full_text"}
+      ]
+    },
+    {
+      "soupName": "userSoup2",
+      "indexes": [
+        { "path": "stringField2", "type": "string"},
+        { "path": "integerField2", "type": "integer"},
+        { "path": "floatingField2", "type": "floating"},
+        { "path": "json1Field2", "type": "json1"},
+        { "path": "ftsField2", "type": "full_text"}
+      ]
+    }
+  ]
+}

package/shared/example.usersyncs.json

@@ -0,0 +1,190 @@
+{
+  "syncs": [
+    {
+      "syncName": "soqlSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"soql",
+        "query":"SELECT Id, Name, LastModifiedDate FROM Account"
+      },
+      "options": {
+        "mergeMode":"OVERWRITE"
+      }
+    },
+    {
+      "syncName": "soqlSyncDownWithBatchSize",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"soql",
+        "query":"SELECT Id, Name, LastModifiedDate FROM Account",
+        "maxBatchSize": 200
+      },
+      "options": {
+        "mergeMode":"OVERWRITE"
+      }
+    },
+    {
+      "syncName": "soslSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"sosl",
+        "query":"FIND {Joe} IN NAME FIELDS RETURNING Account"
+      },
+      "options": {
+        "mergeMode":"LEAVE_IF_CHANGED"
+      }
+    },
+    {
+      "syncName": "mruSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"mru",
+        "sobjectType": "Account",
+        "fieldlist": ["Name", "Description"]
+      },
+      "options": {
+        "mergeMode":"OVERWRITE"
+      }
+    },
+    {
+      "syncName": "refreshSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"refresh",
+        "sobjectType": "Account",
+        "fieldlist": ["Name", "Description"],
+        "soupName": "accounts"
+      },
+      "options": {
+        "mergeMode":"LEAVE_IF_CHANGED"
+      }
+    },
+    {
+      "syncName": "layoutSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"layout",
+        "sobjectType": "Account",
+        "formFactor": "Medium",
+        "layoutType": "Compact",
+        "mode": "Edit"
+      },
+      "options": {
+        "mergeMode":"OVERWRITE"
+      }
+    },
+    {
+      "syncName": "metadataSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "type":"metadata",
+        "sobjectType": "Account"
+      },
+      "options": {
+        "mergeMode":"LEAVE_IF_CHANGED"
+      }
+    },
+    {
+      "syncName": "parentChildrenSyncDown",
+      "syncType": "syncDown",
+      "soupName": "accounts",
+      "target": {
+        "parent" : {
+          "idFieldName" : "IdX",
+          "sobjectType" : "Account",
+          "modificationDateFieldName" : "LastModifiedDateX",
+          "soupName" : "accounts"
+        },
+        "parentFieldlist" : ["IdX", "Name", "Description"],
+        "children" : {
+          "parentIdFieldName" : "AccountId",
+          "idFieldName" : "IdY",
+          "sobjectType" : "Contact",
+          "modificationDateFieldName" : "LastModifiedDateY",
+          "soupName" : "contacts",
+          "sobjectTypePlural" : "Contacts"
+        },
+        "childrenFieldlist" : [
+          "LastName",
+          "AccountId"
+        ],
+        "relationshipType" : "MASTER_DETAIL",
+        "parentSoqlFilter" : "NameX like 'James%'",
+        "type" : "parent_children"
+      },
+      "options": {
+        "mergeMode": "OVERWRITE"
+      }
+    },
+    {
+      "syncName": "noBatchSyncUp",
+      "syncType": "syncUp",
+      "soupName": "accounts",
+      "target": {
+        "iOSImpl": "SFSyncUpTarget",
+        "androidImpl": "com.salesforce.androidsdk.mobilesync.target.SyncUpTarget",
+        "createFieldlist": ["Name"],
+        "updateFieldlist": ["Description"]
+      },
+      "options": {
+        "fieldlist": [],
+        "mergeMode":"LEAVE_IF_CHANGED"
+      }
+    },
+    {
+      "syncName": "batchSyncUp",
+      "syncType": "syncUp",
+      "soupName": "accounts",
+      "target": {
+        "idFieldName": "IdX",
+        "modificationDateFieldName": "LastModifiedDateX",
+        "externalIdFieldName": "ExternalIdX"
+      },
+      "options": {
+        "fieldlist": ["Name", "Description"],
+        "mergeMode":"OVERWRITE"
+      }
+    },
+    {
+      "syncName": "parentChildrenSyncUp",
+      "syncType": "syncUp",
+      "soupName": "accounts",
+      "target": {
+        "iOSImpl" : "SFParentChildrenSyncUpTarget",
+        "androidImpl": "com.salesforce.androidsdk.mobilesync.target.ParentChildrenSyncUpTarget",
+        "parent" : {
+          "idFieldName" : "IdX",
+          "externalIdFieldName": "ExternalIdX",
+          "sobjectType" : "Account",
+          "modificationDateFieldName" : "LastModifiedDateX",
+          "soupName" : "accounts"
+        },
+        "createFieldlist" : ["IdX", "Name", "Description"],
+        "updateFieldlist" : ["Name", "Description"],
+        "children" : {
+          "parentIdFieldName" : "AccountId",
+          "idFieldName" : "IdY",
+          "externalIdFieldName": "ExternalIdY",
+          "sobjectType" : "Contact",
+          "modificationDateFieldName" : "LastModifiedDateY",
+          "soupName" : "contacts",
+          "sobjectTypePlural" : "Contacts"
+        },
+        "childrenCreateFieldlist" : ["LastName", "AccountId"],
+        "childrenUpdateFieldlist" : ["FirstName", "AccountId"],
+        "relationshipType" : "MASTER_DETAIL"
+      },
+      "options": {
+        "fieldlist":[],
+        "mergeMode":"LEAVE_IF_CHANGED"
+      }
+    }
+  ]
+}

package/shared/jsonChecker.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2019-present, salesforce.com, inc.
+ * All rights reserved.
+ * Redistribution and use of this software in source and binary forms, with or
+ * without modification, are permitted provided that the following conditions
+ * are met:
+ * - Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of salesforce.com, inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission of salesforce.com, inc.
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+// Dependencies
+var fs = require('fs'),
+    path = require('path'),
+    COLOR = require('./outputColors'),
+    utils = require('./utils'),
+    Ajv = require('ajv'),
+    jsonlint = require('jsonlint')
+;
+
+// Config type to schema map
+var SCHEMA = {
+    store: path.resolve(__dirname, 'store.schema.json'),
+    syncs: path.resolve(__dirname, 'syncs.schema.json')
+};
+
+
+//
+// Validate config against schema
+//
+function validateJson(configPath, configType) {
+    var config = readJsonFile(configPath)
+    var schema = readJsonFile(SCHEMA[configType])
+    var ajv = new Ajv({allErrors: true});
+    var valid = ajv.validate(schema, config);
+    if (!valid) {
+        utils.logError(JSON.stringify(ajv.errors, null, "  "))
+    } else {
+        utils.logInfo(`${configPath} conforms to ${configType} schema\n`, COLOR.green)
+    }
+}
+
+//
+// Read json from file and validates that is valid json
+//
+function readJsonFile(filePath) {
+    try {
+        var content = fs.readFileSync(filePath, "UTF-8");
+        var json = jsonlint.parse(content);
+        return json;
+    } catch (error) {
+        utils.logError(`Error parsing ${filePath}: ${error}\n`);
+        process.exit(1);
+    }
+}
+
+module.exports = {
+    validateJson
+};