@microsoft/terraform-cdk-constructs 1.0.0 → 1.3.0

package/lib/testing/lib/metadata.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Test run metadata management
+ *
+ * Provides classes and utilities for generating and managing
+ * integration test metadata including unique IDs, timestamps,
+ * CI context, and system tags.
+ */
+/**
+ * CI/CD pipeline context
+ *
+ * Extracted from environment variables during test execution.
+ * Enables tracing resources back to specific pipeline runs.
+ */
+export interface CIContext {
+    /**
+     * CI platform ('github-actions', 'azure-devops', 'generic-ci', 'local')
+     */
+    readonly platform: string;
+    /**
+     * GitHub Actions workflow ID or equivalent
+     */
+    readonly pipelineId?: string;
+    /**
+     * GitHub Actions run ID or equivalent
+     */
+    readonly runId?: string;
+    /**
+     * GitHub Actions run number or equivalent
+     */
+    readonly runNumber?: string;
+    /**
+     * Git commit SHA (full)
+     */
+    readonly commitSha?: string;
+    /**
+     * Git commit SHA (short, 7 chars)
+     */
+    readonly commitShaShort?: string;
+    /**
+     * Git branch name
+     */
+    readonly branch?: string;
+    /**
+     * Git repository name
+     */
+    readonly repository?: string;
+}
+/**
+ * Integration test system tags
+ *
+ * Returns a record of tag key-value pairs for Azure resources.
+ * Uses Azure tag naming conventions with colons and hyphens.
+ */
+export type IntegrationTestTags = Record<string, string>;
+/**
+ * Test run configuration options
+ */
+export interface TestRunOptions {
+    /**
+     * Maximum age in hours before cleanup eligible (default: 4)
+     */
+    readonly maxAgeHours?: number;
+    /**
+     * Enable automated cleanup (default: true)
+     */
+    readonly autoCleanup?: boolean;
+    /**
+     * Cleanup policy (default: 'immediate')
+     */
+    readonly cleanupPolicy?: "immediate" | "delayed" | "manual";
+}
+/**
+ * Metadata for an integration test run
+ *
+ * Generated once per test execution and shared across all resources
+ * in that test. Provides unique identification, temporal tracking,
+ * and CI/CD context.
+ */
+export declare class TestRunMetadata {
+    /**
+     * Unique identifier for this test run (UUID v4)
+     */
+    readonly runId: string;
+    /**
+     * Sanitized test name from the describe block
+     */
+    readonly testName: string;
+    /**
+     * Timestamp when the test run started
+     */
+    readonly createdAt: Date;
+    /**
+     * Cleanup after timestamp (createdAt + maxAgeHours)
+     */
+    readonly cleanupAfter: Date;
+    /**
+     * Maximum age in hours before cleanup eligible
+     */
+    readonly maxAgeHours: number;
+    /**
+     * Enable automated cleanup
+     */
+    readonly autoCleanup: boolean;
+    /**
+     * Cleanup policy
+     */
+    readonly cleanupPolicy: "immediate" | "delayed" | "manual";
+    /**
+     * CI/CD context (populated from environment variables)
+     */
+    readonly ciContext?: CIContext;
+    /**
+     * Creates new test run metadata
+     *
+     * @param testName - Test name (will be sanitized)
+     * @param options - Optional configuration
+     */
+    constructor(testName: string, options?: TestRunOptions);
+    /**
+     * Generates system tags for resources
+     *
+     * @returns Integration test system tags
+     */
+    generateSystemTags(): Record<string, string>;
+    /**
+     * Checks if resources from this run are eligible for cleanup
+     *
+     * @param now - Current time (defaults to now)
+     * @returns Whether cleanup is eligible
+     */
+    isCleanupEligible(now?: Date): boolean;
+    /**
+     * Serializes metadata to JSON for logging
+     *
+     * @returns JSON-serializable object
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Sanitizes test name to be Azure-compliant
+     *
+     * @param name - Raw test name
+     * @returns Sanitized name
+     */
+    private sanitizeTestName;
+}
+/**
+ * Detects and extracts CI context from environment
+ *
+ * @returns CI context or undefined if not in CI
+ */
+export declare function detectCIContext(): CIContext | undefined;

package/lib/testing/lib/metadata.js

