@milaboratories/pl-client 2.11.3 → 2.11.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/core/transaction.d.ts +2 -1
  2. package/dist/core/transaction.d.ts.map +1 -1
  3. package/dist/index.js +1 -1
  4. package/dist/index.js.map +1 -1
  5. package/dist/index.mjs +1377 -1173
  6. package/dist/index.mjs.map +1 -1
  7. package/dist/proto/github.com/googleapis/googleapis/google/rpc/status.d.ts +3 -3
  8. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client.d.ts +4 -4
  9. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client.d.ts.map +1 -1
  10. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.d.ts +16 -16
  11. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.d.ts.map +1 -1
  12. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client.d.ts +2 -2
  13. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.d.ts +11 -11
  14. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.client.d.ts +8 -8
  15. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.client.d.ts.map +1 -1
  16. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.d.ts +22 -22
  17. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.d.ts.map +1 -1
  18. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client.d.ts +10 -10
  19. package/dist/proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.d.ts +25 -25
  20. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/api.client.d.ts +50 -50
  21. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/api.d.ts +415 -304
  22. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/api.d.ts.map +1 -1
  23. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/api_types.d.ts +70 -66
  24. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/api_types.d.ts.map +1 -1
  25. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/base_types.d.ts +4 -4
  26. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/import.d.ts +16 -16
  27. package/dist/proto/github.com/milaboratory/pl/plapi/plapiproto/resource_types.d.ts +30 -30
  28. package/dist/proto/google/api/http.d.ts +93 -89
  29. package/dist/proto/google/api/http.d.ts.map +1 -1
  30. package/dist/proto/google/protobuf/any.d.ts +2 -2
  31. package/dist/proto/google/protobuf/descriptor.d.ts +1298 -1151
  32. package/dist/proto/google/protobuf/descriptor.d.ts.map +1 -1
  33. package/dist/proto/google/protobuf/duration.d.ts +2 -2
  34. package/dist/proto/google/protobuf/struct.d.ts +10 -8
  35. package/dist/proto/google/protobuf/struct.d.ts.map +1 -1
  36. package/dist/proto/google/protobuf/timestamp.d.ts +2 -2
  37. package/dist/proto/google/protobuf/wrappers.d.ts +36 -9
  38. package/dist/proto/google/protobuf/wrappers.d.ts.map +1 -1
  39. package/package.json +3 -3
  40. package/src/core/ll_client.test.ts +3 -3
  41. package/src/core/ll_transaction.test.ts +4 -4
  42. package/src/core/transaction.ts +2 -0
  43. package/src/proto/github.com/googleapis/googleapis/google/rpc/status.ts +5 -5
  44. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client.ts +23 -24
  45. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.ts +232 -247
  46. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client.ts +3 -3
  47. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.ts +13 -13
  48. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.client.ts +35 -37
  49. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/progressapi/protocol.ts +375 -399
  50. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client.ts +11 -11
  51. package/src/proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.ts +26 -26
  52. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/api.client.ts +51 -51
  53. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/api.ts +687 -418
  54. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/api_types.ts +113 -101
  55. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/base_types.ts +5 -5
  56. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/import.ts +17 -17
  57. package/src/proto/github.com/milaboratory/pl/plapi/plapiproto/resource_types.ts +50 -50
  58. package/src/proto/google/api/http.ts +290 -295
  59. package/src/proto/google/protobuf/any.ts +3 -3
  60. package/src/proto/google/protobuf/descriptor.ts +3235 -3123
  61. package/src/proto/google/protobuf/duration.ts +3 -3
  62. package/src/proto/google/protobuf/empty.ts +1 -1
  63. package/src/proto/google/protobuf/struct.ts +13 -11
  64. package/src/proto/google/protobuf/timestamp.ts +3 -3
  65. package/src/proto/google/protobuf/wrappers.ts +48 -14
