CFP AVAD: Adds Container IsFeedRangePartOfAsync support for FeedRange

Microsoft.Azure.Cosmos.Encryption.Custom/src/EncryptionContainer.cs

@@ -1028,6 +1028,19 @@ public override ChangeFeedProcessorBuilder GetChangeFeedProcessorBuilderWithAllV
                 onChangesDelegate);
         }
 #endif
+
+#if SDKPROJECTREF
+        public override Task<bool> IsFeedRangePartOfAsync(
+            Cosmos.FeedRange x,
+            Cosmos.FeedRange y,
+            CancellationToken cancellationToken = default)
+        {
+            return this.container.IsFeedRangePartOfAsync(
+                x,
+                y,
+                cancellationToken);
+        }
+#endif
         private async Task<ResponseMessage> ReadManyItemsHelperAsync(
            IReadOnlyList<(string id, PartitionKey partitionKey)> items,
            ReadManyRequestOptions readManyRequestOptions = null,

Microsoft.Azure.Cosmos.Encryption/src/EncryptionContainer.cs

@@ -762,6 +762,14 @@ public override ChangeFeedProcessorBuilder GetChangeFeedProcessorBuilderWithAllV
         {
             throw new NotImplementedException();
         }
+
+        public override Task<bool> IsFeedRangePartOfAsync(
+            Cosmos.FeedRange x,
+            Cosmos.FeedRange y,
+            CancellationToken cancellationToken = default)
+        {
+            throw new NotImplementedException();
+        }
 #endif
         /// <summary>
         /// This function handles the scenario where a container is deleted(say from different Client) and recreated with same Id but with different client encryption policy.

Microsoft.Azure.Cosmos/src/FeedRange/FeedRanges/FeedRangeEpk.cs

@@ -25,6 +25,11 @@ internal sealed class FeedRangeEpk : FeedRangeInternal
 
         public FeedRangeEpk(Documents.Routing.Range<string> range)
         {
+            if (!range.IsMinInclusive)
+            {
+                throw new ArgumentOutOfRangeException(paramName: nameof(range), message: $"{nameof(range.IsMinInclusive)} must be true.");
+            }
+
             this.Range = range ?? throw new ArgumentNullException(nameof(range));
         }
 

Microsoft.Azure.Cosmos/src/Resource/Container/Container.cs

@@ -1677,9 +1677,9 @@ public abstract ChangeFeedProcessorBuilder GetChangeFeedProcessorBuilder(
         /// <returns>An instance of <see cref="ChangeFeedProcessorBuilder"/></returns>
         public abstract ChangeFeedProcessorBuilder GetChangeFeedProcessorBuilderWithManualCheckpoint(
             string processorName,
-            ChangeFeedStreamHandlerWithManualCheckpoint onChangesDelegate);
-
-#if PREVIEW
+            ChangeFeedStreamHandlerWithManualCheckpoint onChangesDelegate);
+
+#if PREVIEW
         /// <summary>
         /// Deletes all items in the Container with the specified <see cref="PartitionKey"/> value.
         /// Starts an asynchronous Cosmos DB background operation which deletes all items in the Container with the specified value. 
@@ -1781,7 +1781,40 @@ public abstract Task<IEnumerable<string>> GetPartitionKeyRangesAsync(
         /// <returns>An instance of <see cref="ChangeFeedProcessorBuilder"/></returns>
         public abstract ChangeFeedProcessorBuilder GetChangeFeedProcessorBuilderWithAllVersionsAndDeletes<T>(
             string processorName,
-            ChangeFeedHandler<ChangeFeedItem<T>> onChangesDelegate);
-#endif
+            ChangeFeedHandler<ChangeFeedItem<T>> onChangesDelegate);
+
+        /// <summary>
+        /// Determines whether the given y feed range is a part of the specified x feed range.
+        /// </summary>
+        /// <param name="x">The feed range representing the x range.</param>
+        /// <param name="y">The feed range representing the y range.</param>
+        /// <param name="cancellationToken">A token to cancel the operation if needed.</param>
+        /// <example>
+        /// <code language="csharp">
+        /// <![CDATA[
+        /// CancellationToken cancellationToken = ...;
+        /// CosmosClientBuilder cosmosClientBuilder = new CosmosClientBuilder("your-connection-string");
+        /// CosmosClient cosmosClient = cosmosClientBuilder.Build();
+        /// Database cosmosDatabase = cosmosClient.GetDatabase("your-database-id");
+        /// Container container = cosmosDatabase.GetContainer("your-container-id");
+        /// FeedRange x = ...; // Define the feed range for x
+        /// FeedRange y = ...;  // Define the feed range for y
+        ///
+        /// bool isFeedRangePartOfAsync = await container.IsFeedRangePartOfAsync(
+        ///    x,
+        ///    y,
+        ///    cancellationToken);
+        /// ]]>
+        /// </code>
+        /// </example>
+        /// <returns>Returns a boolean indicating whether the y feed range is fully contained within the x feed range.</returns>
+        public virtual Task<bool> IsFeedRangePartOfAsync(
+            Cosmos.FeedRange x,
+            Cosmos.FeedRange y,
+            CancellationToken cancellationToken = default)
+        {
+            throw new NotImplementedException();
+        }
+#endif
     }
 }