@devvit/protos 0.11.18-next-2025-06-17-16-32-06-0435ccdf4.0 → 0.11.18-next-2025-06-17-17-02-29-c057f0f72.0

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 (220) hide show
  1. package/package.json +4 -4
  2. package/schema/.snootobuf/deps/buf/validate/expression.proto +0 -92
  3. package/schema/.snootobuf/deps/buf/validate/priv/private.proto +0 -41
  4. package/schema/.snootobuf/deps/buf/validate/validate.proto +0 -4130
  5. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/audit.proto +0 -72
  6. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/auth.proto +0 -49
  7. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/organization.proto +0 -54
  8. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/service.proto +0 -46
  9. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/subscription.proto +0 -72
  10. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/ui.proto +0 -20
  11. package/schema/.snootobuf/deps/devvit/data/api/admin/v1alpha/user.proto +0 -45
  12. package/schema/.snootobuf/deps/devvit/data/api/v1alpha/admin.proto +0 -54
  13. package/schema/.snootobuf/deps/devvit/data/api/v1alpha/delivery.proto +0 -773
  14. package/schema/.snootobuf/deps/devvit/data/api/v1alpha/filter.proto +0 -66
  15. package/schema/.snootobuf/deps/devvit/data/api/v1alpha/firehose.proto +0 -100
  16. package/schema/.snootobuf/deps/devvit/data/api/v1alpha/intake.proto +0 -19
  17. package/schema/.snootobuf/deps/devvit/events/v1alpha/events.proto +0 -446
  18. package/schema/.snootobuf/deps/devvit/gateway/v1alpha/payments.proto +0 -24
  19. package/schema/.snootobuf/deps/devvit/options/options.proto +0 -98
  20. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/commentv2.proto +0 -29
  21. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/flair.proto +0 -25
  22. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/modaction.proto +0 -53
  23. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/modmail.proto +0 -56
  24. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/postv2.proto +0 -107
  25. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/subredditv2.proto +0 -41
  26. package/schema/.snootobuf/deps/devvit/reddit/v2alpha/userv2.proto +0 -23
  27. package/schema/.snootobuf/deps/devvit/triggers/v1alpha/triggers.proto +0 -162
  28. package/schema/.snootobuf/deps/enum/account_gender_category.proto +0 -14
  29. package/schema/.snootobuf/deps/enum/approval_status.proto +0 -15
  30. package/schema/.snootobuf/deps/enum/automated_reporting_level.proto +0 -12
  31. package/schema/.snootobuf/deps/enum/ban_evasion_threshold.proto +0 -13
  32. package/schema/.snootobuf/deps/enum/ban_info_action.proto +0 -12
  33. package/schema/.snootobuf/deps/enum/block_relation_type.proto +0 -11
  34. package/schema/.snootobuf/deps/enum/comment_sort.proto +0 -18
  35. package/schema/.snootobuf/deps/enum/comment_type.proto +0 -11
  36. package/schema/.snootobuf/deps/enum/crowd_control_level.proto +0 -12
  37. package/schema/.snootobuf/deps/enum/discussion_type.proto +0 -10
  38. package/schema/.snootobuf/deps/enum/distinguish_type.proto +0 -14
  39. package/schema/.snootobuf/deps/enum/flair_position.proto +0 -11
  40. package/schema/.snootobuf/deps/enum/hateful_content_threshold.proto +0 -12
  41. package/schema/.snootobuf/deps/enum/link_content_type.proto +0 -11
  42. package/schema/.snootobuf/deps/enum/link_type.proto +0 -11
  43. package/schema/.snootobuf/deps/enum/link_visibility.proto +0 -11
  44. package/schema/.snootobuf/deps/enum/prediction_leaderboard_entry_type.proto +0 -11
  45. package/schema/.snootobuf/deps/enum/promo_layout.proto +0 -11
  46. package/schema/.snootobuf/deps/enum/removed_by_type.proto +0 -18
  47. package/schema/.snootobuf/deps/enum/spam_level.proto +0 -11
  48. package/schema/.snootobuf/deps/enum/subreddit_type.proto +0 -16
  49. package/schema/.snootobuf/deps/enum/verdict.proto +0 -14
  50. package/schema/.snootobuf/deps/enum/vote.proto +0 -12
  51. package/schema/.snootobuf/deps/enum/whitelist_status.proto +0 -17
  52. package/schema/.snootobuf/deps/enum/wiki_edit_mode.proto +0 -12
  53. package/schema/.snootobuf/deps/evaluator/evaluator.proto +0 -203
  54. package/schema/.snootobuf/deps/google/api/annotations.proto +0 -31
  55. package/schema/.snootobuf/deps/google/api/apikeys/v2/apikeys.proto +0 -288
  56. package/schema/.snootobuf/deps/google/api/apikeys/v2/resources.proto +0 -175
  57. package/schema/.snootobuf/deps/google/api/auth.proto +0 -237
  58. package/schema/.snootobuf/deps/google/api/backend.proto +0 -185
  59. package/schema/.snootobuf/deps/google/api/billing.proto +0 -77
  60. package/schema/.snootobuf/deps/google/api/client.proto +0 -431
  61. package/schema/.snootobuf/deps/google/api/cloudquotas/v1/cloudquotas.proto +0 -322
  62. package/schema/.snootobuf/deps/google/api/cloudquotas/v1/resources.proto +0 -315
  63. package/schema/.snootobuf/deps/google/api/config_change.proto +0 -84
  64. package/schema/.snootobuf/deps/google/api/consumer.proto +0 -82
  65. package/schema/.snootobuf/deps/google/api/context.proto +0 -92
  66. package/schema/.snootobuf/deps/google/api/control.proto +0 -41
  67. package/schema/.snootobuf/deps/google/api/distribution.proto +0 -213
  68. package/schema/.snootobuf/deps/google/api/documentation.proto +0 -168
  69. package/schema/.snootobuf/deps/google/api/endpoint.proto +0 -69
  70. package/schema/.snootobuf/deps/google/api/error_reason.proto +0 -589
  71. package/schema/.snootobuf/deps/google/api/expr/conformance/v1alpha1/conformance_service.proto +0 -183
  72. package/schema/.snootobuf/deps/google/api/expr/v1alpha1/checked.proto +0 -343
  73. package/schema/.snootobuf/deps/google/api/expr/v1alpha1/eval.proto +0 -118
  74. package/schema/.snootobuf/deps/google/api/expr/v1alpha1/explain.proto +0 -53
  75. package/schema/.snootobuf/deps/google/api/expr/v1alpha1/syntax.proto +0 -438
  76. package/schema/.snootobuf/deps/google/api/expr/v1alpha1/value.proto +0 -115
  77. package/schema/.snootobuf/deps/google/api/expr/v1beta1/decl.proto +0 -84
  78. package/schema/.snootobuf/deps/google/api/expr/v1beta1/eval.proto +0 -125
  79. package/schema/.snootobuf/deps/google/api/expr/v1beta1/expr.proto +0 -265
  80. package/schema/.snootobuf/deps/google/api/expr/v1beta1/source.proto +0 -62
  81. package/schema/.snootobuf/deps/google/api/expr/v1beta1/value.proto +0 -114
  82. package/schema/.snootobuf/deps/google/api/field_behavior.proto +0 -104
  83. package/schema/.snootobuf/deps/google/api/field_info.proto +0 -106
  84. package/schema/.snootobuf/deps/google/api/http.proto +0 -371
  85. package/schema/.snootobuf/deps/google/api/httpbody.proto +0 -81
  86. package/schema/.snootobuf/deps/google/api/label.proto +0 -48
  87. package/schema/.snootobuf/deps/google/api/launch_stage.proto +0 -72
  88. package/schema/.snootobuf/deps/google/api/log.proto +0 -54
  89. package/schema/.snootobuf/deps/google/api/logging.proto +0 -81
  90. package/schema/.snootobuf/deps/google/api/metric.proto +0 -268
  91. package/schema/.snootobuf/deps/google/api/monitored_resource.proto +0 -130
  92. package/schema/.snootobuf/deps/google/api/monitoring.proto +0 -107
  93. package/schema/.snootobuf/deps/google/api/policy.proto +0 -85
  94. package/schema/.snootobuf/deps/google/api/quota.proto +0 -184
  95. package/schema/.snootobuf/deps/google/api/resource.proto +0 -243
  96. package/schema/.snootobuf/deps/google/api/routing.proto +0 -461
  97. package/schema/.snootobuf/deps/google/api/service.proto +0 -191
  98. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/check_error.proto +0 -124
  99. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/distribution.proto +0 -166
  100. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/http_request.proto +0 -93
  101. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/log_entry.proto +0 -126
  102. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/metric_value.proto +0 -81
  103. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/operation.proto +0 -123
  104. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/quota_controller.proto +0 -245
  105. package/schema/.snootobuf/deps/google/api/servicecontrol/v1/service_controller.proto +0 -260
  106. package/schema/.snootobuf/deps/google/api/servicecontrol/v2/service_controller.proto +0 -196
  107. package/schema/.snootobuf/deps/google/api/servicemanagement/v1/resources.proto +0 -295
  108. package/schema/.snootobuf/deps/google/api/servicemanagement/v1/servicemanager.proto +0 -508
  109. package/schema/.snootobuf/deps/google/api/serviceusage/v1/resources.proto +0 -130
  110. package/schema/.snootobuf/deps/google/api/serviceusage/v1/serviceusage.proto +0 -305
  111. package/schema/.snootobuf/deps/google/api/serviceusage/v1beta1/resources.proto +0 -458
  112. package/schema/.snootobuf/deps/google/api/serviceusage/v1beta1/serviceusage.proto +0 -793
  113. package/schema/.snootobuf/deps/google/api/source_info.proto +0 -31
  114. package/schema/.snootobuf/deps/google/api/system_parameter.proto +0 -96
  115. package/schema/.snootobuf/deps/google/api/usage.proto +0 -96
  116. package/schema/.snootobuf/deps/google/api/visibility.proto +0 -113
  117. package/schema/.snootobuf/deps/google/cloud/extended_operations.proto +0 -150
  118. package/schema/.snootobuf/deps/google/iam/admin/v1/iam.proto +0 -1087
  119. package/schema/.snootobuf/deps/google/iam/v1/iam_policy.proto +0 -145
  120. package/schema/.snootobuf/deps/google/iam/v1/logging/audit_data.proto +0 -34
  121. package/schema/.snootobuf/deps/google/iam/v1/options.proto +0 -41
  122. package/schema/.snootobuf/deps/google/iam/v1/policy.proto +0 -240
  123. package/schema/.snootobuf/deps/google/logging/type/http_request.proto +0 -92
  124. package/schema/.snootobuf/deps/google/logging/type/log_severity.proto +0 -72
  125. package/schema/.snootobuf/deps/google/longrunning/operations.proto +0 -247
  126. package/schema/.snootobuf/deps/google/protobuf/any.proto +0 -158
  127. package/schema/.snootobuf/deps/google/protobuf/api.proto +0 -208
  128. package/schema/.snootobuf/deps/google/protobuf/compiler/plugin.proto +0 -183
  129. package/schema/.snootobuf/deps/google/protobuf/descriptor.proto +0 -921
  130. package/schema/.snootobuf/deps/google/protobuf/duration.proto +0 -116
  131. package/schema/.snootobuf/deps/google/protobuf/empty.proto +0 -51
  132. package/schema/.snootobuf/deps/google/protobuf/field_mask.proto +0 -245
  133. package/schema/.snootobuf/deps/google/protobuf/source_context.proto +0 -48
  134. package/schema/.snootobuf/deps/google/protobuf/struct.proto +0 -95
  135. package/schema/.snootobuf/deps/google/protobuf/timestamp.proto +0 -147
  136. package/schema/.snootobuf/deps/google/protobuf/type.proto +0 -187
  137. package/schema/.snootobuf/deps/google/protobuf/wrappers.proto +0 -123
  138. package/schema/.snootobuf/deps/google/rpc/code.proto +0 -186
  139. package/schema/.snootobuf/deps/google/rpc/context/attribute_context.proto +0 -287
  140. package/schema/.snootobuf/deps/google/rpc/error_details.proto +0 -246
  141. package/schema/.snootobuf/deps/google/rpc/status.proto +0 -47
  142. package/schema/.snootobuf/deps/google/type/calendar_period.proto +0 -57
  143. package/schema/.snootobuf/deps/google/type/color.proto +0 -170
  144. package/schema/.snootobuf/deps/google/type/date.proto +0 -50
  145. package/schema/.snootobuf/deps/google/type/datetime.proto +0 -97
  146. package/schema/.snootobuf/deps/google/type/dayofweek.proto +0 -51
  147. package/schema/.snootobuf/deps/google/type/expr.proto +0 -51
  148. package/schema/.snootobuf/deps/google/type/fraction.proto +0 -34
  149. package/schema/.snootobuf/deps/google/type/latlng.proto +0 -37
  150. package/schema/.snootobuf/deps/google/type/money.proto +0 -43
  151. package/schema/.snootobuf/deps/google/type/month.proto +0 -66
  152. package/schema/.snootobuf/deps/google/type/postal_address.proto +0 -135
  153. package/schema/.snootobuf/deps/google/type/quaternion.proto +0 -95
  154. package/schema/.snootobuf/deps/google/type/timeofday.proto +0 -44
  155. package/schema/.snootobuf/deps/openapi/helper.proto +0 -20
  156. package/schema/.snootobuf/deps/products-api/protos/reddit/xpaymentsplatform/payproducts/v1/currencies.proto +0 -189
  157. package/schema/.snootobuf/deps/products-api/protos/reddit/xpaymentsplatform/payproducts/v1/payproducts.proto +0 -118
  158. package/schema/.snootobuf/deps/reddit/api/metadata/v1/metadata.proto +0 -55
  159. package/schema/.snootobuf/deps/reddit/coreplatform/account/v1/account.proto +0 -579
  160. package/schema/.snootobuf/deps/reddit/coreplatform/account/v1/account_relations.proto +0 -43
  161. package/schema/.snootobuf/deps/reddit/coreplatform/api/metadata/v1/metadata.proto +0 -82
  162. package/schema/.snootobuf/deps/reddit/coreplatform/blocking/v1/user_blocking_service.proto +0 -221
  163. package/schema/.snootobuf/deps/reddit/coreplatform/comments/v1/comment_tree.proto +0 -78
  164. package/schema/.snootobuf/deps/reddit/coreplatform/comments/v1/comment_tree_service.proto +0 -189
  165. package/schema/.snootobuf/deps/reddit/coreplatform/comments/v1/comment_tree_structure.proto +0 -29
  166. package/schema/.snootobuf/deps/reddit/coreplatform/comments/v1/comments.proto +0 -417
  167. package/schema/.snootobuf/deps/reddit/coreplatform/comments/v1/comments_service.proto +0 -72
  168. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/auth.proto +0 -25
  169. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/features.proto +0 -52
  170. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/lang.proto +0 -16
  171. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/legal.proto +0 -20
  172. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/media.proto +0 -149
  173. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/moderation.proto +0 -197
  174. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/safety.proto +0 -116
  175. package/schema/.snootobuf/deps/reddit/coreplatform/common/v1/time.proto +0 -25
  176. package/schema/.snootobuf/deps/reddit/coreplatform/domains/v1/domains_metadata_service.proto +0 -101
  177. package/schema/.snootobuf/deps/reddit/coreplatform/grpc_thrift/v1/grpc_thrift_options.proto +0 -34
  178. package/schema/.snootobuf/deps/reddit/coreplatform/links/v1/links.proto +0 -798
  179. package/schema/.snootobuf/deps/reddit/coreplatform/links/v1/links_service.proto +0 -186
  180. package/schema/.snootobuf/deps/reddit/coreplatform/messages/v1/messages.proto +0 -110
  181. package/schema/.snootobuf/deps/reddit/coreplatform/sensitive/v1/wrappers.proto +0 -51
  182. package/schema/.snootobuf/deps/reddit/coreplatform/subreddit/v1/subreddit.proto +0 -1202
  183. package/schema/.snootobuf/deps/reddit/coreplatform/subreddit/v1/subreddit_member_relations.proto +0 -85
  184. package/schema/.snootobuf/deps/reddit/coreplatform/subreddit/v1/subreddit_moderator_service.proto +0 -363
  185. package/schema/.snootobuf/deps/reddit/coreplatform/subreddit/v1/subreddit_service.proto +0 -301
  186. package/schema/.snootobuf/deps/reddit/coreplatform/thing/v0/thing.proto +0 -2869
  187. package/schema/.snootobuf/deps/reddit/devvit/custom_post/v1/custom_post.proto +0 -15
  188. package/schema/.snootobuf/deps/reddit/devvit/custom_post/v1/service.proto +0 -11
  189. package/schema/.snootobuf/deps/reddit/devvit/subreddit/v1/context_action.proto +0 -48
  190. package/schema/.snootobuf/deps/reddit/devvit/subreddit/v1/manifest.proto +0 -70
  191. package/schema/.snootobuf/deps/reddit/devvit/subreddit/v1/service.proto +0 -11
  192. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/acknowledge_order_delivery.proto +0 -17
  193. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/checkout.proto +0 -89
  194. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/common.proto +0 -322
  195. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/delete_products.proto +0 -17
  196. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/events.proto +0 -14
  197. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_batch_products.proto +0 -15
  198. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_gold_balances.proto +0 -48
  199. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_order.proto +0 -31
  200. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_orders.proto +0 -26
  201. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_orders_by_user.proto +0 -15
  202. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_payout_info_batch.proto +0 -52
  203. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_products.proto +0 -23
  204. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/get_user_profiles.proto +0 -28
  205. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/refund_order.proto +0 -17
  206. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/service.proto +0 -49
  207. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/service_data_compliance.proto +0 -20
  208. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payapi/v1/upsert_products.proto +0 -17
  209. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/paygatewaypsps/v1/paygatewaypsps.proto +0 -158
  210. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payorders/v1/payments_data_compliance.proto +0 -18
  211. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payorders/v1/payorders.proto +0 -195
  212. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/paypayments/v1/admin.proto +0 -44
  213. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/paypayments/v1/ledger.proto +0 -200
  214. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/paypayments/v1/payments_data_compliance.proto +0 -18
  215. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/paypayments/v1/paypayments.proto +0 -210
  216. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payproducts/v1/currencies.proto +0 -189
  217. package/schema/.snootobuf/deps/reddit/xpaymentsplatform/payproducts/v1/payproducts.proto +0 -135
  218. package/schema/.snootobuf/deps/snooron_sources/text_classification/text_classification.proto +0 -29
  219. package/schema/.snootobuf/deps/snooron_sources/v2_event/v2_event.proto +0 -3292
  220. package/schema/.snootobuf/deps/validate/validate.proto +0 -862
