@hcl-software/dxclient 221.0.0

package/dist/packages/mls_exim/src/export/mlsExport.ts

@@ -0,0 +1,371 @@
+/*
+ ********************************************************************
+ * Licensed Materials - Property of HCL                             *
+ *                                                                  *
+ * Copyright HCL Technologies Ltd. 2024. All Rights Reserved.       *
+ *                                                                  *
+ * Note to US Government Users Restricted Rights:                   *
+ *                                                                  *
+ * Use, duplication or disclosure restricted by GSA ADP Schedule    *
+ ********************************************************************
+ */
+import commander from 'commander';
+import path from 'path';
+import fs, {
+  existsSync, mkdirSync, statSync,
+} from 'fs';
+import { createObjectCsvWriter } from 'csv-writer';
+import { filter, includes, find } from 'lodash';
+import { logger } from '../../../../src/utils/logger';
+import { apiServices } from '../../../../src/services/apiServices';
+
+import {
+  CONTENT_ELEMENT_TYPE,
+  defaultExportPath,
+  URL_PATH,
+  WCMElementTypes,
+  WCM_TYPE,
+  CONTENT_INFORMATION_TYPE,
+  CONTENT_TITLE_TYPE,
+  CONTENT_DESCRIPTION_TYPE,
+} from '../../../../src/utils/constants';
+import { ICSVFileContents, IMLSTranslations, IWCMLibrary } from '../utils/interfaces/export';
+import {
+  errorMessage, getBaseDXUrlFromCommand, getStoreDir, message,
+} from '../../../../src/utils/utils';
+
+const MLS_CSV_HEADERS = [{ id: 'source', title: 'source' }, { id: 'target', title: 'target' }, { id: 'sourceUUID', title: 'sourceUUID' },
+  { id: 'targetUUID', title: 'targetUUID' }, { id: 'sourceLanguage', title: 'sourceLanguage' }, { id: 'targetLanguage', title: 'targetLanguage' },
+  { id: 'field', title: 'field' }, { id: 'type', title: 'type' }, { id: 'wcmType', title: 'wcmType' }, { id: 'componentType', title: 'componentType' },
+  { id: 'fieldLimit', title: 'fieldLimit' }, { id: 'previewLink', title: 'previewLink' }, { id: 'lastModifiedOfSource', title: 'lastModifiedOfSource' },
+  { id: 'lastModifiedOfTarget', title: 'lastModifiedOfTarget' }];
+
+/**
+ * Returns the csv file path where the contents are to be exported.
+ * @param {string} exportPath Path where the contents have to be exported.
+ * @param {string} wcmQueryParam WCM library id or WCM project name used as query parameter.
+ * @returns {string} CSV file path.
+ */
+const getFilePath = async (exportPath: string, wcmQueryParam: string): Promise<string> => {
+  if (!existsSync(exportPath) || !statSync(exportPath).isDirectory()) {
+    logger.debug('Export path provided is not a directory path: %s', exportPath);
+    logger.error(errorMessage('ERROR_INVALID_EXPORT_PATH'));
+    return '';
+  }
+
+  const filePath = `${exportPath}/mls_${wcmQueryParam}_${new Date().getTime()}.csv`;
+  logger.debug('CSV file path to export - %s.', filePath);
+  return filePath;
+};
+
+/**
+ * Returns the preview link for the specified content.
+ * @param {commander.Command} cmdArgs Argument which will be used for processing the exporting the wcm contents.
+ * Contains export path, WCM library id and DX API configuration.
+ * @param {string} contentId Content ID for which the preview link url has to be generated.
+ * @returns {string} Preview link for the specofied content.
+ */
+const getPreviewLinkUrl = (cmdArgs: commander.Command, contentId: string): string => {
+  const contenthandlerPath = cmdArgs.contenthandlerPath.split('/');
+  // Content root will be the first parameter of the contenthandlerPath array if the length of the array is more than 2.
+  // Content root will be empty string in case of no context root and contenthandlerPath array will be 2.
+  const contextRoot = (contenthandlerPath.length > 2) ? `/${contenthandlerPath[1]}/` : '/';
+  return `${cmdArgs.dxProtocol}://${cmdArgs.hostname}:${cmdArgs.dxPort}${contextRoot}mypoc/${cmdArgs.virtualPortalContext}wcm/oid:${contentId}`;
+};
+
+/**
+ * This function is used to write the source contents into CSV file.
+ * @param {string} csvFilePath CSV file path to export.
+ * @param {Array} mlsTranslationData MLS translation contents to write into csv file.
+ * @param {commander.Command} cmdArgs Argument which will be used for processing the exporting the wcm contents.
+ * Contains export path, WCM library id and DX API configuration.
+ */
+export const writeContents = async (csvFilePath: string, mlsTranslationData: IMLSTranslations[], cmdArgs: commander.Command) => {
+  try {
+    logger.debug('Entered to insert contents into CSV file, CSV file path - %s.', csvFilePath);
+    const csvWriterData = createObjectCsvWriter({
+      path: `${csvFilePath}`,
+      header: MLS_CSV_HEADERS,
+      append: false,
+    });
+    const contentsDataArray: ICSVFileContents[] = [];
+    mlsTranslationData.forEach((data) => {
+      // Checks existence of translated items and source item elements
+      const translatedContent = data.translated_items[0].translated_content;
+      const sourceContent = data.translated_items[0].source_content;
+      if (data.translated_items.length > 0 && translatedContent && translatedContent.length > 0 && Object.keys(sourceContent).length > 0) {
+        translatedContent.forEach((target) => {
+          const titleObject: ICSVFileContents = {
+            source: sourceContent.title.value,
+            target: target.title.value,
+            sourceUUID: sourceContent.uuid,
+            targetUUID: target.uuid,
+            sourceLanguage: sourceContent.locale,
+            targetLanguage: target.locale,
+            field: CONTENT_TITLE_TYPE,
+            type: CONTENT_INFORMATION_TYPE,
+            wcmType: WCM_TYPE,
+            componentType: '',
+            fieldLimit: '',
+            previewLink: getPreviewLinkUrl(cmdArgs, sourceContent.uuid),
+            lastModifiedOfSource: sourceContent.updated ? new Date(sourceContent.updated).toUTCString() : '',
+            lastModifiedOfTarget: target.updated ? new Date(target.updated).toUTCString() : '',
+          };
+          contentsDataArray.push(titleObject);
+
+          const descriptionObject: ICSVFileContents = {
+            source: sourceContent.description.value,
+            target: target.description.value,
+            sourceUUID: sourceContent.uuid,
+            targetUUID: target.uuid,
+            sourceLanguage: sourceContent.locale,
+            targetLanguage: target.locale,
+            field: CONTENT_DESCRIPTION_TYPE,
+            type: CONTENT_INFORMATION_TYPE,
+            wcmType: WCM_TYPE,
+            componentType: '',
+            fieldLimit: '',
+            previewLink: getPreviewLinkUrl(cmdArgs, sourceContent.uuid),
+            lastModifiedOfSource: sourceContent.updated ? new Date(sourceContent.updated).toUTCString() : '',
+            lastModifiedOfTarget: target.updated ? new Date(target.updated).toUTCString() : '',
+          };
+          contentsDataArray.push(descriptionObject);
+        });
+        sourceContent.elements.element.forEach((sourceElements) => {
+          // Writes contents only for configured wcm element types like ShortText, RichText etc.
+          if (Object.values(WCMElementTypes).indexOf(sourceElements.type) !== -1) {
+            translatedContent.forEach((target) => {
+              const targetElementObject = find(target.elements.element, { name: sourceElements.name });
+              // Fetching Field Limit of the content to write into CSV
+              const fieldCharLimit = Object.keys(target.elements).length > 0 && targetElementObject
+                && targetElementObject.data.PropertiesContent.properties ? targetElementObject.data.PropertiesContent.properties
+                  .filter((obj) => {
+                    return obj.key === 'MAX_CHARS' && obj.value;
+                  }) : '';
+              const contentObject: ICSVFileContents = {
+                source: sourceElements.data.PropertiesContent.content && sourceElements.data.PropertiesContent.content.value,
+                target: Object.keys(target.elements).length > 0 && targetElementObject && targetElementObject.data.PropertiesContent.content
+                  ? targetElementObject.data.PropertiesContent.content.value : '',
+                sourceUUID: sourceContent.uuid,
+                targetUUID: target.uuid,
+                sourceLanguage: sourceContent.locale,
+                targetLanguage: target.locale,
+                field: sourceElements.name,
+                type: CONTENT_ELEMENT_TYPE,
+                wcmType: WCM_TYPE,
+                componentType: Object.keys(target.elements).length > 0 && targetElementObject ? targetElementObject.type : '',
+                fieldLimit: fieldCharLimit && fieldCharLimit.length > 0 ? fieldCharLimit[0].value : '',
+                previewLink: getPreviewLinkUrl(cmdArgs, sourceContent.uuid),
+                lastModifiedOfSource: sourceContent.updated ? new Date(sourceContent.updated).toUTCString() : '',
+                lastModifiedOfTarget: target.updated ? new Date(target.updated).toUTCString() : '',
+              };
+              contentsDataArray.push(contentObject);
+            });
+          }
+        });
+      }
+    });
+    logger.debug('Write the contents into the CSV file, content data length - %d', contentsDataArray.length);
+    if (contentsDataArray && contentsDataArray.length > 0) {
+      // Write the content data to the CSV file
+      await csvWriterData.writeRecords(contentsDataArray);
+      // Reading the file data by utf8 encoding
+      const originalFile = fs.readFileSync(csvFilePath, { encoding: 'utf8' });
+      const writeStream = fs.createWriteStream(csvFilePath);
+      // Writing the contents with BOM
+      writeStream.write(`\uFEFF ${originalFile}`, 'utf8');
+      writeStream.on('finish', () => {
+        logger.debug('Finished writing the contents into the CSV file with utf8 encoding');
+        // close the stream
+        writeStream.end();
+      });
+    }
+  } catch (error) {
+    logger.debug('Exception during writing contents into CSV file: %o', error);
+    throw new Error(errorMessage('ERROR_WRITING_CONTENTS'));
+  }
+};
+
+/**
+ * This method will check for duplicates in library IDs and library names.
+ * @param {string} wcmLibraryIds wcmLibraryIds command line argument
+ * @param {string} wcmLibraryNames wcmLibraryNames command line argument
+ * @param {string} baseDxURL Base URL to login into DX server
+ * @param {string} cookie Received from the response of DX server authentication
+ * @returns {Array} List of library IDs and names in the format {id: string, name?: string}
+ */
+export const getLibraryIdNameList = async (wcmLibraryIds: string, wcmLibraryNames: string, baseDxURL: string, cookie: string): Promise<IWCMLibrary[]> => {
+  logger.debug('Entering the getLibraryIdNameList function.');
+  const wcmLibraries: IWCMLibrary[] = [];
+  let duplicateIdsList: string[] = [];
+  let duplicateNamesList: string[] = [];
+
+  // Convert wcmLibraryIds string to array and check if duplicate Ids are found
+  if (wcmLibraryIds) {
+    const wcmLibraryIdsList = wcmLibraryIds.split(',').map((libId) => {
+      return libId.trim();
+    });
+
+    duplicateIdsList = filter(wcmLibraryIdsList, (val, index, iteratee) => {
+      return includes(iteratee, val, index + 1);
+    });
+
+    if (!duplicateIdsList.length) {
+      for (let index = 0; index < wcmLibraryIdsList.length; index += 1) {
+        if (wcmLibraryIdsList[index] && wcmLibraryIdsList[index].length) {
+          wcmLibraries.push({ id: wcmLibraryIdsList[index] });
+        }
+      }
+    }
+  }
+
+  // Convert wcmLibraryNames string to array and check if duplicate names are found
+  if (wcmLibraryNames) {
+    const wcmLibraryNamesList = wcmLibraryNames.split(',').map((libName) => {
+      return libName.trim();
+    });
+
+    duplicateNamesList = filter(wcmLibraryNamesList, (val, index, iteratee) => {
+      return includes(iteratee, val, index + 1);
+    });
+
+    if (!duplicateNamesList.length) {
+      for (let index = 0; index < wcmLibraryNamesList.length; index += 1) {
+        if (wcmLibraryNamesList[index] && wcmLibraryNamesList[index].length) {
+          wcmLibraries.push({ name: wcmLibraryNamesList[index] });
+        }
+      }
+    }
+
+    // Fetch library IDs using library name and check if ID is duplicate.
+    for (let index = 0; index < wcmLibraries.length; index += 1) {
+      if (wcmLibraries[index].name) {
+        // eslint-why to get library id for all names in loop.
+        // eslint-disable-next-line no-await-in-loop
+        const libraryId = await apiServices.getWCMLibraryIdFromName(baseDxURL, cookie, wcmLibraries[index].name);
+        if (libraryId && libraryId.length) {
+          const isDuplicate = wcmLibraries.some((lib) => {
+            return lib.id === libraryId;
+          });
+
+          if (isDuplicate) {
+            duplicateNamesList.push(`${wcmLibraries[index].name} with ID ${libraryId}`);
+          } else {
+            wcmLibraries[index].id = libraryId;
+          }
+        }
+      }
+    }
+  }
+
+  // Log both ID and Name if duplicate found in both duplicateID and duplicateName list and throw
+  if (duplicateIdsList.length && duplicateNamesList.length) {
+    logger.debug('Duplicate WCM library IDs found - ', duplicateIdsList.join(','));
+    logger.debug('Duplicate WCM library Names found - ', duplicateNamesList.join(','));
+    throw new Error(errorMessage('ERROR_DUPLICATE_LIBRARY_ID_AND_NAME', { 0: duplicateIdsList.join(','), 1: duplicateNamesList.join(',') }));
+  }
+
+  // Log IDs if duplicate found in duplicateID list and throw
+  if (duplicateIdsList.length) {
+    logger.debug('Duplicate WCM library IDs found - ', duplicateIdsList.join(','));
+    throw new Error(errorMessage('ERROR_DUPLICATE_LIBRARY_ID', { 0: duplicateIdsList.join(',') }));
+  }
+
+  // Log Names if duplicate found in duplicateName list and throw
+  if (duplicateNamesList.length) {
+    logger.debug('Duplicate WCM library Names found - ', duplicateNamesList.join(','));
+    throw new Error(errorMessage('ERROR_DUPLICATE_LIBRARY_NAME', { 0: duplicateNamesList.join(',') }));
+  }
+
+  return wcmLibraries;
+};
+
+/**
+ * This method will get filePath, invokes the DX services to get WCM contents based on Ids or names.
+ * @param {commander.Command} cmdArgs Argument which will be used for processing the exporting the wcm contents.
+ * Contains export path, WCM library id and DX API configuration.
+ * @param {string} baseDxURL Base URL to login into DX server
+ * @param {string} cookie Received from the response of DX server authentication
+ * @param {string} wcmLibraryId WcmLibraryId command line argument
+ * @param {string} wcmLibraryName WcmLibraryName command line argument
+ * @param {string} wcmProjectName WcmProjectName command line argument
+ * @param {string} wcmProjectId wcmProjectId to query to DX to get contents
+ * @returns {boolean} returns true
+ */
+const invokeExportServices = async (cmdArgs: commander.Command, baseDxUrl: string, cookie: string, wcmLibraryId?: string, wcmLibraryName?: string,
+  wcmProjectName?: string, wcmProjectId?: string) : Promise<boolean> => {
+  logger.debug('Entering the invokeExportServices function.');
+  const wcmQueryParam = wcmLibraryId || wcmProjectName;
+  // eslint-why to get filePath for all ids and names in list.
+  // eslint-disable-next-line no-await-in-loop
+  const filePath = await getFilePath(cmdArgs.exportPath, (wcmLibraryId || wcmProjectName.trim().replace(' ', '_'))); // Modify spaces to underscores in project name
+  logger.debug('File path to export the source contents - %s.', filePath);
+  if (filePath && filePath.length) {
+    // eslint-why to get wcmContentIds for all ids and names in list.
+    // eslint-disable-next-line no-await-in-loop
+    const wcmContentIds = await apiServices.getWebContentIds(baseDxUrl, cookie, 1, wcmLibraryId, wcmProjectName, wcmProjectId, cmdArgs.lastModifiedAfter);
+    logger.debug('Found content ids for - %s %d ', wcmQueryParam, wcmContentIds.length);
+    // append projectName to url if project name is provided
+    if (wcmProjectName) {
+      baseDxUrl += `/$project/${wcmProjectName}`;
+      logger.debug('baseDXUrl appended with project name - %s', baseDxUrl);
+    }
+    if (wcmContentIds && wcmContentIds.length) {
+      // eslint-why to get mlsTranslationData content for all ids and names in list.
+      // eslint-disable-next-line no-await-in-loop
+      const mlsTranslationData: IMLSTranslations[] = await apiServices.getMultilingualTranslationsData(baseDxUrl, cookie, wcmContentIds, wcmProjectId);
+      logger.info(message('MLS_EXPORT_WRITE_INTO_FILE', { 0: mlsTranslationData.length }));
+      if (mlsTranslationData && mlsTranslationData.length) {
+        // eslint-why to get writeContents for all ids and names in list.
+        // eslint-disable-next-line no-await-in-loop
+        await writeContents(filePath, mlsTranslationData, cmdArgs);
+        logger.info(message('MLS_EXPORT_CONTENT_SUCCESS', { 0: path.relative(process.cwd(), filePath), 1: (wcmLibraryName || wcmQueryParam) }));
+      }
+    }
+  }
+  return true;
+};
+
+export class MLSExport {
+  /**
+   * This function is used to export the WCM source contents into CSV file.
+   * @param {commander.Command} cmdArgs Argument which will be used for processing the exporting the wcm contents.
+   * Contains export path, WCM library id and DX API configuration.
+   * @returns {Promise<boolean>} True or false, if success true otherwise false.
+   */
+  async invoke(cmdArgs: commander.Command): Promise<boolean> {
+    try {
+      logger.debug('Enter export wcm source contents invoke function');
+      // self signing the certificate
+      process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+      cmdArgs.contenthandlerPath = cmdArgs.contenthandlerPath || URL_PATH.defaultContentHandler;
+      if (cmdArgs.exportPath) {
+        cmdArgs.exportPath = path.resolve(__dirname, cmdArgs.exportPath);
+      } else {
+        cmdArgs.exportPath = path.resolve(getStoreDir(), defaultExportPath);
+        if (!existsSync(cmdArgs.exportPath)) mkdirSync(cmdArgs.exportPath, { recursive: true });
+      }
+      const baseDxUrl = getBaseDXUrlFromCommand(cmdArgs);
+      const cookie = await apiServices.login(cmdArgs.dxUsername, cmdArgs.dxPassword, baseDxUrl);
+      logger.info(message('MLS_EXPORT_DX_LOGIN_SUCCESS'));
+      if (cmdArgs.wcmLibraryId || cmdArgs.wcmLibraryName) {
+        const wcmLibraries = await getLibraryIdNameList(cmdArgs.wcmLibraryId, cmdArgs.wcmLibraryName, baseDxUrl, cookie);
+        for (let index = 0; index < wcmLibraries.length; index += 1) {
+          if (wcmLibraries[index].id) {
+            // eslint-why to get filePath for all ids and names in list.
+            // eslint-disable-next-line no-await-in-loop
+            await invokeExportServices(cmdArgs, baseDxUrl, cookie, wcmLibraries[index].id, wcmLibraries[index].name, undefined);
+          }
+        }
+      } else {
+        const projectId = await apiServices.getWCMProjectIdFromName(baseDxUrl, cookie, cmdArgs.wcmProjectName);
+        return await invokeExportServices(cmdArgs, baseDxUrl, cookie, undefined, undefined, cmdArgs.wcmProjectName, projectId);
+      }
+
+      return true;
+    } catch (error) {
+      logger.error(error.message);
+      return false;
+    }
+  }
+}

