strogiyotec · Oct 5, 2026 · Jun 23, 2026 · Jul 6, 2026 · Jul 16, 2026 · Jul 16, 2026
@@ -24,7 +24,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface DateSearchFacet extends SearchFacet {
     /**
      * Creates a new {@link DateSearchFacet} with the default bucket specified.

@@ -24,6 +24,6 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface FacetSearchCollector extends SearchCollector {
 }
@@ -24,7 +24,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface LowerBoundSearchCount extends SearchCount {
     /**
      * Creates a new {@link LowerBoundSearchCount} that instructs to count documents up to the {@code threshold} exactly,

@@ -24,7 +24,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface NumberSearchFacet extends SearchFacet {
     /**
      * Creates a new {@link NumberSearchFacet} with the default bucket specified.

@@ -38,22 +38,36 @@
 @Beta(Reason.CLIENT)
 public interface SearchCollector extends Bson {
     /**
-     * Returns a {@link SearchCollector} that groups results by values or ranges in the specified faceted fields and returns the count
-     * for each of those groups.
+     * Returns a {@link SearchCollector} that groups the results of a search based on the specified operator
+     * by values or ranges in the specified faceted fields, and returns the count for each of those groups.
      *
      * @param operator The search operator to use.
      * @param facets The non-empty facet definitions.
      * @return The requested {@link SearchCollector}.
      * @mongodb.atlas.manual atlas-search/facet/ facet collector
      */
-    @Beta({Reason.CLIENT, Reason.SERVER})
+    @Beta(Reason.CLIENT)
     static FacetSearchCollector facet(final SearchOperator operator, final Iterable<? extends SearchFacet> facets) {
         notNull("operator", operator);
         notNull("facets", facets);
         return new SearchConstructibleBsonElement("facet", new Document("operator", operator)
                 .append("facets", combineToBson(facets)));
     }
 
+    /**
+     * Returns a {@link SearchCollector} that groups all the input documents
+     * by values or ranges in the specified faceted fields, and returns the count for each of those groups.
+     *
+     * @param facets The non-empty facet definitions.
+     * @return The requested {@link SearchCollector}.
+     * @mongodb.atlas.manual atlas-search/facet/ facet collector
+     */
+    @Beta(Reason.CLIENT)
+    static FacetSearchCollector facet(final Iterable<? extends SearchFacet> facets) {
+        notNull("facets", facets);
+        return new SearchConstructibleBsonElement("facet", new Document("facets", combineToBson(facets)));
+    }
+
     /**
      * Creates a {@link SearchCollector} from a {@link Bson} in situations when there is no builder method that better satisfies your needs.
      * This method cannot be used to validate the syntax.

@@ -34,7 +34,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface SearchCount extends Bson {
     /**
      * Returns a {@link SearchCount} that instructs to count documents exactly.

@@ -44,7 +44,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface SearchFacet extends Bson {
     /**
      * Returns a {@link SearchFacet} that allows narrowing down search results based on the most frequent

@@ -24,7 +24,7 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface StringSearchFacet extends SearchFacet {
     /**
      * Creates a new {@link StringSearchFacet} that explicitly limits the number of facet categories.

@@ -24,6 +24,6 @@
  * @since 4.7
  */
 @Sealed
-@Beta({Reason.CLIENT, Reason.SERVER})
+@Beta(Reason.CLIENT)
 public interface TotalSearchCount extends SearchCount {
 }
@@ -62,6 +62,27 @@ void facet() {
         );
     }
 
+    @Test
+    void facetWithoutOperator() {
+        assertAll(
+                () -> assertThrows(CodecConfigurationException.class, () ->
+                        // facet names must be unique; `BsonCodec` wraps our `IllegalStateException` into `CodecConfigurationException`
+                        SearchCollector.facet(
+                                asList(
+                                        stringFacet("duplicateFacetName", fieldPath("stringFieldName")),
+                                        numberFacet("duplicateFacetName", fieldPath("numberFieldName"), asList(10, 20, 30))))
+                                // we have to render into `BsonDocument` in order to trigger the lazy check
+                                .toBsonDocument()
+                ),
+                () -> assertEquals(
+                        documentWithoutOperator()
+                                .toBsonDocument(),
+                        searchCollectorWithoutOperator()
+                                .toBsonDocument()
+                )
+        );
+    }
+
     private static SearchCollector docExamplePredefined() {
         return SearchCollector.facet(
                 exists(
@@ -89,4 +110,28 @@ private static Document docExampleCustom() {
                                         fieldPath("numberFieldName"),
                                         asList(10, 20, 30))))));
     }
