@pax8-cta/core 0.1.0

package/dist/powerplatform/admin-client.js

@@ -0,0 +1,315 @@
+/**
+ * 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.
+ */
+/**
+ * Client for Power Platform Admin API
+ * Used to discover and manage environments across tenants
+ *
+ * API Reference: https://learn.microsoft.com/en-us/power-platform/admin/list-environments
+ */
+export class PowerPlatformAdminClient {
+    config;
+    adminApiUrl = "https://api.bap.microsoft.com";
+    apiVersion = "2021-04-01";
+    appManagementApiUrl = "https://api.powerplatform.com";
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * List all environments accessible to the authenticated user
+     * When using GDAP, this lists environments in the customer tenant
+     */
+    async listEnvironments() {
+        const token = await this.getAdminToken();
+        const url = `${this.adminApiUrl}/providers/Microsoft.BusinessAppPlatform/scopes/admin/environments?api-version=${this.apiVersion}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to list environments: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        return data.value || [];
+    }
+    /**
+     * Get details for a specific environment
+     */
+    async getEnvironment(environmentId) {
+        const token = await this.getAdminToken();
+        const url = `${this.adminApiUrl}/providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/${environmentId}?api-version=${this.apiVersion}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to get environment: ${response.status} - ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get environment capacity information
+     */
+    async getEnvironmentCapacity(environmentId) {
+        const env = await this.getEnvironment(environmentId);
+        return env.properties.capacity || [];
+    }
+    /**
+     * Convert raw environment to simplified summary for UI
+     */
+    toEnvironmentSummary(env) {
+        const linked = env.properties.linkedEnvironmentMetadata;
+        const capacity = env.properties.capacity || [];
+        const dbCapacity = capacity.find((c) => c.capacityType === "Database");
+        const fileCapacity = capacity.find((c) => c.capacityType === "File");
+        return {
+            id: env.id,
+            displayName: env.properties.displayName || linked?.friendlyName || env.name,
+            uniqueName: linked?.uniqueName || env.name,
+            domainName: linked?.domainName || "",
+            type: env.properties.environmentSku,
+            instanceUrl: linked?.instanceUrl ||
+                env.properties.runtimeEndpoints
+                    ?.microsoft_BusinessAppPlatform_linkedEnvironmentMetadata_instanceUrl ||
+                "",
+            instanceApiUrl: linked?.instanceApiUrl ||
+                env.properties.runtimeEndpoints
+                    ?.microsoft_BusinessAppPlatform_linkedEnvironmentMetadata_instanceApiUrl ||
+                "",
+            version: linked?.version || "",
+            state: linked?.instanceState || env.properties.states?.runtime?.id || "Unknown",
+            location: env.location,
+            isDefault: env.properties.isDefault,
+            createdTime: linked?.createdTime || env.properties.createdTime,
+            capacity: {
+                database: dbCapacity
+                    ? {
+                        used: dbCapacity.actualConsumption,
+                        rated: dbCapacity.ratedConsumption,
+                        unit: dbCapacity.capacityUnit,
+                    }
+                    : undefined,
+                file: fileCapacity
+                    ? {
+                        used: fileCapacity.actualConsumption,
+                        rated: fileCapacity.ratedConsumption,
+                        unit: fileCapacity.capacityUnit,
+                    }
+                    : undefined,
+            },
+        };
+    }
+    /**
+     * List environments and return simplified summaries
+     */
+    async listEnvironmentSummaries() {
+        const environments = await this.listEnvironments();
+        return environments
+            .filter((env) => env.properties.linkedEnvironmentMetadata) // Only Dataverse-enabled environments
+            .map((env) => this.toEnvironmentSummary(env));
+    }
+    /**
+     * List application users in an environment
+     */
+    async listApplicationUsers(environmentId) {
+        const token = await this.getAppManagementToken();
+        const url = `${this.appManagementApiUrl}/appmanagement/environments/${environmentId}/applicationUsers?api-version=2022-03-01-preview`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to list application users: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        return data.value || [];
+    }
+    /**
+     * Check if an application user exists for the given app ID
+     */
+    async checkApplicationUserExists(environmentId, appId) {
+        const users = await this.listApplicationUsers(environmentId);
+        return users.find((u) => u.applicationId.toLowerCase() === appId.toLowerCase()) || null;
+    }
+    /**
+     * Create an application user in an environment
+     */
+    async createApplicationUser(environmentId, appId, businessUnitId) {
+        const token = await this.getAppManagementToken();
+        const url = `${this.appManagementApiUrl}/appmanagement/environments/${environmentId}/applicationUsers?api-version=2022-03-01-preview`;
+        const body = {
+            applicationId: appId,
+            businessUnitId: businessUnitId,
+        };
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to create application user: ${response.status} - ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get the default (root) business unit for an environment
+     */
+    async getDefaultBusinessUnitId(environmentUrl) {
+        // Use Dataverse Web API to get the root business unit
+        const token = await this.config.tokenManager.getDataverseToken(environmentUrl);
+        const baseUrl = environmentUrl.replace(/\/$/, "");
+        const apiUrl = `${baseUrl}/api/data/v9.2`;
+        const url = `${apiUrl}/businessunits?$select=businessunitid,name&$filter=parentbusinessunitid eq null`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "OData-MaxVersion": "4.0",
+                "OData-Version": "4.0",
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to get default business unit: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        if (!data.value || data.value.length === 0) {
+            throw new Error("No root business unit found in environment");
+        }
+        return data.value[0].businessunitid;
+    }
+    /**
+     * Get the System Administrator role ID for an environment
+     */
+    async getSystemAdminRoleId(environmentUrl) {
+        // Use Dataverse Web API to get the System Administrator role
+        const token = await this.config.tokenManager.getDataverseToken(environmentUrl);
+        const baseUrl = environmentUrl.replace(/\/$/, "");
+        const apiUrl = `${baseUrl}/api/data/v9.2`;
+        const url = `${apiUrl}/roles?$select=roleid,name&$filter=name eq 'System Administrator'`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "OData-MaxVersion": "4.0",
+                "OData-Version": "4.0",
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to get System Administrator role: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        if (!data.value || data.value.length === 0) {
+            throw new Error("System Administrator role not found in environment");
+        }
+        return data.value[0].roleid;
+    }
+    /**
+     * Assign a security role to a user (using Dataverse Web API)
+     */
+    async assignSecurityRole(environmentUrl, userId, roleId) {
+        const token = await this.config.tokenManager.getDataverseToken(environmentUrl);
+        const baseUrl = environmentUrl.replace(/\/$/, "");
+        const apiUrl = `${baseUrl}/api/data/v9.2`;
+        // Use associate action to link role to user
+        const url = `${apiUrl}/systemusers(${userId})/systemuserroles_association/$ref`;
+        const body = {
+            "@odata.id": `${apiUrl}/roles(${roleId})`,
+        };
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "OData-MaxVersion": "4.0",
+                "OData-Version": "4.0",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            // Don't fail if role already assigned
+            if (response.status === 400 && error.includes("duplicate")) {
+                return;
+            }
+            throw new Error(`Failed to assign security role: ${response.status} - ${error}`);
+        }
+    }
+    /**
+     * Setup application user with System Administrator role
+     * This is the main entry point for auto-setup functionality
+     */
+    async setupApplicationUser(environmentId, environmentUrl, appId) {
+        // Check if app user already exists
+        const existingUser = await this.checkApplicationUserExists(environmentId, appId);
+        if (existingUser) {
+            return {
+                created: false,
+                userId: existingUser.systemUserId,
+                message: "Application user already exists",
+            };
+        }
+        // Get default business unit
+        const businessUnitId = await this.getDefaultBusinessUnitId(environmentUrl);
+        // Create application user
+        const appUser = await this.createApplicationUser(environmentId, appId, businessUnitId);
+        // Get System Administrator role
+        const roleId = await this.getSystemAdminRoleId(environmentUrl);
+        // Assign role to user
+        await this.assignSecurityRole(environmentUrl, appUser.systemUserId, roleId);
+        return {
+            created: true,
+            userId: appUser.systemUserId,
+            message: "Application user created and System Administrator role assigned",
+        };
+    }
+    /**
+     * Get token for Power Platform Admin API
+     * Uses the BAP (Business Application Platform) scope
+     */
+    async getAdminToken() {
+        return this.config.tokenManager.getToken(["https://api.bap.microsoft.com/.default"]);
+    }
+    /**
+     * Get token for Power Platform App Management API
+     * Uses the Power Platform API scope
+     */
+    async getAppManagementToken() {
+        return this.config.tokenManager.getToken(["https://api.powerplatform.com/.default"]);
+    }
+}
+//# sourceMappingURL=admin-client.js.map

package/dist/powerplatform/admin-client.js.map

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

package/dist/powerplatform/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 * from "./admin-client.js";
+export * from "./tenant-discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/powerplatform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/powerplatform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/powerplatform/index.js

@@ -0,0 +1,18 @@
+/**
+ * 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 * from "./admin-client.js";
+export * from "./tenant-discovery.js";
+//# sourceMappingURL=index.js.map

package/dist/powerplatform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/powerplatform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/powerplatform/tenant-discovery.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 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, TokenManagerConfig } from "../auth/token-manager.js";
+import { EnvironmentSummary } from "./admin-client.js";
+export interface TenantDiscoveryConfig extends TokenManagerConfig {
+}
+/**
+ * Discovered customer tenant with environments and solutions
+ */
+export interface DiscoveredTenant {
+    tenantId: string;
+    displayName: string;
+    gdapRelationshipId: string;
+    gdapStatus: "active" | "pending" | "terminated" | "expired";
+    gdapEndDateTime: string;
+    hasPowerPlatformAdmin: boolean;
+    environments: EnvironmentSummary[];
+    defaultEnvironment?: EnvironmentSummary;
+    discoveredAt: string;
+    error?: string;
+}
+/**
+ * Solution info from a discovered tenant
+ */
+export interface DiscoveredSolution {
+    tenantId: string;
+    tenantName: string;
+    environmentId: string;
+    environmentName: string;
+    environmentUrl: string;
+    solutionId: string;
+    uniqueName: string;
+    friendlyName: string;
+    version: string;
+    isManaged: boolean;
+    publisherName?: string;
+}
+/**
+ * Service for discovering customer tenants and their Power Platform environments
+ * via GDAP relationships
+ */
+export declare class TenantDiscoveryService {
+    private gdapClient;
+    private partnerConfig;
+    private tenantCache;
+    private solutionCache;
+    private readonly DEFAULT_CACHE_TTL_MS;
+    constructor(config: TenantDiscoveryConfig);
+    /**
+     * Discover all customer tenants via GDAP and their Power Platform environments
+     */
+    discoverTenants(options?: {
+        forceRefresh?: boolean;
+        cacheTtlMs?: number;
+    }): Promise<DiscoveredTenant[]>;
+    /**
+     * Discover environments for a single tenant
+     */
+    private discoverTenantEnvironments;
+    /**
+     * Discover solutions installed in a tenant's environment
+     */
+    discoverSolutions(tenantId: string, environmentUrl: string, options?: {
+        forceRefresh?: boolean;
+        cacheTtlMs?: number;
+    }): Promise<DiscoveredSolution[]>;
+    /**
+     * Discover a specific solution across all tenants
+     * Useful for finding where an agent is deployed
+     */
+    findSolutionAcrossTenants(solutionUniqueName: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<DiscoveredSolution[]>;
+    /**
+     * Get a token manager for a specific customer tenant
+     */
+    getCustomerTokenManager(customerTenantId: string): TokenManager;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Clear cache for a specific tenant
+     */
+    clearTenantCache(tenantId: string): void;
+}
+//# sourceMappingURL=tenant-discovery.d.ts.map

package/dist/powerplatform/tenant-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-discovery.d.ts","sourceRoot":"","sources":["../../src/powerplatform/tenant-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAA4B,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIjF,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;CAEhE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAwB;IAG7C,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,aAAa,CAA4D;IAEjF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkB;gBAE3C,MAAM,EAAE,qBAAqB;IAKzC;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE;QAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6C/B;;OAEG;YACW,0BAA0B;IA2CxC;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqDhC;;;OAGG;IACG,yBAAyB,CAC7B,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACA,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA2BhC;;OAEG;IACH,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY;IAO/D;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAUzC"}