@salesforce/plugin-bre-to-cml 1.0.48 → 1.1.0

package/lib/shared/cml-operators.js

@@ -0,0 +1,87 @@
+export function escapeQuotes(str) {
+    return str.replace(/['"]/g, '\\$&');
+}
+export function doubleQuoted(str) {
+    if (str) {
+        return `"${escapeQuotes(str)}"`;
+    }
+    return str ?? "''";
+}
+export function doubleQuotedIfNeeded(value, dataType) {
+    if (typeof value === 'string' || typeof value === 'undefined') {
+        return `${dataType === 'string' ? doubleQuoted(value) ?? '' : value ?? "''"}`;
+    }
+    const singleValue = value[0];
+    return `${dataType === 'string' ? doubleQuoted(singleValue) ?? '' : singleValue ?? "''"}`;
+}
+export function generateInCmlExpression(left, right) {
+    if (typeof right === 'string') {
+        return `${left} == ${doubleQuoted(right)}`;
+    }
+    return right.map((r) => `${left} == ${doubleQuoted(r)}`).join(' || ');
+}
+function firstValue(right) {
+    if (right === undefined)
+        return undefined;
+    return typeof right === 'string' ? right : right[0];
+}
+export function convertToCmlExpression(left, ruleExprOperator, right, dataType) {
+    switch (ruleExprOperator) {
+        case 'Equals':
+            return `${left} == ${doubleQuotedIfNeeded(right, dataType)}`;
+        case 'NotEquals':
+            return `${left} != ${doubleQuotedIfNeeded(right, dataType)}`;
+        case 'LessThan':
+            return `${left} < ${right ?? ''}`;
+        case 'LessThanOrEquals':
+            return `${left} <= ${right ?? ''}`;
+        case 'GreaterThan':
+            return `${left} > ${right ?? ''}`;
+        case 'GreaterThanOrEquals':
+            return `${left} >= ${right ?? ''}`;
+        case 'IsNotNull':
+            return `${left} != null`;
+        case 'IsNull':
+            return `${left} == null`;
+        case 'Contains':
+            return `strcontain(${left}, ${doubleQuoted(firstValue(right))})`;
+        case 'DoesNotContain':
+            return `!strcontain(${left}, ${doubleQuoted(firstValue(right))})`;
+        case 'In':
+            if (right) {
+                return `(${generateInCmlExpression(left, right)})`;
+            }
+            return `${left} == null`;
+        case 'NotIn':
+            if (right) {
+                return `!(${generateInCmlExpression(left, right)})`;
+            }
+            return `${left} != null`;
+        default: {
+            const exhaustive = ruleExprOperator;
+            throw new Error(`Unsupported rule operator: ${String(exhaustive)}`);
+        }
+    }
+}
+const KNOWN_OPERATORS = new Set([
+    'Equals',
+    'NotEquals',
+    'LessThan',
+    'LessThanOrEquals',
+    'GreaterThan',
+    'GreaterThanOrEquals',
+    'IsNotNull',
+    'IsNull',
+    'Contains',
+    'DoesNotContain',
+    'In',
+    'NotIn',
+]);
+export function isKnownOperator(op) {
+    return KNOWN_OPERATORS.has(op);
+}
+const NULL_OPERATORS = new Set(['IsNull', 'IsNotNull']);
+export function operatorRequiresValues(op) {
+    return !NULL_OPERATORS.has(op);
+}
+//# sourceMappingURL=cml-operators.js.map

package/lib/shared/cml-operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cml-operators.js","sourceRoot":"","sources":["../../src/shared/cml-operators.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoC,EAAE,QAA4B;IACrG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE,CAAC;QAC9D,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,KAAwB;IAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,UAAU,CAAC,KAAoC;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,gBAAuC,EACvC,KAAyB,EACzB,QAAiB;IAEjB,QAAQ,gBAAgB,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,OAAO,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/D,KAAK,WAAW;YACd,OAAO,GAAG,IAAI,OAAO,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/D,KAAK,UAAU;YACb,OAAO,GAAG,IAAI,MAAO,KAA4B,IAAI,EAAE,EAAE,CAAC;QAC5D,KAAK,kBAAkB;YACrB,OAAO,GAAG,IAAI,OAAQ,KAA4B,IAAI,EAAE,EAAE,CAAC;QAC7D,KAAK,aAAa;YAChB,OAAO,GAAG,IAAI,MAAO,KAA4B,IAAI,EAAE,EAAE,CAAC;QAC5D,KAAK,qBAAqB;YACxB,OAAO,GAAG,IAAI,OAAQ,KAA4B,IAAI,EAAE,EAAE,CAAC;QAC7D,KAAK,WAAW;YACd,OAAO,GAAG,IAAI,UAAU,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,UAAU,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,cAAc,IAAI,KAAK,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QACnE,KAAK,gBAAgB;YACnB,OAAO,eAAe,IAAI,KAAK,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QACpE,KAAK,IAAI;YACP,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,IAAI,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;YACrD,CAAC;YACD,OAAO,GAAG,IAAI,UAAU,CAAC;QAC3B,KAAK,OAAO;YACV,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;YACtD,CAAC;YACD,OAAO,GAAG,IAAI,UAAU,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,gBAAgB,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAwB;IAC1E,QAAQ;IACR,WAAW;IACX,UAAU;IACV,kBAAkB;IAClB,aAAa;IACb,qBAAqB;IACrB,WAAW;IACX,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,IAAI;IACJ,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,cAAc,GAAuC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAE5F,MAAM,UAAU,sBAAsB,CAAC,EAAyB;IAC9D,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/lib/shared/insurance/insurance-org.d.ts

@@ -0,0 +1,9 @@
+import { Connection } from '@salesforce/core';
+/**
+ * Builds a quoted, comma-separated SOQL id list, keeping only well-formed Salesforce ids.
+ * Product ids originate from rule definitions that may be supplied via --surcharge-file /
+ * --uw-file, so validating here prevents SOQL injection through the `IN (...)` clause.
+ */
+export declare function quoteSoqlIdList(ids: Iterable<string>): string;
+export declare function fetchProductCodes(conn: Connection, productIds: Set<string>): Promise<Map<string, string>>;
+export declare function discoverCmlApiByProducts(conn: Connection, productIds: Set<string>): Promise<string | undefined>;

package/lib/shared/insurance/insurance-org.js

@@ -0,0 +1,40 @@
+/** Matches a well-formed 15- or 18-character Salesforce record id. */
+const SALESFORCE_ID_PATTERN = /^[a-zA-Z0-9]{15,18}$/;
+/**
+ * Builds a quoted, comma-separated SOQL id list, keeping only well-formed Salesforce ids.
+ * Product ids originate from rule definitions that may be supplied via --surcharge-file /
+ * --uw-file, so validating here prevents SOQL injection through the `IN (...)` clause.
+ */
+export function quoteSoqlIdList(ids) {
+    return Array.from(ids)
+        .filter((id) => SALESFORCE_ID_PATTERN.test(id))
+        .map((id) => `'${id}'`)
+        .join(',');
+}
+export async function fetchProductCodes(conn, productIds) {
+    const idToCode = new Map();
+    const idList = quoteSoqlIdList(productIds);
+    if (!idList)
+        return idToCode;
+    const result = await conn.query(`SELECT Id, ProductCode, Name FROM Product2 WHERE Id IN (${idList})`);
+    for (const p of result.records) {
+        idToCode.set(p.Id, p.ProductCode ?? p.Name ?? p.Id);
+    }
+    return idToCode;
+}
+export async function discoverCmlApiByProducts(conn, productIds) {
+    const idList = quoteSoqlIdList(productIds);
+    if (!idList)
+        return undefined;
+    const assocResult = await conn.query(`SELECT ExpressionSetId FROM ExpressionSetConstraintObj WHERE ReferenceObjectId IN (${idList}) AND ConstraintModelTagType = 'Type' LIMIT 1`);
+    if (assocResult.records.length === 0)
+        return undefined;
+    const esId = assocResult.records[0].ExpressionSetId;
+    if (!SALESFORCE_ID_PATTERN.test(esId))
+        return undefined;
+    const esResult = await conn.query(`SELECT ApiName FROM ExpressionSet WHERE Id = '${esId}'`);
+    if (esResult.records.length === 0)
+        return undefined;
+    return esResult.records[0].ApiName;
+}
+//# sourceMappingURL=insurance-org.js.map

package/lib/shared/insurance/insurance-org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insurance-org.js","sourceRoot":"","sources":["../../../src/shared/insurance/insurance-org.ts"],"names":[],"mappings":"AAiBA,sEAAsE;AACtE,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;SACnB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAC9C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;SACtB,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAgB,EAAE,UAAuB;IAC/E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,2DAA2D,MAAM,GAAG,CACrE,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAgB,EAAE,UAAuB;IACtF,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAClC,sFAAsF,MAAM,+CAA+C,CAC5I,CAAC;IACF,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEvD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IACpD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAsB,iDAAiD,IAAI,GAAG,CAAC,CAAC;IACjH,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACrC,CAAC"}

package/lib/shared/insurance/insurance-rule-convert-command.d.ts

@@ -0,0 +1,38 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Connection, Org } from '@salesforce/core';
+import { ParsedRuleDefinition, RuleKeyEntry, RuleRecord } from './models.js';
+export type InsuranceRuleConvertResult = {
+    cmlFile: string;
+    associationsFile: string;
+    ruleKeyMapping: RuleKeyEntry[];
+};
+export type InsuranceRuleConvertContext = {
+    targetOrg: Org;
+    apiVersion: string | undefined;
+    cmlApi: string | undefined;
+    workspaceDir: string | undefined;
+    inputFile: string | undefined;
+    updateRecords: boolean;
+};
+export declare abstract class InsuranceRuleConvertCommand<R extends RuleRecord> extends SfCommand<InsuranceRuleConvertResult> {
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cml-api': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'workspace-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'update-records': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected abstract readonly recordLabel: string;
+    protected abstract readonly keyPrefix: string;
+    protected abstract readonly constraintLabel: string;
+    protected abstract readonly apiNamePrefix: string;
+    protected abstract readonly soql: string;
+    protected runConvert(ctx: InsuranceRuleConvertContext): Promise<InsuranceRuleConvertResult>;
+    private loadRecords;
+    private parseAllRecords;
+    private resolveProductCodes;
+    private discoverCmlApi;
+    private writeOutputFiles;
+    protected abstract parseRecord(record: R): ParsedRuleDefinition | null;
+    protected abstract updateOrgRecords(records: R[], ruleKeyMapping: RuleKeyEntry[], conn: Connection): Promise<void>;
+}

package/lib/shared/insurance/insurance-rule-convert-command.js

@@ -0,0 +1,144 @@
+/*
+ * Copyright 2026, 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.
+ */
+/* eslint-disable sf-plugin/command-summary, sf-plugin/command-example, sf-plugin/no-hardcoded-messages-commands */
+// This file is a shared abstract base, not a user-invocable command, so the
+// command-shape lint rules do not apply.
+import * as fs from 'node:fs/promises';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { generateCsvForAssociations } from '../utils/association.utils.js';
+import { buildCmlModel } from './insurance-rule-generator.js';
+import { discoverCmlApiByProducts, fetchProductCodes } from './insurance-org.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-bre-to-cml', 'cml.convert.insurance-shared');
+export class InsuranceRuleConvertCommand extends SfCommand {
+    static flags = {
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        'cml-api': Flags.string({
+            summary: messages.getMessage('flags.cml-api.summary'),
+            char: 'c',
+        }),
+        'workspace-dir': Flags.directory({
+            summary: messages.getMessage('flags.workspace-dir.summary'),
+            char: 'd',
+            exists: true,
+        }),
+        'update-records': Flags.boolean({
+            summary: messages.getMessage('flags.update-records.summary'),
+            default: false,
+        }),
+    };
+    async runConvert(ctx) {
+        const workspaceDir = ctx.workspaceDir ?? '.';
+        this.log(`Using Workspace Directory: ${ctx.workspaceDir ?? 'not specified'}`);
+        const conn = ctx.targetOrg.getConnection(ctx.apiVersion);
+        const records = await this.loadRecords(conn, ctx.inputFile);
+        if (records.length === 0) {
+            this.log(`No ${this.recordLabel} rules to convert.`);
+            return { cmlFile: '', associationsFile: '', ruleKeyMapping: [] };
+        }
+        const ruleDefs = this.parseAllRecords(records);
+        const productIdToCode = await this.resolveProductCodes(conn, ruleDefs);
+        const api = ctx.cmlApi ?? (await this.discoverCmlApi(conn, ruleDefs, productIdToCode));
+        const safeApi = api.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const { cmlModel, ruleKeyMapping } = buildCmlModel(ruleDefs, productIdToCode, this.keyPrefix, this.constraintLabel);
+        ruleKeyMapping.forEach((m) => this.log(`  -> ${m.name} => ${m.ruleKey}`));
+        if (ctx.updateRecords) {
+            await this.updateOrgRecords(records, ruleKeyMapping, conn);
+        }
+        return this.writeOutputFiles(cmlModel, ruleKeyMapping, safeApi, workspaceDir, api);
+    }
+    async loadRecords(conn, inputFile) {
+        if (inputFile) {
+            this.log(`Reading ${this.recordLabel} records from file: ${inputFile}`);
+            const contents = await fs.readFile(inputFile, 'utf8');
+            return JSON.parse(contents);
+        }
+        this.log(`Querying ${this.recordLabel} records from org...`);
+        const result = await conn.query(this.soql);
+        this.log(`Found ${result.records.length} ${this.recordLabel} records with BRE rules`);
+        return result.records;
+    }
+    parseAllRecords(records) {
+        const parsed = [];
+        for (const record of records) {
+            try {
+                const ruleDef = this.parseRecord(record);
+                if (ruleDef) {
+                    parsed.push({ record, ruleDef });
+                }
+            }
+            catch (e) {
+                this.warn(`Failed to convert ${record.Name}: ${e.message}`);
+            }
+        }
+        this.log(`Parsed ${parsed.length} valid rule definitions`);
+        return parsed;
+    }
+    async resolveProductCodes(conn, ruleDefs) {
+        const productIds = collectRootProductIds(ruleDefs);
+        try {
+            return await fetchProductCodes(conn, productIds);
+        }
+        catch (e) {
+            this.warn(`Could not fetch product codes: ${e.message}. Using product IDs instead.`);
+            return new Map();
+        }
+    }
+    async discoverCmlApi(conn, ruleDefs, productIdToCode) {
+        const productIds = collectRootProductIds(ruleDefs);
+        try {
+            const discovered = await discoverCmlApiByProducts(conn, productIds);
+            if (discovered) {
+                this.log(`Auto-discovered existing CML API: ${discovered}`);
+                return discovered;
+            }
+        }
+        catch (e) {
+            this.warn(`CML auto-discovery failed: ${e.message}`);
+        }
+        const codes = Array.from(productIds).map((id) => productIdToCode.get(id) ?? id);
+        const generated = `${this.apiNamePrefix}${codes.join('_')}`;
+        this.log(`No existing CML found. Generated new CML API name: ${generated}`);
+        return generated;
+    }
+    async writeOutputFiles(cmlModel, ruleKeyMapping, safeApi, workspaceDir, api) {
+        const cmlPath = `${workspaceDir}/${safeApi}.cml`;
+        const associationsPath = `${workspaceDir}/${safeApi}_Associations.csv`;
+        const mappingPath = `${workspaceDir}/${safeApi}_RuleKeyMapping.json`;
+        await fs.writeFile(cmlPath, cmlModel.generateCml(), 'utf8');
+        await fs.writeFile(associationsPath, generateCsvForAssociations(safeApi, cmlModel.associations), 'utf8');
+        await fs.writeFile(mappingPath, JSON.stringify(ruleKeyMapping, null, 2), 'utf8');
+        this.log(`\nCML written to: ${cmlPath}`);
+        this.log(`Associations written to: ${associationsPath}`);
+        this.log(`Rule key mapping written to: ${mappingPath}`);
+        this.log(`\nConverted ${ruleKeyMapping.length} ${this.recordLabel} rules to CML`);
+        this.log('\nNext steps:');
+        this.log('  1. Review the generated .cml file');
+        this.log(`  2. Import: sf cml import as-expression-set --cml-api ${api} --context-definition <CD_NAME> --target-org <org>`);
+        this.log('  3. Update records with RuleKey from mapping file');
+        return { cmlFile: cmlPath, associationsFile: associationsPath, ruleKeyMapping };
+    }
+}
+function collectRootProductIds(ruleDefs) {
+    const productIds = new Set();
+    for (const { record } of ruleDefs) {
+        productIds.add(record.ProductPath.split('/')[0]);
+    }
+    return productIds;
+}
+//# sourceMappingURL=insurance-rule-convert-command.js.map

