@devvit/protos 0.12.1-next-2025-09-08-20-55-43-6ce1b439e.0 → 0.12.1-next-2025-09-09-13-45-18-0f0a506a2.0

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/api/metadata/v1/metadata.proto

@@ -0,0 +1,82 @@
+syntax = "proto3";
+
+package reddit.coreplatform.api.metadata.v1;
+
+import "google/protobuf/descriptor.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "github.snooguts.net/reddit/thing-api/go/api/metadata/v1;metadata";
+option java_multiple_files = true;
+option java_outer_classname = "MetadataProto";
+option java_package = "com.reddit.coreplatform.api.metadata.v1";
+
+extend google.protobuf.EnumValueOptions {
+  // This enum option is used to allow us to annotate newer protobuf enums
+  // with a description of what their previous value was in the older thrift
+  // API. Newer proto enums are not 1:1 mapping of their Thrift counterparts
+  // due to differences between the best practices of Thrift and protobuf.
+  ThriftEnumAlias thrift_alias = 78010000;
+}
+
+// This message represents a legacy Thrift enum const.
+message ThriftEnumAlias {
+  // The const name for the enum value
+  string name = 1;
+  // The the ordinal or index number of the enum value
+  int32 ordinal = 2;
+}
+
+extend google.protobuf.FieldOptions {
+  // Metadata describing the usage and behavior of API entity fields
+  EntityFieldMetadata entity_field_metadata = 78010001 [deprecated = true];
+
+  // Contains metadata about the thrift equivalent of a field. Used to help assert backward compatibility
+  // when mapping protobuf messages to and from their thrift counterpart.
+  ThriftFieldMetadata thrift_field_metadata = 78010002;
+}
+
+// The thing-api metadata for an entity field. This message is used to encapsulate
+// and document information about thing entities.
+//
+// EntityFieldMetadata in this file has been deprecated, use:
+//  https://github.snooguts.net/reddit/reddit-api-metadata
+message EntityFieldMetadata {
+  option deprecated = true;
+
+  // Level of sensitivity that the data stored in a field should be treated with.
+  enum SensitivityLevel {
+    option deprecated = true;
+
+    // This is a default vault used to convey the absence of a value.
+    SENSITIVITY_LEVEL_UNSPECIFIED = 0;
+
+    // Value to denote fields that should be treated as user PII
+    SENSITIVITY_LEVEL_PII = 1;
+
+    // Value to describe fields that are visible to reddit administrators but not
+    // publicly visible to users.
+    SENSITIVITY_LEVEL_ADMIN = 2;
+
+    // Value to describe fields that are visible to all users regardless of authentication status.
+    SENSITIVITY_LEVEL_PUBLIC = 3;
+  }
+
+  // The sensitivity level of the data stored in the annotated field
+  SensitivityLevel sensitivity_level = 1;
+
+  // An http url to the design doc which documents the purposed and introduction of this field to the API.
+  // New fields added by contributors must have this value populated
+  string design_doc_url = 2;
+
+  // The maximum duration the contents of this field can be cached or stored. After which, its value
+  // must be expunged. This is most commonly used to describe the retention period of fields which store PII.
+  google.protobuf.Duration max_retention = 3;
+}
+
+// Represents any metadata about the corresponding field in Thrift schema.
+message ThriftFieldMetadata {
+  // This field denotes if the legacy thrift representation of the annotated field was of type `set`. We use this field
+  // to ensure backward compatibility when mapping protobuf messages to and from their thrift counterpart since
+  // protobuf does not support the concept of `sets`.
+  bool is_set = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/blocking/v1/user_blocking_service.proto

@@ -0,0 +1,221 @@
+syntax = "proto3";
+
+package reddit.coreplatform.blocking.v1;
+
+import "google/protobuf/descriptor.proto";
+
+option go_package = "github.snooguts.net/reddit/thing-api/go/grpc/blocking/v1;blocking";
+option java_multiple_files = true;
+option java_outer_classname = "UserBlockingServiceProto";
+option java_package = "com.reddit.coreplatform.api.blocking.v1";
+
+// The user blocking service exposes APIs for interacting with user block lists
+service UserBlockingService {
+  // Add a user to the target users block list. This performs a bidirectional write, where the
+  // blockee is added to the users "blocking" list, and the blocker is added to the blockees
+  // "blocked by" list.
+  rpc BlockUser(BlockUserRequest) returns (BlockUserResponse) {
+    option idempotency_level = IDEMPOTENT;
+  }
+
+  // Remove a user to the target users block list. This performs a bidirectional write, where the
+  // blockee is removed from the users "blocking" list, and the blocker is removed from the blockees
+  // "blocked by" list.
+  rpc UnblockUser(UnblockUserRequest) returns (UnblockUserResponse) {
+    option idempotency_level = IDEMPOTENT;
+  }
+
+  // Retrieve the list of users that are blocking the requested user.
+  rpc GetBlockedByList(GetBlockedByListRequest) returns (GetBlockedByListResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+
+  // Retrieve the list of users that the requested user has blocked.
+  rpc GetBlockingList(GetBlockingListRequest) returns (GetBlockingListResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+
+  // Check if the requested user is blocked by or blocking any of the target account ids supplied
+  // This method is more performant than concurrently calling both `IsBlockedByUsers` and `IsBlockingUsers`
+  rpc HasAnyBlockingRelation(HasAnyBlockingRelationRequest) returns (HasAnyBlockingRelationResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+
+  // Check if the requested user is blocked by any of the target account ids supplied
+  rpc IsBlockedByUsers(IsBlockedByUsersRequest) returns (IsBlockedByUsersResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+
+  // Check if the requested user is blocking any of the target account ids supplied
+  rpc IsBlockingUsers(IsBlockingUsersRequest) returns (IsBlockingUsersResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+}
+
+// The type of blocking relation between two users
+enum BlockRelationType {
+  // No relation specific
+  BLOCK_RELATION_TYPE_UNSPECIFIED = 0;
+
+  // The relation type used when the subject user is blocking the target user
+  BLOCK_RELATION_TYPE_BLOCKING = 1;
+
+  // The relation type used when the subject user is blocked by the target user
+  BLOCK_RELATION_TYPE_BLOCKED_BY = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message BlockUserRequest {
+  //account_id
+  string account_id = 1;
+
+  //block_target
+  string block_target = 2;
+}
+
+// The response message returned by successful calls to the `BlockUser` rpc.
+message BlockUserResponse {
+  // The unique identifier of the relation entry between the blocker and blocked. This field will always be populated in responses where a block was successfully performed.
+  // Generally, this id has no special meaning outside of the context of core services and should be ignored by clients. Its purpose is mostly to help facilitate migrations in legacy systems which depend blocking implementation details.
+  // Originally added to support R2 blocking migrations due to the way R2 persists blocks in its cache.
+  int64 relation_id = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockedAccountIdsResponse {
+  //blocked_account_ids
+  repeated string blocked_account_ids = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockedByAccountIdsResponse {
+  //blocking_account_ids
+  repeated string blocking_account_ids = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockedByListRequest {
+  //account_id
+  string account_id = 1;
+
+  //cursor
+  string cursor = 2;
+
+  //limit
+  int32 limit = 3;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockedByListResponse {
+  //blocked_by
+  repeated string blocked_by = 1;
+
+  //cursor
+  string cursor = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockedIdsForAccountIdsResponse {
+  //account_id_to_blocked_account_ids
+  map<string, BlockedAccountIdList> account_id_to_blocked_account_ids = 1;
+  /* @exclude No documentation present when converted from Thrift to Proto */
+  message BlockedAccountIdList {
+    /* @exclude No documentation present when converted from Thrift to Proto */
+    repeated string blocked_account_ids = 1;
+  }
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockerAccountIdsResponse {
+  //account_ids
+  repeated string account_ids = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockingListRequest {
+  //account_id
+  string account_id = 1;
+
+  //cursor
+  string cursor = 2;
+
+  //limit
+  int32 limit = 3;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message GetBlockingListResponse {
+  //is_blocking
+  repeated string is_blocking = 1;
+
+  //cursor
+  string cursor = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message HasAnyBlockingRelationRequest {
+  //account_id
+  string account_id = 1;
+
+  //blocker_ids
+  repeated string blocker_ids = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message HasAnyBlockingRelationResponse {
+  //found_relations
+  repeated string found_relations = 1;
+
+  //relations_by_type
+  map<string, AccountIdList> relations_by_type = 2;
+
+  /* @exclude No documentation present when converted from Thrift to Proto */
+  message AccountIdList {
+    /* @exclude No documentation present when converted from Thrift to Proto */
+    repeated string account_id = 1;
+  }
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message IsBlockedByUsersRequest {
+  //account_id
+  string account_id = 1;
+
+  //blocker_ids
+  repeated string blocker_ids = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message IsBlockedByUsersResponse {
+  // The is_blocked_by field contains the subset of blocker_ids supplied which are blocking the account_id supplied.
+  // This list can potentially be empty.
+  repeated string is_blocked_by = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message IsBlockingUsersRequest {
+  //account_id
+  string account_id = 1;
+
+  //users
+  repeated string users = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message IsBlockingUsersResponse {
+  // The is_blocking field contains the subset of account ids supplied which are blocked by the account_id supplied.
+  // This list can potentially be empty.
+  repeated string is_blocking = 1;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message UnblockUserRequest {
+  //account_id
+  string account_id = 1;
+
+  //unblock_target
+  string unblock_target = 2;
+}
+
+/* @exclude No documentation present when converted from Thrift to Proto */
+message UnblockUserResponse {}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/callback/v1/callback_service.proto

@@ -0,0 +1,92 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.callback.v1;
+
+import "google/protobuf/any.proto";
+import "google/protobuf/duration.proto";
+import "reddit/coreplatform/cloudroutines/event/v1/event.proto";
+import "reddit/coreplatform/events/cloudevent/v1/cloudevent.proto";
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/callbackpb/v1;callbackpb";
+
+// RPC Service for working with Cloudroutines callbacks
+service CallbackService {
+  // Invoke makes an RPC call to the user's registered callback in their application
+  rpc Invoke(InvokeRequest) returns (InvokeResponse) {
+    option idempotency_level = IDEMPOTENT;
+  }
+
+  // TODO(marco.ferrer):12/11/23 we may want to add an RPC that the cloudroutines server can
+  // call when a consumer is in trouble or didnt like the result returned by the callback server
+  // then the sdk can record metrics or change application health, or deregister the callback.
+}
+
+// Request message containing the event to be processed by the user's registered callback
+message InvokeRequest {
+  // CloudEvent compliant event payload
+  reddit.coreplatform.events.cloudevent.v1.CloudEvent event = 1;
+  // Name of the callback function to be invoked
+  string callback_name = 2;
+}
+
+// Response message containing the user's registered callback response after processing an event
+message InvokeResponse {
+  OperationResult result = 1;
+}
+
+// OperationResult represents the result of a Cloudroutines operation, currently only a publication result
+message OperationResult {
+  oneof result {
+    Publication publication = 1;
+  }
+
+  // Publication represents a result of a Cloudroutines operation, consisting of a protobuf message
+  // and message route of the protobuf message
+  message Publication {
+    google.protobuf.Any message = 1;
+    reddit.coreplatform.cloudroutines.event.v1.MessageRoute message_route = 2;
+  }
+}
+
+// A finite set of policies which inform the Cloudroutines server on how to react to an error returned by the SDK server.
+message FailurePolicy {
+  // Undefined is the default error policy attached to all status errors when no policy was explicitly set
+  // by the user. This policy message enables the Cloudroutines server to detect when errors are surfaced
+  // from the client vs the network infrastructure.
+  message Undefined {}
+
+  // RetryAfter is the failure policy that indicates a message should be retried after the specified duration.
+  // This is the default failure policy applied if no failure policy is found on the callback error.
+  message RetryAfter {
+    google.protobuf.Duration duration = 1;
+  }
+
+  // BlockExecutionis the failure policy that does a best effort attempt at blocking further execution
+  // from the current message. Manual intervention is required.
+  message BlockExecution {
+    string reason = 1;
+  }
+
+  // Skip is the failure policy that indicates the current message can be dropped.
+  message Skip {
+    string reason = 1;
+  }
+
+  // DeadLetterQueue is the failure policy that adds the current message to a DLQ. The message routing
+  // can be set, otherwise defaults will be used based on the message.
+  message DeadLetterQueue {
+    string reason = 1;
+
+    // Message route allows a user to configure the destination for the DLQ message. If no route is defined,
+    // the SDK will infer the default route based on the message's protobuf fullname, eg. `dlq_{proto_full_name}`.
+    reddit.coreplatform.cloudroutines.event.v1.MessageRoute message_route = 2;
+  }
+
+  oneof policy {
+    Undefined undefined = 1;
+    RetryAfter retry_after = 2;
+    BlockExecution block_execution = 3;
+    Skip skip = 4;
+    DeadLetterQueue dead_letter_queue = 5;
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/event/v1/event.proto

@@ -0,0 +1,52 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.event.v1;
+
+import "google/protobuf/descriptor.proto";
+import "reddit/coreplatform/cloudroutines/workerpool/v1/workerpool.proto";
+import "validate/validate.proto";
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/eventpb/v1;eventpb";
+
+extend google.protobuf.MessageOptions {
+  EventMessageMetadata message = 78110999;
+}
+
+extend google.protobuf.FieldOptions {
+  EventFieldMetadata field = 78110999;
+}
+
+message EventMessageMetadata {
+  string default_topic = 1;
+  repeated reddit.coreplatform.cloudroutines.workerpool.v1.WorkerPool.Source publication_source_whitelist = 2;
+}
+
+message EventFieldMetadata {
+  bool sharding_identifier = 1;
+  string sharding_field_path = 2;
+}
+
+message MessageRoute {
+  // Cluster URI is optional. Defaults to the same cluster as the original protobuf message.
+  // This will be mapped internally to the correct publisher.
+  optional string cluster_uri = 1 [(validate.rules).string = {
+    // TODO: figure out the regex on :/?.&=[]
+    // pattern: "^[-_a-zA-Z0-9]+$",
+    min_len: 1
+    max_len: 64
+  }];
+
+  // Topic is optional. Defaults to `dlq_{proto_full_name}`.
+  optional string topic = 2 [(validate.rules).string = {
+    pattern: "^[-_a-zA-Z0-9]+$"
+    min_len: 1
+    max_len: 255
+  }];
+
+  // Partitioning value is optional. Defaults to the annotated field on the original protobuf message.
+  optional string partitioning_value = 3 [(validate.rules).string = {
+    pattern: "^[-_.a-zA-Z0-9]+$"
+    min_len: 1
+    max_len: 255
+  }];
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/experimental/v1/experimental.proto

@@ -0,0 +1,71 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.experimental.v1;
+
+import "google/protobuf/duration.proto";
+import "validate/validate.proto";
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/experimental/v1;experimentalpb";
+
+// Ensures that messages are processed in the strict order they are received.
+// This guarantees the sequence of message execution but may reduce throughput.
+// This is the default ordering if not specified, so it is not necessary to set this explicitly.
+//
+// *Note: If you're using the Python SDK, then KeyMessageOrdering is the default ordering.
+message StrictMessageOrdering {}
+
+// Enables out-of-order message execution.
+// Messages are batched and processed concurrently, increasing throughput but not guaranteeing order of receipt.
+message LooseMessageOrdering {}
+
+// Messages are processed concurrently, similar to LooseMessageOrdering, improving throughput.
+// However, messages with the same Kafka partitioning key will be processed in the order they arrive in.
+// This allows for controlled parallel processing with guarantees on order based on specific keys.
+//
+// *Note: This is the default ordering if not specified when using the Python SDK.
+message KeyMessageOrdering {}
+
+// Wrapper struct for all client alert configurations.
+message AlertConfig {
+  string sdk_version = 1;
+  optional ConsumerLagAlertConfig consumer_lag_alert_config = 2;
+}
+
+// Alert configuration for consumer lag. If the entire struct is left blank, the stated defaults are applied; otherwise, all fields must be set.
+// Currently, this is based off of Burrow's consumer lag metric.
+message ConsumerLagAlertConfig {
+  // Whether or not the alert is disabled.
+  // Defaults to false.
+  bool disabled = 1;
+
+  // The number of messages the consumer group needs to lag by for the alert to fire.
+  // Defaults to 25000.
+  int64 threshold = 2;
+
+  // How long the alert threshold must be sustained for the alert to fire.
+  // Defaults to 5 minutes. Maximum of 30 minutes.
+  google.protobuf.Duration threshold_duration = 3;
+
+  // Infrared v2 reddit-component name to route the alert to (see https://atlas.snooguts.net/catalog/default/component).
+  // Defaults to an empty value, which will route the alert based on the client namespace.
+  string component_name = 4;
+}
+
+message ExperimentalCallbackOptions {
+  // Specifies the delivery order of messages.
+  // Defaults to strict ordering if unset.
+  oneof message_ordering {
+    StrictMessageOrdering strict_ordering = 1;
+    LooseMessageOrdering loose_ordering = 2;
+    KeyMessageOrdering key_ordering = 3;
+  }
+
+  // Wrapper type containing configuration for all client alerts.
+  AlertConfig alert_config = 4;
+
+  // URI representing an arbitrary data source to consume messages from.
+  optional string data_source_uri = 5 [(validate.rules).string = {
+    uri: true
+    max_len: 255
+  }];
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/interop/analytics/v1/analytics.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.interop.analytics.v1;
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/interop/analyticspb/v1;analyticspb";
+
+// A protobuf wrapper for reddit analytics events. Used as a support shim for older, loosely structured
+// event payloads.
+message AnalyticsEvent {
+  // The event payload.
+  bytes data = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/interop/generic/v1/generic.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.interop.generic.v1;
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/interop/genericpb/v1;genericpb";
+
+// A protobuf wrapper for unprocessed messages. Used as a support shim for events containing raw byte payloads.
+// DO NOT use this without first contacting #core-events in Slack to discuss your use case.
+message Message {
+  // The event payload.
+  bytes payload = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/loadbalancing/v1/loadbalancing.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.loadbalancing.v1;
+
+import "google/protobuf/duration.proto";
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/loadbalancingpb/v1;loadbalancingpb";
+
+// Configuration for slow start throttling performed by the server on new worker instances.
+message SlowStartConfig {
+  // The duration of the slow start window. This is the amount of time spent ramping traffic. At the start of the window
+  // traffic is throttled to `min_allow_rate`. At the end of the window, traffic will no longer be throttled.
+  // This value defaults to 15s.
+  google.protobuf.Duration window = 1;
+
+  // The factor used to increase the traffic allowed as the ramp window progresses. An aggression of `1` results in a
+  // linearly increasing allow rate.
+  float ramp_aggression = 2;
+
+  // This value determines how much traffic is allowed to proceed when max throttling is applied. Usually at the start of
+  // the window.
+  float min_allow_rate = 3;
+}
+
+// This message is attached to an error status when the request failed due to reaching the concurrency limit.
+message ConcurrencyLimitReached {
+  // We're not adding any fields for now.
+}
+
+// This message is attached to an error status when the request failed due to slow start throttling being applied.
+// When this error is encountered, the client should retry the request at some point in the future. The new request
+// will either get routed to another address with less throttling or the current address's allow rate has increased.
+message SlowStartThrottle {
+  // The address that is being throttled.
+  string address = 1;
+
+  // How long it has been since the worker server was started and entered the ready state.
+  google.protobuf.Duration worker_age = 2;
+
+  // The percentage of requests that are allowed to proceed for this upstream address. This is a float64
+  // between 0.0-1.0.
+  double allow_rate = 3;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/cloudroutines/metadata/v1/metadata.proto

@@ -0,0 +1,20 @@
+syntax = "proto3";
+
+package reddit.coreplatform.cloudroutines.metadata.v1;
+
+import "google/protobuf/descriptor.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "github.snooguts.net/reddit/cloudroutines/go/metadatapb/v1;metadatapb";
+
+extend google.protobuf.MessageOptions {
+  MessageMetadata cloudroutines = 78010999;
+}
+
+message MessageMetadata {
+  bool enabled = 1;
+
+  google.protobuf.Duration retention_period = 2;
+
+  int32 partition_qty = 3;
+}