@zohodesk/client_build_tool 0.0.1-0.exp.0.0.3

package/docs/SupportedBrowserVersions.md

@@ -0,0 +1,61 @@
+## Supported Browser Versions Configuration Documentation
+
+The `supportedBrowserVersions` array in the Client Build Tool (CBT) configuration allows you to specify the supported versions of various browsers for your project. Here is the documentation for the provided configuration:
+
+```javascript
+const supportedBrowserVersions = [
+  'last 3 Chrome versions',
+  'last 3 Firefox versions',
+  'last 3 Edge versions',
+  'last 3 Safari versions'
+];
+```
+
+The `supportedBrowserVersions` array includes browser version specifications using a syntax recognized by tools like Autoprefixer and Babel. Each entry in the array represents a specific browser and the number of versions to be supported.
+
+In the provided configuration, the following browser versions are specified:
+
+- `'last 3 Chrome versions'`: This specifies the last three versions of the Chrome browser to be supported.
+
+- `'last 3 Firefox versions'`: This specifies the last three versions of the Firefox browser to be supported.
+
+- `'last 3 Edge versions'`: This specifies the last three versions of the Edge browser to be supported.
+
+- `'last 3 Safari versions'`: This specifies the last three versions of the Safari browser to be supported.
+
+By specifying the supported browser versions, you can ensure that the generated code from CBT is compatible with a specific set of browsers. This helps in targeting a wide range of users while leveraging the latest browser capabilities and ensuring optimal performance and compatibility.
+
+Please note that the actual behavior and compatibility of the generated code may also depend on the specific plugins and tools used in your build configuration, such as Autoprefixer or Babel. Make sure these tools are properly configured and integrated into your build pipeline for the specified browser versions to be correctly targeted and supported.
+
+Feel free to modify the `supportedBrowserVersions` array according to your project's requirements and the desired level of browser compatibility.
+
+## Supported Browser Versions Configuration Documentation
+
+The `supportedBrowserVersions` object in the Client Build Tool (CBT) configuration allows you to specify the supported versions of various browsers for your project. Here is the documentation for the provided configuration:
+
+```javascript
+const supportedBrowserVersions = {
+  chrome: '108.0.0',
+  edge: '108.0.0',
+  firefox: '108.0.0',
+  safari: '16.1.0'
+};
+```
+
+The `supportedBrowserVersions` object includes browser names as keys and their corresponding version numbers as values.
+
+In the provided configuration, the following browser versions are specified:
+
+- `chrome: '108.0.0'`: This specifies that the project supports Chrome browser version 108.0.0.
+
+- `edge: '108.0.0'`: This specifies that the project supports Edge browser version 108.0.0.
+
+- `firefox: '108.0.0'`: This specifies that the project supports Firefox browser version 108.0.0.
+
+- `safari: '16.1.0'`: This specifies that the project supports Safari browser version 16.1.0.
+
+By specifying the supported browser versions, you can ensure that the generated code from CBT is compatible with specific versions of each browser. This helps in targeting a specific set of browsers and ensuring optimal performance and compatibility for your project.
+
+Please note that the actual behavior and compatibility of the generated code may also depend on the specific plugins and tools used in your build configuration. Make sure these tools are properly configured and integrated into your build pipeline to handle browser compatibility based on the specified versions.
+
+Feel free to modify the `supportedBrowserVersions` object according to your project's requirements and the desired level of browser compatibility.

package/helpDocs/check.js

@@ -0,0 +1,7 @@
+const { join } = require('path');
+
+let a = require.resolve('react', { paths: [join(__dirname, "../../client_packages_group")] });
+console.log({a});
+console.log({r: require(a)});
+
+

package/helpDocs/node18-env.md

@@ -0,0 +1,30 @@
+# create node18-env
+
+**Step 1:** run below comment
+> python3 -m venv ~/node18-env
+
+**Step 2:** remove all files except ~/node18-env/bin/activate
+
+**Step 3:** run below comment
+> npm i -g n
+
+**Step 4:** run below comment
+>  N_PREFIX=$HOME/node18-env n 18.11.0
+
+**Step 5:** add below line to ~/node18-env/bin/activate this file bottom
+> export N_PREFIX=$HOME/node18-env
+
+> export PATH=$N_PREFIX/bin:$PATH
+
+**Step 6:** to activate run below comment
+>  source ~/node18-env/bin/activate
+
+**Step 7:** to deactivate run below comment
+>  deactivate
+
+### To enable n18 command
+**Step 1:** add below line in your `~/.bashrc` or `~/.bash_profile` or `~/.profile` or `~/.zshrc` file which file works for you
+>  alias n18="source ~/node18-env/bin/activate"
+
+**Step :** run your `~/.bashrc` or `~/.bash_profile` or `~/.profile` or `~/.zshrc` file which file works for you
+>  source ~/.bash_profile

