@pega/custom-dx-components 0.25.65 → 0.25.67

package/README.md

@@ -37,9 +37,9 @@ Ensure you have access to the following in your system:
 
 - Git version 2.30 or later
 
-- System node version >= 22.15.0
+- System node version >= 24.4.1
 
-- System npm version 10.9.2
+- System npm version 11.4.2
 
 ## Latest Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/custom-dx-components",
-  "version": "0.25.65",
+  "version": "0.25.67",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
   "keywords": [

package/src/tasks/create/index.js

@@ -26,7 +26,9 @@ import {
   getConfigDefaults,
   getSubTypeLabel,
   getMaxComponentNameCount,
-  getStandaloneMaxComponentNameCount
+  getStandaloneMaxLibraryCount,
+  getStandaloneMaxComponentNameCount,
+  getStandaloneMaxLibraryFromPrefixCount
 } from '../../util.js';
 import { COMPONENT_SCHEMA, SHARED_FILE_NAMES } from '../../constants.js';
 
@@ -38,6 +40,7 @@ const copyComponentTemplate = async options => {
   });
 };
 
+
 const compileMustacheTemplates = async (
   componentDirectory,
   {
@@ -305,6 +308,7 @@ addDebugLog("create", "", "+");
       options
     );
   } else {
+    const framework = "Constellation";
     const componentDefaults = getConfigDefaults();
     const serverType = getServerType();
     const maxChars = isLibraryBased ? getMaxComponentNameCount() : getStandaloneMaxComponentNameCount();
@@ -400,10 +404,24 @@ addDebugLog("create", "", "+");
           return 'Please provide semver compatible version e.g 0.0.1';
         },
         when: () => !isLibraryBased
-      },
+      }
+
+    ];
+
+    const answers = await inquirer.prompt(questions);
+    const maxLibChars = await getStandaloneMaxLibraryCount(answers.componentName);
+
+    const libQuestions = [
       {
         name: 'library',
-        message: 'Enter library name (required)',
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter library name (required)`;
+          }
+          else {
+            return `Enter library name (required) (${maxLibChars} max chars)`;
+          }
+        },
         default: componentDefaults.library,
         validate: value => {
           /* value should not be empty
@@ -412,6 +430,9 @@ addDebugLog("create", "", "+");
             Only case-insensitive alphanumeric values are allowed
           */
           if (value && !/^\d/.test(value) && value === sanitize(value)) {
+            if (value.length > maxLibChars && serverType != "launchpad") {
+              return `${value.length - maxLibChars} too many characters.`
+            }
             return true;
           }
           return 'Only alphanumeric values are allowed, starting with alphabets';
@@ -426,32 +447,22 @@ addDebugLog("create", "", "+");
       }
     ];
 
-    await inquirer.prompt(questions).then(async answers => {
-      const {
-        componentName,
-        componentLabel,
-        library,
-        version,
+    const libAnswers = await inquirer.prompt(libQuestions);
+
+    await validateCompile(
+      {
+        componentName : answers.componentName,
+        componentLabel : answers.componentLabel,
+        library : libAnswers.library,
+        version : answers.version,
         framework,
-        type,
-        subtype,
-        description
-      } = answers;
-
-      await validateCompile(
-        {
-          componentName,
-          componentLabel,
-          library,
-          version,
-          framework,
-          type,
-          subtype,
-          description
-        },
-        options
-      );
-    });
+        type : answers.type,
+        subtype : answers.subtype,
+        description : libAnswers.description
+      },
+      options
+    );
+
   }
 
   addDebugLog("create", "END", "-");

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

@@ -27,10 +27,13 @@ import { checkPathAccess, showVersion ,
   getConfigDefaults,
   getSubTypeLabel,
   getMaxPrefixCount,
-  getStandaloneMaxPrefixCount
+  getStandaloneMaxPrefixCount,
+  getMaxComponentLibraryCount,
+  getStandaloneMaxLibraryFromPrefixCount
 } from '../../util.js';
 
 import { COMPONENT_SCHEMA, COMPONENTS_DIRECTORY_PATH, TASKS_CONFIG_JSON_FILENAME, COMPONENTS_PATH, CATEGORY_CONSTELLATION, SHARED_FILE_NAMES } from '../../constants.js';
+import lib from 'babel-loader';
 
 export const DXCB_CONFIG_INTERNAL_JSON_FILENAME = 'src/dxcb.config.json';
 
@@ -418,7 +421,7 @@ addDebugLog("createAll", "", "+");
             return `Enter prefix label (${maxPrefixCount} max chars)`;
           }
         },
-          validate: value => {
+        validate: value => {
           /* value should not be empty
           It should not start with a number
           Only case-insensitive alphanumeric values are allowed
@@ -444,10 +447,24 @@ addDebugLog("createAll", "", "+");
           return 'Please provide semver compatible version e.g 0.0.1';
         },
         when: () => !isLibraryBased
-      },
-      {
+      }
+
+    ];
+
+    const answers = await inquirer.prompt(questions);
+    const maxLibChars = await getStandaloneMaxLibraryFromPrefixCount(answers.prefix);
+
+    const libQuestions = [
+    {
         name: 'library',
-        message: 'Enter library name (required)',
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter library name (required)`;
+          }
+          else {
+            return `Enter library name (required) (${maxLibChars} max chars)`;
+          }
+        },
         default: componentDefaults.library,
         validate: (value) => {
           /* value should not be empty
@@ -456,6 +473,9 @@ addDebugLog("createAll", "", "+");
             Only case-insensitive alphanumeric values are allowed
           */
           if (value && !/^\d/.test(value) && value === sanitize(value)) {
+            if (value.length > maxLibChars && serverType != "launchpad") {
+              return `${value.length - maxLibChars} too many characters.`
+            }
             return true;
           }
           return 'Only alphanumeric values are allowed, starting with alphabets';
@@ -464,28 +484,28 @@ addDebugLog("createAll", "", "+");
       }
     ];
 
