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

package/build/services/EntityService.js

@@ -0,0 +1,132 @@
+/**
+ * EntityService
+ *
+ * Service for entity (table) customization operations.
+ * Note: This service should only be used by powerplatform-customization package.
+ */
+import { bestPracticesValidator } from '../utils/bestPractices.js';
+import { iconManager } from '../utils/iconManager.js';
+import { rateLimiter } from '../utils/rate-limiter.js';
+export class EntityService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new custom entity (table)
+     */
+    async createEntity(entityDefinition, solutionUniqueName) {
+        // Validate entity name against best practices
+        const schemaName = entityDefinition.SchemaName ||
+            entityDefinition.LogicalName;
+        const isRefData = schemaName?.toLowerCase().includes('ref_') || false;
+        const nameValidation = bestPracticesValidator.validateEntityName(schemaName, isRefData);
+        if (!nameValidation.isValid) {
+            throw new Error(`Entity name validation failed: ${nameValidation.issues.join(', ')}`);
+        }
+        // Validate ownership type
+        const ownershipType = entityDefinition.OwnershipType;
+        if (ownershipType) {
+            bestPracticesValidator.validateOwnershipType(ownershipType);
+        }
+        const headers = {};
+        if (solutionUniqueName) {
+            headers['MSCRM.SolutionUniqueName'] = solutionUniqueName;
+        }
+        // Execute with rate limiting
+        return rateLimiter.execute(async () => {
+            return this.client.makeRequest('api/data/v9.2/EntityDefinitions', 'POST', entityDefinition, headers);
+        });
+    }
+    /**
+     * Update an existing entity
+     */
+    async updateEntity(metadataId, updates, solutionUniqueName) {
+        const headers = {
+            'MSCRM.MergeLabels': 'true',
+        };
+        if (solutionUniqueName) {
+            headers['MSCRM.SolutionUniqueName'] = solutionUniqueName;
+        }
+        await this.client.makeRequest(`api/data/v9.2/EntityDefinitions(${metadataId})`, 'PUT', updates, headers);
+    }
+    /**
+     * Delete a custom entity
+     */
+    async deleteEntity(metadataId) {
+        await this.client.makeRequest(`api/data/v9.2/EntityDefinitions(${metadataId})`, 'DELETE');
+    }
+    /**
+     * Update entity icon using Fluent UI System Icon
+     */
+    async updateEntityIcon(entityLogicalName, iconFileName, dependencies, solutionUniqueName) {
+        // Step 1: Get entity metadata
+        const entityMetadata = await dependencies.getEntityMetadata(entityLogicalName);
+        const entitySchemaName = entityMetadata.SchemaName;
+        const metadataId = entityMetadata.MetadataId;
+        if (!metadataId) {
+            throw new Error(`Could not find MetadataId for entity '${entityLogicalName}'`);
+        }
+        // Step 2: Fetch the icon SVG from Fluent UI GitHub
+        const svgContent = await iconManager.fetchIcon(iconFileName);
+        // Step 3: Validate the SVG
+        const validation = iconManager.validateIconSvg(svgContent);
+        if (!validation.valid) {
+            throw new Error(`Invalid SVG: ${validation.error}`);
+        }
+        // Step 4: Convert SVG to base64
+        const base64Content = Buffer.from(svgContent).toString('base64');
+        // Step 5: Generate web resource name
+        const webResourceName = iconManager.generateWebResourceName(entitySchemaName, iconFileName.replace('.svg', ''));
+        // Step 6: Check if web resource already exists
+        const existingResourcesResponse = await this.client.makeRequest(`api/data/v9.2/webresourceset?$filter=name eq '${webResourceName}'&$select=webresourceid,name`);
+        let webResourceId;
+        const displayName = entityMetadata.DisplayName
+            ?.UserLocalizedLabel?.Label || entityLogicalName;
+        if (existingResourcesResponse.value &&
+            existingResourcesResponse.value.length > 0) {
+            // Web resource exists, update it
+            const existing = existingResourcesResponse.value[0];
+            webResourceId = existing.webresourceid;
+            await dependencies.updateWebResource(webResourceId, {
+                displayname: `Icon for ${displayName}`,
+                content: base64Content,
+                description: `Fluent UI icon (${iconFileName}) for ${entityLogicalName} entity`,
+            }, solutionUniqueName);
+        }
+        else {
+            // Web resource doesn't exist, create new
+            const webResourceResult = await dependencies.createWebResource({
+                name: webResourceName,
+                displayname: `Icon for ${displayName}`,
+                webresourcetype: 11, // SVG
+                content: base64Content,
+                description: `Fluent UI icon (${iconFileName}) for ${entityLogicalName} entity`,
+            }, solutionUniqueName);
+            webResourceId = webResourceResult.webresourceid;
+        }
+        // Step 7: Generate icon vector name
+        const iconVectorName = iconManager.generateIconVectorName(webResourceName);
+        // Step 8: Update entity metadata with icon reference
+        const entityUpdates = {
+            '@odata.type': 'Microsoft.Dynamics.CRM.EntityMetadata',
+            IconVectorName: iconVectorName,
+        };
+        await this.updateEntity(metadataId, entityUpdates, solutionUniqueName);
+        // Step 9: Publish the web resource (component type 61)
+        await dependencies.publishComponent(webResourceId, 61);
+        // Step 10: Publish the entity (component type 1)
+        await dependencies.publishComponent(metadataId, 1);
+        return {
+            success: true,
+            entityLogicalName,
+            entitySchemaName,
+            iconFileName,
+            webResourceId,
+            webResourceName,
+            iconVectorName,
+            message: 'Entity icon updated and published successfully. The icon should now be visible in the UI.',
+        };
+    }
+}
+//# sourceMappingURL=EntityService.js.map

