@mcp-consultant-tools/powerplatform-core 26.0.0-beta.2

package/build/utils/bestPractices.js

@@ -0,0 +1,324 @@
+/**
+ * Best Practices Validation Module
+ *
+ * Hard-coded SmartImpact CRM best practices for entity and attribute customization.
+ * These rules are enforced during entity and attribute creation/update operations.
+ */
+/**
+ * Hard-coded best practices rules for SmartImpact CRM customizations
+ */
+export const BEST_PRACTICES = {
+    publisher: {
+        prefix: 'sic_',
+        name: 'SmartImpactCustomer',
+        optionValuePrefix: 15743,
+    },
+    entity: {
+        ownershipType: {
+            allowed: ['UserOwned', 'TeamOwned'],
+            forbidden: ['OrganizationOwned'],
+            default: 'UserOwned',
+        },
+        prefix: 'sic_',
+        refDataInfix: 'ref_',
+        caseRule: 'lowercase',
+    },
+    attribute: {
+        lookupSuffix: 'id',
+        caseRule: 'lowercase',
+        avoidBooleans: true,
+        dateTimeDefaultBehavior: 'TimeZoneIndependent',
+    },
+    requiredColumns: {
+        allTables: [
+            {
+                schemaName: 'sic_updatedbyprocess',
+                displayName: 'Updated by process',
+                description: 'This field is updated, each time an automated process updates this record.',
+                type: 'String',
+                maxLength: 4000,
+            },
+        ],
+        refDataTables: [
+            {
+                schemaName: 'sic_startdate',
+                displayName: 'Start Date',
+                description: 'The date this reference data record started being used.',
+                type: 'DateTime',
+                format: 'DateOnly',
+                behavior: 'TimeZoneIndependent',
+            },
+            {
+                schemaName: 'sic_enddate',
+                displayName: 'End Date',
+                description: 'The date this reference data record stopped being used.',
+                type: 'DateTime',
+                format: 'DateOnly',
+                behavior: 'TimeZoneIndependent',
+            },
+            {
+                schemaName: 'sic_description',
+                displayName: 'Description',
+                description: 'Useful information about this reference data record.',
+                type: 'Memo',
+                maxLength: 20000,
+            },
+            {
+                schemaName: 'sic_code',
+                displayName: 'Code',
+                description: 'Code to identify the record, instead of GUID',
+                type: 'String',
+                maxLength: 100,
+            },
+        ],
+    },
+    form: {
+        firstColumnMustBeName: true,
+        standardColumnOrder: [
+            'name',
+            'createdon',
+            'createdby',
+            'modifiedon',
+            'modifiedby',
+            'statuscode',
+            'status',
+        ],
+        colorPalette: {
+            amber: '#ffd175',
+            green: '#8ed483',
+            red: '#ff8c8c',
+            grey: '#d1d1d1',
+        },
+        timelineActivityLimit: 10,
+    },
+    status: {
+        preferGlobalOptionSets: true,
+        avoidOOTBStateStatus: true,
+    },
+};
+/**
+ * Best Practices Validator Class
+ */
+export class BestPracticesValidator {
+    /**
+     * Validate entity naming conventions
+     */
+    validateEntityName(schemaName, isRefData) {
+        const rules = BEST_PRACTICES.entity;
+        const issues = [];
+        const warnings = [];
+        if (schemaName !== schemaName.toLowerCase()) {
+            issues.push(`Entity schema name must be all lowercase. Got: "${schemaName}"`);
+        }
+        if (!schemaName.startsWith(rules.prefix)) {
+            issues.push(`Entity schema name must start with publisher prefix "${rules.prefix}". Got: "${schemaName}"`);
+        }
+        else if (isRefData) {
+            const expectedPattern = rules.prefix + rules.refDataInfix;
+            if (!schemaName.startsWith(expectedPattern)) {
+                issues.push(`RefData entity schema name must follow pattern "${expectedPattern}<tablename>". ` +
+                    `Example: ${expectedPattern}cancellationreason. Got: "${schemaName}"`);
+            }
+        }
+        return {
+            isValid: issues.length === 0,
+            issues,
+            warnings,
+        };
+    }
+    /**
+     * Validate attribute naming conventions
+     */
+    validateAttributeName(schemaName, isLookup) {
+        const rules = BEST_PRACTICES.attribute;
+        const issues = [];
+        const warnings = [];
+        if (schemaName !== schemaName.toLowerCase()) {
+            issues.push(`Attribute schema name must be all lowercase. Got: "${schemaName}"`);
+        }
+        if (!schemaName.startsWith(BEST_PRACTICES.publisher.prefix)) {
+            issues.push(`Attribute schema name must start with "${BEST_PRACTICES.publisher.prefix}". Got: "${schemaName}"`);
+        }
+        if (isLookup && !schemaName.endsWith(rules.lookupSuffix)) {
+            warnings.push(`Lookup attribute should end with "${rules.lookupSuffix}". Got: "${schemaName}"`);
+        }
+        return {
+            isValid: issues.length === 0,
+            issues,
+            warnings,
+        };
+    }
+    /**
+     * Validate entity ownership type
+     */
+    validateOwnershipType(ownershipType) {
+        const rules = BEST_PRACTICES.entity.ownershipType;
+        const issues = [];
+        if (rules.forbidden.includes(ownershipType)) {
+            issues.push(`Ownership type "${ownershipType}" is forbidden. Use "${rules.default}" instead.`);
+        }
+        if (!rules.allowed.includes(ownershipType)) {
+            issues.push(`Ownership type "${ownershipType}" is not in allowed list: ${rules.allowed.join(', ')}`);
+        }
+        return {
+            isValid: issues.length === 0,
+            issues,
+            warnings: [],
+        };
+    }
+    /**
+     * Check if required columns are present
+     */
+    validateRequiredColumns(existingColumns, isRefData) {
+        const rules = BEST_PRACTICES.requiredColumns;
+        const issues = [];
+        const missingColumns = [];
+        for (const column of rules.allTables) {
+            if (!existingColumns.includes(column.schemaName)) {
+                missingColumns.push(column);
+                issues.push(`Missing required column: ${column.schemaName} (${column.displayName})`);
+            }
+        }
+        if (isRefData) {
+            for (const column of rules.refDataTables) {
+                if (!existingColumns.includes(column.schemaName)) {
+                    missingColumns.push(column);
+                    issues.push(`Missing required RefData column: ${column.schemaName} (${column.displayName})`);
+                }
+            }
+        }
+        return {
+            isValid: issues.length === 0,
+            issues,
+            warnings: [],
+            missingColumns,
+        };
+    }
+    /**
+     * Validate boolean usage (discouraged)
+     */
+    validateBooleanUsage(attributeType, schemaName) {
+        const issues = [];
+        const warnings = [];
+        if (attributeType === 'Boolean' && BEST_PRACTICES.attribute.avoidBooleans) {
+            warnings.push(`Boolean attribute "${schemaName}" should be avoided. ` +
+                `Consider using a picklist with explicit values instead for better clarity.`);
+        }
+        return {
+            isValid: true,
+            issues,
+            warnings,
+        };
+    }
+    /**
+     * Validate DateTime behavior
+     */
+    validateDateTimeBehavior(behavior) {
+        const issues = [];
+        const warnings = [];
+        const defaultBehavior = BEST_PRACTICES.attribute.dateTimeDefaultBehavior;
+        if (behavior && behavior !== defaultBehavior) {
+            warnings.push(`DateTime behavior "${behavior}" differs from recommended "${defaultBehavior}". ` +
+                `Consider using "${defaultBehavior}" for consistency.`);
+        }
+        return {
+            isValid: true,
+            issues,
+            warnings,
+        };
+    }
+    /**
+     * Get required columns for entity type
+     */
+    getRequiredColumns(isRefData) {
+        const columns = [...BEST_PRACTICES.requiredColumns.allTables];
+        if (isRefData) {
+            columns.push(...BEST_PRACTICES.requiredColumns.refDataTables);
+        }
+        return columns;
+    }
+    /**
+     * Validate option set value prefix
+     */
+    validateOptionSetValuePrefix(value) {
+        const issues = [];
+        const warnings = [];
+        const expectedPrefix = BEST_PRACTICES.publisher.optionValuePrefix;
+        const valueStr = value.toString();
+        const prefixStr = expectedPrefix.toString();
+        if (!valueStr.startsWith(prefixStr)) {
+            warnings.push(`Option set value ${value} does not start with publisher prefix ${expectedPrefix}. ` +
+                `Values should start with ${prefixStr} for consistency.`);
+        }
+        return {
+            isValid: true,
+            issues,
+            warnings,
+        };
+    }
+    /**
+     * Generate next option set value with proper prefix
+     */
+    getNextOptionSetValue(existingValues) {
+        const prefix = BEST_PRACTICES.publisher.optionValuePrefix;
+        const prefixStr = prefix.toString();
+        const ourValues = existingValues
+            .filter((v) => v.toString().startsWith(prefixStr))
+            .sort((a, b) => b - a);
+        if (ourValues.length === 0) {
+            return prefix * 10000 + 1;
+        }
+        return ourValues[0] + 1;
+    }
+    /**
+     * Comprehensive entity validation
+     */
+    validateEntity(params) {
+        const allIssues = [];
+        const allWarnings = [];
+        let missingColumns;
+        const nameResult = this.validateEntityName(params.schemaName, params.isRefData);
+        allIssues.push(...nameResult.issues);
+        allWarnings.push(...nameResult.warnings);
+        const ownershipResult = this.validateOwnershipType(params.ownershipType);
+        allIssues.push(...ownershipResult.issues);
+        allWarnings.push(...ownershipResult.warnings);
+        if (params.existingColumns) {
+            const columnsResult = this.validateRequiredColumns(params.existingColumns, params.isRefData);
+            allIssues.push(...columnsResult.issues);
+            allWarnings.push(...columnsResult.warnings);
+            missingColumns = columnsResult.missingColumns;
+        }
+        return {
+            isValid: allIssues.length === 0,
+            issues: allIssues,
+            warnings: allWarnings,
+            missingColumns,
+        };
+    }
+    /**
+     * Comprehensive attribute validation
+     */
+    validateAttribute(params) {
+        const allIssues = [];
+        const allWarnings = [];
+        const isLookup = params.attributeType === 'Lookup' || params.attributeType === 'Customer';
+        const nameResult = this.validateAttributeName(params.schemaName, isLookup);
+        allIssues.push(...nameResult.issues);
+        allWarnings.push(...nameResult.warnings);
+        const boolResult = this.validateBooleanUsage(params.attributeType, params.schemaName);
+        allWarnings.push(...boolResult.warnings);
+        if (params.attributeType === 'DateTime' && params.dateTimeBehavior) {
+            const behaviorResult = this.validateDateTimeBehavior(params.dateTimeBehavior);
+            allWarnings.push(...behaviorResult.warnings);
+        }
+        return {
+            isValid: allIssues.length === 0,
+            issues: allIssues,
+            warnings: allWarnings,
+        };
+    }
+}
+// Export singleton instance
+export const bestPracticesValidator = new BestPracticesValidator();
+//# sourceMappingURL=bestPractices.js.map

