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

package/build/services/PluginDeploymentService.js

@@ -0,0 +1,412 @@
+/**
+ * PluginDeploymentService
+ *
+ * Service for plugin deployment operations.
+ * Note: This service should only be used by powerplatform-customization package.
+ */
+import { auditLogger } from '../utils/auditLogger.js';
+export class PluginDeploymentService {
+    client;
+    addComponentToSolution;
+    constructor(client, addComponentToSolution) {
+        this.client = client;
+        this.addComponentToSolution = addComponentToSolution;
+    }
+    /**
+     * Extract assembly version from .NET DLL
+     */
+    async extractAssemblyVersion(assemblyPath) {
+        try {
+            const fs = await import('fs/promises');
+            const normalizedPath = assemblyPath.replace(/\\/g, '/');
+            const buffer = await fs.readFile(normalizedPath);
+            // Validate DLL format
+            const header = buffer.toString('utf8', 0, 2);
+            if (header !== 'MZ') {
+                return '1.0.0.0';
+            }
+            // Search for version pattern
+            const bufferStr = buffer.toString('utf16le');
+            const versionMatch = bufferStr.match(/\d+\.\d+\.\d+\.\d+/);
+            return versionMatch ? versionMatch[0] : '1.0.0.0';
+        }
+        catch {
+            return '1.0.0.0';
+        }
+    }
+    /**
+     * Query plugin type by typename
+     */
+    async queryPluginTypeByTypename(typename) {
+        const response = await this.client.makeRequest(`api/data/v9.2/plugintypes?$filter=typename eq '${typename}'&$select=plugintypeid`);
+        if (!response.value || response.value.length === 0) {
+            throw new Error(`Plugin type '${typename}' not found. Did you upload the assembly first?`);
+        }
+        return response.value[0].plugintypeid;
+    }
+    /**
+     * Query plugin assembly by name
+     */
+    async queryPluginAssemblyByName(assemblyName) {
+        const response = await this.client.makeRequest(`api/data/v9.2/pluginassemblies?$filter=name eq '${assemblyName}'&$select=pluginassemblyid`);
+        if (!response.value || response.value.length === 0) {
+            return null;
+        }
+        return response.value[0].pluginassemblyid;
+    }
+    /**
+     * Get plugin types for an assembly
+     */
+    async getPluginTypesForAssembly(assemblyId) {
+        const types = await this.client.makeRequest(`api/data/v9.2/plugintypes?$filter=_pluginassemblyid_value eq ${assemblyId}&$select=plugintypeid,typename,friendlyname`);
+        return types.value.map((t) => ({
+            pluginTypeId: t.plugintypeid,
+            typeName: t.typename,
+            friendlyName: t.friendlyname,
+        }));
+    }
+    /**
+     * Resolve SDK Message and Filter IDs
+     */
+    async resolveSdkMessageAndFilter(messageName, entityName) {
+        const timer = auditLogger.startTimer();
+        try {
+            // Get SDK Message ID
+            const messages = await this.client.makeRequest(`api/data/v9.2/sdkmessages?$filter=name eq '${messageName}'&$select=sdkmessageid,name`);
+            if (!messages.value || messages.value.length === 0) {
+                throw new Error(`SDK message '${messageName}' not found. Common: Create, Update, Delete, SetState`);
+            }
+            const messageId = messages.value[0].sdkmessageid;
+            // Get SDK Message Filter ID
+            const filters = await this.client.makeRequest(`api/data/v9.2/sdkmessagefilters?$filter=sdkmessageid/sdkmessageid eq ${messageId} and primaryobjecttypecode eq '${entityName}'&$select=sdkmessagefilterid`);
+            if (!filters.value || filters.value.length === 0) {
+                throw new Error(`SDK message filter not found for '${messageName}' on '${entityName}'`);
+            }
+            const filterId = filters.value[0].sdkmessagefilterid;
+            auditLogger.log({
+                operation: 'resolve-sdk-message-filter',
+                operationType: 'READ',
+                componentType: 'SdkMessage',
+                success: true,
+                parameters: { messageName, entityName, messageId, filterId },
+                executionTimeMs: timer(),
+            });
+            return { messageId, filterId };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'resolve-sdk-message-filter',
+                operationType: 'READ',
+                componentType: 'SdkMessage',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Create a new plugin assembly
+     */
+    async createPluginAssembly(options) {
+        const timer = auditLogger.startTimer();
+        try {
+            // Validate DLL size (16MB limit)
+            const dllSize = Buffer.from(options.content, 'base64').length;
+            const maxSize = 16 * 1024 * 1024;
+            if (dllSize > maxSize) {
+                throw new Error(`Assembly exceeds 16MB limit (current: ${(dllSize / 1024 / 1024).toFixed(2)}MB)`);
+            }
+            const assemblyData = {
+                name: options.name,
+                content: options.content,
+                version: options.version,
+                isolationmode: options.isolationMode ?? 2,
+                sourcetype: options.sourceType ?? 0,
+                culture: 'neutral',
+            };
+            if (options.description) {
+                assemblyData.description = options.description;
+            }
+            const createResponse = await this.client.makeRequest('api/data/v9.2/pluginassemblies', 'POST', assemblyData, {
+                Prefer: 'return=representation',
+            });
+            const pluginAssemblyId = createResponse.pluginassemblyid ||
+                createResponse.id;
+            if (!pluginAssemblyId) {
+                throw new Error('Plugin assembly created but ID not returned');
+            }
+            // Add to solution if specified
+            if (options.solutionUniqueName) {
+                await this.addComponentToSolution(options.solutionUniqueName, pluginAssemblyId, 91 // PluginAssembly
+                );
+            }
+            // Poll for plugin types (async creation)
+            const pluginTypes = [];
+            const maxAttempts = 30;
+            const pollInterval = 2000;
+            for (let attempt = 0; attempt < maxAttempts; attempt++) {
+                if (attempt > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, pollInterval));
+                }
+                const types = await this.getPluginTypesForAssembly(pluginAssemblyId);
+                if (types.length > 0) {
+                    pluginTypes.push(...types);
+                    break;
+                }
+            }
+            if (pluginTypes.length === 0) {
+                throw new Error(`Plugin types not created after ${(maxAttempts * pollInterval) / 1000} seconds`);
+            }
+            auditLogger.log({
+                operation: 'create-plugin-assembly',
+                operationType: 'CREATE',
+                componentId: pluginAssemblyId,
+                componentType: 'PluginAssembly',
+                success: true,
+                parameters: {
+                    name: options.name,
+                    version: options.version,
+                    size: dllSize,
+                    pluginTypeCount: pluginTypes.length,
+                },
+                executionTimeMs: timer(),
+            });
+            return { pluginAssemblyId, pluginTypes };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'create-plugin-assembly',
+                operationType: 'CREATE',
+                componentName: options.name,
+                componentType: 'PluginAssembly',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Update an existing plugin assembly
+     */
+    async updatePluginAssembly(assemblyId, content, version, solutionUniqueName) {
+        const timer = auditLogger.startTimer();
+        try {
+            const dllSize = Buffer.from(content, 'base64').length;
+            const maxSize = 16 * 1024 * 1024;
+            if (dllSize > maxSize) {
+                throw new Error(`Assembly exceeds 16MB limit (current: ${(dllSize / 1024 / 1024).toFixed(2)}MB)`);
+            }
+            await this.client.makeRequest(`api/data/v9.2/pluginassemblies(${assemblyId})`, 'PATCH', { content, version });
+            if (solutionUniqueName) {
+                await this.addComponentToSolution(solutionUniqueName, assemblyId, 91);
+            }
+            auditLogger.log({
+                operation: 'update-plugin-assembly',
+                operationType: 'UPDATE',
+                componentId: assemblyId,
+                componentType: 'PluginAssembly',
+                success: true,
+                parameters: { assemblyId, version, size: dllSize },
+                executionTimeMs: timer(),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'update-plugin-assembly',
+                operationType: 'UPDATE',
+                componentId: assemblyId,
+                componentType: 'PluginAssembly',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Delete a plugin assembly
+     */
+    async deletePluginAssembly(assemblyId) {
+        const timer = auditLogger.startTimer();
+        try {
+            await this.client.makeRequest(`api/data/v9.2/pluginassemblies(${assemblyId})`, 'DELETE');
+            auditLogger.log({
+                operation: 'delete-plugin-assembly',
+                operationType: 'DELETE',
+                componentId: assemblyId,
+                componentType: 'PluginAssembly',
+                success: true,
+                executionTimeMs: timer(),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'delete-plugin-assembly',
+                operationType: 'DELETE',
+                componentId: assemblyId,
+                componentType: 'PluginAssembly',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw new Error(`Failed to delete plugin assembly: ${errorMessage}`);
+        }
+    }
+    /**
+     * Delete a plugin step
+     */
+    async deletePluginStep(stepId) {
+        const timer = auditLogger.startTimer();
+        try {
+            await this.client.makeRequest(`api/data/v9.2/sdkmessageprocessingsteps(${stepId})`, 'DELETE');
+            auditLogger.log({
+                operation: 'delete-plugin-step',
+                operationType: 'DELETE',
+                componentId: stepId,
+                componentType: 'PluginStep',
+                success: true,
+                executionTimeMs: timer(),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'delete-plugin-step',
+                operationType: 'DELETE',
+                componentId: stepId,
+                componentType: 'PluginStep',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            // Log but don't throw - rollback should continue
+        }
+    }
+    /**
+     * Register a plugin step
+     */
+    async registerPluginStep(options) {
+        const timer = auditLogger.startTimer();
+        try {
+            const { messageId, filterId } = await this.resolveSdkMessageAndFilter(options.messageName, options.primaryEntityName);
+            const stepData = {
+                name: options.name,
+                'plugintypeid@odata.bind': `/plugintypes(${options.pluginTypeId})`,
+                'sdkmessageid@odata.bind': `/sdkmessages(${messageId})`,
+                'sdkmessagefilterid@odata.bind': `/sdkmessagefilters(${filterId})`,
+                stage: options.stage,
+                mode: options.executionMode,
+                rank: options.rank ?? 1,
+                supporteddeployment: options.supportedDeployment ?? 0,
+                statuscode: 1,
+            };
+            if (options.filteringAttributes) {
+                stepData.filteringattributes = options.filteringAttributes;
+            }
+            if (options.configuration) {
+                stepData.configuration = options.configuration;
+            }
+            const createResponse = await this.client.makeRequest('api/data/v9.2/sdkmessageprocessingsteps', 'POST', stepData, {
+                Prefer: 'return=representation',
+            });
+            const stepId = createResponse.sdkmessageprocessingstepid ||
+                createResponse.id;
+            if (!stepId) {
+                throw new Error('Plugin step created but ID not returned');
+            }
+            if (options.solutionUniqueName) {
+                await this.addComponentToSolution(options.solutionUniqueName, stepId, 92 // SDKMessageProcessingStep
+                );
+            }
+            auditLogger.log({
+                operation: 'register-plugin-step',
+                operationType: 'CREATE',
+                componentId: stepId,
+                componentType: 'PluginStep',
+                success: true,
+                parameters: {
+                    name: options.name,
+                    messageName: options.messageName,
+                    primaryEntity: options.primaryEntityName,
+                    stage: options.stage,
+                    mode: options.executionMode,
+                },
+                executionTimeMs: timer(),
+            });
+            return { stepId };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'register-plugin-step',
+                operationType: 'CREATE',
+                componentName: options.name,
+                componentType: 'PluginStep',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Register a plugin image
+     */
+    async registerPluginImage(options) {
+        const timer = auditLogger.startTimer();
+        try {
+            const imageData = {
+                name: options.name,
+                'sdkmessageprocessingstepid@odata.bind': `/sdkmessageprocessingsteps(${options.stepId})`,
+                imagetype: options.imageType,
+                entityalias: options.entityAlias,
+                messagepropertyname: options.messagePropertyName || 'Target',
+            };
+            if (options.attributes !== undefined) {
+                imageData.attributes = options.attributes;
+            }
+            const createResponse = await this.client.makeRequest('api/data/v9.2/sdkmessageprocessingstepimages', 'POST', imageData, {
+                Prefer: 'return=representation',
+            });
+            const imageId = createResponse.sdkmessageprocessingstepimageid ||
+                createResponse.id;
+            if (!imageId) {
+                throw new Error('Plugin image created but ID not returned');
+            }
+            auditLogger.log({
+                operation: 'register-plugin-image',
+                operationType: 'CREATE',
+                componentId: imageId,
+                componentType: 'PluginImage',
+                success: true,
+                parameters: {
+                    name: options.name,
+                    imageType: options.imageType,
+                    stepId: options.stepId,
+                },
+                executionTimeMs: timer(),
+            });
+            return { imageId };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            auditLogger.log({
+                operation: 'register-plugin-image',
+                operationType: 'CREATE',
+                componentName: options.name,
+                componentType: 'PluginImage',
+                success: false,
+                error: errorMessage,
+                executionTimeMs: timer(),
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=PluginDeploymentService.js.map

package/build/services/PluginDeploymentService.js.map

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

package/build/services/PluginService.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PluginService
+ *
+ * Read-only service for plugin assemblies, types, steps, images, and trace logs.
+ */
+import type { PowerPlatformClient } from '../client/PowerPlatformClient.js';
+export declare class PluginService {
+    private client;
+    constructor(client: PowerPlatformClient);
+    /**
+     * Get all plugin assemblies in the environment
+     */
+    getPluginAssemblies(includeManaged?: boolean, maxRecords?: number): Promise<{
+        totalCount: number;
+        assemblies: unknown[];
+    }>;
+    /**
+     * Get a plugin assembly by name with all related plugin types, steps, and images
+     */
+    getPluginAssemblyComplete(assemblyName: string, includeDisabled?: boolean): Promise<{
+        assembly: unknown;
+        pluginTypes: unknown[];
+        steps: unknown[];
+        validation: {
+            hasDisabledSteps: boolean;
+            hasAsyncSteps: boolean;
+            hasSyncSteps: boolean;
+            stepsWithoutFilteringAttributes: string[];
+            stepsWithoutImages: string[];
+            potentialIssues: string[];
+        };
+    }>;
+    /**
+     * Get all plugins that execute on a specific entity
+     */
+    getEntityPluginPipeline(entityName: string, messageFilter?: string, includeDisabled?: boolean): Promise<{
+        entity: string;
+        messages: unknown[];
+        steps: unknown[];
+        executionOrder: string[];
+    }>;
+    /**
+     * Get plugin trace logs with filtering
+     */
+    getPluginTraceLogs(options: {
+        entityName?: string;
+        messageName?: string;
+        correlationId?: string;
+        pluginStepId?: string;
+        exceptionOnly?: boolean;
+        hoursBack?: number;
+        maxRecords?: number;
+    }): Promise<{
+        totalCount: number;
+        logs: unknown[];
+    }>;
+    private getOperationTypeName;
+    private extractExceptionType;
+    private extractExceptionMessage;
+}
+//# sourceMappingURL=PluginService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginService.d.ts","sourceRoot":"","sources":["../../src/services/PluginService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAE/C;;OAEG;IACG,mBAAmB,CACvB,cAAc,GAAE,OAAe,EAC/B,UAAU,GAAE,MAAY,GACvB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAuCzD;;OAEG;IACG,yBAAyB,CAC7B,YAAY,EAAE,MAAM,EACpB,eAAe,GAAE,OAAe,GAC/B,OAAO,CAAC;QACT,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,EAAE,CAAC;QACvB,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,UAAU,EAAE;YACV,gBAAgB,EAAE,OAAO,CAAC;YAC1B,aAAa,EAAE,OAAO,CAAC;YACvB,YAAY,EAAE,OAAO,CAAC;YACtB,+BAA+B,EAAE,MAAM,EAAE,CAAC;YAC1C,kBAAkB,EAAE,MAAM,EAAE,CAAC;YAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;SAC3B,CAAC;KACH,CAAC;IA0GF;;OAEG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,GAAE,OAAe,GAC/B,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IAqIF;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAsDpD,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,uBAAuB;CAWhC"}