package/dist/packages/mls_exim/src/import/mlsImport.d.ts

@@ -0,0 +1,8 @@
+import commander from 'commander';
+import { ICSVFileContents } from '../utils/interfaces/import';
+export declare const readFileData: (importPath: string) => Promise<ICSVFileContents[]>;
+export declare const validateFileData: (fileData: ICSVFileContents[], importPath: string) => boolean;
+export declare const getSourceContentIds: (fileData: ICSVFileContents[]) => string[];
+export declare class MLSImport {
+    invoke(cmdArgs: commander.Command): Promise<boolean>;
+}

package/dist/packages/mls_exim/src/import/mlsImport.js

@@ -0,0 +1,104 @@
+"use strict";
+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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MLSImport = exports.getSourceContentIds = exports.validateFileData = exports.readFileData = void 0;
+const csvtojson_1 = __importDefault(require("csvtojson"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../../../../src/utils/logger");
+const apiServices_1 = require("../../../../src/services/apiServices");
+const utils_1 = require("../../../../src/utils/utils");
+const constants_1 = require("../../../../src/utils/constants");
+const readFileData = (importPath) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!fs_1.existsSync(importPath) || !fs_1.statSync(importPath).isFile() || path_1.extname(importPath) !== `.${constants_1.FileType.CSV}`) {
+        logger_1.logger.info(utils_1.message('MLS_IMPORT_INVALID_IMPORT_PATH', { 0: importPath }));
+        return [];
+    }
+    try {
+        logger_1.logger.debug('Path from where the file data is imported - %s.', importPath);
+        const dataArray = yield csvtojson_1.default({
+            noheader: false,
+        }).fromFile(importPath);
+        return dataArray;
+    }
+    catch (error) {
+        logger_1.logger.debug('Exception while reading the CSV file: %o', error);
+        throw new Error(utils_1.errorMessage('ERROR_IMPORT_READ_FILE', { 0: importPath, 1: JSON.stringify(error) }));
+    }
+});
+exports.readFileData = readFileData;
+const validateFileData = (fileData, importPath) => {
+    const maxDataLengthContents = fileData.filter((content) => {
+        return content.componentType === constants_1.WCMElementTypes.SHORT_TEXT_COMPONENT && content.target.length > constants_1.MAX_DATA_LENGTH_CONTENT;
+    });
+    if (maxDataLengthContents.length > 0) {
+        maxDataLengthContents.forEach((row) => {
+            logger_1.logger.info(utils_1.message('MLS_IMPORT_MAX_DATA_LENGTH_INFO', {
+                MAX_LENGTH: constants_1.MAX_DATA_LENGTH_CONTENT, 0: row.targetUUID, 1: row.targetLanguage, 2: row.field, 3: importPath,
+            }));
+        });
+        return false;
+    }
+    return true;
+};
+exports.validateFileData = validateFileData;
+const getSourceContentIds = (fileData) => {
+    const sourceContentIdsObj = {};
+    fileData.forEach((row) => {
+        if (!sourceContentIdsObj[row.sourceUUID]) {
+            sourceContentIdsObj[row.sourceUUID] = 1;
+        }
+    });
+    return Object.keys(sourceContentIdsObj);
+};
+exports.getSourceContentIds = getSourceContentIds;
+class MLSImport {
+    invoke(cmdArgs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                logger_1.logger.debug('Enter import wcm source contents invoke function');
+                process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+                cmdArgs.contenthandlerPath = cmdArgs.contenthandlerPath || constants_1.URL_PATH.defaultContentHandler;
+                const baseDxUrl = utils_1.getBaseDXUrlFromCommand(cmdArgs);
+                const cookie = yield apiServices_1.apiServices.login(cmdArgs.dxUsername, cmdArgs.dxPassword, baseDxUrl);
+                if (cmdArgs.wcmProjectName) {
+                    yield apiServices_1.apiServices.getWCMProjectIdFromName(baseDxUrl, cookie, cmdArgs.wcmProjectName);
+                }
+                cmdArgs.importPath = cmdArgs.importPath.split(',').map((entry) => { return entry.trim(); });
+                for (let index = 0; index < cmdArgs.importPath.length; index += 1) {
+                    if (cmdArgs.importPath[index] && cmdArgs.importPath[index].length) {
+                        const fileData = yield exports.readFileData(cmdArgs.importPath[index]);
+                        if (fileData && fileData.length) {
+                            logger_1.logger.info(utils_1.message('MLS_IMPORT_FETCH_TRANSLATED_DATA', { 0: cmdArgs.importPath[index], 1: fileData.length }));
+                            if (exports.validateFileData(fileData, cmdArgs.importPath[index])) {
+                                const sourceContentIds = exports.getSourceContentIds(fileData);
+                                logger_1.logger.info(utils_1.message('MLS_IMPORT_FETCH_SOURCE_IDS', { 0: sourceContentIds.length }));
+                                const projectName = cmdArgs.wcmProjectName || '';
+                                yield apiServices_1.apiServices.importMultilingualTranslationsData(sourceContentIds, fileData, cookie, baseDxUrl, projectName, (/^true$/i).test(cmdArgs.forceImport));
+                                logger_1.logger.info(utils_1.message('MLS_IMPORT_PROCESS_COMPLETE', { 0: cmdArgs.importPath[index] }));
+                            }
+                        }
+                    }
+                }
+                return true;
+            }
+            catch (error) {
+                logger_1.logger.error(error.message);
+                return false;
+            }
+        });
+    }
+}
+exports.MLSImport = MLSImport;
+//# sourceMappingURL=mlsImport.js.map

