@pega/custom-dx-components 8.8.18 → 8.8.20

package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/Operator.jsx.mustache

@@ -0,0 +1,282 @@
+/* eslint-disable no-undef */
+import { useState, useEffect, Fragment } from 'react';
+import {
+  Link,
+  Button,
+  Popover,
+  useOuterEvent,
+  useElement,
+  Progress,
+  FormField,
+  useTheme
+} from '@pega/cosmos-react-core';
+import { Glimpse } from '@pega/cosmos-react-work';
+import { EmailDisplay } from '@pega/cosmos-react-core';
+import PropTypes from 'prop-types';
+
+import Avatar from './Avatar.jsx';
+
+const Operator = (props) => {
+  const { id, name, label, testId, helperText, externalUser, metaObj } = props;
+  const [isOpen, setIsOpen] = useState(false);
+  const [isLoading, setIsLoading] = useState(true);
+  const [popoverTarget, setPopoverTarget] = useState(null);
+  const [popoverEl, setPopoverEl] = useElement(null);
+  const [popoverContent, setpopoverContent] = useState(null);
+  const theme = useTheme();
+
+  /* If the id has changed, we need to reset the popover */
+  useEffect(() => {
+    setPopoverTarget(null);
+  }, [id]);
+
+
+  {{! pick new delimiteres for mustache }}
+  {{=<% %>=}}
+
+  const OperatorPreview = () => {
+    let localizedVal = PCore.getLocaleUtils().getLocaleValue;
+    let localeCategory = 'Operator';
+    setpopoverContent(
+      <Progress variant='ring' message={localizedVal('Loading operator...', localeCategory)} placement='local' />
+    );
+    if (externalUser && externalUser.classID !== 'Data-Party-Operator') {
+      const fields = [
+        {
+          id: 'pyFirstName',
+          name: localizedVal('Name', localeCategory),
+          value: externalUser.name
+        },
+        {
+          id: 'pyEmail1',
+          name: localizedVal('Email', localeCategory),
+          value:
+            externalUser.email !== '' ? <Link href={`mailto:${externalUser.email}`}>{externalUser.email}</Link> : ''
+        },
+        {
+          id: 'pyPhoneNumber',
+          name: localizedVal('Phone', localeCategory),
+          value: externalUser.phone !== '' ? <Link href={`tel:${externalUser.phone}`}>{externalUser.phone}</Link> : ''
+        }
+      ];
+      setIsLoading(false);
+      setpopoverContent(
+        <Glimpse
+          visual={
+            <Avatar
+              metaObj={{
+                name: externalUser.name
+              }}
+            />
+          }
+          primary={externalUser.name}
+          secondary={[externalUser.position]}
+          fields={fields}
+        />
+      );
+    } else {
+      localizedVal = PCore.getLocaleUtils().getLocaleValue;
+      localeCategory = 'Operator';
+      return PCore.getUserApi()
+        .getOperatorDetails(id, true)
+        .then(res => {
+          if (res.data?.data && res.data.data[0].BusinessID && res.data.data[0].Name) {
+            const fields = [];
+            if (res.data.data[0].Name)
+              fields.push({
+                id: 'Name',
+                name: localizedVal('Name', localeCategory),
+                value: res.data.data[0].Name
+              });
+            if (res.data.data[0].BusinessID)
+              fields.push({
+                id: 'Email',
+                name: localizedVal('Email address', localeCategory),
+                value: <EmailDisplay value={res.data.data[0].BusinessID} />
+              });
+            return (
+              <Glimpse
+                heading={{
+                  primary: res.data.data[0].Name,
+                  secondary: res.data.data[0].BusinessID,
+                  visual: (
+                    <Avatar
+                      metaObj={{
+                        image: '',
+                        name: res.data.data[0].Name
+                      }}
+                    />
+                  )
+                }}
+                fields={fields}
+                target={popoverTarget}
+                onDismiss={() => setPopoverTarget(null)}
+              />
+            );
+          }
+        });
+      /*
+      const { getOperatorDetails } = PCore.getUserApi();
+      getOperatorDetails(id)
+        .then((res) => {
+          if (res.data && res.data.pyOperatorInfo && res.data.pyOperatorInfo.pyUserName) {
+            const fields = [
+              {
+                id: 'pyOrganization',
+                name: localizedVal('Organization', localeCategory),
+                value: res.data.pyOperatorInfo.pyOrganization
+              },
+              {
+                id: 'pyTelephone',
+                name: localizedVal('Telephone', localeCategory),
+                value:
+                  res.data.pyOperatorInfo.pyTelephone !== '' ? (
+                    <Link href={`tel:${res.data.pyOperatorInfo.pyTelephone}`}>
+                      {res.data.pyOperatorInfo.pyTelephone}
+                    </Link>
+                  ) : (
+                    ''
+                  )
+              },
+              {
+                id: 'pyEmailAddress',
+                name: localizedVal('Email address', localeCategory),
+                value:
+                  res.data.pyOperatorInfo.pyEmailAddress !== '' ? (
+                    <Link href={`mailto:${res.data.pyOperatorInfo.pyEmailAddress}`}>
+                      {res.data.pyOperatorInfo.pyEmailAddress}
+                    </Link>
+                  ) : (
+                    ''
+                  )
+              },
+              {
+                id: 'ReportToUserName',
+                name: localizedVal('Reports to', localeCategory),
+                value: res.data.pyOperatorInfo.pyReportToUserName
+              }
+            ];
+            setIsLoading(false);
+            setpopoverContent(
+              <Glimpse
+                visual={
+                  <Avatar
+                    metaObj={{
+                      image: res.data.pyOperatorInfo.pyImageInsKey || '',
+                      name: res.data.pyOperatorInfo.pyUserName
+                    }}
+                  />
+                }
+                primary={res.data.pyOperatorInfo.pyUserName}
+                secondary={[res.data.pyOperatorInfo.pyPosition]}
+                fields={fields}
+              />
+            );
+          } else {
+            setIsLoading(false);
+            setpopoverContent(<Flex container={{ pad: 1 }}>{localizedVal('Operator not found', localeCategory)}</Flex>);
+          }
+        })
+        .catch(() => {
+          setIsLoading(false);
+          setpopoverContent(
+            <Flex container={{ pad: 1 }}>{localizedVal('Error loading the operator profile', localeCategory)}</Flex>
+          );
+        });
+      */
+    }
+  };
+
+  <%={{ }}=%>     {{! revert delimiteres for mustache }}
+
+  const clickAction = (e) => {
+    setPopoverTarget(e.currentTarget);
+    setIsOpen(!isOpen);
+    if (popoverTarget === null) {
+      OperatorPreview();
+    }
+  };
+
+  const hidePopover = () => {
+    if (isOpen) {
+      setIsOpen(false);
+    }
+  };
+  useOuterEvent('mousedown', [popoverEl, popoverTarget], hidePopover); // Call the method on clicking outside these elements
+  const hideOnEscape = (e) => {
+    if (e.key === 'Escape') hidePopover(); // Call the method when Escape key is pressed
+  };
+
+  const comp = (
+    <Fragment>
+      {metaObj ? (
+        <Button
+          variant='text'
+          aria-haspopup
+          aria-expanded={isOpen}
+          onClick={clickAction}
+          onKeyDown={hideOnEscape}
+          data-test-id={testId}
+          style={label !== null ? { width: 'max-content', height: theme.components.input.height } : undefined}
+        >
+          <Avatar metaObj={metaObj}></Avatar>
+        </Button>
+      ) : (
+        <Button
+          variant='link'
+          aria-haspopup
+          aria-expanded={isOpen}
+          onClick={clickAction}
+          onKeyDown={hideOnEscape}
+          data-test-id={testId}
+          style={label !== null ? { width: 'max-content', height: theme.components.input.height } : undefined}
+        >
+          {name}
+        </Button>
+      )}
+
+      {isOpen && (
+        <Popover
+          ref={setPopoverEl}
+          groupId='operator'
+          target={popoverTarget}
+          placement='bottom-start'
+          style={isLoading ? { position: 'relative', width: '10rem', minHeight: '4rem' } : undefined}
+          strategy='fixed'
+        >
+          {popoverContent}
+        </Popover>
+      )}
+    </Fragment>
+  );
+
+  if (label !== null) {
+    return (
+      <FormField label={label} info={helperText}>
+        {comp}
+      </FormField>
+    );
+  }
+
+  return comp;
+};
+
+Operator.propTypes = {
+  name: PropTypes.string,
+  id: PropTypes.string,
+  label: PropTypes.string,
+  testId: PropTypes.string,
+  helperText: PropTypes.string,
+  metaObj: PropTypes.object
+};
+
+Operator.defaultProps = {
+  name: '',
+  id: '',
+  label: null,
+  testId: null,
+  helperText: null,
+  metaObj: null
+};
+
+export default Operator;

