feat: add value_bitmask_filter to the read API

handwritten/bigtable/.jsdoc.js

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -40,7 +40,7 @@ module.exports = {
     includePattern: '\\.js$'
   },
   templates: {
-    copyright: 'Copyright 2025 Google LLC',
+    copyright: 'Copyright 2026 Google LLC',
     includeDate: false,
     sourceFiles: false,
     systemName: '@google-cloud/bigtable',

handwritten/bigtable/.mocharc.js

@@ -1,21 +1,25 @@
-// Copyright 2020 Google LLC
+// Copyright 2026 Google LLC
 //
 // 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
+//     https://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.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
 const config = {
   "enable-source-maps": true,
-  "throw-deprecation": false,
-  "timeout": 10000,
-  "recursive": true
+  "throw-deprecation": true,
+  "timeout": 10000
 }
 if (process.env.MOCHA_THROW_DEPRECATION === 'false') {
   delete config['throw-deprecation'];

handwritten/bigtable/protos/google/bigtable/v2/bigtable.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -23,6 +23,7 @@ import "google/api/resource.proto";
 import "google/api/routing.proto";
 import "google/bigtable/v2/data.proto";
 import "google/bigtable/v2/request_stats.proto";
+import "google/bigtable/v2/session.proto";
 import "google/bigtable/v2/types.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -328,6 +329,36 @@ service Bigtable {
     option (google.api.method_signature) = "instance_name,query";
     option (google.api.method_signature) = "instance_name,query,app_profile_id";
   }
+
+  // This RPC is only intended to be used by the official Cloud Bigtable client
+  // libraries to implement the Bigtable Session based protocol. It is subject
+  // to change without notice.
+  rpc GetClientConfiguration(GetClientConfigurationRequest)
+      returns (ClientConfiguration) {}
+
+  // This RPC is only intended to be used by the official Cloud Bigtable client
+  // libraries to implement the Bigtable Session based protocol. It is subject
+  // to change without notice.
+  rpc OpenTable(stream SessionRequest) returns (stream SessionResponse) {
+    option (google.bigtable.v2.rpc_session_type) = SESSION_TYPE_TABLE;
+  }
+
+  // This RPC is only intended to be used by the official Cloud Bigtable client
+  // libraries to implement the Bigtable Session based protocol. It is subject
+  // to change without notice.
+  rpc OpenAuthorizedView(stream SessionRequest)
+      returns (stream SessionResponse) {
+    option (google.bigtable.v2.rpc_session_type) = SESSION_TYPE_AUTHORIZED_VIEW;
+  }
+
+  // This RPC is only intended to be used by the official Cloud Bigtable client
+  // libraries to implement the Bigtable Session based protocol. It is subject
+  // to change without notice.
+  rpc OpenMaterializedView(stream SessionRequest)
+      returns (stream SessionResponse) {
+    option (google.bigtable.v2.rpc_session_type) =
+        SESSION_TYPE_MATERIALIZED_VIEW;
+  }
 }
 
 // Request message for Bigtable.ReadRows.

handwritten/bigtable/protos/google/bigtable/v2/data.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -255,6 +255,15 @@ message ValueRange {
   }
 }
 
+// Restricts the output to cells whose values match the given bitmask.
+message ValueBitmask {
+  // Required. Mask applied to the value.
+  // Evaluated as: `(value & mask) == mask`
+  // The mask length must exactly match the value length, otherwise the cell is
+  // not considered a match.
+  bytes mask = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
 // Takes a row as input and produces an alternate view of the row based on
 // specified rules. For example, a RowFilter might trim down a row to include
 // just the cells from columns matching a given regular expression, or might
@@ -514,6 +523,12 @@ message RowFilter {
     // will be applied to separate copies of the input. This may be relaxed in
     // the future.
     string apply_label_transformer = 19;
+
+    // Matches only cells with values that satisfy the condition `(value & mask)
+    // == mask`.
+    // The mask length must exactly match the value length, otherwise the cell
+    // is not considered a match.
+    ValueBitmask value_bitmask_filter = 20;
   }
 }
 

handwritten/bigtable/protos/google/bigtable/v2/feature_flags.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -70,4 +70,10 @@ message FeatureFlags {
 
   // If the client can support using BigtablePeerInfo.
   bool peer_info = 11;
+
+  // Indicates whether the client supports the Bigtable Sessions API.
+  bool sessions_compatible = 12;
+
+  // Internal flag to force sessions for internal projects.
+  bool sessions_required = 13;
 }

handwritten/bigtable/protos/google/bigtable/v2/peer_info.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -66,11 +66,15 @@ message PeerInfo {
   // request.
   int64 application_frontend_id = 2;
 
+  // The Cloud region of the application frontend that served this request.
+  string application_frontend_region = 6;
+
   // The Cloud zone of the application frontend that served this request.
-  string application_frontend_zone = 3;
+  string application_frontend_zone = 3 [deprecated = true];
 
   // The subzone of the application frontend that served this request, e.g. an
-  // identifier for where within the zone the application frontend is.
+  // identifier for where within a zone (within the reported region) the
+  // application frontend is.
   string application_frontend_subzone = 4;
 
   TransportType transport_type = 5;

handwritten/bigtable/protos/google/bigtable/v2/request_stats.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

handwritten/bigtable/protos/google/bigtable/v2/response_params.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.