@@ -7,8 +7,8 @@ import { BinaryWriteOptions, IBinaryWriter, BinaryReadOptions, IBinaryReader, Pa
7
7
  */
8
8
  export interface FileDescriptorSet {
9
9
  /**
10
- * @generated from protobuf field: repeated google.protobuf.FileDescriptorProto file = 1;
11
- */
10
+ * @generated from protobuf field: repeated google.protobuf.FileDescriptorProto file = 1
11
+ */
12
12
  file: FileDescriptorProto[];
13
13
  }
14
14
  /**
@@ -18,77 +18,90 @@ export interface FileDescriptorSet {
18
18
  */
19
19
  export interface FileDescriptorProto {
20
20
  /**
21
- * @generated from protobuf field: optional string name = 1;
22
- */
21
+ * @generated from protobuf field: optional string name = 1
22
+ */
23
23
  name?: string;
24
24
  /**
25
- * @generated from protobuf field: optional string package = 2;
26
- */
25
+ * @generated from protobuf field: optional string package = 2
26
+ */
27
27
  package?: string;
28
28
  /**
29
- * Names of files imported by this file.
30
- *
31
- * @generated from protobuf field: repeated string dependency = 3;
32
- */
29
+ * Names of files imported by this file.
30
+ *
31
+ * @generated from protobuf field: repeated string dependency = 3
32
+ */
33
33
  dependency: string[];
34
34
  /**
35
- * Indexes of the public imported files in the dependency list above.
36
- *
37
- * @generated from protobuf field: repeated int32 public_dependency = 10;
38
- */
35
+ * Indexes of the public imported files in the dependency list above.
36
+ *
37
+ * @generated from protobuf field: repeated int32 public_dependency = 10
38
+ */
39
39
  publicDependency: number[];
40
40
  /**
41
- * Indexes of the weak imported files in the dependency list.
42
- * For Google-internal migration only. Do not use.
43
- *
44
- * @generated from protobuf field: repeated int32 weak_dependency = 11;
45
- */
41
+ * Indexes of the weak imported files in the dependency list.
42
+ * For Google-internal migration only. Do not use.
43
+ *
44
+ * @generated from protobuf field: repeated int32 weak_dependency = 11
45
+ */
46
46
  weakDependency: number[];
47
47
  /**
48
- * All top-level definitions in this file.
49
- *
50
- * @generated from protobuf field: repeated google.protobuf.DescriptorProto message_type = 4;
51
- */
48
+ * Names of files imported by this file purely for the purpose of providing
49
+ * option extensions. These are excluded from the dependency list above.
50
+ *
51
+ * @generated from protobuf field: repeated string option_dependency = 15
52
+ */
53
+ optionDependency: string[];
54
+ /**
55
+ * All top-level definitions in this file.
56
+ *
57
+ * @generated from protobuf field: repeated google.protobuf.DescriptorProto message_type = 4
58
+ */
52
59
  messageType: DescriptorProto[];
53
60
  /**
54
- * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto enum_type = 5;
55
- */
61
+ * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto enum_type = 5
62
+ */
56
63
  enumType: EnumDescriptorProto[];
57
64
  /**
58
- * @generated from protobuf field: repeated google.protobuf.ServiceDescriptorProto service = 6;
59
- */
65
+ * @generated from protobuf field: repeated google.protobuf.ServiceDescriptorProto service = 6
66
+ */
60
67
  service: ServiceDescriptorProto[];
61
68
  /**
62
- * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto extension = 7;
63
- */
69
+ * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto extension = 7
70
+ */
64
71
  extension: FieldDescriptorProto[];
65
72
  /**
66
- * @generated from protobuf field: optional google.protobuf.FileOptions options = 8;
67
- */
73
+ * @generated from protobuf field: optional google.protobuf.FileOptions options = 8
74
+ */
68
75
  options?: FileOptions;
69
76
  /**
70
- * This field contains optional information about the original source code.
71
- * You may safely remove this entire field without harming runtime
72
- * functionality of the descriptors -- the information is needed only by
73
- * development tools.
74
- *
75
- * @generated from protobuf field: optional google.protobuf.SourceCodeInfo source_code_info = 9;
76
- */
77
+ * This field contains optional information about the original source code.
78
+ * You may safely remove this entire field without harming runtime
79
+ * functionality of the descriptors -- the information is needed only by
80
+ * development tools.
81
+ *
82
+ * @generated from protobuf field: optional google.protobuf.SourceCodeInfo source_code_info = 9
83
+ */
77
84
  sourceCodeInfo?: SourceCodeInfo;
78
85
  /**
79
- * The syntax of the proto file.
80
- * The supported values are "proto2", "proto3", and "editions".
81
- *
82
- * If `edition` is present, this value must be "editions".
83
- *
84
- * @generated from protobuf field: optional string syntax = 12;
85
- */
86
+ * The syntax of the proto file.
87
+ * The supported values are "proto2", "proto3", and "editions".
88
+ *
89
+ * If `edition` is present, this value must be "editions".
90
+ * WARNING: This field should only be used by protobuf plugins or special
91
+ * cases like the proto compiler. Other uses are discouraged and
92
+ * developers should rely on the protoreflect APIs for their client language.
93
+ *
94
+ * @generated from protobuf field: optional string syntax = 12
95
+ */
86
96
  syntax?: string;
87
97
  /**
88
- * The edition of the proto file.
89
- *
90
- * @generated from protobuf field: optional google.protobuf.Edition edition = 14;
91
- */
98
+ * The edition of the proto file.
99
+ * WARNING: This field should only be used by protobuf plugins or special
100
+ * cases like the proto compiler. Other uses are discouraged and
101
+ * developers should rely on the protoreflect APIs for their client language.
102
+ *
103
+ * @generated from protobuf field: optional google.protobuf.Edition edition = 14
104
+ */
92
105
  edition?: Edition;
93
106
  }
94
107
  /**
@@ -98,64 +111,70 @@ export interface FileDescriptorProto {
98
111
  */
99
112
  export interface DescriptorProto {
100
113
  /**
101
- * @generated from protobuf field: optional string name = 1;
102
- */
114
+ * @generated from protobuf field: optional string name = 1
115
+ */
103
116
  name?: string;
104
117
  /**
105
- * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto field = 2;
106
- */
118
+ * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto field = 2
119
+ */
107
120
  field: FieldDescriptorProto[];
108
121
  /**
109
- * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto extension = 6;
110
- */
122
+ * @generated from protobuf field: repeated google.protobuf.FieldDescriptorProto extension = 6
123
+ */
111
124
  extension: FieldDescriptorProto[];
112
125
  /**
113
- * @generated from protobuf field: repeated google.protobuf.DescriptorProto nested_type = 3;
114
- */
126
+ * @generated from protobuf field: repeated google.protobuf.DescriptorProto nested_type = 3
127
+ */
115
128
  nestedType: DescriptorProto[];
116
129
  /**
117
- * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto enum_type = 4;
118
- */
130
+ * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto enum_type = 4
131
+ */
119
132
  enumType: EnumDescriptorProto[];
120
133
  /**
121
- * @generated from protobuf field: repeated google.protobuf.DescriptorProto.ExtensionRange extension_range = 5;
122
- */
134
+ * @generated from protobuf field: repeated google.protobuf.DescriptorProto.ExtensionRange extension_range = 5
135
+ */
123
136
  extensionRange: DescriptorProto_ExtensionRange[];
124
137
  /**
125
- * @generated from protobuf field: repeated google.protobuf.OneofDescriptorProto oneof_decl = 8;
126
- */
138
+ * @generated from protobuf field: repeated google.protobuf.OneofDescriptorProto oneof_decl = 8
139
+ */
127
140
  oneofDecl: OneofDescriptorProto[];
128
141
  /**
129
- * @generated from protobuf field: optional google.protobuf.MessageOptions options = 7;
130
- */
142
+ * @generated from protobuf field: optional google.protobuf.MessageOptions options = 7
143
+ */
131
144
  options?: MessageOptions;
132
145
  /**
133
- * @generated from protobuf field: repeated google.protobuf.DescriptorProto.ReservedRange reserved_range = 9;
134
- */
146
+ * @generated from protobuf field: repeated google.protobuf.DescriptorProto.ReservedRange reserved_range = 9
147
+ */
135
148
  reservedRange: DescriptorProto_ReservedRange[];
136
149
  /**
137
- * Reserved field names, which may not be used by fields in the same message.
138
- * A given name may only be reserved once.
139
- *
140
- * @generated from protobuf field: repeated string reserved_name = 10;
141
- */
150
+ * Reserved field names, which may not be used by fields in the same message.
151
+ * A given name may only be reserved once.
152
+ *
153
+ * @generated from protobuf field: repeated string reserved_name = 10
154
+ */
142
155
  reservedName: string[];
156
+ /**
157
+ * Support for `export` and `local` keywords on enums.
158
+ *
159
+ * @generated from protobuf field: optional google.protobuf.SymbolVisibility visibility = 11
160
+ */
161
+ visibility?: SymbolVisibility;
143
162
  }
144
163
  /**
145
164
  * @generated from protobuf message google.protobuf.DescriptorProto.ExtensionRange
146
165
  */
147
166
  export interface DescriptorProto_ExtensionRange {
148
167
  /**
149
- * @generated from protobuf field: optional int32 start = 1;
150
- */
168
+ * @generated from protobuf field: optional int32 start = 1
169
+ */
151
170
  start?: number;
152
171
  /**
153
- * @generated from protobuf field: optional int32 end = 2;
154
- */
172
+ * @generated from protobuf field: optional int32 end = 2
173
+ */
155
174
  end?: number;
156
175
  /**
157
- * @generated from protobuf field: optional google.protobuf.ExtensionRangeOptions options = 3;
158
- */
176
+ * @generated from protobuf field: optional google.protobuf.ExtensionRangeOptions options = 3
177
+ */
159
178
  options?: ExtensionRangeOptions;
160
179
  }
161
180
  /**
@@ -167,12 +186,12 @@ export interface DescriptorProto_ExtensionRange {
167
186
  */
168
187
  export interface DescriptorProto_ReservedRange {
169
188
  /**
170
- * @generated from protobuf field: optional int32 start = 1;
171
- */
189
+ * @generated from protobuf field: optional int32 start = 1
190
+ */
172
191
  start?: number;
173
192
  /**
174
- * @generated from protobuf field: optional int32 end = 2;
175
- */
193
+ * @generated from protobuf field: optional int32 end = 2
194
+ */
176
195
  end?: number;
177
196
  }
178
197
  /**
@@ -180,32 +199,32 @@ export interface DescriptorProto_ReservedRange {
180
199
  */
181
200
  export interface ExtensionRangeOptions {
182
201
  /**
183
- * The parser stores options it doesn't recognize here. See above.
184
- *
185
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
186
- */
202
+ * The parser stores options it doesn't recognize here. See above.
203
+ *
204
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
205
+ */
187
206
  uninterpretedOption: UninterpretedOption[];
188
207
  /**
189
- * For external users: DO NOT USE. We are in the process of open sourcing
190
- * extension declaration and executing internal cleanups before it can be
191
- * used externally.
192
- *
193
- * @generated from protobuf field: repeated google.protobuf.ExtensionRangeOptions.Declaration declaration = 2;
194
- */
208
+ * For external users: DO NOT USE. We are in the process of open sourcing
209
+ * extension declaration and executing internal cleanups before it can be
210
+ * used externally.
211
+ *
212
+ * @generated from protobuf field: repeated google.protobuf.ExtensionRangeOptions.Declaration declaration = 2
213
+ */
195
214
  declaration: ExtensionRangeOptions_Declaration[];
196
215
  /**
197
- * Any features defined in the specific edition.
198
- *
199
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 50;
200
- */
216
+ * Any features defined in the specific edition.
217
+ *
218
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 50
219
+ */
201
220
  features?: FeatureSet;
202
221
  /**
203
- * The verification state of the range.
204
- * TODO: flip the default to DECLARATION once all empty ranges
205
- * are marked as UNVERIFIED.
206
- *
207
- * @generated from protobuf field: optional google.protobuf.ExtensionRangeOptions.VerificationState verification = 3;
208
- */
222
+ * The verification state of the range.
223
+ * TODO: flip the default to DECLARATION once all empty ranges
224
+ * are marked as UNVERIFIED.
225
+ *
226
+ * @generated from protobuf field: optional google.protobuf.ExtensionRangeOptions.VerificationState verification = 3 [default = UNVERIFIED]
227
+ */
209
228
  verification?: ExtensionRangeOptions_VerificationState;
210
229
  }
211
230
  /**
@@ -213,40 +232,40 @@ export interface ExtensionRangeOptions {
213
232
  */
214
233
  export interface ExtensionRangeOptions_Declaration {
215
234
  /**
216
- * The extension number declared within the extension range.
217
- *
218
- * @generated from protobuf field: optional int32 number = 1;
219
- */
235
+ * The extension number declared within the extension range.
236
+ *
237
+ * @generated from protobuf field: optional int32 number = 1
238
+ */
220
239
  number?: number;
221
240
  /**
222
- * The fully-qualified name of the extension field. There must be a leading
223
- * dot in front of the full name.
224
- *
225
- * @generated from protobuf field: optional string full_name = 2;
226
- */
241
+ * The fully-qualified name of the extension field. There must be a leading
242
+ * dot in front of the full name.
243
+ *
244
+ * @generated from protobuf field: optional string full_name = 2
245
+ */
227
246
  fullName?: string;
228
247
  /**
229
- * The fully-qualified type name of the extension field. Unlike
230
- * Metadata.type, Declaration.type must have a leading dot for messages
231
- * and enums.
232
- *
233
- * @generated from protobuf field: optional string type = 3;
234
- */
248
+ * The fully-qualified type name of the extension field. Unlike
249
+ * Metadata.type, Declaration.type must have a leading dot for messages
250
+ * and enums.
251
+ *
252
+ * @generated from protobuf field: optional string type = 3
253
+ */
235
254
  type?: string;
236
255
  /**
237
- * If true, indicates that the number is reserved in the extension range,
238
- * and any extension field with the number will fail to compile. Set this
239
- * when a declared extension field is deleted.
240
- *
241
- * @generated from protobuf field: optional bool reserved = 5;
242
- */
256
+ * If true, indicates that the number is reserved in the extension range,
257
+ * and any extension field with the number will fail to compile. Set this
258
+ * when a declared extension field is deleted.
259
+ *
260
+ * @generated from protobuf field: optional bool reserved = 5
261
+ */
243
262
  reserved?: boolean;
244
263
  /**
245
- * If true, indicates that the extension must be defined as repeated.
246
- * Otherwise the extension must be defined as optional.
247
- *
248
- * @generated from protobuf field: optional bool repeated = 6;
249
- */
264
+ * If true, indicates that the extension must be defined as repeated.
265
+ * Otherwise the extension must be defined as optional.
266
+ *
267
+ * @generated from protobuf field: optional bool repeated = 6
268
+ */
250
269
  repeated?: boolean;
251
270
  }
252
271
  /**
@@ -256,14 +275,14 @@ export interface ExtensionRangeOptions_Declaration {
256
275
  */
257
276
  export declare enum ExtensionRangeOptions_VerificationState {
258
277
  /**
259
- * All the extensions of the range must be declared.
260
- *
261
- * @generated from protobuf enum value: DECLARATION = 0;
262
- */
278
+ * All the extensions of the range must be declared.
279
+ *
280
+ * @generated from protobuf enum value: DECLARATION = 0;
281
+ */
263
282
  DECLARATION = 0,
264
283
  /**
265
- * @generated from protobuf enum value: UNVERIFIED = 1;
266
- */
284
+ * @generated from protobuf enum value: UNVERIFIED = 1;
285
+ */
267
286
  UNVERIFIED = 1
268
287
  }
269
288
  /**
@@ -273,95 +292,95 @@ export declare enum ExtensionRangeOptions_VerificationState {
273
292
  */
274
293
  export interface FieldDescriptorProto {
275
294
  /**
276
- * @generated from protobuf field: optional string name = 1;
277
- */
295
+ * @generated from protobuf field: optional string name = 1
296
+ */
278
297
  name?: string;
279
298
  /**
280
- * @generated from protobuf field: optional int32 number = 3;
281
- */
299
+ * @generated from protobuf field: optional int32 number = 3
300
+ */
282
301
  number?: number;
283
302
  /**
284
- * @generated from protobuf field: optional google.protobuf.FieldDescriptorProto.Label label = 4;
285
- */
303
+ * @generated from protobuf field: optional google.protobuf.FieldDescriptorProto.Label label = 4
304
+ */
286
305
  label?: FieldDescriptorProto_Label;
287
306
  /**
288
- * If type_name is set, this need not be set. If both this and type_name
289
- * are set, this must be one of TYPE_ENUM, TYPE_MESSAGE or TYPE_GROUP.
290
- *
291
- * @generated from protobuf field: optional google.protobuf.FieldDescriptorProto.Type type = 5;
292
- */
307
+ * If type_name is set, this need not be set. If both this and type_name
308
+ * are set, this must be one of TYPE_ENUM, TYPE_MESSAGE or TYPE_GROUP.
309
+ *
310
+ * @generated from protobuf field: optional google.protobuf.FieldDescriptorProto.Type type = 5
311
+ */
293
312
  type?: FieldDescriptorProto_Type;
294
313
  /**
295
- * For message and enum types, this is the name of the type. If the name
296
- * starts with a '.', it is fully-qualified. Otherwise, C++-like scoping
297
- * rules are used to find the type (i.e. first the nested types within this
298
- * message are searched, then within the parent, on up to the root
299
- * namespace).
300
- *
301
- * @generated from protobuf field: optional string type_name = 6;
302
- */
314
+ * For message and enum types, this is the name of the type. If the name
315
+ * starts with a '.', it is fully-qualified. Otherwise, C++-like scoping
316
+ * rules are used to find the type (i.e. first the nested types within this
317
+ * message are searched, then within the parent, on up to the root
318
+ * namespace).
319
+ *
320
+ * @generated from protobuf field: optional string type_name = 6
321
+ */
303
322
  typeName?: string;
304
323
  /**
305
- * For extensions, this is the name of the type being extended. It is
306
- * resolved in the same manner as type_name.
307
- *
308
- * @generated from protobuf field: optional string extendee = 2;
309
- */
324
+ * For extensions, this is the name of the type being extended. It is
325
+ * resolved in the same manner as type_name.
326
+ *
327
+ * @generated from protobuf field: optional string extendee = 2
328
+ */
310
329
  extendee?: string;
311
330
  /**
312
- * For numeric types, contains the original text representation of the value.
313
- * For booleans, "true" or "false".
314
- * For strings, contains the default text contents (not escaped in any way).
315
- * For bytes, contains the C escaped value. All bytes >= 128 are escaped.
316
- *
317
- * @generated from protobuf field: optional string default_value = 7;
318
- */
331
+ * For numeric types, contains the original text representation of the value.
332
+ * For booleans, "true" or "false".
333
+ * For strings, contains the default text contents (not escaped in any way).
334
+ * For bytes, contains the C escaped value. All bytes >= 128 are escaped.
335
+ *
336
+ * @generated from protobuf field: optional string default_value = 7
337
+ */
319
338
  defaultValue?: string;
320
339
  /**
321
- * If set, gives the index of a oneof in the containing type's oneof_decl
322
- * list. This field is a member of that oneof.
323
- *
324
- * @generated from protobuf field: optional int32 oneof_index = 9;
325
- */
340
+ * If set, gives the index of a oneof in the containing type's oneof_decl
341
+ * list. This field is a member of that oneof.
342
+ *
343
+ * @generated from protobuf field: optional int32 oneof_index = 9
344
+ */
326
345
  oneofIndex?: number;
327
346
  /**
328
- * JSON name of this field. The value is set by protocol compiler. If the
329
- * user has set a "json_name" option on this field, that option's value
330
- * will be used. Otherwise, it's deduced from the field's name by converting
331
- * it to camelCase.
332
- *
333
- * @generated from protobuf field: optional string json_name = 10;
334
- */
347
+ * JSON name of this field. The value is set by protocol compiler. If the
348
+ * user has set a "json_name" option on this field, that option's value
349
+ * will be used. Otherwise, it's deduced from the field's name by converting
350
+ * it to camelCase.
351
+ *
352
+ * @generated from protobuf field: optional string json_name = 10
353
+ */
335
354
  jsonName?: string;
336
355
  /**
337
- * @generated from protobuf field: optional google.protobuf.FieldOptions options = 8;
338
- */
356
+ * @generated from protobuf field: optional google.protobuf.FieldOptions options = 8
357
+ */
339
358
  options?: FieldOptions;
340
359
  /**
341
- * If true, this is a proto3 "optional". When a proto3 field is optional, it
342
- * tracks presence regardless of field type.
343
- *
344
- * When proto3_optional is true, this field must belong to a oneof to signal
345
- * to old proto3 clients that presence is tracked for this field. This oneof
346
- * is known as a "synthetic" oneof, and this field must be its sole member
347
- * (each proto3 optional field gets its own synthetic oneof). Synthetic oneofs
348
- * exist in the descriptor only, and do not generate any API. Synthetic oneofs
349
- * must be ordered after all "real" oneofs.
350
- *
351
- * For message fields, proto3_optional doesn't create any semantic change,
352
- * since non-repeated message fields always track presence. However it still
353
- * indicates the semantic detail of whether the user wrote "optional" or not.
354
- * This can be useful for round-tripping the .proto file. For consistency we
355
- * give message fields a synthetic oneof also, even though it is not required
356
- * to track presence. This is especially important because the parser can't
357
- * tell if a field is a message or an enum, so it must always create a
358
- * synthetic oneof.
359
- *
360
- * Proto2 optional fields do not set this flag, because they already indicate
361
- * optional with `LABEL_OPTIONAL`.
362
- *
363
- * @generated from protobuf field: optional bool proto3_optional = 17;
364
- */
360
+ * If true, this is a proto3 "optional". When a proto3 field is optional, it
361
+ * tracks presence regardless of field type.
362
+ *
363
+ * When proto3_optional is true, this field must belong to a oneof to signal
364
+ * to old proto3 clients that presence is tracked for this field. This oneof
365
+ * is known as a "synthetic" oneof, and this field must be its sole member
366
+ * (each proto3 optional field gets its own synthetic oneof). Synthetic oneofs
367
+ * exist in the descriptor only, and do not generate any API. Synthetic oneofs
368
+ * must be ordered after all "real" oneofs.
369
+ *
370
+ * For message fields, proto3_optional doesn't create any semantic change,
371
+ * since non-repeated message fields always track presence. However it still
372
+ * indicates the semantic detail of whether the user wrote "optional" or not.
373
+ * This can be useful for round-tripping the .proto file. For consistency we
374
+ * give message fields a synthetic oneof also, even though it is not required
375
+ * to track presence. This is especially important because the parser can't
376
+ * tell if a field is a message or an enum, so it must always create a
377
+ * synthetic oneof.
378
+ *
379
+ * Proto2 optional fields do not set this flag, because they already indicate
380
+ * optional with `LABEL_OPTIONAL`.
381
+ *
382
+ * @generated from protobuf field: optional bool proto3_optional = 17
383
+ */
365
384
  proto3Optional?: boolean;
366
385
  }
367
386
  /**
@@ -369,103 +388,103 @@ export interface FieldDescriptorProto {
369
388
  */
370
389
  export declare enum FieldDescriptorProto_Type {
371
390
  /**
372
- * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
373
- */
391
+ * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
392
+ */
374
393
  UNSPECIFIED$ = 0,
375
394
  /**
376
- * 0 is reserved for errors.
377
- * Order is weird for historical reasons.
378
- *
379
- * @generated from protobuf enum value: TYPE_DOUBLE = 1;
380
- */
395
+ * 0 is reserved for errors.
396
+ * Order is weird for historical reasons.
397
+ *
398
+ * @generated from protobuf enum value: TYPE_DOUBLE = 1;
399
+ */
381
400
  DOUBLE = 1,
382
401
  /**
383
- * @generated from protobuf enum value: TYPE_FLOAT = 2;
384
- */
402
+ * @generated from protobuf enum value: TYPE_FLOAT = 2;
403
+ */
385
404
  FLOAT = 2,
386
405
  /**
387
- * Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT64 if
388
- * negative values are likely.
389
- *
390
- * @generated from protobuf enum value: TYPE_INT64 = 3;
391
- */
406
+ * Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT64 if
407
+ * negative values are likely.
408
+ *
409
+ * @generated from protobuf enum value: TYPE_INT64 = 3;
410
+ */
392
411
  INT64 = 3,
393
412
  /**
394
- * @generated from protobuf enum value: TYPE_UINT64 = 4;
395
- */
413
+ * @generated from protobuf enum value: TYPE_UINT64 = 4;
414
+ */
396
415
  UINT64 = 4,
397
416
  /**
398
- * Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT32 if
399
- * negative values are likely.
400
- *
401
- * @generated from protobuf enum value: TYPE_INT32 = 5;
402
- */
417
+ * Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT32 if
418
+ * negative values are likely.
419
+ *
420
+ * @generated from protobuf enum value: TYPE_INT32 = 5;
421
+ */
403
422
  INT32 = 5,
404
423
  /**
405
- * @generated from protobuf enum value: TYPE_FIXED64 = 6;
406
- */
424
+ * @generated from protobuf enum value: TYPE_FIXED64 = 6;
425
+ */
407
426
  FIXED64 = 6,
408
427
  /**
409
- * @generated from protobuf enum value: TYPE_FIXED32 = 7;
410
- */
428
+ * @generated from protobuf enum value: TYPE_FIXED32 = 7;
429
+ */
411
430
  FIXED32 = 7,
412
431
  /**
413
- * @generated from protobuf enum value: TYPE_BOOL = 8;
414
- */
432
+ * @generated from protobuf enum value: TYPE_BOOL = 8;
433
+ */
415
434
  BOOL = 8,
416
435
  /**
417
- * @generated from protobuf enum value: TYPE_STRING = 9;
418
- */
436
+ * @generated from protobuf enum value: TYPE_STRING = 9;
437
+ */
419
438
  STRING = 9,
420
439
  /**
421
- * Tag-delimited aggregate.
422
- * Group type is deprecated and not supported after google.protobuf. However, Proto3
423
- * implementations should still be able to parse the group wire format and
424
- * treat group fields as unknown fields. In Editions, the group wire format
425
- * can be enabled via the `message_encoding` feature.
426
- *
427
- * @generated from protobuf enum value: TYPE_GROUP = 10;
428
- */
440
+ * Tag-delimited aggregate.
441
+ * Group type is deprecated and not supported after google.protobuf. However, Proto3
442
+ * implementations should still be able to parse the group wire format and
443
+ * treat group fields as unknown fields. In Editions, the group wire format
444
+ * can be enabled via the `message_encoding` feature.
445
+ *
446
+ * @generated from protobuf enum value: TYPE_GROUP = 10;
447
+ */
429
448
  GROUP = 10,
430
449
  /**
431
- * Length-delimited aggregate.
432
- *
433
- * @generated from protobuf enum value: TYPE_MESSAGE = 11;
434
- */
450
+ * Length-delimited aggregate.
451
+ *
452
+ * @generated from protobuf enum value: TYPE_MESSAGE = 11;
453
+ */
435
454
  MESSAGE = 11,
436
455
  /**
437
- * New in version 2.
438
- *
439
- * @generated from protobuf enum value: TYPE_BYTES = 12;
440
- */
456
+ * New in version 2.
457
+ *
458
+ * @generated from protobuf enum value: TYPE_BYTES = 12;
459
+ */
441
460
  BYTES = 12,
442
461
  /**
443
- * @generated from protobuf enum value: TYPE_UINT32 = 13;
444
- */
462
+ * @generated from protobuf enum value: TYPE_UINT32 = 13;
463
+ */
445
464
  UINT32 = 13,
446
465
  /**
447
- * @generated from protobuf enum value: TYPE_ENUM = 14;
448
- */
466
+ * @generated from protobuf enum value: TYPE_ENUM = 14;
467
+ */
449
468
  ENUM = 14,
450
469
  /**
451
- * @generated from protobuf enum value: TYPE_SFIXED32 = 15;
452
- */
470
+ * @generated from protobuf enum value: TYPE_SFIXED32 = 15;
471
+ */
453
472
  SFIXED32 = 15,
454
473
  /**
455
- * @generated from protobuf enum value: TYPE_SFIXED64 = 16;
456
- */
474
+ * @generated from protobuf enum value: TYPE_SFIXED64 = 16;
475
+ */
457
476
  SFIXED64 = 16,
458
477
  /**
459
- * Uses ZigZag encoding.
460
- *
461
- * @generated from protobuf enum value: TYPE_SINT32 = 17;
462
- */
478
+ * Uses ZigZag encoding.
479
+ *
480
+ * @generated from protobuf enum value: TYPE_SINT32 = 17;
481
+ */
463
482
  SINT32 = 17,
464
483
  /**
465
- * Uses ZigZag encoding.
466
- *
467
- * @generated from protobuf enum value: TYPE_SINT64 = 18;
468
- */
484
+ * Uses ZigZag encoding.
485
+ *
486
+ * @generated from protobuf enum value: TYPE_SINT64 = 18;
487
+ */
469
488
  SINT64 = 18
470
489
  }
471
490
  /**
@@ -473,26 +492,26 @@ export declare enum FieldDescriptorProto_Type {
473
492
  */
474
493
  export declare enum FieldDescriptorProto_Label {
475
494
  /**
476
- * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
477
- */
495
+ * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
496
+ */
478
497
  UNSPECIFIED$ = 0,
479
498
  /**
480
- * 0 is reserved for errors
481
- *
482
- * @generated from protobuf enum value: LABEL_OPTIONAL = 1;
483
- */
499
+ * 0 is reserved for errors
500
+ *
501
+ * @generated from protobuf enum value: LABEL_OPTIONAL = 1;
502
+ */
484
503
  OPTIONAL = 1,
485
504
  /**
486
- * @generated from protobuf enum value: LABEL_REPEATED = 3;
487
- */
505
+ * @generated from protobuf enum value: LABEL_REPEATED = 3;
506
+ */
488
507
  REPEATED = 3,
489
508
  /**
490
- * The required label is only allowed in google.protobuf. In proto3 and Editions
491
- * it's explicitly prohibited. In Editions, the `field_presence` feature
492
- * can be used to get this behavior.
493
- *
494
- * @generated from protobuf enum value: LABEL_REQUIRED = 2;
495
- */
509
+ * The required label is only allowed in google.protobuf. In proto3 and Editions
510
+ * it's explicitly prohibited. In Editions, the `field_presence` feature
511
+ * can be used to get this behavior.
512
+ *
513
+ * @generated from protobuf enum value: LABEL_REQUIRED = 2;
514
+ */
496
515
  REQUIRED = 2
497
516
  }
498
517
  /**
@@ -502,12 +521,12 @@ export declare enum FieldDescriptorProto_Label {
502
521
  */
503
522
  export interface OneofDescriptorProto {
504
523
  /**
505
- * @generated from protobuf field: optional string name = 1;
506
- */
524
+ * @generated from protobuf field: optional string name = 1
525
+ */
507
526
  name?: string;
508
527
  /**
509
- * @generated from protobuf field: optional google.protobuf.OneofOptions options = 2;
510
- */
528
+ * @generated from protobuf field: optional google.protobuf.OneofOptions options = 2
529
+ */
511
530
  options?: OneofOptions;
512
531
  }
513
532
  /**
@@ -517,32 +536,38 @@ export interface OneofDescriptorProto {
517
536
  */
518
537
  export interface EnumDescriptorProto {
519
538
  /**
520
- * @generated from protobuf field: optional string name = 1;
521
- */
539
+ * @generated from protobuf field: optional string name = 1
540
+ */
522
541
  name?: string;
523
542
  /**
524
- * @generated from protobuf field: repeated google.protobuf.EnumValueDescriptorProto value = 2;
525
- */
543
+ * @generated from protobuf field: repeated google.protobuf.EnumValueDescriptorProto value = 2
544
+ */
526
545
  value: EnumValueDescriptorProto[];
527
546
  /**
528
- * @generated from protobuf field: optional google.protobuf.EnumOptions options = 3;
529
- */
547
+ * @generated from protobuf field: optional google.protobuf.EnumOptions options = 3
548
+ */
530
549
  options?: EnumOptions;
531
550
  /**
532
- * Range of reserved numeric values. Reserved numeric values may not be used
533
- * by enum values in the same enum declaration. Reserved ranges may not
534
- * overlap.
535
- *
536
- * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto.EnumReservedRange reserved_range = 4;
537
- */
551
+ * Range of reserved numeric values. Reserved numeric values may not be used
552
+ * by enum values in the same enum declaration. Reserved ranges may not
553
+ * overlap.
554
+ *
555
+ * @generated from protobuf field: repeated google.protobuf.EnumDescriptorProto.EnumReservedRange reserved_range = 4
556
+ */
538
557
  reservedRange: EnumDescriptorProto_EnumReservedRange[];
539
558
  /**
540
- * Reserved enum value names, which may not be reused. A given name may only
541
- * be reserved once.
542
- *
543
- * @generated from protobuf field: repeated string reserved_name = 5;
544
- */
559
+ * Reserved enum value names, which may not be reused. A given name may only
560
+ * be reserved once.
561
+ *
562
+ * @generated from protobuf field: repeated string reserved_name = 5
563
+ */
545
564
  reservedName: string[];
565
+ /**
566
+ * Support for `export` and `local` keywords on enums.
567
+ *
568
+ * @generated from protobuf field: optional google.protobuf.SymbolVisibility visibility = 6
569
+ */
570
+ visibility?: SymbolVisibility;
546
571
  }
547
572
  /**
548
573
  * Range of reserved numeric values. Reserved values may not be used by
@@ -556,12 +581,12 @@ export interface EnumDescriptorProto {
556
581
  */
557
582
  export interface EnumDescriptorProto_EnumReservedRange {
558
583
  /**
559
- * @generated from protobuf field: optional int32 start = 1;
560
- */
584
+ * @generated from protobuf field: optional int32 start = 1
585
+ */
561
586
  start?: number;
562
587
  /**
563
- * @generated from protobuf field: optional int32 end = 2;
564
- */
588
+ * @generated from protobuf field: optional int32 end = 2
589
+ */
565
590
  end?: number;
566
591
  }
567
592
  /**
@@ -571,16 +596,16 @@ export interface EnumDescriptorProto_EnumReservedRange {
571
596
  */
572
597
  export interface EnumValueDescriptorProto {
573
598
  /**
574
- * @generated from protobuf field: optional string name = 1;
575
- */
599
+ * @generated from protobuf field: optional string name = 1
600
+ */
576
601
  name?: string;
577
602
  /**
578
- * @generated from protobuf field: optional int32 number = 2;
579
- */
603
+ * @generated from protobuf field: optional int32 number = 2
604
+ */
580
605
  number?: number;
581
606
  /**
582
- * @generated from protobuf field: optional google.protobuf.EnumValueOptions options = 3;
583
- */
607
+ * @generated from protobuf field: optional google.protobuf.EnumValueOptions options = 3
608
+ */
584
609
  options?: EnumValueOptions;
585
610
  }
586
611
  /**
@@ -590,16 +615,16 @@ export interface EnumValueDescriptorProto {
590
615
  */
591
616
  export interface ServiceDescriptorProto {
592
617
  /**
593
- * @generated from protobuf field: optional string name = 1;
594
- */
618
+ * @generated from protobuf field: optional string name = 1
619
+ */
595
620
  name?: string;
596
621
  /**
597
- * @generated from protobuf field: repeated google.protobuf.MethodDescriptorProto method = 2;
598
- */
622
+ * @generated from protobuf field: repeated google.protobuf.MethodDescriptorProto method = 2
623
+ */
599
624
  method: MethodDescriptorProto[];
600
625
  /**
601
- * @generated from protobuf field: optional google.protobuf.ServiceOptions options = 3;
602
- */
626
+ * @generated from protobuf field: optional google.protobuf.ServiceOptions options = 3
627
+ */
603
628
  options?: ServiceOptions;
604
629
  }
605
630
  /**
@@ -609,35 +634,35 @@ export interface ServiceDescriptorProto {
609
634
  */
610
635
  export interface MethodDescriptorProto {
611
636
  /**
612
- * @generated from protobuf field: optional string name = 1;
613
- */
637
+ * @generated from protobuf field: optional string name = 1
638
+ */
614
639
  name?: string;
615
640
  /**
616
- * Input and output type names. These are resolved in the same way as
617
- * FieldDescriptorProto.type_name, but must refer to a message type.
618
- *
619
- * @generated from protobuf field: optional string input_type = 2;
620
- */
641
+ * Input and output type names. These are resolved in the same way as
642
+ * FieldDescriptorProto.type_name, but must refer to a message type.
643
+ *
644
+ * @generated from protobuf field: optional string input_type = 2
645
+ */
621
646
  inputType?: string;
622
647
  /**
623
- * @generated from protobuf field: optional string output_type = 3;
624
- */
648
+ * @generated from protobuf field: optional string output_type = 3
649
+ */
625
650
  outputType?: string;
626
651
  /**
627
- * @generated from protobuf field: optional google.protobuf.MethodOptions options = 4;
628
- */
652
+ * @generated from protobuf field: optional google.protobuf.MethodOptions options = 4
653
+ */
629
654
  options?: MethodOptions;
630
655
  /**
631
- * Identifies if client streams multiple client messages
632
- *
633
- * @generated from protobuf field: optional bool client_streaming = 5;
634
- */
656
+ * Identifies if client streams multiple client messages
657
+ *
658
+ * @generated from protobuf field: optional bool client_streaming = 5 [default = false]
659
+ */
635
660
  clientStreaming?: boolean;
636
661
  /**
637
- * Identifies if server streams multiple server messages
638
- *
639
- * @generated from protobuf field: optional bool server_streaming = 6;
640
- */
662
+ * Identifies if server streams multiple server messages
663
+ *
664
+ * @generated from protobuf field: optional bool server_streaming = 6 [default = false]
665
+ */
641
666
  serverStreaming?: boolean;
642
667
  }
643
668
  /**
@@ -645,175 +670,178 @@ export interface MethodDescriptorProto {
645
670
  */
646
671
  export interface FileOptions {
647
672
  /**
648
- * Sets the Java package where classes generated from this .proto will be
649
- * placed. By default, the proto package is used, but this is often
650
- * inappropriate because proto packages do not normally start with backwards
651
- * domain names.
652
- *
653
- * @generated from protobuf field: optional string java_package = 1;
654
- */
673
+ * Sets the Java package where classes generated from this .proto will be
674
+ * placed. By default, the proto package is used, but this is often
675
+ * inappropriate because proto packages do not normally start with backwards
676
+ * domain names.
677
+ *
678
+ * @generated from protobuf field: optional string java_package = 1
679
+ */
655
680
  javaPackage?: string;
656
681
  /**
657
- * Controls the name of the wrapper Java class generated for the .proto file.
658
- * That class will always contain the .proto file's getDescriptor() method as
659
- * well as any top-level extensions defined in the .proto file.
660
- * If java_multiple_files is disabled, then all the other classes from the
661
- * .proto file will be nested inside the single wrapper outer class.
662
- *
663
- * @generated from protobuf field: optional string java_outer_classname = 8;
664
- */
682
+ * Controls the name of the wrapper Java class generated for the .proto file.
683
+ * That class will always contain the .proto file's getDescriptor() method as
684
+ * well as any top-level extensions defined in the .proto file.
685
+ * If java_multiple_files is disabled, then all the other classes from the
686
+ * .proto file will be nested inside the single wrapper outer class.
687
+ *
688
+ * @generated from protobuf field: optional string java_outer_classname = 8
689
+ */
665
690
  javaOuterClassname?: string;
666
691
  /**
667
- * If enabled, then the Java code generator will generate a separate .java
668
- * file for each top-level message, enum, and service defined in the .proto
669
- * file. Thus, these types will *not* be nested inside the wrapper class
670
- * named by java_outer_classname. However, the wrapper class will still be
671
- * generated to contain the file's getDescriptor() method as well as any
672
- * top-level extensions defined in the file.
673
- *
674
- * @generated from protobuf field: optional bool java_multiple_files = 10;
675
- */
692
+ * If enabled, then the Java code generator will generate a separate .java
693
+ * file for each top-level message, enum, and service defined in the .proto
694
+ * file. Thus, these types will *not* be nested inside the wrapper class
695
+ * named by java_outer_classname. However, the wrapper class will still be
696
+ * generated to contain the file's getDescriptor() method as well as any
697
+ * top-level extensions defined in the file.
698
+ *
699
+ * @generated from protobuf field: optional bool java_multiple_files = 10 [default = false]
700
+ */
676
701
  javaMultipleFiles?: boolean;
677
702
  /**
678
- * This option does nothing.
679
- *
680
- * @deprecated
681
- * @generated from protobuf field: optional bool java_generate_equals_and_hash = 20 [deprecated = true];
682
- */
703
+ * This option does nothing.
704
+ *
705
+ * @deprecated
706
+ * @generated from protobuf field: optional bool java_generate_equals_and_hash = 20 [deprecated = true]
707
+ */
683
708
  javaGenerateEqualsAndHash?: boolean;
684
709
  /**
685
- * A proto2 file can set this to true to opt in to UTF-8 checking for Java,
686
- * which will throw an exception if invalid UTF-8 is parsed from the wire or
687
- * assigned to a string field.
688
- *
689
- * TODO: clarify exactly what kinds of field types this option
690
- * applies to, and update these docs accordingly.
691
- *
692
- * Proto3 files already perform these checks. Setting the option explicitly to
693
- * false has no effect: it cannot be used to opt proto3 files out of UTF-8
694
- * checks.
695
- *
696
- * @generated from protobuf field: optional bool java_string_check_utf8 = 27;
697
- */
710
+ * A proto2 file can set this to true to opt in to UTF-8 checking for Java,
711
+ * which will throw an exception if invalid UTF-8 is parsed from the wire or
712
+ * assigned to a string field.
713
+ *
714
+ * TODO: clarify exactly what kinds of field types this option
715
+ * applies to, and update these docs accordingly.
716
+ *
717
+ * Proto3 files already perform these checks. Setting the option explicitly to
718
+ * false has no effect: it cannot be used to opt proto3 files out of UTF-8
719
+ * checks.
720
+ *
721
+ * @generated from protobuf field: optional bool java_string_check_utf8 = 27 [default = false]
722
+ */
698
723
  javaStringCheckUtf8?: boolean;
699
724
  /**
700
- * @generated from protobuf field: optional google.protobuf.FileOptions.OptimizeMode optimize_for = 9;
701
- */
725
+ * @generated from protobuf field: optional google.protobuf.FileOptions.OptimizeMode optimize_for = 9 [default = SPEED]
726
+ */
702
727
  optimizeFor?: FileOptions_OptimizeMode;
703
728
  /**
704
- * Sets the Go package where structs generated from this .proto will be
705
- * placed. If omitted, the Go package will be derived from the following:
706
- * - The basename of the package import path, if provided.
707
- * - Otherwise, the package statement in the .proto file, if present.
708
- * - Otherwise, the basename of the .proto file, without extension.
709
- *
710
- * @generated from protobuf field: optional string go_package = 11;
711
- */
729
+ * Sets the Go package where structs generated from this .proto will be
730
+ * placed. If omitted, the Go package will be derived from the following:
731
+ * - The basename of the package import path, if provided.
732
+ * - Otherwise, the package statement in the .proto file, if present.
733
+ * - Otherwise, the basename of the .proto file, without extension.
734
+ *
735
+ * @generated from protobuf field: optional string go_package = 11
736
+ */
712
737
  goPackage?: string;
713
738
  /**
714
- * Should generic services be generated in each language? "Generic" services
715
- * are not specific to any particular RPC system. They are generated by the
716
- * main code generators in each language (without additional plugins).
717
- * Generic services were the only kind of service generation supported by
718
- * early versions of google.protobuf.
719
- *
720
- * Generic services are now considered deprecated in favor of using plugins
721
- * that generate code specific to your particular RPC system. Therefore,
722
- * these default to false. Old code which depends on generic services should
723
- * explicitly set them to true.
724
- *
725
- * @generated from protobuf field: optional bool cc_generic_services = 16;
726
- */
739
+ * Should generic services be generated in each language? "Generic" services
740
+ * are not specific to any particular RPC system. They are generated by the
741
+ * main code generators in each language (without additional plugins).
742
+ * Generic services were the only kind of service generation supported by
743
+ * early versions of google.protobuf.
744
+ *
745
+ * Generic services are now considered deprecated in favor of using plugins
746
+ * that generate code specific to your particular RPC system. Therefore,
747
+ * these default to false. Old code which depends on generic services should
748
+ * explicitly set them to true.
749
+ *
750
+ * @generated from protobuf field: optional bool cc_generic_services = 16 [default = false]
751
+ */
727
752
  ccGenericServices?: boolean;
728
753
  /**
729
- * @generated from protobuf field: optional bool java_generic_services = 17;
730
- */
754
+ * @generated from protobuf field: optional bool java_generic_services = 17 [default = false]
755
+ */
731
756
  javaGenericServices?: boolean;
732
757
  /**
733
- * @generated from protobuf field: optional bool py_generic_services = 18;
734
- */
758
+ * @generated from protobuf field: optional bool py_generic_services = 18 [default = false]
759
+ */
735
760
  pyGenericServices?: boolean;
736
761
  /**
737
- * Is this file deprecated?
738
- * Depending on the target platform, this can emit Deprecated annotations
739
- * for everything in the file, or it will be completely ignored; in the very
740
- * least, this is a formalization for deprecating files.
741
- *
742
- * @generated from protobuf field: optional bool deprecated = 23;
743
- */
762
+ * Is this file deprecated?
763
+ * Depending on the target platform, this can emit Deprecated annotations
764
+ * for everything in the file, or it will be completely ignored; in the very
765
+ * least, this is a formalization for deprecating files.
766
+ *
767
+ * @generated from protobuf field: optional bool deprecated = 23 [default = false]
768
+ */
744
769
  deprecated?: boolean;
745
770
  /**
746
- * Enables the use of arenas for the proto messages in this file. This applies
747
- * only to generated classes for C++.
748
- *
749
- * @generated from protobuf field: optional bool cc_enable_arenas = 31;
750
- */
771
+ * Enables the use of arenas for the proto messages in this file. This applies
772
+ * only to generated classes for C++.
773
+ *
774
+ * @generated from protobuf field: optional bool cc_enable_arenas = 31 [default = true]
775
+ */
751
776
  ccEnableArenas?: boolean;
752
777
  /**
753
- * Sets the objective c class prefix which is prepended to all objective c
754
- * generated classes from this .proto. There is no default.
755
- *
756
- * @generated from protobuf field: optional string objc_class_prefix = 36;
757
- */
778
+ * Sets the objective c class prefix which is prepended to all objective c
779
+ * generated classes from this .proto. There is no default.
780
+ *
781
+ * @generated from protobuf field: optional string objc_class_prefix = 36
782
+ */
758
783
  objcClassPrefix?: string;
759
784
  /**
760
- * Namespace for generated classes; defaults to the package.
761
- *
762
- * @generated from protobuf field: optional string csharp_namespace = 37;
763
- */
785
+ * Namespace for generated classes; defaults to the package.
786
+ *
787
+ * @generated from protobuf field: optional string csharp_namespace = 37
788
+ */
764
789
  csharpNamespace?: string;
765
790
  /**
766
- * By default Swift generators will take the proto package and CamelCase it
767
- * replacing '.' with underscore and use that to prefix the types/symbols
768
- * defined. When this options is provided, they will use this value instead
769
- * to prefix the types/symbols defined.
770
- *
771
- * @generated from protobuf field: optional string swift_prefix = 39;
772
- */
791
+ * By default Swift generators will take the proto package and CamelCase it
792
+ * replacing '.' with underscore and use that to prefix the types/symbols
793
+ * defined. When this options is provided, they will use this value instead
794
+ * to prefix the types/symbols defined.
795
+ *
796
+ * @generated from protobuf field: optional string swift_prefix = 39
797
+ */
773
798
  swiftPrefix?: string;
774
799
  /**
775
- * Sets the php class prefix which is prepended to all php generated classes
776
- * from this .proto. Default is empty.
777
- *
778
- * @generated from protobuf field: optional string php_class_prefix = 40;
779
- */
800
+ * Sets the php class prefix which is prepended to all php generated classes
801
+ * from this .proto. Default is empty.
802
+ *
803
+ * @generated from protobuf field: optional string php_class_prefix = 40
804
+ */
780
805
  phpClassPrefix?: string;
781
806
  /**
782
- * Use this option to change the namespace of php generated classes. Default
783
- * is empty. When this option is empty, the package name will be used for
784
- * determining the namespace.
785
- *
786
- * @generated from protobuf field: optional string php_namespace = 41;
787
- */
807
+ * Use this option to change the namespace of php generated classes. Default
808
+ * is empty. When this option is empty, the package name will be used for
809
+ * determining the namespace.
810
+ *
811
+ * @generated from protobuf field: optional string php_namespace = 41
812
+ */
788
813
  phpNamespace?: string;
789
814
  /**
790
- * Use this option to change the namespace of php generated metadata classes.
791
- * Default is empty. When this option is empty, the proto file name will be
792
- * used for determining the namespace.
793
- *
794
- * @generated from protobuf field: optional string php_metadata_namespace = 44;
795
- */
815
+ * Use this option to change the namespace of php generated metadata classes.
816
+ * Default is empty. When this option is empty, the proto file name will be
817
+ * used for determining the namespace.
818
+ *
819
+ * @generated from protobuf field: optional string php_metadata_namespace = 44
820
+ */
796
821
  phpMetadataNamespace?: string;
797
822
  /**
798
- * Use this option to change the package of ruby generated classes. Default
799
- * is empty. When this option is not set, the package name will be used for
800
- * determining the ruby package.
801
- *
802
- * @generated from protobuf field: optional string ruby_package = 45;
803
- */
823
+ * Use this option to change the package of ruby generated classes. Default
824
+ * is empty. When this option is not set, the package name will be used for
825
+ * determining the ruby package.
826
+ *
827
+ * @generated from protobuf field: optional string ruby_package = 45
828
+ */
804
829
  rubyPackage?: string;
805
830
  /**
806
- * Any features defined in the specific edition.
807
- *
808
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 50;
809
- */
831
+ * Any features defined in the specific edition.
832
+ * WARNING: This field should only be used by protobuf plugins or special
833
+ * cases like the proto compiler. Other uses are discouraged and
834
+ * developers should rely on the protoreflect APIs for their client language.
835
+ *
836
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 50
837
+ */
810
838
  features?: FeatureSet;
811
839
  /**
812
- * The parser stores options it doesn't recognize here.
813
- * See the documentation for the "Options" section above.
814
- *
815
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
816
- */
840
+ * The parser stores options it doesn't recognize here.
841
+ * See the documentation for the "Options" section above.
842
+ *
843
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
844
+ */
817
845
  uninterpretedOption: UninterpretedOption[];
818
846
  }
819
847
  /**
@@ -823,28 +851,28 @@ export interface FileOptions {
823
851
  */
824
852
  export declare enum FileOptions_OptimizeMode {
825
853
  /**
826
- * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
827
- */
854
+ * @generated synthetic value - protobuf-ts requires all enums to have a 0 value
855
+ */
828
856
  UNSPECIFIED$ = 0,
829
857
  /**
830
- * Generate complete code for parsing, serialization,
831
- *
832
- * @generated from protobuf enum value: SPEED = 1;
833
- */
858
+ * Generate complete code for parsing, serialization,
859
+ *
860
+ * @generated from protobuf enum value: SPEED = 1;
861
+ */
834
862
  SPEED = 1,
835
863
  /**
836
- * etc.
837
- *
838
- * Use ReflectionOps to implement these methods.
839
- *
840
- * @generated from protobuf enum value: CODE_SIZE = 2;
841
- */
864
+ * etc.
865
+ *
866
+ * Use ReflectionOps to implement these methods.
867
+ *
868
+ * @generated from protobuf enum value: CODE_SIZE = 2;
869
+ */
842
870
  CODE_SIZE = 2,
843
871
  /**
844
- * Generate code using MessageLite and the lite runtime.
845
- *
846
- * @generated from protobuf enum value: LITE_RUNTIME = 3;
847
- */
872
+ * Generate code using MessageLite and the lite runtime.
873
+ *
874
+ * @generated from protobuf enum value: LITE_RUNTIME = 3;
875
+ */
848
876
  LITE_RUNTIME = 3
849
877
  }
850
878
  /**
@@ -852,98 +880,101 @@ export declare enum FileOptions_OptimizeMode {
852
880
  */
853
881
  export interface MessageOptions {
854
882
  /**
855
- * Set true to use the old proto1 MessageSet wire format for extensions.
856
- * This is provided for backwards-compatibility with the MessageSet wire
857
- * format. You should not use this for any other reason: It's less
858
- * efficient, has fewer features, and is more complicated.
859
- *
860
- * The message must be defined exactly as follows:
861
- * message Foo {
862
- * option message_set_wire_format = true;
863
- * extensions 4 to max;
864
- * }
865
- * Note that the message cannot have any defined fields; MessageSets only
866
- * have extensions.
867
- *
868
- * All extensions of your type must be singular messages; e.g. they cannot
869
- * be int32s, enums, or repeated messages.
870
- *
871
- * Because this is an option, the above two restrictions are not enforced by
872
- * the protocol compiler.
873
- *
874
- * @generated from protobuf field: optional bool message_set_wire_format = 1;
875
- */
883
+ * Set true to use the old proto1 MessageSet wire format for extensions.
884
+ * This is provided for backwards-compatibility with the MessageSet wire
885
+ * format. You should not use this for any other reason: It's less
886
+ * efficient, has fewer features, and is more complicated.
887
+ *
888
+ * The message must be defined exactly as follows:
889
+ * message Foo {
890
+ * option message_set_wire_format = true;
891
+ * extensions 4 to max;
892
+ * }
893
+ * Note that the message cannot have any defined fields; MessageSets only
894
+ * have extensions.
895
+ *
896
+ * All extensions of your type must be singular messages; e.g. they cannot
897
+ * be int32s, enums, or repeated messages.
898
+ *
899
+ * Because this is an option, the above two restrictions are not enforced by
900
+ * the protocol compiler.
901
+ *
902
+ * @generated from protobuf field: optional bool message_set_wire_format = 1 [default = false]
903
+ */
876
904
  messageSetWireFormat?: boolean;
877
905
  /**
878
- * Disables the generation of the standard "descriptor()" accessor, which can
879
- * conflict with a field of the same name. This is meant to make migration
880
- * from proto1 easier; new code should avoid fields named "descriptor".
881
- *
882
- * @generated from protobuf field: optional bool no_standard_descriptor_accessor = 2;
883
- */
906
+ * Disables the generation of the standard "descriptor()" accessor, which can
907
+ * conflict with a field of the same name. This is meant to make migration
908
+ * from proto1 easier; new code should avoid fields named "descriptor".
909
+ *
910
+ * @generated from protobuf field: optional bool no_standard_descriptor_accessor = 2 [default = false]
911
+ */
884
912
  noStandardDescriptorAccessor?: boolean;
885
913
  /**
886
- * Is this message deprecated?
887
- * Depending on the target platform, this can emit Deprecated annotations
888
- * for the message, or it will be completely ignored; in the very least,
889
- * this is a formalization for deprecating messages.
890
- *
891
- * @generated from protobuf field: optional bool deprecated = 3;
892
- */
914
+ * Is this message deprecated?
915
+ * Depending on the target platform, this can emit Deprecated annotations
916
+ * for the message, or it will be completely ignored; in the very least,
917
+ * this is a formalization for deprecating messages.
918
+ *
919
+ * @generated from protobuf field: optional bool deprecated = 3 [default = false]
920
+ */
893
921
  deprecated?: boolean;
894
922
  /**
895
- * Whether the message is an automatically generated map entry type for the
896
- * maps field.
897
- *
898
- * For maps fields:
899
- * map<KeyType, ValueType> map_field = 1;
900
- * The parsed descriptor looks like:
901
- * message MapFieldEntry {
902
- * option map_entry = true;
903
- * optional KeyType key = 1;
904
- * optional ValueType value = 2;
905
- * }
906
- * repeated MapFieldEntry map_field = 1;
907
- *
908
- * Implementations may choose not to generate the map_entry=true message, but
909
- * use a native map in the target language to hold the keys and values.
910
- * The reflection APIs in such implementations still need to work as
911
- * if the field is a repeated message field.
912
- *
913
- * NOTE: Do not set the option in .proto files. Always use the maps syntax
914
- * instead. The option should only be implicitly set by the proto compiler
915
- * parser.
916
- *
917
- * @generated from protobuf field: optional bool map_entry = 7;
918
- */
923
+ * Whether the message is an automatically generated map entry type for the
924
+ * maps field.
925
+ *
926
+ * For maps fields:
927
+ * map<KeyType, ValueType> map_field = 1;
928
+ * The parsed descriptor looks like:
929
+ * message MapFieldEntry {
930
+ * option map_entry = true;
931
+ * optional KeyType key = 1;
932
+ * optional ValueType value = 2;
933
+ * }
934
+ * repeated MapFieldEntry map_field = 1;
935
+ *
936
+ * Implementations may choose not to generate the map_entry=true message, but
937
+ * use a native map in the target language to hold the keys and values.
938
+ * The reflection APIs in such implementations still need to work as
939
+ * if the field is a repeated message field.
940
+ *
941
+ * NOTE: Do not set the option in .proto files. Always use the maps syntax
942
+ * instead. The option should only be implicitly set by the proto compiler
943
+ * parser.
944
+ *
945
+ * @generated from protobuf field: optional bool map_entry = 7
946
+ */
919
947
  mapEntry?: boolean;
920
948
  /**
921
- * Enable the legacy handling of JSON field name conflicts. This lowercases
922
- * and strips underscored from the fields before comparison in proto3 only.
923
- * The new behavior takes `json_name` into account and applies to proto2 as
924
- * well.
925
- *
926
- * This should only be used as a temporary measure against broken builds due
927
- * to the change in behavior for JSON field name conflicts.
928
- *
929
- * TODO This is legacy behavior we plan to remove once downstream
930
- * teams have had time to migrate.
931
- *
932
- * @deprecated
933
- * @generated from protobuf field: optional bool deprecated_legacy_json_field_conflicts = 11 [deprecated = true];
934
- */
949
+ * Enable the legacy handling of JSON field name conflicts. This lowercases
950
+ * and strips underscored from the fields before comparison in proto3 only.
951
+ * The new behavior takes `json_name` into account and applies to proto2 as
952
+ * well.
953
+ *
954
+ * This should only be used as a temporary measure against broken builds due
955
+ * to the change in behavior for JSON field name conflicts.
956
+ *
957
+ * TODO This is legacy behavior we plan to remove once downstream
958
+ * teams have had time to migrate.
959
+ *
960
+ * @deprecated
961
+ * @generated from protobuf field: optional bool deprecated_legacy_json_field_conflicts = 11 [deprecated = true]
962
+ */
935
963
  deprecatedLegacyJsonFieldConflicts?: boolean;
936
964
  /**
937
- * Any features defined in the specific edition.
938
- *
939
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 12;
940
- */
965
+ * Any features defined in the specific edition.
966
+ * WARNING: This field should only be used by protobuf plugins or special
967
+ * cases like the proto compiler. Other uses are discouraged and
968
+ * developers should rely on the protoreflect APIs for their client language.
969
+ *
970
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 12
971
+ */
941
972
  features?: FeatureSet;
942
973
  /**
943
- * The parser stores options it doesn't recognize here. See above.
944
- *
945
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
946
- */
974
+ * The parser stores options it doesn't recognize here. See above.
975
+ *
976
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
977
+ */
947
978
  uninterpretedOption: UninterpretedOption[];
948
979
  }
949
980
  /**
@@ -951,129 +982,132 @@ export interface MessageOptions {
951
982
  */
952
983
  export interface FieldOptions {
953
984
  /**
954
- * NOTE: ctype is deprecated. Use `features.(pb.cpp).string_type` instead.
955
- * The ctype option instructs the C++ code generator to use a different
956
- * representation of the field than it normally would. See the specific
957
- * options below. This option is only implemented to support use of
958
- * [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of
959
- * type "bytes" in the open source release.
960
- * TODO: make ctype actually deprecated.
961
- *
962
- * @generated from protobuf field: optional google.protobuf.FieldOptions.CType ctype = 1;
963
- */
985
+ * NOTE: ctype is deprecated. Use `features.(pb.cpp).string_type` instead.
986
+ * The ctype option instructs the C++ code generator to use a different
987
+ * representation of the field than it normally would. See the specific
988
+ * options below. This option is only implemented to support use of
989
+ * [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of
990
+ * type "bytes" in the open source release.
991
+ * TODO: make ctype actually deprecated.
992
+ *
993
+ * @generated from protobuf field: optional google.protobuf.FieldOptions.CType ctype = 1 [default = STRING]
994
+ */
964
995
  ctype?: FieldOptions_CType;
965
996
  /**
966
- * The packed option can be enabled for repeated primitive fields to enable
967
- * a more efficient representation on the wire. Rather than repeatedly
968
- * writing the tag and type for each element, the entire array is encoded as
969
- * a single length-delimited blob. In proto3, only explicit setting it to
970
- * false will avoid using packed encoding. This option is prohibited in
971
- * Editions, but the `repeated_field_encoding` feature can be used to control
972
- * the behavior.
973
- *
974
- * @generated from protobuf field: optional bool packed = 2;
975
- */
997
+ * The packed option can be enabled for repeated primitive fields to enable
998
+ * a more efficient representation on the wire. Rather than repeatedly
999
+ * writing the tag and type for each element, the entire array is encoded as
1000
+ * a single length-delimited blob. In proto3, only explicit setting it to
1001
+ * false will avoid using packed encoding. This option is prohibited in
1002
+ * Editions, but the `repeated_field_encoding` feature can be used to control
1003
+ * the behavior.
1004
+ *
1005
+ * @generated from protobuf field: optional bool packed = 2
1006
+ */
976
1007
  packed?: boolean;
977
1008
  /**
978
- * The jstype option determines the JavaScript type used for values of the
979
- * field. The option is permitted only for 64 bit integral and fixed types
980
- * (int64, uint64, sint64, fixed64, sfixed64). A field with jstype JS_STRING
981
- * is represented as JavaScript string, which avoids loss of precision that
982
- * can happen when a large value is converted to a floating point JavaScript.
983
- * Specifying JS_NUMBER for the jstype causes the generated JavaScript code to
984
- * use the JavaScript "number" type. The behavior of the default option
985
- * JS_NORMAL is implementation dependent.
986
- *
987
- * This option is an enum to permit additional types to be added, e.g.
988
- * goog.math.Integer.
989
- *
990
- * @generated from protobuf field: optional google.protobuf.FieldOptions.JSType jstype = 6;
991
- */
1009
+ * The jstype option determines the JavaScript type used for values of the
1010
+ * field. The option is permitted only for 64 bit integral and fixed types
1011
+ * (int64, uint64, sint64, fixed64, sfixed64). A field with jstype JS_STRING
1012
+ * is represented as JavaScript string, which avoids loss of precision that
1013
+ * can happen when a large value is converted to a floating point JavaScript.
1014
+ * Specifying JS_NUMBER for the jstype causes the generated JavaScript code to
1015
+ * use the JavaScript "number" type. The behavior of the default option
1016
+ * JS_NORMAL is implementation dependent.
1017
+ *
1018
+ * This option is an enum to permit additional types to be added, e.g.
1019
+ * goog.math.Integer.
1020
+ *
1021
+ * @generated from protobuf field: optional google.protobuf.FieldOptions.JSType jstype = 6 [default = JS_NORMAL]
1022
+ */
992
1023
  jstype?: FieldOptions_JSType;
993
1024
  /**
994
- * Should this field be parsed lazily? Lazy applies only to message-type
995
- * fields. It means that when the outer message is initially parsed, the
996
- * inner message's contents will not be parsed but instead stored in encoded
997
- * form. The inner message will actually be parsed when it is first accessed.
998
- *
999
- * This is only a hint. Implementations are free to choose whether to use
1000
- * eager or lazy parsing regardless of the value of this option. However,
1001
- * setting this option true suggests that the protocol author believes that
1002
- * using lazy parsing on this field is worth the additional bookkeeping
1003
- * overhead typically needed to implement it.
1004
- *
1005
- * This option does not affect the public interface of any generated code;
1006
- * all method signatures remain the same. Furthermore, thread-safety of the
1007
- * interface is not affected by this option; const methods remain safe to
1008
- * call from multiple threads concurrently, while non-const methods continue
1009
- * to require exclusive access.
1010
- *
1011
- * Note that lazy message fields are still eagerly verified to check
1012
- * ill-formed wireformat or missing required fields. Calling IsInitialized()
1013
- * on the outer message would fail if the inner message has missing required
1014
- * fields. Failed verification would result in parsing failure (except when
1015
- * uninitialized messages are acceptable).
1016
- *
1017
- * @generated from protobuf field: optional bool lazy = 5;
1018
- */
1025
+ * Should this field be parsed lazily? Lazy applies only to message-type
1026
+ * fields. It means that when the outer message is initially parsed, the
1027
+ * inner message's contents will not be parsed but instead stored in encoded
1028
+ * form. The inner message will actually be parsed when it is first accessed.
1029
+ *
1030
+ * This is only a hint. Implementations are free to choose whether to use
1031
+ * eager or lazy parsing regardless of the value of this option. However,
1032
+ * setting this option true suggests that the protocol author believes that
1033
+ * using lazy parsing on this field is worth the additional bookkeeping
1034
+ * overhead typically needed to implement it.
1035
+ *
1036
+ * This option does not affect the public interface of any generated code;
1037
+ * all method signatures remain the same. Furthermore, thread-safety of the
1038
+ * interface is not affected by this option; const methods remain safe to
1039
+ * call from multiple threads concurrently, while non-const methods continue
1040
+ * to require exclusive access.
1041
+ *
1042
+ * Note that lazy message fields are still eagerly verified to check
1043
+ * ill-formed wireformat or missing required fields. Calling IsInitialized()
1044
+ * on the outer message would fail if the inner message has missing required
1045
+ * fields. Failed verification would result in parsing failure (except when
1046
+ * uninitialized messages are acceptable).
1047
+ *
1048
+ * @generated from protobuf field: optional bool lazy = 5 [default = false]
1049
+ */
1019
1050
  lazy?: boolean;
1020
1051
  /**
1021
- * unverified_lazy does no correctness checks on the byte stream. This should
1022
- * only be used where lazy with verification is prohibitive for performance
1023
- * reasons.
1024
- *
1025
- * @generated from protobuf field: optional bool unverified_lazy = 15;
1026
- */
1052
+ * unverified_lazy does no correctness checks on the byte stream. This should
1053
+ * only be used where lazy with verification is prohibitive for performance
1054
+ * reasons.
1055
+ *
1056
+ * @generated from protobuf field: optional bool unverified_lazy = 15 [default = false]
1057
+ */
1027
1058
  unverifiedLazy?: boolean;
1028
1059
  /**
1029
- * Is this field deprecated?
1030
- * Depending on the target platform, this can emit Deprecated annotations
1031
- * for accessors, or it will be completely ignored; in the very least, this
1032
- * is a formalization for deprecating fields.
1033
- *
1034
- * @generated from protobuf field: optional bool deprecated = 3;
1035
- */
1060
+ * Is this field deprecated?
1061
+ * Depending on the target platform, this can emit Deprecated annotations
1062
+ * for accessors, or it will be completely ignored; in the very least, this
1063
+ * is a formalization for deprecating fields.
1064
+ *
1065
+ * @generated from protobuf field: optional bool deprecated = 3 [default = false]
1066
+ */
1036
1067
  deprecated?: boolean;
1037
1068
  /**
1038
- * For Google-internal migration only. Do not use.
1039
- *
1040
- * @generated from protobuf field: optional bool weak = 10;
1041
- */
1069
+ * For Google-internal migration only. Do not use.
1070
+ *
1071
+ * @generated from protobuf field: optional bool weak = 10 [default = false]
1072
+ */
1042
1073
  weak?: boolean;
1043
1074
  /**
1044
- * Indicate that the field value should not be printed out when using debug
1045
- * formats, e.g. when the field contains sensitive credentials.
1046
- *
1047
- * @generated from protobuf field: optional bool debug_redact = 16;
1048
- */
1075
+ * Indicate that the field value should not be printed out when using debug
1076
+ * formats, e.g. when the field contains sensitive credentials.
1077
+ *
1078
+ * @generated from protobuf field: optional bool debug_redact = 16 [default = false]
1079
+ */
1049
1080
  debugRedact?: boolean;
1050
1081
  /**
1051
- * @generated from protobuf field: optional google.protobuf.FieldOptions.OptionRetention retention = 17;
1052
- */
1082
+ * @generated from protobuf field: optional google.protobuf.FieldOptions.OptionRetention retention = 17
1083
+ */
1053
1084
  retention?: FieldOptions_OptionRetention;
1054
1085
  /**
1055
- * @generated from protobuf field: repeated google.protobuf.FieldOptions.OptionTargetType targets = 19;
1056
- */
1086
+ * @generated from protobuf field: repeated google.protobuf.FieldOptions.OptionTargetType targets = 19
1087
+ */
1057
1088
  targets: FieldOptions_OptionTargetType[];
1058
1089
  /**
1059
- * @generated from protobuf field: repeated google.protobuf.FieldOptions.EditionDefault edition_defaults = 20;
1060
- */
1090
+ * @generated from protobuf field: repeated google.protobuf.FieldOptions.EditionDefault edition_defaults = 20
1091
+ */
1061
1092
  editionDefaults: FieldOptions_EditionDefault[];
1062
1093
  /**
1063
- * Any features defined in the specific edition.
1064
- *
1065
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 21;
1066
- */
1094
+ * Any features defined in the specific edition.
1095
+ * WARNING: This field should only be used by protobuf plugins or special
1096
+ * cases like the proto compiler. Other uses are discouraged and
1097
+ * developers should rely on the protoreflect APIs for their client language.
1098
+ *
1099
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 21
1100
+ */
1067
1101
  features?: FeatureSet;
1068
1102
  /**
1069
- * @generated from protobuf field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 22;
1070
- */
1103
+ * @generated from protobuf field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 22
1104
+ */
1071
1105
  featureSupport?: FieldOptions_FeatureSupport;
1072
1106
  /**
1073
- * The parser stores options it doesn't recognize here. See above.
1074
- *
1075
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1076
- */
1107
+ * The parser stores options it doesn't recognize here. See above.
1108
+ *
1109
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1110
+ */
1077
1111
  uninterpretedOption: UninterpretedOption[];
1078
1112
  }
1079
1113
  /**
@@ -1081,12 +1115,12 @@ export interface FieldOptions {
1081
1115
  */
1082
1116
  export interface FieldOptions_EditionDefault {
1083
1117
  /**
1084
- * @generated from protobuf field: optional google.protobuf.Edition edition = 3;
1085
- */
1118
+ * @generated from protobuf field: optional google.protobuf.Edition edition = 3
1119
+ */
1086
1120
  edition?: Edition;
1087
1121
  /**
1088
- * @generated from protobuf field: optional string value = 2;
1089
- */
1122
+ * @generated from protobuf field: optional string value = 2
1123
+ */
1090
1124
  value?: string;
1091
1125
  }
1092
1126
  /**
@@ -1096,34 +1130,34 @@ export interface FieldOptions_EditionDefault {
1096
1130
  */
1097
1131
  export interface FieldOptions_FeatureSupport {
1098
1132
  /**
1099
- * The edition that this feature was first available in. In editions
1100
- * earlier than this one, the default assigned to EDITION_LEGACY will be
1101
- * used, and proto files will not be able to override it.
1102
- *
1103
- * @generated from protobuf field: optional google.protobuf.Edition edition_introduced = 1;
1104
- */
1133
+ * The edition that this feature was first available in. In editions
1134
+ * earlier than this one, the default assigned to EDITION_LEGACY will be
1135
+ * used, and proto files will not be able to override it.
1136
+ *
1137
+ * @generated from protobuf field: optional google.protobuf.Edition edition_introduced = 1
1138
+ */
1105
1139
  editionIntroduced?: Edition;
1106
1140
  /**
1107
- * The edition this feature becomes deprecated in. Using this after this
1108
- * edition may trigger warnings.
1109
- *
1110
- * @generated from protobuf field: optional google.protobuf.Edition edition_deprecated = 2;
1111
- */
1141
+ * The edition this feature becomes deprecated in. Using this after this
1142
+ * edition may trigger warnings.
1143
+ *
1144
+ * @generated from protobuf field: optional google.protobuf.Edition edition_deprecated = 2
1145
+ */
1112
1146
  editionDeprecated?: Edition;
1113
1147
  /**
1114
- * The deprecation warning text if this feature is used after the edition it
1115
- * was marked deprecated in.
1116
- *
1117
- * @generated from protobuf field: optional string deprecation_warning = 3;
1118
- */
1148
+ * The deprecation warning text if this feature is used after the edition it
1149
+ * was marked deprecated in.
1150
+ *
1151
+ * @generated from protobuf field: optional string deprecation_warning = 3
1152
+ */
1119
1153
  deprecationWarning?: string;
1120
1154
  /**
1121
- * The edition this feature is no longer available in. In editions after
1122
- * this one, the last default assigned will be used, and proto files will
1123
- * not be able to override it.
1124
- *
1125
- * @generated from protobuf field: optional google.protobuf.Edition edition_removed = 4;
1126
- */
1155
+ * The edition this feature is no longer available in. In editions after
1156
+ * this one, the last default assigned will be used, and proto files will
1157
+ * not be able to override it.
1158
+ *
1159
+ * @generated from protobuf field: optional google.protobuf.Edition edition_removed = 4
1160
+ */
1127
1161
  editionRemoved?: Edition;
1128
1162
  }
1129
1163
  /**
@@ -1131,25 +1165,25 @@ export interface FieldOptions_FeatureSupport {
1131
1165
  */
1132
1166
  export declare enum FieldOptions_CType {
1133
1167
  /**
1134
- * Default mode.
1135
- *
1136
- * @generated from protobuf enum value: STRING = 0;
1137
- */
1168
+ * Default mode.
1169
+ *
1170
+ * @generated from protobuf enum value: STRING = 0;
1171
+ */
1138
1172
  STRING = 0,
1139
1173
  /**
1140
- * The option [ctype=CORD] may be applied to a non-repeated field of type
1141
- * "bytes". It indicates that in C++, the data should be stored in a Cord
1142
- * instead of a string. For very large strings, this may reduce memory
1143
- * fragmentation. It may also allow better performance when parsing from a
1144
- * Cord, or when parsing with aliasing enabled, as the parsed Cord may then
1145
- * alias the original buffer.
1146
- *
1147
- * @generated from protobuf enum value: CORD = 1;
1148
- */
1174
+ * The option [ctype=CORD] may be applied to a non-repeated field of type
1175
+ * "bytes". It indicates that in C++, the data should be stored in a Cord
1176
+ * instead of a string. For very large strings, this may reduce memory
1177
+ * fragmentation. It may also allow better performance when parsing from a
1178
+ * Cord, or when parsing with aliasing enabled, as the parsed Cord may then
1179
+ * alias the original buffer.
1180
+ *
1181
+ * @generated from protobuf enum value: CORD = 1;
1182
+ */
1149
1183
  CORD = 1,
1150
1184
  /**
1151
- * @generated from protobuf enum value: STRING_PIECE = 2;
1152
- */
1185
+ * @generated from protobuf enum value: STRING_PIECE = 2;
1186
+ */
1153
1187
  STRING_PIECE = 2
1154
1188
  }
1155
1189
  /**
@@ -1157,22 +1191,22 @@ export declare enum FieldOptions_CType {
1157
1191
  */
1158
1192
  export declare enum FieldOptions_JSType {
1159
1193
  /**
1160
- * Use the default type.
1161
- *
1162
- * @generated from protobuf enum value: JS_NORMAL = 0;
1163
- */
1194
+ * Use the default type.
1195
+ *
1196
+ * @generated from protobuf enum value: JS_NORMAL = 0;
1197
+ */
1164
1198
  JS_NORMAL = 0,
1165
1199
  /**
1166
- * Use JavaScript strings.
1167
- *
1168
- * @generated from protobuf enum value: JS_STRING = 1;
1169
- */
1200
+ * Use JavaScript strings.
1201
+ *
1202
+ * @generated from protobuf enum value: JS_STRING = 1;
1203
+ */
1170
1204
  JS_STRING = 1,
1171
1205
  /**
1172
- * Use JavaScript numbers.
1173
- *
1174
- * @generated from protobuf enum value: JS_NUMBER = 2;
1175
- */
1206
+ * Use JavaScript numbers.
1207
+ *
1208
+ * @generated from protobuf enum value: JS_NUMBER = 2;
1209
+ */
1176
1210
  JS_NUMBER = 2
1177
1211
  }
1178
1212
  /**
@@ -1182,16 +1216,16 @@ export declare enum FieldOptions_JSType {
1182
1216
  */
1183
1217
  export declare enum FieldOptions_OptionRetention {
1184
1218
  /**
1185
- * @generated from protobuf enum value: RETENTION_UNKNOWN = 0;
1186
- */
1219
+ * @generated from protobuf enum value: RETENTION_UNKNOWN = 0;
1220
+ */
1187
1221
  RETENTION_UNKNOWN = 0,
1188
1222
  /**
1189
- * @generated from protobuf enum value: RETENTION_RUNTIME = 1;
1190
- */
1223
+ * @generated from protobuf enum value: RETENTION_RUNTIME = 1;
1224
+ */
1191
1225
  RETENTION_RUNTIME = 1,
1192
1226
  /**
1193
- * @generated from protobuf enum value: RETENTION_SOURCE = 2;
1194
- */
1227
+ * @generated from protobuf enum value: RETENTION_SOURCE = 2;
1228
+ */
1195
1229
  RETENTION_SOURCE = 2
1196
1230
  }
1197
1231
  /**
@@ -1203,44 +1237,44 @@ export declare enum FieldOptions_OptionRetention {
1203
1237
  */
1204
1238
  export declare enum FieldOptions_OptionTargetType {
1205
1239
  /**
1206
- * @generated from protobuf enum value: TARGET_TYPE_UNKNOWN = 0;
1207
- */
1240
+ * @generated from protobuf enum value: TARGET_TYPE_UNKNOWN = 0;
1241
+ */
1208
1242
  TARGET_TYPE_UNKNOWN = 0,
1209
1243
  /**
1210
- * @generated from protobuf enum value: TARGET_TYPE_FILE = 1;
1211
- */
1244
+ * @generated from protobuf enum value: TARGET_TYPE_FILE = 1;
1245
+ */
1212
1246
  TARGET_TYPE_FILE = 1,
1213
1247
  /**
1214
- * @generated from protobuf enum value: TARGET_TYPE_EXTENSION_RANGE = 2;
1215
- */
1248
+ * @generated from protobuf enum value: TARGET_TYPE_EXTENSION_RANGE = 2;
1249
+ */
1216
1250
  TARGET_TYPE_EXTENSION_RANGE = 2,
1217
1251
  /**
1218
- * @generated from protobuf enum value: TARGET_TYPE_MESSAGE = 3;
1219
- */
1252
+ * @generated from protobuf enum value: TARGET_TYPE_MESSAGE = 3;
1253
+ */
1220
1254
  TARGET_TYPE_MESSAGE = 3,
1221
1255
  /**
1222
- * @generated from protobuf enum value: TARGET_TYPE_FIELD = 4;
1223
- */
1256
+ * @generated from protobuf enum value: TARGET_TYPE_FIELD = 4;
1257
+ */
1224
1258
  TARGET_TYPE_FIELD = 4,
1225
1259
  /**
1226
- * @generated from protobuf enum value: TARGET_TYPE_ONEOF = 5;
1227
- */
1260
+ * @generated from protobuf enum value: TARGET_TYPE_ONEOF = 5;
1261
+ */
1228
1262
  TARGET_TYPE_ONEOF = 5,
1229
1263
  /**
1230
- * @generated from protobuf enum value: TARGET_TYPE_ENUM = 6;
1231
- */
1264
+ * @generated from protobuf enum value: TARGET_TYPE_ENUM = 6;
1265
+ */
1232
1266
  TARGET_TYPE_ENUM = 6,
1233
1267
  /**
1234
- * @generated from protobuf enum value: TARGET_TYPE_ENUM_ENTRY = 7;
1235
- */
1268
+ * @generated from protobuf enum value: TARGET_TYPE_ENUM_ENTRY = 7;
1269
+ */
1236
1270
  TARGET_TYPE_ENUM_ENTRY = 7,
1237
1271
  /**
1238
- * @generated from protobuf enum value: TARGET_TYPE_SERVICE = 8;
1239
- */
1272
+ * @generated from protobuf enum value: TARGET_TYPE_SERVICE = 8;
1273
+ */
1240
1274
  TARGET_TYPE_SERVICE = 8,
1241
1275
  /**
1242
- * @generated from protobuf enum value: TARGET_TYPE_METHOD = 9;
1243
- */
1276
+ * @generated from protobuf enum value: TARGET_TYPE_METHOD = 9;
1277
+ */
1244
1278
  TARGET_TYPE_METHOD = 9
1245
1279
  }
1246
1280
  /**
@@ -1248,16 +1282,19 @@ export declare enum FieldOptions_OptionTargetType {
1248
1282
  */
1249
1283
  export interface OneofOptions {
1250
1284
  /**
1251
- * Any features defined in the specific edition.
1252
- *
1253
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 1;
1254
- */
1285
+ * Any features defined in the specific edition.
1286
+ * WARNING: This field should only be used by protobuf plugins or special
1287
+ * cases like the proto compiler. Other uses are discouraged and
1288
+ * developers should rely on the protoreflect APIs for their client language.
1289
+ *
1290
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 1
1291
+ */
1255
1292
  features?: FeatureSet;
1256
1293
  /**
1257
- * The parser stores options it doesn't recognize here. See above.
1258
- *
1259
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1260
- */
1294
+ * The parser stores options it doesn't recognize here. See above.
1295
+ *
1296
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1297
+ */
1261
1298
  uninterpretedOption: UninterpretedOption[];
1262
1299
  }
1263
1300
  /**
@@ -1265,44 +1302,47 @@ export interface OneofOptions {
1265
1302
  */
1266
1303
  export interface EnumOptions {
1267
1304
  /**
1268
- * Set this option to true to allow mapping different tag names to the same
1269
- * value.
1270
- *
1271
- * @generated from protobuf field: optional bool allow_alias = 2;
1272
- */
1305
+ * Set this option to true to allow mapping different tag names to the same
1306
+ * value.
1307
+ *
1308
+ * @generated from protobuf field: optional bool allow_alias = 2
1309
+ */
1273
1310
  allowAlias?: boolean;
1274
1311
  /**
1275
- * Is this enum deprecated?
1276
- * Depending on the target platform, this can emit Deprecated annotations
1277
- * for the enum, or it will be completely ignored; in the very least, this
1278
- * is a formalization for deprecating enums.
1279
- *
1280
- * @generated from protobuf field: optional bool deprecated = 3;
1281
- */
1312
+ * Is this enum deprecated?
1313
+ * Depending on the target platform, this can emit Deprecated annotations
1314
+ * for the enum, or it will be completely ignored; in the very least, this
1315
+ * is a formalization for deprecating enums.
1316
+ *
1317
+ * @generated from protobuf field: optional bool deprecated = 3 [default = false]
1318
+ */
1282
1319
  deprecated?: boolean;
1283
1320
  /**
1284
- * Enable the legacy handling of JSON field name conflicts. This lowercases
1285
- * and strips underscored from the fields before comparison in proto3 only.
1286
- * The new behavior takes `json_name` into account and applies to proto2 as
1287
- * well.
1288
- * TODO Remove this legacy behavior once downstream teams have
1289
- * had time to migrate.
1290
- *
1291
- * @deprecated
1292
- * @generated from protobuf field: optional bool deprecated_legacy_json_field_conflicts = 6 [deprecated = true];
1293
- */
1321
+ * Enable the legacy handling of JSON field name conflicts. This lowercases
1322
+ * and strips underscored from the fields before comparison in proto3 only.
1323
+ * The new behavior takes `json_name` into account and applies to proto2 as
1324
+ * well.
1325
+ * TODO Remove this legacy behavior once downstream teams have
1326
+ * had time to migrate.
1327
+ *
1328
+ * @deprecated
1329
+ * @generated from protobuf field: optional bool deprecated_legacy_json_field_conflicts = 6 [deprecated = true]
1330
+ */
1294
1331
  deprecatedLegacyJsonFieldConflicts?: boolean;
1295
1332
  /**
1296
- * Any features defined in the specific edition.
1297
- *
1298
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 7;
1299
- */
1333
+ * Any features defined in the specific edition.
1334
+ * WARNING: This field should only be used by protobuf plugins or special
1335
+ * cases like the proto compiler. Other uses are discouraged and
1336
+ * developers should rely on the protoreflect APIs for their client language.
1337
+ *
1338
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 7
1339
+ */
1300
1340
  features?: FeatureSet;
1301
1341
  /**
1302
- * The parser stores options it doesn't recognize here. See above.
1303
- *
1304
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1305
- */
1342
+ * The parser stores options it doesn't recognize here. See above.
1343
+ *
1344
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1345
+ */
1306
1346
  uninterpretedOption: UninterpretedOption[];
1307
1347
  }
1308
1348
  /**
@@ -1310,39 +1350,42 @@ export interface EnumOptions {
1310
1350
  */
1311
1351
  export interface EnumValueOptions {
1312
1352
  /**
1313
- * Is this enum value deprecated?
1314
- * Depending on the target platform, this can emit Deprecated annotations
1315
- * for the enum value, or it will be completely ignored; in the very least,
1316
- * this is a formalization for deprecating enum values.
1317
- *
1318
- * @generated from protobuf field: optional bool deprecated = 1;
1319
- */
1353
+ * Is this enum value deprecated?
1354
+ * Depending on the target platform, this can emit Deprecated annotations
1355
+ * for the enum value, or it will be completely ignored; in the very least,
1356
+ * this is a formalization for deprecating enum values.
1357
+ *
1358
+ * @generated from protobuf field: optional bool deprecated = 1 [default = false]
1359
+ */
1320
1360
  deprecated?: boolean;
1321
1361
  /**
1322
- * Any features defined in the specific edition.
1323
- *
1324
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 2;
1325
- */
1362
+ * Any features defined in the specific edition.
1363
+ * WARNING: This field should only be used by protobuf plugins or special
1364
+ * cases like the proto compiler. Other uses are discouraged and
1365
+ * developers should rely on the protoreflect APIs for their client language.
1366
+ *
1367
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 2
1368
+ */
1326
1369
  features?: FeatureSet;
1327
1370
  /**
1328
- * Indicate that fields annotated with this enum value should not be printed
1329
- * out when using debug formats, e.g. when the field contains sensitive
1330
- * credentials.
1331
- *
1332
- * @generated from protobuf field: optional bool debug_redact = 3;
1333
- */
1371
+ * Indicate that fields annotated with this enum value should not be printed
1372
+ * out when using debug formats, e.g. when the field contains sensitive
1373
+ * credentials.
1374
+ *
1375
+ * @generated from protobuf field: optional bool debug_redact = 3 [default = false]
1376
+ */
1334
1377
  debugRedact?: boolean;
1335
1378
  /**
1336
- * Information about the support window of a feature value.
1337
- *
1338
- * @generated from protobuf field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 4;
1339
- */
1379
+ * Information about the support window of a feature value.
1380
+ *
1381
+ * @generated from protobuf field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 4
1382
+ */
1340
1383
  featureSupport?: FieldOptions_FeatureSupport;
1341
1384
  /**
1342
- * The parser stores options it doesn't recognize here. See above.
1343
- *
1344
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1345
- */
1385
+ * The parser stores options it doesn't recognize here. See above.
1386
+ *
1387
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1388
+ */
1346
1389
  uninterpretedOption: UninterpretedOption[];
1347
1390
  }
1348
1391
  /**
@@ -1350,25 +1393,28 @@ export interface EnumValueOptions {
1350
1393
  */
1351
1394
  export interface ServiceOptions {
1352
1395
  /**
1353
- * Any features defined in the specific edition.
1354
- *
1355
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 34;
1356
- */
1396
+ * Any features defined in the specific edition.
1397
+ * WARNING: This field should only be used by protobuf plugins or special
1398
+ * cases like the proto compiler. Other uses are discouraged and
1399
+ * developers should rely on the protoreflect APIs for their client language.
1400
+ *
1401
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 34
1402
+ */
1357
1403
  features?: FeatureSet;
1358
1404
  /**
1359
- * Is this service deprecated?
1360
- * Depending on the target platform, this can emit Deprecated annotations
1361
- * for the service, or it will be completely ignored; in the very least,
1362
- * this is a formalization for deprecating services.
1363
- *
1364
- * @generated from protobuf field: optional bool deprecated = 33;
1365
- */
1405
+ * Is this service deprecated?
1406
+ * Depending on the target platform, this can emit Deprecated annotations
1407
+ * for the service, or it will be completely ignored; in the very least,
1408
+ * this is a formalization for deprecating services.
1409
+ *
1410
+ * @generated from protobuf field: optional bool deprecated = 33 [default = false]
1411
+ */
1366
1412
  deprecated?: boolean;
1367
1413
  /**
1368
- * The parser stores options it doesn't recognize here. See above.
1369
- *
1370
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1371
- */
1414
+ * The parser stores options it doesn't recognize here. See above.
1415
+ *
1416
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1417
+ */
1372
1418
  uninterpretedOption: UninterpretedOption[];
1373
1419
  }
1374
1420
  /**
@@ -1376,29 +1422,32 @@ export interface ServiceOptions {
1376
1422
  */
1377
1423
  export interface MethodOptions {
1378
1424
  /**
1379
- * Is this method deprecated?
1380
- * Depending on the target platform, this can emit Deprecated annotations
1381
- * for the method, or it will be completely ignored; in the very least,
1382
- * this is a formalization for deprecating methods.
1383
- *
1384
- * @generated from protobuf field: optional bool deprecated = 33;
1385
- */
1425
+ * Is this method deprecated?
1426
+ * Depending on the target platform, this can emit Deprecated annotations
1427
+ * for the method, or it will be completely ignored; in the very least,
1428
+ * this is a formalization for deprecating methods.
1429
+ *
1430
+ * @generated from protobuf field: optional bool deprecated = 33 [default = false]
1431
+ */
1386
1432
  deprecated?: boolean;
1387
1433
  /**
1388
- * @generated from protobuf field: optional google.protobuf.MethodOptions.IdempotencyLevel idempotency_level = 34;
1389
- */
1434
+ * @generated from protobuf field: optional google.protobuf.MethodOptions.IdempotencyLevel idempotency_level = 34 [default = IDEMPOTENCY_UNKNOWN]
1435
+ */
1390
1436
  idempotencyLevel?: MethodOptions_IdempotencyLevel;
1391
1437
  /**
1392
- * Any features defined in the specific edition.
1393
- *
1394
- * @generated from protobuf field: optional google.protobuf.FeatureSet features = 35;
1395
- */
1438
+ * Any features defined in the specific edition.
1439
+ * WARNING: This field should only be used by protobuf plugins or special
1440
+ * cases like the proto compiler. Other uses are discouraged and
1441
+ * developers should rely on the protoreflect APIs for their client language.
1442
+ *
1443
+ * @generated from protobuf field: optional google.protobuf.FeatureSet features = 35
1444
+ */
1396
1445
  features?: FeatureSet;
1397
1446
  /**
1398
- * The parser stores options it doesn't recognize here. See above.
1399
- *
1400
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
1401
- */
1447
+ * The parser stores options it doesn't recognize here. See above.
1448
+ *
1449
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999
1450
+ */
1402
1451
  uninterpretedOption: UninterpretedOption[];
1403
1452
  }
1404
1453
  /**
@@ -1410,20 +1459,20 @@ export interface MethodOptions {
1410
1459
  */
1411
1460
  export declare enum MethodOptions_IdempotencyLevel {
1412
1461
  /**
1413
- * @generated from protobuf enum value: IDEMPOTENCY_UNKNOWN = 0;
1414
- */
1462
+ * @generated from protobuf enum value: IDEMPOTENCY_UNKNOWN = 0;
1463
+ */
1415
1464
  IDEMPOTENCY_UNKNOWN = 0,
1416
1465
  /**
1417
- * implies idempotent
1418
- *
1419
- * @generated from protobuf enum value: NO_SIDE_EFFECTS = 1;
1420
- */
1466
+ * implies idempotent
1467
+ *
1468
+ * @generated from protobuf enum value: NO_SIDE_EFFECTS = 1;
1469
+ */
1421
1470
  NO_SIDE_EFFECTS = 1,
1422
1471
  /**
1423
- * idempotent, but may have side effects
1424
- *
1425
- * @generated from protobuf enum value: IDEMPOTENT = 2;
1426
- */
1472
+ * idempotent, but may have side effects
1473
+ *
1474
+ * @generated from protobuf enum value: IDEMPOTENT = 2;
1475
+ */
1427
1476
  IDEMPOTENT = 2
1428
1477
  }
1429
1478
  /**
@@ -1438,35 +1487,35 @@ export declare enum MethodOptions_IdempotencyLevel {
1438
1487
  */
1439
1488
  export interface UninterpretedOption {
1440
1489
  /**
1441
- * @generated from protobuf field: repeated google.protobuf.UninterpretedOption.NamePart name = 2;
1442
- */
1490
+ * @generated from protobuf field: repeated google.protobuf.UninterpretedOption.NamePart name = 2
1491
+ */
1443
1492
  name: UninterpretedOption_NamePart[];
1444
1493
  /**
1445
- * The value of the uninterpreted option, in whatever type the tokenizer
1446
- * identified it as during parsing. Exactly one of these should be set.
1447
- *
1448
- * @generated from protobuf field: optional string identifier_value = 3;
1449
- */
1494
+ * The value of the uninterpreted option, in whatever type the tokenizer
1495
+ * identified it as during parsing. Exactly one of these should be set.
1496
+ *
1497
+ * @generated from protobuf field: optional string identifier_value = 3
1498
+ */
1450
1499
  identifierValue?: string;
1451
1500
  /**
1452
- * @generated from protobuf field: optional uint64 positive_int_value = 4;
1453
- */
1501
+ * @generated from protobuf field: optional uint64 positive_int_value = 4
1502
+ */
1454
1503
  positiveIntValue?: bigint;
1455
1504
  /**
1456
- * @generated from protobuf field: optional int64 negative_int_value = 5;
1457
- */
1505
+ * @generated from protobuf field: optional int64 negative_int_value = 5
1506
+ */
1458
1507
  negativeIntValue?: bigint;
1459
1508
  /**
1460
- * @generated from protobuf field: optional double double_value = 6;
1461
- */
1509
+ * @generated from protobuf field: optional double double_value = 6
1510
+ */
1462
1511
  doubleValue?: number;
1463
1512
  /**
1464
- * @generated from protobuf field: optional bytes string_value = 7;
1465
- */
1513
+ * @generated from protobuf field: optional bytes string_value = 7
1514
+ */
1466
1515
  stringValue?: Uint8Array;
1467
1516
  /**
1468
- * @generated from protobuf field: optional string aggregate_value = 8;
1469
- */
1517
+ * @generated from protobuf field: optional string aggregate_value = 8
1518
+ */
1470
1519
  aggregateValue?: string;
1471
1520
  }
1472
1521
  /**
@@ -1480,12 +1529,12 @@ export interface UninterpretedOption {
1480
1529
  */
1481
1530
  export interface UninterpretedOption_NamePart {
1482
1531
  /**
1483
- * @generated from protobuf field: string name_part = 1;
1484
- */
1532
+ * @generated from protobuf field: required string name_part = 1
1533
+ */
1485
1534
  namePart: string;
1486
1535
  /**
1487
- * @generated from protobuf field: bool is_extension = 2;
1488
- */
1536
+ * @generated from protobuf field: required bool is_extension = 2
1537
+ */
1489
1538
  isExtension: boolean;
1490
1539
  }
1491
1540
  /**
@@ -1500,49 +1549,97 @@ export interface UninterpretedOption_NamePart {
1500
1549
  */
1501
1550
  export interface FeatureSet {
1502
1551
  /**
1503
- * @generated from protobuf field: optional google.protobuf.FeatureSet.FieldPresence field_presence = 1;
1504
- */
1552
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.FieldPresence field_presence = 1
1553
+ */
1505
1554
  fieldPresence?: FeatureSet_FieldPresence;
1506
1555
  /**
1507
- * @generated from protobuf field: optional google.protobuf.FeatureSet.EnumType enum_type = 2;
1508
- */
1556
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.EnumType enum_type = 2
1557
+ */
1509
1558
  enumType?: FeatureSet_EnumType;
1510
1559
  /**
1511
- * @generated from protobuf field: optional google.protobuf.FeatureSet.RepeatedFieldEncoding repeated_field_encoding = 3;
1512
- */
1560
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.RepeatedFieldEncoding repeated_field_encoding = 3
1561
+ */
1513
1562
  repeatedFieldEncoding?: FeatureSet_RepeatedFieldEncoding;
1514
1563
  /**
1515
- * @generated from protobuf field: optional google.protobuf.FeatureSet.Utf8Validation utf8_validation = 4;
1516
- */
1564
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.Utf8Validation utf8_validation = 4
1565
+ */
1517
1566
  utf8Validation?: FeatureSet_Utf8Validation;
1518
1567
  /**
1519
- * @generated from protobuf field: optional google.protobuf.FeatureSet.MessageEncoding message_encoding = 5;
1520
- */
1568
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.MessageEncoding message_encoding = 5
1569
+ */
1521
1570
  messageEncoding?: FeatureSet_MessageEncoding;
1522
1571
  /**
1523
- * @generated from protobuf field: optional google.protobuf.FeatureSet.JsonFormat json_format = 6;
1524
- */
1572
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.JsonFormat json_format = 6
1573
+ */
1525
1574
  jsonFormat?: FeatureSet_JsonFormat;
1575
+ /**
1576
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.EnforceNamingStyle enforce_naming_style = 7
1577
+ */
1578
+ enforceNamingStyle?: FeatureSet_EnforceNamingStyle;
1579
+ /**
1580
+ * @generated from protobuf field: optional google.protobuf.FeatureSet.VisibilityFeature.DefaultSymbolVisibility default_symbol_visibility = 8
1581
+ */
1582
+ defaultSymbolVisibility?: FeatureSet_VisibilityFeature_DefaultSymbolVisibility;
1583
+ }
1584
+ /**
1585
+ * @generated from protobuf message google.protobuf.FeatureSet.VisibilityFeature
1586
+ */
1587
+ export interface FeatureSet_VisibilityFeature {
1588
+ }
1589
+ /**
1590
+ * @generated from protobuf enum google.protobuf.FeatureSet.VisibilityFeature.DefaultSymbolVisibility
1591
+ */
1592
+ export declare enum FeatureSet_VisibilityFeature_DefaultSymbolVisibility {
1593
+ /**
1594
+ * @generated from protobuf enum value: DEFAULT_SYMBOL_VISIBILITY_UNKNOWN = 0;
1595
+ */
1596
+ DEFAULT_SYMBOL_VISIBILITY_UNKNOWN = 0,
1597
+ /**
1598
+ * Default pre-EDITION_2024, all UNSET visibility are export.
1599
+ *
1600
+ * @generated from protobuf enum value: EXPORT_ALL = 1;
1601
+ */
1602
+ EXPORT_ALL = 1,
1603
+ /**
1604
+ * All top-level symbols default to export, nested default to local.
1605
+ *
1606
+ * @generated from protobuf enum value: EXPORT_TOP_LEVEL = 2;
1607
+ */
1608
+ EXPORT_TOP_LEVEL = 2,
1609
+ /**
1610
+ * All symbols default to local.
1611
+ *
1612
+ * @generated from protobuf enum value: LOCAL_ALL = 3;
1613
+ */
1614
+ LOCAL_ALL = 3,
1615
+ /**
1616
+ * All symbols local by default. Nested types cannot be exported.
1617
+ * With special case caveat for message { enum {} reserved 1 to max; }
1618
+ * This is the recommended setting for new protos.
1619
+ *
1620
+ * @generated from protobuf enum value: STRICT = 4;
1621
+ */
1622
+ STRICT = 4
1526
1623
  }
1527
1624
  /**
1528
1625
  * @generated from protobuf enum google.protobuf.FeatureSet.FieldPresence
1529
1626
  */
1530
1627
  export declare enum FeatureSet_FieldPresence {
1531
1628
  /**
1532
- * @generated from protobuf enum value: FIELD_PRESENCE_UNKNOWN = 0;
1533
- */
1629
+ * @generated from protobuf enum value: FIELD_PRESENCE_UNKNOWN = 0;
1630
+ */
1534
1631
  FIELD_PRESENCE_UNKNOWN = 0,
1535
1632
  /**
1536
- * @generated from protobuf enum value: EXPLICIT = 1;
1537
- */
1633
+ * @generated from protobuf enum value: EXPLICIT = 1;
1634
+ */
1538
1635
  EXPLICIT = 1,
1539
1636
  /**
1540
- * @generated from protobuf enum value: IMPLICIT = 2;
1541
- */
1637
+ * @generated from protobuf enum value: IMPLICIT = 2;
1638
+ */
1542
1639
  IMPLICIT = 2,
1543
1640
  /**
1544
- * @generated from protobuf enum value: LEGACY_REQUIRED = 3;
1545
- */
1641
+ * @generated from protobuf enum value: LEGACY_REQUIRED = 3;
1642
+ */
1546
1643
  LEGACY_REQUIRED = 3
1547
1644
  }
1548
1645
  /**
@@ -1550,16 +1647,16 @@ export declare enum FeatureSet_FieldPresence {
1550
1647
  */
1551
1648
  export declare enum FeatureSet_EnumType {
1552
1649
  /**
1553
- * @generated from protobuf enum value: ENUM_TYPE_UNKNOWN = 0;
1554
- */
1650
+ * @generated from protobuf enum value: ENUM_TYPE_UNKNOWN = 0;
1651
+ */
1555
1652
  ENUM_TYPE_UNKNOWN = 0,
1556
1653
  /**
1557
- * @generated from protobuf enum value: OPEN = 1;
1558
- */
1654
+ * @generated from protobuf enum value: OPEN = 1;
1655
+ */
1559
1656
  OPEN = 1,
1560
1657
  /**
1561
- * @generated from protobuf enum value: CLOSED = 2;
1562
- */
1658
+ * @generated from protobuf enum value: CLOSED = 2;
1659
+ */
1563
1660
  CLOSED = 2
1564
1661
  }
1565
1662
  /**
@@ -1567,16 +1664,16 @@ export declare enum FeatureSet_EnumType {
1567
1664
  */
1568
1665
  export declare enum FeatureSet_RepeatedFieldEncoding {
1569
1666
  /**
1570
- * @generated from protobuf enum value: REPEATED_FIELD_ENCODING_UNKNOWN = 0;
1571
- */
1667
+ * @generated from protobuf enum value: REPEATED_FIELD_ENCODING_UNKNOWN = 0;
1668
+ */
1572
1669
  REPEATED_FIELD_ENCODING_UNKNOWN = 0,
1573
1670
  /**
1574
- * @generated from protobuf enum value: PACKED = 1;
1575
- */
1671
+ * @generated from protobuf enum value: PACKED = 1;
1672
+ */
1576
1673
  PACKED = 1,
1577
1674
  /**
1578
- * @generated from protobuf enum value: EXPANDED = 2;
1579
- */
1675
+ * @generated from protobuf enum value: EXPANDED = 2;
1676
+ */
1580
1677
  EXPANDED = 2
1581
1678
  }
1582
1679
  /**
@@ -1584,16 +1681,16 @@ export declare enum FeatureSet_RepeatedFieldEncoding {
1584
1681
  */
1585
1682
  export declare enum FeatureSet_Utf8Validation {
1586
1683
  /**
1587
- * @generated from protobuf enum value: UTF8_VALIDATION_UNKNOWN = 0;
1588
- */
1684
+ * @generated from protobuf enum value: UTF8_VALIDATION_UNKNOWN = 0;
1685
+ */
1589
1686
  UTF8_VALIDATION_UNKNOWN = 0,
1590
1687
  /**
1591
- * @generated from protobuf enum value: VERIFY = 2;
1592
- */
1688
+ * @generated from protobuf enum value: VERIFY = 2;
1689
+ */
1593
1690
  VERIFY = 2,
1594
1691
  /**
1595
- * @generated from protobuf enum value: NONE = 3;
1596
- */
1692
+ * @generated from protobuf enum value: NONE = 3;
1693
+ */
1597
1694
  NONE = 3
1598
1695
  }
1599
1696
  /**
@@ -1601,16 +1698,16 @@ export declare enum FeatureSet_Utf8Validation {
1601
1698
  */
1602
1699
  export declare enum FeatureSet_MessageEncoding {
1603
1700
  /**
1604
- * @generated from protobuf enum value: MESSAGE_ENCODING_UNKNOWN = 0;
1605
- */
1701
+ * @generated from protobuf enum value: MESSAGE_ENCODING_UNKNOWN = 0;
1702
+ */
1606
1703
  MESSAGE_ENCODING_UNKNOWN = 0,
1607
1704
  /**
1608
- * @generated from protobuf enum value: LENGTH_PREFIXED = 1;
1609
- */
1705
+ * @generated from protobuf enum value: LENGTH_PREFIXED = 1;
1706
+ */
1610
1707
  LENGTH_PREFIXED = 1,
1611
1708
  /**
1612
- * @generated from protobuf enum value: DELIMITED = 2;
1613
- */
1709
+ * @generated from protobuf enum value: DELIMITED = 2;
1710
+ */
1614
1711
  DELIMITED = 2
1615
1712
  }
1616
1713
  /**
@@ -1618,18 +1715,35 @@ export declare enum FeatureSet_MessageEncoding {
1618
1715
  */
1619
1716
  export declare enum FeatureSet_JsonFormat {
1620
1717
  /**
1621
- * @generated from protobuf enum value: JSON_FORMAT_UNKNOWN = 0;
1622
- */
1718
+ * @generated from protobuf enum value: JSON_FORMAT_UNKNOWN = 0;
1719
+ */
1623
1720
  JSON_FORMAT_UNKNOWN = 0,
1624
1721
  /**
1625
- * @generated from protobuf enum value: ALLOW = 1;
1626
- */
1722
+ * @generated from protobuf enum value: ALLOW = 1;
1723
+ */
1627
1724
  ALLOW = 1,
1628
1725
  /**
1629
- * @generated from protobuf enum value: LEGACY_BEST_EFFORT = 2;
1630
- */
1726
+ * @generated from protobuf enum value: LEGACY_BEST_EFFORT = 2;
1727
+ */
1631
1728
  LEGACY_BEST_EFFORT = 2
1632
1729
  }
1730
+ /**
1731
+ * @generated from protobuf enum google.protobuf.FeatureSet.EnforceNamingStyle
1732
+ */
1733
+ export declare enum FeatureSet_EnforceNamingStyle {
1734
+ /**
1735
+ * @generated from protobuf enum value: ENFORCE_NAMING_STYLE_UNKNOWN = 0;
1736
+ */
1737
+ ENFORCE_NAMING_STYLE_UNKNOWN = 0,
1738
+ /**
1739
+ * @generated from protobuf enum value: STYLE2024 = 1;
1740
+ */
1741
+ STYLE2024 = 1,
1742
+ /**
1743
+ * @generated from protobuf enum value: STYLE_LEGACY = 2;
1744
+ */
1745
+ STYLE_LEGACY = 2
1746
+ }
1633
1747
  /**
1634
1748
  * A compiled specification for the defaults of a set of features. These
1635
1749
  * messages are generated from FeatureSet extensions and can be used to seed
@@ -1640,22 +1754,22 @@ export declare enum FeatureSet_JsonFormat {
1640
1754
  */
1641
1755
  export interface FeatureSetDefaults {
1642
1756
  /**
1643
- * @generated from protobuf field: repeated google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault defaults = 1;
1644
- */
1757
+ * @generated from protobuf field: repeated google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault defaults = 1
1758
+ */
1645
1759
  defaults: FeatureSetDefaults_FeatureSetEditionDefault[];
1646
1760
  /**
1647
- * The minimum supported edition (inclusive) when this was constructed.
1648
- * Editions before this will not have defaults.
1649
- *
1650
- * @generated from protobuf field: optional google.protobuf.Edition minimum_edition = 4;
1651
- */
1761
+ * The minimum supported edition (inclusive) when this was constructed.
1762
+ * Editions before this will not have defaults.
1763
+ *
1764
+ * @generated from protobuf field: optional google.protobuf.Edition minimum_edition = 4
1765
+ */
1652
1766
  minimumEdition?: Edition;
1653
1767
  /**
1654
- * The maximum known edition (inclusive) when this was constructed. Editions
1655
- * after this will not have reliable defaults.
1656
- *
1657
- * @generated from protobuf field: optional google.protobuf.Edition maximum_edition = 5;
1658
- */
1768
+ * The maximum known edition (inclusive) when this was constructed. Editions
1769
+ * after this will not have reliable defaults.
1770
+ *
1771
+ * @generated from protobuf field: optional google.protobuf.Edition maximum_edition = 5
1772
+ */
1659
1773
  maximumEdition?: Edition;
1660
1774
  }
1661
1775
  /**
@@ -1668,20 +1782,20 @@ export interface FeatureSetDefaults {
1668
1782
  */
1669
1783
  export interface FeatureSetDefaults_FeatureSetEditionDefault {
1670
1784
  /**
1671
- * @generated from protobuf field: optional google.protobuf.Edition edition = 3;
1672
- */
1785
+ * @generated from protobuf field: optional google.protobuf.Edition edition = 3
1786
+ */
1673
1787
  edition?: Edition;
1674
1788
  /**
1675
- * Defaults of features that can be overridden in this edition.
1676
- *
1677
- * @generated from protobuf field: optional google.protobuf.FeatureSet overridable_features = 4;
1678
- */
1789
+ * Defaults of features that can be overridden in this edition.
1790
+ *
1791
+ * @generated from protobuf field: optional google.protobuf.FeatureSet overridable_features = 4
1792
+ */
1679
1793
  overridableFeatures?: FeatureSet;
1680
1794
  /**
1681
- * Defaults of features that can't be overridden in this edition.
1682
- *
1683
- * @generated from protobuf field: optional google.protobuf.FeatureSet fixed_features = 5;
1684
- */
1795
+ * Defaults of features that can't be overridden in this edition.
1796
+ *
1797
+ * @generated from protobuf field: optional google.protobuf.FeatureSet fixed_features = 5
1798
+ */
1685
1799
  fixedFeatures?: FeatureSet;
1686
1800
  }
1687
1801
  /**
@@ -1692,52 +1806,52 @@ export interface FeatureSetDefaults_FeatureSetEditionDefault {
1692
1806
  */
1693
1807
  export interface SourceCodeInfo {
1694
1808
  /**
1695
- * A Location identifies a piece of source code in a .proto file which
1696
- * corresponds to a particular definition. This information is intended
1697
- * to be useful to IDEs, code indexers, documentation generators, and similar
1698
- * tools.
1699
- *
1700
- * For example, say we have a file like:
1701
- * message Foo {
1702
- * optional string foo = 1;
1703
- * }
1704
- * Let's look at just the field definition:
1705
- * optional string foo = 1;
1706
- * ^ ^^ ^^ ^ ^^^
1707
- * a bc de f ghi
1708
- * We have the following locations:
1709
- * span path represents
1710
- * [a,i) [ 4, 0, 2, 0 ] The whole field definition.
1711
- * [a,b) [ 4, 0, 2, 0, 4 ] The label (optional).
1712
- * [c,d) [ 4, 0, 2, 0, 5 ] The type (string).
1713
- * [e,f) [ 4, 0, 2, 0, 1 ] The name (foo).
1714
- * [g,h) [ 4, 0, 2, 0, 3 ] The number (1).
1715
- *
1716
- * Notes:
1717
- * - A location may refer to a repeated field itself (i.e. not to any
1718
- * particular index within it). This is used whenever a set of elements are
1719
- * logically enclosed in a single code segment. For example, an entire
1720
- * extend block (possibly containing multiple extension definitions) will
1721
- * have an outer location whose path refers to the "extensions" repeated
1722
- * field without an index.
1723
- * - Multiple locations may have the same path. This happens when a single
1724
- * logical declaration is spread out across multiple places. The most
1725
- * obvious example is the "extend" block again -- there may be multiple
1726
- * extend blocks in the same scope, each of which will have the same path.
1727
- * - A location's span is not always a subset of its parent's span. For
1728
- * example, the "extendee" of an extension declaration appears at the
1729
- * beginning of the "extend" block and is shared by all extensions within
1730
- * the block.
1731
- * - Just because a location's span is a subset of some other location's span
1732
- * does not mean that it is a descendant. For example, a "group" defines
1733
- * both a type and a field in a single declaration. Thus, the locations
1734
- * corresponding to the type and field and their components will overlap.
1735
- * - Code which tries to interpret locations should probably be designed to
1736
- * ignore those that it doesn't understand, as more types of locations could
1737
- * be recorded in the future.
1738
- *
1739
- * @generated from protobuf field: repeated google.protobuf.SourceCodeInfo.Location location = 1;
1740
- */
1809
+ * A Location identifies a piece of source code in a .proto file which
1810
+ * corresponds to a particular definition. This information is intended
1811
+ * to be useful to IDEs, code indexers, documentation generators, and similar
1812
+ * tools.
1813
+ *
1814
+ * For example, say we have a file like:
1815
+ * message Foo {
1816
+ * optional string foo = 1;
1817
+ * }
1818
+ * Let's look at just the field definition:
1819
+ * optional string foo = 1;
1820
+ * ^ ^^ ^^ ^ ^^^
1821
+ * a bc de f ghi
1822
+ * We have the following locations:
1823
+ * span path represents
1824
+ * [a,i) [ 4, 0, 2, 0 ] The whole field definition.
1825
+ * [a,b) [ 4, 0, 2, 0, 4 ] The label (optional).
1826
+ * [c,d) [ 4, 0, 2, 0, 5 ] The type (string).
1827
+ * [e,f) [ 4, 0, 2, 0, 1 ] The name (foo).
1828
+ * [g,h) [ 4, 0, 2, 0, 3 ] The number (1).
1829
+ *
1830
+ * Notes:
1831
+ * - A location may refer to a repeated field itself (i.e. not to any
1832
+ * particular index within it). This is used whenever a set of elements are
1833
+ * logically enclosed in a single code segment. For example, an entire
1834
+ * extend block (possibly containing multiple extension definitions) will
1835
+ * have an outer location whose path refers to the "extensions" repeated
1836
+ * field without an index.
1837
+ * - Multiple locations may have the same path. This happens when a single
1838
+ * logical declaration is spread out across multiple places. The most
1839
+ * obvious example is the "extend" block again -- there may be multiple
1840
+ * extend blocks in the same scope, each of which will have the same path.
1841
+ * - A location's span is not always a subset of its parent's span. For
1842
+ * example, the "extendee" of an extension declaration appears at the
1843
+ * beginning of the "extend" block and is shared by all extensions within
1844
+ * the block.
1845
+ * - Just because a location's span is a subset of some other location's span
1846
+ * does not mean that it is a descendant. For example, a "group" defines
1847
+ * both a type and a field in a single declaration. Thus, the locations
1848
+ * corresponding to the type and field and their components will overlap.
1849
+ * - Code which tries to interpret locations should probably be designed to
1850
+ * ignore those that it doesn't understand, as more types of locations could
1851
+ * be recorded in the future.
1852
+ *
1853
+ * @generated from protobuf field: repeated google.protobuf.SourceCodeInfo.Location location = 1
1854
+ */
1741
1855
  location: SourceCodeInfo_Location[];
1742
1856
  }
1743
1857
  /**
@@ -1745,102 +1859,102 @@ export interface SourceCodeInfo {
1745
1859
  */
1746
1860
  export interface SourceCodeInfo_Location {
1747
1861
  /**
1748
- * Identifies which part of the FileDescriptorProto was defined at this
1749
- * location.
1750
- *
1751
- * Each element is a field number or an index. They form a path from
1752
- * the root FileDescriptorProto to the place where the definition appears.
1753
- * For example, this path:
1754
- * [ 4, 3, 2, 7, 1 ]
1755
- * refers to:
1756
- * file.message_type(3) // 4, 3
1757
- * .field(7) // 2, 7
1758
- * .name() // 1
1759
- * This is because FileDescriptorProto.message_type has field number 4:
1760
- * repeated DescriptorProto message_type = 4;
1761
- * and DescriptorProto.field has field number 2:
1762
- * repeated FieldDescriptorProto field = 2;
1763
- * and FieldDescriptorProto.name has field number 1:
1764
- * optional string name = 1;
1765
- *
1766
- * Thus, the above path gives the location of a field name. If we removed
1767
- * the last element:
1768
- * [ 4, 3, 2, 7 ]
1769
- * this path refers to the whole field declaration (from the beginning
1770
- * of the label to the terminating semicolon).
1771
- *
1772
- * @generated from protobuf field: repeated int32 path = 1 [packed = true];
1773
- */
1862
+ * Identifies which part of the FileDescriptorProto was defined at this
1863
+ * location.
1864
+ *
1865
+ * Each element is a field number or an index. They form a path from
1866
+ * the root FileDescriptorProto to the place where the definition appears.
1867
+ * For example, this path:
1868
+ * [ 4, 3, 2, 7, 1 ]
1869
+ * refers to:
1870
+ * file.message_type(3) // 4, 3
1871
+ * .field(7) // 2, 7
1872
+ * .name() // 1
1873
+ * This is because FileDescriptorProto.message_type has field number 4:
1874
+ * repeated DescriptorProto message_type = 4;
1875
+ * and DescriptorProto.field has field number 2:
1876
+ * repeated FieldDescriptorProto field = 2;
1877
+ * and FieldDescriptorProto.name has field number 1:
1878
+ * optional string name = 1;
1879
+ *
1880
+ * Thus, the above path gives the location of a field name. If we removed
1881
+ * the last element:
1882
+ * [ 4, 3, 2, 7 ]
1883
+ * this path refers to the whole field declaration (from the beginning
1884
+ * of the label to the terminating semicolon).
1885
+ *
1886
+ * @generated from protobuf field: repeated int32 path = 1 [packed = true]
1887
+ */
1774
1888
  path: number[];
1775
1889
  /**
1776
- * Always has exactly three or four elements: start line, start column,
1777
- * end line (optional, otherwise assumed same as start line), end column.
1778
- * These are packed into a single field for efficiency. Note that line
1779
- * and column numbers are zero-based -- typically you will want to add
1780
- * 1 to each before displaying to a user.
1781
- *
1782
- * @generated from protobuf field: repeated int32 span = 2 [packed = true];
1783
- */
1890
+ * Always has exactly three or four elements: start line, start column,
1891
+ * end line (optional, otherwise assumed same as start line), end column.
1892
+ * These are packed into a single field for efficiency. Note that line
1893
+ * and column numbers are zero-based -- typically you will want to add
1894
+ * 1 to each before displaying to a user.
1895
+ *
1896
+ * @generated from protobuf field: repeated int32 span = 2 [packed = true]
1897
+ */
1784
1898
  span: number[];
1785
1899
  /**
1786
- * If this SourceCodeInfo represents a complete declaration, these are any
1787
- * comments appearing before and after the declaration which appear to be
1788
- * attached to the declaration.
1789
- *
1790
- * A series of line comments appearing on consecutive lines, with no other
1791
- * tokens appearing on those lines, will be treated as a single comment.
1792
- *
1793
- * leading_detached_comments will keep paragraphs of comments that appear
1794
- * before (but not connected to) the current element. Each paragraph,
1795
- * separated by empty lines, will be one comment element in the repeated
1796
- * field.
1797
- *
1798
- * Only the comment content is provided; comment markers (e.g. //) are
1799
- * stripped out. For block comments, leading whitespace and an asterisk
1800
- * will be stripped from the beginning of each line other than the first.
1801
- * Newlines are included in the output.
1802
- *
1803
- * Examples:
1804
- *
1805
- * optional int32 foo = 1; // Comment attached to foo.
1806
- * // Comment attached to bar.
1807
- * optional int32 bar = 2;
1808
- *
1809
- * optional string baz = 3;
1810
- * // Comment attached to baz.
1811
- * // Another line attached to baz.
1812
- *
1813
- * // Comment attached to moo.
1814
- * //
1815
- * // Another line attached to moo.
1816
- * optional double moo = 4;
1817
- *
1818
- * // Detached comment for corge. This is not leading or trailing comments
1819
- * // to moo or corge because there are blank lines separating it from
1820
- * // both.
1821
- *
1822
- * // Detached comment for corge paragraph 2.
1823
- *
1824
- * optional string corge = 5;
1825
- * /* Block comment attached
1826
- * * to corge. Leading asterisks
1827
- * * will be removed. *\/
1828
- * /* Block comment attached to
1829
- * * grault. *\/
1830
- * optional int32 grault = 6;
1831
- *
1832
- * // ignored detached comments.
1833
- *
1834
- * @generated from protobuf field: optional string leading_comments = 3;
1835
- */
1900
+ * If this SourceCodeInfo represents a complete declaration, these are any
1901
+ * comments appearing before and after the declaration which appear to be
1902
+ * attached to the declaration.
1903
+ *
1904
+ * A series of line comments appearing on consecutive lines, with no other
1905
+ * tokens appearing on those lines, will be treated as a single comment.
1906
+ *
1907
+ * leading_detached_comments will keep paragraphs of comments that appear
1908
+ * before (but not connected to) the current element. Each paragraph,
1909
+ * separated by empty lines, will be one comment element in the repeated
1910
+ * field.
1911
+ *
1912
+ * Only the comment content is provided; comment markers (e.g. //) are
1913
+ * stripped out. For block comments, leading whitespace and an asterisk
1914
+ * will be stripped from the beginning of each line other than the first.
1915
+ * Newlines are included in the output.
1916
+ *
1917
+ * Examples:
1918
+ *
1919
+ * optional int32 foo = 1; // Comment attached to foo.
1920
+ * // Comment attached to bar.
1921
+ * optional int32 bar = 2;
1922
+ *
1923
+ * optional string baz = 3;
1924
+ * // Comment attached to baz.
1925
+ * // Another line attached to baz.
1926
+ *
1927
+ * // Comment attached to moo.
1928
+ * //
1929
+ * // Another line attached to moo.
1930
+ * optional double moo = 4;
1931
+ *
1932
+ * // Detached comment for corge. This is not leading or trailing comments
1933
+ * // to moo or corge because there are blank lines separating it from
1934
+ * // both.
1935
+ *
1936
+ * // Detached comment for corge paragraph 2.
1937
+ *
1938
+ * optional string corge = 5;
1939
+ * /* Block comment attached
1940
+ * * to corge. Leading asterisks
1941
+ * * will be removed. *\/
1942
+ * /* Block comment attached to
1943
+ * * grault. *\/
1944
+ * optional int32 grault = 6;
1945
+ *
1946
+ * // ignored detached comments.
1947
+ *
1948
+ * @generated from protobuf field: optional string leading_comments = 3
1949
+ */
1836
1950
  leadingComments?: string;
1837
1951
  /**
1838
- * @generated from protobuf field: optional string trailing_comments = 4;
1839
- */
1952
+ * @generated from protobuf field: optional string trailing_comments = 4
1953
+ */
1840
1954
  trailingComments?: string;
1841
1955
  /**
1842
- * @generated from protobuf field: repeated string leading_detached_comments = 6;
1843
- */
1956
+ * @generated from protobuf field: repeated string leading_detached_comments = 6
1957
+ */
1844
1958
  leadingDetachedComments: string[];
1845
1959
  }
1846
1960
  /**
@@ -1852,11 +1966,11 @@ export interface SourceCodeInfo_Location {
1852
1966
  */
1853
1967
  export interface GeneratedCodeInfo {
1854
1968
  /**
1855
- * An Annotation connects some span of text in generated code to an element
1856
- * of its generating .proto file.
1857
- *
1858
- * @generated from protobuf field: repeated google.protobuf.GeneratedCodeInfo.Annotation annotation = 1;
1859
- */
1969
+ * An Annotation connects some span of text in generated code to an element
1970
+ * of its generating .proto file.
1971
+ *
1972
+ * @generated from protobuf field: repeated google.protobuf.GeneratedCodeInfo.Annotation annotation = 1
1973
+ */
1860
1974
  annotation: GeneratedCodeInfo_Annotation[];
1861
1975
  }
1862
1976
  /**
@@ -1864,36 +1978,36 @@ export interface GeneratedCodeInfo {
1864
1978
  */
1865
1979
  export interface GeneratedCodeInfo_Annotation {
1866
1980
  /**
1867
- * Identifies the element in the original source .proto file. This field
1868
- * is formatted the same as SourceCodeInfo.Location.path.
1869
- *
1870
- * @generated from protobuf field: repeated int32 path = 1 [packed = true];
1871
- */
1981
+ * Identifies the element in the original source .proto file. This field
1982
+ * is formatted the same as SourceCodeInfo.Location.path.
1983
+ *
1984
+ * @generated from protobuf field: repeated int32 path = 1 [packed = true]
1985
+ */
1872
1986
  path: number[];
1873
1987
  /**
1874
- * Identifies the filesystem path to the original source .proto.
1875
- *
1876
- * @generated from protobuf field: optional string source_file = 2;
1877
- */
1988
+ * Identifies the filesystem path to the original source .proto.
1989
+ *
1990
+ * @generated from protobuf field: optional string source_file = 2
1991
+ */
1878
1992
  sourceFile?: string;
1879
1993
  /**
1880
- * Identifies the starting offset in bytes in the generated code
1881
- * that relates to the identified object.
1882
- *
1883
- * @generated from protobuf field: optional int32 begin = 3;
1884
- */
1994
+ * Identifies the starting offset in bytes in the generated code
1995
+ * that relates to the identified object.
1996
+ *
1997
+ * @generated from protobuf field: optional int32 begin = 3
1998
+ */
1885
1999
  begin?: number;
1886
2000
  /**
1887
- * Identifies the ending offset in bytes in the generated code that
1888
- * relates to the identified object. The end offset should be one past
1889
- * the last relevant byte (so the length of the text = end - begin).
1890
- *
1891
- * @generated from protobuf field: optional int32 end = 4;
1892
- */
2001
+ * Identifies the ending offset in bytes in the generated code that
2002
+ * relates to the identified object. The end offset should be one past
2003
+ * the last relevant byte (so the length of the text = end - begin).
2004
+ *
2005
+ * @generated from protobuf field: optional int32 end = 4
2006
+ */
1893
2007
  end?: number;
1894
2008
  /**
1895
- * @generated from protobuf field: optional google.protobuf.GeneratedCodeInfo.Annotation.Semantic semantic = 5;
1896
- */
2009
+ * @generated from protobuf field: optional google.protobuf.GeneratedCodeInfo.Annotation.Semantic semantic = 5
2010
+ */
1897
2011
  semantic?: GeneratedCodeInfo_Annotation_Semantic;
1898
2012
  }
1899
2013
  /**
@@ -1904,22 +2018,22 @@ export interface GeneratedCodeInfo_Annotation {
1904
2018
  */
1905
2019
  export declare enum GeneratedCodeInfo_Annotation_Semantic {
1906
2020
  /**
1907
- * There is no effect or the effect is indescribable.
1908
- *
1909
- * @generated from protobuf enum value: NONE = 0;
1910
- */
2021
+ * There is no effect or the effect is indescribable.
2022
+ *
2023
+ * @generated from protobuf enum value: NONE = 0;
2024
+ */
1911
2025
  NONE = 0,
1912
2026
  /**
1913
- * The element is set or otherwise mutated.
1914
- *
1915
- * @generated from protobuf enum value: SET = 1;
1916
- */
2027
+ * The element is set or otherwise mutated.
2028
+ *
2029
+ * @generated from protobuf enum value: SET = 1;
2030
+ */
1917
2031
  SET = 1,
1918
2032
  /**
1919
- * An alias to the element is returned.
1920
- *
1921
- * @generated from protobuf enum value: ALIAS = 2;
1922
- */
2033
+ * An alias to the element is returned.
2034
+ *
2035
+ * @generated from protobuf enum value: ALIAS = 2;
2036
+ */
1923
2037
  ALIAS = 2
1924
2038
  }
1925
2039
  /**
@@ -1929,75 +2043,98 @@ export declare enum GeneratedCodeInfo_Annotation_Semantic {
1929
2043
  */
1930
2044
  export declare enum Edition {
1931
2045
  /**
1932
- * A placeholder for an unknown edition value.
1933
- *
1934
- * @generated from protobuf enum value: EDITION_UNKNOWN = 0;
1935
- */
2046
+ * A placeholder for an unknown edition value.
2047
+ *
2048
+ * @generated from protobuf enum value: EDITION_UNKNOWN = 0;
2049
+ */
1936
2050
  EDITION_UNKNOWN = 0,
1937
2051
  /**
1938
- * A placeholder edition for specifying default behaviors *before* a feature
1939
- * was first introduced. This is effectively an "infinite past".
1940
- *
1941
- * @generated from protobuf enum value: EDITION_LEGACY = 900;
1942
- */
2052
+ * A placeholder edition for specifying default behaviors *before* a feature
2053
+ * was first introduced. This is effectively an "infinite past".
2054
+ *
2055
+ * @generated from protobuf enum value: EDITION_LEGACY = 900;
2056
+ */
1943
2057
  EDITION_LEGACY = 900,
1944
2058
  /**
1945
- * Legacy syntax "editions". These pre-date editions, but behave much like
1946
- * distinct editions. These can't be used to specify the edition of proto
1947
- * files, but feature definitions must supply proto2/proto3 defaults for
1948
- * backwards compatibility.
1949
- *
1950
- * @generated from protobuf enum value: EDITION_PROTO2 = 998;
1951
- */
2059
+ * Legacy syntax "editions". These pre-date editions, but behave much like
2060
+ * distinct editions. These can't be used to specify the edition of proto
2061
+ * files, but feature definitions must supply proto2/proto3 defaults for
2062
+ * backwards compatibility.
2063
+ *
2064
+ * @generated from protobuf enum value: EDITION_PROTO2 = 998;
2065
+ */
1952
2066
  EDITION_PROTO2 = 998,
1953
2067
  /**
1954
- * @generated from protobuf enum value: EDITION_PROTO3 = 999;
1955
- */
2068
+ * @generated from protobuf enum value: EDITION_PROTO3 = 999;
2069
+ */
1956
2070
  EDITION_PROTO3 = 999,
1957
2071
  /**
1958
- * Editions that have been released. The specific values are arbitrary and
1959
- * should not be depended on, but they will always be time-ordered for easy
1960
- * comparison.
1961
- *
1962
- * @generated from protobuf enum value: EDITION_2023 = 1000;
1963
- */
2072
+ * Editions that have been released. The specific values are arbitrary and
2073
+ * should not be depended on, but they will always be time-ordered for easy
2074
+ * comparison.
2075
+ *
2076
+ * @generated from protobuf enum value: EDITION_2023 = 1000;
2077
+ */
1964
2078
  EDITION_2023 = 1000,
1965
2079
  /**
1966
- * @generated from protobuf enum value: EDITION_2024 = 1001;
1967
- */
2080
+ * @generated from protobuf enum value: EDITION_2024 = 1001;
2081
+ */
1968
2082
  EDITION_2024 = 1001,
1969
2083
  /**
1970
- * Placeholder editions for testing feature resolution. These should not be
1971
- * used or relied on outside of tests.
1972
- *
1973
- * @generated from protobuf enum value: EDITION_1_TEST_ONLY = 1;
1974
- */
2084
+ * Placeholder editions for testing feature resolution. These should not be
2085
+ * used or relied on outside of tests.
2086
+ *
2087
+ * @generated from protobuf enum value: EDITION_1_TEST_ONLY = 1;
2088
+ */
1975
2089
  EDITION_1_TEST_ONLY = 1,
1976
2090
  /**
1977
- * @generated from protobuf enum value: EDITION_2_TEST_ONLY = 2;
1978
- */
2091
+ * @generated from protobuf enum value: EDITION_2_TEST_ONLY = 2;
2092
+ */
1979
2093
  EDITION_2_TEST_ONLY = 2,
1980
2094
  /**
1981
- * @generated from protobuf enum value: EDITION_99997_TEST_ONLY = 99997;
1982
- */
2095
+ * @generated from protobuf enum value: EDITION_99997_TEST_ONLY = 99997;
2096
+ */
1983
2097
  EDITION_99997_TEST_ONLY = 99997,
1984
2098
  /**
1985
- * @generated from protobuf enum value: EDITION_99998_TEST_ONLY = 99998;
1986
- */
2099
+ * @generated from protobuf enum value: EDITION_99998_TEST_ONLY = 99998;
2100
+ */
1987
2101
  EDITION_99998_TEST_ONLY = 99998,
1988
2102
  /**
1989
- * @generated from protobuf enum value: EDITION_99999_TEST_ONLY = 99999;
1990
- */
2103
+ * @generated from protobuf enum value: EDITION_99999_TEST_ONLY = 99999;
2104
+ */
1991
2105
  EDITION_99999_TEST_ONLY = 99999,
1992
2106
  /**
1993
- * Placeholder for specifying unbounded edition support. This should only
1994
- * ever be used by plugins that can expect to never require any changes to
1995
- * support a new edition.
1996
- *
1997
- * @generated from protobuf enum value: EDITION_MAX = 2147483647;
1998
- */
2107
+ * Placeholder for specifying unbounded edition support. This should only
2108
+ * ever be used by plugins that can expect to never require any changes to
2109
+ * support a new edition.
2110
+ *
2111
+ * @generated from protobuf enum value: EDITION_MAX = 2147483647;
2112
+ */
1999
2113
  EDITION_MAX = 2147483647
2000
2114
  }
2115
+ /**
2116
+ * Describes the 'visibility' of a symbol with respect to the proto import
2117
+ * system. Symbols can only be imported when the visibility rules do not prevent
2118
+ * it (ex: local symbols cannot be imported). Visibility modifiers can only set
2119
+ * on `message` and `enum` as they are the only types available to be referenced
2120
+ * from other files.
2121
+ *
2122
+ * @generated from protobuf enum google.protobuf.SymbolVisibility
2123
+ */
2124
+ export declare enum SymbolVisibility {
2125
+ /**
2126
+ * @generated from protobuf enum value: VISIBILITY_UNSET = 0;
2127
+ */
2128
+ VISIBILITY_UNSET = 0,
2129
+ /**
2130
+ * @generated from protobuf enum value: VISIBILITY_LOCAL = 1;
2131
+ */
2132
+ VISIBILITY_LOCAL = 1,
2133
+ /**
2134
+ * @generated from protobuf enum value: VISIBILITY_EXPORT = 2;
2135
+ */
2136
+ VISIBILITY_EXPORT = 2
2137
+ }
2001
2138
  declare class FileDescriptorSet$Type extends MessageType<FileDescriptorSet> {
2002
2139
  constructor();
2003
2140
  create(value?: PartialMessage<FileDescriptorSet>): FileDescriptorSet;
@@ -2268,6 +2405,16 @@ declare class FeatureSet$Type extends MessageType<FeatureSet> {
2268
2405
  * @generated MessageType for protobuf message google.protobuf.FeatureSet
2269
2406
  */
2270
2407
  export declare const FeatureSet: FeatureSet$Type;
2408
+ declare class FeatureSet_VisibilityFeature$Type extends MessageType<FeatureSet_VisibilityFeature> {
2409
+ constructor();
2410
+ create(value?: PartialMessage<FeatureSet_VisibilityFeature>): FeatureSet_VisibilityFeature;
2411
+ internalBinaryRead(reader: IBinaryReader, length: number, options: BinaryReadOptions, target?: FeatureSet_VisibilityFeature): FeatureSet_VisibilityFeature;
2412
+ internalBinaryWrite(message: FeatureSet_VisibilityFeature, writer: IBinaryWriter, options: BinaryWriteOptions): IBinaryWriter;
2413
+ }
2414
+ /**
2415
+ * @generated MessageType for protobuf message google.protobuf.FeatureSet.VisibilityFeature
2416
+ */
2417
+ export declare const FeatureSet_VisibilityFeature: FeatureSet_VisibilityFeature$Type;
2271
2418
  declare class FeatureSetDefaults$Type extends MessageType<FeatureSetDefaults> {
2272
2419
  constructor();
2273
2420
  create(value?: PartialMessage<FeatureSetDefaults>): FeatureSetDefaults;