package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/config.json.mustache

@@ -0,0 +1,55 @@
+{
+  "name": "{{COMPONENT_KEY}}",
+  "label": "{{COMPONENT_LABEL}}",
+  "description": "{{DESCRIPTION}}",
+  "organization": "{{ORGANIZATION}}",
+  "version": "{{VERSION}}",
+  "library": "{{LIBRARY}}",
+  "allowedApplications": {{{ALLOWEDAPPS}}},
+  "componentKey": "{{COMPONENT_KEY}}",
+  "type": "{{TYPE}}",
+  "subtype": {{{SUB_TYPE}}},
+  "icon": "OneColumnPage.svg",
+   "properties": [
+    {
+      "name": "title",
+      "label": "Label value",
+      "format": "TEXT"
+    },
+    {
+      "format": "SELECT",
+      "label": "Usage",
+      "name": "label",
+      "defaultValue": "Create operator",
+      "localize": true,
+      "source": [
+        {
+          "key": "Create operator",
+          "value": "Create operator"
+        },
+        {
+          "key": "Update operator",
+          "value": "Update operator"
+        }
+      ]
+    },
+
+    {
+      "label": "Conditions",
+      "format": "GROUP",
+      "properties": [
+        {
+          "name": "visibility",
+          "label": "Visibility",
+          "format": "VISIBILITY"
+        }
+      ]
+    }
+  ],
+  "defaultConfig": {
+    "label": "Create operator",
+    "title": "Create operator",
+    "createLabel": "@L Created",
+    "updateLabel": "@L Updated"
+  }
+}

