@pax8-cta/core 0.1.0

package/dist/services/deployment-service.js

@@ -0,0 +1,375 @@
+/**
+ * Copyright 2024 Pax8, 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 { TokenManager } from "../auth/token-manager.js";
+import { DataverseClient } from "../dataverse/client.js";
+import { SolutionOperations } from "../dataverse/solution-ops.js";
+import { ConnectionOperations } from "../dataverse/connection-refs.js";
+import { PowerPlatformAdminClient } from "../powerplatform/admin-client.js";
+import { DEFAULT_DEPLOYMENT_CONCURRENCY } from "../constants.js";
+import { GdapError, ErrorCode } from "../errors.js";
+/**
+ * Service for deploying solutions to customer tenants via GDAP
+ */
+export class DeploymentService {
+    config;
+    tokenManagers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get or create a cached TokenManager for a tenant.
+     * Avoids creating redundant TokenManager instances for the same tenant.
+     */
+    getTokenManager(tenantId) {
+        let manager = this.tokenManagers.get(tenantId);
+        if (!manager) {
+            manager = new TokenManager({
+                tenantId,
+                clientId: this.config.clientId,
+                clientSecret: this.config.clientSecret,
+            });
+            this.tokenManagers.set(tenantId, manager);
+        }
+        return manager;
+    }
+    /**
+     * Deploy a solution to a single tenant
+     */
+    async deployToTenant(solutionBase64, target, onProgress) {
+        const startedAt = new Date().toISOString();
+        const startTime = Date.now();
+        const emitProgress = (step, progress, status = "in_progress") => {
+            onProgress?.({
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                status,
+                step,
+                progress,
+                startedAt,
+            });
+        };
+        try {
+            // Step 1: Authenticate to customer tenant
+            emitProgress("authenticating", 5);
+            const customerTokenManager = this.getTokenManager(target.tenantId);
+            // Verify we can get a token
+            await customerTokenManager.getDataverseToken(target.environmentUrl);
+            emitProgress("authenticating", 15);
+            // Step 2: Validate environment
+            emitProgress("validating", 20);
+            const dataverseClient = new DataverseClient({
+                environmentUrl: target.environmentUrl,
+                tokenManager: customerTokenManager,
+                clientId: this.config.clientId,
+            });
+            // Quick health check - try to query solutions
+            try {
+                await dataverseClient.querySolutions();
+            }
+            catch (error) {
+                // Check if this is an app user setup issue
+                const isAppUserError = this.isAppUserNotRegisteredError(error);
+                if (isAppUserError) {
+                    // Check if auto-setup is enabled (default: true)
+                    const autoSetup = target.autoSetup !== false;
+                    if (!autoSetup) {
+                        // Auto-setup is disabled, provide helpful error message
+                        throw new GdapError(ErrorCode.GDAP_APP_USER_NOT_REGISTERED, `Application user not registered in environment.\n\n` +
+                            `Auto-setup is disabled (autoSetup: false in config).\n\n` +
+                            `To fix manually:\n` +
+                            `1. Go to https://admin.powerplatform.microsoft.com\n` +
+                            `2. Select the environment → Settings → Users + permissions → Application users\n` +
+                            `3. Click "+ New app user" and add your application (Client ID: ${this.config.clientId})\n` +
+                            `4. Assign the "System Administrator" security role\n` +
+                            `5. Save and retry the deployment\n\n` +
+                            `Or enable auto-setup by removing 'autoSetup: false' from your tenant configuration.`, {
+                            clientId: this.config.clientId,
+                            tenantId: target.tenantId,
+                            tenantName: target.tenantName,
+                            environmentUrl: target.environmentUrl,
+                        }, { cause: error });
+                    }
+                    // Auto-setup the application user
+                    console.log(`Application user not registered. Auto-setting up for ${target.tenantName}...`);
+                    await this.setupApplicationUser(target, customerTokenManager);
+                    // Retry the query
+                    await dataverseClient.querySolutions();
+                }
+                else {
+                    // Re-throw other errors
+                    throw error;
+                }
+            }
+            emitProgress("validating", 30);
+            // Step 3: Import solution
+            emitProgress("uploading", 35);
+            const solutionOps = new SolutionOperations(dataverseClient);
+            // Import solution from base64
+            emitProgress("importing", 40);
+            const importResult = await this.importSolutionFromBase64(solutionOps, solutionBase64, (importProgress) => {
+                // Map import progress (0-100) to our step range (40-70)
+                const mappedProgress = 40 + Math.floor(importProgress * 0.3);
+                emitProgress("importing", mappedProgress);
+            });
+            if (!importResult.success) {
+                throw new Error(importResult.error || "Solution import failed");
+            }
+            emitProgress("importing", 70);
+            // Step 4: Configure connections (if provided)
+            if (target.connectionMappings && target.connectionMappings.length > 0) {
+                emitProgress("configuring_connections", 75);
+                const connectionOps = new ConnectionOperations(dataverseClient);
+                const connResult = await connectionOps.applyConnectionMappings(target.connectionMappings);
+                if (!connResult.success) {
+                    console.warn("Connection mapping warnings:", connResult.errors);
+                    // Don't fail the deployment for connection mapping issues
+                }
+            }
+            emitProgress("configuring_connections", 80);
+            // Step 5: Configure environment variables (if provided)
+            if (target.environmentVariables && target.environmentVariables.length > 0) {
+                emitProgress("configuring_variables", 85);
+                const connectionOps = new ConnectionOperations(dataverseClient);
+                const varResult = await connectionOps.applyEnvironmentVariables(target.environmentVariables);
+                if (!varResult.success) {
+                    console.warn("Environment variable warnings:", varResult.errors);
+                    // Don't fail the deployment for env var issues
+                }
+            }
+            emitProgress("configuring_variables", 90);
+            // Step 6: Verify deployment
+            emitProgress("verifying", 95);
+            // Could add additional verification here (e.g., check solution is active)
+            // Step 7: Complete
+            emitProgress("completing", 100, "completed");
+            const completedAt = new Date().toISOString();
+            return {
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                success: true,
+                importJobId: importResult.importJobId,
+                startedAt,
+                completedAt,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            const completedAt = new Date().toISOString();
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            onProgress?.({
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                status: "failed",
+                step: "importing", // Best guess at where it failed
+                progress: 0,
+                startedAt,
+                completedAt,
+                error: errorMessage,
+            });
+            return {
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                success: false,
+                error: errorMessage,
+                startedAt,
+                completedAt,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Deploy to multiple tenants with concurrency control
+     */
+    async deployToTenants(solutionBase64, targets, options) {
+        const { maxConcurrent = DEFAULT_DEPLOYMENT_CONCURRENCY, onProgress } = options || {};
+        const results = [];
+        const pending = [...targets];
+        const active = [];
+        while (pending.length > 0 || active.length > 0) {
+            // Start new deployments up to max concurrency
+            while (pending.length > 0 && active.length < maxConcurrent) {
+                const target = pending.shift();
+                const promise = this.deployToTenant(solutionBase64, target, onProgress)
+                    .then((result) => {
+                    results.push(result);
+                })
+                    .finally(() => {
+                    const index = active.indexOf(promise);
+                    if (index > -1)
+                        active.splice(index, 1);
+                });
+                active.push(promise);
+            }
+            // Wait for at least one to complete
+            if (active.length > 0) {
+                await Promise.race(active);
+            }
+        }
+        return results;
+    }
+    /**
+     * Import a solution from base64 encoded content
+     */
+    async importSolutionFromBase64(solutionOps, base64Content, onProgress) {
+        // Write to temp file (required by current SolutionOperations API)
+        const fs = await import("node:fs/promises");
+        const path = await import("node:path");
+        const os = await import("node:os");
+        const tempDir = os.tmpdir();
+        const tempFile = path.join(tempDir, `solution-${Date.now()}.zip`);
+        try {
+            // Decode and write solution
+            const buffer = Buffer.from(base64Content, "base64");
+            await fs.writeFile(tempFile, buffer);
+            // Import with progress polling
+            const importJobId = await solutionOps.importSolutionAsync(tempFile);
+            // Poll for completion
+            const result = await solutionOps.waitForImport(importJobId, {
+                pollIntervalMs: 3000,
+                timeoutMs: 600000, // 10 minutes
+                onProgress,
+            });
+            return result;
+        }
+        finally {
+            // Clean up temp file
+            try {
+                await fs.unlink(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+    /**
+     * Validate that a tenant is ready for deployment
+     */
+    async validateTenant(target) {
+        const errors = [];
+        const warnings = [];
+        try {
+            // Check authentication
+            const customerTokenManager = this.getTokenManager(target.tenantId);
+            try {
+                await customerTokenManager.getDataverseToken(target.environmentUrl);
+            }
+            catch (error) {
+                errors.push(`Authentication failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+                return { valid: false, errors, warnings };
+            }
+            // Check environment is accessible
+            const dataverseClient = new DataverseClient({
+                environmentUrl: target.environmentUrl,
+                tokenManager: customerTokenManager,
+                clientId: this.config.clientId,
+            });
+            try {
+                await dataverseClient.querySolutions();
+            }
+            catch (error) {
+                errors.push(`Environment not accessible: ${error instanceof Error ? error.message : "Unknown error"}`);
+                return { valid: false, errors, warnings };
+            }
+            // Check connection references if mappings provided
+            if (target.connectionMappings && target.connectionMappings.length > 0) {
+                const connectionOps = new ConnectionOperations(dataverseClient);
+                for (const mapping of target.connectionMappings) {
+                    const connRef = await connectionOps.getConnectionReferenceByLogicalName(mapping.sourceLogicalName);
+                    if (!connRef) {
+                        warnings.push(`Connection reference not found: ${mapping.sourceLogicalName}`);
+                    }
+                }
+            }
+            return {
+                valid: errors.length === 0,
+                errors,
+                warnings,
+            };
+        }
+        catch (error) {
+            errors.push(`Validation error: ${error instanceof Error ? error.message : "Unknown error"}`);
+            return { valid: false, errors, warnings };
+        }
+    }
+    /**
+     * Check if an error indicates the app user is not registered.
+     * Prefers checking the structured error code; falls back to regex on the message.
+     */
+    isAppUserNotRegisteredError(error) {
+        // Check typed error code first
+        if (error instanceof GdapError && error.code === ErrorCode.GDAP_APP_USER_NOT_REGISTERED) {
+            return true;
+        }
+        // Fallback to message matching for untyped errors from external sources
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return (/user is not a member of the organization/i.test(errorMessage) ||
+            /not a member of.*environment/i.test(errorMessage) ||
+            /application is not registered as a user/i.test(errorMessage));
+    }
+    /**
+     * Setup application user in an environment
+     */
+    async setupApplicationUser(target, tokenManager) {
+        // We need the environment ID for the Power Platform Admin API
+        if (!target.environmentId) {
+            // Try to extract from URL (e.g., https://org.crm.dynamics.com -> org)
+            // This is a fallback - ideally environmentId should be provided in config
+            const match = target.environmentUrl.match(/https:\/\/([^.]+)\./);
+            if (!match) {
+                throw new GdapError(ErrorCode.GDAP_ENVIRONMENT_ID_MISSING, "Cannot auto-setup application user: environmentId not provided in target configuration.\n" +
+                    "Please add 'environmentId' to your tenant configuration or set 'autoSetup: false' to disable auto-setup.", {
+                    tenantId: target.tenantId,
+                    tenantName: target.tenantName,
+                    environmentUrl: target.environmentUrl,
+                });
+            }
+            // Note: This is the org name, not the full environment ID
+            // The Admin API requires the full ID like: /providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/{guid}
+            throw new GdapError(ErrorCode.GDAP_ENVIRONMENT_ID_MISSING, "Cannot auto-setup application user: environmentId not provided in target configuration.\n" +
+                "Please add 'environmentId' to your tenant configuration.\n" +
+                "You can find the environment ID in the Power Platform Admin Center URL when viewing the environment.", {
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                environmentUrl: target.environmentUrl,
+            });
+        }
+        const adminClient = new PowerPlatformAdminClient({
+            tokenManager,
+        });
+        try {
+            const result = await adminClient.setupApplicationUser(target.environmentId, target.environmentUrl, this.config.clientId);
+            if (result.created) {
+                console.log(`\u2713 ${result.message}`);
+            }
+            else {
+                console.log(`\u2713 ${result.message}`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new GdapError(ErrorCode.GDAP_SETUP_FAILED, `Failed to auto-setup application user: ${errorMessage}\n\n` +
+                `You can disable auto-setup by setting 'autoSetup: false' in your tenant configuration,\n` +
+                `then follow the manual setup instructions.`, {
+                clientId: this.config.clientId,
+                tenantId: target.tenantId,
+                tenantName: target.tenantName,
+                environmentUrl: target.environmentUrl,
+                environmentId: target.environmentId,
+            }, { cause: error });
+        }
+    }
+}
+//# sourceMappingURL=deployment-service.js.map

package/dist/services/deployment-service.js.map

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

package/dist/services/drift-analyzer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Copyright 2024 Pax8, 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.
+ */
+/**
+ * Drift Risk Analyzer
+ *
+ * Scores the risk of updating each drifted tenant by combining:
+ * - Version drift magnitude (how far behind)
+ * - Deployment history (last result, success rate, recency)
+ * - Tenant tags (production vs staging vs test)
+ *
+ * Produces a per-tenant recommendation: safe_to_update, review_recommended,
+ * update_risky, or do_not_update.
+ */
+import { TenantVersionStatus, SolutionVersionInfo } from "./version-checker.js";
+import { TenantConfig } from "../config/schema.js";
+export type DriftRiskLevel = "low" | "medium" | "high";
+export type DriftRecommendation = "safe_to_update" | "review_recommended" | "update_risky" | "do_not_update" | "current";
+export interface DriftRiskFactor {
+    name: string;
+    level: DriftRiskLevel;
+    weight: number;
+    description: string;
+}
+export interface TenantDriftAnalysis {
+    tenantId: string;
+    tenantName: string;
+    environmentUrl: string;
+    riskLevel: DriftRiskLevel;
+    riskScore: number;
+    recommendation: DriftRecommendation;
+    recommendationReason: string;
+    factors: DriftRiskFactor[];
+    versionStatus: TenantVersionStatus;
+    outdatedSolutions: SolutionVersionInfo[];
+}
+export interface FleetDriftAnalysis {
+    tenants: TenantDriftAnalysis[];
+    summary: {
+        total: number;
+        current: number;
+        safeToUpdate: number;
+        reviewRecommended: number;
+        risky: number;
+        doNotUpdate: number;
+    };
+}
+/**
+ * Deployment history for a single tenant, passed in by the caller.
+ * Keeps the DriftAnalyzer decoupled from Dataverse query logic.
+ */
+export interface TenantDeploymentHistory {
+    tenantId: string;
+    lastDeployResult: "success" | "failure" | null;
+    lastDeployDate: string | null;
+    totalDeploys: number;
+    successfulDeploys: number;
+}
+export declare class DriftAnalyzer {
+    /**
+     * Analyze drift risk for a single tenant
+     */
+    analyzeTenant(tenant: TenantConfig, versionStatus: TenantVersionStatus, history?: TenantDeploymentHistory): TenantDriftAnalysis;
+    /**
+     * Analyze drift risk for a fleet of tenants
+     */
+    analyzeFleet(tenants: TenantConfig[], versionStatuses: TenantVersionStatus[], histories?: Map<string, TenantDeploymentHistory>): FleetDriftAnalysis;
+    private calculateScore;
+    private scoreToLevel;
+    private getRecommendation;
+    private getTopRiskDescription;
+}
+export declare const driftAnalyzer: DriftAnalyzer;
+//# sourceMappingURL=drift-analyzer.d.ts.map

package/dist/services/drift-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-analyzer.d.ts","sourceRoot":"","sources":["../../src/services/drift-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,eAAe,GACf,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,mBAAmB,CAAC;IACpC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,mBAAmB,CAAC;IACnC,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAsBD,qBAAa,aAAa;IACxB;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,mBAAmB,EAClC,OAAO,CAAC,EAAE,uBAAuB,GAChC,mBAAmB;IA0JtB;;OAEG;IACH,YAAY,CACV,OAAO,EAAE,YAAY,EAAE,EACvB,eAAe,EAAE,mBAAmB,EAAE,EACtC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC/C,kBAAkB;IAwBrB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,qBAAqB;CAQ9B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}