build: update gapic-generator-typescript to v4.4.1 (#1975)

* feat: Trusted Private Cloud support, use the universeDomain parameter
feat: auto populate UUID fields where needed
fix: revert changes to streaming retries

Use gapic-generator-typescript v4.4.0.

PiperOrigin-RevId: 603757799

Source-Link: googleapis/googleapis@1a45bf7

Source-Link: googleapis/googleapis-gen@19ca4b4
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTljYTRiNDVhNTNkMDBjYjdiZGQ5NGI0NDJiNjBiZDIzN2RmZTEyMyJ9

docs: update the comment regarding eligible SQL shapes for PartitionQuery

PiperOrigin-RevId: 602806739

Source-Link: googleapis/googleapis@20b095b

Source-Link: googleapis/googleapis-gen@fc8a8ea
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmM4YThlYTMwMjljNTkwZDI3ZmNiZjM2YWQzMWVmN2E4MjJmNDBmNCJ9

feat: add FLOAT32 enum to TypeCode

PiperOrigin-RevId: 601176446

Source-Link: googleapis/googleapis@584ecd4

Source-Link: googleapis/googleapis-gen@0bdb815
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGJkYjgxNTc3OWQwZmQ3ODI0YmFmZmYwYzkxMDQ2YTdkY2E1Y2Q1ZiJ9

feat(spanner): add proto descriptors for proto and enum types in create/update/get database ddl requests

PiperOrigin-RevId: 601013501

Source-Link: googleapis/googleapis@81b24a5

Source-Link: googleapis/googleapis-gen@46f0446
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDZmMDQ0NjAzNzkwNmYwZDkwNTM2NTgzNWYwMmE2NTIyNDFmM2RlMyJ9

fix: improve retry logic for streaming API calls
build: update typescript generator version to 4.3.0

The streaming API call retry logic has changed, which in some rare cases may require code changes. Please feel free to reach out to us in the issues if you experience new problems with retrying streaming calls after this update.

PiperOrigin-RevId: 599622271

Source-Link: googleapis/googleapis@6239c21

Source-Link: googleapis/googleapis-gen@da13d82
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZGExM2Q4MjIyZDNiYTMzNzM0NTAxOTk5ODY0NDU4NjQwZjE0MDVhZSJ9

feat: add max_commit_delay API

PiperOrigin-RevId: 599315735

Source-Link: googleapis/googleapis@465a103

Source-Link: googleapis/googleapis-gen@930e231
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOTMwZTIzMThhY2JkMTBmYjU0ZDg2NjhkMmYyY2YxOWZlNDEzZDVhOSJ9

feat(spanner): add proto and enum types

PiperOrigin-RevId: 599046867

Source-Link: googleapis/googleapis@64a5bfe

Source-Link: googleapis/googleapis-gen@6e96ab8
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNmU5NmFiOGJiMWVjNDUzNmM1YTBjNGQwOTVmNTNjZTA1NzhjYjhhNCJ9

fix: correct long audio synthesis HTTP binding
docs: Deprecate the custom voice usage field

PiperOrigin-RevId: 595119987

Source-Link: googleapis/googleapis@c22f408

Source-Link: googleapis/googleapis-gen@4e9ca63
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGU5Y2E2M2QyY2M3OTMzZWI3YzM4M2NlOGI3OTRmY2UxNTJlYTJmYyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* fix: do not use deprecated static servicePath

* build: update gapic-generator-typescript to v4.4.1

PiperOrigin-RevId: 604765466

Source-Link: googleapis/googleapis@40203ca

Source-Link: googleapis/googleapis-gen@07b7f3d
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDdiN2YzZGFkOGFhMTkxMmQ0YWNkY2ZkNjM2NWJiNDIzNmU0YjU0YiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Sri Harsha CH <[email protected]>
Co-authored-by: Alexander Fenster <[email protected]>

.gitignore

@@ -2,8 +2,6 @@
 **/node_modules
 /.coverage
 /coverage
-/.idea
-/.vscode
 /.nyc_output
 /docs/
 /out/

.jsdoc.js

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 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 2023 Google LLC',
+    copyright: 'Copyright 2024 Google LLC',
     includeDate: false,
     sourceFiles: false,
     systemName: '@google-cloud/spanner',

protos/google/spanner/admin/database/v1/spanner_database_admin.proto

@@ -572,6 +572,23 @@ message CreateDatabaseRequest {
 
   // Optional. The dialect of the Cloud Spanner Database.
   DatabaseDialect database_dialect = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements in
+  // 'extra_statements' above.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+  // run `protoc` with --include_imports and --descriptor_set_out. For example,
+  // to generate for moon/shot/app.proto, run
+  // ```
+  // $protoc  --proto_path=/app_path --proto_path=/lib_path \
+  //          --include_imports \
+  //          --descriptor_set_out=descriptors.data \
+  //          moon/shot/app.proto
+  // ```
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Metadata type for the operation returned by
@@ -674,6 +691,22 @@ message UpdateDatabaseDdlRequest {
   // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns
   // `ALREADY_EXISTS`.
   string operation_id = 3;
+
+  // Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+  // run `protoc` with --include_imports and --descriptor_set_out. For example,
+  // to generate for moon/shot/app.proto, run
+  // ```
+  // $protoc  --proto_path=/app_path --proto_path=/lib_path \
+  //          --include_imports \
+  //          --descriptor_set_out=descriptors.data \
+  //          moon/shot/app.proto
+  // ```
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Action information extracted from a DDL statement. This proto is used to
@@ -762,6 +795,13 @@ message GetDatabaseDdlResponse {
   // A list of formatted DDL statements defining the schema of the database
   // specified in the request.
   repeated string statements = 1;
+
+  // Proto descriptors stored in the database.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 2;
 }
 
 // The request for

protos/google/spanner/v1/spanner.proto

@@ -22,6 +22,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -927,9 +928,10 @@ message PartitionQueryRequest {
 
   // Required. The query request to generate partitions for. The request will
   // fail if the query is not root partitionable. For a query to be root
-  // partitionable, it needs to satisfy a few conditions. For example, the first
-  // operator in the query execution plan must be a distributed union operator.
-  // For more information about other conditions, see [Read data in
+  // partitionable, it needs to satisfy a few conditions. For example, if the
+  // query execution plan contains a distributed union operator, then it must be
+  // the first operator in the plan. For more information about other
+  // conditions, see [Read data in
   // parallel](https://cloud.google.com/spanner/docs/reads#read_data_in_parallel).
   //
   // The query request must not contain DML commands, such as INSERT, UPDATE, or
@@ -1163,6 +1165,14 @@ message CommitRequest {
   // Default value is `false`.
   bool return_commit_stats = 5;
 
+  // Optional. The amount of latency this request is willing to incur in order
+  // to improve throughput. If this field is not set, Spanner assumes requests
+  // are relatively latency sensitive and automatically determines an
+  // appropriate delay time. You can specify a batching delay value between 0
+  // and 500 ms.
+  google.protobuf.Duration max_commit_delay = 8
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Common options for this request.
   RequestOptions request_options = 6;
 }

protos/google/spanner/v1/type.proto

@@ -47,6 +47,13 @@ message Type {
   // typically is not needed to process the content of a value (it doesn't
   // affect serialization) and clients can ignore it on the read path.
   TypeAnnotationCode type_annotation = 4;
+
+  // If [code][google.spanner.v1.Type.code] ==
+  // [PROTO][google.spanner.v1.TypeCode.PROTO] or
+  // [code][google.spanner.v1.Type.code] ==
+  // [ENUM][google.spanner.v1.TypeCode.ENUM], then `proto_type_fqn` is the fully
+  // qualified name of the proto type representing the proto/enum definition.
+  string proto_type_fqn = 5;
 }
 
 // `StructType` defines the fields of a [STRUCT][google.spanner.v1.TypeCode.STRUCT] type.
@@ -96,6 +103,10 @@ enum TypeCode {
   // `"-Infinity"`.
   FLOAT64 = 3;
 
+  // Encoded as `number`, or the strings `"NaN"`, `"Infinity"`, or
+  // `"-Infinity"`.
+  FLOAT32 = 15;
+
   // Encoded as `string` in RFC 3339 timestamp format. The time zone
   // must be present, and must be `"Z"`.
   //
@@ -145,6 +156,13 @@ enum TypeCode {
   //   preserved.
   // - JSON array elements will have their order preserved.
   JSON = 11;
+
+  // Encoded as a base64-encoded `string`, as described in RFC 4648,
+  // section 4.
+  PROTO = 13;
+
+  // Encoded as `string`, in decimal format.
+  ENUM = 14;
 }
 
 // `TypeAnnotationCode` is used as a part of [Type][google.spanner.v1.Type] to