@microsoft/terraform-cdk-constructs 1.2.0 → 1.3.0

package/lib/core-azure/lib/azapi/resource-schema-validator.d.ts

@@ -0,0 +1,118 @@
+/**
+ * ResourceSchemaValidator - Helper class for schema validation
+ *
+ * This helper class extracts validation logic from AzapiResource to follow
+ * the Single Responsibility Principle. It handles property validation against
+ * API schemas and provides detailed error reporting.
+ *
+ * @internal
+ * @packageDocumentation
+ */
+import { ApiSchema, ValidationResult } from "../version-manager/interfaces/version-interfaces";
+/**
+ * Helper class for validating resource properties against API schemas
+ *
+ * This class encapsulates all validation-related operations including:
+ * - Schema-based property validation
+ * - Default value application
+ * - Validation error formatting
+ * - Integration with SchemaMapper
+ *
+ * @internal
+ */
+export declare class ResourceSchemaValidator {
+    private readonly _schema;
+    private readonly _schemaMapper;
+    /**
+     * Creates a new ResourceSchemaValidator instance
+     *
+     * @param schema - The API schema to validate against
+     */
+    constructor(schema: ApiSchema);
+    /**
+     * Validates properties against the configured schema
+     *
+     * This method performs comprehensive validation including:
+     * - Required property checks
+     * - Type validation
+     * - Custom validation rules
+     * - Deprecation warnings
+     *
+     * @param properties - The properties to validate
+     * @returns Detailed validation results with errors and warnings
+     */
+    validateProps(properties: any): ValidationResult;
+    /**
+     * Validates the schema structure itself
+     *
+     * This method checks if the schema is properly configured and has all
+     * required fields for validation to work correctly.
+     *
+     * @returns Validation result indicating if schema is valid
+     */
+    validateSchema(): ValidationResult;
+    /**
+     * Applies default values to properties based on schema definitions
+     *
+     * This method injects default values for properties that are not provided
+     * but have defaults defined in the schema.
+     *
+     * @param properties - The properties to apply defaults to
+     * @returns New properties object with default values applied
+     */
+    applyDefaults(properties: any): any;
+    /**
+     * Formats validation errors into user-friendly messages
+     *
+     * This method takes a validation result and formats the errors
+     * into clear, actionable error messages.
+     *
+     * @param validationResult - The validation result to format
+     * @returns Array of formatted error messages
+     */
+    formatValidationErrors(validationResult: ValidationResult): string[];
+    /**
+     * Gets the schema this validator is configured for
+     *
+     * @returns The API schema being used for validation
+     */
+    get schema(): ApiSchema;
+    /**
+     * Gets the resource type from the schema
+     *
+     * @returns The Azure resource type string
+     */
+    get resourceType(): string;
+    /**
+     * Gets the API version from the schema
+     *
+     * @returns The API version string
+     */
+    get version(): string;
+    /**
+     * Checks if a specific property is required
+     *
+     * @param propertyName - The name of the property to check
+     * @returns True if the property is required, false otherwise
+     */
+    isPropertyRequired(propertyName: string): boolean;
+    /**
+     * Checks if a specific property is deprecated
+     *
+     * @param propertyName - The name of the property to check
+     * @returns True if the property is deprecated, false otherwise
+     */
+    isPropertyDeprecated(propertyName: string): boolean;
+    /**
+     * Gets the list of all required properties
+     *
+     * @returns Array of required property names
+     */
+    getRequiredProperties(): string[];
+    /**
+     * Gets the list of all deprecated properties
+     *
+     * @returns Array of deprecated property names
+     */
+    getDeprecatedProperties(): string[];
+}