package/lib/shared/insurance/insurance-rule-convert-command.js.map

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

package/lib/shared/insurance/insurance-rule-generator.d.ts

@@ -0,0 +1,26 @@
+import { CmlModel } from '../types/types.js';
+import { ParsedRuleDefinition, RuleCriteria, RuleKeyEntry, RuleRecord, UnderwritingRuleGroup } from './models.js';
+export declare function sanitizeName(name: string): string;
+/**
+ * Decodes the common HTML entities that can appear in a RuleDefinition / DynamicRuleDefinition
+ * field when the JSON was persisted HTML-escaped. `&` is decoded last so already-decoded
+ * ampersands are not double-processed.
+ */
+export declare function decodeHtmlEntities(value: string): string;
+export declare function buildStageTransition(ruleGroup?: UnderwritingRuleGroup): string | undefined;
+export declare function generateRuleKey(prefix: string, productCode: string, apiName: string, stageTransition?: string): string;
+export declare function buildConstraintDeclaration(ruleDef: {
+    ruleCriteria?: RuleCriteria[];
+}): string;
+export declare function collectAttributes(ruleDefs: Array<{
+    ruleDef: {
+        ruleCriteria?: RuleCriteria[];
+    };
+}>): Set<string>;
+export declare function buildCmlModel(ruleDefs: Array<{
+    record: RuleRecord;
+    ruleDef: ParsedRuleDefinition;
+}>, productIdToCode: Map<string, string>, keyPrefix: string, constraintLabel: string): {
+    cmlModel: CmlModel;
+    ruleKeyMapping: RuleKeyEntry[];
+};