+
+    private static SearchCollector searchCollectorWithoutOperator() {
+        return SearchCollector.facet(
+                asList(
+                        stringFacet(
+                                "stringFacetName",
+                                fieldPath("stringFieldName")),
+                        numberFacet(
+                                "numberFacetName",
+                                fieldPath("numberFieldName"),
+                                asList(10, 20, 30))));
+    }
+
+    private static Document documentWithoutOperator() {
+        return new Document("facet",
+                new Document("facets", combineToBson(asList(
+                        stringFacet(
+                                "stringFacetName",
+                                fieldPath("stringFieldName")),
+                        numberFacet(
+                                "numberFacetName",
+                                fieldPath("numberFieldName"),
+                                asList(10, 20, 30))))));
+    }
 }
@@ -34,18 +34,30 @@ import scala.collection.JavaConverters._
 object SearchCollector {
 
   /**
-   * Returns a `SearchCollector` that groups results by values or ranges in the specified faceted fields and returns the count
-   * for each of those groups.
+   * Returns a `SearchCollector` that groups the results of a search based on the specified operator
+   * by values or ranges in the specified faceted fields, and returns the count for each of those groups.
    *
    * @param operator The search operator to use.
    * @param facets The non-empty facet definitions.
    * @return The requested `SearchCollector`.
    * @see [[https://www.mongodb.com/docs/atlas/atlas-search/facet/ facet collector]]
    */
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   def facet(operator: SearchOperator, facets: Iterable[_ <: SearchFacet]): FacetSearchCollector =
     JSearchCollector.facet(operator, facets.asJava)
 
+  /**
+   * Returns a `SearchCollector` that groups all the input documents
+   * by values or ranges in the specified faceted fields, and returns the count for each of those groups.
+   *
+   * @param facets The non-empty facet definitions.
+   * @return The requested `SearchCollector`.
+   * @see [[https://www.mongodb.com/docs/atlas/atlas-search/facet/ facet collector]]
+   */
+  @Beta(Array(Reason.CLIENT))
+  def facet(facets: Iterable[_ <: SearchFacet]): FacetSearchCollector =
+    JSearchCollector.facet(facets.asJava)
+
   /**
    * Creates a `SearchCollector` from a `Bson` in situations when there is no builder method that better satisfies your needs.
    * This method cannot be used to validate the syntax.

@@ -28,7 +28,7 @@ import org.mongodb.scala.model.Projections
  * @see [[https://www.mongodb.com/docs/atlas/atlas-search/counting/ Counting]]
  * @since 4.7
  */
-@Beta(Array(Reason.CLIENT, Reason.SERVER))
+@Beta(Array(Reason.CLIENT))
 object SearchCount {
 
   /**

@@ -28,7 +28,7 @@ import collection.JavaConverters._
  * @see [[https://www.mongodb.com/docs/atlas/atlas-search/facet/#facet-definition Facet definition]]
  * @since 4.7
  */
-@Beta(Array(Reason.CLIENT, Reason.SERVER))
+@Beta(Array(Reason.CLIENT))
 object SearchFacet {
 
   /**

@@ -269,7 +269,7 @@ package object search {
    * @see `SearchCollector.facet(SearchOperator, Iterable)`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type FacetSearchCollector = com.mongodb.client.model.search.FacetSearchCollector
 
   /**
@@ -375,21 +375,21 @@ package object search {
    * @see [[https://www.mongodb.com/docs/atlas/atlas-search/counting/ Counting]]
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type SearchCount = com.mongodb.client.model.search.SearchCount
 
   /**
    * @see `SearchCount.total()`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type TotalSearchCount = com.mongodb.client.model.search.TotalSearchCount
 
   /**
    * @see `SearchCount.lowerBound()`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type LowerBoundSearchCount = com.mongodb.client.model.search.LowerBoundSearchCount
 
   /**
@@ -398,28 +398,28 @@ package object search {
    * @see [[https://www.mongodb.com/docs/atlas/atlas-search/facet/#facet-definition Facet definition]]
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type SearchFacet = com.mongodb.client.model.search.SearchFacet
 
   /**
    * @see `SearchFacet.stringFacet(String, FieldSearchPath)`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type StringSearchFacet = com.mongodb.client.model.search.StringSearchFacet
 
   /**
    * @see `SearchFacet.numberFacet(String, FieldSearchPath, Iterable)`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type NumberSearchFacet = com.mongodb.client.model.search.NumberSearchFacet
 
   /**
    * @see `SearchFacet.dateFacet(String, FieldSearchPath, Iterable)`
    */
   @Sealed
-  @Beta(Array(Reason.CLIENT, Reason.SERVER))
+  @Beta(Array(Reason.CLIENT))
   type DateSearchFacet = com.mongodb.client.model.search.DateSearchFacet
 
   /**