package/lib/core-azure/lib/azapi/resource-schema-validator.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * ResourceSchemaValidator - Helper class for schema validation
+ *
+ * This helper class extracts validation logic from AzapiResource to follow
+ * the Single Responsibility Principle. It handles property validation against
+ * API schemas and provides detailed error reporting.
+ *
+ * @internal
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceSchemaValidator = void 0;
+const schema_mapper_1 = require("./schema-mapper/schema-mapper");
+/**
+ * Helper class for validating resource properties against API schemas
+ *
+ * This class encapsulates all validation-related operations including:
+ * - Schema-based property validation
+ * - Default value application
+ * - Validation error formatting
+ * - Integration with SchemaMapper
+ *
+ * @internal
+ */
+class ResourceSchemaValidator {
+    /**
+     * Creates a new ResourceSchemaValidator instance
+     *
+     * @param schema - The API schema to validate against
+     */
+    constructor(schema) {
+        if (!schema) {
+            throw new Error("Schema cannot be undefined or null");
+        }
+        if (!schema.resourceType || schema.resourceType.trim().length === 0) {
+            throw new Error("Schema must have a valid resourceType");
+        }
+        if (!schema.version || schema.version.trim().length === 0) {
+            throw new Error("Schema must have a valid version");
+        }
+        this._schema = schema;
+        this._schemaMapper = schema_mapper_1.SchemaMapper.create(schema);
+    }
+    /**
+     * Validates properties against the configured schema
+     *
+     * This method performs comprehensive validation including:
+     * - Required property checks
+     * - Type validation
+     * - Custom validation rules
+     * - Deprecation warnings
+     *
+     * @param properties - The properties to validate
+     * @returns Detailed validation results with errors and warnings
+     */
+    validateProps(properties) {
+        if (!properties) {
+            return {
+                valid: false,
+                errors: ["Properties cannot be undefined or null"],
+                warnings: [],
+            };
+        }
+        try {
+            return this._schemaMapper.validateProperties(properties);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [
+                    `Validation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+                ],
+                warnings: [],
+            };
+        }
+    }
+    /**
+     * Validates the schema structure itself
+     *
+     * This method checks if the schema is properly configured and has all
+     * required fields for validation to work correctly.
+     *
+     * @returns Validation result indicating if schema is valid
+     */
+    validateSchema() {
+        const errors = [];
+        const warnings = [];
+        // Check for required schema fields
+        if (!this._schema.resourceType) {
+            errors.push("Schema is missing resourceType");
+        }
+        if (!this._schema.version) {
+            errors.push("Schema is missing version");
+        }
+        if (!this._schema.properties) {
+            errors.push("Schema is missing properties definition");
+        }
+        if (!this._schema.required) {
+            errors.push("Schema is missing required properties array");
+        }
+        // Check for potential issues
+        if (this._schema.required &&
+            Array.isArray(this._schema.required) &&
+            this._schema.required.length === 0) {
+            warnings.push("Schema has no required properties defined");
+        }
+        if (this._schema.properties &&
+            Object.keys(this._schema.properties).length === 0) {
+            warnings.push("Schema has no properties defined");
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Applies default values to properties based on schema definitions
+     *
+     * This method injects default values for properties that are not provided
+     * but have defaults defined in the schema.
+     *
+     * @param properties - The properties to apply defaults to
+     * @returns New properties object with default values applied
+     */
+    applyDefaults(properties) {
+        if (!properties) {
+            properties = {};
+        }
+        try {
+            return this._schemaMapper.applyDefaults(properties);
+        }
+        catch (error) {
+            throw new Error(`Failed to apply defaults: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Formats validation errors into user-friendly messages
+     *
+     * This method takes a validation result and formats the errors
+     * into clear, actionable error messages.
+     *
+     * @param validationResult - The validation result to format
+     * @returns Array of formatted error messages
+     */
+    formatValidationErrors(validationResult) {
+        const formattedErrors = [];
+        // Add general errors
+        formattedErrors.push(...validationResult.errors);
+        // Add property-specific errors with context
+        if (validationResult.propertyErrors) {
+            for (const [property, errors] of Object.entries(validationResult.propertyErrors)) {
+                for (const error of errors) {
+                    formattedErrors.push(`[${property}] ${error}`);
+                }
+            }
+        }
+        return formattedErrors;
+    }
+    /**
+     * Gets the schema this validator is configured for
+     *
+     * @returns The API schema being used for validation
+     */
+    get schema() {
+        return this._schema;
+    }
+    /**
+     * Gets the resource type from the schema
+     *
+     * @returns The Azure resource type string
+     */
+    get resourceType() {
+        return this._schema.resourceType;
+    }
+    /**
+     * Gets the API version from the schema
+     *
+     * @returns The API version string
+     */
+    get version() {
+        return this._schema.version;
+    }
+    /**
+     * Checks if a specific property is required
+     *
+     * @param propertyName - The name of the property to check
+     * @returns True if the property is required, false otherwise
+     */
+    isPropertyRequired(propertyName) {
+        if (!this._schema.required || !Array.isArray(this._schema.required)) {
+            return false;
+        }
+        return this._schema.required.includes(propertyName);
+    }
+    /**
+     * Checks if a specific property is deprecated
+     *
+     * @param propertyName - The name of the property to check
+     * @returns True if the property is deprecated, false otherwise
+     */
+    isPropertyDeprecated(propertyName) {
+        if (!this._schema.properties) {
+            return false;
+        }
+        const propDef = this._schema.properties[propertyName];
+        return propDef ? propDef.deprecated === true : false;
+    }
+    /**
+     * Gets the list of all required properties
+     *
+     * @returns Array of required property names
+     */
+    getRequiredProperties() {
+        if (!this._schema.required || !Array.isArray(this._schema.required)) {
+            return [];
+        }
+        return [...this._schema.required];
+    }
+    /**
+     * Gets the list of all deprecated properties
+     *
+     * @returns Array of deprecated property names
+     */
+    getDeprecatedProperties() {
+        if (!this._schema.properties) {
+            return [];
+        }
+        return Object.entries(this._schema.properties)
+            .filter(([_, propDef]) => propDef.deprecated === true)
+            .map(([propName]) => propName);
+    }
+}
+exports.ResourceSchemaValidator = ResourceSchemaValidator;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb3VyY2Utc2NoZW1hLXZhbGlkYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb3JlLWF6dXJlL2xpYi9hemFwaS9yZXNvdXJjZS1zY2hlbWEtdmFsaWRhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7O0dBU0c7OztBQUVILGlFQUE2RDtBQU03RDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBYSx1QkFBdUI7SUFJbEM7Ozs7T0FJRztJQUNILFlBQVksTUFBaUI7UUFDM0IsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ1osTUFBTSxJQUFJLEtBQUssQ0FBQyxvQ0FBb0MsQ0FBQyxDQUFDO1FBQ3hELENBQUM7UUFFRCxJQUFJLENBQUMsTUFBTSxDQUFDLFlBQVksSUFBSSxNQUFNLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUNwRSxNQUFNLElBQUksS0FBSyxDQUFDLHVDQUF1QyxDQUFDLENBQUM7UUFDM0QsQ0FBQztRQUVELElBQUksQ0FBQyxNQUFNLENBQUMsT0FBTyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQzFELE1BQU0sSUFBSSxLQUFLLENBQUMsa0NBQWtDLENBQUMsQ0FBQztRQUN0RCxDQUFDO1FBRUQsSUFBSSxDQUFDLE9BQU8sR0FBRyxNQUFNLENBQUM7UUFDdEIsSUFBSSxDQUFDLGFBQWEsR0FBRyw0QkFBWSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNuRCxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7O09BV0c7SUFDSSxhQUFhLENBQUMsVUFBZTtRQUNsQyxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDaEIsT0FBTztnQkFDTCxLQUFLLEVBQUUsS0FBSztnQkFDWixNQUFNLEVBQUUsQ0FBQyx3Q0FBd0MsQ0FBQztnQkFD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QVUsRUFBRSxDQUFDO1lBQzdCLE9BQU8sS0FBSyxDQUFDO1FBQ2YsQ0FBQztRQUVELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQ3RELE9BQU8sT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsVUFBVSxLQUFLLElBQUksQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDO0lBQ3ZELENBQUM7SUFFRDs7OztPQUlHO0lBQ0kscUJBQXFCO1FBQzFCLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQ3BFLE9BQU8sRUFBRSxDQUFDO1FBQ1osQ0FBQztRQUVELE9BQU8sQ0FBQyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDcEMsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSx1QkFBdUI7UUFDNUIsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDN0IsT0FBTyxFQUFFLENBQUM7UUFDWixDQUFDO1FBRUQsT0FBTyxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDO2FBQzNDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLE9BQU8sQ0FBQyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsVUFBVSxLQUFLLElBQUksQ0FBQzthQUNyRCxHQUFHLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUNuQyxDQUFDO0NBQ0Y7QUF2UEQsMERBdVBDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBSZXNvdXJjZVNjaGVtYVZhbGlkYXRvciAtIEhlbHBlciBjbGFzcyBmb3Igc2NoZW1hIHZhbGlkYXRpb25cbiAqXG4gKiBUaGlzIGhlbHBlciBjbGFzcyBleHRyYWN0cyB2YWxpZGF0aW9uIGxvZ2ljIGZyb20gQXphcGlSZXNvdXJjZSB0byBmb2xsb3dcbiAqIHRoZSBTaW5nbGUgUmVzcG9uc2liaWxpdHkgUHJpbmNpcGxlLiBJdCBoYW5kbGVzIHByb3BlcnR5IHZhbGlkYXRpb24gYWdhaW5zdFxuICogQVBJIHNjaGVtYXMgYW5kIHByb3ZpZGVzIGRldGFpbGVkIGVycm9yIHJlcG9ydGluZy5cbiAqXG4gKiBAaW50ZXJuYWxcbiAqIEBwYWNrYWdlRG9jdW1lbnRhdGlvblxuICovXG5cbmltcG9ydCB7IFNjaGVtYU1hcHBlciB9IGZyb20gXCIuL3NjaGVtYS1tYXBwZXIvc2NoZW1hLW1hcHBlclwiO1xuaW1wb3J0IHtcbiAgQXBpU2NoZW1hLFxuICBWYWxpZGF0aW9uUmVzdWx0LFxufSBmcm9tIFwiLi4vdmVyc2lvbi1tYW5hZ2VyL2ludGVyZmFjZXMvdmVyc2lvbi1pbnRlcmZhY2VzXCI7XG5cbi8qKlxuICogSGVscGVyIGNsYXNzIGZvciB2YWxpZGF0aW5nIHJlc291cmNlIHByb3BlcnRpZXMgYWdhaW5zdCBBUEkgc2NoZW1hc1xuICpcbiAqIFRoaXMgY2xhc3MgZW5jYXBzdWxhdGVzIGFsbCB2YWxpZGF0aW9uLXJlbGF0ZWQgb3BlcmF0aW9ucyBpbmNsdWRpbmc6XG4gKiAtIFNjaGVtYS1iYXNlZCBwcm9wZXJ0eSB2YWxpZGF0aW9uXG4gKiAtIERlZmF1bHQgdmFsdWUgYXBwbGljYXRpb25cbiAqIC0gVmFsaWRhdGlvbiBlcnJvciBmb3JtYXR0aW5nXG4gKiAtIEludGVncmF0aW9uIHdpdGggU2NoZW1hTWFwcGVyXG4gKlxuICogQGludGVybmFsXG4gKi9cbmV4cG9ydCBjbGFzcyBSZXNvdXJjZVNjaGVtYVZhbGlkYXRvciB7XG4gIHByaXZhdGUgcmVhZG9ubHkgX3NjaGVtYTogQXBpU2NoZW1hO1xuICBwcml2YXRlIHJlYWRvbmx5IF9zY2hlbWFNYXBwZXI6IFNjaGVtYU1hcHBlcjtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBSZXNvdXJjZVNjaGVtYVZhbGlkYXRvciBpbnN0YW5jZVxuICAgKlxuICAgKiBAcGFyYW0gc2NoZW1hIC0gVGhlIEFQSSBzY2hlbWEgdG8gdmFsaWRhdGUgYWdhaW5zdFxuICAgKi9cbiAgY29uc3RydWN0b3Ioc2NoZW1hOiBBcGlTY2hlbWEpIHtcbiAgICBpZiAoIXNjaGVtYSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFwiU2NoZW1hIGNhbm5vdCBiZSB1bmRlZmluZWQgb3IgbnVsbFwiKTtcbiAgICB9XG5cbiAgICBpZiAoIXNjaGVtYS5yZXNvdXJjZVR5cGUgfHwgc2NoZW1hLnJlc291cmNlVHlwZS50cmltKCkubGVuZ3RoID09PSAwKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXCJTY2hlbWEgbXVzdCBoYXZlIGEgdmFsaWQgcmVzb3VyY2VUeXBlXCIpO1xuICAgIH1cblxuICAgIGlmICghc2NoZW1hLnZlcnNpb24gfHwgc2NoZW1hLnZlcnNpb24udHJpbSgpLmxlbmd0aCA9PT0gMCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFwiU2NoZW1hIG11c3QgaGF2ZSBhIHZhbGlkIHZlcnNpb25cIik7XG4gICAgfVxuXG4gICAgdGhpcy5fc2NoZW1hID0gc2NoZW1hO1xuICAgIHRoaXMuX3NjaGVtYU1hcHBlciA9IFNjaGVtYU1hcHBlci5jcmVhdGUoc2NoZW1hKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBWYWxpZGF0ZXMgcHJvcGVydGllcyBhZ2FpbnN0IHRoZSBjb25maWd1cmVkIHNjaGVtYVxuICAgKlxuICAgKiBUaGlzIG1ldGhvZCBwZXJmb3JtcyBjb21wcmVoZW5zaXZlIHZhbGlkYXRpb24gaW5jbHVkaW5nOlxuICAgKiAtIFJlcXVpcmVkIHByb3BlcnR5IGNoZWNrc1xuICAgKiAtIFR5cGUgdmFsaWRhdGlvblxuICAgKiAtIEN1c3RvbSB2YWxpZGF0aW9uIHJ1bGVzXG4gICAqIC0gRGVwcmVjYXRpb24gd2FybmluZ3NcbiAgICpcbiAgICogQHBhcmFtIHByb3BlcnRpZXMgLSBUaGUgcHJvcGVydGllcyB0byB2YWxpZGF0ZVxuICAgKiBAcmV0dXJucyBEZXRhaWxlZCB2YWxpZGF0aW9uIHJlc3VsdHMgd2l0aCBlcnJvcnMgYW5kIHdhcm5pbmdzXG4gICAqL1xuICBwdWJsaWMgdmFsaWRhdGVQcm9wcyhwcm9wZXJ0aWVzOiBhbnkpOiBWYWxpZGF0aW9uUmVzdWx0IHtcbiAgICBpZiAoIXByb3BlcnRpZXMpIHtcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHZhbGlkOiBmYWxzZSxcbiAgICAgICAgZXJyb3JzOiBbXCJQcm9wZXJ0aWVzIGNhbm5vdCBiZSB1bmRlZmluZWQgb3IgbnVsbFwiXSxcbiAgICAgICAgd2FybmluZ3M6IFtdLFxuICAgICAgfTtcbiAgICB9XG5cbiAgICB0cnkge1xuICAgICAgcmV0dXJuIHRoaXMuX3NjaGVtYU1hcHBlci52YWxpZGF0ZVByb3BlcnRpZXMocHJvcGVydGllcyk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHZhbGlkOiBmYWxzZSxcbiAgICAgICAgZXJyb3JzOiBbXG4gICAgICAgICAgYFZhbGlkYXRpb24gZmFpbGVkOiAke2Vycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvci5tZXNzYWdlIDogXCJVbmtub3duIGVycm9yXCJ9YCxcbiAgICAgICAgXSxcbiAgICAgICAgd2FybmluZ3M6IFtdLFxuICAgICAgfTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogVmFsaWRhdGVzIHRoZSBzY2hlbWEgc3RydWN0dXJlIGl0c2VsZlxuICAgKlxuICAgKiBUaGlzIG1ldGhvZCBjaGVja3MgaWYgdGhlIHNjaGVtYSBpcyBwcm9wZXJseSBjb25maWd1cmVkIGFuZCBoYXMgYWxsXG4gICAqIHJlcXVpcmVkIGZpZWxkcyBmb3IgdmFsaWRhdGlvbiB0byB3b3JrIGNvcnJlY3RseS5cbiAgICpcbiAgICogQHJldHVybnMgVmFsaWRhdGlvbiByZXN1bHQgaW5kaWNhdGluZyBpZiBzY2hlbWEgaXMgdmFsaWRcbiAgICovXG4gIHB1YmxpYyB2YWxpZGF0ZVNjaGVtYSgpOiBWYWxpZGF0aW9uUmVzdWx0IHtcbiAgICBjb25zdCBlcnJvcnM6IHN0cmluZ1tdID0gW107XG4gICAgY29uc3Qgd2FybmluZ3M6IHN0cmluZ1tdID0gW107XG5cbiAgICAvLyBDaGVjayBmb3IgcmVxdWlyZWQgc2NoZW1hIGZpZWxkc1xuICAgIGlmICghdGhpcy5fc2NoZW1hLnJlc291cmNlVHlwZSkge1xuICAgICAgZXJyb3JzLnB1c2goXCJTY2hlbWEgaXMgbWlzc2luZyByZXNvdXJjZVR5cGVcIik7XG4gICAgfVxuXG4gICAgaWYgKCF0aGlzLl9zY2hlbWEudmVyc2lvbikge1xuICAgICAgZXJyb3JzLnB1c2goXCJTY2hlbWEgaXMgbWlzc2luZyB2ZXJzaW9uXCIpO1xuICAgIH1cblxuICAgIGlmICghdGhpcy5fc2NoZW1hLnByb3BlcnRpZXMpIHtcbiAgICAgIGVycm9ycy5wdXNoKFwiU2NoZW1hIGlzIG1pc3NpbmcgcHJvcGVydGllcyBkZWZpbml0aW9uXCIpO1xuICAgIH1cblxuICAgIGlmICghdGhpcy5fc2NoZW1hLnJlcXVpcmVkKSB7XG4gICAgICBlcnJvcnMucHVzaChcIlNjaGVtYSBpcyBtaXNzaW5nIHJlcXVpcmVkIHByb3BlcnRpZXMgYXJyYXlcIik7XG4gICAgfVxuXG4gICAgLy8gQ2hlY2sgZm9yIHBvdGVudGlhbCBpc3N1ZXNcbiAgICBpZiAoXG4gICAgICB0aGlzLl9zY2hlbWEucmVxdWlyZWQgJiZcbiAgICAgIEFycmF5LmlzQXJyYXkodGhpcy5fc2NoZW1hLnJlcXVpcmVkKSAmJlxuICAgICAgdGhpcy5fc2NoZW1hLnJlcXVpcmVkLmxlbmd0aCA9PT0gMFxuICAgICkge1xuICAgICAgd2FybmluZ3MucHVzaChcIlNjaGVtYSBoYXMgbm8gcmVxdWlyZWQgcHJvcGVydGllcyBkZWZpbmVkXCIpO1xuICAgIH1cblxuICAgIGlmIChcbiAgICAgIHRoaXMuX3NjaGVtYS5wcm9wZXJ0aWVzICYmXG4gICAgICBPYmplY3Qua2V5cyh0aGlzLl9zY2hlbWEucHJvcGVydGllcykubGVuZ3RoID09PSAwXG4gICAgKSB7XG4gICAgICB3YXJuaW5ncy5wdXNoKFwiU2NoZW1hIGhhcyBubyBwcm9wZXJ0aWVzIGRlZmluZWRcIik7XG4gICAgfVxuXG4gICAgcmV0dXJuIHtcbiAgICAgIHZhbGlkOiBlcnJvcnMubGVuZ3RoID09PSAwLFxuICAgICAgZXJyb3JzLFxuICAgICAgd2FybmluZ3MsXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBBcHBsaWVzIGRlZmF1bHQgdmFsdWVzIHRvIHByb3BlcnRpZXMgYmFzZWQgb24gc2NoZW1hIGRlZmluaXRpb25zXG4gICAqXG4gICAqIFRoaXMgbWV0aG9kIGluamVjdHMgZGVmYXVsdCB2YWx1ZXMgZm9yIHByb3BlcnRpZXMgdGhhdCBhcmUgbm90IHByb3ZpZGVkXG4gICAqIGJ1dCBoYXZlIGRlZmF1bHRzIGRlZmluZWQgaW4gdGhlIHNjaGVtYS5cbiAgICpcbiAgICogQHBhcmFtIHByb3BlcnRpZXMgLSBUaGUgcHJvcGVydGllcyB0byBhcHBseSBkZWZhdWx0cyB0b1xuICAgKiBAcmV0dXJucyBOZXcgcHJvcGVydGllcyBvYmplY3Qgd2l0aCBkZWZhdWx0IHZhbHVlcyBhcHBsaWVkXG4gICAqL1xuICBwdWJsaWMgYXBwbHlEZWZhdWx0cyhwcm9wZXJ0aWVzOiBhbnkpOiBhbnkge1xuICAgIGlmICghcHJvcGVydGllcykge1xuICAgICAgcHJvcGVydGllcyA9IHt9O1xuICAgIH1cblxuICAgIHRyeSB7XG4gICAgICByZXR1cm4gdGhpcy5fc2NoZW1hTWFwcGVyLmFwcGx5RGVmYXVsdHMocHJvcGVydGllcyk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgYEZhaWxlZCB0byBhcHBseSBkZWZhdWx0czogJHtlcnJvciBpbnN0YW5jZW9mIEVycm9yID8gZXJyb3IubWVzc2FnZSA6IFwiVW5rbm93biBlcnJvclwifWAsXG4gICAgICApO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBGb3JtYXRzIHZhbGlkYXRpb24gZXJyb3JzIGludG8gdXNlci1mcmllbmRseSBtZXNzYWdlc1xuICAgKlxuICAgKiBUaGlzIG1ldGhvZCB0YWtlcyBhIHZhbGlkYXRpb24gcmVzdWx0IGFuZCBmb3JtYXRzIHRoZSBlcnJvcnNcbiAgICogaW50byBjbGVhciwgYWN0aW9uYWJsZSBlcnJvciBtZXNzYWdlcy5cbiAgICpcbiAgICogQHBhcmFtIHZhbGlkYXRpb25SZXN1bHQgLSBUaGUgdmFsaWRhdGlvbiByZXN1bHQgdG8gZm9ybWF0XG4gICAqIEByZXR1cm5zIEFycmF5IG9mIGZvcm1hdHRlZCBlcnJvciBtZXNzYWdlc1xuICAgKi9cbiAgcHVibGljIGZvcm1hdFZhbGlkYXRpb25FcnJvcnModmFsaWRhdGlvblJlc3VsdDogVmFsaWRhdGlvblJlc3VsdCk6IHN0cmluZ1tdIHtcbiAgICBjb25zdCBmb3JtYXR0ZWRFcnJvcnM6IHN0cmluZ1tdID0gW107XG5cbiAgICAvLyBBZGQgZ2VuZXJhbCBlcnJvcnNcbiAgICBmb3JtYXR0ZWRFcnJvcnMucHVzaCguLi52YWxpZGF0aW9uUmVzdWx0LmVycm9ycyk7XG5cbiAgICAvLyBBZGQgcHJvcGVydHktc3BlY2lmaWMgZXJyb3JzIHdpdGggY29udGV4dFxuICAgIGlmICh2YWxpZGF0aW9uUmVzdWx0LnByb3BlcnR5RXJyb3JzKSB7XG4gICAgICBmb3IgKGNvbnN0IFtwcm9wZXJ0eSwgZXJyb3JzXSBvZiBPYmplY3QuZW50cmllcyhcbiAgICAgICAgdmFsaWRhdGlvblJlc3VsdC5wcm9wZXJ0eUVycm9ycyxcbiAgICAgICkpIHtcbiAgICAgICAgZm9yIChjb25zdCBlcnJvciBvZiBlcnJvcnMpIHtcbiAgICAgICAgICBmb3JtYXR0ZWRFcnJvcnMucHVzaChgWyR7cHJvcGVydHl9XSAke2Vycm9yfWApO1xuICAgICAgICB9XG4gICAgICB9XG4gICAgfVxuXG4gICAgcmV0dXJuIGZvcm1hdHRlZEVycm9ycztcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBzY2hlbWEgdGhpcyB2YWxpZGF0b3IgaXMgY29uZmlndXJlZCBmb3JcbiAgICpcbiAgICogQHJldHVybnMgVGhlIEFQSSBzY2hlbWEgYmVpbmcgdXNlZCBmb3IgdmFsaWRhdGlvblxuICAgKi9cbiAgcHVibGljIGdldCBzY2hlbWEoKTogQXBpU2NoZW1hIHtcbiAgICByZXR1cm4gdGhpcy5fc2NoZW1hO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIHJlc291cmNlIHR5cGUgZnJvbSB0aGUgc2NoZW1hXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBBenVyZSByZXNvdXJjZSB0eXBlIHN0cmluZ1xuICAgKi9cbiAgcHVibGljIGdldCByZXNvdXJjZVR5cGUoKTogc3RyaW5nIHtcbiAgICByZXR1cm4gdGhpcy5fc2NoZW1hLnJlc291cmNlVHlwZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBBUEkgdmVyc2lvbiBmcm9tIHRoZSBzY2hlbWFcbiAgICpcbiAgICogQHJldHVybnMgVGhlIEFQSSB2ZXJzaW9uIHN0cmluZ1xuICAgKi9cbiAgcHVibGljIGdldCB2ZXJzaW9uKCk6IHN0cmluZyB7XG4gICAgcmV0dXJuIHRoaXMuX3NjaGVtYS52ZXJzaW9uO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrcyBpZiBhIHNwZWNpZmljIHByb3BlcnR5IGlzIHJlcXVpcmVkXG4gICAqXG4gICAqIEBwYXJhbSBwcm9wZXJ0eU5hbWUgLSBUaGUgbmFtZSBvZiB0aGUgcHJvcGVydHkgdG8gY2hlY2tcbiAgICogQHJldHVybnMgVHJ1ZSBpZiB0aGUgcHJvcGVydHkgaXMgcmVxdWlyZWQsIGZhbHNlIG90aGVyd2lzZVxuICAgKi9cbiAgcHVibGljIGlzUHJvcGVydHlSZXF1aXJlZChwcm9wZXJ0eU5hbWU6IHN0cmluZyk6IGJvb2xlYW4ge1xuICAgIGlmICghdGhpcy5fc2NoZW1hLnJlcXVpcmVkIHx8ICFBcnJheS5pc0FycmF5KHRoaXMuX3NjaGVtYS5yZXF1aXJlZCkpIHtcbiAgICAgIHJldHVybiBmYWxzZTtcbiAgICB9XG5cbiAgICByZXR1cm4gdGhpcy5fc2NoZW1hLnJlcXVpcmVkLmluY2x1ZGVzKHByb3BlcnR5TmFtZSk7XG4gIH1cblxuICAvKipcbiAgICogQ2hlY2tzIGlmIGEgc3BlY2lmaWMgcHJvcGVydHkgaXMgZGVwcmVjYXRlZFxuICAgKlxuICAgKiBAcGFyYW0gcHJvcGVydHlOYW1lIC0gVGhlIG5hbWUgb2YgdGhlIHByb3BlcnR5IHRvIGNoZWNrXG4gICAqIEByZXR1cm5zIFRydWUgaWYgdGhlIHByb3BlcnR5IGlzIGRlcHJlY2F0ZWQsIGZhbHNlIG90aGVyd2lzZVxuICAgKi9cbiAgcHVibGljIGlzUHJvcGVydHlEZXByZWNhdGVkKHByb3BlcnR5TmFtZTogc3RyaW5nKTogYm9vbGVhbiB7XG4gICAgaWYgKCF0aGlzLl9zY2hlbWEucHJvcGVydGllcykge1xuICAgICAgcmV0dXJuIGZhbHNlO1xuICAgIH1cblxuICAgIGNvbnN0IHByb3BEZWYgPSB0aGlzLl9zY2hlbWEucHJvcGVydGllc1twcm9wZXJ0eU5hbWVdO1xuICAgIHJldHVybiBwcm9wRGVmID8gcHJvcERlZi5kZXByZWNhdGVkID09PSB0cnVlIDogZmFsc2U7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgbGlzdCBvZiBhbGwgcmVxdWlyZWQgcHJvcGVydGllc1xuICAgKlxuICAgKiBAcmV0dXJucyBBcnJheSBvZiByZXF1aXJlZCBwcm9wZXJ0eSBuYW1lc1xuICAgKi9cbiAgcHVibGljIGdldFJlcXVpcmVkUHJvcGVydGllcygpOiBzdHJpbmdbXSB7XG4gICAgaWYgKCF0aGlzLl9zY2hlbWEucmVxdWlyZWQgfHwgIUFycmF5LmlzQXJyYXkodGhpcy5fc2NoZW1hLnJlcXVpcmVkKSkge1xuICAgICAgcmV0dXJuIFtdO1xuICAgIH1cblxuICAgIHJldHVybiBbLi4udGhpcy5fc2NoZW1hLnJlcXVpcmVkXTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBsaXN0IG9mIGFsbCBkZXByZWNhdGVkIHByb3BlcnRpZXNcbiAgICpcbiAgICogQHJldHVybnMgQXJyYXkgb2YgZGVwcmVjYXRlZCBwcm9wZXJ0eSBuYW1lc1xuICAgKi9cbiAgcHVibGljIGdldERlcHJlY2F0ZWRQcm9wZXJ0aWVzKCk6IHN0cmluZ1tdIHtcbiAgICBpZiAoIXRoaXMuX3NjaGVtYS5wcm9wZXJ0aWVzKSB7XG4gICAgICByZXR1cm4gW107XG4gICAgfVxuXG4gICAgcmV0dXJuIE9iamVjdC5lbnRyaWVzKHRoaXMuX3NjaGVtYS5wcm9wZXJ0aWVzKVxuICAgICAgLmZpbHRlcigoW18sIHByb3BEZWZdKSA9PiBwcm9wRGVmLmRlcHJlY2F0ZWQgPT09IHRydWUpXG4gICAgICAubWFwKChbcHJvcE5hbWVdKSA9PiBwcm9wTmFtZSk7XG4gIH1cbn1cbiJdfQ==

package/lib/core-azure/lib/azapi/resource-version-manager.d.ts

@@ -0,0 +1,103 @@
+/**
+ * ResourceVersionManager - Helper class for managing API version resolution
+ *
+ * This helper class extracts version management logic from AzapiResource to follow
+ * the Single Responsibility Principle. It handles version resolution, validation,
+ * and configuration retrieval.
+ *
+ * @internal
+ * @packageDocumentation
+ */
+import { ApiSchema, VersionConfig } from "../version-manager/interfaces/version-interfaces";
+/**
+ * Helper class for managing API version resolution and configuration
+ *
+ * This class encapsulates all version-related operations including:
+ * - API version resolution (explicit or automatic)
+ * - Version validation against registered versions
+ * - Schema and configuration retrieval
+ * - Latest version resolution
+ *
+ * @internal
+ */
+export declare class ResourceVersionManager {
+    private readonly _apiVersionManager;
+    private readonly _resourceType;
+    private readonly _defaultVersion;
+    /**
+     * Creates a new ResourceVersionManager instance
+     *
+     * @param resourceType - The Azure resource type (e.g., "Microsoft.Resources/resourceGroups")
+     * @param defaultVersion - The default version to use as fallback
+     */
+    constructor(resourceType: string, defaultVersion: string);
+    /**
+     * Resolves the API version to use for a resource instance
+     *
+     * This method implements the version resolution logic:
+     * 1. If explicitVersion is provided, validate and use it
+     * 2. Otherwise, try to get the latest version from ApiVersionManager
+     * 3. If no versions registered, fall back to defaultVersion
+     *
+     * @param explicitVersion - Optional explicit version specified by user
+     * @returns The resolved API version string
+     * @throws Error if explicit version is provided but not supported
+     */
+    resolveApiVersion(explicitVersion?: string): string;
+    /**
+     * Retrieves the version configuration for a specific version
+     *
+     * @param version - The version to retrieve configuration for
+     * @returns The version configuration, or undefined if not found
+     */
+    versionConfig(version: string): VersionConfig | undefined;
+    /**
+     * Retrieves the API schema for a specific version
+     *
+     * @param version - The version to retrieve schema for
+     * @returns The API schema for the version
+     * @throws Error if version configuration or schema cannot be found
+     */
+    schemaForVersion(version: string): ApiSchema;
+    /**
+     * Validates whether a version is supported for the resource type
+     *
+     * @param version - The version to validate
+     * @returns True if the version is supported, false otherwise
+     */
+    validateVersion(version: string): boolean;
+    /**
+     * Retrieves the latest available version for the resource type
+     *
+     * @returns The latest version string, or undefined if none found
+     */
+    latestVersion(): string | undefined;
+    /**
+     * Retrieves all supported versions for the resource type
+     *
+     * @returns Array of supported version strings, sorted by release date (newest first)
+     */
+    supportedVersions(): string[];
+    /**
+     * Checks if the version is deprecated
+     *
+     * @param version - The version to check
+     * @returns True if the version is deprecated or sunset, false otherwise
+     */
+    isDeprecated(version: string): boolean;
+    /**
+     * Checks if the version has reached sunset
+     *
+     * @param version - The version to check
+     * @returns True if the version has reached sunset, false otherwise
+     */
+    isSunset(version: string): boolean;
+    /**
+     * The resource type this manager is configured for
+     */
+    get resourceType(): string;
+    /**
+     * The default version configured for this manager
+     */
+    get defaultVersion(): string;
+}

package/lib/core-azure/lib/azapi/resource-version-manager.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * ResourceVersionManager - Helper class for managing API version resolution
+ *
+ * This helper class extracts version management logic from AzapiResource to follow
+ * the Single Responsibility Principle. It handles version resolution, validation,
+ * and configuration retrieval.
+ *
+ * @internal
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceVersionManager = void 0;
+const api_version_manager_1 = require("../version-manager/api-version-manager");
+const version_interfaces_1 = require("../version-manager/interfaces/version-interfaces");
+/**
+ * Helper class for managing API version resolution and configuration
+ *
+ * This class encapsulates all version-related operations including:
+ * - API version resolution (explicit or automatic)
+ * - Version validation against registered versions
+ * - Schema and configuration retrieval
+ * - Latest version resolution
+ *
+ * @internal
+ */
+class ResourceVersionManager {
+    /**
+     * Creates a new ResourceVersionManager instance
+     *
+     * @param resourceType - The Azure resource type (e.g., "Microsoft.Resources/resourceGroups")
+     * @param defaultVersion - The default version to use as fallback
+     */
+    constructor(resourceType, defaultVersion) {
+        if (!resourceType || resourceType.trim().length === 0) {
+            throw new Error("Resource type cannot be empty");
+        }
+        if (!defaultVersion || defaultVersion.trim().length === 0) {
+            throw new Error("Default version cannot be empty");
+        }
+        this._resourceType = resourceType;
+        this._defaultVersion = defaultVersion;
+        this._apiVersionManager = api_version_manager_1.ApiVersionManager.instance();
+    }
+    /**
+     * Resolves the API version to use for a resource instance
+     *
+     * This method implements the version resolution logic:
+     * 1. If explicitVersion is provided, validate and use it
+     * 2. Otherwise, try to get the latest version from ApiVersionManager
+     * 3. If no versions registered, fall back to defaultVersion
+     *
+     * @param explicitVersion - Optional explicit version specified by user
+     * @returns The resolved API version string
+     * @throws Error if explicit version is provided but not supported
+     */
+    resolveApiVersion(explicitVersion) {
+        if (explicitVersion) {
+            // Validate that the explicit version is supported
+            if (!this.validateVersion(explicitVersion)) {
+                const supportedVersions = this.supportedVersions();
+                throw new Error(`Unsupported API version '${explicitVersion}' for resource type '${this._resourceType}'. ` +
+                    `Supported versions: ${supportedVersions.join(", ")}`);
+            }
+            return explicitVersion;
+        }
+        // Try to get the latest version from the manager
+        const latestVersion = this.latestVersion();
+        if (latestVersion) {
+            return latestVersion;
+        }
+        // Fall back to the default version
+        console.warn(`No versions registered for ${this._resourceType}. ` +
+            `Using default version: ${this._defaultVersion}. ` +
+            `Consider registering versions with ApiVersionManager for better version management.`);
+        return this._defaultVersion;
+    }
+    /**
+     * Retrieves the version configuration for a specific version
+     *
+     * @param version - The version to retrieve configuration for
+     * @returns The version configuration, or undefined if not found
+     */
+    versionConfig(version) {
+        return this._apiVersionManager.versionConfig(this._resourceType, version);
+    }
+    /**
+     * Retrieves the API schema for a specific version
+     *
+     * @param version - The version to retrieve schema for
+     * @returns The API schema for the version
+     * @throws Error if version configuration or schema cannot be found
+     */
+    schemaForVersion(version) {
+        const versionConfig = this.versionConfig(version);
+        if (!versionConfig) {
+            throw new Error(`Cannot resolve schema: version configuration not found for ` +
+                `${this._resourceType}@${version}`);
+        }
+        return versionConfig.schema;
+    }
+    /**
+     * Validates whether a version is supported for the resource type
+     *
+     * @param version - The version to validate
+     * @returns True if the version is supported, false otherwise
+     */
+    validateVersion(version) {
+        return this._apiVersionManager.validateVersionSupport(this._resourceType, version);
+    }
+    /**
+     * Retrieves the latest available version for the resource type
+     *
+     * @returns The latest version string, or undefined if none found
+     */
+    latestVersion() {
+        return this._apiVersionManager.latestVersion(this._resourceType);
+    }
+    /**
+     * Retrieves all supported versions for the resource type
+     *
+     * @returns Array of supported version strings, sorted by release date (newest first)
+     */
+    supportedVersions() {
+        return this._apiVersionManager.supportedVersions(this._resourceType);
+    }
+    /**
+     * Checks if the version is deprecated
+     *
+     * @param version - The version to check
+     * @returns True if the version is deprecated or sunset, false otherwise
+     */
+    isDeprecated(version) {
+        const config = this.versionConfig(version);
+        if (!config) {
+            return false;
+        }
+        return (config.supportLevel === version_interfaces_1.VersionSupportLevel.DEPRECATED ||
+            config.supportLevel === version_interfaces_1.VersionSupportLevel.SUNSET);
+    }
+    /**
+     * Checks if the version has reached sunset
+     *
+     * @param version - The version to check
+     * @returns True if the version has reached sunset, false otherwise
+     */
+    isSunset(version) {
+        const config = this.versionConfig(version);
+        if (!config) {
+            return false;
+        }
+        return config.supportLevel === version_interfaces_1.VersionSupportLevel.SUNSET;
+    }
+    /**
+     * The resource type this manager is configured for
+     */
+    get resourceType() {
+        return this._resourceType;
+    }
+    /**
+     * The default version configured for this manager
+     */
+    get defaultVersion() {
+        return this._defaultVersion;
+    }
+}
+exports.ResourceVersionManager = ResourceVersionManager;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb3VyY2UtdmVyc2lvbi1tYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvcmUtYXp1cmUvbGliL2F6YXBpL3Jlc291cmNlLXZlcnNpb24tbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7OztHQVNHOzs7QUFFSCxnRkFBMkU7QUFDM0UseUZBSTBEO0FBRTFEOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFhLHNCQUFzQjtJQUtqQzs7Ozs7T0FLRztJQUNILFlBQVksWUFBb0IsRUFBRSxjQUFzQjtRQUN0RCxJQUFJLENBQUMsWUFBWSxJQUFJLFlBQVksQ0FBQyxJQUFJLEVBQUUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDdEQsTUFBTSxJQUFJLEtBQUssQ0FBQywrQkFBK0IsQ0FBQyxDQUFDO1FBQ25ELENBQUM7UUFFRCxJQUFJLENBQUMsY0FBYyxJQUFJLGNBQWMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDMUQsTUFBTSxJQUFJLEtBQUssQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO1FBQ3JELENBQUM7UUFFRCxJQUFJLENBQUMsYUFBYSxHQUFHLFlBQVksQ0FBQztRQUNsQyxJQUFJLENBQUMsZUFBZSxHQUFHLGNBQWMsQ0FBQztRQUN0QyxJQUFJLENBQUMsa0JBQWtCLEdBQUcsdUNBQWlCLENBQUMsUUFBUSxFQUFFLENBQUM7SUFDekQsQ0FBQztJQUVEOzs7Ozs7Ozs7OztPQVdHO0lBQ0ksaUJBQWlCLENBQUMsZUFBd0I7UUFDL0MsSUFBSSxlQUFlLEVBQUUsQ0FBQztZQUNwQixrREFBa0Q7WUFDbEQsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLENBQUMsZUFBZSxDQUFDLEVBQUUsQ0FBQztnQkFDM0MsTUFBTSxpQkFBaUIsR0FBRyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztnQkFDbkQsTUFBTSxJQUFJLEtBQUss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KipcbiAqIFJlc291cmNlVmVyc2lvbk1hbmFnZXIgLSBIZWxwZXIgY2xhc3MgZm9yIG1hbmFnaW5nIEFQSSB2ZXJzaW9uIHJlc29sdXRpb25cbiAqXG4gKiBUaGlzIGhlbHBlciBjbGFzcyBleHRyYWN0cyB2ZXJzaW9uIG1hbmFnZW1lbnQgbG9naWMgZnJvbSBBemFwaVJlc291cmNlIHRvIGZvbGxvd1xuICogdGhlIFNpbmdsZSBSZXNwb25zaWJpbGl0eSBQcmluY2lwbGUuIEl0IGhhbmRsZXMgdmVyc2lvbiByZXNvbHV0aW9uLCB2YWxpZGF0aW9uLFxuICogYW5kIGNvbmZpZ3VyYXRpb24gcmV0cmlldmFsLlxuICpcbiAqIEBpbnRlcm5hbFxuICogQHBhY2thZ2VEb2N1bWVudGF0aW9uXG4gKi9cblxuaW1wb3J0IHsgQXBpVmVyc2lvbk1hbmFnZXIgfSBmcm9tIFwiLi4vdmVyc2lvbi1tYW5hZ2VyL2FwaS12ZXJzaW9uLW1hbmFnZXJcIjtcbmltcG9ydCB7XG4gIEFwaVNjaGVtYSxcbiAgVmVyc2lvbkNvbmZpZyxcbiAgVmVyc2lvblN1cHBvcnRMZXZlbCxcbn0gZnJvbSBcIi4uL3ZlcnNpb24tbWFuYWdlci9pbnRlcmZhY2VzL3ZlcnNpb24taW50ZXJmYWNlc1wiO1xuXG4vKipcbiAqIEhlbHBlciBjbGFzcyBmb3IgbWFuYWdpbmcgQVBJIHZlcnNpb24gcmVzb2x1dGlvbiBhbmQgY29uZmlndXJhdGlvblxuICpcbiAqIFRoaXMgY2xhc3MgZW5jYXBzdWxhdGVzIGFsbCB2ZXJzaW9uLXJlbGF0ZWQgb3BlcmF0aW9ucyBpbmNsdWRpbmc6XG4gKiAtIEFQSSB2ZXJzaW9uIHJlc29sdXRpb24gKGV4cGxpY2l0IG9yIGF1dG9tYXRpYylcbiAqIC0gVmVyc2lvbiB2YWxpZGF0aW9uIGFnYWluc3QgcmVnaXN0ZXJlZCB2ZXJzaW9uc1xuICogLSBTY2hlbWEgYW5kIGNvbmZpZ3VyYXRpb24gcmV0cmlldmFsXG4gKiAtIExhdGVzdCB2ZXJzaW9uIHJlc29sdXRpb25cbiAqXG4gKiBAaW50ZXJuYWxcbiAqL1xuZXhwb3J0IGNsYXNzIFJlc291cmNlVmVyc2lvbk1hbmFnZXIge1xuICBwcml2YXRlIHJlYWRvbmx5IF9hcGlWZXJzaW9uTWFuYWdlcjogQXBpVmVyc2lvbk1hbmFnZXI7XG4gIHByaXZhdGUgcmVhZG9ubHkgX3Jlc291cmNlVHlwZTogc3RyaW5nO1xuICBwcml2YXRlIHJlYWRvbmx5IF9kZWZhdWx0VmVyc2lvbjogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IFJlc291cmNlVmVyc2lvbk1hbmFnZXIgaW5zdGFuY2VcbiAgICpcbiAgICogQHBhcmFtIHJlc291cmNlVHlwZSAtIFRoZSBBenVyZSByZXNvdXJjZSB0eXBlIChlLmcuLCBcIk1pY3Jvc29mdC5SZXNvdXJjZXMvcmVzb3VyY2VHcm91cHNcIilcbiAgICogQHBhcmFtIGRlZmF1bHRWZXJzaW9uIC0gVGhlIGRlZmF1bHQgdmVyc2lvbiB0byB1c2UgYXMgZmFsbGJhY2tcbiAgICovXG4gIGNvbnN0cnVjdG9yKHJlc291cmNlVHlwZTogc3RyaW5nLCBkZWZhdWx0VmVyc2lvbjogc3RyaW5nKSB7XG4gICAgaWYgKCFyZXNvdXJjZVR5cGUgfHwgcmVzb3VyY2VUeXBlLnRyaW0oKS5sZW5ndGggPT09IDApIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcIlJlc291cmNlIHR5cGUgY2Fubm90IGJlIGVtcHR5XCIpO1xuICAgIH1cblxuICAgIGlmICghZGVmYXVsdFZlcnNpb24gfHwgZGVmYXVsdFZlcnNpb24udHJpbSgpLmxlbmd0aCA9PT0gMCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFwiRGVmYXVsdCB2ZXJzaW9uIGNhbm5vdCBiZSBlbXB0eVwiKTtcbiAgICB9XG5cbiAgICB0aGlzLl9yZXNvdXJjZVR5cGUgPSByZXNvdXJjZVR5cGU7XG4gICAgdGhpcy5fZGVmYXVsdFZlcnNpb24gPSBkZWZhdWx0VmVyc2lvbjtcbiAgICB0aGlzLl9hcGlWZXJzaW9uTWFuYWdlciA9IEFwaVZlcnNpb25NYW5hZ2VyLmluc3RhbmNlKCk7XG4gIH1cblxuICAvKipcbiAgICogUmVzb2x2ZXMgdGhlIEFQSSB2ZXJzaW9uIHRvIHVzZSBmb3IgYSByZXNvdXJjZSBpbnN0YW5jZVxuICAgKlxuICAgKiBUaGlzIG1ldGhvZCBpbXBsZW1lbnRzIHRoZSB2ZXJzaW9uIHJlc29sdXRpb24gbG9naWM6XG4gICAqIDEuIElmIGV4cGxpY2l0VmVyc2lvbiBpcyBwcm92aWRlZCwgdmFsaWRhdGUgYW5kIHVzZSBpdFxuICAgKiAyLiBPdGhlcndpc2UsIHRyeSB0byBnZXQgdGhlIGxhdGVzdCB2ZXJzaW9uIGZyb20gQXBpVmVyc2lvbk1hbmFnZXJcbiAgICogMy4gSWYgbm8gdmVyc2lvbnMgcmVnaXN0ZXJlZCwgZmFsbCBiYWNrIHRvIGRlZmF1bHRWZXJzaW9uXG4gICAqXG4gICAqIEBwYXJhbSBleHBsaWNpdFZlcnNpb24gLSBPcHRpb25hbCBleHBsaWNpdCB2ZXJzaW9uIHNwZWNpZmllZCBieSB1c2VyXG4gICAqIEByZXR1cm5zIFRoZSByZXNvbHZlZCBBUEkgdmVyc2lvbiBzdHJpbmdcbiAgICogQHRocm93cyBFcnJvciBpZiBleHBsaWNpdCB2ZXJzaW9uIGlzIHByb3ZpZGVkIGJ1dCBub3Qgc3VwcG9ydGVkXG4gICAqL1xuICBwdWJsaWMgcmVzb2x2ZUFwaVZlcnNpb24oZXhwbGljaXRWZXJzaW9uPzogc3RyaW5nKTogc3RyaW5nIHtcbiAgICBpZiAoZXhwbGljaXRWZXJzaW9uKSB7XG4gICAgICAvLyBWYWxpZGF0ZSB0aGF0IHRoZSBleHBsaWNpdCB2ZXJzaW9uIGlzIHN1cHBvcnRlZFxuICAgICAgaWYgKCF0aGlzLnZhbGlkYXRlVmVyc2lvbihleHBsaWNpdFZlcnNpb24pKSB7XG4gICAgICAgIGNvbnN0IHN1cHBvcnRlZFZlcnNpb25zID0gdGhpcy5zdXBwb3J0ZWRWZXJzaW9ucygpO1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgYFVuc3VwcG9ydGVkIEFQSSB2ZXJzaW9uICcke2V4cGxpY2l0VmVyc2lvbn0nIGZvciByZXNvdXJjZSB0eXBlICcke3RoaXMuX3Jlc291cmNlVHlwZX0nLiBgICtcbiAgICAgICAgICAgIGBTdXBwb3J0ZWQgdmVyc2lvbnM6ICR7c3VwcG9ydGVkVmVyc2lvbnMuam9pbihcIiwgXCIpfWAsXG4gICAgICAgICk7XG4gICAgICB9XG4gICAgICByZXR1cm4gZXhwbGljaXRWZXJzaW9uO1xuICAgIH1cblxuICAgIC8vIFRyeSB0byBnZXQgdGhlIGxhdGVzdCB2ZXJzaW9uIGZyb20gdGhlIG1hbmFnZXJcbiAgICBjb25zdCBsYXRlc3RWZXJzaW9uID0gdGhpcy5sYXRlc3RWZXJzaW9uKCk7XG4gICAgaWYgKGxhdGVzdFZlcnNpb24pIHtcbiAgICAgIHJldHVybiBsYXRlc3RWZXJzaW9uO1xuICAgIH1cblxuICAgIC8vIEZhbGwgYmFjayB0byB0aGUgZGVmYXVsdCB2ZXJzaW9uXG4gICAgY29uc29sZS53YXJuKFxuICAgICAgYE5vIHZlcnNpb25zIHJlZ2lzdGVyZWQgZm9yICR7dGhpcy5fcmVzb3VyY2VUeXBlfS4gYCArXG4gICAgICAgIGBVc2luZyBkZWZhdWx0IHZlcnNpb246ICR7dGhpcy5fZGVmYXVsdFZlcnNpb259LiBgICtcbiAgICAgICAgYENvbnNpZGVyIHJlZ2lzdGVyaW5nIHZlcnNpb25zIHdpdGggQXBpVmVyc2lvbk1hbmFnZXIgZm9yIGJldHRlciB2ZXJzaW9uIG1hbmFnZW1lbnQuYCxcbiAgICApO1xuXG4gICAgcmV0dXJuIHRoaXMuX2RlZmF1bHRWZXJzaW9uO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHJpZXZlcyB0aGUgdmVyc2lvbiBjb25maWd1cmF0aW9uIGZvciBhIHNwZWNpZmljIHZlcnNpb25cbiAgICpcbiAgICogQHBhcmFtIHZlcnNpb24gLSBUaGUgdmVyc2lvbiB0byByZXRyaWV2ZSBjb25maWd1cmF0aW9uIGZvclxuICAgKiBAcmV0dXJucyBUaGUgdmVyc2lvbiBjb25maWd1cmF0aW9uLCBvciB1bmRlZmluZWQgaWYgbm90IGZvdW5kXG4gICAqL1xuICBwdWJsaWMgdmVyc2lvbkNvbmZpZyh2ZXJzaW9uOiBzdHJpbmcpOiBWZXJzaW9uQ29uZmlnIHwgdW5kZWZpbmVkIHtcbiAgICByZXR1cm4gdGhpcy5fYXBpVmVyc2lvbk1hbmFnZXIudmVyc2lvbkNvbmZpZyh0aGlzLl9yZXNvdXJjZVR5cGUsIHZlcnNpb24pO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHJpZXZlcyB0aGUgQVBJIHNjaGVtYSBmb3IgYSBzcGVjaWZpYyB2ZXJzaW9uXG4gICAqXG4gICAqIEBwYXJhbSB2ZXJzaW9uIC0gVGhlIHZlcnNpb24gdG8gcmV0cmlldmUgc2NoZW1hIGZvclxuICAgKiBAcmV0dXJucyBUaGUgQVBJIHNjaGVtYSBmb3IgdGhlIHZlcnNpb25cbiAgICogQHRocm93cyBFcnJvciBpZiB2ZXJzaW9uIGNvbmZpZ3VyYXRpb24gb3Igc2NoZW1hIGNhbm5vdCBiZSBmb3VuZFxuICAgKi9cbiAgcHVibGljIHNjaGVtYUZvclZlcnNpb24odmVyc2lvbjogc3RyaW5nKTogQXBpU2NoZW1hIHtcbiAgICBjb25zdCB2ZXJzaW9uQ29uZmlnID0gdGhpcy52ZXJzaW9uQ29uZmlnKHZlcnNpb24pO1xuXG4gICAgaWYgKCF2ZXJzaW9uQ29uZmlnKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBDYW5ub3QgcmVzb2x2ZSBzY2hlbWE6IHZlcnNpb24gY29uZmlndXJhdGlvbiBub3QgZm91bmQgZm9yIGAgK1xuICAgICAgICAgIGAke3RoaXMuX3Jlc291cmNlVHlwZX1AJHt2ZXJzaW9ufWAsXG4gICAgICApO1xuICAgIH1cblxuICAgIHJldHVybiB2ZXJzaW9uQ29uZmlnLnNjaGVtYTtcbiAgfVxuXG4gIC8qKlxuICAgKiBWYWxpZGF0ZXMgd2hldGhlciBhIHZlcnNpb24gaXMgc3VwcG9ydGVkIGZvciB0aGUgcmVzb3VyY2UgdHlwZVxuICAgKlxuICAgKiBAcGFyYW0gdmVyc2lvbiAtIFRoZSB2ZXJzaW9uIHRvIHZhbGlkYXRlXG4gICAqIEByZXR1cm5zIFRydWUgaWYgdGhlIHZlcnNpb24gaXMgc3VwcG9ydGVkLCBmYWxzZSBvdGhlcndpc2VcbiAgICovXG4gIHB1YmxpYyB2YWxpZGF0ZVZlcnNpb24odmVyc2lvbjogc3RyaW5nKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuX2FwaVZlcnNpb25NYW5hZ2VyLnZhbGlkYXRlVmVyc2lvblN1cHBvcnQoXG4gICAgICB0aGlzLl9yZXNvdXJjZVR5cGUsXG4gICAgICB2ZXJzaW9uLFxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogUmV0cmlldmVzIHRoZSBsYXRlc3QgYXZhaWxhYmxlIHZlcnNpb24gZm9yIHRoZSByZXNvdXJjZSB0eXBlXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBsYXRlc3QgdmVyc2lvbiBzdHJpbmcsIG9yIHVuZGVmaW5lZCBpZiBub25lIGZvdW5kXG4gICAqL1xuICBwdWJsaWMgbGF0ZXN0VmVyc2lvbigpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICAgIHJldHVybiB0aGlzLl9hcGlWZXJzaW9uTWFuYWdlci5sYXRlc3RWZXJzaW9uKHRoaXMuX3Jlc291cmNlVHlwZSk7XG4gIH1cblxuICAvKipcbiAgICogUmV0cmlldmVzIGFsbCBzdXBwb3J0ZWQgdmVyc2lvbnMgZm9yIHRoZSByZXNvdXJjZSB0eXBlXG4gICAqXG4gICAqIEByZXR1cm5zIEFycmF5IG9mIHN1cHBvcnRlZCB2ZXJzaW9uIHN0cmluZ3MsIHNvcnRlZCBieSByZWxlYXNlIGRhdGUgKG5ld2VzdCBmaXJzdClcbiAgICovXG4gIHB1YmxpYyBzdXBwb3J0ZWRWZXJzaW9ucygpOiBzdHJpbmdbXSB7XG4gICAgcmV0dXJuIHRoaXMuX2FwaVZlcnNpb25NYW5hZ2VyLnN1cHBvcnRlZFZlcnNpb25zKHRoaXMuX3Jlc291cmNlVHlwZSk7XG4gIH1cblxuICAvKipcbiAgICogQ2hlY2tzIGlmIHRoZSB2ZXJzaW9uIGlzIGRlcHJlY2F0ZWRcbiAgICpcbiAgICogQHBhcmFtIHZlcnNpb24gLSBUaGUgdmVyc2lvbiB0byBjaGVja1xuICAgKiBAcmV0dXJucyBUcnVlIGlmIHRoZSB2ZXJzaW9uIGlzIGRlcHJlY2F0ZWQgb3Igc3Vuc2V0LCBmYWxzZSBvdGhlcndpc2VcbiAgICovXG4gIHB1YmxpYyBpc0RlcHJlY2F0ZWQodmVyc2lvbjogc3RyaW5nKTogYm9vbGVhbiB7XG4gICAgY29uc3QgY29uZmlnID0gdGhpcy52ZXJzaW9uQ29uZmlnKHZlcnNpb24pO1xuICAgIGlmICghY29uZmlnKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgcmV0dXJuIChcbiAgICAgIGNvbmZpZy5zdXBwb3J0TGV2ZWwgPT09IFZlcnNpb25TdXBwb3J0TGV2ZWwuREVQUkVDQVRFRCB8fFxuICAgICAgY29uZmlnLnN1cHBvcnRMZXZlbCA9PT0gVmVyc2lvblN1cHBvcnRMZXZlbC5TVU5TRVRcbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrcyBpZiB0aGUgdmVyc2lvbiBoYXMgcmVhY2hlZCBzdW5zZXRcbiAgICpcbiAgICogQHBhcmFtIHZlcnNpb24gLSBUaGUgdmVyc2lvbiB0byBjaGVja1xuICAgKiBAcmV0dXJucyBUcnVlIGlmIHRoZSB2ZXJzaW9uIGhhcyByZWFjaGVkIHN1bnNldCwgZmFsc2Ugb3RoZXJ3aXNlXG4gICAqL1xuICBwdWJsaWMgaXNTdW5zZXQodmVyc2lvbjogc3RyaW5nKTogYm9vbGVhbiB7XG4gICAgY29uc3QgY29uZmlnID0gdGhpcy52ZXJzaW9uQ29uZmlnKHZlcnNpb24pO1xuICAgIGlmICghY29uZmlnKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgcmV0dXJuIGNvbmZpZy5zdXBwb3J0TGV2ZWwgPT09IFZlcnNpb25TdXBwb3J0TGV2ZWwuU1VOU0VUO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSByZXNvdXJjZSB0eXBlIHRoaXMgbWFuYWdlciBpcyBjb25maWd1cmVkIGZvclxuICAgKi9cbiAgcHVibGljIGdldCByZXNvdXJjZVR5cGUoKTogc3RyaW5nIHtcbiAgICByZXR1cm4gdGhpcy5fcmVzb3VyY2VUeXBlO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSBkZWZhdWx0IHZlcnNpb24gY29uZmlndXJlZCBmb3IgdGhpcyBtYW5hZ2VyXG4gICAqL1xuICBwdWJsaWMgZ2V0IGRlZmF1bHRWZXJzaW9uKCk6IHN0cmluZyB7XG4gICAgcmV0dXJuIHRoaXMuX2RlZmF1bHRWZXJzaW9uO1xuICB9XG59XG4iXX0=