@@ -1,183 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // https://developers.google.com/protocol-buffers/
4
- //
5
- // Redistribution and use in source and binary forms, with or without
6
- // modification, are permitted provided that the following conditions are
7
- // met:
8
- //
9
- // * Redistributions of source code must retain the above copyright
10
- // notice, this list of conditions and the following disclaimer.
11
- // * Redistributions in binary form must reproduce the above
12
- // copyright notice, this list of conditions and the following disclaimer
13
- // in the documentation and/or other materials provided with the
14
- // distribution.
15
- // * Neither the name of Google Inc. nor the names of its
16
- // contributors may be used to endorse or promote products derived from
17
- // this software without specific prior written permission.
18
- //
19
- // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
- // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
- // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
- // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
- // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
- // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
- // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
- // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
- // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
- // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
- // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
-
31
- // Author: kenton@google.com (Kenton Varda)
32
- //
33
- // WARNING: The plugin interface is currently EXPERIMENTAL and is subject to
34
- // change.
35
- //
36
- // protoc (aka the Protocol Compiler) can be extended via plugins. A plugin is
37
- // just a program that reads a CodeGeneratorRequest from stdin and writes a
38
- // CodeGeneratorResponse to stdout.
39
- //
40
- // Plugins written using C++ can use google/protobuf/compiler/plugin.h instead
41
- // of dealing with the raw protocol defined here.
42
- //
43
- // A plugin executable needs only to be placed somewhere in the path. The
44
- // plugin should be named "protoc-gen-$NAME", and will then be used when the
45
- // flag "--${NAME}_out" is passed to protoc.
46
-
47
- syntax = "proto2";
48
-
49
- package google.protobuf.compiler;
50
- option java_package = "com.google.protobuf.compiler";
51
- option java_outer_classname = "PluginProtos";
52
-
53
- option go_package = "google.golang.org/protobuf/types/pluginpb";
54
-
55
- import "google/protobuf/descriptor.proto";
56
-
57
- // The version number of protocol compiler.
58
- message Version {
59
- optional int32 major = 1;
60
- optional int32 minor = 2;
61
- optional int32 patch = 3;
62
- // A suffix for alpha, beta or rc release, e.g., "alpha-1", "rc2". It should
63
- // be empty for mainline stable releases.
64
- optional string suffix = 4;
65
- }
66
-
67
- // An encoded CodeGeneratorRequest is written to the plugin's stdin.
68
- message CodeGeneratorRequest {
69
- // The .proto files that were explicitly listed on the command-line. The
70
- // code generator should generate code only for these files. Each file's
71
- // descriptor will be included in proto_file, below.
72
- repeated string file_to_generate = 1;
73
-
74
- // The generator parameter passed on the command-line.
75
- optional string parameter = 2;
76
-
77
- // FileDescriptorProtos for all files in files_to_generate and everything
78
- // they import. The files will appear in topological order, so each file
79
- // appears before any file that imports it.
80
- //
81
- // protoc guarantees that all proto_files will be written after
82
- // the fields above, even though this is not technically guaranteed by the
83
- // protobuf wire format. This theoretically could allow a plugin to stream
84
- // in the FileDescriptorProtos and handle them one by one rather than read
85
- // the entire set into memory at once. However, as of this writing, this
86
- // is not similarly optimized on protoc's end -- it will store all fields in
87
- // memory at once before sending them to the plugin.
88
- //
89
- // Type names of fields and extensions in the FileDescriptorProto are always
90
- // fully qualified.
91
- repeated FileDescriptorProto proto_file = 15;
92
-
93
- // The version number of protocol compiler.
94
- optional Version compiler_version = 3;
95
-
96
- }
97
-
98
- // The plugin writes an encoded CodeGeneratorResponse to stdout.
99
- message CodeGeneratorResponse {
100
- // Error message. If non-empty, code generation failed. The plugin process
101
- // should exit with status code zero even if it reports an error in this way.
102
- //
103
- // This should be used to indicate errors in .proto files which prevent the
104
- // code generator from generating correct code. Errors which indicate a
105
- // problem in protoc itself -- such as the input CodeGeneratorRequest being
106
- // unparseable -- should be reported by writing a message to stderr and
107
- // exiting with a non-zero status code.
108
- optional string error = 1;
109
-
110
- // A bitmask of supported features that the code generator supports.
111
- // This is a bitwise "or" of values from the Feature enum.
112
- optional uint64 supported_features = 2;
113
-
114
- // Sync with code_generator.h.
115
- enum Feature {
116
- FEATURE_NONE = 0;
117
- FEATURE_PROTO3_OPTIONAL = 1;
118
- }
119
-
120
- // Represents a single generated file.
121
- message File {
122
- // The file name, relative to the output directory. The name must not
123
- // contain "." or ".." components and must be relative, not be absolute (so,
124
- // the file cannot lie outside the output directory). "/" must be used as
125
- // the path separator, not "\".
126
- //
127
- // If the name is omitted, the content will be appended to the previous
128
- // file. This allows the generator to break large files into small chunks,
129
- // and allows the generated text to be streamed back to protoc so that large
130
- // files need not reside completely in memory at one time. Note that as of
131
- // this writing protoc does not optimize for this -- it will read the entire
132
- // CodeGeneratorResponse before writing files to disk.
133
- optional string name = 1;
134
-
135
- // If non-empty, indicates that the named file should already exist, and the
136
- // content here is to be inserted into that file at a defined insertion
137
- // point. This feature allows a code generator to extend the output
138
- // produced by another code generator. The original generator may provide
139
- // insertion points by placing special annotations in the file that look
140
- // like:
141
- // @@protoc_insertion_point(NAME)
142
- // The annotation can have arbitrary text before and after it on the line,
143
- // which allows it to be placed in a comment. NAME should be replaced with
144
- // an identifier naming the point -- this is what other generators will use
145
- // as the insertion_point. Code inserted at this point will be placed
146
- // immediately above the line containing the insertion point (thus multiple
147
- // insertions to the same point will come out in the order they were added).
148
- // The double-@ is intended to make it unlikely that the generated code
149
- // could contain things that look like insertion points by accident.
150
- //
151
- // For example, the C++ code generator places the following line in the
152
- // .pb.h files that it generates:
153
- // // @@protoc_insertion_point(namespace_scope)
154
- // This line appears within the scope of the file's package namespace, but
155
- // outside of any particular class. Another plugin can then specify the
156
- // insertion_point "namespace_scope" to generate additional classes or
157
- // other declarations that should be placed in this scope.
158
- //
159
- // Note that if the line containing the insertion point begins with
160
- // whitespace, the same whitespace will be added to every line of the
161
- // inserted text. This is useful for languages like Python, where
162
- // indentation matters. In these languages, the insertion point comment
163
- // should be indented the same amount as any inserted code will need to be
164
- // in order to work correctly in that context.
165
- //
166
- // The code generator that generates the initial file and the one which
167
- // inserts into it must both run as part of a single invocation of protoc.
168
- // Code generators are executed in the order in which they appear on the
169
- // command line.
170
- //
171
- // If |insertion_point| is present, |name| must also be present.
172
- optional string insertion_point = 2;
173
-
174
- // The file contents.
175
- optional string content = 15;
176
-
177
- // Information describing the file content being inserted. If an insertion
178
- // point is used, this information will be appropriately offset and inserted
179
- // into the code generation metadata for the generated files.
180
- optional GeneratedCodeInfo generated_code_info = 16;
181
- }
182
- repeated File file = 15;
183
- }