package/build/services/EntityService.js.map

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

package/build/services/FlowService.d.ts

@@ -0,0 +1,55 @@
+/**
+ * FlowService
+ *
+ * Read-only service for Power Automate cloud flows.
+ */
+import type { PowerPlatformClient } from '../client/PowerPlatformClient.js';
+import type { FlowFilterOptions, FlowListResult } from '../client/types.js';
+export declare class FlowService {
+    private client;
+    private environmentId;
+    constructor(client: PowerPlatformClient);
+    /**
+     * Get Power Automate cloud flows with smart filtering
+     */
+    getFlows(options?: FlowFilterOptions): Promise<FlowListResult>;
+    /**
+     * Search workflows (both classic workflows and Power Automate flows)
+     */
+    searchWorkflows(options?: {
+        name?: string;
+        primaryEntity?: string;
+        description?: string;
+        category?: number;
+        statecode?: number;
+        includeDescription?: boolean;
+        maxResults?: number;
+    }): Promise<{
+        totalCount: number;
+        hasMore: boolean;
+        requestedMax: number;
+        workflows: unknown[];
+    }>;
+    /**
+     * Get a specific Power Automate flow with its complete definition
+     */
+    getFlowDefinition(flowId: string, summary?: boolean): Promise<unknown>;
+    /**
+     * Parse a flow definition to extract a summary
+     */
+    parseFlowSummary(flowDef: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Get flow run history for a specific Power Automate flow
+     */
+    getFlowRuns(flowId: string, maxRecords?: number): Promise<{
+        flowId: string;
+        totalCount: number;
+        runs: unknown[];
+    }>;
+    /**
+     * Get detailed flow run information
+     */
+    getFlowRunDetails(flowId: string, runId: string): Promise<unknown>;
+    private getEnvironmentId;
+}
+//# sourceMappingURL=FlowService.d.ts.map

package/build/services/FlowService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowService.d.ts","sourceRoot":"","sources":["../../src/services/FlowService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EAEf,MAAM,oBAAoB,CAAC;AA4C5B,qBAAa,WAAW;IAGV,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,aAAa,CAAuB;gBAExB,MAAM,EAAE,mBAAmB;IAE/C;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgHxE;;OAEG;IACG,eAAe,CACnB,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB,GACL,OAAO,CAAC;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,OAAO,EAAE,CAAC;KACtB,CAAC;IAmGF;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,OAAO,CAAC;IAgEnB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuQ3E;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAY,GACvB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAqCnE;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAsG1D,gBAAgB;CAgB/B"}