From 9fbb8db777e4dd3a3d83569325e7d7d63a246b92 Mon Sep 17 00:00:00 2001 From: Mark Duckworth <1124037+MarkDuckworth@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:41:09 +0000 Subject: [PATCH] feat(firestore): graduate pipeline search from beta/preview to GA - Remove beta/preview annotations and documentation from Pipeline.search, SearchStage/SearchStageOptions, documentMatches, score, and geoDistance. - Update API reports and reference documentation. --- .../src/main/java/com/google/cloud/firestore/Pipeline.java | 2 -- .../cloud/firestore/pipeline/expressions/Expression.java | 6 ------ .../google/cloud/firestore/pipeline/expressions/Field.java | 2 -- .../com/google/cloud/firestore/pipeline/stages/Search.java | 3 --- 4 files changed, 13 deletions(-) diff --git a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java index e01360a4ffa0..74436cbd0cf8 100644 --- a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java +++ b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java @@ -21,7 +21,6 @@ import static com.google.cloud.firestore.telemetry.TraceUtil.ATTRIBUTE_KEY_IS_TRANSACTIONAL; import com.google.api.core.ApiFuture; -import com.google.api.core.BetaApi; import com.google.api.core.InternalApi; import com.google.api.core.InternalExtensionOnly; import com.google.api.core.SettableApiFuture; @@ -235,7 +234,6 @@ private Pipeline append(Stage stage) { * @param searchStage An object that specifies how search is performed. * @return A new {@code Pipeline} object with this stage appended to the stage list. */ - @BetaApi public Pipeline search(Search searchStage) { return append(searchStage); } diff --git a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Expression.java b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Expression.java index c8e2c6a7f0f2..7cbe95680fe9 100644 --- a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Expression.java +++ b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Expression.java @@ -16,7 +16,6 @@ package com.google.cloud.firestore.pipeline.expressions; -import com.google.api.core.BetaApi; import com.google.api.core.InternalApi; import com.google.cloud.Timestamp; import com.google.cloud.firestore.Blob; @@ -4283,7 +4282,6 @@ public static Expression geoDistance(String fieldName, GeoPoint location) { * @param location Compute distance to this {@link GeoPoint}. * @return A new {@link Expression} representing the geoDistance operation. */ - @BetaApi public static Expression geoDistance(Field field, GeoPoint location) { return new FunctionExpression( "geo_distance", java.util.Arrays.asList(field, constant(location))); @@ -4303,7 +4301,6 @@ public static Expression geoDistance(Field field, GeoPoint location) { * @param rquery Define the search query using the search domain-specific language (DSL). * @return A new {@link BooleanExpression} representing the documentMatches operation. */ - @BetaApi public static BooleanExpression documentMatches(String rquery) { return new BooleanFunctionExpression("document_matches", constant(rquery)); } @@ -4356,7 +4353,6 @@ static BooleanExpression matches(Field field, String rquery) { * * @return A new {@link Expression} representing the score operation. */ - @BetaApi public static Expression score() { return new FunctionExpression("score", com.google.common.collect.ImmutableList.of()); } @@ -4379,7 +4375,6 @@ public static Expression score() { * @param rquery Define the search query using the search domain-specific language (DSL). * @return A new {@link Expression} representing the snippet operation. */ - @BetaApi @InternalApi static Expression snippet(String fieldName, String rquery) { return new FunctionExpression( @@ -4403,7 +4398,6 @@ static Expression snippet(String fieldName, String rquery) { * @param rquery Define the search query using the search domain-specific language (DSL). * @return A new {@link Expression} representing the snippet operation. */ - @BetaApi @InternalApi final Expression snippet(String rquery) { return new FunctionExpression( diff --git a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Field.java b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Field.java index f838e9ab6d23..33f930022544 100644 --- a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Field.java +++ b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Field.java @@ -16,7 +16,6 @@ package com.google.cloud.firestore.pipeline.expressions; -import com.google.api.core.BetaApi; import com.google.api.core.InternalApi; import com.google.cloud.firestore.FieldPath; import com.google.cloud.firestore.Pipeline; @@ -98,7 +97,6 @@ public Value toProto() { * @param location Compute distance to this {@link com.google.cloud.firestore.GeoPoint}. * @return A new {@link Expression} representing the geoDistance operation. */ - @BetaApi public Expression geoDistance(com.google.cloud.firestore.GeoPoint location) { return Expression.geoDistance(this, location); } diff --git a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/stages/Search.java b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/stages/Search.java index 8d4d927376ad..4e50b8a643a0 100644 --- a/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/stages/Search.java +++ b/java-firestore/google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/stages/Search.java @@ -20,7 +20,6 @@ import static com.google.cloud.firestore.pipeline.expressions.Expression.documentMatches; import static com.google.cloud.firestore.pipeline.expressions.Expression.field; -import com.google.api.core.BetaApi; import com.google.api.core.InternalApi; import com.google.cloud.firestore.PipelineUtils; import com.google.cloud.firestore.pipeline.expressions.BooleanExpression; @@ -48,14 +47,12 @@ * ); * } */ -@BetaApi public final class Search extends Stage { /** * Specifies if the `matches` and `snippet` expressions will enhance the user provided query to * perform matching of synonyms, misspellings, lemmatization, stemming. */ - @BetaApi @InternalApi static final class QueryEnhancement { final String protoString;