Merge branch 'main' into yvonne/timestamp-expressions

Author: yvonnep165

.DS_Store

@@ -108,12 +108,12 @@
   "packages/google-cloud-geminidataanalytics": "0.6.0",
   "packages/google-cloud-gkebackup": "2.2.1",
   "packages/google-cloud-gkeconnect-gateway": "5.2.1",
-  "packages/google-cloud-gkehub": "6.3.1",
+  "packages/google-cloud-gkehub": "6.4.0",
   "packages/google-cloud-gkemulticloud": "2.3.0",
   "packages/google-cloud-gkerecommender": "0.1.0",
   "packages/google-cloud-gsuiteaddons": "2.2.1",
   "packages/google-cloud-hypercomputecluster": "0.2.0",
-  "packages/google-cloud-iap": "4.3.1",
+  "packages/google-cloud-iap": "4.4.0",
   "packages/google-cloud-ids": "4.2.1",
   "packages/google-cloud-iot": "5.2.1",
   "packages/google-cloud-kms": "5.4.0",
@@ -167,7 +167,7 @@
   "packages/google-cloud-securesourcemanager": "0.8.1",
   "packages/google-cloud-security-privateca": "7.0.1",
   "packages/google-cloud-security-publicca": "2.2.1",
-  "packages/google-cloud-securitycenter": "9.2.1",
+  "packages/google-cloud-securitycenter": "9.3.0",
   "packages/google-cloud-securitycentermanagement": "0.7.1",
   "packages/google-cloud-servicedirectory": "6.1.1",
   "packages/google-cloud-servicehealth": "0.7.1",
@@ -183,7 +183,7 @@
   "packages/google-cloud-texttospeech": "6.4.0",
   "packages/google-cloud-tpu": "4.1.1",
   "packages/google-cloud-translate": "9.3.0",
-  "packages/google-cloud-vectorsearch": "0.4.0",
+  "packages/google-cloud-vectorsearch": "0.5.0",
   "packages/google-cloud-video-livestream": "2.2.1",
   "packages/google-cloud-video-stitcher": "3.2.1",
   "packages/google-cloud-video-transcoder": "4.4.1",
@@ -212,13 +212,13 @@
   "packages/google-maps-fleetengine": "0.8.1",
   "packages/google-maps-fleetengine-delivery": "0.6.1",
   "packages/google-maps-mapsplatformdatasets": "3.1.1",
-  "packages/google-maps-places": "2.3.0",
+  "packages/google-maps-places": "2.4.0",
   "packages/google-maps-routeoptimization": "0.6.0",
-  "packages/google-maps-routing": "2.1.1",
+  "packages/google-maps-routing": "2.2.0",
   "packages/google-maps-solar": "0.5.1",
   "packages/google-marketingplatform-admin": "0.4.0",
   "packages/google-monitoring-dashboard": "4.1.1",
-  "packages/google-privacy-dlp": "6.5.0",
+  "packages/google-privacy-dlp": "6.6.0",
   "packages/google-shopping-css": "0.11.0",
   "packages/google-shopping-merchant-accounts": "3.2.0",
   "packages/google-shopping-merchant-conversions": "0.7.1",

.release-please-manifest.json