package/build/utils/bestPractices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bestPractices.js","sourceRoot":"","sources":["../../src/utils/bestPractices.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE;QACT,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qBAAqB;QAC3B,iBAAiB,EAAE,KAAK;KACzB;IAED,MAAM,EAAE;QACN,aAAa,EAAE;YACb,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;YACnC,SAAS,EAAE,CAAC,mBAAmB,CAAC;YAChC,OAAO,EAAE,WAAW;SACrB;QACD,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,MAAM;QACpB,QAAQ,EAAE,WAAW;KACtB;IAED,SAAS,EAAE;QACT,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,WAAW;QACrB,aAAa,EAAE,IAAI;QACnB,uBAAuB,EAAE,qBAAqB;KAC/C;IAED,eAAe,EAAE;QACf,SAAS,EAAE;YACT;gBACE,UAAU,EAAE,sBAAsB;gBAClC,WAAW,EAAE,oBAAoB;gBACjC,WAAW,EAAE,4EAA4E;gBACzF,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,IAAI;aAChB;SACF;QACD,aAAa,EAAE;YACb;gBACE,UAAU,EAAE,eAAe;gBAC3B,WAAW,EAAE,YAAY;gBACzB,WAAW,EAAE,yDAAyD;gBACtE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,qBAAqB;aAChC;YACD;gBACE,UAAU,EAAE,aAAa;gBACzB,WAAW,EAAE,UAAU;gBACvB,WAAW,EAAE,yDAAyD;gBACtE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,qBAAqB;aAChC;YACD;gBACE,UAAU,EAAE,iBAAiB;gBAC7B,WAAW,EAAE,aAAa;gBAC1B,WAAW,EAAE,sDAAsD;gBACnE,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,KAAK;aACjB;YACD;gBACE,UAAU,EAAE,UAAU;gBACtB,WAAW,EAAE,MAAM;gBACnB,WAAW,EAAE,8CAA8C;gBAC3D,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,GAAG;aACf;SACF;KACF;IAED,IAAI,EAAE;QACJ,qBAAqB,EAAE,IAAI;QAC3B,mBAAmB,EAAE;YACnB,MAAM;YACN,WAAW;YACX,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,QAAQ;SACT;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;SAChB;QACD,qBAAqB,EAAE,EAAE;KAC1B;IAED,MAAM,EAAE;QACN,sBAAsB,EAAE,IAAI;QAC5B,oBAAoB,EAAE,IAAI;KAC3B;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;OAEG;IACH,kBAAkB,CAAC,UAAkB,EAAE,SAAkB;QACvD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,UAAU,KAAK,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,mDAAmD,UAAU,GAAG,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CACT,wDAAwD,KAAK,CAAC,MAAM,YAAY,UAAU,GAAG,CAC9F,CAAC;QACJ,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;YAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CACT,mDAAmD,eAAe,gBAAgB;oBAChF,YAAY,eAAe,6BAA6B,UAAU,GAAG,CACxE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,UAAkB,EAAE,QAAiB;QACzD,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC;QACvC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,UAAU,KAAK,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,sDAAsD,UAAU,GAAG,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CACT,0CAA0C,cAAc,CAAC,SAAS,CAAC,MAAM,YAAY,UAAU,GAAG,CACnG,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YACzD,QAAQ,CAAC,IAAI,CACX,qCAAqC,KAAK,CAAC,YAAY,YAAY,UAAU,GAAG,CACjF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,aAAqB;QACzC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC;QAClD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CACT,mBAAmB,aAAa,wBAAwB,KAAK,CAAC,OAAO,YAAY,CAClF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CACT,mBAAmB,aAAa,6BAA6B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,eAAyB,EAAE,SAAkB;QACnE,MAAM,KAAK,GAAG,cAAc,CAAC,eAAe,CAAC;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,cAAc,GAAqB,EAAE,CAAC;QAE5C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjD,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACzC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjD,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC5B,MAAM,CAAC,IAAI,CACT,oCAAoC,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,WAAW,GAAG,CAChF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ,EAAE,EAAE;YACZ,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,aAAqB,EAAE,UAAkB;QAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,aAAa,KAAK,SAAS,IAAI,cAAc,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YAC1E,QAAQ,CAAC,IAAI,CACX,sBAAsB,UAAU,uBAAuB;gBACrD,4EAA4E,CAC/E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,QAA4B;QACnD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,uBAAuB,CAAC;QAEzE,IAAI,QAAQ,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CACX,sBAAsB,QAAQ,+BAA+B,eAAe,KAAK;gBAC/E,mBAAmB,eAAe,oBAAoB,CACzD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,SAAkB;QACnC,MAAM,OAAO,GAAqB,CAAC,GAAG,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,GAAI,cAAc,CAAC,eAAe,CAAC,aAAkC,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,4BAA4B,CAAC,KAAa;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,cAAc,CAAC,SAAS,CAAC,iBAAiB,CAAC;QAElE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;QAE5C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CACX,oBAAoB,KAAK,yCAAyC,cAAc,IAAI;gBAClF,4BAA4B,SAAS,mBAAmB,CAC3D,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,cAAwB;QAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,iBAAiB,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEpC,MAAM,SAAS,GAAG,cAAc;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;aACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAMd;QACC,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,cAA4C,CAAC;QAEjD,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAChF,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEzC,MAAM,eAAe,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACzE,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7F,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC5C,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;QAChD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;YAC/B,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,WAAW;YACrB,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,MAIjB;QACC,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,KAAK,UAAU,CAAC;QAC1F,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3E,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACtF,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,MAAM,CAAC,aAAa,KAAK,UAAU,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACnE,MAAM,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC9E,WAAW,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;YAC/B,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,WAAW;SACtB,CAAC;IACJ,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,sBAAsB,EAAE,CAAC"}