@@ -0,0 +1,183 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestRunMetadata = void 0;
+exports.detectCIContext = detectCIContext;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+/**
+ * Test run metadata management
+ *
+ * Provides classes and utilities for generating and managing
+ * integration test metadata including unique IDs, timestamps,
+ * CI context, and system tags.
+ */
+const uuid_1 = require("uuid");
+/**
+ * Metadata for an integration test run
+ *
+ * Generated once per test execution and shared across all resources
+ * in that test. Provides unique identification, temporal tracking,
+ * and CI/CD context.
+ */
+class TestRunMetadata {
+    /**
+     * Creates new test run metadata
+     *
+     * @param testName - Test name (will be sanitized)
+     * @param options - Optional configuration
+     */
+    constructor(testName, options) {
+        this.runId = (0, uuid_1.v4)();
+        this.testName = this.sanitizeTestName(testName);
+        this.createdAt = new Date();
+        this.maxAgeHours = options?.maxAgeHours ?? 4;
+        this.autoCleanup = options?.autoCleanup ?? true;
+        this.cleanupPolicy = options?.cleanupPolicy ?? "immediate";
+        this.cleanupAfter = new Date(this.createdAt.getTime() + this.maxAgeHours * 60 * 60 * 1000);
+        this.ciContext = detectCIContext();
+    }
+    /**
+     * Generates system tags for resources
+     *
+     * @returns Integration test system tags
+     */
+    generateSystemTags() {
+        // Build tags object with all properties
+        // NOTE: Tag names use hyphens instead of colons because Azure DNS zones
+        // and some other resource types don't support colons (":") in tag names.
+        // See: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/tag-resources#limitations
+        const tags = {
+            // Resource Identification
+            "test-run-id": this.runId,
+            "test-name": this.testName,
+            "test-resource-type": "integration-test",
+            // Temporal Tracking
+            "test-created-at": this.createdAt.toISOString(),
+            "test-cleanup-after": this.cleanupAfter.toISOString(),
+            "test-max-age-hours": this.maxAgeHours.toString(),
+            // Lifecycle Management
+            "test-managed-by": "terraform-cdk-constructs-tests",
+            "test-auto-cleanup": this.autoCleanup.toString(),
+            "test-cleanup-policy": this.cleanupPolicy,
+            // Backward Compatibility
+            environment: "integration-test",
+            purpose: "integration-test",
+        };
+        // Add CI/CD context if available
+        if (this.ciContext) {
+            if (this.ciContext.pipelineId) {
+                tags["test-ci-pipeline"] = this.ciContext.pipelineId;
+            }
+            if (this.ciContext.runId) {
+                tags["test-ci-run-id"] = this.ciContext.runId;
+            }
+            if (this.ciContext.runNumber) {
+                tags["test-ci-run-number"] = this.ciContext.runNumber;
+            }
+            if (this.ciContext.commitShaShort) {
+                tags["test-git-commit"] = this.ciContext.commitShaShort;
+            }
+            if (this.ciContext.branch) {
+                tags["test-git-branch"] = this.ciContext.branch;
+            }
+        }
+        return tags;
+    }
+    /**
+     * Checks if resources from this run are eligible for cleanup
+     *
+     * @param now - Current time (defaults to now)
+     * @returns Whether cleanup is eligible
+     */
+    isCleanupEligible(now) {
+        const currentTime = now || new Date();
+        return currentTime >= this.cleanupAfter;
+    }
+    /**
+     * Serializes metadata to JSON for logging
+     *
+     * @returns JSON-serializable object
+     */
+    toJSON() {
+        return {
+            runId: this.runId,
+            testName: this.testName,
+            createdAt: this.createdAt.toISOString(),
+            cleanupAfter: this.cleanupAfter.toISOString(),
+            maxAgeHours: this.maxAgeHours,
+            autoCleanup: this.autoCleanup,
+            cleanupPolicy: this.cleanupPolicy,
+            ciContext: this.ciContext,
+        };
+    }
+    /**
+     * Sanitizes test name to be Azure-compliant
+     *
+     * @param name - Raw test name
+     * @returns Sanitized name
+     */
+    sanitizeTestName(name) {
+        let sanitized = name
+            .toLowerCase()
+            // Replace spaces and special characters with hyphens
+            .replace(/[^a-z0-9-]/g, "-")
+            // Remove consecutive hyphens
+            .replace(/-+/g, "-")
+            // Remove leading/trailing hyphens
+            .replace(/^-+|-+$/g, "");
+        // Truncate to 63 characters (DNS label limit)
+        if (sanitized.length > 63) {
+            sanitized = sanitized.substring(0, 63).replace(/-+$/, "");
+        }
+        return sanitized;
+    }
+}
+exports.TestRunMetadata = TestRunMetadata;
+_a = JSII_RTTI_SYMBOL_1;
+TestRunMetadata[_a] = { fqn: "@microsoft/terraform-cdk-constructs.TestRunMetadata", version: "1.3.0" };
+/**
+ * Detects and extracts CI context from environment
+ *
+ * @returns CI context or undefined if not in CI
+ */
+function detectCIContext() {
+    // Detect GitHub Actions
+    if (process.env.GITHUB_ACTIONS === "true") {
+        return {
+            platform: "github-actions",
+            pipelineId: process.env.GITHUB_WORKFLOW,
+            runId: process.env.GITHUB_RUN_ID,
+            runNumber: process.env.GITHUB_RUN_NUMBER,
+            commitSha: process.env.GITHUB_SHA,
+            commitShaShort: process.env.GITHUB_SHA?.substring(0, 7),
+            branch: process.env.GITHUB_REF_NAME,
+            repository: process.env.GITHUB_REPOSITORY,
+        };
+    }
+    // Detect Azure DevOps
+    if (process.env.TF_BUILD === "True") {
+        return {
+            platform: "azure-devops",
+            pipelineId: process.env.BUILD_DEFINITIONNAME,
+            runId: process.env.BUILD_BUILDID,
+            runNumber: process.env.BUILD_BUILDNUMBER,
+            commitSha: process.env.BUILD_SOURCEVERSION,
+            commitShaShort: process.env.BUILD_SOURCEVERSION?.substring(0, 7),
+            branch: process.env.BUILD_SOURCEBRANCHNAME,
+            repository: process.env.BUILD_REPOSITORY_NAME,
+        };
+    }
+    // Detect generic CI
+    if (process.env.CI === "true") {
+        return {
+            platform: "generic-ci",
+            commitShaShort: "ci",
+        };
+    }
+    // Local execution
+    return {
+        platform: "local",
+        commitShaShort: "local",
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0YWRhdGEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGVzdGluZy9saWIvbWV0YWRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7OztBQXlRQSwwQ0EwQ0M7O0FBblREOzs7Ozs7R0FNRztBQUVILCtCQUFvQztBQThFcEM7Ozs7OztHQU1HO0FBQ0gsTUFBYSxlQUFlO0lBeUMxQjs7Ozs7T0FLRztJQUNILFlBQVksUUFBZ0IsRUFBRSxPQUF3QjtRQUNwRCxJQUFJLENBQUMsS0FBSyxHQUFHLElBQUEsU0FBTSxHQUFFLENBQUM7UUFDdEIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDaEQsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO1FBQzVCLElBQUksQ0FBQyxXQUFXLEdBQUcsT0FBTyxFQUFFLFdBQVcsSUFBSSxDQUFDLENBQUM7UUFDN0MsSUFBSSxDQUFDLFdBQVcsR0FBRyxPQUFPLEVBQUUsV0FBVyxJQUFJLElBQUksQ0FBQztRQUNoRCxJQUFJLENBQUMsYUFBYSxHQUFHLE9BQU8sRUFBRSxhQUFhLElBQUksV0FBVyxDQUFDO1FBQzNELElBQUksQ0FBQyxZQUFZLEdBQUcsSUFBSSxJQUFJLENBQzFCLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLFdBQVcsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FDN0QsQ0FBQztRQUNGLElBQUksQ0FBQyxTQUFTLEdBQUcsZUFBZSxFQUFFLENBQUM7SUFDckMsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxrQkFBa0I7UUFDdkIsd0NBQXdDO1FBQ3hDLHdFQUF3RTtRQUN4RSx5RUFBeUU7UUFDekUsMkdBQTJHO1FBQzNHLE1BQU0sSUFBSSxHQUEyQjtZQUNuQywwQkFBMEI7WUFDMUIsYUFBYSxFQUFFLElBQUksQ0FBQyxLQUFLO1lBQ3pC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QWlCO1lBQ3hDLFNBQVMsRUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLG1CQUFtQjtZQUMxQyxjQUFjLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxtQkFBbUIsRUFBRSxTQUFTLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUNoRSxNQUFNLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxzQkFBc0I7WUFDMUMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMscUJBQXFCO1NBQzlDLENBQUM7SUFDSixDQUFDO0lBRUQsb0JBQW9CO0lBQ3BCLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUM7UUFDOUIsT0FBTztZQUNMLFFBQVEsRUFBRSxZQUFZO1lBQ3RCLGNBQWMsRUFBRSxJQUFJO1NBQ3JCLENBQUM7SUFDSixDQUFDO0lBRUQsa0JBQWtCO0lBQ2xCLE9BQU87UUFDTCxRQUFRLEVBQUUsT0FBTztRQUNqQixjQUFjLEVBQUUsT0FBTztLQUN4QixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogVGVzdCBydW4gbWV0YWRhdGEgbWFuYWdlbWVudFxuICpcbiAqIFByb3ZpZGVzIGNsYXNzZXMgYW5kIHV0aWxpdGllcyBmb3IgZ2VuZXJhdGluZyBhbmQgbWFuYWdpbmdcbiAqIGludGVncmF0aW9uIHRlc3QgbWV0YWRhdGEgaW5jbHVkaW5nIHVuaXF1ZSBJRHMsIHRpbWVzdGFtcHMsXG4gKiBDSSBjb250ZXh0LCBhbmQgc3lzdGVtIHRhZ3MuXG4gKi9cblxuaW1wb3J0IHsgdjQgYXMgdXVpZHY0IH0gZnJvbSBcInV1aWRcIjtcblxuLyoqXG4gKiBDSS9DRCBwaXBlbGluZSBjb250ZXh0XG4gKlxuICogRXh0cmFjdGVkIGZyb20gZW52aXJvbm1lbnQgdmFyaWFibGVzIGR1cmluZyB0ZXN0IGV4ZWN1dGlvbi5cbiAqIEVuYWJsZXMgdHJhY2luZyByZXNvdXJjZXMgYmFjayB0byBzcGVjaWZpYyBwaXBlbGluZSBydW5zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENJQ29udGV4dCB7XG4gIC8qKlxuICAgKiBDSSBwbGF0Zm9ybSAoJ2dpdGh1Yi1hY3Rpb25zJywgJ2F6dXJlLWRldm9wcycsICdnZW5lcmljLWNpJywgJ2xvY2FsJylcbiAgICovXG4gIHJlYWRvbmx5IHBsYXRmb3JtOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdEh1YiBBY3Rpb25zIHdvcmtmbG93IElEIG9yIGVxdWl2YWxlbnRcbiAgICovXG4gIHJlYWRvbmx5IHBpcGVsaW5lSWQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdEh1YiBBY3Rpb25zIHJ1biBJRCBvciBlcXVpdmFsZW50XG4gICAqL1xuICByZWFkb25seSBydW5JZD86IHN0cmluZztcblxuICAvKipcbiAgICogR2l0SHViIEFjdGlvbnMgcnVuIG51bWJlciBvciBlcXVpdmFsZW50XG4gICAqL1xuICByZWFkb25seSBydW5OdW1iZXI/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdCBjb21taXQgU0hBIChmdWxsKVxuICAgKi9cbiAgcmVhZG9ubHkgY29tbWl0U2hhPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBHaXQgY29tbWl0IFNIQSAoc2hvcnQsIDcgY2hhcnMpXG4gICAqL1xuICByZWFkb25seSBjb21taXRTaGFTaG9ydD86IHN0cmluZztcblxuICAvKipcbiAgICogR2l0IGJyYW5jaCBuYW1lXG4gICAqL1xuICByZWFkb25seSBicmFuY2g/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdCByZXBvc2l0b3J5IG5hbWVcbiAgICovXG4gIHJlYWRvbmx5IHJlcG9zaXRvcnk/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogSW50ZWdyYXRpb24gdGVzdCBzeXN0ZW0gdGFnc1xuICpcbiAqIFJldHVybnMgYSByZWNvcmQgb2YgdGFnIGtleS12YWx1ZSBwYWlycyBmb3IgQXp1cmUgcmVzb3VyY2VzLlxuICogVXNlcyBBenVyZSB0YWcgbmFtaW5nIGNvbnZlbnRpb25zIHdpdGggY29sb25zIGFuZCBoeXBoZW5zLlxuICovXG5leHBvcnQgdHlwZSBJbnRlZ3JhdGlvblRlc3RUYWdzID0gUmVjb3JkPHN0cmluZywgc3RyaW5nPjtcblxuLyoqXG4gKiBUZXN0IHJ1biBjb25maWd1cmF0aW9uIG9wdGlvbnNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUZXN0UnVuT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBNYXhpbXVtIGFnZSBpbiBob3VycyBiZWZvcmUgY2xlYW51cCBlbGlnaWJsZSAoZGVmYXVsdDogNClcbiAgICovXG4gIHJlYWRvbmx5IG1heEFnZUhvdXJzPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBFbmFibGUgYXV0b21hdGVkIGNsZWFudXAgKGRlZmF1bHQ6IHRydWUpXG4gICAqL1xuICByZWFkb25seSBhdXRvQ2xlYW51cD86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIENsZWFudXAgcG9saWN5IChkZWZhdWx0OiAnaW1tZWRpYXRlJylcbiAgICovXG4gIHJlYWRvbmx5IGNsZWFudXBQb2xpY3k/OiBcImltbWVkaWF0ZVwiIHwgXCJkZWxheWVkXCIgfCBcIm1hbnVhbFwiO1xufVxuXG4vKipcbiAqIE1ldGFkYXRhIGZvciBhbiBpbnRlZ3JhdGlvbiB0ZXN0IHJ1blxuICpcbiAqIEdlbmVyYXRlZCBvbmNlIHBlciB0ZXN0IGV4ZWN1dGlvbiBhbmQgc2hhcmVkIGFjcm9zcyBhbGwgcmVzb3VyY2VzXG4gKiBpbiB0aGF0IHRlc3QuIFByb3ZpZGVzIHVuaXF1ZSBpZGVudGlmaWNhdGlvbiwgdGVtcG9yYWwgdHJhY2tpbmcsXG4gKiBhbmQgQ0kvQ0QgY29udGV4dC5cbiAqL1xuZXhwb3J0IGNsYXNzIFRlc3RSdW5NZXRhZGF0YSB7XG4gIC8qKlxuICAgKiBVbmlxdWUgaWRlbnRpZmllciBmb3IgdGhpcyB0ZXN0IHJ1biAoVVVJRCB2NClcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBydW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBTYW5pdGl6ZWQgdGVzdCBuYW1lIGZyb20gdGhlIGRlc2NyaWJlIGJsb2NrXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgdGVzdE5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGltZXN0YW1wIHdoZW4gdGhlIHRlc3QgcnVuIHN0YXJ0ZWRcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBjcmVhdGVkQXQ6IERhdGU7XG5cbiAgLyoqXG4gICAqIENsZWFudXAgYWZ0ZXIgdGltZXN0YW1wIChjcmVhdGVkQXQgKyBtYXhBZ2VIb3VycylcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBjbGVhbnVwQWZ0ZXI6IERhdGU7XG5cbiAgLyoqXG4gICAqIE1heGltdW0gYWdlIGluIGhvdXJzIGJlZm9yZSBjbGVhbnVwIGVsaWdpYmxlXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgbWF4QWdlSG91cnM6IG51bWJlcjtcblxuICAvKipcbiAgICogRW5hYmxlIGF1dG9tYXRlZCBjbGVhbnVwXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgYXV0b0NsZWFudXA6IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIENsZWFudXAgcG9saWN5XG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgY2xlYW51cFBvbGljeTogXCJpbW1lZGlhdGVcIiB8IFwiZGVsYXllZFwiIHwgXCJtYW51YWxcIjtcblxuICAvKipcbiAgICogQ0kvQ0QgY29udGV4dCAocG9wdWxhdGVkIGZyb20gZW52aXJvbm1lbnQgdmFyaWFibGVzKVxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGNpQ29udGV4dD86IENJQ29udGV4dDtcblxuICAvKipcbiAgICogQ3JlYXRlcyBuZXcgdGVzdCBydW4gbWV0YWRhdGFcbiAgICpcbiAgICogQHBhcmFtIHRlc3ROYW1lIC0gVGVzdCBuYW1lICh3aWxsIGJlIHNhbml0aXplZClcbiAgICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25hbCBjb25maWd1cmF0aW9uXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih0ZXN0TmFtZTogc3RyaW5nLCBvcHRpb25zPzogVGVzdFJ1bk9wdGlvbnMpIHtcbiAgICB0aGlzLnJ1bklkID0gdXVpZHY0KCk7XG4gICAgdGhpcy50ZXN0TmFtZSA9IHRoaXMuc2FuaXRpemVUZXN0TmFtZSh0ZXN0TmFtZSk7XG4gICAgdGhpcy5jcmVhdGVkQXQgPSBuZXcgRGF0ZSgpO1xuICAgIHRoaXMubWF4QWdlSG91cnMgPSBvcHRpb25zPy5tYXhBZ2VIb3VycyA/PyA0O1xuICAgIHRoaXMuYXV0b0NsZWFudXAgPSBvcHRpb25zPy5hdXRvQ2xlYW51cCA/PyB0cnVlO1xuICAgIHRoaXMuY2xlYW51cFBvbGljeSA9IG9wdGlvbnM/LmNsZWFudXBQb2xpY3kgPz8gXCJpbW1lZGlhdGVcIjtcbiAgICB0aGlzLmNsZWFudXBBZnRlciA9IG5ldyBEYXRlKFxuICAgICAgdGhpcy5jcmVhdGVkQXQuZ2V0VGltZSgpICsgdGhpcy5tYXhBZ2VIb3VycyAqIDYwICogNjAgKiAxMDAwLFxuICAgICk7XG4gICAgdGhpcy5jaUNvbnRleHQgPSBkZXRlY3RDSUNvbnRleHQoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZW5lcmF0ZXMgc3lzdGVtIHRhZ3MgZm9yIHJlc291cmNlc1xuICAgKlxuICAgKiBAcmV0dXJucyBJbnRlZ3JhdGlvbiB0ZXN0IHN5c3RlbSB0YWdzXG4gICAqL1xuICBwdWJsaWMgZ2VuZXJhdGVTeXN0ZW1UYWdzKCk6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4ge1xuICAgIC8vIEJ1aWxkIHRhZ3Mgb2JqZWN0IHdpdGggYWxsIHByb3BlcnRpZXNcbiAgICAvLyBOT1RFOiBUYWcgbmFtZXMgdXNlIGh5cGhlbnMgaW5zdGVhZCBvZiBjb2xvbnMgYmVjYXVzZSBBenVyZSBETlMgem9uZXNcbiAgICAvLyBhbmQgc29tZSBvdGhlciByZXNvdXJjZSB0eXBlcyBkb24ndCBzdXBwb3J0IGNvbG9ucyAoXCI6XCIpIGluIHRhZyBuYW1lcy5cbiAgICAvLyBTZWU6IGh0dHBzOi8vbGVhcm4ubWljcm9zb2Z0LmNvbS9lbi11cy9henVyZS9henVyZS1yZXNvdXJjZS1tYW5hZ2VyL21hbmFnZW1lbnQvdGFnLXJlc291cmNlcyNsaW1pdGF0aW9uc1xuICAgIGNvbnN0IHRhZ3M6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4gPSB7XG4gICAgICAvLyBSZXNvdXJjZSBJZGVudGlmaWNhdGlvblxuICAgICAgXCJ0ZXN0LXJ1bi1pZFwiOiB0aGlzLnJ1bklkLFxuICAgICAgXCJ0ZXN0LW5hbWVcIjogdGhpcy50ZXN0TmFtZSxcbiAgICAgIFwidGVzdC1yZXNvdXJjZS10eXBlXCI6IFwiaW50ZWdyYXRpb24tdGVzdFwiLFxuXG4gICAgICAvLyBUZW1wb3JhbCBUcmFja2luZ1xuICAgICAgXCJ0ZXN0LWNyZWF0ZWQtYXRcIjogdGhpcy5jcmVhdGVkQXQudG9JU09TdHJpbmcoKSxcbiAgICAgIFwidGVzdC1jbGVhbnVwLWFmdGVyXCI6IHRoaXMuY2xlYW51cEFmdGVyLnRvSVNPU3RyaW5nKCksXG4gICAgICBcInRlc3QtbWF4LWFnZS1ob3Vyc1wiOiB0aGlzLm1heEFnZUhvdXJzLnRvU3RyaW5nKCksXG5cbiAgICAgIC8vIExpZmVjeWNsZSBNYW5hZ2VtZW50XG4gICAgICBcInRlc3QtbWFuYWdlZC1ieVwiOiBcInRlcnJhZm9ybS1jZGstY29uc3RydWN0cy10ZXN0c1wiLFxuICAgICAgXCJ0ZXN0LWF1dG8tY2xlYW51cFwiOiB0aGlzLmF1dG9DbGVhbnVwLnRvU3RyaW5nKCksXG4gICAgICBcInRlc3QtY2xlYW51cC1wb2xpY3lcIjogdGhpcy5jbGVhbnVwUG9saWN5LFxuXG4gICAgICAvLyBCYWNrd2FyZCBDb21wYXRpYmlsaXR5XG4gICAgICBlbnZpcm9ubWVudDogXCJpbnRlZ3JhdGlvbi10ZXN0XCIsXG4gICAgICBwdXJwb3NlOiBcImludGVncmF0aW9uLXRlc3RcIixcbiAgICB9O1xuXG4gICAgLy8gQWRkIENJL0NEIGNvbnRleHQgaWYgYXZhaWxhYmxlXG4gICAgaWYgKHRoaXMuY2lDb250ZXh0KSB7XG4gICAgICBpZiAodGhpcy5jaUNvbnRleHQucGlwZWxpbmVJZCkge1xuICAgICAgICB0YWdzW1widGVzdC1jaS1waXBlbGluZVwiXSA9IHRoaXMuY2lDb250ZXh0LnBpcGVsaW5lSWQ7XG4gICAgICB9XG4gICAgICBpZiAodGhpcy5jaUNvbnRleHQucnVuSWQpIHtcbiAgICAgICAgdGFnc1tcInRlc3QtY2ktcnVuLWlkXCJdID0gdGhpcy5jaUNvbnRleHQucnVuSWQ7XG4gICAgICB9XG4gICAgICBpZiAodGhpcy5jaUNvbnRleHQucnVuTnVtYmVyKSB7XG4gICAgICAgIHRhZ3NbXCJ0ZXN0LWNpLXJ1bi1udW1iZXJcIl0gPSB0aGlzLmNpQ29udGV4dC5ydW5OdW1iZXI7XG4gICAgICB9XG4gICAgICBpZiAodGhpcy5jaUNvbnRleHQuY29tbWl0U2hhU2hvcnQpIHtcbiAgICAgICAgdGFnc1tcInRlc3QtZ2l0LWNvbW1pdFwiXSA9IHRoaXMuY2lDb250ZXh0LmNvbW1pdFNoYVNob3J0O1xuICAgICAgfVxuICAgICAgaWYgKHRoaXMuY2lDb250ZXh0LmJyYW5jaCkge1xuICAgICAgICB0YWdzW1widGVzdC1naXQtYnJhbmNoXCJdID0gdGhpcy5jaUNvbnRleHQuYnJhbmNoO1xuICAgICAgfVxuICAgIH1cblxuICAgIHJldHVybiB0YWdzIGFzIEludGVncmF0aW9uVGVzdFRhZ3M7XG4gIH1cblxuICAvKipcbiAgICogQ2hlY2tzIGlmIHJlc291cmNlcyBmcm9tIHRoaXMgcnVuIGFyZSBlbGlnaWJsZSBmb3IgY2xlYW51cFxuICAgKlxuICAgKiBAcGFyYW0gbm93IC0gQ3VycmVudCB0aW1lIChkZWZhdWx0cyB0byBub3cpXG4gICAqIEByZXR1cm5zIFdoZXRoZXIgY2xlYW51cCBpcyBlbGlnaWJsZVxuICAgKi9cbiAgcHVibGljIGlzQ2xlYW51cEVsaWdpYmxlKG5vdz86IERhdGUpOiBib29sZWFuIHtcbiAgICBjb25zdCBjdXJyZW50VGltZSA9IG5vdyB8fCBuZXcgRGF0ZSgpO1xuICAgIHJldHVybiBjdXJyZW50VGltZSA+PSB0aGlzLmNsZWFudXBBZnRlcjtcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXJpYWxpemVzIG1ldGFkYXRhIHRvIEpTT04gZm9yIGxvZ2dpbmdcbiAgICpcbiAgICogQHJldHVybnMgSlNPTi1zZXJpYWxpemFibGUgb2JqZWN0XG4gICAqL1xuICBwdWJsaWMgdG9KU09OKCk6IFJlY29yZDxzdHJpbmcsIGFueT4ge1xuICAgIHJldHVybiB7XG4gICAgICBydW5JZDogdGhpcy5ydW5JZCxcbiAgICAgIHRlc3ROYW1lOiB0aGlzLnRlc3ROYW1lLFxuICAgICAgY3JlYXRlZEF0OiB0aGlzLmNyZWF0ZWRBdC50b0lTT1N0cmluZygpLFxuICAgICAgY2xlYW51cEFmdGVyOiB0aGlzLmNsZWFudXBBZnRlci50b0lTT1N0cmluZygpLFxuICAgICAgbWF4QWdlSG91cnM6IHRoaXMubWF4QWdlSG91cnMsXG4gICAgICBhdXRvQ2xlYW51cDogdGhpcy5hdXRvQ2xlYW51cCxcbiAgICAgIGNsZWFudXBQb2xpY3k6IHRoaXMuY2xlYW51cFBvbGljeSxcbiAgICAgIGNpQ29udGV4dDogdGhpcy5jaUNvbnRleHQsXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBTYW5pdGl6ZXMgdGVzdCBuYW1lIHRvIGJlIEF6dXJlLWNvbXBsaWFudFxuICAgKlxuICAgKiBAcGFyYW0gbmFtZSAtIFJhdyB0ZXN0IG5hbWVcbiAgICogQHJldHVybnMgU2FuaXRpemVkIG5hbWVcbiAgICovXG4gIHByaXZhdGUgc2FuaXRpemVUZXN0TmFtZShuYW1lOiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIGxldCBzYW5pdGl6ZWQgPSBuYW1lXG4gICAgICAudG9Mb3dlckNhc2UoKVxuICAgICAgLy8gUmVwbGFjZSBzcGFjZXMgYW5kIHNwZWNpYWwgY2hhcmFjdGVycyB3aXRoIGh5cGhlbnNcbiAgICAgIC5yZXBsYWNlKC9bXmEtejAtOS1dL2csIFwiLVwiKVxuICAgICAgLy8gUmVtb3ZlIGNvbnNlY3V0aXZlIGh5cGhlbnNcbiAgICAgIC5yZXBsYWNlKC8tKy9nLCBcIi1cIilcbiAgICAgIC8vIFJlbW92ZSBsZWFkaW5nL3RyYWlsaW5nIGh5cGhlbnNcbiAgICAgIC5yZXBsYWNlKC9eLSt8LSskL2csIFwiXCIpO1xuXG4gICAgLy8gVHJ1bmNhdGUgdG8gNjMgY2hhcmFjdGVycyAoRE5TIGxhYmVsIGxpbWl0KVxuICAgIGlmIChzYW5pdGl6ZWQubGVuZ3RoID4gNjMpIHtcbiAgICAgIHNhbml0aXplZCA9IHNhbml0aXplZC5zdWJzdHJpbmcoMCwgNjMpLnJlcGxhY2UoLy0rJC8sIFwiXCIpO1xuICAgIH1cblxuICAgIHJldHVybiBzYW5pdGl6ZWQ7XG4gIH1cbn1cblxuLyoqXG4gKiBEZXRlY3RzIGFuZCBleHRyYWN0cyBDSSBjb250ZXh0IGZyb20gZW52aXJvbm1lbnRcbiAqXG4gKiBAcmV0dXJucyBDSSBjb250ZXh0IG9yIHVuZGVmaW5lZCBpZiBub3QgaW4gQ0lcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRldGVjdENJQ29udGV4dCgpOiBDSUNvbnRleHQgfCB1bmRlZmluZWQge1xuICAvLyBEZXRlY3QgR2l0SHViIEFjdGlvbnNcbiAgaWYgKHByb2Nlc3MuZW52LkdJVEhVQl9BQ1RJT05TID09PSBcInRydWVcIikge1xuICAgIHJldHVybiB7XG4gICAgICBwbGF0Zm9ybTogXCJnaXRodWItYWN0aW9uc1wiLFxuICAgICAgcGlwZWxpbmVJZDogcHJvY2Vzcy5lbnYuR0lUSFVCX1dPUktGTE9XLFxuICAgICAgcnVuSWQ6IHByb2Nlc3MuZW52LkdJVEhVQl9SVU5fSUQsXG4gICAgICBydW5OdW1iZXI6IHByb2Nlc3MuZW52LkdJVEhVQl9SVU5fTlVNQkVSLFxuICAgICAgY29tbWl0U2hhOiBwcm9jZXNzLmVudi5HSVRIVUJfU0hBLFxuICAgICAgY29tbWl0U2hhU2hvcnQ6IHByb2Nlc3MuZW52LkdJVEhVQl9TSEE/LnN1YnN0cmluZygwLCA3KSxcbiAgICAgIGJyYW5jaDogcHJvY2Vzcy5lbnYuR0lUSFVCX1JFRl9OQU1FLFxuICAgICAgcmVwb3NpdG9yeTogcHJvY2Vzcy5lbnYuR0lUSFVCX1JFUE9TSVRPUlksXG4gICAgfTtcbiAgfVxuXG4gIC8vIERldGVjdCBBenVyZSBEZXZPcHNcbiAgaWYgKHByb2Nlc3MuZW52LlRGX0JVSUxEID09PSBcIlRydWVcIikge1xuICAgIHJldHVybiB7XG4gICAgICBwbGF0Zm9ybTogXCJhenVyZS1kZXZvcHNcIixcbiAgICAgIHBpcGVsaW5lSWQ6IHByb2Nlc3MuZW52LkJVSUxEX0RFRklOSVRJT05OQU1FLFxuICAgICAgcnVuSWQ6IHByb2Nlc3MuZW52LkJVSUxEX0JVSUxESUQsXG4gICAgICBydW5OdW1iZXI6IHByb2Nlc3MuZW52LkJVSUxEX0JVSUxETlVNQkVSLFxuICAgICAgY29tbWl0U2hhOiBwcm9jZXNzLmVudi5CVUlMRF9TT1VSQ0VWRVJTSU9OLFxuICAgICAgY29tbWl0U2hhU2hvcnQ6IHByb2Nlc3MuZW52LkJVSUxEX1NPVVJDRVZFUlNJT04/LnN1YnN0cmluZygwLCA3KSxcbiAgICAgIGJyYW5jaDogcHJvY2Vzcy5lbnYuQlVJTERfU09VUkNFQlJBTkNITkFNRSxcbiAgICAgIHJlcG9zaXRvcnk6IHByb2Nlc3MuZW52LkJVSUxEX1JFUE9TSVRPUllfTkFNRSxcbiAgICB9O1xuICB9XG5cbiAgLy8gRGV0ZWN0IGdlbmVyaWMgQ0lcbiAgaWYgKHByb2Nlc3MuZW52LkNJID09PSBcInRydWVcIikge1xuICAgIHJldHVybiB7XG4gICAgICBwbGF0Zm9ybTogXCJnZW5lcmljLWNpXCIsXG4gICAgICBjb21taXRTaGFTaG9ydDogXCJjaVwiLFxuICAgIH07XG4gIH1cblxuICAvLyBMb2NhbCBleGVjdXRpb25cbiAgcmV0dXJuIHtcbiAgICBwbGF0Zm9ybTogXCJsb2NhbFwiLFxuICAgIGNvbW1pdFNoYVNob3J0OiBcImxvY2FsXCIsXG4gIH07XG59XG4iXX0=

package/lib/testing/lib/naming.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Resource naming utilities for integration tests
+ *
+ * Provides functions for generating unique, Azure-compliant
+ * resource names with proper length constraints and character restrictions.
+ */
+/**
+ * Azure resource naming constraints
+ */
+interface ResourceConstraints {
+    maxLength: number;
+    allowHyphens: boolean;
+    allowUnderscores: boolean;
+    allowPeriods: boolean;
+    casePolicy: "lower" | "upper" | "any";
+    allowedPattern?: RegExp;
+}
+/**
+ * Options for generating resource names
+ */
+export interface NameGenerationOptions {
+    /**
+     * Azure resource type (e.g., 'Microsoft.Resources/resourceGroups')
+     */
+    resourceType: string;
+    /**
+     * Test name or identifier
+     */
+    testName: string;
+    /**
+     * Test run UUID
+     */
+    runId: string;
+    /**
+     * Optional custom identifier to include in name
+     */
+    customIdentifier?: string;
+}
+/**
+ * Generates a unique, Azure-compliant resource name
+ *
+ * Creates names in format: {prefix}-{identifier}-{suffix} or
+ * {prefix}{identifier}{suffix} depending on resource constraints.
+ *
+ * @param options - Name generation options
+ * @returns Azure-compliant resource name
+ *
+ * @example
+ * generateResourceName({
+ *   resourceType: 'Microsoft.Resources/resourceGroups',
+ *   testName: 'storage-test',
+ *   runId: 'a1b2c3d4-e5f6-4789-b012-3456789abcde'
+ * });
+ * // Returns: 'rg-storage-test-a1b2c3'
+ *
+ * generateResourceName({
+ *   resourceType: 'Microsoft.Storage/storageAccounts',
+ *   testName: 'basic-test',
+ *   runId: 'a1b2c3d4-e5f6-4789-b012-3456789abcde'
+ * });
+ * // Returns: 'stbasictesta1b2c3'
+ */
+export declare function generateResourceName(options: NameGenerationOptions): string;
+/**
+ * Gets the resource type prefix
+ *
+ * @param resourceType - Azure resource type
+ * @returns Short prefix for the resource type
+ */
+export declare function getResourcePrefix(resourceType: string): string;
+/**
+ * Sanitizes a test identifier to be Azure-compliant
+ *
+ * @param identifier - Raw identifier
+ * @param constraints - Resource naming constraints
+ * @returns Sanitized identifier
+ */
+export declare function sanitizeIdentifier(identifier: string, constraints: ResourceConstraints): string;
+/**
+ * Generates a short unique ID from a UUID
+ *
+ * Takes the first 6 characters of the UUID (without hyphens)
+ * to create a short, unique suffix.
+ *
+ * @param runId - UUID v4 run ID
+ * @returns Short ID (6 characters)
+ */
+export declare function generateShortId(runId: string): string;
+/**
+ * Gets resource naming constraints for a resource type
+ *
+ * @param resourceType - Azure resource type
+ * @returns Naming constraints for the resource type
+ */
+export declare function getResourceConstraints(resourceType: string): ResourceConstraints;
+export {};