package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/demo.stories.jsx.mustache

@@ -0,0 +1,74 @@
+import { withKnobs } from '@storybook/addon-knobs';
+
+import {{COMPONENT_CLASS_NAME}} from './index.jsx';
+
+import { configProps, operatorDetails } from './mock.stories';
+
+export default {
+  title: '{{COMPONENT_CLASS_NAME}}',
+  decorators: [withKnobs],
+  component: {{COMPONENT_CLASS_NAME}}
+};
+
+if (!window.PCore) {
+  window.PCore = {};
+}
+
+window.PCore.getLocaleUtils = () => {
+  return {
+    getLocaleValue: value => {
+      return value;
+    }
+  };
+};
+
+window.PCore.getUserApi = () => {
+  return {
+    getOperatorDetails: () => {
+      return new Promise(resolve => {
+        resolve(operatorDetails);
+      });
+    }
+  };
+};
+
+export const base{{COMPONENT_CLASS_NAME}} = () => {
+
+  const props = {
+    label: configProps.label,
+    createLabel: configProps.createLabel,
+    updateLabel: configProps.updateLabel,
+    createOperator: configProps.createOperator,
+    updateOperator: configProps.updateOperator,
+    createDateTime: configProps.createDateTime,
+    updateDateTime: configProps.updateDateTime,
+    hideLabel: configProps.hideLabel,
+
+    getPConnect: () => {
+      return {
+        getActionsApi: () => {
+          return {
+            updateFieldValue: () => {/* nothing */},
+            triggerFieldChange: () => {/* nothing */}
+          };
+        },
+        getCaseSummary: () => {
+          return {
+            user: configProps.updateOperator.userId,
+            dateTimeValue: configProps.updateDateTime
+          }
+        },
+        ignoreSuggestion: () => {/* nothing */},
+        acceptSuggestion: () => {/* nothing */},
+        setInheritedProps: () => {/* nothing */},
+        resolveConfigProps: () => {/* nothing */}
+      };
+    }
+};
+
+return (
+    <>
+      <{{COMPONENT_CLASS_NAME}} {...props} />
+    </>
+  );
+};

package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/index.jsx.mustache

