@pax8-cta/core 0.1.0

package/dist/dataverse/client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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";
+export interface DataverseClientConfig {
+    environmentUrl: string;
+    tokenManager: TokenManager;
+    clientId?: string;
+}
+export interface DataverseError {
+    code: string;
+    message: string;
+    innererror?: {
+        message: string;
+        type: string;
+        stacktrace: string;
+    };
+}
+export interface ErrorContext {
+    operation?: string;
+    environmentUrl?: string;
+    clientId?: string;
+}
+/**
+ * Format Dataverse errors with helpful guidance for common authentication issues.
+ *
+ * Throws a typed error (DataverseApiError or GdapError) instead of
+ * returning a plain string, so callers can switch on error.code.
+ */
+export declare function throwDataverseError(error: DataverseError, statusCode: number, context?: ErrorContext): never;
+/**
+ * Format Dataverse errors with helpful guidance for common authentication issues.
+ *
+ * @deprecated Use throwDataverseError() instead. This is kept for backwards
+ * compatibility but will be removed in a future release.
+ */
+export declare function formatDataverseError(error: DataverseError, statusCode: number, context?: ErrorContext): string;
+/**
+ * Low-level client for Dataverse Web API
+ */
+export declare class DataverseClient {
+    private config;
+    private readonly apiUrl;
+    constructor(config: DataverseClientConfig);
+    /**
+     * Make a GET request to the Dataverse API
+     */
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    /**
+     * Make a POST request to the Dataverse API
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * Make a PATCH request to the Dataverse API
+     */
+    patch<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * Make a DELETE request to the Dataverse API
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Execute a Dataverse action (unbound)
+     */
+    executeAction<TRequest, TResponse>(actionName: string, parameters: TRequest): Promise<TResponse>;
+    /**
+     * Get the raw response for actions that return binary data (like solution export)
+     */
+    executeActionRaw(actionName: string, parameters: unknown): Promise<Response>;
+    /**
+     * Query solutions in the environment
+     */
+    querySolutions(): Promise<SolutionRecord[]>;
+    /**
+     * Get a specific solution by unique name
+     */
+    getSolutionByName(uniqueName: string): Promise<SolutionRecord | null>;
+    private fetch;
+    private handleError;
+}
+export interface SolutionRecord {
+    solutionid: string;
+    uniquename: string;
+    friendlyname: string;
+    version: string;
+    ismanaged: boolean;
+    publisherid?: {
+        publisherid: string;
+        uniquename: string;
+        friendlyname: string;
+    };
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/dataverse/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,KAAK,CA8GP;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAWR;AAED;;GAEG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEZ,MAAM,EAAE,qBAAqB;IAKjD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYvE;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAUtD;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAUvD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,SAAS,EACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,QAAQ,GACnB,OAAO,CAAC,SAAS,CAAC;IAIrB;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBlF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASjD;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAQ7D,KAAK;YAsBL,WAAW;CA4B1B;AAED,MAAM,WAAW,cAAc;IAC7B,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,WAAW,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH"}

package/dist/dataverse/client.js

@@ -0,0 +1,272 @@
+/**
+ * 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 { DataverseApiError, ErrorCode, GdapError } from "../errors.js";
+/**
+ * Format Dataverse errors with helpful guidance for common authentication issues.
+ *
+ * Throws a typed error (DataverseApiError or GdapError) instead of
+ * returning a plain string, so callers can switch on error.code.
+ */
+export function throwDataverseError(error, statusCode, context) {
+    const errorMessage = error.message;
+    const innerMessage = error.innererror?.message || "";
+    const fullMessage = `${errorMessage}${innerMessage ? ` - ${innerMessage}` : ""}`;
+    const errorContext = {
+        environmentUrl: context?.environmentUrl,
+        clientId: context?.clientId,
+    };
+    // Check for common S2S authentication patterns
+    const isNotMemberError = /user is not a member of the organization/i.test(fullMessage) ||
+        /not a member of.*environment/i.test(fullMessage);
+    if (isNotMemberError) {
+        let helpfulMessage = `Authentication failed: ${fullMessage}\n`;
+        helpfulMessage += `\nThe application is not registered as a user in the Power Platform environment.\n`;
+        helpfulMessage += `\nTo fix:\n`;
+        helpfulMessage += `1. Go to https://admin.powerplatform.microsoft.com\n`;
+        helpfulMessage += `2. Select the environment → Settings → Users + permissions → Application users\n`;
+        helpfulMessage += `3. Click "+ New app user" and add your application\n`;
+        if (context?.clientId) {
+            helpfulMessage += `   Client ID: ${context.clientId}\n`;
+        }
+        helpfulMessage += `4. Assign the "System Administrator" security role\n`;
+        helpfulMessage += `5. Save and retry the command\n`;
+        if (context?.environmentUrl) {
+            helpfulMessage += `\nEnvironment: ${context.environmentUrl}`;
+        }
+        throw new GdapError(ErrorCode.GDAP_APP_USER_NOT_REGISTERED, helpfulMessage, errorContext);
+    }
+    const isPrivilegeError = /prvRead/i.test(fullMessage) ||
+        /prvWrite/i.test(fullMessage) ||
+        /prvCreate/i.test(fullMessage) ||
+        /prvDelete/i.test(fullMessage) ||
+        /insufficient.*privilege/i.test(fullMessage) ||
+        /missing privilege/i.test(fullMessage) ||
+        /access.*denied/i.test(fullMessage);
+    const isForbiddenError = statusCode === 403;
+    const isUnauthorizedError = statusCode === 401;
+    if (isPrivilegeError || isForbiddenError) {
+        let helpfulMessage = `Authentication failed: ${fullMessage}\n`;
+        helpfulMessage += `\nThe application lacks required permissions in the Power Platform environment.\n`;
+        helpfulMessage += `\nTo fix:\n`;
+        helpfulMessage += `1. Go to https://admin.powerplatform.microsoft.com\n`;
+        helpfulMessage += `2. Select the environment → Settings → Users + permissions → Application users\n`;
+        helpfulMessage += `3. Find your application user`;
+        if (context?.clientId) {
+            helpfulMessage += ` (Client ID: ${context.clientId})`;
+        }
+        helpfulMessage += `\n`;
+        helpfulMessage += `4. Click "Manage security roles" or "Edit"\n`;
+        helpfulMessage += `5. Ensure "System Administrator" role is assigned\n`;
+        helpfulMessage += `   (Required privileges: prvReadSolution, prvWriteSolution, prvCreateSolution, etc.)\n`;
+        helpfulMessage += `6. Save and retry the command\n`;
+        if (context?.environmentUrl) {
+            helpfulMessage += `\nEnvironment: ${context.environmentUrl}`;
+        }
+        throw new DataverseApiError(isPrivilegeError ? ErrorCode.PERMISSION_PRIVILEGE_MISSING : ErrorCode.DATAVERSE_FORBIDDEN, helpfulMessage, statusCode, errorContext);
+    }
+    if (isUnauthorizedError) {
+        let helpfulMessage = `Authentication failed: ${fullMessage}\n`;
+        helpfulMessage += `\nAuthentication token could not be acquired or is invalid.\n`;
+        helpfulMessage += `\nTo fix:\n`;
+        helpfulMessage += `1. Verify the app registration in Azure Portal:\n`;
+        helpfulMessage += `   - Go to https://portal.azure.com → Azure Active Directory → App registrations\n`;
+        if (context?.clientId) {
+            helpfulMessage += `   - Find your app (Client ID: ${context.clientId})\n`;
+        }
+        helpfulMessage += `2. Check API permissions:\n`;
+        helpfulMessage += `   - Ensure "Dynamics CRM" or "Common Data Service" permission is added\n`;
+        helpfulMessage += `   - Permission type: "user_impersonation" (delegated) or ".default" (application)\n`;
+        helpfulMessage += `   - Verify "Grant admin consent" has been clicked\n`;
+        helpfulMessage += `3. Verify client secret:\n`;
+        helpfulMessage += `   - Check if the secret has expired\n`;
+        helpfulMessage += `   - Generate a new secret if needed and update your configuration\n`;
+        helpfulMessage += `4. Retry the command\n`;
+        if (context?.environmentUrl) {
+            helpfulMessage += `\nEnvironment: ${context.environmentUrl}`;
+        }
+        throw new DataverseApiError(ErrorCode.DATAVERSE_UNAUTHORIZED, helpfulMessage, statusCode, errorContext);
+    }
+    // Generic Dataverse API error
+    let helpfulMessage = `Dataverse API error: ${fullMessage}`;
+    if (context?.environmentUrl) {
+        helpfulMessage += `\nEnvironment: ${context.environmentUrl}`;
+    }
+    throw new DataverseApiError(ErrorCode.DATAVERSE_API_ERROR, helpfulMessage, statusCode, errorContext);
+}
+/**
+ * Format Dataverse errors with helpful guidance for common authentication issues.
+ *
+ * @deprecated Use throwDataverseError() instead. This is kept for backwards
+ * compatibility but will be removed in a future release.
+ */
+export function formatDataverseError(error, statusCode, context) {
+    try {
+        throwDataverseError(error, statusCode, context);
+    }
+    catch (e) {
+        if (e instanceof Error) {
+            return e.message;
+        }
+        return String(e);
+    }
+    // Unreachable, but TypeScript needs it
+    return "";
+}
+/**
+ * Low-level client for Dataverse Web API
+ */
+export class DataverseClient {
+    config;
+    apiUrl;
+    constructor(config) {
+        this.config = config;
+        const baseUrl = config.environmentUrl.replace(/\/$/, "");
+        this.apiUrl = `${baseUrl}/api/data/v9.2`;
+    }
+    /**
+     * Make a GET request to the Dataverse API
+     */
+    async get(path, params) {
+        const url = new URL(`${this.apiUrl}${path}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                url.searchParams.set(key, value);
+            });
+        }
+        const response = await this.fetch(url.toString(), { method: "GET" });
+        return response.json();
+    }
+    /**
+     * Make a POST request to the Dataverse API
+     */
+    async post(path, body) {
+        const response = await this.fetch(`${this.apiUrl}${path}`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        const text = await response.text();
+        return (text ? JSON.parse(text) : null);
+    }
+    /**
+     * Make a PATCH request to the Dataverse API
+     */
+    async patch(path, body) {
+        const response = await this.fetch(`${this.apiUrl}${path}`, {
+            method: "PATCH",
+            body: JSON.stringify(body),
+        });
+        const text = await response.text();
+        return (text ? JSON.parse(text) : null);
+    }
+    /**
+     * Make a DELETE request to the Dataverse API
+     */
+    async delete(path) {
+        await this.fetch(`${this.apiUrl}${path}`, {
+            method: "DELETE",
+        });
+    }
+    /**
+     * Execute a Dataverse action (unbound)
+     */
+    async executeAction(actionName, parameters) {
+        return this.post(`/${actionName}`, parameters);
+    }
+    /**
+     * Get the raw response for actions that return binary data (like solution export)
+     */
+    async executeActionRaw(actionName, parameters) {
+        const token = await this.config.tokenManager.getDataverseToken(this.config.environmentUrl);
+        const response = await fetch(`${this.apiUrl}/${actionName}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "OData-MaxVersion": "4.0",
+                "OData-Version": "4.0",
+            },
+            body: JSON.stringify(parameters),
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response;
+    }
+    /**
+     * Query solutions in the environment
+     */
+    async querySolutions() {
+        const result = await this.get("/solutions", {
+            $select: "solutionid,uniquename,friendlyname,version,ismanaged",
+            $filter: "isvisible eq true",
+            $orderby: "friendlyname asc",
+        });
+        return result.value;
+    }
+    /**
+     * Get a specific solution by unique name
+     */
+    async getSolutionByName(uniqueName) {
+        const result = await this.get("/solutions", {
+            $select: "solutionid,uniquename,friendlyname,version,ismanaged,publisherid",
+            $filter: `uniquename eq '${uniqueName}'`,
+        });
+        return result.value[0] || null;
+    }
+    async fetch(url, options) {
+        const token = await this.config.tokenManager.getDataverseToken(this.config.environmentUrl);
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "OData-MaxVersion": "4.0",
+                "OData-Version": "4.0",
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response;
+    }
+    async handleError(response) {
+        try {
+            const errorBody = (await response.json());
+            if (errorBody.error) {
+                // Throws a typed error (DataverseApiError, GdapError, etc.)
+                throwDataverseError(errorBody.error, response.status, {
+                    environmentUrl: this.config.environmentUrl,
+                    clientId: this.config.clientId,
+                });
+            }
+        }
+        catch (e) {
+            // Re-throw typed errors from throwDataverseError
+            if (e instanceof DataverseApiError || e instanceof GdapError) {
+                throw e;
+            }
+            // Ignore JSON parse errors - fall back to basic error
+        }
+        throw new DataverseApiError(ErrorCode.DATAVERSE_API_ERROR, `Dataverse API error: ${response.status} ${response.statusText}`, response.status, {
+            environmentUrl: this.config.environmentUrl,
+            clientId: this.config.clientId,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/dataverse/client.js.map

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

package/dist/dataverse/connection-refs.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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 { DataverseClient } from "./client.js";
+import { ConnectionMapping, EnvironmentVariable } from "../config/schema.js";
+/**
+ * Connection Reference record from Dataverse
+ */
+export interface ConnectionReferenceRecord {
+    connectionreferenceid: string;
+    connectionreferencelogicalname: string;
+    connectionreferencedisplayname: string;
+    connectionid: string | null;
+    connectorid: string;
+    statecode: number;
+    statuscode: number;
+}
+/**
+ * Environment Variable Definition record
+ */
+export interface EnvironmentVariableDefinitionRecord {
+    environmentvariabledefinitionid: string;
+    schemaname: string;
+    displayname: string;
+    type: number;
+    defaultvalue: string | null;
+}
+/**
+ * Environment Variable Value record
+ */
+export interface EnvironmentVariableValueRecord {
+    environmentvariablevalueid: string;
+    value: string;
+    environmentvariabledefinitionid: string;
+}
+/**
+ * Operations for managing Connection References and Environment Variables
+ */
+export declare class ConnectionOperations {
+    private client;
+    constructor(client: DataverseClient);
+    /**
+     * List all connection references in the environment
+     */
+    listConnectionReferences(): Promise<ConnectionReferenceRecord[]>;
+    /**
+     * Get a connection reference by logical name
+     */
+    getConnectionReferenceByLogicalName(logicalName: string): Promise<ConnectionReferenceRecord | null>;
+    /**
+     * Update the connection ID for a connection reference
+     */
+    updateConnectionReference(connectionReferenceId: string, connectionId: string): Promise<void>;
+    /**
+     * Apply connection mappings to the environment
+     * Maps source connection references to target connections
+     */
+    applyConnectionMappings(mappings: ConnectionMapping[]): Promise<{
+        success: boolean;
+        applied: number;
+        errors: string[];
+    }>;
+    /**
+     * Validate that all required connection references have connections assigned
+     */
+    validateConnectionReferences(logicalNames: string[]): Promise<{
+        valid: boolean;
+        missing: string[];
+    }>;
+    /**
+     * List all environment variable definitions in the environment
+     */
+    listEnvironmentVariables(): Promise<EnvironmentVariableDefinitionRecord[]>;
+    /**
+     * Get an environment variable definition by schema name
+     */
+    getEnvironmentVariableBySchemaName(schemaName: string): Promise<EnvironmentVariableDefinitionRecord | null>;
+    /**
+     * Get the current value of an environment variable
+     */
+    getEnvironmentVariableValue(definitionId: string): Promise<string | null>;
+    /**
+     * Set the value of an environment variable
+     * Creates a new value record if none exists, updates if it does
+     */
+    setEnvironmentVariableValue(schemaName: string, value: string | number | boolean): Promise<void>;
+    /**
+     * Apply environment variable values to the environment
+     */
+    applyEnvironmentVariables(variables: EnvironmentVariable[]): Promise<{
+        success: boolean;
+        applied: number;
+        errors: string[];
+    }>;
+    /**
+     * Get current values for all environment variables (for snapshot/rollback)
+     */
+    getCurrentEnvironmentVariableValues(): Promise<Map<string, {
+        definitionId: string;
+        value: string | null;
+    }>>;
+}
+//# sourceMappingURL=connection-refs.d.ts.map

package/dist/dataverse/connection-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-refs.d.ts","sourceRoot":"","sources":["../../src/dataverse/connection-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8BAA8B,EAAE,MAAM,CAAC;IACvC,8BAA8B,EAAE,MAAM,CAAC;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,+BAA+B,EAAE,MAAM,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0BAA0B,EAAE,MAAM,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B,EAAE,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAM3C;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAYtE;;OAEG;IACG,mCAAmC,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAY5C;;OAEG;IACG,yBAAyB,CAC7B,qBAAqB,EAAE,MAAM,EAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,uBAAuB,CAC3B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAqCnE;;OAEG;IACG,4BAA4B,CAChC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAuBjD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,mCAAmC,EAAE,CAAC;IAWhF;;OAEG;IACG,kCAAkC,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mCAAmC,GAAG,IAAI,CAAC;IAWtD;;OAEG;IACG,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW/E;;;OAGG;IACG,2BAA2B,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAC/B,OAAO,CAAC,IAAI,CAAC;IAmChB;;OAEG;IACG,yBAAyB,CAC7B,SAAS,EAAE,mBAAmB,EAAE,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAwBnE;;OAEG;IACG,mCAAmC,IAAI,OAAO,CAClD,GAAG,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAC5D;CAcF"}