@salesforce/plugin-bre-to-cml 1.0.2

package/lib/shared/utils/common.utils.d.ts

@@ -0,0 +1,191 @@
+import { CmlModel, CmlRelation, CmlType } from '../types/types.js';
+export type Logger = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export declare function isSameIds(id1: string | null | undefined, id2: string | null | undefined): boolean;
+/**
+ * Checks whether the passed parameter is specifically undefined or null and not an empty string.
+ *
+ * @param {String} value The string to check
+ * @returns {Boolean} Whether value is undefined or null
+ */
+export declare function isUndefinedOrNull(value: unknown): boolean;
+/**
+ * Checks if the input value is undefined, null, empty array and object.
+ *
+ * @param {String} value input string to evaluate
+ * @returns {boolean} return true for undefined, null or empty string otherwise false
+ */
+export declare function isEmpty(value: unknown): boolean;
+/**
+ * Determines if item is an object
+ *
+ * @param {*} item The item in question of being an object
+ * @returns {Boolean} Whether item is an object or not
+ */
+export declare function isObject(item: unknown): boolean;
+/**
+ * Capitalizes the first letter in a string.
+ *
+ * @param string - string to capitalize
+ * @returns {string} - capitalized version of the string.
+ */
+export declare function capitalizeFirstLetter(string: string): string;
+/**
+ * Generates a random uuid (Version 4 in rfc4122)
+ * Copied the method from ui-industries-epc-components
+ *
+ * @returns {string} a UUID string
+ */
+export declare function uuid(): string;
+/**
+ * Finds an entry in a Map based on a specified key-value pair.
+ *
+ * @param {Map} map - The map to search through, where values are objects.
+ * @param {string} key - The key to match within each entry's object.
+ * @param {*} value - The value to match for the specified key.
+ * @returns {Object|undefined} - The first entry in the map where the specified key has the given value, or `undefined` if no match is found.
+ */
+export declare function findInMap<T>(map: Map<string, T>, key: string, value: unknown): T | undefined;
+/**
+ * Checks that name is valid - it should have only alphanumeric chars and underscores and should start with a letter
+ *
+ * @param name - string to validate
+ * @returns {boolean} - whether name is valid or not
+ */
+export declare function isNameValid(name: string): boolean;
+/**
+ * Checks if a given name is already used in the model.
+ *
+ * @param {Object} model - The model containing existing types.
+ * @param {string} name - The name to check for uniqueness.
+ * @param {Map} existingProductIdsToTypes - A map of existing type names to types that have been created but not yet saved to the model.
+ * @returns {boolean} - Returns true if the name is not used, otherwise false.
+ */
+export declare function isTypeNameUnique(model: CmlModel, name: string, existingProductIdsToTypes: Map<string, CmlType>): boolean;
+/**
+ * Checks if a given relation name is unique within a specific type.
+ *
+ * @param {Object} type - The type object containing existing relations.
+ * @param {string} name - The name of the relation to check.
+ * @param {Map} existingPrcIdsToRelations - A map of existing relation names to relations that have been created but not yet saved to the model.
+ * @returns {boolean} - Returns true if the relation name is unique (not already used), otherwise false.
+ */
+export declare function isRelationNameUnique(type: CmlType, name: string, existingPrcIdsToRelations: Map<string, CmlRelation>): boolean;
+/**
+ * Checks that name length is 80 or fewer chars
+ *
+ * @param name - string to validate
+ * @returns {boolean} - whether name is valid or not
+ */
+export declare function isNameLengthValid(name: string): boolean;
+/**
+ * Checks if value is an integer
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is an integer or not
+ */
+export declare function isInteger(value: string): boolean;
+/**
+ * Checks if value is a double
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a double or not
+ */
+export declare function isDouble(value: string): boolean;
+/**
+ * Checks if value is a boolean
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a boolean or not
+ */
+export declare function isBoolean(value: string): boolean;
+/**
+ * Checks if value is a date
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a date or not
+ */
+export declare function isDate(value: string): boolean;
+/**
+ * Checks if value is a string
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a string or not
+ */
+export declare function isString(value: string): boolean;
+/**
+ * Checks if the given value is a Date object.
+ *
+ * @param {*} d - The value to check.
+ * @returns {boolean} True if the value is an instance of Date, otherwise false.
+ */
+export declare function isDateType(d: unknown): boolean;
+/**
+ * Determines whether a given CML data type requires scale precision.
+ *
+ * @param {string} type - The CML data type to check (e.g., "double", "decimal").
+ * @returns {boolean} - Returns `true` if the type requires scale precision, otherwise `false`.
+ */
+export declare function isScaledType(type: string): boolean;
+/**
+ * Parses a string by removing surrounding quotes (single or double).
+ *
+ * @param {string} value - The string to be parsed.
+ * @returns {string} - The parsed string with quotes removed, or the original string if no quotes are found.
+ */
+export declare function parseString(value: string): string;
+/**
+ * Parses a date string into a Date object or returns the original string if invalid
+ *
+ * We return the original string because it may be a CML constant variable reference
+ *
+ * @param {string} stringValue - A date string in the format "YYYY-MM-DD"
+ * @returns {Date|string} A valid Date object if parsing succeeds, or the original string if invalid
+ */
+export declare function parseDate(stringValue: string): Date | string;
+/**
+ * Parses a numeric string into a number (either integer or float).
+ *
+ * @param {string} value - The string representation of the number.
+ * @returns {number} - The parsed number.
+ * @throws {Error} - Throws an error if the value cannot be parsed as a number.
+ */
+export declare function parseNumber(value: string): number;
+/**
+ * Determines whether a given type is a number type.
+ *
+ * @param {string} type - The attribute type (e.g., "int", "double", "decimal").
+ * @returns {boolean} - True if the type is a number type, false otherwise.
+ */
+export declare function isNumberType(type: string): boolean;
+/**
+ * Determines whether a given type is a date type.
+ *
+ * @param {string} type - The attribute type (e.g., "date", "int").
+ * @returns {boolean} - True if the type is "date", false otherwise.
+ */
+export declare function isDateDataType(type: string): boolean;
+/**
+ * Formats a Date object to a CML-compatible date string in the format "YYYY-MM-DD".
+ *
+ * @param {Date} date - The Date object to format.
+ * @returns {string} The formatted date string in "YYYY-MM-DD" format, enclosed in double quotes.
+ */
+export declare function formatToCmlDate(date: Date): string;
+/**
+ * Formats a Date object to a user-friendly display string in the format "Month Day, Year".
+ *
+ * @param {Date} date - The Date object to format.
+ * @returns {string} The formatted date string in "Month Day, Year" format (e.g., "March 27, 1994").
+ */
+export declare function formatToDisplayDate(date: Date): string;
+/**
+ * Converts the HTML entities &amp;, &lt;, &gt;, &quot;, and &#39; in string to their corresponding characters.
+ *
+ * @param {string} source - The source string
+ * @returns {string} The string with unescaped HTML characters.
+ */
+export declare function unescapeHtml(source: string): string;