@@ -0,0 +1,82 @@
+/* eslint-disable no-nested-ternary */
+import { Fragment } from 'react';
+import { DateTimeDisplay, Card, CardHeader, CardContent, Flex } from '@pega/cosmos-react-core';
+import PropTypes from 'prop-types';
+
+// includes in bundle
+import Operator from './Operator.jsx';
+
+import Styled{{COMPONENT_CLASS_NAME}}Wrapper from './styles';
+
+
+// Created for Launchpad
+
+// props passed in combination of props from property panel (config.json) and run time props from Constellation
+// any default values in config.pros should be set in defaultProps at bottom of this file
+export default function {{COMPONENT_CLASS_NAME}}(props) {
+
+  const {
+    getPConnect,
+    title,
+    label,
+    createLabel,
+    updateLabel
+  } = props;
+
+
+  const { createTime, createdBy, lastUpdateTime, lastUpdatedBy } = getPConnect().getCaseSummary();
+
+  const [_label, user, dateTimeValue] =
+    label === 'Create operator'
+      ? [createLabel, createdBy, createTime]
+      : [updateLabel, lastUpdatedBy, lastUpdateTime];
+
+
+
+  return (
+    <Styled{{COMPONENT_CLASS_NAME}}Wrapper>
+      <Card>
+      <CardHeader>{title}</CardHeader>
+      <CardContent>
+{{! pick new delimiteres for mustache }} {{=<% %>=}}
+      <Flex container={{ direction: 'row'}}>
+      <Operator label={_label} name={user} id={user} getPConnect={getPConnect} />
+
+<%={{ }}=%>     {{! revert delimiteres for mustache }}
+      {dateTimeValue && (
+        <Fragment>
+          {' '}
+          <DateTimeDisplay value={dateTimeValue} variant='relative' />
+        </Fragment>
+      )}
+      </Flex>
+      </CardContent>
+      </Card>
+
+    </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
+  );
+
+
+
+}
+
+{{COMPONENT_CLASS_NAME}}.defaultProps = {
+  "label": "Create operator",
+  "title": "Create operator",
+  createLabel: null,
+  updateLabel: null
+};
+
+{{COMPONENT_CLASS_NAME}}.propTypes = {
+  getPConnect: PropTypes.func.isRequired,
+  label: PropTypes.string,
+  title: PropTypes.string,
+  createLabel: PropTypes.string,
+  updateLabel: PropTypes.string
+};
+
+// as objects are there in props, shallow comparision fails & re-rendering of comp happens even with
+// same key value pairs in obj. hence using custom comparison function on when to re-render
+// const comparisonFn = (prevProps, nextProps) => {
+//   return prevProps.updateDateTime === nextProps.updateDateTime;
+// };

package/src/tasks/create/templates/Launchpad/Widget/__components.md

@@ -0,0 +1,3 @@
+# The **Widget** directory
+
+The **Launchpad/Widget** directory contains the template code for the field components you want to use with the **WebComponents SDK**.

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

