@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/devvit/events/v1alpha/events.proto

@@ -0,0 +1,446 @@
+syntax = "proto3";
+
+package devvit.events.v1alpha;
+
+import "devvit/options/options.proto";
+import "devvit/reddit/v2alpha/commentv2.proto";
+import "devvit/reddit/v2alpha/postv2.proto";
+import "devvit/reddit/v2alpha/subredditv2.proto";
+import "devvit/reddit/v2alpha/userv2.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/devplatform-api/go/grpc/devvit/events/v1alpha";
+option java_package = "com.reddit.devvit.actor.events";
+
+enum EventSource {
+  UNKNOWN_EVENT_SOURCE = 0;
+  USER = 1;
+  ADMIN = 2;
+  MODERATOR = 3;
+}
+
+enum DeletionReason {
+  UNSPECIFIED_DELETION_REASON = 0;
+  SPAM = 1;
+  LEGAL = 2;
+  OTHER = 3;
+  UNKNOWN = 4;
+  EXPLICIT_CONTENT = 5;
+}
+
+message PostSubmit {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "submit"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message PostCreate {
+  option (devvit.options.trigger) = {
+    source: "firehose"
+    action: "create"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message PostUpdate {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "edit"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  string previous_body = 3 [(devvit.options.v2_event_path) = "edit.previous_body_text"];
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message PostReport {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "report"
+    noun: "post"
+  };
+
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "report"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+
+  // Deprecated - preserving privacy for the user reporting post
+  reserved 2;
+  reserved "reporter";
+
+  string reason = 3 [(devvit.options.v2_event_path) = "action_info.reason"];
+}
+
+message PostFlairUpdate {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "apply_flair"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10 [(devvit.options.secondary_hydration_path) = "post.subreddit_id"];
+}
+
+message PostDelete {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "delete"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "remove"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "takedown"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "purge"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "nuke"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "remove"
+    noun: "post"
+  };
+
+  string post_id = 1 [(devvit.options.v2_event_path) = "post.id"];
+  google.protobuf.Timestamp deleted_at = 2 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+
+  devvit.reddit.v2alpha.UserV2 author = 3;
+
+  google.protobuf.Timestamp created_at = 4 [(devvit.options.v2_event_path) = "post.created_timestamp"];
+  EventSource source = 5;
+
+  DeletionReason reason = 6;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message PostApprove {
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "unremove"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "approve"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  google.protobuf.Timestamp approved_at = 2 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+  devvit.reddit.v2alpha.UserV2 author = 3 [(devvit.options.v2_event_path) = "target_user.id"];
+  EventSource source = 5;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message CommentApprove {
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "unremove"
+    noun: "comment"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "approve"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1;
+  devvit.reddit.v2alpha.PostV2 post = 2;
+  google.protobuf.Timestamp approved_at = 3 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+  devvit.reddit.v2alpha.UserV2 author = 4 [(devvit.options.v2_event_path) = "target_user.id"];
+  EventSource source = 6;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message CommentSubmit {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "submit"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  devvit.reddit.v2alpha.PostV2 post = 3 [(devvit.options.v2_event_path) = "comment.post_id"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message CommentCreate {
+  option (devvit.options.trigger) = {
+    source: "firehose"
+    action: "create"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  devvit.reddit.v2alpha.PostV2 post = 3 [(devvit.options.v2_event_path) = "comment.post_id"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message CommentUpdate {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "edit"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  devvit.reddit.v2alpha.PostV2 post = 3 [(devvit.options.v2_event_path) = "comment.post_id"];
+  string previous_body = 4 [(devvit.options.v2_event_path) = "edit.previous_body_text"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message CommentReport {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "report"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+
+  // Deprecated - preserving privacy for the user reporting comment
+  reserved 2;
+  reserved "reporter";
+
+  string reason = 3 [(devvit.options.v2_event_path) = "action_info.reason"];
+}
+
+message CommentDelete {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "delete"
+    noun: "comment"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "remove"
+    noun: "comment"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "takedown"
+    noun: "comment"
+  };
+  option (devvit.options.trigger) = {
+    source: "admin"
+    action: "purge"
+    noun: "comment"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "remove"
+    noun: "comment"
+  };
+
+  string comment_id = 1 [(devvit.options.v2_event_path) = "comment.id"];
+  string post_id = 2 [(devvit.options.v2_event_path) = "comment.post_id"];
+  string parent_id = 3 [(devvit.options.v2_event_path) = "comment.parent_id"];
+  google.protobuf.Timestamp deleted_at = 4 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+
+  devvit.reddit.v2alpha.UserV2 author = 5;
+
+  google.protobuf.Timestamp created_at = 6 [(devvit.options.v2_event_path) = "comment.created_timestamp"];
+  EventSource source = 7;
+  DeletionReason reason = 8;
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message SubredditSubscribe {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "subscribe"
+    noun: "subreddit"
+  };
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 1;
+  devvit.reddit.v2alpha.UserV2 subscriber = 2;
+}
+
+message AppInstall {
+  option (devvit.options.trigger) = {
+    source: "devplatform"
+    action: "install"
+    noun: "app"
+  };
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 1;
+  devvit.reddit.v2alpha.UserV2 installer = 2;
+}
+
+message AppUpgrade {
+  option (devvit.options.trigger) = {
+    source: "devplatform"
+    action: "uninstall"
+    noun: "app"
+  };
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 1;
+  devvit.reddit.v2alpha.UserV2 installer = 2;
+}
+
+message AccountDelete {
+  option (devvit.options.trigger) = {
+    source: "backend"
+    action: "deactivate"
+    noun: "user"
+  };
+
+  string user_id = 1 [(devvit.options.v2_event_path) = "user.id"];
+  google.protobuf.Timestamp deleted_at = 2 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+
+  devvit.reddit.v2alpha.UserV2 user = 3;
+}
+
+message Vote {
+  google.protobuf.Timestamp updated_at = 4;
+
+  devvit.reddit.v2alpha.CommentV2 comment = 5;
+  devvit.reddit.v2alpha.PostV2 post = 6;
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 7;
+  float upvote_ratio = 8;
+  int32 score = 9;
+
+  // removed fields
+  reserved 1 to 3;
+  reserved "thing_id", "upvotes", "downvotes";
+}
+
+message AutomoderatorFilterPost {
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "filter"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1 [(devvit.options.v2_event_path) = "target_post.id"];
+
+  google.protobuf.Timestamp removed_at = 2 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+
+  string reason = 3 [(devvit.options.v2_event_path) = "action_info.reason"];
+
+  string author = 4 [(devvit.options.v2_event_path) = "target_user.id"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 5;
+}
+
+message AutomoderatorFilterComment {
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "filter"
+    noun: "comment"
+  };
+
+  devvit.reddit.v2alpha.CommentV2 comment = 1 [(devvit.options.v2_event_path) = "target_comment.id"];
+
+  google.protobuf.Timestamp removed_at = 2 [(devvit.options.v2_event_path) = "endpoint_timestamp"];
+
+  string reason = 3 [(devvit.options.v2_event_path) = "action_info.reason"];
+
+  string author = 4 [(devvit.options.v2_event_path) = "target_user.id"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 5;
+}
+
+message PostNsfwUpdate {
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "mark_nsfw"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "marknsfw"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "mark_nsfw"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "unmark_nsfw"
+    noun: "post"
+  };
+
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  bool is_nsfw = 3 [(devvit.options.v2_event_path) = "post.nsfw"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}
+
+message PostSpoilerUpdate {
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "mark_spoiler"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "moderator"
+    action: "unmark_spoiler"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "mark_spoiler"
+    noun: "post"
+  };
+  option (devvit.options.trigger) = {
+    source: "automoderator"
+    action: "unmark_spoiler"
+    noun: "post"
+  };
+  devvit.reddit.v2alpha.PostV2 post = 1;
+  devvit.reddit.v2alpha.UserV2 author = 2;
+  bool is_spoiler = 4 [(devvit.options.v2_event_path) = "post.spoiler"];
+
+  devvit.reddit.v2alpha.SubredditV2 subreddit = 10;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/events/v1alpha/realtime.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package devvit.events.v1alpha;
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/struct.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/events";
+option java_package = "com.reddit.devvit.actor.events";
+
+service Realtime {
+  rpc Subscribe(RealtimeRequest) returns (stream RealtimeEvent) {}
+  rpc Send(RealtimeEvent) returns (google.protobuf.Empty) {}
+}
+
+message RealtimeRequest {
+  repeated string channels = 1;
+}
+
+message RealtimeEvent {
+  // The channel that received the message
+  string channel = 1;
+  // The data that was received
+  google.protobuf.Struct data = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/events/v1alpha/wqcleanup.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+
+package devvit.events.v1alpha;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/events";
+option java_package = "com.reddit.devvit.actor.events";
+
+message WqCleanup {
+  uint64 cursor = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/cache/v1alpha/cache.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+
+package devvit.gateway.cache.v1alpha;
+
+import "reddit/coreplatform/cloudroutines/event/v1/event.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/gateway/cache";
+
+// This proto definition is used to publish/handle events for the global-caching Cloudroutine.
+message CacheEntry {
+  string key = 1 [(reddit.coreplatform.cloudroutines.event.v1.field) = {sharding_identifier: true}];
+  string value = 2;
+  int64 ttl = 3;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/custom_post_snapshot.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package devvit.gateway;
+
+import "devvit/gql/snapshot.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/gateway";
+
+service CustomPostSnapshotResolver {
+  rpc GetCustomPostSnapshot(CustomPostSnapshotRequest) returns (devvit.gql.CustomPostSnapshot);
+}
+
+message CustomPostSnapshotRequest {
+  string snapshot_id = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/playtest_subreddit/playtest_subreddit.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package devvit.gateway.playtest_subreddit;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/gateway/playtestsubreddit";
+
+service PlaytestSubreddit {
+  // Create a playtest subreddit for an app
+  rpc CreatePlaytestSubreddit(CreatePlaytestSubredditRequest) returns (CreatePlaytestSubredditResponse);
+}
+
+message CreatePlaytestSubredditRequest {
+  // Name of the app for which to create the playtest subreddit
+  string app_name = 1;
+  // T2 of the developer's reddit account to add them as a moderator
+  string dev_user_id = 2;
+}
+
+message CreatePlaytestSubredditResponse {
+  // ID of the subreddit created
+  string subreddit_id = 1;
+  // Name of the subreddit created
+  string subreddit_name = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/resolvers.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package devvit.gateway;
+
+import "devvit/gql/subreddit_metadata.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/gateway";
+
+service SubredditMetadataResolver {
+  rpc GetSubredditMetadata(SubredditMetadataRequest) returns (devvit.gql.DevvitSubredditMetadata);
+}
+
+message SubredditMetadataRequest {
+  string subreddit = 1; // t5_ subreddit id
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/utils/v1alpha/app_health.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package devvit.gateway.utils.v1alpha;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/utilities";
+
+message CheckHealthRequest {
+  string app_name = 1;
+  string app_version = 2;
+}
+
+message CheckHealthResponse {
+  optional float health_score = 1;
+}
+
+service AppHealth {
+  rpc CheckHealth(CheckHealthRequest) returns (CheckHealthResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/utils/v1alpha/utilities.proto

@@ -0,0 +1,58 @@
+syntax = "proto3";
+
+package devvit.gateway.utils.v1alpha;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/utilities";
+
+message AccessKeyPurgeRequest {
+  string user_id = 1; // the t2_ user id
+  bool include_refresh = 2; // also purge the refresh key
+}
+
+message InstallationsPurgeRequest {
+  string subreddit = 1; // t5 subreddit id
+}
+
+message InstallationPurgeRequest {
+  string installation_id = 1;
+}
+
+message AppVersionPurgeRequest {
+  string app_version_id = 1;
+}
+
+message AppPurgeRequest {
+  string app_id = 1;
+}
+
+message PurgeResult {
+  int64 count = 1; // Number of items purged
+}
+
+message CacheContextActionsRequest {
+  string installation_id = 1;
+}
+
+service CacheUtils {
+  // Temporary method for fetching context actions and storing/caching them in the Runtime DB.
+  // This is for a single-use backfill and can be removed afterwards.
+  // TODO(gunsch): delete when finished.
+  rpc CacheContextActionsInRuntimeDb(CacheContextActionsRequest) returns (PurgeResult);
+
+  rpc PurgeAccessKey(AccessKeyPurgeRequest) returns (PurgeResult);
+  rpc PurgeInstallations(InstallationsPurgeRequest) returns (PurgeResult);
+  rpc PurgeInstallation(InstallationPurgeRequest) returns (PurgeResult);
+  rpc PurgeAppVersion(AppVersionPurgeRequest) returns (PurgeResult);
+  rpc PurgeApp(AppPurgeRequest) returns (PurgeResult);
+}
+
+message AcceptInviteRequest {
+  string subreddit_name = 1;
+  string app_account_id = 2;
+}
+
+message AcceptInviteResponse {}
+
+service ModInviteUtils {
+  rpc AcceptInvite(AcceptInviteRequest) returns (AcceptInviteResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/v1alpha/payments.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package devvit.gateway.v1alpha;
+
+import "reddit/xpaymentsplatform/payapi/v1/common.proto";
+
+option go_package = "github.snooguts.net/reddit/devplatform-api/go/grpc/devvit/gateway";
+
+service PaymentOrderProcessing {
+  rpc ProcessOrder(ProcessOrderRequest) returns (ProcessOrderResponse);
+}
+
+message ProcessOrderRequest {
+  reddit.xpaymentsplatform.payapi.v1.Order order = 1;
+}
+
+message ProcessOrderResponse {
+  oneof result {
+    // the product has been acknowledged and delivered
+    bool acknowledged = 1;
+    // the reason for rejecting product delivery
+    string rejection_reason = 2;
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/gateway/v1alpha/triggers.proto

@@ -0,0 +1,37 @@
+syntax = "proto3";
+
+package devvit.gateway.v1alpha;
+
+import "devvit/dev_portal/installation/installation.proto";
+import "devvit/triggers/v1alpha/triggers.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/gateway";
+
+service Triggers {
+  rpc OnTrigger(devvit.data.triggers.v1alpha.TriggerEvent) returns (TriggerResponse);
+  rpc OnFanOut(devvit.data.triggers.v1alpha.TriggerEvent) returns (TriggerFanOutResponse);
+  rpc OnInvoke(TriggerInvocation) returns (google.protobuf.Empty);
+  rpc OnInstall(devvit.dev_portal.installation.InstallationInfo) returns (google.protobuf.Empty);
+  rpc OnUninstall(devvit.dev_portal.installation.InstallationInfo) returns (google.protobuf.Empty);
+  rpc OnInstallChanged(devvit.dev_portal.installation.InstallationInfo) returns (google.protobuf.Empty);
+}
+
+message TriggerResponse {
+  // total number of apps invoked
+  int32 total = 1;
+  // successful installation ids
+  repeated string success = 2;
+  // map of installation ids to error message
+  map<string, string> errors = 3;
+}
+
+message TriggerFanOutResponse {
+  // installation id of apps to invoke
+  repeated string installation_ids = 1;
+}
+
+message TriggerInvocation {
+  string installation_id = 1;
+  devvit.data.triggers.v1alpha.TriggerEvent evt = 2;
+}