@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/plugin/redditapi/flair/flair_msg.proto

@@ -0,0 +1,284 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.flair;
+
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.flair";
+
+message ClearFlairTemplatesRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // one of (USER_FLAIR, LINK_FLAIR)
+  string flair_type = 2;
+}
+
+message DeleteFlairRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // a user by name
+  string name = 2;
+}
+
+message DeleteFlairTemplateRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  string flair_template_id = 2;
+}
+
+message FlairRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // a valid subreddit image name
+  google.protobuf.StringValue css_class = 2;
+
+  // the thing id of a link e.g. t3_15bfi0
+  google.protobuf.StringValue link = 3;
+
+  // a user by name
+  google.protobuf.StringValue name = 4;
+
+  // a string no longer than 64 characters
+  google.protobuf.StringValue text = 5;
+}
+
+message FlairTemplateOrderRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // one of (USER_FLAIR, LINK_FLAIR)
+  string flair_type = 2;
+
+  repeated string order = 3;
+}
+
+message FlairConfigRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // is flair enabled? e.g. true/false
+  bool flair_enabled = 2;
+
+  // position of flair e.g. one of (left, right)
+  string flair_position = 3;
+
+  // a boolean value e.g. true/false
+  bool flair_self_assign_enabled = 4;
+
+  // position of link flair
+  string link_flair_position = 5;
+
+  // a boolean value e.g. true/false
+  bool link_flair_self_assign_enabled = 6;
+}
+
+message FlairCsvRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // flair information, separated by commas
+  string flair_csv = 2;
+}
+
+message FlairListRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // thing id e.g. t3_15bfi0
+  google.protobuf.StringValue after = 2;
+
+  // thing id e.g. t3_15bfi0
+  google.protobuf.StringValue before = 3;
+
+  // a positive integer (default: 0)
+  google.protobuf.Int64Value count = 4;
+
+  // the maximum number of items desired (default: 25, maximum: 1000)
+  google.protobuf.Int64Value limit = 5;
+
+  // a user by name
+  google.protobuf.StringValue name = 6;
+
+  // (optional) the string "all"
+  google.protobuf.StringValue show = 7;
+}
+
+message FlairSelectorRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // is it a new link e.g. true/false
+  bool is_newlink = 2;
+
+  // the thing id of a link e.g. t3_15bfi0
+  google.protobuf.StringValue link = 3;
+
+  // a user by name
+  string name = 4;
+}
+
+message FlairTemplateRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // one of (all, emoji, text)
+  string allowable_content = 2;
+
+  // a 6-digit rgb hex color, e.g. #AABBCC
+  string background_color = 3;
+
+  // a valid subreddit image name
+  string css_class = 4;
+
+  string flair_template_id = 5; // no-op
+
+  //  one of (USER_FLAIR, LINK_FLAIR)
+  string flair_type = 6;
+
+  // an integer between 1 and 10 (default: 10)
+  int64 max_emojis = 7;
+
+  // a boolean value
+  bool mod_only = 8;
+
+  bool override_css = 9; // no-op
+
+  // a string no longer than 64 characters
+  string text = 10;
+
+  // one of (light, dark)
+  string text_color = 11;
+
+  // is this text editable? e.g. true/false
+  bool text_editable = 12;
+}
+
+message LinkFlairRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+}
+
+message SelectFlairRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // a 6-digit rgb hex color, e.g. #AABBCC
+  string background_color = 2;
+
+  // a valid subreddit image name
+  string css_class = 3;
+
+  string flair_template_id = 4; // no-op
+
+  // the thing id of a link e.g. t3_15bfi0
+  string link = 5;
+
+  // a user by name
+  string name = 6;
+
+  // "all" saves attributes and returns rtjson; "only" only returns rtjson; "none" only saves attributes e.g. [all|only|none]
+  string return_rtjson = 7;
+
+  // a string no longer than 64 characters
+  string text = 8;
+
+  // one of (light, dark)
+  string text_color = 9;
+}
+
+message SetFlairEnabledRequest {
+  // subreddit name without the r/ e.g. 'devvit_test'
+  string subreddit = 1;
+
+  // is flair enabled? e.g. true/false
+  bool flair_enabled = 2;
+}
+
+message FlairObject {
+  google.protobuf.StringValue allowable_content = 1;
+  google.protobuf.StringValue text = 2;
+  google.protobuf.StringValue text_color = 3;
+  bool mod_only = 4;
+  google.protobuf.StringValue background_color = 5;
+  google.protobuf.StringValue id = 6;
+  google.protobuf.StringValue css_class = 7;
+  int64 max_emojis = 8;
+
+  // prev: repeated google.protobuf.StringValue richtext
+  reserved 9;
+
+  bool text_editable = 10;
+  bool override_css = 11;
+  google.protobuf.StringValue type = 12;
+  google.protobuf.StringValue flair_type = 13;
+  repeated FlairRichText richtext = 14;
+
+  // RichText document for flair
+  message FlairRichText {
+    // enum of element types.  e.g. emoji or text
+    google.protobuf.StringValue e = 1;
+    // text to show up in the flair, e.g. "Need Advice"
+    google.protobuf.StringValue t = 2;
+    // emoji references, e.g. ":rainbow:"
+    google.protobuf.StringValue a = 3;
+    // url string, e.g. "https://reddit.com/"
+    google.protobuf.StringValue u = 4;
+  }
+}
+
+message FlairArray {
+  repeated FlairObject flair = 1;
+}
+
+message FlairSelectorResponseOption {
+  google.protobuf.StringValue flair_css_class = 1;
+  google.protobuf.StringValue flair_template_id = 2;
+  google.protobuf.StringValue flair_text = 3;
+  google.protobuf.BoolValue flair_text_editable = 4;
+  google.protobuf.StringValue flair_position = 5;
+}
+
+message FlairSelectorResponse {
+  FlairSelectorResponseOption current = 1;
+  repeated FlairSelectorResponseOption choices = 2;
+}
+
+message UserFlair {
+  google.protobuf.StringValue flair_css_class = 1;
+  google.protobuf.StringValue user = 2;
+  google.protobuf.StringValue flair_text = 3;
+}
+
+message FlairListResponse {
+  repeated UserFlair users = 1;
+  google.protobuf.StringValue next = 2;
+  google.protobuf.StringValue prev = 3;
+}
+
+// options derived from this:
+// https://github.snooguts.net/reddit/reddit-public/blob/ec7d110c0be319e68502828a2662b86caca03a3c/r2/r2/controllers/api.py#L8531
+message FlairCsvResultError {
+  google.protobuf.StringValue css = 1;
+  google.protobuf.StringValue row = 2;
+  google.protobuf.StringValue user = 3;
+}
+
+message FlairCsvResultWarning {
+  google.protobuf.StringValue text = 1;
+}
+
+message FlairCsvResult {
+  google.protobuf.StringValue status = 1;
+  google.protobuf.BoolValue ok = 2;
+  FlairCsvResultError errors = 3;
+  FlairCsvResultWarning warnings = 4;
+}
+
+message FlairCsvResponse {
+  repeated FlairCsvResult result = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/flair/flair_svc.proto

@@ -0,0 +1,120 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.flair;
+
+import "devvit/plugin/redditapi/common/common_msg.proto";
+import "devvit/plugin/redditapi/flair/flair_msg.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.flair";
+
+// FLAIR - https://www.reddit.com/dev/api#section_flair
+service Flair {
+  // https://www.reddit.com/dev/api#POST_api_clearflairtemplates
+  rpc ClearFlairTemplates(ClearFlairTemplatesRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/clearflairtemplates';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_deleteflair
+  rpc DeleteFlair(DeleteFlairRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/deleteflair';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_deleteflairtemplate
+  rpc DeleteFlairTemplate(DeleteFlairTemplateRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/deleteflairtemplate';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_flair
+  rpc Flair(FlairRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flair';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#PATCH_api_flair_template_order
+  // Note: Endpoint expects body as raw array of flair id's
+  rpc FlairTemplateOrder(FlairTemplateOrderRequest) returns (google.protobuf.Empty);
+
+  // https://www.reddit.com/dev/api#POST_api_flairconfig
+  rpc FlairConfig(FlairConfigRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flairconfig';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_flaircsv
+  rpc FlairCsv(FlairCsvRequest) returns (FlairCsvResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flaircsv';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+    option (devvit.plugin.redditapi.common.api_client_config).use_custom_response_parser = true;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_flairlist
+  rpc FlairList(FlairListRequest) returns (FlairListResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flairlist.json?after={after}&before={before}&count={count}&limit={limit}&name={name}&show={show}';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_flairselector
+  rpc FlairSelector(FlairSelectorRequest) returns (FlairSelectorResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flairselector?name={name}&link={link}&is_newlink={is_newlink}';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_flairtemplate_v2
+  // Note: We ignore the "v1" implementation of this method
+  // Beware: The JSON response to this endpoint is a FlairObject in camelCase, not snake_case
+  // like the other responses.
+  rpc FlairTemplate(FlairTemplateRequest) returns (FlairObject) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/flairtemplate_v2';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_link_flair_v2
+  // Note: We ignore the "v1" implementation of this method
+  rpc LinkFlair(LinkFlairRequest) returns (FlairArray) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/link_flair_v2';
+    option (devvit.plugin.redditapi.common.api_client_config).use_custom_response_parser = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_selectflair
+  rpc SelectFlair(SelectFlairRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/selectflair';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_setflairenabled
+  rpc SetFlairEnabled(SetFlairEnabledRequest) returns (devvit.plugin.redditapi.common.JsonStatus) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/setflairenabled';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+    option (devvit.plugin.redditapi.common.api_client_config).enforce_json = true;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_user_flair_v2
+  // Note: We ignore the "v1" implementation of this method
+  rpc UserFlair(LinkFlairRequest) returns (FlairArray) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/r/{subreddit}/api/user_flair_v2';
+    option (devvit.plugin.redditapi.common.api_client_config).use_custom_response_parser = true;
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/graphql/graphql_msg.proto

@@ -0,0 +1,35 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.graphql;
+
+import "google/protobuf/struct.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.graphql";
+
+message QueryRequest {
+  // gql query string
+  string query = 1;
+  // put the variables here
+  optional google.protobuf.Struct variables = 2;
+}
+
+message PersistedQueryRequest {
+  // id of a persisted operation
+  string id = 1;
+  // put the variables here
+  optional google.protobuf.Struct variables = 2;
+  // the name of the persisted operation
+  string operation_name = 3;
+}
+
+message QueryResponse {
+  google.protobuf.Struct data = 1;
+  repeated GraphQLError errors = 2 [deprecated = true];
+  optional bool ok = 3 [deprecated = true];
+}
+
+message GraphQLError {
+  string code = 1;
+  string message = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/graphql/graphql_svc.proto

@@ -0,0 +1,19 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.graphql;
+
+import "devvit/plugin/redditapi/graphql/graphql_msg.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.graphql";
+
+service GraphQL {
+  // Sending a GraphQL query request using a custom query string
+  rpc Query(QueryRequest) returns (QueryResponse);
+
+  // Sending a GraphQL persisted query request
+  //
+  // A persisted query is a query string that's cached on the server side,
+  // along with its unique identifier (always its SHA-256 hash)
+  rpc PersistedQuery(PersistedQueryRequest) returns (QueryResponse);
+}