Remove beta notation and timeout for tests and regenerate documentation

yvonnep165 · yvonnep165 · commit c71d720931c5 · 2026-04-01T12:16:41.000-04:00
diff --git a/common/api-review/firestore-lite-pipelines.api.md b/common/api-review/firestore-lite-pipelines.api.md
@@ -1191,6 +1191,14 @@ export class Ordering {
     readonly expr: Expression;
 }
 
+// @public
+function parent_2(documentPath: string | DocumentReference): FunctionExpression;
+
+// @public
+function parent_2(documentPathExpr: Expression): FunctionExpression;
+
+export { parent_2 as parent }
+
 // @public
 export class Pipeline {
     addFields(field: Selectable, ...additionalFields: Selectable[]): Pipeline;
diff --git a/common/api-review/firestore-pipelines.api.md b/common/api-review/firestore-pipelines.api.md
@@ -1194,6 +1194,14 @@ export class Ordering {
     readonly expr: Expression;
 }
 
+// @public
+function parent_2(documentPath: string | DocumentReference): FunctionExpression;
+
+// @public
+function parent_2(documentPathExpr: Expression): FunctionExpression;
+
+export { parent_2 as parent }
+
 // @public (undocumented)
 export class Pipeline {
     addFields(field: Selectable, ...additionalFields: Selectable[]): Pipeline;
diff --git a/docs-devsite/firestore_lite_pipelines.expression.md b/docs-devsite/firestore_lite_pipelines.expression.md
@@ -145,6 +145,7 @@ export declare abstract class Expression
 |  [notEqual(value)](./firestore_lite_pipelines.expression.md#expressionnotequal) |  | Creates an expression that checks if this expression is not equal to a constant value. |
 |  [notEqualAny(values)](./firestore_lite_pipelines.expression.md#expressionnotequalany) |  | Creates an expression that checks if this expression is not equal to any of the provided values or expressions. |
 |  [notEqualAny(arrayExpression)](./firestore_lite_pipelines.expression.md#expressionnotequalany) |  | Creates an expression that checks if this expression is not equal to any of the values in the evaluated expression. |
+|  [parent()](./firestore_lite_pipelines.expression.md#expressionparent) |  | Creates an expression that returns the parent document reference of a document reference. |
 |  [pow(exponent)](./firestore_lite_pipelines.expression.md#expressionpow) |  | Creates an expression that returns the value of this expression raised to the power of another expression. |
 |  [pow(exponent)](./firestore_lite_pipelines.expression.md#expressionpow) |  | Creates an expression that returns the value of this expression raised to the power of a constant value. |
 |  [regexContains(pattern)](./firestore_lite_pipelines.expression.md#expressionregexcontains) |  | Creates an expression that checks if a string contains a specified regular expression as a substring. |
@@ -3445,9 +3446,6 @@ field("status").notEqualAny(field('rejectedStatuses'));
 
 ## Expression.parent()
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
diff --git a/docs-devsite/firestore_lite_pipelines.md b/docs-devsite/firestore_lite_pipelines.md
@@ -66,8 +66,10 @@ https://github.com/firebase/firebase-js-sdk
 |  [switchOn(condition, result, others)](./firestore_lite_pipelines.md#switchon_02b8caf) | Creates an expression that evaluates to the result corresponding to the first true condition. |
 |  <b>function(documentPath, ...)</b> |
 |  [documentId(documentPath)](./firestore_lite_pipelines.md#documentid_cef293c) | Creates an expression that returns the document ID from a path. |
+|  [parent\_2(documentPath)](./firestore_lite_pipelines.md#parent_2_cef293c) | Creates an expression that returns the parent document reference of a document reference. |
 |  <b>function(documentPathExpr, ...)</b> |
 |  [documentId(documentPathExpr)](./firestore_lite_pipelines.md#documentid_9a69021) | Creates an expression that returns the document ID from a path. |
+|  [parent\_2(documentPathExpr)](./firestore_lite_pipelines.md#parent_2_9a69021) | Creates an expression that returns the parent document reference of a document reference. |
 |  <b>function(element, ...)</b> |
 |  [notEqualAny(element, values)](./firestore_lite_pipelines.md#notequalany_c2c5bcb) | Creates an expression that checks if an expression is not equal to any of the provided values or expressions. |
 |  [notEqualAny(element, arrayExpression)](./firestore_lite_pipelines.md#notequalany_16b2851) | Creates an expression that checks if an expression is not equal to any of the provided values or expressions. |
@@ -1823,9 +1825,6 @@ documentId(myDocumentReference);
 
 ### parent\_2(documentPath) {:#parent_2_cef293c}
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
@@ -1890,9 +1889,6 @@ documentId(field("__path__"));
 
 ### parent\_2(documentPathExpr) {:#parent_2_9a69021}
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
diff --git a/docs-devsite/firestore_pipelines.expression.md b/docs-devsite/firestore_pipelines.expression.md
@@ -145,6 +145,7 @@ export declare abstract class Expression
 |  [notEqual(value)](./firestore_pipelines.expression.md#expressionnotequal) |  | Creates an expression that checks if this expression is not equal to a constant value. |
 |  [notEqualAny(values)](./firestore_pipelines.expression.md#expressionnotequalany) |  | Creates an expression that checks if this expression is not equal to any of the provided values or expressions. |
 |  [notEqualAny(arrayExpression)](./firestore_pipelines.expression.md#expressionnotequalany) |  | Creates an expression that checks if this expression is not equal to any of the values in the evaluated expression. |
+|  [parent()](./firestore_pipelines.expression.md#expressionparent) |  | Creates an expression that returns the parent document reference of a document reference. |
 |  [pow(exponent)](./firestore_pipelines.expression.md#expressionpow) |  | Creates an expression that returns the value of this expression raised to the power of another expression. |
 |  [pow(exponent)](./firestore_pipelines.expression.md#expressionpow) |  | Creates an expression that returns the value of this expression raised to the power of a constant value. |
 |  [regexContains(pattern)](./firestore_pipelines.expression.md#expressionregexcontains) |  | Creates an expression that checks if a string contains a specified regular expression as a substring. |
@@ -3445,9 +3446,6 @@ field("status").notEqualAny(field('rejectedStatuses'));
 
 ## Expression.parent()
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
diff --git a/docs-devsite/firestore_pipelines.md b/docs-devsite/firestore_pipelines.md
@@ -66,8 +66,10 @@ https://github.com/firebase/firebase-js-sdk
 |  [switchOn(condition, result, others)](./firestore_pipelines.md#switchon_02b8caf) | Creates an expression that evaluates to the result corresponding to the first true condition. |
 |  <b>function(documentPath, ...)</b> |
 |  [documentId(documentPath)](./firestore_pipelines.md#documentid_cef293c) | Creates an expression that returns the document ID from a path. |
+|  [parent\_2(documentPath)](./firestore_pipelines.md#parent_2_cef293c) | Creates an expression that returns the parent document reference of a document reference. |
 |  <b>function(documentPathExpr, ...)</b> |
 |  [documentId(documentPathExpr)](./firestore_pipelines.md#documentid_9a69021) | Creates an expression that returns the document ID from a path. |
+|  [parent\_2(documentPathExpr)](./firestore_pipelines.md#parent_2_9a69021) | Creates an expression that returns the parent document reference of a document reference. |
 |  <b>function(element, ...)</b> |
 |  [notEqualAny(element, values)](./firestore_pipelines.md#notequalany_c2c5bcb) | Creates an expression that checks if an expression is not equal to any of the provided values or expressions. |
 |  [notEqualAny(element, arrayExpression)](./firestore_pipelines.md#notequalany_16b2851) | Creates an expression that checks if an expression is not equal to any of the provided values or expressions. |
@@ -1829,9 +1831,6 @@ documentId(myDocumentReference);
 
 ### parent\_2(documentPath) {:#parent_2_cef293c}
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
@@ -1896,9 +1895,6 @@ documentId(field("__path__"));
 
 ### parent\_2(documentPathExpr) {:#parent_2_9a69021}
 
-> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
 Creates an expression that returns the parent document reference of a document reference.
 
 <b>Signature:</b>
diff --git a/packages/firestore/src/lite-api/expressions.ts b/packages/firestore/src/lite-api/expressions.ts
@@ -2600,7 +2600,6 @@ export abstract class Expression implements ProtoValueSerializable, UserData {
   }
 
   /**
-   * @beta
    *
    * Creates an expression that returns a substring of the results of this expression.
    *
@@ -4545,7 +4544,6 @@ export function parent(
 ): FunctionExpression;
 
 /**
- * @beta
  *
  * Creates an expression that returns the parent document reference of a document reference.
  *
@@ -4568,7 +4566,6 @@ export function parent(
 }
 
 /**
- * @beta
  *
  * Creates an expression that returns a substring of a string or byte array.
  *
diff --git a/packages/firestore/test/integration/api/pipeline.test.ts b/packages/firestore/test/integration/api/pipeline.test.ts
@@ -4684,7 +4684,7 @@ apiDescribe.skipClassic('Pipelines', persistence => {
         parentIdStatic: 'book4',
         parentIdInstance: 'book4'
       });
-    }).timeout(10000);
+    });
 
     it('supports substring', async () => {
       let snapshot = await execute(
diff --git a/packages/firestore/test/lite/pipeline.test.ts b/packages/firestore/test/lite/pipeline.test.ts
@@ -4742,7 +4742,7 @@ describe.skipClassic('Firestore Pipelines', () => {
         parentIdStatic: 'book4',
         parentIdInstance: 'book4'
       });
-    }).timeout(10000);
+    });
 
     it('supports substring', async () => {
       let snapshot = await execute(

Original file line number	Diff line number	Diff line change
`@@ -2600,7 +2600,6 @@ export abstract class Expression implements ProtoValueSerializable, UserData {`
`2600`	`2600`	`}`
`2601`	`2601`
`2602`	`2602`	`/**`
`2603`		`- * @beta`
`2604`	`2603`	`*`
`2605`	`2604`	`* Creates an expression that returns a substring of the results of this expression.`
`2606`	`2605`	`*`
`@@ -4545,7 +4544,6 @@ export function parent(`
`4545`	`4544`	`): FunctionExpression;`
`4546`	`4545`
`4547`	`4546`	`/**`
`4548`		`- * @beta`
`4549`	`4547`	`*`
`4550`	`4548`	`* Creates an expression that returns the parent document reference of a document reference.`
`4551`	`4549`	`*`
`@@ -4568,7 +4566,6 @@ export function parent(`
`4568`	`4566`	`}`
`4569`	`4567`
`4570`	`4568`	`/**`
`4571`		`- * @beta`
`4572`	`4569`	`*`
`4573`	`4570`	`* Creates an expression that returns a substring of a string or byte array.`
`4574`	`4571`	`*`