@pega/custom-dx-components 26.1.11 → 26.1.12-alpha.0.2

package/src/tasks/ai-toggle/index.js

@@ -0,0 +1,46 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { enableAgentFiles, removeAgentFiles, hasAgentFiles } from '../../ai/index.js';
+
+const TOOLS = 'Copilot, Claude Code, Cursor, Codex, Gemini';
+
+export const enableAi = async () => {
+  const projectDirectory = process.cwd();
+  const alreadyEnabled = hasAgentFiles(projectDirectory);
+
+  await enableAgentFiles(projectDirectory);
+
+  console.log(
+    alreadyEnabled
+      ? `${chalk.green('AI-assisted development is already enabled.')} Missing files were restored; your edits were kept.`
+      : `${chalk.green('AI-assisted development enabled')} ${chalk.blue(`(${TOOLS})`)}.`,
+  );
+};
+
+export const disableAi = async (options) => {
+  const projectDirectory = process.cwd();
+
+  if (!hasAgentFiles(projectDirectory)) {
+    console.log(chalk.yellow('AI-assisted development is not enabled in this project. Nothing to remove.'));
+    return;
+  }
+
+  if (!options.yes) {
+    const { confirmed } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirmed',
+        message:
+          'Disable AI-assisted development? This deletes the AGENTS.md and skills that were installed, including any edits you made to them. Your other files are kept.',
+        default: false,
+      },
+    ]);
+    if (!confirmed) {
+      console.log('Nothing was changed.');
+      return;
+    }
+  }
+
+  await removeAgentFiles(projectDirectory);
+  console.log(`${chalk.green('AI-assisted development disabled.')} Run ${chalk.cyan('npm run enableAi')} to turn it back on.`);
+};

package/src/tasks/authenticate/helper.js

@@ -1,7 +1,7 @@
 import { AUTHENTICATE_SCHEMA, AUTHENTICATE_DEFAULTS } from '../../constants.js';
 import { isCompleteHttpUrl } from '../../util.js';
 