package/dist/packages/mls_exim/src/import/mlsImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mlsImport.js","sourceRoot":"","sources":["../../../../../packages/mls_exim/src/import/mlsImport.ts"],"names":[],"mappings":"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"}

package/dist/packages/mls_exim/src/import/mlsImport.ts

@@ -0,0 +1,138 @@
+/*
+ ********************************************************************
+ * Licensed Materials - Property of HCL                             *
+ *                                                                  *
+ * Copyright HCL Technologies Ltd. 2021. All Rights Reserved.       *
+ *                                                                  *
+ * Note to US Government Users Restricted Rights:                   *
+ *                                                                  *
+ * Use, duplication or disclosure restricted by GSA ADP Schedule    *
+ ********************************************************************
+ */
+import commander from 'commander';
+import csvReader from 'csvtojson';
+import { existsSync, statSync } from 'fs';
+import { extname } from 'path';
+import { logger } from '../../../../src/utils/logger';
+import { apiServices } from '../../../../src/services/apiServices';
+import { ICSVFileContents } from '../utils/interfaces/import';
+import {
+  errorMessage, getBaseDXUrlFromCommand, message,
+} from '../../../../src/utils/utils';
+import {
+  FileType, MAX_DATA_LENGTH_CONTENT, URL_PATH, WCMElementTypes,
+} from '../../../../src/utils/constants';
+
+/**
+ * Returns the csv file data array from the file path specified.
+ * @param {string} importPath Path from where the contents have to be imported.
+ * @returns {Array} CSV file data array.
+*/
+export const readFileData = async (importPath: string): Promise<ICSVFileContents[]> => {
+  if (!existsSync(importPath) || !statSync(importPath).isFile() || extname(importPath) !== `.${FileType.CSV}`) {
+    logger.info(message('MLS_IMPORT_INVALID_IMPORT_PATH', { 0: importPath }));
+    return [] as ICSVFileContents[];
+  }
+
+  try {
+    logger.debug('Path from where the file data is imported - %s.', importPath);
+    const dataArray = await csvReader({
+      noheader: false,
+    }).fromFile(importPath); // Returns array of objects
+    return dataArray;
+  } catch (error) {
+    logger.debug('Exception while reading the CSV file: %o', error);
+    throw new Error(errorMessage('ERROR_IMPORT_READ_FILE', { 0: importPath, 1: JSON.stringify(error) }));
+  }
+};
+
+/**
+ * Check whether CSV file data is valid
+ * @param {string} fileData CSV file data array.
+ * @param {string} importPath Path from where the contents have to be imported.
+ * @returns {Boolean} true if CSF file data is valid else false.
+*/
+export const validateFileData = (fileData: ICSVFileContents[], importPath: string): boolean => {
+  const maxDataLengthContents = fileData.filter((content) => {
+    return content.componentType === WCMElementTypes.SHORT_TEXT_COMPONENT && content.target.length > MAX_DATA_LENGTH_CONTENT;
+  });
+
+  if (maxDataLengthContents.length > 0) {
+    maxDataLengthContents.forEach((row) => {
+      logger.info(message('MLS_IMPORT_MAX_DATA_LENGTH_INFO', {
+        MAX_LENGTH: MAX_DATA_LENGTH_CONTENT, 0: row.targetUUID, 1: row.targetLanguage, 2: row.field, 3: importPath,
+      }));
+    });
+    return false;
+  }
+  return true;
+};
+
+/**
+ * Returns the unique list of source content ids.
+ * @param {string} fileData File data which has to be imported.
+ * @returns {Array} Array of source content ids.
+*/
+export const getSourceContentIds = (fileData: ICSVFileContents[]): string[] => {
+  const sourceContentIdsObj: {[key: string]: number} = {};
+  fileData.forEach((row) => {
+    if (!sourceContentIdsObj[row.sourceUUID]) {
+      sourceContentIdsObj[row.sourceUUID] = 1;
+    }
+  });
+  // Return the unique source content ids list
+  return Object.keys(sourceContentIdsObj);
+};
+
+export class MLSImport {
+  /**
+   * This function is used to export the WCM source contents into CSV file.
+   * @param {commander.Command} cmdArgs Argument which will be used for processing the exporting the wcm contents.
+   * Contains export path, WCM library id and RING API configuration.
+   * @returns {Promise<boolean>} True or false, if success true otherwise false.
+   */
+  async invoke(cmdArgs: commander.Command): Promise<boolean> {
+    try {
+      logger.debug('Enter import wcm source contents invoke function');
+      // self signing the certificate
+      process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+      cmdArgs.contenthandlerPath = cmdArgs.contenthandlerPath || URL_PATH.defaultContentHandler;
+      const baseDxUrl = getBaseDXUrlFromCommand(cmdArgs);
+      const cookie = await apiServices.login(cmdArgs.dxUsername, cmdArgs.dxPassword, baseDxUrl);
+
+      if (cmdArgs.wcmProjectName) {
+        // This is to validate if the project name is valid or not.
+        await apiServices.getWCMProjectIdFromName(baseDxUrl, cookie, cmdArgs.wcmProjectName);
+      }
+
+      cmdArgs.importPath = cmdArgs.importPath.split(',').map((entry:string) => { return entry.trim(); });
+      for (let index = 0; index < cmdArgs.importPath.length; index += 1) {
+        // Checking array elements length to verify path existence
+        if (cmdArgs.importPath[index] && cmdArgs.importPath[index].length) {
+          // eslint-why We need a synchronous fashion execution to process the data.
+          // eslint-disable-next-line no-await-in-loop
+          const fileData = await readFileData(cmdArgs.importPath[index]);
+          // Checking fileData array is empty or not to process importing
+          if (fileData && fileData.length) {
+            logger.info(message('MLS_IMPORT_FETCH_TRANSLATED_DATA', { 0: cmdArgs.importPath[index], 1: fileData.length }));
+            // Validating each row from fileData to handle max data length
+            if (validateFileData(fileData, cmdArgs.importPath[index])) {
+              const sourceContentIds = getSourceContentIds(fileData);
+              logger.info(message('MLS_IMPORT_FETCH_SOURCE_IDS', { 0: sourceContentIds.length }));
+
+              const projectName = cmdArgs.wcmProjectName || '';
+              // eslint-why to invoke dx api in synchronous fashion and process it.
+              // eslint-disable-next-line no-await-in-loop
+              await apiServices.importMultilingualTranslationsData(sourceContentIds, fileData, cookie, baseDxUrl, projectName, (/^true$/i).test(cmdArgs.forceImport));
+              logger.info(message('MLS_IMPORT_PROCESS_COMPLETE', { 0: cmdArgs.importPath[index] }));
+            }
+          }
+        }
+      }
+      return true;
+    } catch (error) {
+      logger.error(error.message);
+      return false;
+    }
+  }
+}

