@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/domains/v1/domains_metadata_service.proto

@@ -0,0 +1,101 @@
+syntax = "proto3";
+
+package reddit.coreplatform.domains.v1;
+
+import "validate/validate.proto";
+
+option go_package = "github.snooguts.net/reddit/thing-api/go/grpc/domains/v1;domains";
+option java_multiple_files = true;
+option java_outer_classname = "DomainsMetadataServiceProto";
+option java_package = "com.reddit.coreplatform.api.domains.v1";
+
+// The domains metadata service exposes APIs for fetching metadata related to domains
+service DomainsMetadataService {
+  // Check if the requested url has been banned at the domain-level and if it's
+  // publicly banned (shamed) or privately banned.
+  rpc GetDomainBanInfo(GetDomainBanInfoRequest) returns (GetDomainBanInfoResponse) {
+    option idempotency_level = NO_SIDE_EFFECTS;
+  }
+}
+
+// The ban status of the domain
+enum BanStatus {
+  // Either not banned or just unspecified
+  BAN_STATUS_UNSPECIFIED = 0;
+
+  // The domain has not been banned
+  BAN_STATUS_NOT_BANNED = 1;
+
+  // The domain has been banned, but that fact shouldn't be exposed to users
+  BAN_STATUS_PRIVATELY_BANNED = 2;
+
+  // The domain has been banned and we should let users actively know it's banned
+  BAN_STATUS_PUBLICLY_BANNED = 3;
+}
+
+// Ban status, message associated to a domain
+message DomainBanInfo {
+  // Ban status of this URL
+  BanStatus ban_status = 1;
+
+  // Ban message to be shown when trying to submit a url from that domain
+  string public_ban_message = 2;
+
+  // Internal ban info, for admins only
+  InternalDomainBanInfo internal_info = 3;
+}
+
+// All status associated with a given domain, for internal use by admins
+message InternalDomainBanInfo {
+  // Ban status of this domain without overriding based on regex
+  BanStatus original_ban_status = 1;
+
+  // Internal note written by the banning admin
+  string internal_ban_message = 2;
+
+  // Is the domain also prohibited in markdown links (in self posts, comments, messages)?
+  bool banned_in_markdown = 3;
+
+  // Is the domain also prohibited as an email?
+  bool banned_in_email = 4;
+
+  // Username of the banning admin
+  string banning_admin_username = 5;
+
+  // UTC time zone, string format "YYYY-MM-DD hh:mm"
+  string banned_at_timestamp = 6;
+
+  // If present, the ban only applies to URLs matching this regex
+  string url_regex = 7;
+
+  // Is the domain also prohibited from being manually approved by moderators?
+  bool prohibit_approval = 8;
+
+  // Inspector exemptions regex (matches anywhere)
+  string inspector_exemptions_regex = 9;
+}
+
+// Request argument for checking the url to see if the domain has been banned
+message GetDomainBanInfoRequest {
+  // The list of full urls to check for banned status
+  repeated string urls = 1 [(validate.rules).repeated = {
+    min_items: 1
+    max_items: 100
+    unique: true
+    items: {
+      string: {
+        min_len: 3
+        max_len: 2048
+      }
+    }
+  }];
+
+  // Whether internal info should be included
+  bool include_internal_info = 2;
+}
+
+// Response payload for if the url is part of a banned domain
+message GetDomainBanInfoResponse {
+  // A map of url to the ban status of that url's domain.
+  map<string, DomainBanInfo> ban_info_by_url = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/account/v1/account.proto

@@ -0,0 +1,56 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.account.v1;
+
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "reddit/coreplatform/account/v1/account.proto";
+import "reddit/coreplatform/events/common/v1/actor.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/account/v1;account";
+option java_multiple_files = true;
+option java_outer_classname = "AccountProto";
+option java_package = "com.reddit.coreplatform.events.account.v1";
+
+// An event which encapsulates a single instance of an account entity modification. A single update event is emitted
+// per account update, regardless of the number of attributes that are modified. This is not triggered on account
+// creation, but will be triggered on any subsequent changes to that account.
+message AccountUpdateEvent {
+  // An account thing entity. All fields on this account instance are eventually consistent, with the exception of those
+  // explicitly referenced by the `updated_fields` field of this message. Updated fields are always strongly consistent
+  // at the moment this event was emitted. Storage of the account model in systems external to core-platform must abide
+  // by the `max_retention` policy defined on any of its fields.
+  reddit.coreplatform.account.v1.Account account = 1;
+
+  // A field mask containing a list of all fields that were updated on the account in this event.
+  // Fields denoted in the field mask are guaranteed to be consistent at the time this event was triggered.
+  // The precision of this mask is limited to only the root fields on a account message. It it makes no guarantee to convey
+  // if or which nested fields may have changed during an update.
+  google.protobuf.FieldMask updated_fields = 2;
+
+  // The actor that triggered this event
+  reddit.coreplatform.events.common.v1.Actor updated_by = 3;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp updated_at = 4;
+
+  // The version ID of this account update. This is a monotonically increasing integer that is incremented
+  // on every update to this account. On overflow (after 2^31-1 updates), the version ID will reset to 0.
+  int32 version_id = 5;
+}
+
+// An event which encapsulates a single instance of a account entity creation. This event will not be triggered
+// on any subsequent changes to a account.
+message AccountCreateEvent {
+  // A account thing entity. The fields set on this account instance reflect a combination of the attributes supplied
+  // during the create and the default values for any unset fields. This is an exact representation of the entity at the
+  // time of creation. This event will not reflect any modifications made to a account immediately after creation.
+  // Storage of the account model in systems external to core-platform must abide by the `max_retention` policy defined
+  // on any of its fields.
+  reddit.coreplatform.account.v1.Account account = 1;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp created_at = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/account/v1/account_relations.proto

@@ -0,0 +1,93 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.account.v1;
+
+import "google/protobuf/timestamp.proto";
+import "reddit/coreplatform/account/v1/account_relations.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/account/v1;account";
+option java_multiple_files = true;
+option java_outer_classname = "AccountRelationsProto";
+option java_package = "com.reddit.coreplatform.events.account.v1";
+
+// An event which encapsulates a single instance of a friend relation entity creation or deletion. A change event
+// is emitted when a friend relationship is either created or deleted. A friend relation has no attributes and can
+// only be created or deleted and not modified. In the future if attributes get added to the friend relation,
+// the change event will start to include update event as well.
+message FriendRelationChangeEvent {
+  // An event which encapsulates a single friend relation create.
+  message Create {
+    // The friend relation entity created.
+    reddit.coreplatform.account.v1.FriendRelation relation = 1;
+
+    // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+    // any relevant datastore.
+    google.protobuf.Timestamp created_at = 3;
+  }
+
+  // An event which encapsulates a single friend relation delete.
+  message Delete {
+    // The friend relation entity deleted.
+    reddit.coreplatform.account.v1.FriendRelation relation = 1;
+
+    // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+    // any relevant datastore.
+    google.protobuf.Timestamp deleted_at = 3;
+  }
+
+  // A change event is either a create event or a delete event depending on the action that triggered
+  // the event.
+  oneof change {
+    // Event representing a friend relation create. In a change event representing a relationship create,
+    // only create event will be present.
+    Create create = 1;
+
+    // Event representing a friend relation delete. In a change event representing a relationship delete,
+    // only delete event will be present.
+    Delete delete = 2;
+  }
+
+  // Reserved for exposing the actor that triggered this event.
+  reserved 3;
+}
+
+// An event which encapsulates a single instance of a block relation entity create or delete. A change event
+// is emitted when a block relation is created or deleted. A block relation can't be modified as it has no
+// data attributes. In the future if attributes get added to the block relation, the change event will start to
+// include update event as well.
+message BlockRelationChangeEvent {
+  // An event which encapsulates a single block relation create.
+  message Create {
+    // The blocking relation entity created.
+    reddit.coreplatform.account.v1.BlockRelation relation = 1;
+
+    // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+    // any relevant datastore.
+    google.protobuf.Timestamp created_at = 3;
+  }
+
+  // An event which encapsulates a single block relation delete.
+  message Delete {
+    // The block relation entity deleted.
+    reddit.coreplatform.account.v1.BlockRelation relation = 1;
+
+    // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+    // any relevant datastore.
+    google.protobuf.Timestamp deleted_at = 3;
+  }
+
+  // A change event is either a create event or a delete event depending on the action that triggered
+  // the event.
+  oneof change {
+    // Event representing a block relation create. In a change event representing a relationship create,
+    // only create event will be present.
+    Create create = 1;
+
+    // Event representing a block relation delete. In a change event representing a relationship delete,
+    // only delete event will be present.
+    Delete delete = 2;
+  }
+
+  // Reserved for exposing the actor that triggered this event.
+  reserved 3;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/cloudevent/v1/cloudevent.proto

@@ -0,0 +1,67 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.cloudevent.v1;
+
+import "google/protobuf/any.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/cloudevent/v1;cloudevent";
+option java_multiple_files = true;
+option java_outer_classname = "CloudeventProto";
+option java_package = "com.reddit.coreplatform.events.cloudevent.v1";
+
+// this entire file is copied from https://github.com/cloudevents/sdk-go/blob/main/binding/format/protobuf/v2/pb/cloudevent.proto
+// unfortunately, the package and option values need to be updated and we need to build the python binding, which doesn't exist
+
+// CloudEvent is copied from
+// https://github.com/cloudevents/spec/blob/master/protobuf-format.md.
+message CloudEvent {
+  // Unique event identifier.
+  string id = 1;
+  // URI of the event source.
+  string source = 2;
+  // Version of the spec in use.
+  string spec_version = 3;
+  // Event type identifier.
+  string type = 4;
+
+  // Optional & Extension Attributes
+  map<string, CloudEventAttributeValue> attributes = 5;
+
+  // CloudEvent Data (Bytes, Text, or Proto)
+  oneof data {
+    // If the event is binary data then the datacontenttype attribute
+    // should be set to an appropriate media-type.
+    bytes binary_data = 6;
+    // If the event is string data then the datacontenttype attribute
+    // should be set to an appropriate media-type such as application/json.
+    string text_data = 7;
+    // If the event is a protobuf then it must be encoded using this Any
+    // type. The datacontenttype attribute should be set to
+    // application/protobuf and the dataschema attribute set to the message
+    // type.
+    google.protobuf.Any proto_data = 8;
+  }
+}
+
+// CloudEventAttribute enables extensions to use any of the seven allowed
+// data types as the value of an envelope key.
+message CloudEventAttributeValue {
+  // The value can be any one of these types.
+  oneof attr {
+    // Boolean value.
+    bool ce_boolean = 1;
+    // Integer value.
+    int32 ce_integer = 2;
+    // String value.
+    string ce_string = 3;
+    // Byte string value.
+    bytes ce_bytes = 4;
+    // URI value.
+    string ce_uri = 5;
+    // URI reference value.
+    string ce_uri_ref = 6;
+    // Timestamp value.
+    google.protobuf.Timestamp ce_timestamp = 7;
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/comments/v1/comments.proto

@@ -0,0 +1,59 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.comments.v1;
+
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "reddit/coreplatform/comments/v1/comments.proto";
+import "reddit/coreplatform/events/common/v1/actor.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/comments/v1;comments";
+option java_multiple_files = true;
+option java_outer_classname = "CommentsProto";
+option java_package = "com.reddit.coreplatform.events.comments.v1";
+
+// An event which encapsulates a single instance of a comment entity modification. A single update event is emitted
+// per comment update, regardless of the number of attributes that are modified. This is not triggered on comment
+// creation, but will be triggered on any subsequent changes to that comment.
+message CommentUpdateEvent {
+  // A comment thing entity. All fields on this comment instance are eventually consistent, with the exception of those
+  // explicitly referenced by the `updated_fields` field of this message. Updated fields are always strongly consistent
+  // at the moment this event was emitted. Storage of the comment model in systems external to core-platform must abide
+  // by the `max_retention` policy defined on any of its fields.
+  reddit.coreplatform.comments.v1.Comment comment = 1;
+
+  // A field mask containing a list of all fields that were updated on the comment in this event.
+  // Fields denoted in the field mask are guaranteed to be consistent at the time this event was triggered.
+  // The precision of this mask is limited to only the root fields on a comment message. It it makes no guarantee to convey
+  // if or which nested fields may have changed during an update.
+  google.protobuf.FieldMask updated_fields = 2;
+
+  // The actor that triggered this event
+  reddit.coreplatform.events.common.v1.Actor updated_by = 3;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp updated_at = 4;
+
+  // The version ID of this comment update. This is a monotonically increasing integer that is incremented
+  // on every update to this comment. On overflow (after 2^31-1 updates), the version ID will reset to 0.
+  int32 version_id = 5;
+}
+
+// An event which encapsulates a single instance of a comment entity creation. This event will not be triggered
+// on any subsequent changes to a comment.
+message CommentCreateEvent {
+  // A comment thing entity. The fields set on this comment instance reflect a combination of the attributes supplied
+  // during the create and the default values for any unset fields. This is an exact representation of the entity at the
+  // time of creation. This event will not reflect any modifications made to a comment immediately after creation.
+  // Storage of the comment model in systems external to core-platform must abide by the `max_retention` policy defined
+  // on any of its fields.
+  reddit.coreplatform.comments.v1.Comment comment = 1;
+
+  // The actor that triggered this event
+  reddit.coreplatform.events.common.v1.Actor created_by = 2;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp created_at = 3;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/common/v1/actor.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.common.v1;
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/common/v1";
+option java_multiple_files = true;
+option java_outer_classname = "ActorProto";
+option java_package = "com.reddit.coreplatform.events.common.v1";
+
+// A reference to an actor which initiated an action. In the case of events, this
+// is usually the user or service account which performed the action that resulted
+// in the attributed event being emitted.
+message Actor {
+  // The entity which triggered an event
+  oneof entity {
+    // The service used to trigger an event. This field will be propagated if the service
+    // account is acting on behalf of itself OR performing an action on behalf of a user.
+    Service service = 1;
+
+    // The user which triggered this action. This field will NOT be populated for actions performed by a service account
+    // acting on behalf of a user. The `service` field will be populated instead.
+    User user = 2;
+  }
+
+  // A message describing a user actor
+  message User {
+    // The id of the user which triggered this action. If the action was trigger by a service account on behalf
+    // of a user, then this field will be populated.
+    string id = 1;
+  }
+
+  // A message describing a service actor
+  message Service {
+    // The service account id used to trigger an event. This id will match the service name used in the edge
+    // context which performed the action.
+    string service_account_id = 1;
+
+    // The id of the user this service assumed when performing the action which triggered an event. If the service
+    // was acting as a super user, then this field will be set to the const `__super__`. If no special permissions
+    // were invoked and the service acted on behalf of itself, then this field will be empty.
+    string on_behalf_of_user = 2;
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/common/v1/event_attr_key.proto

@@ -0,0 +1,19 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.common.v1;
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/common/v1";
+option java_multiple_files = true;
+option java_outer_classname = "EventAttrKeyProto";
+option java_package = "com.reddit.coreplatform.events.common.v1";
+
+// Enums to be used as keys for core event related attributes on the CloudEvent
+// These are deprecated since the string format is not compatible with the CloudEvent attribute key specification
+enum EventAttrKey {
+  // Default unspecified key, do not use unless catching default cases
+  EVENT_ATTR_KEY_UNSPECIFIED = 0 [deprecated = true];
+  // EventContext key
+  EVENT_ATTR_KEY_EVENTCONTEXT = 1 [deprecated = true];
+  // Event_Extensions key
+  EVENT_ATTR_KEY_EVENT_EXTENSIONS = 2 [deprecated = true];
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/common/v1/event_extensions.proto

@@ -0,0 +1,26 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.common.v1;
+
+import "google/protobuf/any.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/common/v1";
+option java_multiple_files = true;
+option java_outer_classname = "EventExtensionsProto";
+option java_package = "com.reddit.coreplatform.events.common.v1";
+
+// Wrapper for vote metadata values, used for CloudEvent EventExtensions
+message VoteMetadata {
+  // Field for upvotes
+  int32 ups = 1;
+  // Field for downvotes
+  int32 downs = 2;
+}
+
+// EventExtensions are optionally attached on a CloudEvent's attributes field and are a way to pass contextual metadata
+// of the event to downstream consumers
+message EventExtensions {
+  // Extensions are a map of the fully qualified protobuf name to a protobuf payload containing metadata;
+  // payloads above a certain size may be truncated and validation of payloads is left to the end user
+  map<string, google.protobuf.Any> extensions = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/common/v1/eventcontext.proto

@@ -0,0 +1,69 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.common.v1;
+
+import "reddit/coreplatform/events/common/v1/actor.proto";
+import "reddit/coreplatform/sensitive/v1/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/common/v1";
+option java_multiple_files = true;
+option java_outer_classname = "EventcontextProto";
+option java_package = "com.reddit.coreplatform.events.common.v1";
+
+// wrapper for geolocation metadata values on the event context
+message Geolocation {
+  // two-character ISO 3166-1 country code where the request originated from
+  string country_code = 1;
+}
+
+// wrapper for device metadata values on the event context
+message Device {
+  // device ID of the request
+  string id = 1;
+}
+
+// wrapper for locale metadata values on the event context
+message Locale {
+  // IETF language code for the client of the request
+  string code = 1;
+}
+
+// wrapper for OAuth2 client values on the event context
+message OAuthClient {
+  // OAuth client ID of the request
+  string id = 1;
+  // OAuth client type of the request
+  string type = 2;
+}
+
+// wrapper for origin values on the event context
+message OriginService {
+  // name of the service that serves as the origin of the request
+  string name = 1;
+}
+
+// ClientIP is a wrapper for the client IP that affected the change represented by this event
+message ClientIP {
+  // client IP address
+  string value = 1;
+}
+
+// EventContext containing metadata values taken from the edge context used when the event was created
+message EventContext {
+  // geolocation metadata values
+  Geolocation geolocation = 1;
+  // device metadata values
+  Device device = 2;
+  // locale metadata values
+  Locale locale = 3;
+  // oauth client metadata values
+  OAuthClient oauth_client = 4;
+  // origin service metadata values
+  OriginService origin_service = 5;
+  // request ID
+  string request_id = 6;
+  // client IP Address
+  optional reddit.coreplatform.sensitive.v1.SensitiveString client_ip = 7;
+  // actor metadata
+  reddit.coreplatform.events.common.v1.Actor actor = 8;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/reddit/coreplatform/events/links/v1/links.proto

@@ -0,0 +1,59 @@
+syntax = "proto3";
+
+package reddit.coreplatform.events.links.v1;
+
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "reddit/coreplatform/events/common/v1/actor.proto";
+import "reddit/coreplatform/links/v1/links.proto";
+
+option go_package = "github.snooguts.net/reddit/core-platform-events/go/links/v1;links";
+option java_multiple_files = true;
+option java_outer_classname = "LinksProto";
+option java_package = "com.reddit.coreplatform.events.links.v1";
+
+// An event which encapsulates a single instance of a link entity modification. A single update event is emitted
+// per link update, regardless of the number of attributes that are modified. This is not triggered on link
+// creation, but will be triggered on any subsequent changes to that link.
+message LinkUpdateEvent {
+  // A link thing entity. All fields on this link instance are eventually consistent, with the exception of those
+  // explicitly referenced by the `updated_fields` field of this message. Updated fields are always strongly consistent
+  // at the moment this event was emitted. Storage of the link model in systems external to core-platform must abide
+  // by the `max_retention` policy defined on any of its fields.
+  reddit.coreplatform.links.v1.Link link = 1;
+
+  // A field mask containing a list of all fields that were updated on the link in this event.
+  // Fields denoted in the field mask are guaranteed to be consistent at the time this event was triggered.
+  // The precision of this mask is limited to only the root fields on a link message. It it makes no guarantee to convey
+  // if or which nested fields may have changed during an update.
+  google.protobuf.FieldMask updated_fields = 2;
+
+  // The actor that triggered this event
+  reddit.coreplatform.events.common.v1.Actor updated_by = 3;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp updated_at = 4;
+
+  // The version ID of this link update. This is a monotonically increasing integer that is incremented
+  // on every update to this link. On overflow (after 2^31-1 updates), the version ID will reset to 0.
+  int32 version_id = 5;
+}
+
+// An event which encapsulates a single instance of a link entity creation. This event will not be triggered
+// on any subsequent changes to a link.
+message LinkCreateEvent {
+  // A link thing entity. The fields set on this link instance reflect a combination of the attributes supplied
+  // during the create and the default values for any unset fields. This is an exact representation of the entity at the
+  // time of creation. This event will not reflect any modifications made to a link immediately after creation.
+  // Storage of the link model in systems external to core-platform must abide by the `max_retention` policy defined
+  // on any of its fields.
+  reddit.coreplatform.links.v1.Link link = 1;
+
+  // The actor that triggered this event
+  reddit.coreplatform.events.common.v1.Actor created_by = 2;
+
+  // The UTC timestamp of the instance at which this event was triggered and successfully persisted to
+  // any relevant datastore.
+  google.protobuf.Timestamp created_at = 3;
+}