@microsoft/terraform-cdk-constructs 0.0.3-pre.7 → 1.2.0

package/lib/core-azure/lib/azapi/azapi-exports.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Convenience exports for commonly used AZAPI provider classes
+ *
+ * This file provides direct imports for frequently used AZAPI classes
+ * without needing to navigate the nested provider structure.
+ */
+export { DataAzapiClientConfig, DataAzapiClientConfigTimeoutsOutputReference, } from "./providers-azapi/data-azapi-client-config";
+export type { DataAzapiClientConfigConfig, DataAzapiClientConfigTimeouts, } from "./providers-azapi/data-azapi-client-config";
+export { DataAzapiResource, DataAzapiResourceIdentityList, DataAzapiResourceIdentityOutputReference, DataAzapiResourceRetryOutputReference, DataAzapiResourceTimeoutsOutputReference, } from "./providers-azapi/data-azapi-resource";
+export type { DataAzapiResourceConfig, DataAzapiResourceIdentity, DataAzapiResourceRetry, DataAzapiResourceTimeouts, } from "./providers-azapi/data-azapi-resource";
+export { Resource, ResourceIdentity, ResourceIdentityList, ResourceIdentityOutputReference, ResourceRetryOutputReference, ResourceTimeoutsOutputReference, } from "./providers-azapi/resource";
+export type { ResourceConfig, ResourceRetry, ResourceTimeouts, } from "./providers-azapi/resource";
+export { ResourceAction, ResourceActionRetryOutputReference, ResourceActionTimeoutsOutputReference, } from "./providers-azapi/resource-action";
+export type { ResourceActionConfig, ResourceActionRetry, ResourceActionTimeouts, } from "./providers-azapi/resource-action";
+export { UpdateResource, UpdateResourceRetryOutputReference, UpdateResourceTimeoutsOutputReference, } from "./providers-azapi/update-resource";
+export type { UpdateResourceConfig, UpdateResourceRetry, UpdateResourceTimeouts, } from "./providers-azapi/update-resource";