package/lib/shared/utils/common.utils.js

@@ -0,0 +1,338 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { getRandomValues } from 'node:crypto';
+import { CML_DATA_TYPES, CML_NUMBER_DATA_TYPES } from '../constants/constants.js';
+export function isSameIds(id1, id2) {
+    if (!id1 || !id2) {
+        return false;
+    }
+    if (id1.length === id2.length) {
+        return id1.localeCompare(id2) === 0;
+    }
+    if (id1.length > id2.length) {
+        return id1.startsWith(id2);
+    }
+    return id2.startsWith(id1);
+}
+/**
+ * Checks whether the passed parameter is specifically undefined or null and not an empty string.
+ *
+ * @param {String} value The string to check
+ * @returns {Boolean} Whether value is undefined or null
+ */
+export function isUndefinedOrNull(value) {
+    return value === undefined || value === null;
+}
+/**
+ * Checks if the input value is undefined, null, empty array and object.
+ *
+ * @param {String} value input string to evaluate
+ * @returns {boolean} return true for undefined, null or empty string otherwise false
+ */
+export function isEmpty(value) {
+    if (value === undefined || value === null) {
+        return true;
+    }
+    else if (Array.isArray(value)) {
+        return value.length <= 0;
+    }
+    else if (isObject(value)) {
+        return Object.keys(value).length === 0;
+    }
+    else if (value === '') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Determines if item is an object
+ *
+ * @param {*} item The item in question of being an object
+ * @returns {Boolean} Whether item is an object or not
+ */
+export function isObject(item) {
+    return typeof item === 'object' && !Array.isArray(item) && !isUndefinedOrNull(item);
+}
+/**
+ * Capitalizes the first letter in a string.
+ *
+ * @param string - string to capitalize
+ * @returns {string} - capitalized version of the string.
+ */
+export function capitalizeFirstLetter(string) {
+    return string.charAt(0).toUpperCase() + string.slice(1).toLowerCase();
+}
+/**
+ * Generates a random uuid (Version 4 in rfc4122)
+ * Copied the method from ui-industries-epc-components
+ *
+ * @returns {string} a UUID string
+ */
+export function uuid() {
+    const hexDigits = '0123456789abcdef';
+    const valueArray = new Uint32Array(32);
+    getRandomValues(valueArray);
+    let res = '';
+    for (let i = 0; i < 32; i++) {
+        if (i === 8 || i === 12 || i === 16 || i === 20) {
+            res += '_';
+        }
+        if (i === 12) {
+            res += '4'; // UUID version
+        }
+        else if (i === 16) {
+            res += hexDigits.charAt((valueArray[i] & 0x3) | 0x8); // Bits need to start with 10
+        }
+        else {
+            res += hexDigits.charAt(valueArray[i] & 0xf);
+        }
+    }
+    return res;
+}
+/**
+ * Finds an entry in a Map based on a specified key-value pair.
+ *
+ * @param {Map} map - The map to search through, where values are objects.
+ * @param {string} key - The key to match within each entry's object.
+ * @param {*} value - The value to match for the specified key.
+ * @returns {Object|undefined} - The first entry in the map where the specified key has the given value, or `undefined` if no match is found.
+ */
+export function findInMap(map, key, value) {
+    return [...map.values()].find((entry) => entry[key] === value);
+}
+/**
+ * Checks that name is valid - it should have only alphanumeric chars and underscores and should start with a letter
+ *
+ * @param name - string to validate
+ * @returns {boolean} - whether name is valid or not
+ */
+export function isNameValid(name) {
+    const validChars = /^[a-zA-Z0-9_]+$/;
+    const validFirstChar = /^[a-zA-Z]/;
+    return validFirstChar.test(name.charAt(0)) && validChars.test(name);
+}
+/**
+ * Checks if a given name is already used in the model.
+ *
+ * @param {Object} model - The model containing existing types.
+ * @param {string} name - The name to check for uniqueness.
+ * @param {Map} existingProductIdsToTypes - A map of existing type names to types that have been created but not yet saved to the model.
+ * @returns {boolean} - Returns true if the name is not used, otherwise false.
+ */
+export function isTypeNameUnique(model, name, existingProductIdsToTypes) {
+    return !model.getType(name) && (!existingProductIdsToTypes || !findInMap(existingProductIdsToTypes, 'name', name));
+}
+/**
+ * Checks if a given relation name is unique within a specific type.
+ *
+ * @param {Object} type - The type object containing existing relations.
+ * @param {string} name - The name of the relation to check.
+ * @param {Map} existingPrcIdsToRelations - A map of existing relation names to relations that have been created but not yet saved to the model.
+ * @returns {boolean} - Returns true if the relation name is unique (not already used), otherwise false.
+ */
+export function isRelationNameUnique(type, name, existingPrcIdsToRelations) {
+    return !type.getRelation(name) && (!existingPrcIdsToRelations || !findInMap(existingPrcIdsToRelations, 'name', name));
+}
+/**
+ * Checks that name length is 80 or fewer chars
+ *
+ * @param name - string to validate
+ * @returns {boolean} - whether name is valid or not
+ */
+export function isNameLengthValid(name) {
+    return name.length <= 80;
+}
+/**
+ * Checks if value is an integer
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is an integer or not
+ */
+export function isInteger(value) {
+    const num = Number(value);
+    return !isNaN(num) ? !value.toString().includes('.') : false;
+}
+/**
+ * Checks if value is a double
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a double or not
+ */
+export function isDouble(value) {
+    const num = Number(value);
+    return !isNaN(num) ? value.toString().includes('.') : false;
+}
+/**
+ * Checks if value is a boolean
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a boolean or not
+ */
+export function isBoolean(value) {
+    return value.toString().toLowerCase() === 'true' || value.toString().toLowerCase() === 'false';
+}
+/**
+ * Checks if value is a date
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a date or not
+ */
+export function isDate(value) {
+    const date = new Date(value);
+    return !isNaN(date.getTime());
+}
+/**
+ * Checks if value is a string
+ *
+ * @param value - string to validate
+ * @returns {boolean} - whether value is a string or not
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Checks if the given value is a Date object.
+ *
+ * @param {*} d - The value to check.
+ * @returns {boolean} True if the value is an instance of Date, otherwise false.
+ */
+export function isDateType(d) {
+    return d instanceof Date;
+}
+/**
+ * Determines whether a given CML data type requires scale precision.
+ *
+ * @param {string} type - The CML data type to check (e.g., "double", "decimal").
+ * @returns {boolean} - Returns `true` if the type requires scale precision, otherwise `false`.
+ */
+export function isScaledType(type) {
+    return type === CML_DATA_TYPES.DOUBLE || type === CML_DATA_TYPES.DECIMAL;
+}
+/**
+ * Parses a string by removing surrounding quotes (single or double).
+ *
+ * @param {string} value - The string to be parsed.
+ * @returns {string} - The parsed string with quotes removed, or the original string if no quotes are found.
+ */
+export function parseString(value) {
+    if (typeof value === 'string' &&
+        ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'")))) {
+        return value.slice(1, -1);
+    }
+    return value; // Return the original string if no surrounding quotes
+}
+/**
+ * Parses a date string into a Date object or returns the original string if invalid
+ *
+ * We return the original string because it may be a CML constant variable reference
+ *
+ * @param {string} stringValue - A date string in the format "YYYY-MM-DD"
+ * @returns {Date|string} A valid Date object if parsing succeeds, or the original string if invalid
+ */
+export function parseDate(stringValue) {
+    const parts = stringValue.split('-');
+    // Ensure the format has exactly 3 parts (year, month, day)
+    if (parts.length !== 3) {
+        return stringValue;
+    }
+    // Convert parts to numbers
+    const [year, month, day] = parts.map(Number);
+    // Validate year, month, and day
+    if (!Number.isInteger(year) ||
+        !Number.isInteger(month) ||
+        !Number.isInteger(day) ||
+        month < 1 ||
+        month > 12 ||
+        day < 1 ||
+        day > 31) {
+        return stringValue;
+    }
+    // Create and validate the Date object
+    const date = new Date(year, month - 1, day);
+    // Ensure the Date object matches the input values
+    if (date.getFullYear() !== year || date.getMonth() + 1 !== month || date.getDate() !== day) {
+        return stringValue;
+    }
+    return date;
+}
+/**
+ * Parses a numeric string into a number (either integer or float).
+ *
+ * @param {string} value - The string representation of the number.
+ * @returns {number} - The parsed number.
+ * @throws {Error} - Throws an error if the value cannot be parsed as a number.
+ */
+export function parseNumber(value) {
+    const parsedValue = parseFloat(value);
+    if (isNaN(parsedValue)) {
+        throw new Error(`Invalid number format: ${value}`);
+    }
+    return Number.isInteger(parsedValue) ? parseInt(value, 10) : parsedValue;
+}
+/**
+ * Determines whether a given type is a number type.
+ *
+ * @param {string} type - The attribute type (e.g., "int", "double", "decimal").
+ * @returns {boolean} - True if the type is a number type, false otherwise.
+ */
+export function isNumberType(type) {
+    return Object.values(CML_NUMBER_DATA_TYPES).includes(type);
+}
+/**
+ * Determines whether a given type is a date type.
+ *
+ * @param {string} type - The attribute type (e.g., "date", "int").
+ * @returns {boolean} - True if the type is "date", false otherwise.
+ */
+export function isDateDataType(type) {
+    return type === CML_DATA_TYPES.DATE;
+}
+/**
+ * Formats a Date object to a CML-compatible date string in the format "YYYY-MM-DD".
+ *
+ * @param {Date} date - The Date object to format.
+ * @returns {string} The formatted date string in "YYYY-MM-DD" format, enclosed in double quotes.
+ */
+export function formatToCmlDate(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `"${year}-${month}-${day}"`;
+}
+/**
+ * Formats a Date object to a user-friendly display string in the format "Month Day, Year".
+ *
+ * @param {Date} date - The Date object to format.
+ * @returns {string} The formatted date string in "Month Day, Year" format (e.g., "March 27, 1994").
+ */
+export function formatToDisplayDate(date) {
+    return date.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' });
+}
+/**
+ * Converts the HTML entities &amp;, &lt;, &gt;, &quot;, and &#39; in string to their corresponding characters.
+ *
+ * @param {string} source - The source string
+ * @returns {string} The string with unescaped HTML characters.
+ */
+export function unescapeHtml(source) {
+    return source
+        .replace(/&amp;/g, '&')
+        .replace(/&gt;/g, '>')
+        .replace(/&lt;/g, '<')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'");
+}
+//# sourceMappingURL=common.utils.js.map

package/lib/shared/utils/common.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/common.utils.ts"],"names":[],"mappings":"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"}

package/messages/call.external.service.md

@@ -0,0 +1,20 @@
+# summary
+
+Summary of a command.
+
+# description
+
+More information about a command. Don't repeat the summary. 
+
+# flags.name.summary
+
+Description of a flag.
+
+# flags.name.description
+
+More information about a flag. Don't repeat the summary. 
+
+# examples
+
+- <%= config.bin %> <%= command.id %>
+

package/messages/cml.convert.prod-cfg-rules.md

@@ -0,0 +1,59 @@
+# summary
+
+Converts BRE based Standard Configurator rules represented as JSON to CML and saves it as a pair of CML and association files.
+
+# description
+
+Before you execute this command make sure to migrate you PCM or perform migration of rules within the same org.
+
+Export BRE based Standard Configurator rules using sf data export bulk plugin and save results in a JSON file:
+sf data export bulk -o breMigOrg --query "SELECT ApiName, ConfigurationRuleDefinition,Description, EffectiveFromDate, EffectiveToDate, Id, IsDeleted, Name, ProcessScope, RuleSubType, RuleType, Sequence, Status FROM ProductConfigurationRule WHERE RuleType = 'Configurator' AND ApiName = 'myTestBundle'" --output-file ./data/ProductConfigurationRules.json --result-format json --wait 10 --all-rows
+
+This command executes following logic:
+
+- Read SC Rules from the json file and build a list of `ConfiguratorRuleInput` to mimic the JSON structure of `ConfigurationRuleDefinition`
+- Group rules by non-intersecting `Product2` IDs (CMLs can’t share products)
+- For each group:
+  - Query PCM for related products (for bundle rules) or root definitions (for others)
+  - Build an in-memory representation of the CML
+  - Apply logic to build constraints
+- Serialize the in-memory CML to a blob for import as an Expression Set, save it in a cml-api.cml file. 
+- Create `ExpressionSetConstraintObj` association records pointing to the `cml-api` name and write them to `cml-api_associations.csv` file.
+- If multiple CML and association files are produced 1-N number will be appended to the names of files.
+
+# flags.name.summary
+
+Description of a flag.
+
+# flags.name.description
+
+More information about a flag. Don't repeat the summary.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --pcr-file data/ProductConfigurationRules.json --cml-api MY_TEST --workspace-dir data --target-org breMigOrg
+
+
+# flags.pcr-file.summary
+
+Name of the JSON file that contain exported standard Product Configuration Rules.
+
+# flags.cml-api.summary
+
+Unique CML API Name to be created.
+
+# flags.workspace-dir.summary
+
+Directory where working files are located, exported rules JSON and where CMLs will be created.
+
+# flags.target-org.summary
+
+Alias of the source target org.
+
+# flags.additional-products.summary
+
+Comma-separated list of additional product IDs for which CML types should be generated.
+
+# flags.products-file.summary
+
+Name of the JSON file that contain exported Products from PCM (if not present products will be fetched automatically).

package/messages/cml.import.as-expression-set.md

@@ -0,0 +1,32 @@
+# summary
+
+Imports CML and associations to the target org
+
+# description
+
+Review CM created by conversion command before doing import.  
+This command executes following logic:
+- Import one CML at a time
+- Upsert the Expression Set using the `cml-api` name
+- Read and upsert `ExpressionSetConstraintObj` rows from the `cml-api_associations.csv` file (resolving FKs)
+- Upload the CML blob
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --cml-api MY_TEST --context-definition PricingTransactionCD2 --workspace-dir data --target-org tgtOrg
+
+# flags.context-definition.summary
+
+Context Definition name to be assocciated with the CML.
+
+# flags.cml-api.summary
+
+Unique CML API Name to be created.
+
+# flags.workspace-dir.summary
+
+Directory where converted CML and assocciations csv files are located.
+
+# flags.target-org.summary
+
+Alias of the destination target org.

package/messages/connect.org.md

@@ -0,0 +1,19 @@
+# summary
+
+Summary of a command.
+
+# description
+
+More information about a command. Don't repeat the summary.
+
+# flags.name.summary
+
+Description of a flag.
+
+# flags.name.description
+
+More information about a flag. Don't repeat the summary.
+
+# examples
+
+- <%= config.bin %> <%= command.id %>