package/helpDocs/troubleshootings/NewMachineSetup.md

@@ -0,0 +1,71 @@
+# dev setup requirements:-
+
+First we need to install node 12 - 16 and npm 6
+
+if npm version 7 or greater then please check for "#Make a directory for global installations" below then install
+"npm install -g npm@6"
+
+### Find the path to npm's directory:
+
+> npm config get prefix
+
+For many systems, this will be `/usr/local` if it's not same then you can skip "#Make a directory for global installations"
+
+## Make a directory for global installations:
+
+in mac and unbundu when you install any package global you will be ask for sudo permission. if you follow the below step you do not have to use sudo for every install.
+
+> mkdir ~/.npm-global
+
+Configure npm to use the new directory path:
+
+> npm config set prefix '~/.npm-global'
+
+Open or create a `vim ~/.profile` (for unbuntu `vim ~/.bashrc`) file and add this line to bottom of that file:
+
+```
+export PATH=~/.npm-global/bin:$PATH
+```
+
+Back on the command line, update your system variables:
+For mac
+
+> source ~/.profile
+> For unbuntu
+> source ~/.bashrc
+
+then open new terminal you or good to go. now you can install npm globally with out sudo
+
+# set local registry
+
+in order to install local packages you need to set local registry
+
+> npm config edit
+
+One editor will open add below line bottom of that file
+
+```
+@zoho:registry=http://cm-npmregistry.csez.zohocorpin.com
+@zohocharts:registry=http://cm-npmregistry.csez.zohocorpin.com
+@zohodesk-private:registry=http://cm-npmregistry.csez.zohocorpin.com
+```
+
+# for install react-cli
+
+> npm i -g @zohodesk/react-cli
+
+# Memory Issue
+
+For some projects when you run app start command some memeory issue will come.SO it would be better if you do below steps you have memory issue or not if you do this memory issue would not come.
+
+Open or create a `vim ~/.profile` (for unbuntu `vim ~/.bashrc`) file and add this line to bottom of that file:
+
+```
+export NODE_OPTIONS=--max-old-space-size=14096
+```
+
+# extra tips:-
+
+for some git project clone may be file name too long error may come.
+solution was in the below link
+https://stackoverflow.com/questions/22575662/filename-too-long-in-git-for-windows

package/helpDocs/troubleshootings/README.md

@@ -0,0 +1,9 @@
+# Trouble shooting
+
+
+Most  of the troubleshooting will be  solved by below Shell scripts 
+## For Mac
+```sh  newMachineMac.sh```
+
+## For Ubundu
+```bash  newMachineUbundu.bash```

package/helpDocs/troubleshootings/hg_install.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+hg_already_installed="true"
+
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+installHg() {
+  echo "HG not installed"
+  hg_already_installed="false"
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  brew install mercurial
+  echo "HG ${GREEN}Installed${NC}"
+}
+
+hg --version || installHg
+[[ "$hg_already_installed" == "true" ]] && echo "we already have hg ${GREEN}Installed${NC}"