package/build/utils/iconManager.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Icon Management Module
+ *
+ * Integrates with Fluent UI System Icons for entity icon management.
+ * Fetches SVG icons from GitHub and uploads them as web resources.
+ */
+export interface IconSuggestion {
+    name: string;
+    fileName: string;
+    url: string;
+    category: string;
+}
+export interface IconUploadResult {
+    webResourceId: string;
+    webResourceName: string;
+    iconVectorName: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Icon Manager Class
+ */
+export declare class IconManager {
+    private baseUrl;
+    private cache;
+    constructor();
+    /**
+     * Suggest icons based on entity name or type
+     */
+    suggestIcons(entityName: string): IconSuggestion[];
+    /**
+     * Populate full URLs for icon suggestions
+     */
+    private populateUrls;
+    /**
+     * Parse icon filename and construct GitHub path
+     * Converts: people_community_24_filled.svg
+     * To: assets/People Community/SVG/ic_fluent_people_community_24_filled.svg
+     */
+    private constructFluentIconPath;
+    /**
+     * Fetch SVG icon from Fluent UI GitHub repository
+     */
+    fetchIcon(fileName: string): Promise<string>;
+    /**
+     * Generate web resource name for icon
+     */
+    generateWebResourceName(entitySchemaName: string, iconName: string): string;
+    /**
+     * Generate icon vector name for EntityMetadata
+     * Uses $webresource: directive which is the correct syntax for Dynamics 365
+     * This creates a solution dependency and tells the system to look up the web resource by name
+     */
+    generateIconVectorName(webResourceName: string): string;
+    /**
+     * Validate icon SVG content
+     */
+    validateIconSvg(svg: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Get all available icon categories
+     */
+    getCategories(): string[];
+    /**
+     * Search icons by name
+     */
+    searchIcons(searchTerm: string): IconSuggestion[];
+    /**
+     * Get icons by category
+     */
+    getIconsByCategory(category: string): IconSuggestion[];
+    /**
+     * Build custom icon URL for specific size/style
+     */
+    buildIconUrl(iconName: string, size?: number, style?: 'filled' | 'regular'): string;
+    /**
+     * Clear icon cache
+     */
+    clearCache(): void;
+}
+export declare const iconManager: IconManager;
+//# sourceMappingURL=iconManager.d.ts.map

package/build/utils/iconManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconManager.d.ts","sourceRoot":"","sources":["../../src/utils/iconManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuID;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAkC;;IAM/C;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAsBlD;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsClD;;OAEG;IACH,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ3E;;;;OAIG;IACH,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;IAIvD;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAiBhE;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAQzB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAkBjD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IActD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,EAAE,KAAK,GAAE,QAAQ,GAAG,SAAoB,GAAG,MAAM;IAYjG;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}