fix: split v1 and v1beta1 protos to improve startup time

.jsdoc.js

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

dev/protos/google/api/resource.proto

@@ -57,22 +57,15 @@ extend google.protobuf.MessageOptions {
 //       // For Kubernetes resources, the format is {api group}/{kind}.
 //       option (google.api.resource) = {
 //         type: "pubsub.googleapis.com/Topic"
-//         name_descriptor: {
-//           pattern: "projects/{project}/topics/{topic}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         }
+//         pattern: "projects/{project}/topics/{topic}"
 //       };
 //     }
 //
 // The ResourceDescriptor Yaml config will look like:
 //
 //     resources:
 //     - type: "pubsub.googleapis.com/Topic"
-//       name_descriptor:
-//         - pattern: "projects/{project}/topics/{topic}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
+//       pattern: "projects/{project}/topics/{topic}"
 //
 // Sometimes, resources have multiple patterns, typically because they can
 // live under multiple parents.
@@ -82,75 +75,21 @@ extend google.protobuf.MessageOptions {
 //     message LogEntry {
 //       option (google.api.resource) = {
 //         type: "logging.googleapis.com/LogEntry"
-//         name_descriptor: {
-//           pattern: "projects/{project}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         }
-//         name_descriptor: {
-//           pattern: "folders/{folder}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//           parent_name_extractor: "folders/{folder}"
-//         }
-//         name_descriptor: {
-//           pattern: "organizations/{organization}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-//           parent_name_extractor: "organizations/{organization}"
-//         }
-//         name_descriptor: {
-//           pattern: "billingAccounts/{billing_account}/logs/{log}"
-//           parent_type: "billing.googleapis.com/BillingAccount"
-//           parent_name_extractor: "billingAccounts/{billing_account}"
-//         }
+//         pattern: "projects/{project}/logs/{log}"
+//         pattern: "folders/{folder}/logs/{log}"
+//         pattern: "organizations/{organization}/logs/{log}"
+//         pattern: "billingAccounts/{billing_account}/logs/{log}"
 //       };
 //     }
 //
 // The ResourceDescriptor Yaml config will look like:
 //
 //     resources:
 //     - type: 'logging.googleapis.com/LogEntry'
-//       name_descriptor:
-//         - pattern: "projects/{project}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         - pattern: "folders/{folder}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//           parent_name_extractor: "folders/{folder}"
-//         - pattern: "organizations/{organization}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-//           parent_name_extractor: "organizations/{organization}"
-//         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-//           parent_type: "billing.googleapis.com/BillingAccount"
-//           parent_name_extractor: "billingAccounts/{billing_account}"
-//
-// For flexible resources, the resource name doesn't contain parent names, but
-// the resource itself has parents for policy evaluation.
-//
-// Example:
-//
-//     message Shelf {
-//       option (google.api.resource) = {
-//         type: "library.googleapis.com/Shelf"
-//         name_descriptor: {
-//           pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//         }
-//         name_descriptor: {
-//           pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//         }
-//       };
-//     }
-//
-// The ResourceDescriptor Yaml config will look like:
-//
-//     resources:
-//     - type: 'library.googleapis.com/Shelf'
-//       name_descriptor:
-//         - pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//         - pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+//       pattern: "projects/{project}/logs/{log}"
+//       pattern: "folders/{folder}/logs/{log}"
+//       pattern: "organizations/{organization}/logs/{log}"
+//       pattern: "billingAccounts/{billing_account}/logs/{log}"
 message ResourceDescriptor {
   // A description of the historical or future-looking state of the
   // resource pattern.

dev/protos/google/firestore/admin/v1/database.proto

@@ -0,0 +1,98 @@
+// Copyright 2021 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
+//
+// 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.
+
+syntax = "proto3";
+
+package google.firestore.admin.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "DatabaseProto";
+option java_package = "com.google.firestore.admin.v1";
+option objc_class_prefix = "GCFS";
+option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
+option ruby_package = "Google::Cloud::Firestore::Admin::V1";
+
+// A Cloud Firestore Database.
+// Currently only one database is allowed per cloud project; this database
+// must have a `database_id` of '(default)'.
+message Database {
+  option (google.api.resource) = {
+    type: "firestore.googleapis.com/Database"
+    pattern: "projects/{project}/databases/{database}"
+    style: DECLARATIVE_FRIENDLY
+  };
+
+  // The type of the database.
+  // See https://cloud.google.com/datastore/docs/firestore-or-datastore for
+  // information about how to choose.
+  enum DatabaseType {
+    // The default value. This value is used if the database type is omitted.
+    DATABASE_TYPE_UNSPECIFIED = 0;
+
+    // Firestore Native Mode
+    FIRESTORE_NATIVE = 1;
+
+    // Firestore in Datastore Mode.
+    DATASTORE_MODE = 2;
+  }
+
+  // The type of concurrency control mode for transactions.
+  enum ConcurrencyMode {
+    // Not used.
+    CONCURRENCY_MODE_UNSPECIFIED = 0;
+
+    // Use optimistic concurrency control by default. This setting is available
+    // for Cloud Firestore customers.
+    OPTIMISTIC = 1;
+
+    // Use pessimistic concurrency control by default. This setting is available
+    // for Cloud Firestore customers.
+    // This is the default setting for Cloud Firestore.
+    PESSIMISTIC = 2;
+
+    // Use optimistic concurrency control with entity groups by default. This is
+    // the only available setting for Cloud Datastore customers.
+    // This is the default setting for Cloud Datastore.
+    OPTIMISTIC_WITH_ENTITY_GROUPS = 3;
+  }
+
+  // The resource name of the Database.
+  // Format: `projects/{project}/databases/{database}`
+  string name = 1;
+
+  // The location of the database. Available databases are listed at
+  // https://cloud.google.com/firestore/docs/locations.
+  string location_id = 9;
+
+  // The type of the database.
+  // See https://cloud.google.com/datastore/docs/firestore-or-datastore for
+  // information about how to choose.
+  DatabaseType type = 10;
+
+  // The concurrency control mode to use for this database.
+  ConcurrencyMode concurrency_mode = 15;
+
+  // This checksum is computed by the server based on the value of other
+  // fields, and may be sent on update and delete requests to ensure the
+  // client has an up-to-date value before proceeding.
+  string etag = 99;
+}

dev/protos/google/firestore/admin/v1/field.proto

@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,12 @@
 // 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.
-//
 
 syntax = "proto3";
 
 package google.firestore.admin.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/firestore/admin/v1/index.proto";
 import "google/api/annotations.proto";
@@ -64,7 +64,7 @@ message Field {
     bool reverting = 4;
   }
 
-  // A field name of the form
+  // Required. A field name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}`
   //
   // A field path may be a simple field name, e.g. `address` or a path to fields
@@ -90,7 +90,7 @@ message Field {
   // `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`
   // Indexes defined on this `Field` will be applied to all fields which do not
   // have their own `Field` index configuration.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The index configuration for this field. If unset, field indexing will
   // revert to the configuration defined by the `ancestor_field`. To