package/lib/shared/insurance/insurance-rule-generator.js

@@ -0,0 +1,144 @@
+/*
+ * Copyright 2026, 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 { ASSOCIATION_TYPES, CML_DATA_TYPES, CONSTRAINT_TYPES } from '../constants/constants.js';
+import { Association, CmlAttribute, CmlConstraint, CmlModel, CmlType } from '../types/types.js';
+import { convertToCmlExpression, isKnownOperator, operatorRequiresValues } from '../cml-operators.js';
+function dataTypeToCml(dataType) {
+    const types = {
+        Number: CML_DATA_TYPES.INTEGER,
+        Integer: CML_DATA_TYPES.INTEGER,
+        Percent: CML_DATA_TYPES.DECIMAL,
+        Currency: CML_DATA_TYPES.DECIMAL,
+        Boolean: CML_DATA_TYPES.BOOLEAN,
+        Date: CML_DATA_TYPES.DATE,
+        DateTime: CML_DATA_TYPES.DATE,
+    };
+    return (dataType && types[dataType]) ?? CML_DATA_TYPES.STRING;
+}
+export function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9]/g, '_');
+}
+/**
+ * Decodes the common HTML entities that can appear in a RuleDefinition / DynamicRuleDefinition
+ * field when the JSON was persisted HTML-escaped. `&` is decoded last so already-decoded
+ * ampersands are not double-processed.
+ */
+export function decodeHtmlEntities(value) {
+    return value
+        .replace(/"/g, '"')
+        .replace(/'/g, "'")
+        .replace(/'/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&');
+}
+function stripSpaces(stage) {
+    return stage.replace(/\s+/g, '');
+}
+export function buildStageTransition(ruleGroup) {
+    if (!ruleGroup?.fromStage || !ruleGroup?.toStage)
+        return undefined;
+    return `${stripSpaces(ruleGroup.fromStage)}To${stripSpaces(ruleGroup.toStage)}`;
+}
+export function generateRuleKey(prefix, productCode, apiName, stageTransition) {
+    const parts = [prefix, sanitizeName(productCode)];
+    if (stageTransition)
+        parts.push(stageTransition);
+    parts.push(sanitizeName(apiName));
+    return parts.join('__');
+}
+function buildConditionExpression(condition) {
+    if (!isKnownOperator(condition.operator))
+        return null;
+    const op = condition.operator;
+    if (operatorRequiresValues(op) && (!condition.values || condition.values.length === 0)) {
+        return null;
+    }
+    const attrName = sanitizeName(condition.attributeName ?? condition.contextTagName ?? 'unknown');
+    const cmlDataType = dataTypeToCml(condition.dataType);
+    return convertToCmlExpression(attrName, op, condition.values, cmlDataType);
+}
+function buildCriteriaExpression(criteria) {
+    const parts = [];
+    if (criteria.conditions) {
+        for (const condition of criteria.conditions) {
+            const expr = buildConditionExpression(condition);
+            if (expr)
+                parts.push(expr);
+        }
+    }
+    return parts.length > 0 ? parts.join(' && ') : null;
+}
+export function buildConstraintDeclaration(ruleDef) {
+    if (!ruleDef.ruleCriteria || ruleDef.ruleCriteria.length === 0) {
+        return 'true';
+    }
+    const expressions = ruleDef.ruleCriteria.map(buildCriteriaExpression).filter((e) => e !== null);
+    if (expressions.length === 0)
+        return 'true';
+    if (expressions.length === 1)
+        return expressions[0];
+    return expressions.map((e) => `(${e})`).join(' || ');
+}
+export function collectAttributes(ruleDefs) {
+    const attrs = new Set();
+    for (const { ruleDef } of ruleDefs) {
+        for (const criteria of ruleDef.ruleCriteria ?? []) {
+            for (const cond of criteria.conditions ?? []) {
+                const name = cond.attributeName ?? cond.contextTagName;
+                if (name)
+                    attrs.add(name);
+            }
+        }
+    }
+    return attrs;
+}
+export function buildCmlModel(ruleDefs, productIdToCode, keyPrefix, constraintLabel) {
+    const cmlModel = new CmlModel();
+    const rulesByProduct = new Map();
+    for (const entry of ruleDefs) {
+        const rootProductId = entry.record.ProductPath.split('/')[0];
+        if (!rulesByProduct.has(rootProductId)) {
+            rulesByProduct.set(rootProductId, []);
+        }
+        rulesByProduct.get(rootProductId).push(entry);
+    }
+    const ruleKeyMapping = [];
+    for (const [rootProductId, productRules] of rulesByProduct) {
+        const productCode = productIdToCode.get(rootProductId) ?? rootProductId;
+        const typeName = sanitizeName(productCode);
+        const productType = new CmlType(typeName, undefined, undefined);
+        const attrs = collectAttributes(productRules);
+        for (const attrName of attrs) {
+            productType.addAttribute(new CmlAttribute(null, sanitizeName(attrName), CML_DATA_TYPES.STRING));
+        }
+        for (const { record, ruleDef } of productRules) {
+            const apiName = ruleDef.apiName ?? record.Name;
+            const stageTransition = buildStageTransition(ruleDef.underwritingRuleGroup);
+            const ruleKey = generateRuleKey(keyPrefix, productCode, apiName, stageTransition);
+            const constraint = new CmlConstraint(CONSTRAINT_TYPES.CONSTRAINT, buildConstraintDeclaration(ruleDef), `"${constraintLabel}: ${record.Name}"`);
+            // Mirror generateRuleKey: include the stage transition so two rules that share an
+            // apiName under the same product (gated on different transitions) don't collide.
+            constraint.name = sanitizeName(stageTransition ? `${apiName}_${stageTransition}` : apiName);
+            productType.addConstraint(constraint);
+            ruleKeyMapping.push({ recordId: record.Id, name: record.Name, ruleKey });
+        }
+        cmlModel.addType(productType);
+        cmlModel.addAssociation(new Association(null, typeName, ASSOCIATION_TYPES.TYPE, rootProductId, 'Product2', productCode));
+    }
+    return { cmlModel, ruleKeyMapping };
+}
+//# sourceMappingURL=insurance-rule-generator.js.map

package/lib/shared/insurance/insurance-rule-generator.js.map

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

package/lib/shared/insurance/models.d.ts

@@ -0,0 +1,44 @@
+export type RuleCondition = {
+    contextTagName?: string;
+    operator: string;
+    conditionIndex?: number;
+    attributeName?: string;
+    attributePicklistValueId?: string;
+    attributeId?: string;
+    dataType?: string;
+    type?: string;
+    values?: string[];
+};
+export type RuleCriteria = {
+    rootObjectId: string;
+    criteriaIndex?: number;
+    sourceContextTagName?: string;
+    sourceOperator?: string;
+    sourceDataType?: string;
+    sourceValues?: string[];
+    conditions?: RuleCondition[];
+};
+export type UnderwritingRuleGroup = {
+    fromStage?: string;
+    toStage?: string;
+    stageTransitionName?: string;
+};
+export type ParsedRuleDefinition = {
+    name: string;
+    apiName: string;
+    productPath: string;
+    status?: string;
+    description?: string;
+    ruleCriteria?: RuleCriteria[];
+    underwritingRuleGroup?: UnderwritingRuleGroup;
+};
+export type RuleRecord = {
+    Id: string;
+    Name: string;
+    ProductPath: string;
+};
+export type RuleKeyEntry = {
+    recordId: string;
+    name: string;
+    ruleKey: string;
+};

package/lib/shared/insurance/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/lib/shared/insurance/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/shared/insurance/models.ts"],"names":[],"mappings":""}

package/messages/cml.convert.insurance-shared.md

@@ -0,0 +1,11 @@
+# flags.cml-api.summary
+
+CML API Name. If omitted, auto-discovers an existing CML associated with the same root products.
+
+# flags.workspace-dir.summary
+
+Directory where output files will be written.
+
+# flags.update-records.summary
+
+Update source records in the org with RuleEngineType=ConstraintEngine.

package/messages/cml.convert.surcharge-rules.md

@@ -0,0 +1,17 @@
+# summary
+
+Converts BRE-based Product Surcharge dynamic rules to CML eligibility constraints.
+
+# description
+
+Reads ProductSurcharge records from the org (or a JSON file), parses their RuleDefinition, and generates CML constraints that evaluate surcharge eligibility. Each surcharge rule becomes a named constraint that returns true/false. The command outputs a .cml file with the constraint model, an \_Associations.csv file for ExpressionSetConstraintObj records, and a \_RuleKeyMapping.json with the ProductSurcharge ID to RuleKey mapping for updating records.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --cml-api SURCHARGE_CML --target-org myOrg
+
+- <%= config.bin %> <%= command.id %> --cml-api SURCHARGE_CML --surcharge-file path/to/surcharges.json --workspace-dir data --target-org myOrg
+
+# flags.surcharge-file.summary
+
+Optional JSON file with pre-exported ProductSurcharge records. If omitted, records are queried from the org.

package/messages/cml.convert.underwriting-rules.md

@@ -0,0 +1,17 @@
+# summary
+
+Converts BRE-based Insurance Underwriting dynamic rules to CML eligibility constraints.
+
+# description
+
+Reads UnderwritingRule records from the org (or a JSON file), parses their DynamicRuleDefinition, and generates CML constraints that evaluate underwriting eligibility. Each rule becomes a named constraint that returns true/false. The command outputs a .cml file with the constraint model, an \_Associations.csv file for ExpressionSetConstraintObj records, and a \_RuleKeyMapping.json with the UnderwritingRule ID to RuleKey mapping for updating records.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --cml-api UW_CML --target-org myOrg
+
+- <%= config.bin %> <%= command.id %> --cml-api UW_CML --uw-file data/underwriting.json --workspace-dir data --target-org myOrg
+
+# flags.uw-file.summary
+
+Optional JSON file with pre-exported UnderwritingRule records. If omitted, records are queried from the org.