-export const getAuthQuestions = async dxcbConfig => {
+export const getAuthQuestions = async (dxcbConfig) => {
   const defaultPegaConfig = dxcbConfig;
   const aAlwaysAsk = dxcbConfig.questions_askAlways ? dxcbConfig.questions_askAlways.split(',') : [];
   const aNeverAsk = dxcbConfig.questions_askNever ? dxcbConfig.questions_askNever.split(',') : [];
@@ -9,7 +9,7 @@ export const getAuthQuestions = async dxcbConfig => {
   const aAskedOnce = dxcbConfig.questions_askedOnce ? dxcbConfig.questions_askedOnce.split(',') : [];
 
   // Ask if various must, never, once criteria are met
-  const askThisTime = prop => {
+  const askThisTime = (prop) => {
     return aAlwaysAsk.includes(prop) || (!aNeverAsk.includes(prop) && aAskOnce.includes(prop) && !aAskedOnce.includes(prop));
   };
 
@@ -20,7 +20,7 @@ export const getAuthQuestions = async dxcbConfig => {
     return defaultPegaConfig[prop] ? defaultPegaConfig[prop] : defValue;
   };
 
-  const initAnswers = answers => {
+  const initAnswers = (answers) => {
     // Setup default answers (if they are present and non-empty)
     answers.serverType = initAnswer('serverType', AUTHENTICATE_DEFAULTS.serverType);
     answers.isVanity = defaultPegaConfig.isVanity;
@@ -50,103 +50,103 @@ export const getAuthQuestions = async dxcbConfig => {
       name: 'serverType',
       type: 'rawlist',
       message: 'Enter Pega server type',
-      default: answers => {
+      default: (answers) => {
         return defaultPegaConfig.serverType;
       },
       choices: AUTHENTICATE_SCHEMA.serverType,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'Pega server type cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         initAnswers(answers);
         return fnStandardWhen('serverType', answers);
-      }
+      },
     },
     {
       name: 'server',
       type: 'input',
       message: 'Enter pega server url',
       default: defaultPegaConfig.server,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'Pega server cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return fnStandardWhen('server', answers);
-      }
+      },
     },
     {
       name: 'grantType',
       type: 'rawlist',
       message: 'Enter OAuth 2.0 grant type',
       default: defaultPegaConfig.grantType,
-      choices: answers => {
-        return AUTHENTICATE_SCHEMA.grantType.filter(gt => !(answers.serverType === 'launchpad' && gt.value === 'passwordCreds'));
+      choices: (answers) => {
+        return AUTHENTICATE_SCHEMA.grantType.filter((gt) => !(answers.serverType === 'launchpad' && gt.value === 'passwordCreds'));
       },
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'Grant type cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return fnStandardWhen('grantType', answers);
-      }
+      },
     },
     {
       name: 'authorizeUri',
       type: 'input',
       message: 'Enter complete authorization URL',
       default: defaultPegaConfig.authorizeUri,
-      validate: value => isCompleteHttpUrl(value) || 'Authorization URL must be a complete HTTP(S) URL',
-      when: answers =>
+      validate: (value) => isCompleteHttpUrl(value) || 'Authorization URL must be a complete HTTP(S) URL',
+      when: (answers) =>
         answers.serverType === 'launchpad' &&
         answers.isVanity !== false &&
         answers.grantType === 'authCode' &&
-        fnStandardWhen('authorizeUri', answers)
+        fnStandardWhen('authorizeUri', answers),
     },
     {
       name: 'tokenUri',
       type: 'input',
       message: 'Enter complete access token URL',
       default: defaultPegaConfig.tokenUri,
-      validate: value => isCompleteHttpUrl(value) || 'Access token URL must be a complete HTTP(S) URL',
-      when: answers => answers.serverType === 'launchpad' && answers.isVanity !== false && fnStandardWhen('tokenUri', answers)
+      validate: (value) => isCompleteHttpUrl(value) || 'Access token URL must be a complete HTTP(S) URL',
+      when: (answers) => answers.serverType === 'launchpad' && answers.isVanity !== false && fnStandardWhen('tokenUri', answers),
     },
     {
       name: 'authService',
       type: 'input',
       message: 'Enter authentication service alias',
       default: defaultPegaConfig.authService,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'Authentication service alias cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return answers.serverType === 'infinity' && answers.grantType === 'authCode' && fnStandardWhen('authService', answers);
-      }
+      },
     },
     {
       name: 'redirectUri',
       type: 'input',
-      message: 'Enter valid redirect Uri within OAuth 2.0 client reg reccord',
+      message: 'Enter valid redirect Uri within OAuth 2.0 client reg record',
       default: defaultPegaConfig.redirectUri,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'Redirect URI cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return answers.serverType === 'infinity' && answers.grantType === 'authCode' && fnStandardWhen('redirectUri', answers);
-      }
+      },
     },
     {
       name: 'user',
@@ -159,9 +159,9 @@ export const getAuthQuestions = async dxcbConfig => {
         }
         return 'Username cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return answers.serverType === 'infinity' && answers.grantType === 'passwordCreds' && fnStandardWhen('user', answers);
-      }
+      },
     },
     {
       name: 'password',
@@ -174,42 +174,42 @@ export const getAuthQuestions = async dxcbConfig => {
         }
         return 'Password cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return answers.user && answers.serverType === 'infinity' && answers.grantType === 'passwordCreds' && fnStandardWhen('password', answers);
-      }
+      },
     },
     {
       name: 'clientId',
       type: 'input',
       message: 'Enter clientId',
       default: defaultPegaConfig.clientId,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'clientId cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return fnStandardWhen('clientId', answers);
-      }
+      },
     },
     {
       name: 'clientSecret',
       type: 'password',
       message: 'Enter clientSecret',
       default: defaultPegaConfig.clientSecret,
-      validate: value => {
+      validate: (value) => {
         if (value.trim()) {
           return true;
         }
         return 'clientSecret cannot be empty';
       },
-      when: answers => {
+      when: (answers) => {
         return (
           ((answers.serverType === 'infinity' && answers.grantType !== 'authCode') || answers.serverType === 'launchpad') &&
           fnStandardWhen('clientSecret', answers)
         );
-      }
-    }
+      },
+    },
   ];
 };

package/src/tasks/authenticate/index.js

@@ -13,9 +13,8 @@ import { getAuthQuestions } from './helper.js';
 export const TASKS_CONFIG_JSON_FILENAME = 'tasks.config.json';
 
 const pegaConfigJsonPath = path.join(path.resolve(), TASKS_CONFIG_JSON_FILENAME);