@@ -16,6 +16,7 @@ import {
   convertIntoPascalCase,
   compileMustacheTemplate,
   getComponentDirectoryPath,
+  getPegaServerConfig,
   getPegaConfig,
   getComponents,
   getComponentDefaults,
@@ -220,10 +221,35 @@ export const validateCompile = async (
   let pegaConfig = await getPegaConfig();
   let templateParentDir = `./templates/${framework}`;
 
-  const templateDir = `${templateParentDir}/${type}/${sSubType}`;
+  let templateDir = `${templateParentDir}/${type}/${sSubType}`;
   let templateDirectory = fileURLToPath(new URL(templateDir, import.meta.url));
   templateDirectory = templateDirectory.replace(path.sep + 'create-all', path.sep + 'create');
 
+  const defaultPegaServerConfig = await getPegaServerConfig();
+  const isLaunchpad = defaultPegaServerConfig.serverType === 'launchpad';
+  let originalFramework = framework;
+
+  if (isLaunchpad) {
+    framework = "Launchpad";
+
+    templateDir = `./templates/${framework}/${type}/${sSubType}`;
+    templateDirectory = fileURLToPath(new URL(templateDir, import.meta.url));
+    templateDirectory = templateDirectory.replace(path.sep + 'create-all', path.sep + 'create');
+
+    // if doesn't exist, revert
+    if (!fs.existsSync(templateDirectory)) {
+      framework = originalFramework;
+
+      templateDir = `./templates/${framework}/${type}/${sSubType}`;
+      templateDirectory = fileURLToPath(new URL(templateDir, import.meta.url));
+      templateDirectory = templateDirectory.replace(path.sep + 'create-all', path.sep + 'create');
+
+    }
+
+  }
+
+
+
   const componentKey = `${organization}_${library}_${componentName}`;
 
   const targetDirectory = await getComponentDirectoryPath(componentKey);

package/src/tasks/delete/helper.js

@@ -1,22 +1,32 @@
+import fs from 'fs';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
 
+import path from 'path';
+import { join } from 'path';
+
 import {
   deleteLocalComponent,
   deleteInfinityServerComponent,
   deleteLaunchpadServerComponent,
   getComponents,
   getPegaServerConfig,
-  standardizeStr
+  standardizeStr,
+  sanitize
 } from '../../util.js';
 import { getComponentsFromServer } from '../list/helper.js';
 
+import { TASKS_CONFIG_JSON_FILENAME, COMPONENTS_DIRECTORY_PATH, COMPONENTS_PATH } from '../../constants.js';
+
 export const SOURCE_OF_COMPONENT_TYPES = {
   SERVER: 'Server',
   LOCAL: 'Local'
 };
 
+let library;
+let organization;
+
 export const getDeleteComponentsQuestions = async (options) => {
   const defaultPegaServerConfig = await getPegaServerConfig();
 
@@ -34,6 +44,51 @@ export const getDeleteComponentsQuestions = async (options) => {
   ];
 };
 
+export const getLaunchPadFilterQuestions = async () => {
+  const defaultPegaServerConfig = await getPegaServerConfig();
+
+  const currentDirectory = process.cwd();
+  const pegaConfigJsonPath = join(currentDirectory, TASKS_CONFIG_JSON_FILENAME);
+
+  let data = fs.readFileSync(pegaConfigJsonPath, { encoding: 'utf8' });
+  data = data && JSON.parse(data);
+
+  if (!data[COMPONENTS_DIRECTORY_PATH]) {
+    console.error(`${chalk.red.bold('ERROR')} Could not able find components directory path in config.json`);
+    process.exit(1);
+  }
+
+  const componentData = data[COMPONENTS_PATH];
+
+  ({ library } = componentData);
+  ({ organization } = JSON.parse(fs.readFileSync(path.resolve('package.json'), 'utf8')));
+
+  return [
+    {
+      name: 'organization',
+      message: 'Enter component organization (required)',
+      default: organization,
+      validate: (value) => {
+        if (value) {
+          return true;
+        }
+        return 'Please provide value for organization';
+      }
+    },
+    {
+      name: 'library',
+      message: 'Enter library name (required)',
+      default: library,
+      validate: (value) => {
+        if (value) {
+          return true;
+        }
+        return 'Please provide value for library';
+      }
+    }
+  ];
+};
+
 export const deleteLocalComponents = async (sourceOfComponents, options) => {
   const localComponents = await getComponents();
 
@@ -70,10 +125,19 @@ export const deleteLocalComponents = async (sourceOfComponents, options) => {
 };
 
 export const deleteServerComponents = async (sourceOfComponents, answers) => {
-  const spinner = ora('Fetching components from server').start();
   const defaultPegaServerConfig = await getPegaServerConfig();
   const isLaunchpad = defaultPegaServerConfig.serverType === 'launchpad';
-  const data = await getComponentsFromServer(answers);
+
+  if (isLaunchpad) {
+    const questions = await getLaunchPadFilterQuestions();
+    const lpAnswers = await inquirer.prompt(questions);
+
+    ({ library, organization } = lpAnswers);
+  }
+
+  const spinner = ora('Fetching components from server').start();
+  const data = await getComponentsFromServer(library, organization);
+  spinner.stop();
 
   let serverComponents;
   if (isLaunchpad) {
@@ -89,7 +153,6 @@ export const deleteServerComponents = async (sourceOfComponents, answers) => {
       /* empty */
     }
   }
-  spinner.stop();
 
   if (serverComponents && serverComponents?.length > 0) {
     if (isLaunchpad) {