-    await inquirer.prompt(questions).then(async (answers) => {
-      ({library} = answers);
+    const libAnswers = await inquirer.prompt(libQuestions);
+    library = libAnswers.library;
 
-      if (isLibraryBased) {
-        // library comes from config
-        const orgLib = getConfigDefaults();
-        library = orgLib.library;
-      }
+    if (isLibraryBased) {
+      // library comes from config
+      const orgLib = getConfigDefaults();
+      library = orgLib.library;
+    }
+
+    const { version } = answers;
+    let { prefix } = answers;
+    prefix = prefix.replace(/[^a-zA-Z0-9 ]/g, '');
+    await validateCompileAll(
+      {
+        prefix,
+        library,
+        version,
+        organization
+      },
+      options
+    );
 
-      const { version } = answers;
-      let { prefix } = answers;
-      prefix = prefix.replace(/[^a-zA-Z0-9 ]/g, '');
-      await validateCompileAll(
-        {
-          prefix,
-          library,
-          version,
-          organization
-        },
-        options
-      );
-    });
   }
 
 addDebugLog("createAll", "END", "-");

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

@@ -49,6 +49,7 @@ export const updateConfig = async (
     version,
     targetDirectory,
     newLabel = "",
+    organization
   },
   options,
   onlyCompanion = false
