@microsoft/terraform-cdk-constructs 1.0.0 → 1.2.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,180 @@
+"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
+        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.2.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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0YWRhdGEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGVzdGluZy9saWIvbWV0YWRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7OztBQXNRQSwwQ0EwQ0M7O0FBaFREOzs7Ozs7R0FNRztBQUVILCtCQUFvQztBQThFcEM7Ozs7OztHQU1HO0FBQ0gsTUFBYSxlQUFlO0lBeUMxQjs7Ozs7T0FLRztJQUNILFlBQVksUUFBZ0IsRUFBRSxPQUF3QjtRQUNwRCxJQUFJLENBQUMsS0FBSyxHQUFHLElBQUEsU0FBTSxHQUFFLENBQUM7UUFDdEIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDaEQsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO1FBQzVCLElBQUksQ0FBQyxXQUFXLEdBQUcsT0FBTyxFQUFFLFdBQVcsSUFBSSxDQUFDLENBQUM7UUFDN0MsSUFBSSxDQUFDLFdBQVcsR0FBRyxPQUFPLEVBQUUsV0FBVyxJQUFJLElBQUksQ0FBQztRQUNoRCxJQUFJLENBQUMsYUFBYSxHQUFHLE9BQU8sRUFBRSxhQUFhLElBQUksV0FBVyxDQUFDO1FBQzNELElBQUksQ0FBQyxZQUFZLEdBQUcsSUFBSSxJQUFJLENBQzFCLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLFdBQVcsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FDN0QsQ0FBQztRQUNGLElBQUksQ0FBQyxTQUFTLEdBQUcsZUFBZSxFQUFFLENBQUM7SUFDckMsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxrQkFBa0I7UUFDdkIsd0NBQXdDO1FBQ3hDLE1BQU0sSUFBSSxHQUEyQjtZQUNuQywwQkFBMEI7WUFDMUIsYUFBYSxFQUFFLElBQUksQ0FBQyxLQUFLO1lBQ3pCLFdBQVcsRUFBRSxJQUFJLENBQUMsUUFBUTtZQUMxQixvQkFBb0Is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LG1CQUFtQjtZQUMxQyxjQUFjLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxtQkFBbUIsRUFBRSxTQUFTLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUNoRSxNQUFNLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxzQkFBc0I7WUFDMUMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMscUJBQXFCO1NBQzlDLENBQUM7SUFDSixDQUFDO0lBRUQsb0JBQW9CO0lBQ3BCLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUM7UUFDOUIsT0FBTztZQUNMLFFBQVEsRUFBRSxZQUFZO1lBQ3RCLGNBQWMsRUFBRSxJQUFJO1NBQ3JCLENBQUM7SUFDSixDQUFDO0lBRUQsa0JBQWtCO0lBQ2xCLE9BQU87UUFDTCxRQUFRLEVBQUUsT0FBTztRQUNqQixjQUFjLEVBQUUsT0FBTztLQUN4QixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogVGVzdCBydW4gbWV0YWRhdGEgbWFuYWdlbWVudFxuICpcbiAqIFByb3ZpZGVzIGNsYXNzZXMgYW5kIHV0aWxpdGllcyBmb3IgZ2VuZXJhdGluZyBhbmQgbWFuYWdpbmdcbiAqIGludGVncmF0aW9uIHRlc3QgbWV0YWRhdGEgaW5jbHVkaW5nIHVuaXF1ZSBJRHMsIHRpbWVzdGFtcHMsXG4gKiBDSSBjb250ZXh0LCBhbmQgc3lzdGVtIHRhZ3MuXG4gKi9cblxuaW1wb3J0IHsgdjQgYXMgdXVpZHY0IH0gZnJvbSBcInV1aWRcIjtcblxuLyoqXG4gKiBDSS9DRCBwaXBlbGluZSBjb250ZXh0XG4gKlxuICogRXh0cmFjdGVkIGZyb20gZW52aXJvbm1lbnQgdmFyaWFibGVzIGR1cmluZyB0ZXN0IGV4ZWN1dGlvbi5cbiAqIEVuYWJsZXMgdHJhY2luZyByZXNvdXJjZXMgYmFjayB0byBzcGVjaWZpYyBwaXBlbGluZSBydW5zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENJQ29udGV4dCB7XG4gIC8qKlxuICAgKiBDSSBwbGF0Zm9ybSAoJ2dpdGh1Yi1hY3Rpb25zJywgJ2F6dXJlLWRldm9wcycsICdnZW5lcmljLWNpJywgJ2xvY2FsJylcbiAgICovXG4gIHJlYWRvbmx5IHBsYXRmb3JtOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdEh1YiBBY3Rpb25zIHdvcmtmbG93IElEIG9yIGVxdWl2YWxlbnRcbiAgICovXG4gIHJlYWRvbmx5IHBpcGVsaW5lSWQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdEh1YiBBY3Rpb25zIHJ1biBJRCBvciBlcXVpdmFsZW50XG4gICAqL1xuICByZWFkb25seSBydW5JZD86IHN0cmluZztcblxuICAvKipcbiAgICogR2l0SHViIEFjdGlvbnMgcnVuIG51bWJlciBvciBlcXVpdmFsZW50XG4gICAqL1xuICByZWFkb25seSBydW5OdW1iZXI/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdCBjb21taXQgU0hBIChmdWxsKVxuICAgKi9cbiAgcmVhZG9ubHkgY29tbWl0U2hhPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBHaXQgY29tbWl0IFNIQSAoc2hvcnQsIDcgY2hhcnMpXG4gICAqL1xuICByZWFkb25seSBjb21taXRTaGFTaG9ydD86IHN0cmluZztcblxuICAvKipcbiAgICogR2l0IGJyYW5jaCBuYW1lXG4gICAqL1xuICByZWFkb25seSBicmFuY2g/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdpdCByZXBvc2l0b3J5IG5hbWVcbiAgICovXG4gIHJlYWRvbmx5IHJlcG9zaXRvcnk/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogSW50ZWdyYXRpb24gdGVzdCBzeXN0ZW0gdGFnc1xuICpcbiAqIFJldHVybnMgYSByZWNvcmQgb2YgdGFnIGtleS12YWx1ZSBwYWlycyBmb3IgQXp1cmUgcmVzb3VyY2VzLlxuICogVXNlcyBBenVyZSB0YWcgbmFtaW5nIGNvbnZlbnRpb25zIHdpdGggY29sb25zIGFuZCBoeXBoZW5zLlxuICovXG5leHBvcnQgdHlwZSBJbnRlZ3JhdGlvblRlc3RUYWdzID0gUmVjb3JkPHN0cmluZywgc3RyaW5nPjtcblxuLyoqXG4gKiBUZXN0IHJ1biBjb25maWd1cmF0aW9uIG9wdGlvbnNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUZXN0UnVuT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBNYXhpbXVtIGFnZSBpbiBob3VycyBiZWZvcmUgY2xlYW51cCBlbGlnaWJsZSAoZGVmYXVsdDogNClcbiAgICovXG4gIHJlYWRvbmx5IG1heEFnZUhvdXJzPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBFbmFibGUgYXV0b21hdGVkIGNsZWFudXAgKGRlZmF1bHQ6IHRydWUpXG4gICAqL1xuICByZWFkb25seSBhdXRvQ2xlYW51cD86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIENsZWFudXAgcG9saWN5IChkZWZhdWx0OiAnaW1tZWRpYXRlJylcbiAgICovXG4gIHJlYWRvbmx5IGNsZWFudXBQb2xpY3k/OiBcImltbWVkaWF0ZVwiIHwgXCJkZWxheWVkXCIgfCBcIm1hbnVhbFwiO1xufVxuXG4vKipcbiAqIE1ldGFkYXRhIGZvciBhbiBpbnRlZ3JhdGlvbiB0ZXN0IHJ1blxuICpcbiAqIEdlbmVyYXRlZCBvbmNlIHBlciB0ZXN0IGV4ZWN1dGlvbiBhbmQgc2hhcmVkIGFjcm9zcyBhbGwgcmVzb3VyY2VzXG4gKiBpbiB0aGF0IHRlc3QuIFByb3ZpZGVzIHVuaXF1ZSBpZGVudGlmaWNhdGlvbiwgdGVtcG9yYWwgdHJhY2tpbmcsXG4gKiBhbmQgQ0kvQ0QgY29udGV4dC5cbiAqL1xuZXhwb3J0IGNsYXNzIFRlc3RSdW5NZXRhZGF0YSB7XG4gIC8qKlxuICAgKiBVbmlxdWUgaWRlbnRpZmllciBmb3IgdGhpcyB0ZXN0IHJ1biAoVVVJRCB2NClcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBydW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBTYW5pdGl6ZWQgdGVzdCBuYW1lIGZyb20gdGhlIGRlc2NyaWJlIGJsb2NrXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgdGVzdE5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGltZXN0YW1wIHdoZW4gdGhlIHRlc3QgcnVuIHN0YXJ0ZWRcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBjcmVhdGVkQXQ6IERhdGU7XG5cbiAgLyoqXG4gICAqIENsZWFudXAgYWZ0ZXIgdGltZXN0YW1wIChjcmVhdGVkQXQgKyBtYXhBZ2VIb3VycylcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBjbGVhbnVwQWZ0ZXI6IERhdGU7XG5cbiAgLyoqXG4gICAqIE1heGltdW0gYWdlIGluIGhvdXJzIGJlZm9yZSBjbGVhbnVwIGVsaWdpYmxlXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgbWF4QWdlSG91cnM6IG51bWJlcjtcblxuICAvKipcbiAgICogRW5hYmxlIGF1dG9tYXRlZCBjbGVhbnVwXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgYXV0b0NsZWFudXA6IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIENsZWFudXAgcG9saWN5XG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgY2xlYW51cFBvbGljeTogXCJpbW1lZGlhdGVcIiB8IFwiZGVsYXllZFwiIHwgXCJtYW51YWxcIjtcblxuICAvKipcbiAgICogQ0kvQ0QgY29udGV4dCAocG9wdWxhdGVkIGZyb20gZW52aXJvbm1lbnQgdmFyaWFibGVzKVxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGNpQ29udGV4dD86IENJQ29udGV4dDtcblxuICAvKipcbiAgICogQ3JlYXRlcyBuZXcgdGVzdCBydW4gbWV0YWRhdGFcbiAgICpcbiAgICogQHBhcmFtIHRlc3ROYW1lIC0gVGVzdCBuYW1lICh3aWxsIGJlIHNhbml0aXplZClcbiAgICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25hbCBjb25maWd1cmF0aW9uXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih0ZXN0TmFtZTogc3RyaW5nLCBvcHRpb25zPzogVGVzdFJ1bk9wdGlvbnMpIHtcbiAgICB0aGlzLnJ1bklkID0gdXVpZHY0KCk7XG4gICAgdGhpcy50ZXN0TmFtZSA9IHRoaXMuc2FuaXRpemVUZXN0TmFtZSh0ZXN0TmFtZSk7XG4gICAgdGhpcy5jcmVhdGVkQXQgPSBuZXcgRGF0ZSgpO1xuICAgIHRoaXMubWF4QWdlSG91cnMgPSBvcHRpb25zPy5tYXhBZ2VIb3VycyA/PyA0O1xuICAgIHRoaXMuYXV0b0NsZWFudXAgPSBvcHRpb25zPy5hdXRvQ2xlYW51cCA/PyB0cnVlO1xuICAgIHRoaXMuY2xlYW51cFBvbGljeSA9IG9wdGlvbnM/LmNsZWFudXBQb2xpY3kgPz8gXCJpbW1lZGlhdGVcIjtcbiAgICB0aGlzLmNsZWFudXBBZnRlciA9IG5ldyBEYXRlKFxuICAgICAgdGhpcy5jcmVhdGVkQXQuZ2V0VGltZSgpICsgdGhpcy5tYXhBZ2VIb3VycyAqIDYwICogNjAgKiAxMDAwLFxuICAgICk7XG4gICAgdGhpcy5jaUNvbnRleHQgPSBkZXRlY3RDSUNvbnRleHQoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZW5lcmF0ZXMgc3lzdGVtIHRhZ3MgZm9yIHJlc291cmNlc1xuICAgKlxuICAgKiBAcmV0dXJucyBJbnRlZ3JhdGlvbiB0ZXN0IHN5c3RlbSB0YWdzXG4gICAqL1xuICBwdWJsaWMgZ2VuZXJhdGVTeXN0ZW1UYWdzKCk6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4ge1xuICAgIC8vIEJ1aWxkIHRhZ3Mgb2JqZWN0IHdpdGggYWxsIHByb3BlcnRpZXNcbiAgICBjb25zdCB0YWdzOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+ID0ge1xuICAgICAgLy8gUmVzb3VyY2UgSWRlbnRpZmljYXRpb25cbiAgICAgIFwidGVzdDpydW4taWRcIjogdGhpcy5ydW5JZCxcbiAgICAgIFwidGVzdDpuYW1lXCI6IHRoaXMudGVzdE5hbWUsXG4gICAgICBcInRlc3Q6cmVzb3VyY2UtdHlwZVwiOiBcImludGVncmF0aW9uLXRlc3RcIixcblxuICAgICAgLy8gVGVtcG9yYWwgVHJhY2tpbmdcbiAgICAgIFwidGVzdDpjcmVhdGVkLWF0XCI6IHRoaXMuY3JlYXRlZEF0LnRvSVNPU3RyaW5nKCksXG4gICAgICBcInRlc3Q6Y2xlYW51cC1hZnRlclwiOiB0aGlzLmNsZWFudXBBZnRlci50b0lTT1N0cmluZygpLFxuICAgICAgXCJ0ZXN0Om1heC1hZ2UtaG91cnNcIjogdGhpcy5tYXhBZ2VIb3Vycy50b1N0cmluZygpLFxuXG4gICAgICAvLyBMaWZlY3ljbGUgTWFuYWdlbWVudFxuICAgICAgXCJ0ZXN0Om1hbmFnZWQtYnlcIjogXCJ0ZXJyYWZvcm0tY2RrLWNvbnN0cnVjdHMtdGVzdHNcIixcbiAgICAgIFwidGVzdDphdXRvLWNsZWFudXBcIjogdGhpcy5hdXRvQ2xlYW51cC50b1N0cmluZygpLFxuICAgICAgXCJ0ZXN0OmNsZWFudXAtcG9saWN5XCI6IHRoaXMuY2xlYW51cFBvbGljeSxcblxuICAgICAgLy8gQmFja3dhcmQgQ29tcGF0aWJpbGl0eVxuICAgICAgZW52aXJvbm1lbnQ6IFwiaW50ZWdyYXRpb24tdGVzdFwiLFxuICAgICAgcHVycG9zZTogXCJpbnRlZ3JhdGlvbi10ZXN0XCIsXG4gICAgfTtcblxuICAgIC8vIEFkZCBDSS9DRCBjb250ZXh0IGlmIGF2YWlsYWJsZVxuICAgIGlmICh0aGlzLmNpQ29udGV4dCkge1xuICAgICAgaWYgKHRoaXMuY2lDb250ZXh0LnBpcGVsaW5lSWQpIHtcbiAgICAgICAgdGFnc1tcInRlc3Q6Y2ktcGlwZWxpbmVcIl0gPSB0aGlzLmNpQ29udGV4dC5waXBlbGluZUlkO1xuICAgICAgfVxuICAgICAgaWYgKHRoaXMuY2lDb250ZXh0LnJ1bklkKSB7XG4gICAgICAgIHRhZ3NbXCJ0ZXN0OmNpLXJ1bi1pZFwiXSA9IHRoaXMuY2lDb250ZXh0LnJ1bklkO1xuICAgICAgfVxuICAgICAgaWYgKHRoaXMuY2lDb250ZXh0LnJ1bk51bWJlcikge1xuICAgICAgICB0YWdzW1widGVzdDpjaS1ydW4tbnVtYmVyXCJdID0gdGhpcy5jaUNvbnRleHQucnVuTnVtYmVyO1xuICAgICAgfVxuICAgICAgaWYgKHRoaXMuY2lDb250ZXh0LmNvbW1pdFNoYVNob3J0KSB7XG4gICAgICAgIHRhZ3NbXCJ0ZXN0OmdpdC1jb21taXRcIl0gPSB0aGlzLmNpQ29udGV4dC5jb21taXRTaGFTaG9ydDtcbiAgICAgIH1cbiAgICAgIGlmICh0aGlzLmNpQ29udGV4dC5icmFuY2gpIHtcbiAgICAgICAgdGFnc1tcInRlc3Q6Z2l0LWJyYW5jaFwiXSA9IHRoaXMuY2lDb250ZXh0LmJyYW5jaDtcbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gdGFncyBhcyBJbnRlZ3JhdGlvblRlc3RUYWdzO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrcyBpZiByZXNvdXJjZXMgZnJvbSB0aGlzIHJ1biBhcmUgZWxpZ2libGUgZm9yIGNsZWFudXBcbiAgICpcbiAgICogQHBhcmFtIG5vdyAtIEN1cnJlbnQgdGltZSAoZGVmYXVsdHMgdG8gbm93KVxuICAgKiBAcmV0dXJucyBXaGV0aGVyIGNsZWFudXAgaXMgZWxpZ2libGVcbiAgICovXG4gIHB1YmxpYyBpc0NsZWFudXBFbGlnaWJsZShub3c/OiBEYXRlKTogYm9vbGVhbiB7XG4gICAgY29uc3QgY3VycmVudFRpbWUgPSBub3cgfHwgbmV3IERhdGUoKTtcbiAgICByZXR1cm4gY3VycmVudFRpbWUgPj0gdGhpcy5jbGVhbnVwQWZ0ZXI7XG4gIH1cblxuICAvKipcbiAgICogU2VyaWFsaXplcyBtZXRhZGF0YSB0byBKU09OIGZvciBsb2dnaW5nXG4gICAqXG4gICAqIEByZXR1cm5zIEpTT04tc2VyaWFsaXphYmxlIG9iamVjdFxuICAgKi9cbiAgcHVibGljIHRvSlNPTigpOiBSZWNvcmQ8c3RyaW5nLCBhbnk+IHtcbiAgICByZXR1cm4ge1xuICAgICAgcnVuSWQ6IHRoaXMucnVuSWQsXG4gICAgICB0ZXN0TmFtZTogdGhpcy50ZXN0TmFtZSxcbiAgICAgIGNyZWF0ZWRBdDogdGhpcy5jcmVhdGVkQXQudG9JU09TdHJpbmcoKSxcbiAgICAgIGNsZWFudXBBZnRlcjogdGhpcy5jbGVhbnVwQWZ0ZXIudG9JU09TdHJpbmcoKSxcbiAgICAgIG1heEFnZUhvdXJzOiB0aGlzLm1heEFnZUhvdXJzLFxuICAgICAgYXV0b0NsZWFudXA6IHRoaXMuYXV0b0NsZWFudXAsXG4gICAgICBjbGVhbnVwUG9saWN5OiB0aGlzLmNsZWFudXBQb2xpY3ksXG4gICAgICBjaUNvbnRleHQ6IHRoaXMuY2lDb250ZXh0LFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogU2FuaXRpemVzIHRlc3QgbmFtZSB0byBiZSBBenVyZS1jb21wbGlhbnRcbiAgICpcbiAgICogQHBhcmFtIG5hbWUgLSBSYXcgdGVzdCBuYW1lXG4gICAqIEByZXR1cm5zIFNhbml0aXplZCBuYW1lXG4gICAqL1xuICBwcml2YXRlIHNhbml0aXplVGVzdE5hbWUobmFtZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgICBsZXQgc2FuaXRpemVkID0gbmFtZVxuICAgICAgLnRvTG93ZXJDYXNlKClcbiAgICAgIC8vIFJlcGxhY2Ugc3BhY2VzIGFuZCBzcGVjaWFsIGNoYXJhY3RlcnMgd2l0aCBoeXBoZW5zXG4gICAgICAucmVwbGFjZSgvW15hLXowLTktXS9nLCBcIi1cIilcbiAgICAgIC8vIFJlbW92ZSBjb25zZWN1dGl2ZSBoeXBoZW5zXG4gICAgICAucmVwbGFjZSgvLSsvZywgXCItXCIpXG4gICAgICAvLyBSZW1vdmUgbGVhZGluZy90cmFpbGluZyBoeXBoZW5zXG4gICAgICAucmVwbGFjZSgvXi0rfC0rJC9nLCBcIlwiKTtcblxuICAgIC8vIFRydW5jYXRlIHRvIDYzIGNoYXJhY3RlcnMgKEROUyBsYWJlbCBsaW1pdClcbiAgICBpZiAoc2FuaXRpemVkLmxlbmd0aCA+IDYzKSB7XG4gICAgICBzYW5pdGl6ZWQgPSBzYW5pdGl6ZWQuc3Vic3RyaW5nKDAsIDYzKS5yZXBsYWNlKC8tKyQvLCBcIlwiKTtcbiAgICB9XG5cbiAgICByZXR1cm4gc2FuaXRpemVkO1xuICB9XG59XG5cbi8qKlxuICogRGV0ZWN0cyBhbmQgZXh0cmFjdHMgQ0kgY29udGV4dCBmcm9tIGVudmlyb25tZW50XG4gKlxuICogQHJldHVybnMgQ0kgY29udGV4dCBvciB1bmRlZmluZWQgaWYgbm90IGluIENJXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZXRlY3RDSUNvbnRleHQoKTogQ0lDb250ZXh0IHwgdW5kZWZpbmVkIHtcbiAgLy8gRGV0ZWN0IEdpdEh1YiBBY3Rpb25zXG4gIGlmIChwcm9jZXNzLmVudi5HSVRIVUJfQUNUSU9OUyA9PT0gXCJ0cnVlXCIpIHtcbiAgICByZXR1cm4ge1xuICAgICAgcGxhdGZvcm06IFwiZ2l0aHViLWFjdGlvbnNcIixcbiAgICAgIHBpcGVsaW5lSWQ6IHByb2Nlc3MuZW52LkdJVEhVQl9XT1JLRkxPVyxcbiAgICAgIHJ1bklkOiBwcm9jZXNzLmVudi5HSVRIVUJfUlVOX0lELFxuICAgICAgcnVuTnVtYmVyOiBwcm9jZXNzLmVudi5HSVRIVUJfUlVOX05VTUJFUixcbiAgICAgIGNvbW1pdFNoYTogcHJvY2Vzcy5lbnYuR0lUSFVCX1NIQSxcbiAgICAgIGNvbW1pdFNoYVNob3J0OiBwcm9jZXNzLmVudi5HSVRIVUJfU0hBPy5zdWJzdHJpbmcoMCwgNyksXG4gICAgICBicmFuY2g6IHByb2Nlc3MuZW52LkdJVEhVQl9SRUZfTkFNRSxcbiAgICAgIHJlcG9zaXRvcnk6IHByb2Nlc3MuZW52LkdJVEhVQl9SRVBPU0lUT1JZLFxuICAgIH07XG4gIH1cblxuICAvLyBEZXRlY3QgQXp1cmUgRGV2T3BzXG4gIGlmIChwcm9jZXNzLmVudi5URl9CVUlMRCA9PT0gXCJUcnVlXCIpIHtcbiAgICByZXR1cm4ge1xuICAgICAgcGxhdGZvcm06IFwiYXp1cmUtZGV2b3BzXCIsXG4gICAgICBwaXBlbGluZUlkOiBwcm9jZXNzLmVudi5CVUlMRF9ERUZJTklUSU9OTkFNRSxcbiAgICAgIHJ1bklkOiBwcm9jZXNzLmVudi5CVUlMRF9CVUlMRElELFxuICAgICAgcnVuTnVtYmVyOiBwcm9jZXNzLmVudi5CVUlMRF9CVUlMRE5VTUJFUixcbiAgICAgIGNvbW1pdFNoYTogcHJvY2Vzcy5lbnYuQlVJTERfU09VUkNFVkVSU0lPTixcbiAgICAgIGNvbW1pdFNoYVNob3J0OiBwcm9jZXNzLmVudi5CVUlMRF9TT1VSQ0VWRVJTSU9OPy5zdWJzdHJpbmcoMCwgNyksXG4gICAgICBicmFuY2g6IHByb2Nlc3MuZW52LkJVSUxEX1NPVVJDRUJSQU5DSE5BTUUsXG4gICAgICByZXBvc2l0b3J5OiBwcm9jZXNzLmVudi5CVUlMRF9SRVBPU0lUT1JZX05BTUUsXG4gICAgfTtcbiAgfVxuXG4gIC8vIERldGVjdCBnZW5lcmljIENJXG4gIGlmIChwcm9jZXNzLmVudi5DSSA9PT0gXCJ0cnVlXCIpIHtcbiAgICByZXR1cm4ge1xuICAgICAgcGxhdGZvcm06IFwiZ2VuZXJpYy1jaVwiLFxuICAgICAgY29tbWl0U2hhU2hvcnQ6IFwiY2lcIixcbiAgICB9O1xuICB9XG5cbiAgLy8gTG9jYWwgZXhlY3V0aW9uXG4gIHJldHVybiB7XG4gICAgcGxhdGZvcm06IFwibG9jYWxcIixcbiAgICBjb21taXRTaGFTaG9ydDogXCJsb2NhbFwiLFxuICB9O1xufVxuIl19

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 {};