@pax8-cta/core 0.1.0

package/dist/services/solution-diff.js

@@ -0,0 +1,260 @@
+/**
+ * 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 { readFile } from "node:fs/promises";
+import * as crypto from "node:crypto";
+import { SolutionOperations } from "../dataverse/index.js";
+/**
+ * Component type codes in Power Platform
+ */
+export const ComponentTypes = {
+    1: "Entity",
+    2: "Attribute",
+    3: "Relationship",
+    9: "Option Set",
+    10: "Entity Relationship",
+    20: "Security Role",
+    21: "Privilege",
+    26: "View",
+    29: "Workflow",
+    59: "Saved Query Visualization",
+    60: "Form",
+    61: "Organization",
+    62: "Web Resource",
+    63: "Site Map",
+    65: "Plugin Assembly",
+    70: "Plugin Type",
+    90: "SDK Message Processing Step",
+    91: "SDK Message Processing Step Image",
+    92: "Service Endpoint",
+    150: "Duplicate Detection Rule",
+    300: "Canvas App",
+    371: "Connector",
+    372: "Connection Reference",
+    380: "Environment Variable Definition",
+    381: "Environment Variable Value",
+    10029: "AI Model",
+    10034: "Bot Component",
+};
+/**
+ * Service for comparing solutions and previewing changes
+ */
+export class SolutionDiffService {
+    /**
+     * Compare a solution file against what's installed in a target environment
+     */
+    async compareSolutions(solutionPath, targetClient) {
+        // Parse the solution file to get metadata
+        const sourceMetadata = await this.parseSolutionFile(solutionPath);
+        if (!sourceMetadata) {
+            throw new Error("Failed to parse solution file");
+        }
+        // Get the installed solution in target environment
+        const solutionOps = new SolutionOperations(targetClient);
+        const installedSolution = await solutionOps.getSolution(sourceMetadata.uniqueName);
+        // If solution doesn't exist in target, it's a new install
+        if (!installedSolution) {
+            return {
+                source: {
+                    uniqueName: sourceMetadata.uniqueName,
+                    version: sourceMetadata.version,
+                    componentCount: sourceMetadata.componentCount || 0,
+                },
+                target: null,
+                summary: {
+                    added: sourceMetadata.componentCount || 0,
+                    removed: 0,
+                    modified: 0,
+                    unchanged: 0,
+                },
+                differences: [],
+                isUpgrade: false,
+                isNewInstall: true,
+            };
+        }
+        // Get components from installed solution
+        const installedComponents = await this.getSolutionComponents(targetClient, installedSolution.solutionid);
+        // For a proper diff, we would need to extract components from the zip file
+        // This is a simplified version that compares versions and basic info
+        const isUpgrade = this.compareVersions(sourceMetadata.version, installedSolution.version) > 0;
+        return {
+            source: {
+                uniqueName: sourceMetadata.uniqueName,
+                version: sourceMetadata.version,
+                componentCount: sourceMetadata.componentCount || 0,
+            },
+            target: {
+                uniqueName: installedSolution.uniquename,
+                version: installedSolution.version,
+                componentCount: installedComponents.length,
+            },
+            summary: {
+                added: 0,
+                removed: 0,
+                modified: 0,
+                unchanged: installedComponents.length,
+            },
+            differences: [],
+            isUpgrade,
+            isNewInstall: false,
+        };
+    }
+    /**
+     * Get all components from a solution
+     */
+    async getSolutionComponents(client, solutionId) {
+        const result = await client.get("/solutioncomponents", {
+            $filter: `_solutionid_value eq '${solutionId}'`,
+            $select: "solutioncomponentid,componenttype,objectid,rootsolutioncomponentid,ismetadata",
+        });
+        return result.value;
+    }
+    /**
+     * Parse solution.xml from a solution zip file
+     */
+    async parseSolutionFile(solutionPath) {
+        try {
+            const buffer = await readFile(solutionPath);
+            // Solutions are ZIP files - we need to extract solution.xml
+            // Using a simple approach: look for the XML content in the buffer
+            const content = buffer.toString("utf-8");
+            // Extract unique name
+            const uniqueNameMatch = content.match(/<UniqueName>([^<]+)<\/UniqueName>/);
+            const versionMatch = content.match(/<Version>([^<]+)<\/Version>/);
+            const friendlyNameMatch = content.match(/<LocalizedName[^>]*description="([^"]+)"/);
+            const managedMatch = content.match(/<Managed>([^<]+)<\/Managed>/);
+            if (!uniqueNameMatch || !versionMatch) {
+                // Try to use JSZip if available, otherwise return minimal info
+                return null;
+            }
+            return {
+                uniqueName: uniqueNameMatch[1],
+                version: versionMatch[1],
+                friendlyName: friendlyNameMatch?.[1] || uniqueNameMatch[1],
+                isManaged: managedMatch?.[1] === "1" || managedMatch?.[1] === "true",
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Compare two version strings
+     * Returns: >0 if v1 > v2, <0 if v1 < v2, 0 if equal
+     */
+    compareVersions(v1, v2) {
+        const parts1 = v1.split(".").map(Number);
+        const parts2 = v2.split(".").map(Number);
+        const maxLength = Math.max(parts1.length, parts2.length);
+        for (let i = 0; i < maxLength; i++) {
+            const p1 = parts1[i] || 0;
+            const p2 = parts2[i] || 0;
+            if (p1 !== p2) {
+                return p1 - p2;
+            }
+        }
+        return 0;
+    }
+    /**
+     * Preview what will happen during deployment
+     */
+    async previewDeployment(solutionPath, targetClient) {
+        const comparison = await this.compareSolutions(solutionPath, targetClient);
+        const warnings = [];
+        // Check for potential issues
+        if (!comparison.isNewInstall && !comparison.isUpgrade && comparison.target) {
+            if (this.compareVersions(comparison.source.version, comparison.target.version) < 0) {
+                warnings.push(`Source version (${comparison.source.version}) is older than target (${comparison.target.version}). This may cause issues.`);
+            }
+            if (comparison.source.version === comparison.target.version) {
+                warnings.push(`Same version (${comparison.source.version}) already installed. Import will overwrite existing customizations.`);
+            }
+        }
+        // Estimate duration based on component count
+        const componentCount = comparison.source.componentCount;
+        const baseDuration = 30000; // 30 seconds base
+        const perComponentDuration = 100; // 100ms per component
+        const estimatedDurationMs = baseDuration + componentCount * perComponentDuration;
+        return {
+            willInstall: comparison.isNewInstall,
+            willUpgrade: comparison.isUpgrade,
+            sourceVersion: comparison.source.version,
+            targetVersion: comparison.target?.version || null,
+            warnings,
+            estimatedDurationMs,
+        };
+    }
+    /**
+     * Calculate checksum for a solution file
+     */
+    async calculateChecksum(solutionPath) {
+        const buffer = await readFile(solutionPath);
+        return crypto.createHash("sha256").update(buffer).digest("hex");
+    }
+    /**
+     * Verify solution file integrity
+     */
+    async verifySolutionIntegrity(solutionPath, expectedChecksum) {
+        const errors = [];
+        let checksum;
+        try {
+            checksum = await this.calculateChecksum(solutionPath);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                checksum: "",
+                errors: [
+                    `Failed to read solution file: ${error instanceof Error ? error.message : String(error)}`,
+                ],
+            };
+        }
+        // Verify checksum if provided
+        if (expectedChecksum && checksum !== expectedChecksum) {
+            errors.push(`Checksum mismatch: expected ${expectedChecksum}, got ${checksum}`);
+        }
+        // Try to parse the solution
+        const metadata = await this.parseSolutionFile(solutionPath);
+        if (!metadata) {
+            errors.push("Failed to parse solution metadata from file");
+        }
+        return {
+            valid: errors.length === 0,
+            checksum,
+            errors,
+        };
+    }
+    /**
+     * Get summary of solution contents (for display purposes)
+     */
+    async getSolutionSummary(solutionPath) {
+        try {
+            const buffer = await readFile(solutionPath);
+            const metadata = await this.parseSolutionFile(solutionPath);
+            if (!metadata) {
+                return null;
+            }
+            return {
+                ...metadata,
+                checksum: crypto.createHash("sha256").update(buffer).digest("hex"),
+                fileSizeBytes: buffer.length,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=solution-diff.js.map

package/dist/services/solution-diff.js.map

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

package/dist/services/solution-mode-detector.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+export interface SolutionModeCheck {
+    managedCount: number;
+    unmanagedCount: number;
+    notInstalledCount: number;
+    hasConflict: boolean;
+}
+export interface TargetEnvironment {
+    tenantId: string;
+    environmentUrl: string;
+    name?: string;
+}
+/**
+ * Check solution installation mode across target environments.
+ *
+ * Queries each target in parallel and returns counts of managed/unmanaged/not-installed
+ * installations. The `hasConflict` flag indicates whether some targets have the solution
+ * as managed while others have it as unmanaged.
+ */
+export declare function detectSolutionMode(solutionName: string, targets: TargetEnvironment[], clientId: string, clientSecret: string): Promise<SolutionModeCheck>;
+//# sourceMappingURL=solution-mode-detector.d.ts.map

package/dist/services/solution-mode-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solution-mode-detector.d.ts","sourceRoot":"","sources":["../../src/services/solution-mode-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}

package/dist/services/solution-mode-detector.js

@@ -0,0 +1,84 @@
+/**
+ * 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.
+ */
+/**
+ * Solution Mode Detector
+ *
+ * Detects whether a solution is installed as managed or unmanaged across
+ * target environments to help auto-detect the correct export mode.
+ *
+ * Extracted from CLI deploy.ts to make this reusable and testable.
+ */
+import { DataverseClient } from "../dataverse/client.js";
+import { TokenManager } from "../auth/token-manager.js";
+// ============================================================================
+// Service
+// ============================================================================
+/**
+ * Check solution installation mode across target environments.
+ *
+ * Queries each target in parallel and returns counts of managed/unmanaged/not-installed
+ * installations. The `hasConflict` flag indicates whether some targets have the solution
+ * as managed while others have it as unmanaged.
+ */
+export async function detectSolutionMode(solutionName, targets, clientId, clientSecret) {
+    let managedCount = 0;
+    let unmanagedCount = 0;
+    let notInstalledCount = 0;
+    // Check each target in parallel for speed
+    const checks = targets.map(async (target) => {
+        try {
+            const tokenManager = new TokenManager({
+                tenantId: target.tenantId,
+                clientId,
+                clientSecret,
+            });
+            const client = new DataverseClient({
+                environmentUrl: target.environmentUrl,
+                tokenManager,
+            });
+            const result = await client.get("/solutions", {
+                $filter: `uniquename eq '${solutionName}'`,
+                $select: "solutionid,uniquename,ismanaged",
+            });
+            if (result.value.length === 0) {
+                return "not_installed";
+            }
+            return result.value[0].ismanaged ? "managed" : "unmanaged";
+        }
+        catch {
+            // If we can't check, assume not installed (will fail at import if wrong)
+            return "not_installed";
+        }
+    });
+    const results = await Promise.all(checks);
+    for (const mode of results) {
+        if (mode === "managed")
+            managedCount++;
+        else if (mode === "unmanaged")
+            unmanagedCount++;
+        else
+            notInstalledCount++;
+    }
+    // Conflict if we have both managed and unmanaged installations
+    const hasConflict = managedCount > 0 && unmanagedCount > 0;
+    return {
+        managedCount,
+        unmanagedCount,
+        notInstalledCount,
+        hasConflict,
+    };
+}
+//# sourceMappingURL=solution-mode-detector.js.map

package/dist/services/solution-mode-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solution-mode-detector.js","sourceRoot":"","sources":["../../src/services/solution-mode-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmBxD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAoB,EACpB,OAA4B,EAC5B,QAAgB,EAChB,YAAoB;IAEpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;gBACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,YAAY;aACb,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;gBACjC,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,YAAY;aACb,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAA8B,YAAY,EAAE;gBACzE,OAAO,EAAE,kBAAkB,YAAY,GAAG;gBAC1C,OAAO,EAAE,iCAAiC;aAC3C,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,eAAwB,CAAC;YAClC,CAAC;YAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,SAAmB,CAAC,CAAC,CAAE,WAAqB,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,OAAO,eAAwB,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS;YAAE,YAAY,EAAE,CAAC;aAClC,IAAI,IAAI,KAAK,WAAW;YAAE,cAAc,EAAE,CAAC;;YAC3C,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,GAAG,YAAY,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,CAAC;IAE3D,OAAO;QACL,YAAY;QACZ,cAAc;QACd,iBAAiB;QACjB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/services/tenant-resolver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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.
+ */
+/**
+ * Tenant URL Resolver
+ *
+ * Derives tenant-specific URL values from a tenant's configuration,
+ * primarily using the environmentUrl (Dynamics CRM URL) as the source of truth.
+ */
+import { TenantConfig } from "../config/schema.js";
+import { TenantUrlValues } from "./url-templater.js";
+/**
+ * Resolve tenant URL values from a TenantConfig
+ *
+ * Uses the environmentUrl (e.g., https://contoso.crm.dynamics.com) to derive:
+ * - tenant: The org/tenant identifier (e.g., "contoso")
+ * - sharepoint: SharePoint domain (e.g., "contoso.sharepoint.com")
+ * - dynamicsCrm: Dynamics CRM domain (e.g., "contoso.crm.dynamics.com")
+ * - onmicrosoft: Default tenant domain (e.g., "contoso.onmicrosoft.com")
+ */
+export declare function resolveTenantUrls(tenant: TenantConfig): TenantUrlValues;
+/**
+ * Apply manual overrides to resolved tenant URLs
+ */
+export declare function applyUrlOverrides(tenantUrls: TenantUrlValues, overrides?: Partial<TenantUrlValues>): TenantUrlValues;
+/**
+ * Validate that all required URL values are present
+ */
+export declare function validateTenantUrls(tenantUrls: TenantUrlValues): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Get a preview of URL transformations for a tenant
+ */
+export declare function previewUrlTransformations(templates: Array<{
+    originalUrl: string;
+    templatePattern: string;
+}>, tenantUrls: TenantUrlValues): Array<{
+    original: string;
+    resolved: string;
+}>;
+//# sourceMappingURL=tenant-resolver.d.ts.map

package/dist/services/tenant-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-resolver.d.ts","sourceRoot":"","sources":["../../src/services/tenant-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAiDvE;AAgBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,eAAe,EAC3B,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,eAAe,CAYjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAYA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,EAClE,UAAU,EAAE,eAAe,GAC1B,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAY/C"}

package/dist/services/tenant-resolver.js

@@ -0,0 +1,126 @@
+/**
+ * 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.
+ */
+/**
+ * Resolve tenant URL values from a TenantConfig
+ *
+ * Uses the environmentUrl (e.g., https://contoso.crm.dynamics.com) to derive:
+ * - tenant: The org/tenant identifier (e.g., "contoso")
+ * - sharepoint: SharePoint domain (e.g., "contoso.sharepoint.com")
+ * - dynamicsCrm: Dynamics CRM domain (e.g., "contoso.crm.dynamics.com")
+ * - onmicrosoft: Default tenant domain (e.g., "contoso.onmicrosoft.com")
+ */
+export function resolveTenantUrls(tenant) {
+    try {
+        const url = new URL(tenant.environmentUrl);
+        const hostname = url.hostname;
+        // Try to parse Dynamics CRM URL: {org}.crm{N}.dynamics.com
+        const crmMatch = hostname.match(/^([a-zA-Z0-9-]+)\.(crm[0-9]*)\.dynamics\.com$/i);
+        if (crmMatch) {
+            const orgName = crmMatch[1];
+            const region = crmMatch[2];
+            return {
+                tenant: orgName,
+                sharepoint: `${orgName}.sharepoint.com`,
+                dynamicsCrm: `${orgName}.${region}.dynamics.com`,
+                onmicrosoft: `${orgName}.onmicrosoft.com`,
+                region,
+            };
+        }
+        // Try alternate format: {org}.api.crm{N}.dynamics.com
+        const apiMatch = hostname.match(/^([a-zA-Z0-9-]+)\.api\.(crm[0-9]*)\.dynamics\.com$/i);
+        if (apiMatch) {
+            const orgName = apiMatch[1];
+            const region = apiMatch[2];
+            return {
+                tenant: orgName,
+                sharepoint: `${orgName}.sharepoint.com`,
+                dynamicsCrm: `${orgName}.${region}.dynamics.com`,
+                onmicrosoft: `${orgName}.onmicrosoft.com`,
+                region,
+            };
+        }
+    }
+    catch {
+        // Invalid URL, fall through to fallback
+    }
+    // Fallback: sanitize tenant name to create a valid identifier
+    const sanitized = sanitizeTenantName(tenant.name);
+    return {
+        tenant: sanitized,
+        sharepoint: `${sanitized}.sharepoint.com`,
+        dynamicsCrm: `${sanitized}.crm.dynamics.com`,
+        onmicrosoft: `${sanitized}.onmicrosoft.com`,
+    };
+}
+/**
+ * Sanitize a tenant name to create a valid URL identifier
+ */
+function sanitizeTenantName(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "") // Remove invalid characters
+        .replace(/^-+|-+$/g, "") // Remove leading/trailing dashes
+        .substring(0, 63) || // Max subdomain length
+        "tenant"); // Fallback if empty
+}
+/**
+ * Apply manual overrides to resolved tenant URLs
+ */
+export function applyUrlOverrides(tenantUrls, overrides) {
+    if (!overrides) {
+        return tenantUrls;
+    }
+    return {
+        tenant: overrides.tenant || tenantUrls.tenant,
+        sharepoint: overrides.sharepoint || tenantUrls.sharepoint,
+        dynamicsCrm: overrides.dynamicsCrm || tenantUrls.dynamicsCrm,
+        onmicrosoft: overrides.onmicrosoft || tenantUrls.onmicrosoft,
+        region: overrides.region || tenantUrls.region,
+    };
+}
+/**
+ * Validate that all required URL values are present
+ */
+export function validateTenantUrls(tenantUrls) {
+    const missing = [];
+    if (!tenantUrls.tenant)
+        missing.push("tenant");
+    if (!tenantUrls.sharepoint)
+        missing.push("sharepoint");
+    if (!tenantUrls.dynamicsCrm)
+        missing.push("dynamicsCrm");
+    if (!tenantUrls.onmicrosoft)
+        missing.push("onmicrosoft");
+    return {
+        valid: missing.length === 0,
+        missing,
+    };
+}
+/**
+ * Get a preview of URL transformations for a tenant
+ */
+export function previewUrlTransformations(templates, tenantUrls) {
+    return templates.map((template) => {
+        let resolved = template.templatePattern;
+        // Replace {tenant} placeholder
+        resolved = resolved.replace(/\{tenant\}/g, tenantUrls.tenant);
+        return {
+            original: template.originalUrl,
+            resolved,
+        };
+    });
+}
+//# sourceMappingURL=tenant-resolver.js.map

package/dist/services/tenant-resolver.js.map

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