package/lib/core-azure/lib/azapi/azapi-exports.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Convenience exports for commonly used AZAPI provider classes
+ *
+ * This file provides direct imports for frequently used AZAPI classes
+ * without needing to navigate the nested provider structure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateResourceTimeoutsOutputReference = exports.UpdateResourceRetryOutputReference = exports.UpdateResource = exports.ResourceActionTimeoutsOutputReference = exports.ResourceActionRetryOutputReference = exports.ResourceAction = exports.ResourceTimeoutsOutputReference = exports.ResourceRetryOutputReference = exports.ResourceIdentityOutputReference = exports.ResourceIdentityList = exports.Resource = exports.DataAzapiResourceTimeoutsOutputReference = exports.DataAzapiResourceRetryOutputReference = exports.DataAzapiResourceIdentityOutputReference = exports.DataAzapiResourceIdentityList = exports.DataAzapiResource = exports.DataAzapiClientConfigTimeoutsOutputReference = exports.DataAzapiClientConfig = void 0;
+// Re-export from data-azapi-client-config
+var data_azapi_client_config_1 = require("./providers-azapi/data-azapi-client-config");
+Object.defineProperty(exports, "DataAzapiClientConfig", { enumerable: true, get: function () { return data_azapi_client_config_1.DataAzapiClientConfig; } });
+Object.defineProperty(exports, "DataAzapiClientConfigTimeoutsOutputReference", { enumerable: true, get: function () { return data_azapi_client_config_1.DataAzapiClientConfigTimeoutsOutputReference; } });
+// Re-export from data-azapi-resource
+var data_azapi_resource_1 = require("./providers-azapi/data-azapi-resource");
+Object.defineProperty(exports, "DataAzapiResource", { enumerable: true, get: function () { return data_azapi_resource_1.DataAzapiResource; } });
+Object.defineProperty(exports, "DataAzapiResourceIdentityList", { enumerable: true, get: function () { return data_azapi_resource_1.DataAzapiResourceIdentityList; } });
+Object.defineProperty(exports, "DataAzapiResourceIdentityOutputReference", { enumerable: true, get: function () { return data_azapi_resource_1.DataAzapiResourceIdentityOutputReference; } });
+Object.defineProperty(exports, "DataAzapiResourceRetryOutputReference", { enumerable: true, get: function () { return data_azapi_resource_1.DataAzapiResourceRetryOutputReference; } });
+Object.defineProperty(exports, "DataAzapiResourceTimeoutsOutputReference", { enumerable: true, get: function () { return data_azapi_resource_1.DataAzapiResourceTimeoutsOutputReference; } });
+// Re-export from resource
+var resource_1 = require("./providers-azapi/resource");
+Object.defineProperty(exports, "Resource", { enumerable: true, get: function () { return resource_1.Resource; } });
+Object.defineProperty(exports, "ResourceIdentityList", { enumerable: true, get: function () { return resource_1.ResourceIdentityList; } });
+Object.defineProperty(exports, "ResourceIdentityOutputReference", { enumerable: true, get: function () { return resource_1.ResourceIdentityOutputReference; } });
+Object.defineProperty(exports, "ResourceRetryOutputReference", { enumerable: true, get: function () { return resource_1.ResourceRetryOutputReference; } });
+Object.defineProperty(exports, "ResourceTimeoutsOutputReference", { enumerable: true, get: function () { return resource_1.ResourceTimeoutsOutputReference; } });
+// Re-export from resource-action
+var resource_action_1 = require("./providers-azapi/resource-action");
+Object.defineProperty(exports, "ResourceAction", { enumerable: true, get: function () { return resource_action_1.ResourceAction; } });
+Object.defineProperty(exports, "ResourceActionRetryOutputReference", { enumerable: true, get: function () { return resource_action_1.ResourceActionRetryOutputReference; } });
+Object.defineProperty(exports, "ResourceActionTimeoutsOutputReference", { enumerable: true, get: function () { return resource_action_1.ResourceActionTimeoutsOutputReference; } });
+// Re-export from update-resource
+var update_resource_1 = require("./providers-azapi/update-resource");
+Object.defineProperty(exports, "UpdateResource", { enumerable: true, get: function () { return update_resource_1.UpdateResource; } });
+Object.defineProperty(exports, "UpdateResourceRetryOutputReference", { enumerable: true, get: function () { return update_resource_1.UpdateResourceRetryOutputReference; } });
+Object.defineProperty(exports, "UpdateResourceTimeoutsOutputReference", { enumerable: true, get: function () { return update_resource_1.UpdateResourceTimeoutsOutputReference; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXphcGktZXhwb3J0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb3JlLWF6dXJlL2xpYi9hemFwaS9hemFwaS1leHBvcnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7R0FLRzs7O0FBRUgsMENBQTBDO0FBQzFDLHVGQUdvRDtBQUZsRCxpSUFBQSxxQkFBcUIsT0FBQTtBQUNyQix3SkFBQSw0Q0FBNEMsT0FBQTtBQU85QyxxQ0FBcUM7QUFDckMsNkVBTStDO0FBTDdDLHdIQUFBLGlCQUFpQixPQUFBO0FBQ2pCLG9JQUFBLDZCQUE2QixPQUFBO0FBQzdCLCtJQUFBLHdDQUF3QyxPQUFBO0FBQ3hDLDRJQUFBLHFDQUFxQyxPQUFBO0FBQ3JDLCtJQUFBLHdDQUF3QyxPQUFBO0FBUzFDLDBCQUEwQjtBQUMxQix1REFPb0M7QUFObEMsb0dBQUEsUUFBUSxPQUFBO0FBRVIsZ0hBQUEsb0JBQW9CLE9BQUE7QUFDcEIsMkhBQUEsK0JBQStCLE9BQUE7QUFDL0Isd0hBQUEsNEJBQTRCLE9BQUE7QUFDNUIsMkhBQUEsK0JBQStCLE9BQUE7QUFRakMsaUNBQWlDO0FBQ2pDLHFFQUkyQztBQUh6QyxpSEFBQSxjQUFjLE9BQUE7QUFDZCxxSUFBQSxrQ0FBa0MsT0FBQTtBQUNsQyx3SUFBQSxxQ0FBcUMsT0FBQTtBQVF2QyxpQ0FBaUM7QUFDakMscUVBSTJDO0FBSHpDLGlIQUFBLGNBQWMsT0FBQTtBQUNkLHFJQUFBLGtDQUFrQyxPQUFBO0FBQ2xDLHdJQUFBLHFDQUFxQyxPQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDb252ZW5pZW5jZSBleHBvcnRzIGZvciBjb21tb25seSB1c2VkIEFaQVBJIHByb3ZpZGVyIGNsYXNzZXNcbiAqXG4gKiBUaGlzIGZpbGUgcHJvdmlkZXMgZGlyZWN0IGltcG9ydHMgZm9yIGZyZXF1ZW50bHkgdXNlZCBBWkFQSSBjbGFzc2VzXG4gKiB3aXRob3V0IG5lZWRpbmcgdG8gbmF2aWdhdGUgdGhlIG5lc3RlZCBwcm92aWRlciBzdHJ1Y3R1cmUuXG4gKi9cblxuLy8gUmUtZXhwb3J0IGZyb20gZGF0YS1hemFwaS1jbGllbnQtY29uZmlnXG5leHBvcnQge1xuICBEYXRhQXphcGlDbGllbnRDb25maWcsXG4gIERhdGFBemFwaUNsaWVudENvbmZpZ1RpbWVvdXRzT3V0cHV0UmVmZXJlbmNlLFxufSBmcm9tIFwiLi9wcm92aWRlcnMtYXphcGkvZGF0YS1hemFwaS1jbGllbnQtY29uZmlnXCI7XG5leHBvcnQgdHlwZSB7XG4gIERhdGFBemFwaUNsaWVudENvbmZpZ0NvbmZpZyxcbiAgRGF0YUF6YXBpQ2xpZW50Q29uZmlnVGltZW91dHMsXG59IGZyb20gXCIuL3Byb3ZpZGVycy1hemFwaS9kYXRhLWF6YXBpLWNsaWVudC1jb25maWdcIjtcblxuLy8gUmUtZXhwb3J0IGZyb20gZGF0YS1hemFwaS1yZXNvdXJjZVxuZXhwb3J0IHtcbiAgRGF0YUF6YXBpUmVzb3VyY2UsXG4gIERhdGFBemFwaVJlc291cmNlSWRlbnRpdHlMaXN0LFxuICBEYXRhQXphcGlSZXNvdXJjZUlkZW50aXR5T3V0cHV0UmVmZXJlbmNlLFxuICBEYXRhQXphcGlSZXNvdXJjZVJldHJ5T3V0cHV0UmVmZXJlbmNlLFxuICBEYXRhQXphcGlSZXNvdXJjZVRpbWVvdXRzT3V0cHV0UmVmZXJlbmNlLFxufSBmcm9tIFwiLi9wcm92aWRlcnMtYXphcGkvZGF0YS1hemFwaS1yZXNvdXJjZVwiO1xuZXhwb3J0IHR5cGUge1xuICBEYXRhQXphcGlSZXNvdXJjZUNvbmZpZyxcbiAgRGF0YUF6YXBpUmVzb3VyY2VJZGVudGl0eSxcbiAgRGF0YUF6YXBpUmVzb3VyY2VSZXRyeSxcbiAgRGF0YUF6YXBpUmVzb3VyY2VUaW1lb3V0cyxcbn0gZnJvbSBcIi4vcHJvdmlkZXJzLWF6YXBpL2RhdGEtYXphcGktcmVzb3VyY2VcIjtcblxuLy8gUmUtZXhwb3J0IGZyb20gcmVzb3VyY2VcbmV4cG9ydCB7XG4gIFJlc291cmNlLFxuICBSZXNvdXJjZUlkZW50aXR5LFxuICBSZXNvdXJjZUlkZW50aXR5TGlzdCxcbiAgUmVzb3VyY2VJZGVudGl0eU91dHB1dFJlZmVyZW5jZSxcbiAgUmVzb3VyY2VSZXRyeU91dHB1dFJlZmVyZW5jZSxcbiAgUmVzb3VyY2VUaW1lb3V0c091dHB1dFJlZmVyZW5jZSxcbn0gZnJvbSBcIi4vcHJvdmlkZXJzLWF6YXBpL3Jlc291cmNlXCI7XG5leHBvcnQgdHlwZSB7XG4gIFJlc291cmNlQ29uZmlnLFxuICBSZXNvdXJjZVJldHJ5LFxuICBSZXNvdXJjZVRpbWVvdXRzLFxufSBmcm9tIFwiLi9wcm92aWRlcnMtYXphcGkvcmVzb3VyY2VcIjtcblxuLy8gUmUtZXhwb3J0IGZyb20gcmVzb3VyY2UtYWN0aW9uXG5leHBvcnQge1xuICBSZXNvdXJjZUFjdGlvbixcbiAgUmVzb3VyY2VBY3Rpb25SZXRyeU91dHB1dFJlZmVyZW5jZSxcbiAgUmVzb3VyY2VBY3Rpb25UaW1lb3V0c091dHB1dFJlZmVyZW5jZSxcbn0gZnJvbSBcIi4vcHJvdmlkZXJzLWF6YXBpL3Jlc291cmNlLWFjdGlvblwiO1xuZXhwb3J0IHR5cGUge1xuICBSZXNvdXJjZUFjdGlvbkNvbmZpZyxcbiAgUmVzb3VyY2VBY3Rpb25SZXRyeSxcbiAgUmVzb3VyY2VBY3Rpb25UaW1lb3V0cyxcbn0gZnJvbSBcIi4vcHJvdmlkZXJzLWF6YXBpL3Jlc291cmNlLWFjdGlvblwiO1xuXG4vLyBSZS1leHBvcnQgZnJvbSB1cGRhdGUtcmVzb3VyY2VcbmV4cG9ydCB7XG4gIFVwZGF0ZVJlc291cmNlLFxuICBVcGRhdGVSZXNvdXJjZVJldHJ5T3V0cHV0UmVmZXJlbmNlLFxuICBVcGRhdGVSZXNvdXJjZVRpbWVvdXRzT3V0cHV0UmVmZXJlbmNlLFxufSBmcm9tIFwiLi9wcm92aWRlcnMtYXphcGkvdXBkYXRlLXJlc291cmNlXCI7XG5leHBvcnQgdHlwZSB7XG4gIFVwZGF0ZVJlc291cmNlQ29uZmlnLFxuICBVcGRhdGVSZXNvdXJjZVJldHJ5LFxuICBVcGRhdGVSZXNvdXJjZVRpbWVvdXRzLFxufSBmcm9tIFwiLi9wcm92aWRlcnMtYXphcGkvdXBkYXRlLXJlc291cmNlXCI7XG4iXX0=

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

@@ -0,0 +1,481 @@
+/**
+ * AzapiResource - A unified framework for version-aware Azure resource management
+ *
+ * This abstract base class provides a self-contained unified framework approach
+ * for Azure resource management with automatic version management, schema-driven
+ * property transformation, and migration analysis capabilities.
+ *
+ * Key Features:
+ * - Automatic latest version resolution when no version is specified
+ * - Support for explicit version pinning for stability
+ * - Schema-driven property transformation between versions
+ * - Migration analysis and deprecation warnings
+ * - Built-in role assignment and diagnostic settings support
+ * - JSII-compliant design for multi-language support
+ *
+ * This class replaces the previous dual-class approach (AzapiResource + AzapiResource)
+ * with a single, self-contained implementation that handles all resource management needs.
+ *
+ * @packageDocumentation
+ */
+import * as cdktf from "cdktf";
+import { Construct } from "constructs";
+import type { ActionGroupProps } from "../../../azure-actiongroup/lib/action-group";
+import type { ActivityLogAlertProps } from "../../../azure-activitylogalert/lib/activity-log-alert";
+import type { DiagnosticSettingsProps } from "../../../azure-diagnosticsettings/lib/diagnostic-settings";
+import type { MetricAlertProps } from "../../../azure-metricalert/lib/metric-alert";
+import { ApiSchema, VersionConfig, ValidationResult, MigrationAnalysis } from "../version-manager/interfaces/version-interfaces";
+/**
+ * Retention policy configuration
+ */
+export interface RetentionPolicyConfig {
+    readonly enabled: boolean;
+    readonly days: number;
+}
+/**
+ * Log configuration for diagnostic settings
+ */
+export interface DiagnosticLogConfig {
+    readonly category?: string;
+    readonly categoryGroup?: string;
+    readonly enabled: boolean;
+    readonly retentionPolicy?: RetentionPolicyConfig;
+}
+/**
+ * Metric configuration for diagnostic settings
+ */
+export interface DiagnosticMetricConfig {
+    /** Metric category name (used in newer API versions) */
+    readonly category?: string;
+    /** Time grain for metrics in ISO 8601 duration format (used in API version 2016-09-01, e.g., "PT1M") */
+    readonly timeGrain?: string;
+    readonly enabled: boolean;
+    readonly retentionPolicy?: RetentionPolicyConfig;
+}
+/**
+ * Monitoring configuration for Azure resources
+ *
+ * Provides integrated monitoring capabilities including diagnostic settings,
+ * metric alerts, and activity log alerts. All monitoring is optional and
+ * disabled by default.
+ */
+export interface MonitoringConfig {
+    /**
+     * Whether monitoring is enabled
+     * @defaultValue true
+     */
+    readonly enabled?: boolean;
+    /**
+     * Diagnostic settings configuration
+     * Uses the full DiagnosticSettings construct for consistency
+     */
+    readonly diagnosticSettings?: DiagnosticSettingsProps;
+    /**
+     * Action groups to create for this resource
+     * Creates new ActionGroup instances as child constructs
+     */
+    readonly actionGroups?: ActionGroupProps[];
+    /**
+     * Metric alerts configuration
+     * Creates MetricAlert instances scoped to this resource
+     */
+    readonly metricAlerts?: MetricAlertProps[];
+    /**
+     * Activity log alerts configuration
+     * Creates ActivityLogAlert instances for this resource's operations
+     */
+    readonly activityLogAlerts?: ActivityLogAlertProps[];
+}
+/**
+ * Properties for versioned Azure resources
+ *
+ * Combines base resource properties with version management capabilities
+ * and advanced configuration options for the unified framework.
+ */
+export interface AzapiResourceProps {
+    /**
+     * The name of the resource
+     */
+    readonly name?: string;
+    /**
+     * The location where the resource should be created
+     */
+    readonly location?: string;
+    /**
+     * Tags to apply to the resource
+     */
+    readonly tags?: Record<string, string>;
+    /**
+     * Explicit API version to use for this resource
+     *
+     * If not specified, the latest active version will be automatically resolved.
+     * Use this for version pinning when stability is required over latest features.
+     *
+     * @example "2024-11-01"
+     * @defaultValue Latest active version from ApiVersionManager
+     */
+    readonly apiVersion?: string;
+    /**
+     * Whether to enable migration analysis warnings
+     *
+     * When true, the framework will analyze the current version for deprecation
+     * status and provide migration recommendations in the deployment output.
+     *
+     * @defaultValue true
+     */
+    readonly enableMigrationAnalysis?: boolean;
+    /**
+     * Whether to validate properties against the schema
+     *
+     * When true, all properties will be validated against the API schema before
+     * resource creation. Validation errors will cause deployment failures.
+     *
+     * @defaultValue true
+     */
+    readonly enableValidation?: boolean;
+    /**
+     * Whether to apply property transformations automatically
+     *
+     * When true, properties will be automatically transformed according to the
+     * target schema's transformation rules. This enables backward compatibility.
+     *
+     * @defaultValue true
+     */
+    readonly enableTransformation?: boolean;
+    /**
+     * Monitoring configuration for this resource
+     *
+     * Enables integrated monitoring with diagnostic settings, metric alerts,
+     * and activity log alerts. All monitoring is optional and disabled by default.
+     *
+     * @example
+     * monitoring: {
+     *   enabled: true,
+     *   diagnosticSettings: {
+     *     workspaceId: logAnalytics.id,
+     *     metrics: ['AllMetrics'],
+     *     logs: ['AuditLogs']
+     *   },
+     *   metricAlerts: [{
+     *     name: 'high-cpu-alert',
+     *     severity: 2,
+     *     scopes: [], // Automatically set to this resource
+     *     criteria: { ... },
+     *     actions: [{ actionGroupId: actionGroup.id }]
+     *   }]
+     * }
+     */
+    readonly monitoring?: MonitoringConfig;
+}
+/**
+ * Abstract base class for version-aware Azure resource management
+ *
+ * AzapiResource provides a unified framework for creating Azure resources
+ * with automatic version management, schema validation, property transformation,
+ * and migration analysis. It extends the existing AzapiResource class while
+ * maintaining full backward compatibility.
+ *
+ * This class implements the core framework that enables:
+ * - Automatic resolution of the latest API version when none is specified
+ * - Explicit version pinning for environments requiring stability
+ * - Schema-driven property validation and transformation
+ * - Migration analysis with breaking change detection
+ * - Deprecation warnings and upgrade recommendations
+ *
+ * Subclasses must implement the abstract methods to provide resource-specific
+ * configuration while the framework handles all version management complexity.
+ *
+ * @example Basic usage with automatic version resolution:
+ * class MyResource extends AzapiResource {
+ *   protected getDefaultVersion(): string {
+ *     return "2024-11-01"; // fallback if no versions registered
+ *   }
+ *
+ *   protected getResourceType(): string {
+ *     return "Microsoft.Resources/resourceGroups";
+ *   }
+ *
+ *   protected getApiSchema(): ApiSchema {
+ *     return this.resolveSchema();
+ *   }
+ *
+ *   protected createResourceBody(props: any): any {
+ *     return { location: props.location, tags: props.tags || {} };
+ *   }
+ * }
+ *
+ * @example Usage with explicit version pinning:
+ * new MyResource(this, "resource", {
+ *   name: "my-resource",
+ *   location: "eastus",
+ *   apiVersion: "2024-01-01" // Pin to specific version
+ * });
+ *
+ * @stability stable
+ */
+export declare abstract class AzapiResource extends Construct {
+    /**
+     * The Azure resource type (e.g., "Microsoft.Resources/resourceGroups")
+     * @internal
+     */
+    protected readonly _resourceType: string;
+    /**
+     * The API version to use for this resource
+     */
+    protected readonly apiVersion: string;
+    /**
+     * The underlying AZAPI Terraform resource
+     */
+    protected terraformResource: cdktf.TerraformResource;
+    /**
+     * The name of the resource
+     */
+    readonly name: string;
+    /**
+     * The location of the resource
+     */
+    readonly location: string;
+    /**
+     * The resource ID (abstract - must be implemented by subclasses)
+     */
+    abstract readonly id: string;
+    /**
+     * The resolved API version being used for this resource instance
+     *
+     * This is the actual version that will be used for the Azure API call,
+     * either explicitly specified in props or automatically resolved to
+     * the latest active version.
+     */
+    readonly resolvedApiVersion: string;
+    /**
+     * The API schema for the resolved version
+     *
+     * Contains the complete schema definition including properties, validation
+     * rules, and transformation mappings for the resolved API version.
+     */
+    readonly schema: ApiSchema;
+    /**
+     * The version configuration for the resolved version
+     *
+     * Contains lifecycle information, breaking changes, and migration metadata
+     * for the resolved API version.
+     */
+    readonly versionConfig: VersionConfig;
+    /**
+     * Validation results for the resource properties
+     *
+     * Available after construction if validation is enabled. Contains detailed
+     * information about any validation errors or warnings.
+     */
+    readonly validationResult?: ValidationResult;
+    /**
+     * Migration analysis results
+     *
+     * Available after construction if migration analysis is enabled and a
+     * previous version can be determined for comparison.
+     */
+    readonly migrationAnalysis?: MigrationAnalysis;
+    private readonly _apiVersionManager;
+    private readonly _schemaMapper;
+    protected readonly monitoringActionGroups: Construct[];
+    protected readonly monitoringMetricAlerts: Construct[];
+    protected readonly monitoringActivityLogAlerts: Construct[];
+    /**
+     * Creates a new AzapiResource instance
+     *
+     * The constructor handles all framework initialization including version resolution,
+     * schema loading, property validation, transformation, and migration analysis.
+     * It maintains full backward compatibility with the AzapiResource constructor.
+     *
+     * @param scope - The scope in which to define this construct
+     * @param id - The unique identifier for this instance
+     * @param props - Configuration properties for the resource
+     */
+    constructor(scope: Construct, id: string, props?: AzapiResourceProps);
+    /**
+     * Gets the default API version to use when no explicit version is specified
+     *
+     * This method should return a sensible default version that can be used
+     * as a fallback if the ApiVersionManager doesn't have any versions registered
+     * for this resource type.
+     *
+     * @returns The default API version string (e.g., "2024-11-01")
+     */
+    protected abstract defaultVersion(): string;
+    /**
+     * Gets the Azure resource type for this resource
+     *
+     * This method should return the full Azure resource type identifier that
+     * will be used for API calls and version management.
+     *
+     * @returns The Azure resource type (e.g., "Microsoft.Resources/resourceGroups")
+     */
+    protected abstract resourceType(): string;
+    /**
+     * Gets the API schema for the resolved version
+     *
+     * This method should return the complete API schema for the resolved version,
+     * including all property definitions, validation rules, and transformation
+     * mappings. Use the resolveSchema() helper method for standard schema resolution.
+     *
+     * @returns The API schema for the resolved version
+     */
+    protected abstract apiSchema(): ApiSchema;
+    /**
+     * Creates the resource body for the Azure API call
+     *
+     * This method should transform the input properties into the JSON body format
+     * expected by the Azure REST API for the resolved version. The framework will
+     * have already applied any necessary property transformations and validation.
+     *
+     * @param props - The processed and validated properties for the resource
+     * @returns The resource body object to send to Azure API
+     */
+    protected abstract createResourceBody(props: any): any;
+    /**
+     * Helper method for standard schema resolution
+     *
+     * Subclasses can use this method to resolve the schema for the current version
+     * from the ApiVersionManager. This provides a standard implementation that
+     * most resources can use without custom logic.
+     *
+     * @returns The API schema for the resolved version
+     * @throws Error if the schema cannot be resolved
+     */
+    protected resolveSchema(): ApiSchema;
+    /**
+     * Gets the latest available version for this resource type
+     *
+     * This method provides access to the latest version resolution logic
+     * for use in subclasses or external tooling.
+     *
+     * @returns The latest available version, or undefined if none found
+     */
+    latestVersion(): string | undefined;
+    /**
+     * Gets all supported versions for this resource type
+     *
+     * This method provides access to the version registry for use in
+     * subclasses or external tooling.
+     *
+     * @returns Array of supported version strings, sorted by release date
+     */
+    supportedVersions(): string[];
+    /**
+     * Analyzes migration from current version to a target version
+     *
+     * This method enables external tools to analyze migration requirements
+     * between versions for planning and automation purposes.
+     *
+     * @param targetVersion - The target version to analyze migration to
+     * @returns Detailed migration analysis results
+     */
+    analyzeMigrationTo(targetVersion: string): MigrationAnalysis;
+    /**
+     * Resolves the API version to use for this resource instance
+     */
+    private _resolveApiVersion;
+    /**
+     * Processes properties through the framework pipeline
+     */
+    private _processProperties;
+    /**
+     * Validates properties against the schema
+     */
+    private _validateProperties;
+    /**
+     * Performs migration analysis for the current version
+     */
+    private _performMigrationAnalysis;
+    /**
+     * Creates the underlying Azure resource
+     */
+    private _createAzureResource;
+    /**
+     * Resolves the parent resource ID for this resource.
+     *
+     * Override this method in child resource classes (like Subnet) that need
+     * custom parent ID resolution logic. By default, this delegates to the
+     * private _determineParentId method which handles standard resource types.
+     *
+     * @param props - The resource properties
+     * @returns The parent resource ID
+     */
+    protected resolveParentId(props: any): string;
+    /**
+     * Determines the parent ID for the resource (internal implementation)
+     *
+     * This method provides the default parent ID resolution logic for most resources.
+     * Child resources should override resolveParentId() instead of this method.
+     */
+    private _determineParentId;
+    /**
+     * Logs framework messages including warnings and migration guidance
+     */
+    private _logFrameworkMessages;
+    /**
+     * Creates monitoring resources based on the monitoring configuration
+     *
+     * This method is called automatically during construction if monitoring is configured.
+     * It creates action groups, metric alerts, and activity log alerts as child constructs.
+     *
+     * Protected to allow subclasses to override or extend monitoring behavior.
+     *
+     * @param config - The monitoring configuration from props
+     */
+    protected createMonitoringResources(config: MonitoringConfig): Promise<void>;
+    /**
+     * Creates the underlying AZAPI Terraform resource using the generated provider classes
+     *
+     * @param properties - The properties object to send to the Azure API
+     * @param parentId - The parent resource ID (e.g., subscription or resource group)
+     * @param name - The name of the resource
+     * @param location - The location of the resource (optional, can be in properties)
+     * @returns The created AZAPI resource
+     */
+    protected createAzapiResource(properties: Record<string, any>, parentId: string, name: string, location?: string): cdktf.TerraformResource;
+    /**
+     * Creates an AZAPI data source for reading existing resources
+     *
+     * @param resourceId - The full resource ID
+     * @returns The created Terraform data source
+     */
+    protected createAzapiDataSource(resourceId: string): cdktf.TerraformDataSource;
+    /**
+     * Updates the resource with new properties
+     *
+     * @param properties - The new properties to apply
+     */
+    protected updateAzapiResource(properties: Record<string, any>): void;
+    /**
+     * Gets the full resource ID
+     */
+    get resourceId(): string;
+    /**
+     * Gets the resource as a Terraform output value
+     */
+    get output(): cdktf.TerraformOutput;
+    /**
+     * Adds an access role assignment for a specified Azure AD object
+     *
+     * Note: This method creates role assignments using AZAPI instead of AzureRM provider.
+     *
+     * @param objectId - The unique identifier of the Azure AD object
+     * @param roleDefinitionName - The name of the Azure RBAC role to be assigned
+     */
+    addAccess(objectId: string, roleDefinitionName: string): void;
+}
+/**
+ * Properties for AZAPI role assignment
+ */
+export interface AzapiRoleAssignmentProps {
+    readonly objectId: string;
+    readonly roleDefinitionName: string;
+    readonly scope: string;
+}
+/**
+ * AZAPI-based role assignment construct
+ */
+export declare class AzapiRoleAssignment extends Construct {
+    constructor(scope: Construct, id: string, props: AzapiRoleAssignmentProps);
+}