minimum api version check

Author: linglingye001

src/appConfigurationClient.ts

@@ -81,8 +81,7 @@ export function getFeatureFlagClientOptions(options?: ConfigurationClientOptions
     if (options === undefined) {
         return undefined;
     }
-    if (options.apiVersion !== undefined &&
-        options.apiVersion !== KnownAppConfigurationApiVersion.V20260501Preview) {
+    if (options.apiVersion !== undefined && !isSupportedApiVersion(options.apiVersion)) {
         throw new ArgumentError(ErrorMessages.API_VERSION_NOT_SUPPORTED);
     }
 
@@ -96,3 +95,23 @@ export function getFeatureFlagClientOptions(options?: ConfigurationClientOptions
         ...(options.additionalPolicies && { additionalPolicies: [...options.additionalPolicies] })
     };
 }
+
+function isSupportedApiVersion(apiVersion: string): boolean {
+    const apiVersionDate = parseApiVersionDate(apiVersion);
+    const minimumApiVersionDate = parseApiVersionDate(KnownAppConfigurationApiVersion.V20260501Preview)!;
+    return apiVersionDate !== undefined && apiVersionDate >= minimumApiVersionDate;
+}
+
+function parseApiVersionDate(apiVersion: string): number | undefined {
+    const match = /^(\d{4}-\d{2}-\d{2})(?:-[0-9A-Za-z.-]+)?$/.exec(apiVersion);
+    if (match === null) {
+        return undefined;
+    }
+
+    const date = new Date(`${match[1]}T00:00:00Z`);
+    if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== match[1]) {
+        return undefined;
+    }
+
+    return date.getTime();
+}

src/common/errorMessages.ts

@@ -20,7 +20,7 @@ export const enum ErrorMessages {
     INVALID_KEY_FILTER = "Key filter cannot be null or empty.",
     INVALID_LABEL_FILTER = "The characters '*' and ',' are not supported in label filters.",
     INVALID_TAG_FILTER = "Tag filter must follow the format 'tagName=tagValue'",
-    API_VERSION_NOT_SUPPORTED = "The App Configuration provider requires API version '2026-05-01-preview'.",
+    API_VERSION_NOT_SUPPORTED = "The App Configuration provider requires API version '2026-05-01-preview' or later.",
     CONNECTION_STRING_OR_ENDPOINT_MISSED = "A connection string or an endpoint with credential must be specified to create a client.",
     REPLICA_DISCOVERY_NOT_SUPPORTED = "Replica discovery is not supported when loading from Azure Front Door. For guidance on how to take advantage of geo-replication when Azure Front Door is used, visit https://aka.ms/appconfig/geo-replication-with-afd",
     LOAD_BALANCING_NOT_SUPPORTED = "Load balancing is not supported when loading from Azure Front Door. For guidance on how to take advantage of geo-replication when Azure Front Door is used, visit https://aka.ms/appconfig/geo-replication-with-afd",

test/clientOptions.test.ts

@@ -53,6 +53,22 @@ describe("custom client options", function () {
         expect(createClientManager).throws(ErrorMessages.API_VERSION_NOT_SUPPORTED);
     });
 
+    it("should reject a malformed API version", () => {
+        const createFeatureFlagClientOptions = () => getFeatureFlagClientOptions({
+            apiVersion: "2026-13-01-preview"
+        });
+
+        expect(createFeatureFlagClientOptions).throws(ErrorMessages.API_VERSION_NOT_SUPPORTED);
+    });
+
+    it("should allow the stable API version with the minimum date", () => {
+        expect(() => getFeatureFlagClientOptions({ apiVersion: "2026-05-01" })).not.throws();
+    });
+
+    it("should allow an API version later than the minimum", () => {
+        expect(() => getFeatureFlagClientOptions({ apiVersion: "2026-06-01-preview" })).not.throws();
+    });
+
     it("should use equivalent options for configuration and feature flag clients", () => {
         const countPolicy = new HttpRequestCountPolicy();
         const configurationClientOptions = getClientOptions({