Merge branch 'upstream-main'

# Conflicts:
#	src/DataStax.AstraDB.DataApi/Collections/Collection.cs
#	src/DataStax.AstraDB.DataApi/Core/Query/ProjectionBuilder.cs
#	src/DataStax.AstraDB.DataApi/DataAPIClient.cs

Author: stephenatsembit

src/DataStax.AstraDB.DataApi/Core/CountDocumentsCommandOptions.cs

@@ -0,0 +1,22 @@
+/*
+ * Copyright DataStax, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace DataStax.AstraDB.DataApi.Core;
+
+public class CountDocumentsCommandOptions : CommandOptions
+{
+  public int MaxDocumentsToCount { get; set; } = int.MaxValue;
+}

src/DataStax.AstraDB.DataApi/Core/Query/ProjectionBuilder.cs

@@ -388,6 +388,80 @@ public ExclusiveProjectionBuilder<T> IncludeSpecial<TField>(Expression<Func<T, T
         return this;
     }
 
+    /// <summary>
+    /// Specify a field to include in the projection.
+    /// </summary>
+    /// <param name="fieldName">The name of the field to include.</param>
+    /// <returns>The projection builder.</returns>
+    public ExclusiveProjectionBuilder<T> Slice(string fieldName, int start, int length = 0)
+    {
+        var projection = new Projection() { FieldName = fieldName, Include = true, SliceStart = start };
+        if (length > 0)
+        {
+            projection.SliceLength = length;
+        }
+        _projections.Add(projection);
+        return this;
+    }
+
+    /// <summary>
+    /// Specify a field to include in the projection.
+    /// </summary>
+    /// <typeparam name="TField">The type of the field to include.</typeparam>
+    /// <param name="fieldExpression">The field to include in the projection.</param>
+    /// <returns>The projection builder.</returns>
+    public ExclusiveProjectionBuilder<T> Slice<TField>(Expression<Func<T, TField>> fieldExpression, int start, int length = 0)
+    {
+        var fieldName = fieldExpression.GetMemberNameTree();
+        var projection = new Projection() { FieldName = fieldName, Include = true, SliceStart = start };
+        if (length > 0)
+        {
+            projection.SliceLength = length;
+        }
+        _projections.Add(projection);
+        return this;
+    }
+
+    /// <summary>
+    /// Specify a special field to include in the projection.
+    /// </summary>
+    /// <param name="fieldName">The name of the field to include.</param>
+    /// <returns>The projection builder.</returns>
+    public ExclusiveProjectionBuilder<T> IncludeSpecial(string fieldName)
+    {
+        _projections.Add(new Projection() { FieldName = fieldName, Include = true });
+        return this;
+    }
+
+    /// <summary>
+    /// Specify a special field to include in the projection.
+    /// </summary>
+    /// <param name="fieldName">The name of the field to include.</param>
+    /// <returns>The projection builder.</returns>
+    public ExclusiveProjectionBuilder<T> IncludeSpecial<TField>(Expression<Func<T, TField>> fieldExpression)
+    {
+        var isSpecial = false;
+        if (ExpressionValidator.DoesPropertyHaveAttribute<T, TField, DocumentMappingAttribute>(fieldExpression))
+        {
+            isSpecial = true;
+        }
+        if (ExpressionValidator.DoesPropertyHaveAttribute<T, TField, DocumentIdAttribute>(fieldExpression))
+        {
+            isSpecial = true;
+        }
+        var fieldName = fieldExpression.GetMemberNameTree();
+        if (fieldName == "_id")
+        {
+            isSpecial = true;
+        }
+        if (!isSpecial)
+        {
+            throw new ArgumentException($"Property '{fieldName}' must either have the '{typeof(DocumentMappingAttribute).Name}' attribute or be the '{typeof(DocumentIdAttribute).Name}' attribute.", nameof(fieldExpression));
+        }
+        _projections.Add(new Projection() { FieldName = fieldName, Include = true });
+        return this;
+    }
+
     public override IProjectionBuilder Clone()
     {
         var clone = new ExclusiveProjectionBuilder<T>();