@@ -1,6 +1,125 @@
 {
   "repository": "googleapis/google-cloud-node",
   "entries": [
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "1f6f8cc33f811631b58007cc0645b476e65f8e26",
+          "message": "[dlp] added support for detecting key-value pairs in document metadata",
+          "issues": [
+            "7822"
+          ]
+        }
+      ],
+      "version": "6.6.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@google-cloud/dlp",
+      "id": "10ea7e1e-bd9a-4379-a56b-a0c47b841d58",
+      "createTime": "2026-03-19T18:18:35.904Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "b906b3ac62ee0513392d62defc7d168966c989f3",
+          "message": "[routing] add a new Waypoint source to accept a token that identifies a Navigation Point obtained from the `SearchDestinations` method of the Geocoding API",
+          "issues": [
+            "7531"
+          ]
+        }
+      ],
+      "version": "2.2.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@googlemaps/routing",
+      "id": "44c3e2c6-1106-454f-9530-892c47bf1f87",
+      "createTime": "2026-03-19T18:18:35.883Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "bbaf91884b006918b1235edb483e5ac7ed09442b",
+          "message": "[places] add a new business status `FUTURE_OPENING` for places,",
+          "issues": [
+            "7821"
+          ]
+        }
+      ],
+      "version": "2.4.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@googlemaps/places",
+      "id": "56058c47-372c-46c4-b917-379aee9ccc75",
+      "createTime": "2026-03-19T18:18:35.850Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "451de89cdd525b8aac424fc30ead047246ec521b",
+          "message": "[vectorsearch] Mark Vector Search v1 API as GA",
+          "issues": [
+            "7610"
+          ]
+        }
+      ],
+      "version": "0.5.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@google-cloud/vectorsearch",
+      "id": "744c0026-d1d8-4b0a-a76c-48c0247a8f4b",
+      "createTime": "2026-03-19T18:18:35.823Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "694f8f92608fc1b4afbf7c71ecce90341fea5908",
+          "message": "[securitycenter] Support Chokepoint and external exposure in findings Proto",
+          "issues": [
+            "7638"
+          ]
+        }
+      ],
+      "version": "9.3.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@google-cloud/security-center",
+      "id": "67f7ff53-1786-4e92-9319-99b9f6f32744",
+      "createTime": "2026-03-19T18:18:35.792Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "0012a46efa30c86cf8a88a88d3c4077bbbfe670c",
+          "message": "[iap] add oauth fields for IapSettings",
+          "issues": [
+            "7613"
+          ]
+        }
+      ],
+      "version": "4.4.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@google-cloud/iap",
+      "id": "bfbf2189-c8db-4d8e-b124-8d9af2b8c663",
+      "createTime": "2026-03-19T18:18:35.759Z"
+    },
+    {
+      "changes": [
+        {
+          "type": "feat",
+          "sha": "9de14388ef6e9919bb75de88d63cecb1c9a9a629",
+          "message": "[gkehub] A new field `kubernetes_api_server_version` is added to message `.google.cloud.gkehub.configmanagement.v1beta.MembershipState`",
+          "issues": [
+            "7534"
+          ]
+        }
+      ],
+      "version": "6.4.0",
+      "language": "JAVASCRIPT",
+      "artifactName": "@google-cloud/gke-hub",
+      "id": "8da5cdb7-0d1e-4af6-ab15-3887074c8a71",
+      "createTime": "2026-03-19T18:18:35.725Z"
+    },
     {
       "changes": [
         {
@@ -68999,5 +69118,5 @@
       "createTime": "2023-01-28T04:18:24.718Z"
     }
   ],
-  "updateTime": "2026-03-18T20:59:46.364Z"
+  "updateTime": "2026-03-19T18:18:35.904Z"
 }

changelog.json

@@ -783,6 +783,13 @@ export class Firestore implements firestore.Firestore {
       validateBoolean('settings.ssl', settings.ssl);
     }
 