-const server = null;
 
-export const generateAccessToken = async config => {
+export const generateAccessToken = async (config) => {
   let authSuccess = false;
   const { serverType, authService, isolationId, grantType, clientId, clientSecret, user, password, legacyTLS } = config;
   const launchpadVanity = isLaunchpadVanity(config);
@@ -63,7 +62,7 @@ export const generateAccessToken = async config => {
             cert: config.cert,
             key: config.key,
             winTitle: 'DX Component Dev',
-            winBodyHtml: browserAuthSuccessMarkup
+            winBodyHtml: browserAuthSuccessMarkup,
           }
         : {};
 
@@ -77,7 +76,7 @@ export const generateAccessToken = async config => {
       clientSecret,
       ignoreInvalidCerts: true,
       useNodeFetch: false,
-      ...authCodeConfig
+      ...authCodeConfig,
     };
     if (legacyTLS) {
       authConfig.legacyTLS = true;
@@ -99,16 +98,16 @@ export const generateAccessToken = async config => {
       const auth = new PegaAuth(authConfig);
       if (grantType === 'authCode') {
         console.log(
-          `${chalk.green('Awaiting authorization to complete (Ctrl-C to exit).  You may need to enter credentials within your default browser.')}`
+          `${chalk.green('Awaiting authorization to complete (Ctrl-C to exit).  You may need to enter credentials within your default browser.')}`,
         );
       }
       // console.log(`authConfig: ${JSON.stringify(authConfig)}`);
 
       auth
         .login()
-        .then(token => {
+        .then((token) => {
           if (token?.token_type) {
-            fs.writeFile(TOKEN_PATH, JSON.stringify(token), err => {
+            fs.writeFile(TOKEN_PATH, JSON.stringify(token), (err) => {
               if (err) {
                 console.error(err);
                 return reject(authSuccess);
@@ -122,18 +121,18 @@ export const generateAccessToken = async config => {
             return reject(authSuccess);
           }
         })
-        .catch(e => {
+        .catch((e) => {
           console.log(`${chalk.bold.red(`Authentication failed:${e}`)}`);
           return reject(authSuccess);
         });
-    } catch (e) {
+    } catch {
       console.log(`Authentication failed: Problem initializing OAuth library`);
       return reject(authSuccess);
     }
   });
 };
 
-export default async options => {
+export default async () => {
   let authOK = false;
 
   await showVersion();
@@ -145,7 +144,7 @@ export default async options => {
   if (cfgData) {
     try {
       data = JSON.parse(cfgData);
-    } catch (e) {
+    } catch {
       console.log(`${chalk.red('Invalid JSON within tasks.config.json')}`);
       process.exit(1);
     }
@@ -175,7 +174,7 @@ export default async options => {
     'redirectUri',
     'clientSecret',
     'user',
-    'password'
+    'password',
   ];
   const isLaunchPad = answers.serverType === 'launchpad';
   let bWriteUpdate = false;
@@ -223,19 +222,22 @@ export default async options => {
       serverConfig.password = '';
     }
     console.log(`${chalk.green('Writing updated config...')}`);
-    let updCfg = null;
+    let updCfg;
     try {
       updCfg = JSON.stringify(data, null, 2);
       // console.log(`updated config: ${updCfg}`);
-      fs.writeFileSync(pegaConfigJsonPath, updCfg, err => {
+      fs.writeFileSync(pegaConfigJsonPath, updCfg, (err) => {
         if (err) throw err;
       });
-    } catch (e) {}
+    } catch {
+      // ignore write errors
+    }
   }
 
   if (authOK) {
     // get C11B2S token
     if (isLaunchPad) {
+      // no-op for Launchpad, token already obtained above
     } else {
       // update B2N token in access token file
       await updateC11NB2SForInfinity();

package/src/tasks/build-all/helper.js

@@ -22,12 +22,12 @@ export const getBuildComponentQuestions = async () => {
       name: 'devBuild',
       type: 'confirm',
       message: 'Generate development build ?',
-      default: defaultPegaConfig.devBuild
-    }
+      default: defaultPegaConfig.devBuild,
+    },
   ];
 };
 
-export const zipComponent = async componentKey => {
+export const zipComponent = async (componentKey) => {
   addDebugLog('zipComponent', `componentKey: ${componentKey}`, '');
 
   const srcDirectory = await getComponentDirectoryPath(componentKey);
@@ -37,7 +37,7 @@ export const zipComponent = async componentKey => {
 
   const archive = archiver('zip', { zlib: { level: 9 } });
   const zipChunks = [];
-  archive.on('data', chunk => zipChunks.push(chunk));
+  archive.on('data', (chunk) => zipChunks.push(chunk));
 
   // Add src directory
   archive.directory(srcDirectory, 'src');

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

@@ -15,7 +15,7 @@ import {
   getLibraryBasedCL,
   checkLibraryAndArchives,
   getConfigDefaults,
-  zipVersionAndArchive
+  zipVersionAndArchive,
 } from '../../util.js';
 
 import { getBuildComponentQuestions } from './helper.js';
@@ -32,7 +32,7 @@ export function getCustomTasks(componentKey, sourceMap, devBuild, options, showS
         title: 'Validate config schema',
         task: async () => {
           await validate(componentKey);
-        }
+        },
       },
       {
         title: 'Lint component',
@@ -40,19 +40,19 @@ export function getCustomTasks(componentKey, sourceMap, devBuild, options, showS
           const targetDirectory = await getComponentDirectoryPath(componentKey);
           // console.log(`in buildComponent Lint component task: componentKey: ${componentKey} targetDirectory: ${targetDirectory}`);
           await lintComponent(targetDirectory);
-        }
+        },
       },
       {
         title: `Bundle component ${sDevBuild}`,
         task: async () => await bundleComponent(componentKey, sourceMap, devBuild, showStats),
-        enabled: () => !skipBuild
-      }
+        enabled: () => !skipBuild,
+      },
     ],
-    { concurrent: false, exitOnError: true }
+    { concurrent: false, exitOnError: true },
   );
 }
 
-export default async options => {
+export default async (options) => {
   await showVersion();
   await checkLibraryAndArchives();
 

package/src/tasks/build-comp/helper.js

@@ -7,7 +7,7 @@ import chalk from 'chalk';
 import { constructCompleteUrl, getComponentDirectoryPath, getComponents, getPegaServerConfig, getFetchAgent, getLibraryBased } from '../../util.js';
 import { PUBLISH_COMPONENT_SERVICE_REST_ENDPOINT, TOKEN_PATH } from '../../constants.js';
 
-export const getPublishComponentQuestions = async componentKey => {
+export const getPublishComponentQuestions = async (componentKey) => {
   const isLibraryBased = getLibraryBased();
   // validate and validateAll will be called when libraryBased, but using same code
   // so need different label
@@ -29,26 +29,26 @@ export const getPublishComponentQuestions = async componentKey => {
       message: `Select component to ${buildLabel}`,
       choices: components,
       default: componentKey,
-      when: () => !componentKey
+      when: () => !componentKey,
     },
     {
       name: 'sourceMap',
       message: 'Generate source map ?',
       default: defaultPegaConfig.sourceMap,
 
-      when: () => false && !process.env.SOURCE_MAP
+      when: () => false,
     },
     {
       name: 'devBuild',
       type: 'confirm',
       message: 'Generate development build ?',
       default: defaultPegaConfig.devBuild,
-      when: () => !isLibraryBased
-    }
+      when: () => !isLibraryBased,
+    },
   ];
 };
 
-export const zipComponent = async componentKey => {
+export const zipComponent = async (componentKey) => {
   const srcDirectory = await getComponentDirectoryPath(componentKey);
   const buildDirectory = await path.join(path.resolve(), 'dist/components', componentKey);
   const configJson = `${srcDirectory}/config.json`;
@@ -57,7 +57,7 @@ export const zipComponent = async componentKey => {
 
   const archive = archiver('zip', { zlib: { level: 9 } });
   const zipChunks = [];
-  archive.on('data', chunk => zipChunks.push(chunk));
+  archive.on('data', (chunk) => zipChunks.push(chunk));
 
   // Add src directory
   archive.directory(srcDirectory, 'src');
@@ -84,7 +84,7 @@ export const zipComponent = async componentKey => {
   const configContent = Buffer.from(fs.readFileSync(configJson)).toString();
 
   if (fs.existsSync('dist/components')) {
-    fs.rm('dist/components', { recursive: true }, err => {
+    fs.rm('dist/components', { recursive: true }, (err) => {
       if (err) {
         throw err;
       }
@@ -92,7 +92,7 @@ export const zipComponent = async componentKey => {
   }
 
   if (fs.existsSync('lib')) {
-    fs.rm('lib', { recursive: true }, err => {
+    fs.rm('lib', { recursive: true }, (err) => {
       if (err) {
         throw err;
       }
@@ -102,7 +102,7 @@ export const zipComponent = async componentKey => {
   return { zipContent, configContent };
 };
 
-export const publishComponentToServer = async data => {
+export const publishComponentToServer = async (data) => {
   const { configContent, zipContent, rulesetName, rulesetVersion } = data;
 
   const apiBody = {
@@ -112,7 +112,7 @@ export const publishComponentToServer = async data => {
     publishFor: 'constellation',
     rulesetName,
     rulesetVersion,
-    category: ''
+    category: '',
   };
   const defaultPegaConfig = await getPegaServerConfig();
   const url = constructCompleteUrl(defaultPegaConfig.server, PUBLISH_COMPONENT_SERVICE_REST_ENDPOINT);
@@ -125,15 +125,15 @@ export const publishComponentToServer = async data => {
         method: 'POST',
         dispatcher: getFetchAgent(defaultPegaConfig),
         headers: {
-          Authorization: `${tokenType} ${accessToken}`
+          Authorization: `${tokenType} ${accessToken}`,
         },
-        body: JSON.stringify(apiBody)
+        body: JSON.stringify(apiBody),
       })
-        .then(response => {
+        .then((response) => {
           status = response.status;
           return response.text();
         })
-        .then(resp => {
+        .then((resp) => {
           const respData = JSON.parse(resp);
           if (status === 401) {
             throw new Error('Error occurred in authentication. Please regenerate using authenticate');
@@ -146,11 +146,11 @@ export const publishComponentToServer = async data => {
           }
         })
 
-        .catch(e => Promise.reject(`${chalk.bold.red(e)}`));
+        .catch((e) => Promise.reject(`${chalk.bold.red(e)}`));
     } else {
       throw new Error(`Error occurred in authentication. Please regenerate using authenticate`);
     }
   } catch (err) {
-    throw new Error(`Error occurred in authentication. Please regenerate using authenticate`);
+    throw new Error(`Error occurred in authentication. Please regenerate using authenticate`, { cause: err });
   }
 };

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

@@ -15,10 +15,10 @@ import {
   getLibraryBased,
   checkLibraryAndArchives,
   getConfigDefaults,
-  zipVersionAndArchive
+  zipVersionAndArchive,
 } from '../../util.js';
 
-export default async options => {
+export default async (options) => {
   await showVersion();
   await checkLibraryAndArchives();
 
@@ -56,7 +56,7 @@ export default async options => {
     }
 
     content = {
-      ...answers
+      ...answers,
     };
   }
 
@@ -67,7 +67,7 @@ export default async options => {
         title: 'Validate config schema',
         task: async () => {
           await validate(componentKey);
-        }
+        },
       },
       {
         title: 'Lint component',
@@ -75,21 +75,21 @@ export default async options => {
           const targetDirectory = await getComponentDirectoryPath(componentKey);
           // console.log(`in buildComponent Lint component task: componentKey: ${componentKey} targetDirectory: ${targetDirectory}`);
           await lintComponent(targetDirectory);
-        }
+        },
       },
       {
         title: `Bundle Component ${sDevBuild}`,
         type: 'confirm',
         task: async () => await bundleComponent(componentKey, sourceMap, devBuild, showStats),
-        skip: () => (options.skipBundle ? 'Skipped bundling component' : undefined)
-      }
+        skip: () => (options.skipBundle ? 'Skipped bundling component' : undefined),
+      },
     ],
     {
-      exitOnError: true
-    }
+      exitOnError: true,
+    },
   );
 
-  await tasks.run().catch(err => {
+  await tasks.run().catch((err) => {
     console.log(chalk.bold.red(err.toString()));
     process.exit(1);
   });