package/helpDocs/troubleshootings/newMachineMac.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+
+node_recommented_version="16"
+npm_recommented_version="6"
+local_registry="http://cm-npmregistry.csez.zohocorpin.com"
+dollor_symbol='$'
+global_p=~/npm-global
+# global_config_file=~/.zshrc
+# global_config_file=~/.bash_profile
+global_config_file=~/.profile
+
+
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+
+node_version=$(node -v)
+npm_prefix=$(npm config get prefix)
+npm_version=$(npm -v)
+
+echo "node_version $node_version npm_version $npm_version"
+
+if [ "$npm_prefix" == "/usr/local" ]
+  then
+    echo "npm_prefix $npm_prefix"
+    [ -d "$global_p" ] && echo "Directory $global_p exists."
+    [ ! -d "$global_p" ] && mkdir $global_p
+    npm config set prefix="$global_p"
+    echo "npm_prefix ${GREEN}Updated${NC}"
+  else
+    echo "npm_prefix ${GREEN}Correct${NC}"
+fi
+
+if [[ "$PATH" != *"$global_p/bin:"* ]] && [[ "$PATH" != "$global_p/bin:"* ]] 
+  then
+    # write in global config file
+    sudo echo "export PATH=$global_p/bin:${dollor_symbol}PATH" >> $global_config_file
+    echo "${dollor_symbol}PATH variable ${GREEN}Updated${NC}"
+  else
+    echo "${dollor_symbol}PATH variable ${GREEN}Correct${NC}"
+fi
+
+if [[ "$NODE_OPTIONS" != "--max-old-space-size=14096" ]]
+  then
+    sudo echo "export NODE_OPTIONS=--max-old-space-size=14096" >> $global_config_file
+    echo "${dollor_symbol}NODE_OPTIONS variable ${GREEN}Updated${NC}"
+  else
+    echo "${dollor_symbol}NODE_OPTIONS variable ${GREEN}Correct${NC}"
+fi
+
+if [[ $npm_version != $npm_recommented_version* ]];
+  then
+    echo "npm i -g npm@$npm_recommented_version"
+    npm i -g npm@$npm_recommented_version
+    echo "npm $(npm -v) ${GREEN}Updated${NC}"
+  else
+    echo "npm $(npm -v) version ${GREEN}Correct${NC}"
+fi
+
+updateLocalRegistry() {
+  npm_package_scpoe="$1"
+  npm_current_registry=$(npm config get $npm_package_scpoe:registry)
+
+  if [ "$npm_current_registry" != "$local_registry" ]
+  then
+    echo "$npm_package_scpoe:registry registry ${GREEN}Updated${NC}"
+    npm config set $npm_package_scpoe:registry="$local_registry"
+  else
+    echo "$npm_package_scpoe registry url ${GREEN}Correct${NC}"
+  fi
+}
+
+updateLocalRegistry "@zoho"
+updateLocalRegistry "@zohocharts"
+
+if [[ $node_version = '' ]] || [[ $node_version != v$node_recommented_version* ]]
+  then
+    echo "please install or switch to nodejs $node_recommented_version"
+    echo "Node Official Site https://nodejs.org/en/download/releases/"
+  else
+    echo "node version $node_version ${GREEN}Correct${NC}"
+fi
+
+echo "\nPlease open new terminal and check ${CYAN}echo ${dollor_symbol}PATH${NC} starts with ${CYAN}$global_p/bin${NC}"
+echo "To work with current terminal Please run ${CYAN}source $global_config_file${NC}"

package/helpDocs/troubleshootings/newMachineUbundu.bash

@@ -0,0 +1,84 @@
+#!/bin/bash
+
+node_recommented_version="16"
+npm_recommented_version="6"
+local_registry="http://cm-npmregistry.csez.zohocorpin.com"
+dollor_symbol='$'
+global_p=~/npm-global
+global_config_file=~/.bashrc
+
+
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+
+node_version=$(node -v)
+npm_prefix=$(npm config get prefix)
+npm_version=$(npm -v)
+
+printf "\nnode_version $node_version npm_version $npm_version"
+
+if [[ $node_version = '' ]] || [[ $node_version != v$node_recommented_version* ]]
+  then
+    curl -sL https://deb.nodesource.com/setup_${node_recommented_version}.x| sudo -E bash -
+    printf "\nnodejs $node_recommented_version and $(node -v) ${GREEN}Installed${NC}"
+  else
+    printf "\nnode version $node_version ${GREEN}Correct${NC}"
+fi
+
+if [[ "$npm_prefix" = "/usr/local" ]]
+  then
+    printf "\nnpm_prefix $npm_prefix"
+    [[ -d "$global_p" ]] && printf "\nDirectory $global_p exists."
+    [[ ! -d "$global_p" ]] && mkdir $global_p
+    npm config set prefix="$global_p"
+    printf "\nnpm_prefix ${GREEN}Updated${NC}"
+  else
+    printf "\nnpm_prefix ${GREEN}Correct${NC}"
+fi
+
+if [[ "$PATH" != *"$global_p/bin:"* ]] && [[ "$PATH" != "$global_p/bin:"* ]] 
+  then
+    # write in global config file
+    sudo printf "\nexport PATH=$global_p/bin:${dollor_symbol}PATH" >> $global_config_file
+    printf "\n${dollor_symbol}PATH variable ${GREEN}Updated${NC}"
+  else
+    printf "\n${dollor_symbol}PATH variable ${GREEN}Correct${NC}"
+fi
+
+if [[ "$NODE_OPTIONS" != "--max-old-space-size=14096" ]]
+  then
+    sudo printf "\nexport NODE_OPTIONS=--max-old-space-size=14096" >> $global_config_file
+    printf "\n${dollor_symbol}NODE_OPTIONS variable ${GREEN}Updated${NC}"
+  else
+    printf "\n${dollor_symbol}NODE_OPTIONS variable ${GREEN}Correct${NC}"
+fi
+
+if [[ $npm_version != $npm_recommented_version* ]];
+  then
+    printf "\nnpm i -g npm@$npm_recommented_version"
+    npm i -g npm@$npm_recommented_version
+    printf "\nnpm $(npm -v) ${GREEN}Updated${NC}"
+  else
+    printf "\nnpm $(npm -v) version ${GREEN}Correct${NC}"
+fi
+
+updateLocalRegistry() {
+  npm_package_scpoe="$1"
+  npm_current_registry=$(npm config get $npm_package_scpoe:registry)
+
+  if [[ "$npm_current_registry" != "$local_registry" ]]
+  then
+    printf "\n$npm_package_scpoe:registry registry ${GREEN}Updated${NC}"
+    npm config set $npm_package_scpoe:registry="$local_registry"
+  else
+    printf "\n$npm_package_scpoe registry url ${GREEN}Correct${NC}"
+  fi
+}
+
+updateLocalRegistry "@zoho"
+updateLocalRegistry "@zohocharts"
+
+printf "\nPlease open new terminal and check ${CYAN}echo ${dollor_symbol}PATH${NC} starts with ${CYAN}$global_p/bin${NC}"
+printf "\nTo work with current terminal Please run ${CYAN}source $global_config_file${NC}\n"

