@rh-support/troubleshoot 2.6.295 → 2.6.299

package/lib/esm/utils/caseHistoryUtils.js

@@ -0,0 +1,165 @@
+/**
+ * Maps Salesforce field identifiers to human-readable display names.
+ *
+ * Contains two distinct key categories:
+ * - Real SF API field names (e.g. `ContactId`, `RH_Product__c`, `FolderId__c`)
+ * - Synthetic lifecycle pseudo-fields produced by the SF History API (e.g. `created`,
+ *   `closed`, `ownerAssignment`). These are not custom Salesforce fields — they represent
+ *   case lifecycle events that appear as history entries with no OldValue/NewValue.
+ */
+export const FIELD_NAME_DISPLAY_MAP = {
+    created: 'Case Created',
+    closed: 'Case Closed',
+    ownerAssignment: 'Owner',
+    ownerAccepted: 'Owner',
+    ownerEscalated: 'Owner',
+    external: 'Visibility',
+    ContactId: 'Contact',
+    RH_Product__c: 'Product',
+    RH_Version__c: 'Version',
+    EntitlementId: 'Entitlement',
+    AccountId: 'Account',
+    OwnerId: 'Owner',
+    BusinessHoursId: 'Business Hours',
+    FolderId__c: 'Case Group',
+    Status: 'Status',
+    Customer_Escalation__c: 'Customer Escalation',
+    SlaStartDate: 'SLA Start Date',
+    Case_Language__c: 'Case Language',
+    SBR_Group__c: 'SBR Group',
+};
+export function getFieldDisplayName(fieldName) {
+    if (fieldName in FIELD_NAME_DISPLAY_MAP) {
+        return FIELD_NAME_DISPLAY_MAP[fieldName];
+    }
+    return undefined;
+}
+// Salesforce object IDs are strictly 15 (case-sensitive) or 18 (case-insensitive)
+// alphanumeric characters. Strings of 16–17 chars are intentionally excluded.
+const SFDC_ID_REGEX = /^[a-zA-Z0-9]{15}$|^[a-zA-Z0-9]{18}$/;
+export function isSfdcId(value) {
+    return SFDC_ID_REGEX.test(value);
+}
+/**
+ * Extracts a string representation from a polymorphic SF value union.
+ *
+ * Property names (`stringValue`, `booleanValue`, etc.) correspond to GraphQL
+ * inline-fragment aliases defined in the `GET_CASE_HISTORY` query. Changing those
+ * aliases without updating this function will silently break value extraction.
+ *
+ * The check order is safe because the union discriminants are mutually exclusive.
+ * Note: empty string `''` is a valid return value (distinct from `null`).
+ */
+export function extractStringValue(val) {
+    if (!val)
+        return null;
+    if ('stringValue' in val)
+        return val.stringValue;
+    if ('booleanValue' in val)
+        return String(val.booleanValue);
+    if ('doubleValue' in val)
+        return String(val.doubleValue);
+    if ('dateTimeValue' in val)
+        return val.dateTimeValue;
+    return null;
+}
+/**
+ * Lifecycle pseudo-field names from the SF History API mapped to human-readable action
+ * sentences. Fields not listed here fall back to using the raw `fieldName` as output text
+ * in {@link normalizeNodeToHistoryItem}.
+ */
+export const SPECIAL_FIELD_ACTIONS = {
+    created: 'created the case',
+    closed: 'closed the case',
+    ownerAssignment: 'changed the case owner',
+    ownerAccepted: 'accepted ownership of the case',
+    ownerEscalated: 'escalated the case owner',
+    external: 'made the case visible to customers',
+};
+export const DEFAULT_AVATAR_SRC = 'https://www.patternfly.org/images/668560cd.svg';
+const INTERNAL_USER_TYPE = 'Standard';
+/**
+ * Only SF `UserType === 'Standard'` is treated as an internal (Red Hat) user.
+ * All other types — including `null`, `undefined`, and unknown portal types — default
+ * to customer. This conservative default ensures external users are never accidentally
+ * styled as internal.
+ */
+export function deriveIsCustomer(userType) {
+    if (userType === INTERNAL_USER_TYPE)
+        return false;
+    return true;
+}
+/**
+ * Filters out history entries whose values are raw Salesforce IDs that cannot be
+ * decoded into human-readable display strings.
+ *
+ * Filtering rules:
+ * - Both values null → **keep** (lifecycle action events carry no values)
+ * - `newValue` is an SFDC ID and `oldValue` is null or also an ID → **drop**
+ *   (unresolvable reference change with no readable side)
+ * - `oldValue` is an SFDC ID and `newValue` is null → **drop**
+ *   (ID removal with no display name)
+ * - At least one side is a human-readable string → **keep**
+ */
+export function filterSfdcIdEntries(edges) {
+    return edges
+        .map((edge) => edge.node)
+        .filter((node) => {
+        const newVal = extractStringValue(node.NewValue);
+        const oldVal = extractStringValue(node.OldValue);
+        if (!newVal && !oldVal)
+            return true;
+        const hasIdNewVal = newVal && isSfdcId(newVal);
+        const hasIdOldVal = oldVal && isSfdcId(oldVal);
+        if (hasIdNewVal && (!oldVal || hasIdOldVal))
+            return false;
+        if (hasIdOldVal && !newVal)
+            return false;
+        return true;
+    });
+}
+/**
+ * Converts a raw SF history node into a normalized `ICaseHistoryItem`.
+ *
+ * Classifies each entry as either:
+ * - **Action** (`!oldValue && !newValue`): lifecycle events like "created", "closed".
+ *   `outputText` is set here from {@link SPECIAL_FIELD_ACTIONS}, or falls back to the
+ *   raw `fieldName` for unknown actions.
+ * - **Change**: field-value mutations. `outputText` is left empty because the Timeline
+ *   layer formats change text via `applyReplacements` / `handleFieldChange`.
+ *
+ * Display name fallback chain: `FIELD_NAME_DISPLAY_MAP` → SF `label` → SF
+ * `displayValue` → raw `fieldName`.
+ */
+export function normalizeNodeToHistoryItem(node) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    const fieldName = node.SalesforceSupportField.value;
+    const oldValue = extractStringValue(node.OldValue);
+    const newValue = extractStringValue(node.NewValue);
+    const isAction = !oldValue && !newValue;
+    let outputText = '';
+    if (isAction) {
+        if (fieldName in SPECIAL_FIELD_ACTIONS) {
+            outputText = SPECIAL_FIELD_ACTIONS[fieldName];
+        }
+        else {
+            outputText = fieldName;
+        }
+    }
+    return {
+        id: node.Id,
+        fieldName,
+        displayName: (_c = (_b = (_a = getFieldDisplayName(fieldName)) !== null && _a !== void 0 ? _a : node.SalesforceSupportField.label) !== null && _b !== void 0 ? _b : node.SalesforceSupportField.displayValue) !== null && _c !== void 0 ? _c : fieldName,
+        label: (_f = (_e = (_d = getFieldDisplayName(fieldName)) !== null && _d !== void 0 ? _d : node.SalesforceSupportField.label) !== null && _e !== void 0 ? _e : node.SalesforceSupportField.displayValue) !== null && _f !== void 0 ? _f : fieldName,
+        oldValue,
+        newValue,
+        createdDate: node.CreatedDate.value,
+        createdByUserName: (_j = (_h = (_g = node.CreatedBy) === null || _g === void 0 ? void 0 : _g.Name) === null || _h === void 0 ? void 0 : _h.value) !== null && _j !== void 0 ? _j : '',
+        createdByCustomer: deriveIsCustomer((_l = (_k = node.CreatedBy) === null || _k === void 0 ? void 0 : _k.UserType) === null || _l === void 0 ? void 0 : _l.value),
+        // TODO: SmallPhotoUrl points to an internal Salesforce domain that external portal
+        // users can't authenticate against. If images break, Hydra will need to proxy them.
+        photoUrl: (_p = (_o = (_m = node.CreatedBy) === null || _m === void 0 ? void 0 : _m.SmallPhotoUrl) === null || _o === void 0 ? void 0 : _o.value) !== null && _p !== void 0 ? _p : null,
+        type: isAction ? 'Action' : 'Change',
+        outputText,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rh-support/troubleshoot",
-    "version": "2.6.295",
+    "version": "2.6.299",
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org"
@@ -54,10 +54,10 @@
         "@progress/kendo-react-pdf": "^5.16.0",
         "@redux-devtools/extension": "^3.3.0",
         "@rh-support/components": "2.5.165",
-        "@rh-support/react-context": "2.5.271",
+        "@rh-support/react-context": "2.5.275",
         "@rh-support/types": "2.0.26",
-        "@rh-support/user-permissions": "2.5.123",
-        "@rh-support/utils": "2.5.106",
+        "@rh-support/user-permissions": "2.5.127",
+        "@rh-support/utils": "2.5.110",
         "@types/react-redux": "^7.1.33",
         "@types/redux": "^3.6.0",
         "date-fns": "3.6.0",
@@ -127,5 +127,5 @@
         "defaults and supports es6-module",
         "maintained node versions"
     ],
-    "gitHead": "7b1306d35722c768378d97b4c6f9895c6a66bce8"
+    "gitHead": "d1a226af32eb5997a31c34001b6146be141c8911"
 }