package/dist/packages/mls_exim/src/messages/messages_en.json

@@ -0,0 +1,14 @@
+{
+  "MLS_EXPORT_CONTENT_SUCCESS": "Successfully exported the contents in specified path {0} for {1}.",
+  "MLS_EXPORT_DX_LOGIN_SUCCESS": "Successfully logged in to DX server.",
+  "MLS_EXPORT_WRITE_INTO_FILE": "{0} web contents are found to export the MLS translation data.",
+  "MLS_EXPORT_RETRIEVED_TRANSLATION": "Retrieved translated contents to write into file for the content Id {0}",
+  "MLS_IMPORT_FETCH_TRANSLATED_DATA": "Translated data fetched successfully from the path - {0}, total number of rows in the file - {1}.",
+  "MLS_IMPORT_FETCH_SOURCE_IDS": "Unique sourceContentIds fetched successfully, total number of sourceContentIds - {0}.",
+  "MLS_IMPORT_PROCESS_COMPLETE": "Import process completed for the CSV file - {0}.",
+  "MLS_IMPORT_TRANSLATION_DATA_SUCCESS": "Imported translations data successfully for sourceContentId - {0}.",
+  "MLS_IMPORT_TRANSLATION_DATA_ERROR": "Translation unsuccessful for the sourceContentId - {0}, error response - {1}.",
+  "MLS_IMPORT_MAX_DATA_LENGTH_INFO": "Translated content data length is more than maximum supported data length {MAX_LENGTH} for targetUUID - {0}, targetLanguage - {1}, field - {2} for CSV file path - {3}, hence skipping the import process for this.",
+  "MLS_IMPORT_INVALID_IMPORT_PATH": "Import path provided is not a valid CSV file path - {0}, hence skipping the import process for this.",
+  "MLS_IMPORT_VALIDATION_FAILED": "Either source content or one of the target contents updated since last export, hence skipping the import process for this content - {0}. Perform force import to ignore this."
+}