+    if (settings.alwaysUseImplicitOrderBy !== undefined) {
+      validateBoolean(
+        'settings.alwaysUseImplicitOrderBy',
+        settings.alwaysUseImplicitOrderBy,
+      );
+    }
+
     if (settings.maxIdleChannels !== undefined) {
       validateInteger('settings.maxIdleChannels', settings.maxIdleChannels, {
         minValue: 0,
@@ -845,6 +852,14 @@ export class Firestore implements firestore.Firestore {
     return this._databaseId || DEFAULT_DATABASE_ID;
   }
 
+  /**
+   * Whether to always use implicit order by clauses.
+   * @internal
+   */
+  get alwaysUseImplicitOrderBy(): boolean {
+    return this._settings.alwaysUseImplicitOrderBy ?? false;
+  }
+
   /**
    * Returns the root path of the database. Validates that
    * `initializeIfNeeded()` was called before.

handwritten/firestore/dev/src/index.ts

@@ -1475,6 +1475,7 @@ export class Query<
   toProto(
     transactionOrReadTime?: Uint8Array | Timestamp | api.ITransactionOptions,
     explainOptions?: firestore.ExplainOptions,
+    forceImplicitOrderBy?: boolean,
   ): api.IRunQueryRequest {
     const projectId = this.firestore.projectId;
     const databaseId = this.firestore.databaseId;
@@ -1483,18 +1484,18 @@ export class Query<
       databaseId,
     );
 
-    const structuredQuery = this.toStructuredQuery();
+    const structuredQuery = this.toStructuredQuery(forceImplicitOrderBy);
 
     // For limitToLast queries, the structured query has to be translated to a version with
     // reversed ordered, and flipped startAt/endAt to work properly.
     if (this._queryOptions.limitType === LimitType.Last) {
-      if (!this._queryOptions.hasFieldOrders()) {
-        throw new Error(
-          'limitToLast() queries require specifying at least one orderBy() clause.',
-        );
-      }
+      const forceImplicit =
+        forceImplicitOrderBy || this._firestore.alwaysUseImplicitOrderBy;
+      const fieldOrders = forceImplicit
+        ? this.createImplicitOrderBy()
+        : this._queryOptions.fieldOrders;
 
-      structuredQuery.orderBy = this._queryOptions.fieldOrders!.map(order => {
+      structuredQuery.orderBy = fieldOrders.map(order => {
         // Flip the orderBy directions since we want the last results
         const dir =
           order.direction === 'DESCENDING' ? 'ASCENDING' : 'DESCENDING';
@@ -1564,7 +1565,9 @@ export class Query<
     return bundledQuery;
   }
 
-  private toStructuredQuery(): api.IStructuredQuery {
+  private toStructuredQuery(
+    forceImplicitOrderBy?: boolean,
+  ): api.IStructuredQuery {
     const structuredQuery: api.IStructuredQuery = {
       from: [{}],
     };
@@ -1586,9 +1589,19 @@ export class Query<
       ).toProto();
     }
 
-    if (this._queryOptions.hasFieldOrders()) {
-      structuredQuery.orderBy = this._queryOptions.fieldOrders.map(o =>
-        o.toProto(),
+    // orders
+    const forceImplicit =
+      forceImplicitOrderBy || this._firestore.alwaysUseImplicitOrderBy;
+    let fieldOrders = this._queryOptions.fieldOrders;
+    if (forceImplicit) {
+      fieldOrders = this.createImplicitOrderBy();
+    }
+
+    if (fieldOrders.length > 0) {
+      structuredQuery.orderBy = fieldOrders.map(o => o.toProto());
+    } else if (this._queryOptions.limitType === LimitType.Last) {
+      throw new Error(
+        'limitToLast() queries require specifying at least one orderBy() clause.',
       );
     }
 

handwritten/firestore/dev/src/reference/query.ts

@@ -941,7 +941,7 @@ export class QueryWatch<
   }
 
   getTarget(resumeToken?: Uint8Array): google.firestore.v1.ITarget {
-    const query = this.query.toProto();
+    const query = this.query.toProto(undefined, undefined, true);
     return {query, targetId: WATCH_TARGET_ID, resumeToken};
   }
 }

handwritten/firestore/dev/src/watch.ts

@@ -2291,5 +2291,55 @@ describe.skipClassic('Query and Pipeline Compare - Enterprise DB', () => {
       expectDocs(await compareQueryAndPipeline(query), 'doc2', 'doc3', 'doc4');
       expectDocs(await queryWithCursor.get(), 'doc2', 'doc3', 'doc4');
     });
+
+    it('alwaysUseImplicitOrderBy returns same results', async () => {
+      const collection = getTestRoot();
+      const docs = {
+        doc01: {sort: 1},
+        doc02: {sort: 2},
+        doc03: {sort: 3},
+        doc04: {sort: 4},
+        doc05: {sort: 5},
+        doc06: {sort: 6},
+        doc07: {sort: 7},
+        doc08: {sort: 8},
+        doc09: {sort: 9},
+        doc10: {sort: 10},
+      };
+
+      for (const [id, data] of Object.entries(docs)) {
+        await collection.doc(id).set(data);
+      }
+
+      const expectedOrder = [
+        'doc02',
+        'doc03',
+        'doc04',
+        'doc05',
+        'doc06',
+        'doc07',
+        'doc08',
+        'doc09',
+        'doc10',
+      ];
+
+      // TODO: This test should run against both standard and enterprise
+      // and verify the results respectively
+      // const originalQuery = collection.where('sort', '>', 1);
+      // const originalSnapshot = await originalQuery.get();
+      // const originalResult = originalSnapshot.docs.map(d => d.id);
+
+      const modifiedFirestore = new Firestore({
+        ...firestore.settings,
+        alwaysUseImplicitOrderBy: true,
+      });
+      const modifiedCollection = modifiedFirestore.collection(collection.id);
+      const query = modifiedCollection.where('sort', '>', 1);
+      const snapshot = await query.get();
+      const result = snapshot.docs.map(d => d.id);
+
+      // since alwaysUseImplicitOrderBy is true, we expect strict ordering.
+      expect(result).to.deep.equal(expectedOrder);
+    });
   });
 });