package/lib/allCommandsConfigs.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _fs = require("fs");
+
+var _path = require("path");
+
+/* eslint-disable global-require */
+const allConfigs = [];
+(0, _fs.readdirSync)((0, _path.join)(__dirname, 'commands')).forEach(folderName => {
+  const modulePath = (0, _path.join)(__dirname, `./commands/${folderName}/config.js`);
+
+  if ((0, _fs.existsSync)(modulePath)) {
+    // eslint-disable-next-line import/no-dynamic-require
+    const config = require(modulePath).default;
+
+    allConfigs.push(config);
+  }
+});
+var _default = allConfigs;
+exports.default = _default;

package/lib/commands/build/commandExecutor.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.commandExecutor = commandExecutor;
+
+var _logger = require("../../logger");
+
+var _webpackBuild = _interopRequireDefault(require("../../shared/bundler/webpack/webpackBuild"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function commandExecutor(options) {
+  (0, _logger.messageLogger)('Build is running.....');
+  (0, _webpackBuild.default)(options);
+}

package/lib/commands/build/config.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = {
+  name: 'build',
+  alias: ['devbuild'],
+  dirname: __dirname
+};
+exports.default = _default;

package/lib/commands/build/optionsProcessor.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.optionsProcessor = optionsProcessor;
+
+var _decidePublicPath = require("../../shared/bundler/webpack/common/decidePublicPath");
+
+var _modeUtils = require("../../shared/bundler/webpack/common/modeUtils");
+
+var _constants = require("../../shared/constants");
+
+function optionsProcessor(options) {
+  const {
+    context,
+    mode,
+    noPublicPath
+  } = options;
+  const {
+    isCdnEnabled
+  } = options.cdnMapping;
+  const serverExtras = (0, _decidePublicPath.modifiedServerOptions)(options);
+  const publicPath = noPublicPath ? undefined : (0, _decidePublicPath.decidePublicPath)(serverExtras);
+  const contextFolderPath = (0, _constants.joinWithAppPath)(context);
+  const defaultAppliedOptions = { ...options,
+    serverExtras,
+    // eslint-disable-next-line no-nested-ternary
+    mode: mode === null ? 'prod' : mode === 'dev' ? 'dev' : 'prod',
+    publicPath: (0, _modeUtils.isDevelopmentMode)(mode) || isCdnEnabled ? undefined : publicPath,
+    contextFolderPath,
+    httpsOptions: serverExtras.httpsOptions
+  };
+  return defaultAppliedOptions;
+}

package/lib/commands/build/preProcessor.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.preProcessor = preProcessor;
+
+var _runPreProcess = require("../../shared/pre_process/runPreProcess");
+
+function preProcessor(options) {
+  (0, _runPreProcess.runPreProcess)(options, 'node');
+}

package/lib/commands/buildEs/commandExecutor.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.commandExecutor = commandExecutor;
+
+var _constants = require("../../shared/constants");
+
+var _watchRun = require("../../shared/fileUtils/watchRun");
+
+function commandExecutor(options) {
+  const {
+    extraArgs = []
+  } = options;
+  const index = extraArgs.indexOf('-w');
+  const canWatch = index !== -1;
+
+  if (canWatch) {
+    extraArgs.splice(index, 1);
+  }
+
+  let [src, target] = extraArgs;
+  src = (0, _constants.joinWithAppPath)(src || 'src');
+  target = (0, _constants.joinWithAppPath)(target || 'es');
+  (0, _watchRun.watchRun)({
+    options,
+    src,
+    target,
+    canWatch,
+    mode: 'es'
+  });
+}

package/lib/commands/buildEs/config.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = {
+  name: 'buildEs',
+  alias: ['build_es', 'build:es'],
+  dirname: __dirname
+};
+exports.default = _default;

package/lib/commands/buildEs/preProcessor.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.preProcessor = preProcessor;
+
+var _runPreProcess = require("../../shared/pre_process/runPreProcess");
+
+function preProcessor(options) {
+  const {
+    extraArgs = []
+  } = options;
+  const index = extraArgs.indexOf('-w');
+  const canWatch = index !== -1;
+  (0, _runPreProcess.runPreProcess)(options, canWatch ? 'nodemon' : 'node');
+}

package/lib/commands/buildLib/commandExecutor.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.commandExecutor = commandExecutor;
+
+var _constants = require("../../shared/constants");
+
+var _watchRun = require("../../shared/fileUtils/watchRun");
+
+function commandExecutor(options) {
+  const {
+    extraArgs = []
+  } = options;
+  const index = extraArgs.indexOf('-w');
+  const canWatch = index !== -1;
+
+  if (canWatch) {
+    extraArgs.splice(index, 1);
+  }
+
+  let [src, target] = extraArgs;
+  src = (0, _constants.joinWithAppPath)(src || 'src');
+  target = (0, _constants.joinWithAppPath)(target || 'lib');
+  (0, _watchRun.watchRun)({
+    options,
+    src,
+    target,
+    canWatch,
+    mode: 'lib'
+  });
+}

package/lib/commands/buildLib/config.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = {
+  name: 'buildLib',
+  alias: ['build:lib', 'build_lib'],
+  dirname: __dirname
+};
+exports.default = _default;

package/lib/commands/buildLib/preProcessor.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.preProcessor = preProcessor;
+
+var _runPreProcess = require("../../shared/pre_process/runPreProcess");
+
+function preProcessor(options) {
+  const {
+    extraArgs = []
+  } = options;
+  const index = extraArgs.indexOf('-w');
+  const canWatch = index !== -1;
+  (0, _runPreProcess.runPreProcess)(options, canWatch ? 'nodemon' : 'node');
+}

package/lib/commands/mockserver/commandExecutor.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.commandExecutor = commandExecutor;
+
+var _path = require("path");
+
+var _logger = require("../../logger");
+
+var _spawnSyncIO = require("../../shared/commands-utils/spawnSyncIO");
+
+var _constants = require("../../shared/constants");
+
+function commandExecutor(options) {
+  const {
+    extraArgs
+  } = options;
+  const {
+    enable,
+    separateSeverPort,
+    mockEntryFile,
+    disableNodemon
+  } = options.mockServer;
+
+  if (!enable) {
+    (0, _logger.messageLogger)('mock server not enabled');
+    return;
+  }
+
+  if (!separateSeverPort) {
+    (0, _logger.messageLogger)('mock server not port enabled');
+    return;
+  }
+
+  const absolutePath = (0, _path.join)(__dirname, '..', '..', 'shared', 'server', 'mockServer.js');
+  const mockFile = (0, _constants.joinWithAppPath)(mockEntryFile);
+  (0, _logger.verboseLogger)('Mock server is running path', absolutePath);
+  (0, _logger.verboseLogger)('App mock server is path', mockFile);
+  (0, _logger.messageLogger)('mock server is running.....');
+  (0, _spawnSyncIO.spawnSyncIO)(disableNodemon ? 'node' : 'nodemon', [absolutePath, '--watch', (0, _path.dirname)(mockFile), ...extraArgs]); // webpackBuild(options);
+}