@pax8-cta/core 0.1.0

package/dist/auth/token-manager.js

@@ -0,0 +1,150 @@
+/**
+ * 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 { ConfidentialClientApplication, } from "@azure/msal-node";
+import { TOKEN_REFRESH_BUFFER_MS } from "../constants.js";
+import { AuthError, ErrorCode } from "../errors.js";
+/**
+ * Manages OAuth tokens with caching and automatic refresh
+ */
+export class TokenManager {
+    msalClient;
+    tokenCache = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+        const msalConfig = {
+            auth: {
+                clientId: config.clientId,
+                authority: `https://login.microsoftonline.com/${config.tenantId}`,
+                clientSecret: config.clientSecret,
+            },
+        };
+        this.msalClient = new ConfidentialClientApplication(msalConfig);
+    }
+    /**
+     * Get the client ID for this token manager
+     */
+    getClientId() {
+        return this.config.clientId;
+    }
+    /**
+     * Get an access token for the specified resource/scope
+     * Tokens are cached and automatically refreshed when near expiry
+     */
+    async getToken(scopes) {
+        const cacheKey = scopes.sort().join(",");
+        const cached = this.tokenCache.get(cacheKey);
+        if (cached && !this.isTokenExpired(cached)) {
+            return cached.accessToken;
+        }
+        const result = await this.acquireToken(scopes);
+        this.cacheToken(cacheKey, result);
+        return result.accessToken;
+    }
+    /**
+     * Get a token for Dataverse API access
+     */
+    async getDataverseToken(environmentUrl) {
+        // Dataverse scope is the environment URL with /.default
+        const baseUrl = environmentUrl.replace(/\/$/, "");
+        const scopes = [`${baseUrl}/.default`];
+        return this.getToken(scopes);
+    }
+    /**
+     * Get a token for Microsoft Graph API access
+     */
+    async getGraphToken() {
+        return this.getToken(["https://graph.microsoft.com/.default"]);
+    }
+    /**
+     * Clear all cached tokens
+     */
+    clearCache() {
+        this.tokenCache.clear();
+    }
+    async acquireToken(scopes) {
+        try {
+            const result = await this.msalClient.acquireTokenByClientCredential({
+                scopes,
+            });
+            if (!result) {
+                throw new AuthError(ErrorCode.AUTH_FAILED, "Failed to acquire token - no result returned", {
+                    clientId: this.config.clientId,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            // Re-throw if already a typed error
+            if (error instanceof AuthError) {
+                throw error;
+            }
+            const errorString = String(error);
+            const context = { clientId: this.config.clientId, tenantId: this.config.tenantId };
+            // Check for common authentication errors
+            if (/AADSTS700016/i.test(errorString)) {
+                throw new AuthError(ErrorCode.AUTH_APP_NOT_FOUND, `Token acquisition failed: ${error instanceof Error ? error.message : String(error)}\n\n` +
+                    `The application (Client ID: ${this.config.clientId}) is not registered in the tenant.\n` +
+                    `\nTo fix:\n` +
+                    `1. Verify the Client ID in your configuration\n` +
+                    `2. Go to https://portal.azure.com → Azure Active Directory → App registrations\n` +
+                    `3. Ensure the app is registered in the correct tenant\n` +
+                    `4. Check that the app has not been deleted`, context, { cause: error });
+            }
+            else if (/AADSTS7000215/i.test(errorString)) {
+                throw new AuthError(ErrorCode.AUTH_INVALID_SECRET, `Token acquisition failed: ${error instanceof Error ? error.message : String(error)}\n\n` +
+                    `The client secret for application (Client ID: ${this.config.clientId}) is invalid.\n` +
+                    `\nTo fix:\n` +
+                    `1. Go to https://portal.azure.com → Azure Active Directory → App registrations\n` +
+                    `2. Find your application and go to "Certificates & secrets"\n` +
+                    `3. Generate a new client secret\n` +
+                    `4. Update your configuration with the new secret\n` +
+                    `5. Note: Secrets expire - check the expiration date`, context, { cause: error });
+            }
+            else if (/AADSTS50034/i.test(errorString)) {
+                throw new AuthError(ErrorCode.AUTH_ACCOUNT_NOT_FOUND, `Token acquisition failed: ${error instanceof Error ? error.message : String(error)}\n\n` +
+                    `The application (Client ID: ${this.config.clientId}) account does not exist in tenant ${this.config.tenantId}.\n` +
+                    `\nTo fix:\n` +
+                    `1. Verify the Tenant ID in your configuration\n` +
+                    `2. Ensure the application is registered in the correct Azure AD tenant`, context, { cause: error });
+            }
+            else if (/invalid_client/i.test(errorString)) {
+                throw new AuthError(ErrorCode.AUTH_INVALID_CLIENT, `Token acquisition failed: ${error instanceof Error ? error.message : String(error)}\n\n` +
+                    `Authentication credentials are invalid for application (Client ID: ${this.config.clientId}).\n` +
+                    `\nTo fix:\n` +
+                    `1. Verify Client ID and Client Secret are correct\n` +
+                    `2. Check if the client secret has expired\n` +
+                    `3. Ensure the application has the required API permissions:\n` +
+                    `   - For Power Platform: "Dynamics CRM" → "user_impersonation"\n` +
+                    `   - Click "Grant admin consent" after adding permissions`, context, { cause: error });
+            }
+            // Generic auth failure
+            throw new AuthError(ErrorCode.AUTH_FAILED, `Token acquisition failed: ${error instanceof Error ? error.message : String(error)}`, context, { cause: error });
+        }
+    }
+    cacheToken(key, result) {
+        this.tokenCache.set(key, {
+            accessToken: result.accessToken,
+            expiresAt: result.expiresOn || new Date(Date.now() + 3600 * 1000),
+        });
+    }
+    isTokenExpired(cached) {
+        const now = Date.now();
+        const expiresAt = cached.expiresAt.getTime();
+        return now >= expiresAt - TOKEN_REFRESH_BUFFER_MS;
+    }
+}
+//# sourceMappingURL=token-manager.js.map

package/dist/auth/token-manager.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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-safe exports from @pax8-cta/core
+ *
+ * Use this entry point when importing in client-side (browser) code.
+ * These exports don't require Node.js APIs.
+ *
+ * @example
+ * // In a 'use client' component:
+ * import { DEPLOYMENT_STATUS_CATEGORIES } from '@pax8-cta/core/client'
+ */
+export * from "./config/client.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/client.js

@@ -0,0 +1,27 @@
+/**
+ * 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-safe exports from @pax8-cta/core
+ *
+ * Use this entry point when importing in client-side (browser) code.
+ * These exports don't require Node.js APIs.
+ *
+ * @example
+ * // In a 'use client' component:
+ * import { DEPLOYMENT_STATUS_CATEGORIES } from '@pax8-cta/core/client'
+ */
+export * from "./config/client.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/config/client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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-safe exports from the config module.
+ *
+ * This file only exports types and constants that don't require Node.js APIs,
+ * making them safe to import in client-side (browser) code.
+ */
+export type { DeploymentStatus, TenantDeploymentResult, DeploymentTrigger, DeploymentJob, Deployment, DeploymentBatch, StatusCategory, } from "./schema.js";
+export { DEPLOYMENT_STATUS_CATEGORIES, calculateDeploymentStatus } from "./schema.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/config/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/config/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AAGH,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/client.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.
+ */
+// Re-export status constants and utilities
+export { DEPLOYMENT_STATUS_CATEGORIES, calculateDeploymentStatus } from "./schema.js";
+//# sourceMappingURL=client.js.map

package/dist/config/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/config/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,2CAA2C;AAC3C,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/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 "./schema.js";
+export * from "./loader.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/config/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 "./schema.js";
+export * from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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 { Config } from "./schema.js";
+import { ConfigValidationError } from "../errors.js";
+/**
+ * @deprecated Use ConfigValidationError from @pax8-cta/core/errors instead.
+ * Kept for backwards compatibility.
+ */
+export declare class ConfigError extends ConfigValidationError {
+    readonly name: "ConfigValidationError";
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Load and validate configuration from YAML file with optional env var overrides
+ *
+ * Priority:
+ * - Tenants ALWAYS come from config file (never from env vars)
+ * - Env vars can override partner/source config fields
+ * - Secrets (like PARTNER_CLIENT_SECRET) come from env vars via getClientSecret()
+ */
+export declare function loadConfig(configPath: string): Promise<Config>;
+/**
+ * Get client secret from environment variable
+ */
+export declare function getClientSecret(envVar?: string): string;
+/**
+ * Filter tenants by tags
+ */
+export declare function filterTenantsByTags(config: Config, tags: string[]): Config["tenants"];
+/**
+ * Filter tenants by name (partial match)
+ */
+export declare function filterTenantsByName(config: Config, namePattern: string): Config["tenants"];
+/**
+ * Get a single tenant by ID
+ */
+export declare function getTenantById(config: Config, tenantId: string): Config["tenants"][0] | undefined;
+/**
+ * Find a tenant by ID, name, or environment URL
+ *
+ * Matches tenants using the following strategies (in order):
+ * 1. Exact match on tenantId (UUID)
+ * 2. Case-insensitive exact match on name
+ * 3. Case-insensitive partial match on environmentUrl
+ *
+ * This is useful when multiple environments share the same Azure AD tenant,
+ * allowing users to specify tenants by name or URL instead of just tenant ID.
+ *
+ * @param config - The configuration containing tenant definitions
+ * @param identifier - The tenant identifier (ID, name, or environment URL)
+ * @returns The matching tenant config, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * // Match by tenant ID
+ * findTenant(config, "12345678-1234-1234-1234-123456789012");
+ *
+ * // Match by name (case-insensitive)
+ * findTenant(config, "production");
+ * findTenant(config, "Production"); // same result
+ *
+ * // Match by environment URL (partial, case-insensitive)
+ * findTenant(config, "contoso.crm.dynamics.com");
+ * findTenant(config, "contoso"); // same result
+ * ```
+ */
+export declare function findTenant(config: Config, identifier: string): Config["tenants"][0] | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAa,MAAM,cAAc,CAAC;AAEhE;;;GAGG;AACH,qBAAa,WAAY,SAAQ,qBAAqB;IACpD,SAAkB,IAAI,EAAG,uBAAuB,CAAU;gBAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAc7C;AA+FD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,MAAgC,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAQrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAK1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAsB/F"}