@pega/custom-dx-components 0.25.17 → 0.25.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/custom-dx-components",
-  "version": "0.25.17",
+  "version": "0.25.19",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
   "scripts": {

package/src/cli.js

@@ -32,6 +32,7 @@ import {
   moveComponent,
   renameLibrary,
   restoreConfig,
+  restore,
   revertWebPack,
   promoteWebPack,
   showStatus,
@@ -63,6 +64,7 @@ const TASKS = {
   RENAME: 'rename',
   RENAME_LIB: 'renameLibrary',
   RESTORE_CONFIG: 'restoreConfig',
+  RESTORE_LIB: 'restore',
   QUARANTINE: 'quarantine',
   MOVE: 'moveComponent',
   LIST: 'list',
@@ -170,6 +172,10 @@ export default async (args = []) => {
       restoreConfig(options);
       break;
     }
+    case TASKS.RESTORE_LIB: {
+      restore(options);
+      break;
+    }
     case TASKS.QUARANTINE: {
       quarantine(options);
       break;

package/src/constants.js

@@ -40,9 +40,11 @@ export const LP_DELETE_COMPONENT_SERVICE_REST_ENDPOINT =
   'pegalaunchpad/c11n/isolations/{isolationId}/v102/assetsUpdate';
 
 export const PUBLISH_COMPONENT_LIBRARY_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/publish_component_library';
-export const PUBLISH_COMPONENT_ARCHIVE_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/publish_component_archive';
+export const PUBLISH_COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/publish_component_library_archive';
 export const LIST_COMPONENT_LIBRARIES_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/list_component_libraries';
+export const LIST_COMPONENT_LIBRARY_ARCHIVES_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/list_component_library_archives';
 export const DELETE_COMPONENT_LIBRARY_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/delete_component_library';
+export const COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT = 'PRRestService/dev/v1/component_library_archive';
 
 
 export const FIELD_PATH = '/field';

package/src/tasks/create/templates/Constellation/Field/Icon-Button-URL/localizations.json.mustache

@@ -0,0 +1,10 @@
+{
+  "fields": {
+    "State name" : "State name",
+    "State code" : "State code",
+    "State list for": "State list for",
+    "Click to show/hide state list": "Click to show/hide state list",
+    "State list": "State list",
+    "Loading state list": "Loading state list"
+  }
+}

package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/localizations.json.mustache

@@ -0,0 +1,5 @@
+{
+  "fields": {
+    "No items": "No items"
+  }
+}

package/src/tasks/create/templates/Constellation/Widget/CASE/localizations.json.mustache

@@ -0,0 +1,8 @@
+{
+  "fields": {
+    "Date": "Date",
+    "Description" : "Description",
+    "Performed by" : "Performed by",
+    "Loading case history" : "Loading case history"
+  }
+}

package/src/tasks/create/templates/Constellation/Widget/PAGE/localizations.json.mustache

@@ -0,0 +1,10 @@
+{
+  "fields": {
+    "Case type": "Case type",
+    "Key" : "Key",
+    "Status" : "Status",
+    "Stage" : "Stage",
+    "Work list" : "Work list",
+    "Loading Work list" : "Loading Work list"
+  }
+}

package/src/tasks/create-version/helper.js

@@ -80,3 +80,33 @@ addDebugLog("getCreateVersionComponentQuestions", "", "");
     },
   ];
 };
+
+
+export const getCreateVersionComponentCLQuestions = async () => {
+  addDebugLog("getCreateVersionComponentCLQuestions", "", "");
+    const componentDefaults =  getConfigDefaults();
+
+    // increment the version
+    const incrVersion = await getNextVersion();
+    console.log(`\nCurrent library: ${chalk.green(`${componentDefaults.currentOrgLib}`)}`);
+
+    return [
+      {
+        name: 'version',
+        message: 'Enter version ',
+        default: incrVersion,
+        validate: value => {
+          if (validateSemver(value)) {
+            return true;
+          }
+          return 'Please provide semver compatible version e.g 0.0.1';
+        }
+      },
+      {
+        name: 'copyExisting',
+        type: 'confirm',
+        message: 'Copy current components to new version ?',
+        default: true
+      },
+    ];
+  };

package/src/tasks/create-version/index.js

@@ -21,7 +21,7 @@ import {
   cleanUpTemp
 } from '../../util.js';
 
-import { getCreateVersionComponentQuestions, updateAllComponentsConfig } from './helper.js';
+import { getCreateVersionComponentQuestions, updateAllComponentsConfig, getCreateVersionComponentCLQuestions } from './helper.js';
 import { showCurrentStatus } from '../show-status/index.js';
 
 export default async options => {
@@ -65,9 +65,17 @@ addDebugLog("createVersion", "", "+");
     copyExisting = !!(copyExist === 'Y' || copyExist === 'y' || copyExist === true || copyExist === 'true');
 
   } else {
-    const questions = await getCreateVersionComponentQuestions();
-    const answers = await inquirer.prompt(questions);
-    ({ version, permBuild, copyExisting } = answers);
+    if (isLibraryBasedCL) {
+      const questions = await getCreateVersionComponentCLQuestions();
+      const answers = await inquirer.prompt(questions);
+      ({ version, copyExisting } = answers);
+    }
+    else {
+      const questions = await getCreateVersionComponentQuestions();
+      const answers = await inquirer.prompt(questions);
+      ({ version, permBuild, copyExisting } = answers);
+    }
+
   }
 
   if (isLibraryBasedCL) {

package/src/tasks/delete-pub/helper.js

@@ -135,7 +135,7 @@ addDebugLog("getInfinityLibraries", '', "");
 
   // inquire
 
-  let urlParams = `/AppName/${ApplicationName}/AppVersion/${ApplicationVersion}/ruleset/${rulesetName}/rulesetVersion/${rulesetVersion}`;
+  let urlParams = `/app-name/${ApplicationName}/app-version/${ApplicationVersion}/rulesetname/${rulesetName}/rulesetversion/${rulesetVersion}`;
   //let urlParams = `&ApplicationName=${ApplicationName}&ApplicationVersion=${ApplicationVersion}&RulesetName=${rulesetName}&RulesetVersion=${rulesetVersion}`;
   //urlParams = encodeURIComponent(urlParams);
 

package/src/tasks/delete-pub/index.js

@@ -3,7 +3,7 @@ import ora from 'ora';
 
 import chalk from 'chalk';
 
-import { showVersion, getC11NB2STokenAndStaticServer, getLocalLibraryVersions, getLibraryBased, deleteLocalLibrary, deleteLocalLibraryVersion, addDebugLog, getConfigDefaults, getLibraryBasedCL, getPegaServerConfig, deleteInfinityServerComponentLibrary } from '../../util.js';
+import { showVersion, getC11NB2STokenAndStaticServer, getLocalLibraryVersions, getLibraryBased, deleteLocalLibrary, deleteLocalLibraryVersion, addDebugLog, getConfigDefaults, getLibraryBasedCL, getPegaServerConfig, deleteInfinityServerComponentLibrary, checkAccessTokenExpiration } from '../../util.js';
 import { deleteLib } from '@pega/constellation-dx-components-build-utils/index.js';
 
 import { getDeleteLibraryQuestions, getLibraryVersionQuestion, getRulesetAndVersionQuestion, SOURCE_OF_COMPONENT_TYPES, getInfinityLibraries } from './helper.js';
@@ -85,7 +85,12 @@ addDebugLog("deletePublished", "END", "-");
 
   }
   else {
+    // server
+
+    await checkAccessTokenExpiration();
+
     const isLibraryBasedCL =  getLibraryBasedCL();
+
     if (isLibraryBasedCL) {
 
       const serverConfg = await getPegaServerConfig();

package/src/tasks/export-archive/helper.js

@@ -111,18 +111,18 @@ addDebugLog("getLibraryVersionQuestion", "", "");
 };
 
 export const getServerOrDirectoryQuestion = async () => {
-  addDebugLog("getLibraryVersionQuestion", "", "");
-
-      return [
-      {
-        name: 'exportTo',
-        type: 'rawlist',
-        message: `Export to`,
-        choices:  [{name: 'Local directory', value: 'Directory'}, {name: 'Server', value: 'Server'}],
-        defaut: 'Directory'
-      }
-    ];
-  };
+addDebugLog("getLibraryVersionQuestion", "", "");
+
+    return [
+    {
+      name: 'exportTo',
+      type: 'rawlist',
+      message: `Export to`,
+      choices:  [{name: 'Local directory', value: 'Directory'}, {name: 'Server', value: 'Server'}],
+      default: 'Directory'
+    }
+  ];
+};
 
 export const getFullArchiveQuestions = async () => {
 

package/src/tasks/export-archive/index.js

@@ -191,6 +191,7 @@ addDebugLog("exportArch", `exportPath: ${exportPath}, orgLibName: ${orgLibName},
 
   if (orgLibName === configDef.currentOrgLib && selectedVersion === configDef.buildVersion) {
 
+    /*
     let currentOrStore = currentOrArchive;
     if (currentOrArchive === "") {
       console.log("\nYou've selected the current working library/version.");
@@ -212,6 +213,11 @@ addDebugLog("exportArch", `exportPath: ${exportPath}, orgLibName: ${orgLibName},
     if (currentOrStore === "Current") {
       archiveBeforeStore = true;
     }
+    */
+
+    // We are just going to archive before store and not ask
+    archiveBeforeStore = true;
+
   }
 
   if (!fs.existsSync(exportPath)) {

package/src/tasks/import-archive/helper.js

@@ -1,10 +1,11 @@
 import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
+import fetch from 'node-fetch';
 import { join } from 'path';
 import { Listr } from 'listr2';
-import { addDebugLog, getConfigDefaults, convertIntoPascalCase, getComponents, getComponentDirectoryPath, getDirectoryFiles, setConfigImportRelativePath, forceDefaultsUpdate } from '../../util.js';
-import { TASKS_CONFIG_JSON_FILENAME, TEMP_PATH, PACKAGE_JSON_FILENAME } from '../../constants.js';
+import { addDebugLog, getHttpsAgent, getConfigDefaults, getPegaServerConfig, convertIntoPascalCase, getComponents, getComponentDirectoryPath, getDirectoryFiles, setConfigImportRelativePath, forceDefaultsUpdate, constructCompleteUrl } from '../../util.js';
+import { TASKS_CONFIG_JSON_FILENAME, TEMP_PATH, PACKAGE_JSON_FILENAME, LIST_COMPONENT_LIBRARY_ARCHIVES_SERVICE_REST_ENDPOINT, COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT, TOKEN_PATH} from '../../constants.js';
 
 
 
@@ -229,6 +230,20 @@ export const updateTempArchive = async(libraryName, version, devBuild) => {
 
 }
 
+export const getServerOrDirectoryQuestion = async () => {
+addDebugLog("getLibraryVersionQuestion", "", "");
+
+    return [
+    {
+      name: 'importFrom',
+      type: 'rawlist',
+      message: `Import from`,
+      choices:  [{name: 'Local directory', value: 'Directory'}, {name: 'Server', value: 'Server'}],
+      defaut: 'Directory'
+    }
+  ];
+};
+
 
 export const getFilePathQuestions = async () => {
 addDebugLog("getFilePathQuestions", "", "");
@@ -304,7 +319,6 @@ addDebugLog("getFileNameQuestions", "", "");
 export const updateSavedFilePath = async(filePath) => {
   const currentDirectory = process.cwd();
   const arPathParts = currentDirectory.split(path.sep);
-  const configDef = getConfigDefaults();
 
   let defaultPath = join(path.sep, arPathParts[0], arPathParts[1], arPathParts[2]);
 
@@ -345,3 +359,191 @@ export const updateSavedFilePath = async(filePath) => {
   }
 
 }
+
+
+
+
+
+async function fetchComponentLibraryArchivesFromInfinity(apiUrl, headers) {
+  addDebugLog("fetchComponentLibraryArchivesFromInfinity", `apiUrl: ${apiUrl}`, "");
+    const serverConfig = await getPegaServerConfig();
+    return new Promise((resolve, reject) => {
+      let status = 500;
+      fetch(apiUrl, {
+        method: 'GET',
+        agent: getHttpsAgent(serverConfig),
+        headers
+      })
+        .then((response) => {
+          status = response.status;
+          if (status === 401) {
+            throw new Error('Error occurred in authentication. Please regenerate using authenticate');
+          }
+          else if (status === 404){
+            throw new Error('404: Server resource not found');
+          }
+          else if (status === 405){
+            throw new Error('405: Server method not allowed');
+          }
+          else if (status === 408){
+            throw new Error('408: Server timed out');
+          }
+          return response.json();
+        })
+        .then((resp) => {
+          // const respData = JSON.parse(resp);
+          if (status === 401) {
+            throw new Error('Error occurred in authentication. Please regenerate using authenticate');
+            // console.log(accessTokenUri, refreshToken);
+            /* TODO - Handle refresh_token */
+          } else if (status === 200) {
+            resolve(resp);
+          } else {
+            throw new Error(`${resp.message}`);
+          }
+        })
+        // eslint-disable-next-line prefer-promise-reject-errors
+        .catch((e) => reject(`${chalk.bold.red(e)}`));
+    });
+  }
+
+  export const getServerLibraryArchives = async() => {
+  addDebugLog("getServerLibraryArchives", '', "");
+
+    const defaultPegaServerConfig = await getPegaServerConfig();
+    let url = constructCompleteUrl(
+      defaultPegaServerConfig.server,
+      LIST_COMPONENT_LIBRARY_ARCHIVES_SERVICE_REST_ENDPOINT
+    );
+
+
+    return new Promise((resolve, reject) => {
+      try {
+        fs.readFile(TOKEN_PATH, 'utf8', (err, data) => {
+          if (err) {
+            // eslint-disable-next-line prefer-promise-reject-errors
+            reject(`\n${chalk.bold.red('Error occurred in authentication. Please regenerate using authenticate')}`);
+          }
+          if (data) {
+            const { access_token: accessToken, token_type: tokenType } = JSON.parse(data);
+
+            const headers = {};
+            headers.Authorization = `${tokenType} ${accessToken}`;
+
+            fetchComponentLibraryArchivesFromInfinity(url, headers)
+              .then((response) => resolve(response))
+              .catch((e) => reject(e));
+
+          }
+        });
+      } catch (error) {
+        console.log(`\n${chalk.bold.red(error)}`);
+        // eslint-disable-next-line prefer-promise-reject-errors
+        reject(`${chalk.bold.red(error)}`);
+      }
+    });
+
+  }
+
+
+  export const getLibraryArchiveQuestion = async (archiveVersions) => {
+  addDebugLog("getLibraryArchiveQuestion", `archiveVersions: ${archiveVersions}`, "");
+    return [
+      {
+        name: 'archiveData',
+        type: 'rawlist',
+        message: `Select an archive`,
+        choices: archiveVersions
+      }
+    ];
+  };
+
+
+
+  async function fetchComponentLibraryArchiveFromInfinity(apiUrl, headers) {
+    addDebugLog("fetchComponentLibraryArchivesFromInfinity", `apiUrl: ${apiUrl}`, "");
+      const serverConfig = await getPegaServerConfig();
+      return new Promise((resolve, reject) => {
+        let status = 500;
+        fetch(apiUrl, {
+          method: 'GET',
+          agent: getHttpsAgent(serverConfig),
+          headers
+        })
+          .then((response) => {
+            status = response.status;
+            if (status === 401) {
+              throw new Error('Error occurred in authentication. Please regenerate using authenticate');
+            }
+            else if (status === 404){
+              throw new Error('404: Server resource not found');
+            }
+            else if (status === 405){
+              throw new Error('405: Server method not allowed');
+            }
+            else if (status === 408){
+              throw new Error('408: Server timed out');
+            }
+            return response.json();
+          })
+          .then((resp) => {
+            // const respData = JSON.parse(resp);
+            if (status === 401) {
+              throw new Error('Error occurred in authentication. Please regenerate using authenticate');
+              // console.log(accessTokenUri, refreshToken);
+              /* TODO - Handle refresh_token */
+            } else if (status === 200) {
+              resolve(resp);
+            } else {
+              throw new Error(`${resp.message}`);
+            }
+          })
+          // eslint-disable-next-line prefer-promise-reject-errors
+          .catch((e) => reject(`${chalk.bold.red(e)}`));
+      });
+    }
+
+    export const getServerLibraryArchive = async(appName, fileName, fileType, ruleSet, ruleSetVersion) => {
+    addDebugLog("getServerLibraryArchives", '', "");
+
+      const defaultPegaServerConfig = await getPegaServerConfig();
+      let url = constructCompleteUrl(
+        defaultPegaServerConfig.server,
+        COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT
+      );
+
+      let urlParams = `/app-name/${appName}/file-name/${fileName}/file-type/${fileType}/rulesetname/${ruleSet}/rulesetversion/${ruleSetVersion}`;
+      //let urlParams = `&ApplicationName=${ApplicationName}&ApplicationVersion=${ApplicationVersion}&RulesetName=${rulesetName}&RulesetVersion=${rulesetVersion}`;
+      //urlParams = encodeURIComponent(urlParams);
+
+
+      url = url.concat(urlParams);
+
+
+      return new Promise((resolve, reject) => {
+        try {
+          fs.readFile(TOKEN_PATH, 'utf8', (err, data) => {
+            if (err) {
+              // eslint-disable-next-line prefer-promise-reject-errors
+              reject(`\n${chalk.bold.red('Error occurred in authentication. Please regenerate using authenticate')}`);
+            }
+            if (data) {
+              const { access_token: accessToken, token_type: tokenType } = JSON.parse(data);
+
+              const headers = {};
+              headers.Authorization = `${tokenType} ${accessToken}`;
+
+              fetchComponentLibraryArchiveFromInfinity(url, headers)
+                .then((response) => resolve(response))
+                .catch((e) => reject(e));
+
+            }
+          });
+        } catch (error) {
+          console.log(`\n${chalk.bold.red(error)}`);
+          // eslint-disable-next-line prefer-promise-reject-errors
+          reject(`${chalk.bold.red(error)}`);
+        }
+      });
+
+    }

package/src/tasks/import-archive/index.js

@@ -6,6 +6,7 @@ import inquirer from 'inquirer';
 import ncp from 'ncp';
 import chalk from 'chalk';
 import { Listr } from 'listr2';
+import archiver from 'archiver';
 
 import StreamZip from 'node-stream-zip';
 
@@ -17,6 +18,7 @@ import {
   showVersion,
   getDirectoryFiles,
   addDebugLog,
+  checkAccessTokenExpiration,
   checkLibraryAndArchives,
   getConfigDefaults,
   getLibraryBased,
@@ -31,7 +33,7 @@ import {
   getLibraryBasedCL
  } from '../../util.js';
 import { TASKS_CONFIG_JSON_FILENAME, ARCHIVES_PATH, TEMP_PATH } from '../../constants.js';
-import { getFilePathQuestions, getFileNameQuestions, updateTempArchive, updateSavedFilePath  } from './helper.js';
+import { getFilePathQuestions, getFileNameQuestions, updateTempArchive, updateSavedFilePath, getServerOrDirectoryQuestion, getLibraryArchiveQuestion, getServerLibraryArchives, getServerLibraryArchive  } from './helper.js';
 import { showCurrentStatus } from '../show-status/index.js';
 
 export const DXCB_CONFIG_INTERNAL_JSON_FILENAME = 'src/dxcb.config.json';
@@ -236,6 +238,8 @@ addDebugLog("importArch", `filePath: ${filePath}, fileName: ${fileName}`, "");
 
   const currentDirectory = process.cwd();
   const tempDirectory = join(currentDirectory, TEMP_PATH);
+
+
   const zipFilePath = join(filePath, fileName);
 
 
@@ -274,6 +278,8 @@ addDebugLog("importArch", `filePath: ${filePath}, fileName: ${fileName}`, "");
 
   await unZipFromArchive(zipFilePath);
 
+
+
   // if (!fs.existsSync(tempTasksConfig) || !fs.existsSync(tempPackage)) {
   //   console.log(chalk.red.bold(`Zip file: ${fileName} not a compatible DX Component archive.`));
   //   console.log(chalk.red.bold("Cleaning up..."));
@@ -431,6 +437,37 @@ export const getZipFileList = async(filePath) => {
   }
 }
 
+function decodeBase64(encodedString) {
+  try {
+    const decodedString = atob(encodedString);
+    return decodedString;
+  } catch (error) {
+    console.error("Error decoding base64 string:", error);
+    return null;
+  }
+}
+
+export const writeZipBuffer = async(fileName, fileBuffer) => {
+  const currentDirectory = process.cwd();
+  const tempDirectory = join(currentDirectory, TEMP_PATH);
+
+  // have to decode it and then re-encode it.
+  let decodedString;
+  try {
+    decodedString = atob(fileBuffer);
+  } catch (error) {
+  }
+
+  if (!fs.existsSync (tempDirectory)) {
+    fs.mkdirSync(tempDirectory);
+  }
+
+  const filePath = join(tempDirectory, fileName);
+
+  fs.writeFileSync(filePath, fileBuffer, 'base64');
+
+}
+
 export default async options => {
   await showVersion();
   // await checkLibraryAndArchives();
@@ -449,9 +486,11 @@ export default async options => {
   addDebugLog("importArchive", "", "+");
 
 
-  if (options.params.length >= 5) {
-    const filePath = options.params[3];
-    const fileName = options.params[4];
+  if (options.params.length >= 6) {
+    const localOrServer = options.params[3];
+    const filePath = options.params[4];
+    const fileName = options.params[5];
+
     await importArch( filePath, fileName, hasArch);
 
   }
@@ -459,43 +498,119 @@ export default async options => {
 
     inquirer.registerPrompt('fuzzypath', inquirerFuzzyPath);
 
-    let filePathQuestions;
-    try {
-      filePathQuestions = await getFilePathQuestions();
-    }
-    catch (ex) {
-      process.exit(1);
-    }
 
+    const localOrServerQuestion = await getServerOrDirectoryQuestion();
+    const localOrServerAnswer = await inquirer.prompt(localOrServerQuestion);
+    const {importFrom} = localOrServerAnswer;
 
-    let filePathAnswers;
-    try {
-      filePathAnswers = await inquirer.prompt(filePathQuestions);
-    }
-    catch(ex) {
-      process.exit(1);
-    }
+    if (importFrom === "Server") {
 
-    const { filePath } = filePathAnswers;
-    const zipFileList = await getZipFileList(filePath);
 
-    if (!zipFileList || zipFileList.length === 0) {
-      console.log(chalk.red.bold(`No zip files exist at path: ${filePath}`));
-      process.exit();
+      await checkAccessTokenExpiration();
+
+      let archiveVersions = [];
+      try {
+        archiveVersions = await getServerLibraryArchives();
+      }
+      catch (ex) {
+        console.log(chalk.redBright(ex));
+      }
+
+
+      if (archiveVersions && archiveVersions.pxResults.length > 0) {
+        // ALL option
+
+        // to name value pairs
+        const archiveResults = archiveVersions["pxResults"].map( archive => ( { value: `${archive.pyApplicationName},${archive.pyFileName},${archive.pyFileType},${archive.pyRuleSet},${archive.pyRuleSetVersion}`, name: `${archive.pyLabel}, ${archive.pyRuleSet}:${archive.pyRuleSetVersion}` }) );
+
+
+        const versionQuestions = await getLibraryArchiveQuestion(archiveResults);
+        const versionAnswers = await inquirer.prompt(versionQuestions);
+
+        const {archiveData} = versionAnswers;
+
+        if (archiveData != "") {
+
+          const arArchData = archiveData.split(",");
+          let fileName = `${arArchData[1]}.${arArchData[2]}`;
+          // get archive
+          const fileData = await getServerLibraryArchive(arArchData[0],arArchData[1], arArchData[2], arArchData[3], arArchData[4]);
+
+          // console.log(fileSource);
+
+          // fileName = "big.zip";
+
+
+          await writeZipBuffer(fileName, fileData.pyFileSource);
+
+
+
+          // import archive
+          const currentDirectory = process.cwd();
+          const tempDirectory = join(currentDirectory, TEMP_PATH);
+
+          await importArch( tempDirectory, fileName, hasArch);
+          // const zipFilePath = join(tempDirectory, fileName);
+          //await unZipFromArchive(zipFilePath);
+
+
+
+
+        }
+
+
+
+      }
+      else {
+        // No library with that name
+        console.log(chalk.redBright(`No library archives exist on server.`));
+        process.exit(1);
+
+      }
+
     }
+    else {
+      let filePathQuestions;
+      try {
+        filePathQuestions = await getFilePathQuestions();
+      }
+      catch (ex) {
+        process.exit(1);
+      }
 
-    await updateSavedFilePath(filePath);
 
-    const fileNameQuestions = await getFileNameQuestions(zipFileList);
-    const fileNameAnswers = await inquirer.prompt(fileNameQuestions);
-    const {fileName} = fileNameAnswers;
+      let filePathAnswers;
+      try {
+        filePathAnswers = await inquirer.prompt(filePathQuestions);
+      }
+      catch(ex) {
+        process.exit(1);
+      }
+
+      const { filePath } = filePathAnswers;
+      const zipFileList = await getZipFileList(filePath);
+
+      if (!zipFileList || zipFileList.length === 0) {
+        console.log(chalk.red.bold(`No zip files exist at path: ${filePath}`));
+        process.exit();
+      }
+
+      await updateSavedFilePath(filePath);
+
+      const fileNameQuestions = await getFileNameQuestions(zipFileList);
+      const fileNameAnswers = await inquirer.prompt(fileNameQuestions);
+      const {fileName} = fileNameAnswers;
+
+
+      await importArch( filePath, fileName, hasArch);
+
+      // reapply to save if changed, because imported task.config may have overriden and we want
+      // to keep what was entered as the latest
+      await updateSavedFilePath(filePath);
+    }
 
 
-    await importArch( filePath, fileName, hasArch);
 
-    // reapply to save if changed, because imported task.config may have overriden and we want
-    // to keep what was entered as the latest
-    await updateSavedFilePath(filePath);
 
 
 

package/src/tasks/index.js

@@ -38,3 +38,4 @@ export { default as buildAllComponents } from './build-all/index.js';
 export { default as buildLibrary } from './build-lib/index.js';
 export { default as buildJestAssets } from './build-jest-assets/index.js';
 export { default as restoreConfig } from './restore-config/index.js';
+export { default as restore } from './restore/index.js';

package/src/tasks/init/template/package.json.mustache

@@ -41,6 +41,7 @@
     "deleteLibVersion": "custom-dx-components deleteVersion",
     "move": "custom-dx-components moveComponent",
     "publishLibVersion": "custom-dx-components publish",
+    "restoreLibVersion": "custom-dx-components restore",
     "storeLibVersion": "custom-dx-components storeComponents",
     "showStatus": "custom-dx-components showStatus",
     "setPermanent": "custom-dx-components setPermanent",
@@ -106,7 +107,7 @@
     "@babel/preset-react": "^7.26.3",
     "@babel/preset-typescript": "^7.26.0",
     "@pega/configs": "^0.16.2",
-    "@pega/custom-dx-components": "~0.25.17",
+    "@pega/custom-dx-components": "~0.25.19",
     "@pega/pcore-pconnect-typedefs": "^4.1.0-alpha.1",
     "@storybook/addon-actions": "^7.6.19",
     "@storybook/addon-essentials": "^7.6.19",

package/src/tasks/list-pub/helper.js

@@ -83,8 +83,8 @@ addDebugLog("listLibJSONResponse", "services end", "");
 
 }
 
-async function fetchComponenLibrariessFromInfinity(apiUrl, headers) {
-addDebugLog("fetchComponenLibrariessFromInfinity", `apiUrl: ${apiUrl}`, "");
+async function fetchComponentLibrariesFromInfinity(apiUrl, headers) {
+addDebugLog("fetchComponentLibrariesFromInfinity", `apiUrl: ${apiUrl}`, "");
   const serverConfig = await getPegaServerConfig();
   return new Promise((resolve, reject) => {
     let status = 500;
@@ -161,7 +161,7 @@ addDebugLog("getInfinityLibraries", '', "");
           const headers = {};
           headers.Authorization = `${tokenType} ${accessToken}`;
 
-          fetchComponenLibrariessFromInfinity(url, headers)
+          fetchComponentLibrariesFromInfinity(url, headers)
             .then((response) => resolve(response))
             .catch((e) => reject(e));
 

package/src/tasks/publish-archive/index.js

@@ -11,7 +11,7 @@ import { getPublishComponentQuestions } from './helper.js';
 
 import {
   LP_PUBLISH_COMPONENT_SERVICE_REST_ENDPOINT,
-  PUBLISH_COMPONENT_ARCHIVE_SERVICE_REST_ENDPOINT,
+  PUBLISH_COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT,
   TEMP_PATH,
   TOKEN_PATH,
   ARCHIVES_PATH
@@ -56,7 +56,7 @@ export const publishComponentLibraryArchiveToServer = async (data, doFetch) => {
     const defaultPegaConfig = await getPegaServerConfig();
     const url = constructCompleteUrl(
       defaultPegaConfig.server,
-      isLaunchpad ? launchpadRestEndpoint : PUBLISH_COMPONENT_ARCHIVE_SERVICE_REST_ENDPOINT
+      isLaunchpad ? launchpadRestEndpoint : PUBLISH_COMPONENT_LIBRARY_ARCHIVE_SERVICE_REST_ENDPOINT
     );
 
     if (doFetch) {
@@ -157,6 +157,7 @@ export default async (orgLibName, selectedVersion) => {
 
   if (orgLibName === configDef.currentOrgLib && selectedVersion === configDef.buildVersion) {
 
+    /*
     console.log("\nYou've selected the current working library/version.");
     console.log("Export store or the current.");
     const archAnswers = await inquirer.prompt([
@@ -174,6 +175,8 @@ export default async (orgLibName, selectedVersion) => {
     if (currentOrStore === "Current") {
       archiveBeforeStore = true;
     }
+    */
+    archiveBeforeStore = true;
 
     if (archiveBeforeStore) {
 

package/src/tasks/publish-lib/index.js

@@ -70,7 +70,9 @@ export const zipLibraryComponent = async (libraryName, version) => {
   const currentDirectory = process.cwd();
   const libraryDirName = `${libraryName}/${version}`;
   const libraryDirectory = path.join(currentDirectory, libraryDirName);
-  const componentsConfigJson = `${libraryDirectory}/componentsconfig.json`;
+  const componentsConfigJson = path.join(libraryDirectory, "componentsconfig.json");
+  // const componentsConfigJson = `${libraryDirectory}/componentsconfig.json`;
+  const localizationsJson = path.join(libraryDirectory, "componentslocalization.json");
 
 
   const archive = archiver('zip', { zlib: { level: 9 } });
@@ -85,6 +87,11 @@ export const zipLibraryComponent = async (libraryName, version) => {
     archive.file(componentsConfigJson, { name: path.basename(componentsConfigJson) });
   }
 
+  // Add localizations file
+  if (fs.existsSync(localizationsJson)) {
+    archive.file(localizationsJson, { name: path.basename(localizationsJson) });
+  }
+
 
   await archive.finalize();
 
@@ -93,6 +100,10 @@ export const zipLibraryComponent = async (libraryName, version) => {
   const zipContent = zipBuffer.toString('base64');
 
   const configContent = Buffer.from(fs.readFileSync(componentsConfigJson)).toString();
+  let localizationsContent = "[]";
+  if (fs.existsSync(localizationsJson)) {
+    localizationsContent = Buffer.from(fs.readFileSync(localizationsJson)).toString();
+  }
 
   // if (fs.existsSync(libraryDirectory)) {
   //   fs.rm(libraryDirectory, { recursive: true }, err => {
@@ -102,13 +113,13 @@ export const zipLibraryComponent = async (libraryName, version) => {
   //   });
   // }
 
-  return { zipContent, configContent };
+  return { zipContent, configContent, localizationsContent};
 };
 
 
 export const publishComponentLibraryToServer = async (data, doFetch) => {
   addDebugLog("publishComponentToServer", `data: ${data}`, "");
-    const { configContent, zipContent, rulesetName, rulesetVersion, libraryName, version } = data;
+    const { configContent, zipContent, localizationsContent, rulesetName, rulesetVersion, libraryName, version } = data;
 
     const defaultPegaServerConfig = await getPegaServerConfig();
     const { serverType, isolationId } = defaultPegaServerConfig;
@@ -138,7 +149,8 @@ export const publishComponentLibraryToServer = async (data, doFetch) => {
         rulesetVersion,
         libraryName,
         version,
-        category: ''
+        category: '',
+        localizationsContent
       };
     }
 

package/src/tasks/restore/index.js

@@ -0,0 +1,72 @@
+
+import { Listr } from 'listr2';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+
+import {
+  showVersion,
+  addDebugLog,
+  checkLibraryAndArchives,
+  getConfigDefaults,
+  getLibraryBased,
+  restoreFromArchive,
+  cleanUpTemp
+ } from '../../util.js';
+
+export default async options => {
+  await showVersion();
+  await checkLibraryAndArchives();
+
+addDebugLog("restoreComponent", "", "+");
+
+  await cleanUpTemp();
+
+  const isLibraryBased = getLibraryBased();
+  if (!isLibraryBased) {
+    console.log(`Command only supported for ${chalk.bold.green('library mode')} components.`)
+    process.exit();
+  }
+  const confDef = getConfigDefaults();
+
+  console.log(chalk.bold.yellow('\nChanges not saved to local storage will be LOST, code will be restored from local storage.'));
+  console.log("");
+
+  const restoreFromStore = await inquirer.prompt([
+    {
+      name: 'confirmRestore',
+      type: 'confirm',
+      message: `Restoring ${chalk.bold.green(`${confDef.displayLibVersion}`)} from local storage, proceed ?`,
+      default: true
+    }
+  ]);
+
+  if (restoreFromStore.confirmRestore) {
+    const switchToFileName = `${confDef.currentOrgLib}_${confDef.version}.arch.zip`;
+    const tasks = new Listr(
+      [
+        {
+          title: `Restoring ${confDef.displayLibVersion}`,
+          task: async () => {
+            // await zipVersionAndArchive(confDef.currentOrgLib, confDef.buildVersion);
+            await restoreFromArchive(switchToFileName, confDef.currentOrgLib, confDef.version);
+          }
+        }
+      ],
+      { concurrent: false, exitOnError: true }
+    );
+
+    await tasks.run().catch(err => {
+      console.log(chalk.bold.red(err.toString()));
+  addDebugLog("restoreComponent", "", "-");
+      process.exit(1);
+    });
+    console.log(chalk.greenBright('\nComponents restored'));
+  }
+
+
+
+
+
+addDebugLog("restoreComponent", "", "-");
+
+};

package/src/tasks/show-help/index.js

@@ -3,7 +3,7 @@ import path from 'path';
 
 import chalk from 'chalk';
 
-import { showVersion, getLibraryBased } from '../../util.js';
+import { showVersion, getLibraryBased, getLibraryBasedCL } from '../../util.js';
 
 export const showCurrentStatus = async () => {
 
@@ -58,9 +58,11 @@ export const showHelpV1 = () => {
 
 };
 
-export const showHelpV2 = () => {
+export const showHelpV2 = (isCL) => {
   console.log("");
-  console.log(chalk.yellow("**** Beta capability and subject to change.  Developer experimental.  Do not use in a Production Deployment. ***\n"));
+  if (!isCL) {
+    console.log(chalk.yellow("**** Beta capability and subject to change.  Developer experimental.  Do not use in a Production Deployment. ***\n"));
+  }
   console.log(`--> All commands will not work until a library is created via ${chalk.cyan(`npm run createLib`)}.`);
   console.log(`\nnpm run <command>`);
   console.log(`\nUsage:`);
@@ -80,10 +82,18 @@ export const showHelpV2 = () => {
   console.log(`${chalk.cyan('npm run createLibVersion')}\tcreate a new version within the current library`);
   console.log(`${chalk.cyan('npm run switchLibVersion')}\tswitch to different version within the current library`);
   console.log(`${chalk.cyan('npm run deleteLibVersion')}\tdelete current version, move to another version`);
+  console.log(`${chalk.cyan('npm run restoreLibVersion ')}\trestore current version from local storage (current changes will be LOST)`);
   console.log(`${chalk.cyan('npm run storeLibVersion ')}\tstore current version to local storage (must SAVE components before)`);
-  console.log(`${chalk.cyan('npm run exportLibVersion')}\texport current version as a zip file to a given local path (must SAVE components before)`);
-  console.log(`${chalk.cyan('npm run importLibVersion')}\timport a zip file (created by export) from a given local path`);
-  console.log(`${chalk.cyan('npm run setPermanent    ')}\tmake current version permanent or non permanent upon publish`);
+  if (isCL) {
+    console.log(`${chalk.cyan('npm run exportLibVersion')}\texport current version as a zip file to a given local path or a server (must SAVE components before)`);
+    console.log(`${chalk.cyan('npm run importLibVersion')}\timport a zip file (created by export) from a given local path or a server`);
+  }
+  else {
+    console.log(`${chalk.cyan('npm run exportLibVersion')}\texport current version as a zip file to a given local path (must SAVE components before)`);
+    console.log(`${chalk.cyan('npm run importLibVersion')}\timport a zip file (created by export) from a given local path`);
+    console.log(`${chalk.cyan('npm run setPermanent    ')}\tmake current version permanent or non permanent upon publish`);
+  }
+
 
   console.log(`\n${chalk.underline(`Published Versions (needs authentication)`)}`);
   console.log(`${chalk.cyan('npm run publish           ')}\tpublish current library/version to server (creates a local published library as well)`);
@@ -109,17 +119,25 @@ export const showHelpV2 = () => {
   console.log(`${chalk.cyan(`createLib, switchLib, createLibVersion, switchLibVersion, publishLibVersion, exportLibVersion`)}`);
   console.log(`\nWhen editing in an IDE, always ${chalk.yellow("SAVE")} changes to components before doing a library/version context switch`);
   console.log(`or changes will be lost!`);
+  console.log(`\nStoring is to LOCAL storage and is not backed up.  You should export your library/versions archives to ${chalk.yellow("git")}`);
+  if (isCL) {
+    console.log(`or export archives to ${chalk.yellow("server")} for backup storage.`);
+  }
+  else {
+    console.log(`for backup storage.`);
+  }
   console.log("");
 }
 
 
 export default async options => {
   const isLibraryBased =  getLibraryBased();
+  const isLibraryBasedCL = getLibraryBasedCL();
 
   await showVersion();
 
   if (isLibraryBased) {
-    await showHelpV2();
+    await showHelpV2(isLibraryBasedCL);
   }
   else {
     await showHelpV1();

package/src/util.js

@@ -1847,6 +1847,9 @@ if (showDebug) addDebugLog("zipVersionAndArchive", `orgLibName: ${orgLibName}, v
 
 };
 
+
+
+
 export const zipVersionAndArchiveAndReturnBuffer = async (orgLibName, version, currentDirectory = "") => {
 if (showDebug) addDebugLog("zipVersionAndArchive", `orgLibName: ${orgLibName}, version: ${version}`, "");
   // const srcDirectoryPath = await getSrcDirectoryPath();
@@ -1963,7 +1966,7 @@ export const zipUnArchiveToTempAndReturnBuffer = async(orgLibName, version) => {
     for (const configF of configFiles) {
       if (configF !== "package-lock.json") {
         archive.file(
-          join(currentDirectory, configF), { name: configF });
+          join(tempDirectory, configF), { name: configF });
       }
 
     }