@@ -63,6 +64,7 @@ addDebugLog("updateConfig", `oldComponentKey: ${oldComponentKey}, newComponentKe
   if (configData.componentKey) configData.componentKey = newComponentKey;
   configData.library = library;
   configData.version = version;
+  configData.organization = organization;
 
   if (newLabel != "") {
     configData.label = newLabel;
@@ -97,17 +99,19 @@ addDebugLog("updateFile", `fileName: ${fileName}, oldComponentKeyPC: ${oldCompon
 // rename the component
 export const renameComponent = async (
     componentKey,
-    library,
+    orgLib,
     version,
     newName = "",
     newLabel = "",
+    organization,
     options
 ) => {
 
-addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKey}`, "");
+addDebugLog("renameComponent", `orgLib: ${orgLib}, componentKey: ${componentKey}`, "");
 
   const componentName = newName != "" ? newName : componentKey.split("_")[2];
-  const newComponentKey = `${library}_${componentName}`;
+  const newComponentKey = `${orgLib}_${componentName}`;
+  const library = orgLib.split("_")[1];
   const oldComponentKey = componentKey;
   const newComponentKeyPC = convertIntoPascalCase(newComponentKey);
   const oldComponentKeyPC = convertIntoPascalCase(oldComponentKey);
@@ -136,7 +140,8 @@ addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKe
           library,
           version,
           targetDirectory,
-          newLabel
+          newLabel,
+          organization
         },
         options
       );
@@ -252,7 +257,7 @@ addDebugLog("importComp", `filePath: ${filePath}, fileName: ${fileName}`, "");
 
     configData = configData && JSON.parse(configData);
 
-    const newCompKey = await renameComponent(configData.componentKey, configDef.currentOrgLib, configDef.buildVersion, newName, newLabel, null);
+    const newCompKey = await renameComponent(configData.componentKey, configDef.currentOrgLib, configDef.buildVersion, newName, newLabel, configDef.organization, null);
     console.log(`\n${chalk.green(`${fileName}`)} has been imported as ${chalk.green(`${newCompKey}`)}\n`);
 
     if (askValidate) {

package/src/tasks/init/template/README.md

@@ -37,9 +37,9 @@ Ensure you have access to the following in your system:
 
 - Git version 2.30 or later
 
-- System node version >= 22.15.0
+- System node version >= 24.4.1
 
-- System npm version 10.9.2
+- System npm version 11.4.2
 
 ## Latest Documentation
 

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

@@ -25,13 +25,13 @@
     "delete": "custom-dx-components delete",
     "deleteAll": "custom-dx-components deleteAll",
     "importComponent": "custom-dx-components importComponent",
-    "exportRC" : "custom-dx-components exportRC",
     "help": "custom-dx-components showHelp",
     "publish": "custom-dx-components publish",
     "_***Component_mode_only***": "Component only commands",
     "publishAll": "custom-dx-components publishAll",
     "promoteWebPack": "custom-dx-components promoteWebPack",
     "revertWebPack": "custom-dx-components revertWebPack",
+    "exportRC" : "custom-dx-components exportRC",
     "_***Library_mode_only***": "Library CL mode only commands",
     "createLib": "custom-dx-components createLibrary",
     "switchLib": "custom-dx-components switchLibrary",
@@ -108,7 +108,7 @@
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
     "@pega/configs": "^0.16.3",
-    "@pega/custom-dx-components": "~0.25.65",
+    "@pega/custom-dx-components": "~25.1.22",
     "@pega/pcore-pconnect-typedefs": "^4.1.0",
     "@storybook/addon-actions": "^8.6.14",
     "@storybook/addon-essentials": "^8.6.14",

package/src/tasks/validator/index.js

@@ -11,14 +11,17 @@ import {
 import {
   getComponentDirectoryPath,
   getComponents,
-  getOOTBComponents,
   isComponentValidLength,
-  addDebugLog } from '../../util.js';
+  getConfigDefaults,
+  getLibraryBasedCL } from '../../util.js';
 
 const ajv = new Ajv({ allErrors: true });
 
 const combinationTypes = ['PAGE', 'CASE'];
 
+const configDef = getConfigDefaults();
+const isLibraryBasedCL = getLibraryBasedCL();
+
 const allowedSubtypes = [
   ...new Set([
     ...COMPONENT_SCHEMA.subtype.field.map(({ value }) => value),
@@ -343,6 +346,14 @@ export default async (option) => {
     throw new Error(`Invalid: componentName is too long.`);
   }
 
+  if (isLibraryBasedCL) {
+    if (componentToValidate.indexOf(configDef.currentOrgLib + "_") != 0) {
+      const arPrefix = componentToValidate.split("_");
+      const sPrefix = `${arPrefix[0]}_${arPrefix[1]}`;
+      throw new Error(`Component: ${componentToValidate} prefix invalid.\n --> '${sPrefix}' prefix does not match configuration '${configDef.currentOrgLib}'. \n --> Org_Lib prefix of component must match Organization and Library values \n --> in package.json and tasks.config.json respectively.`);
+    }
+  }
+
   const componentDirectory = await getComponentDirectoryPath(componentToValidate);
   let configFileName = "config.json";
 
@@ -393,8 +404,47 @@ export default async (option) => {
       process.exit(1);
     }
 
+    if (isLibraryBasedCL) {
+      if (data.library !== configDef.library) {
+        throw new Error (`${chalk.redBright(`Error: Invalid library in config.json for component '${data.name}'.\n -->Library: '${data.library}' must match tasks.config library: '${configDef.library}'.`)}`);
+      }
+
+      if (data.organization !== configDef.organization) {
+        throw new Error (`${chalk.redBright(`Error: Invalid organization in config.json for component '${data.name}'.\n -->Organization: '${data.organization}' must match package.json organization: '${configDef.organization}'.`)}`);
+      }
+
+      if (data.componentKey.indexOf(configDef.currentOrgLib + "_") !== 0) {
+        const arPrefix = data.componentKey.split("_");
+        const sPrefix = `${arPrefix[0]}_${arPrefix[1]}`
+        throw new Error (`${chalk.redBright(`Error: Invalid componentKey in config.json for component '${data.name}'.\n --> Component prefix Org_Lib: '${sPrefix}' must match '${configDef.currentOrgLib}'. \n --> These represent organization and library values found in package.json and tasks.config.json respectively. `)}`);
+      }
+
+      if (data.componentKey !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or componentKey in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match component key '${data.componentKey}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+      if (data.name !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or name in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match name '${data.name}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+    }
+    else {
+      if (data.componentKey !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or componentKey in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match component key '${data.componentKey}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+      if (data.name !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or name in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match name '${data.name}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+    }
+
     console.log(`${chalk.bold.green(componentToValidate)} schema is valid`);
   } else {
     throw new Error(`Invalid: ${ajv.errorsText(validateSchema.errors)}`);
   }
+
+
+
+
 };

package/src/util.js

@@ -963,7 +963,7 @@ if (showDebug) { addDebugLog("getPegaConfig", "END", "-"); }
 export const getPegaServerConfig = async (force = false) => {
 if (showDebug) addDebugLog("getPegaServerConfig", "", "+");
   if (!pegaConfig || force) {
-    pegaConfig = await getPegaConfig();
+    pegaConfig = await getPegaConfig(force);
 
     if (getServerType() === "launchpad") {
 
@@ -1342,16 +1342,33 @@ export const showVersion = async () => {
     process.exit();
   }
 
-  // do a check of node version, it should be 18 or greater
+  // do a check of node version, it should be 24 or greater
   const arNodeVersion = process.versions.node.split('.');
 
   const nodeMajorVersion = parseInt(arNodeVersion[0]);
   const nodeMinorVersion = parseInt(arNodeVersion[1]);
+  const nodePatchVersion = parseInt(arNodeVersion[2]);
 
-  if (nodeMajorVersion < 22 && nodeMinorVersion < 15 ) {
+  if (nodeMajorVersion < 24) {
     console.log(
       chalk.redBright(
-        `DX Component Builder - requires node v22.15.0 or greater, current version: ${process.version}`
+        `DX Component Builder - requires node v24.4.1 or greater, current version: ${process.version}`
+      )
+    );
+    process.exit(1);
+  }
+  else if ( nodeMajorVersion == 24 && nodeMinorVersion < 4) {
+    console.log(
+      chalk.redBright(
+        `DX Component Builder - requires node v24.4.1 or greater, current version: ${process.version}`
+      )
+    );
+    process.exit(1);
+  }
+  else if (nodeMajorVersion == 24 && nodeMinorVersion == 4 && nodePatchVersion < 1 ) {
+    console.log(
+      chalk.redBright(
+        `DX Component Builder - requires node v24.4.1 or greater, current version: ${process.version}`
       )
     );
     process.exit(1);
@@ -1712,7 +1729,7 @@ if (showDebug) addDebugLog("getBootstrapConfig", `restServerUrl: ${restServerUrl
 
 export const updateC11NB2SForInfinity = async () => {
 if (showDebug) addDebugLog("updateC11NB2SForInfinity", "", "");
-  const serverConfig = await getPegaServerConfig();
+  const serverConfig = await getPegaServerConfig(true);
   const { server } = serverConfig;
   const OAuthData = fs.readFileSync(TOKEN_PATH, 'utf8');
 
@@ -2653,10 +2670,14 @@ if (showDebug) addDebugLog("deleteArchives", ``, "");
   }
 }
 
-export const checkLibraryAndArchives = async () => {
+export const checkLibraryAndArchives = async (checkArch = true) => {
 if (showDebug) addDebugLog("checkLibraryAndArchives", ``, "");
   const isLibraryBased =  getLibraryBased();
-  const hasArch = await hasArchives();
+  let hasArch  = true;
+  if (checkArch) {
+    hasArch = await hasArchives();
+
+  }
 
   if (isLibraryBased && !hasArch) {
     console.log(chalk.yellow('\nPlease create/import a library before proceeding.'));
@@ -2818,7 +2839,20 @@ export const getSubTypeLabel = (type, subtype) => {
 export const getMaxComponentNameCount = () => {
   let count = MAX_RFT_CHARS;
   const configDef = getConfigDefaults();
-  const orgLibCount = configDef.currentOrgLib.length + 1;
+  const orgLibCount = configDef.currentOrgLib.length + 1; // trailing underscore
+  const versionCount = configDef.version.length - 2;
+  const prefixCount = versionCount + 4;
+
+  count = count - orgLibCount - prefixCount - 9; // 9 chars for trailing hash
+
+  return count;
+
+}
+
+export const getMaxComponentLibraryCount = (componentName) => {
+  let count = MAX_RFT_CHARS;
+  const configDef = getConfigDefaults();
+  const orgLibCount = configDef.organization.length + componentName.length + 2; // 2 underscores
   const versionCount = configDef.version.length - 2;
   const prefixCount = versionCount + 4;
 
@@ -2839,16 +2873,35 @@ export const getStandaloneMaxComponentNameCount = () => {
 
 }
 
+export const getStandaloneMaxLibraryCount = async(componentName) => {
+
+  let count = MAX_RFT_CHARS;
+  const configDef = await getConfigDefaults();
+  const orgComp = `${configDef.organization}__${componentName}`;
+  const orgCompCount = orgComp.length + 1;
+
+  count = count - orgCompCount; // 9 chars for trailing hash
+
+  return count;
+
+}
+
 export const getMaxPrefixCount = () => {
   // TwoColumnDetails is 16 chars
   return (getMaxComponentNameCount() - 16);
 }
 
+
+
 export const getStandaloneMaxPrefixCount = () => {
   // TwoColumnDetails is 16 chars
   return (getStandaloneMaxComponentNameCount() - 16);
 }
 
+export const getStandaloneMaxLibraryFromPrefixCount = async(componentName) => {
+  return (await getStandaloneMaxLibraryCount(componentName) - 16);
+}
+
 export const isComponentValidLength = (componentKey) => {
   const serverType = getServerType();
   if (serverType === "launchpad") {