@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/dev_portal/dev_portal.proto

@@ -0,0 +1,193 @@
+syntax = "proto3";
+
+package devvit.dev_portal;
+
+// portal imports
+import "devvit/dev_portal/app/app.proto";
+import "devvit/dev_portal/app/categories/categories.proto";
+import "devvit/dev_portal/app/info/app_info.proto";
+import "devvit/dev_portal/app_publish_request/app_publish_request.proto";
+import "devvit/dev_portal/app_publish_request/note/app_publish_request_note.proto";
+import "devvit/dev_portal/app_publish_request/review/app_publish_request_review.proto";
+import "devvit/dev_portal/app_settings/app_settings.proto";
+import "devvit/dev_portal/app_version/app_version.proto";
+import "devvit/dev_portal/app_version/info/app_version_info.proto";
+import "devvit/dev_portal/data_api/admin/audit/audit.proto";
+import "devvit/dev_portal/data_api/admin/auth/auth.proto";
+import "devvit/dev_portal/data_api/admin/organization/organization.proto";
+import "devvit/dev_portal/data_api/admin/subscription/subscription.proto";
+import "devvit/dev_portal/data_api/admin/user/user.proto";
+import "devvit/dev_portal/developer_account/developer_account.proto";
+import "devvit/dev_portal/feedback/feedback.proto";
+import "devvit/dev_portal/installation/installation.proto";
+import "devvit/dev_portal/installation_settings/installation_settings.proto";
+import "devvit/dev_portal/nutrition/nutrition.proto";
+import "devvit/dev_portal/payments/payments_verification.proto";
+import "devvit/dev_portal/payments/product.proto";
+// utils
+import "devvit/uuid.proto";
+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/devportal";
+
+service App {
+  rpc Create(app.AppCreationRequest) returns (app.info.AppInfo);
+
+  rpc Search(app.AppSearchRequest) returns (app.AppSearchResponse);
+
+  rpc GetBySlug(app.GetAppBySlugRequest) returns (app.FullAppInfo);
+  rpc GetByUUID(UUID) returns (app.FullAppInfo);
+
+  rpc GetAllWithLocation(installation.GetAllWithInstallLocationRequest) returns (app.info.MultipleAppInfos);
+  rpc GetAllWithInstaller(installation.GetAllWithInstallerRequest) returns (app.info.MultipleAppInfos);
+  rpc GetAllWithOwner(app.GetAllWithOwnerRequest) returns (app.info.MultipleAppInfos);
+
+  // Get the X most popular apps, as determined by number of installations.
+  rpc GetPopularApps(app.GetPopularAppsRequest) returns (app.info.MultipleAppInfos);
+
+  rpc CheckIfMediaExists(app.CheckIfMediaExistsRequest) returns (app.CheckIfMediaExistsResponse);
+  rpc UploadNewMedia(app.UploadNewMediaRequest) returns (app.UploadNewMediaResponse);
+
+  rpc Update(app.AppUpdateRequest) returns (app.FullAppInfo);
+
+  rpc Unpublish(app.UnpublishAppRequest) returns (google.protobuf.Empty);
+  rpc Disable(app.DisableAppRequest) returns (google.protobuf.Empty);
+  rpc Enable(app.EnableAppRequest) returns (google.protobuf.Empty);
+
+  rpc Exists(app.AppExistsRequest) returns (app.AppExistsResponse);
+
+  rpc AppAccountExists(app.AppAccountExistsRequest) returns (app.AppAccountExistsResponse);
+  rpc CreateAppAccount(app.CreateAppAccountRequest) returns (app.CreateAppAccountResponse);
+  rpc RecoverAppAccount(app.RecoverAppAccountRequest) returns (app.info.AppInfo);
+  // Retrieve the full category taxonomy as a nested tree structure.
+  rpc GetAllCategories(google.protobuf.Empty) returns (app.categories.AppCategoryNodeListResponse);
+}
+
+service AppVersion {
+  rpc Create(app_version.AppVersionCreationRequest) returns (app_version.info.AppVersionInfo);
+
+  rpc Get(UUID) returns (app_version.FullAppVersionInfo);
+  rpc GetBySlugAndVersionNumber(app_version.AppSlugAndVersion) returns (app_version.FullAppVersionInfo);
+
+  rpc Update(app_version.AppVersionUpdateRequest) returns (app_version.FullAppVersionInfo);
+
+  rpc GetValidInstallLocations(app_version.ValidInstallLocationsRequest) returns (app_version.ValidInstallLocationsResponse);
+  rpc GetAppVersionBundle(UUID) returns (app_version.GetAppVersionBundleResponse);
+
+  // Get app nutritional labels by app name (slug) and optional version (1.2.3,
+  // 1.2.3.4, latest). Unlike SemVer, latest includes pre-release versions, not
+  // just stable.
+  rpc GetNutritionByNameVersion(nutrition.GetNutritionByNameVersionRequest) returns (nutrition.MultipleNutritionCategories);
+
+  // Get app nutritional labels by app version id
+  rpc GetNutritionByAppVersionId(UUID) returns (nutrition.MultipleNutritionCategories);
+
+  // Get app products by app version id
+  rpc GetProductsByAppVersionId(UUID) returns (payments.ProductList);
+}
+
+// Currently, there are no Actors or ActorTypes services. If use cases appear for either of these
+// services, this is where they'd go.
+
+service Installations {
+  rpc Create(installation.InstallationCreationRequest) returns (installation.FullInstallationInfo);
+
+  rpc GetByUUID(UUID) returns (installation.FullInstallationInfo);
+  rpc GetByAppNameAndInstallLocation(installation.GetByAppNameAndInstallLocationRequest) returns (installation.FullInstallationInfo);
+
+  rpc GetAllWithInstallLocation(installation.GetAllWithInstallLocationRequest) returns (installation.MultipleInstallationsResponse);
+  rpc GetAllWithInstaller(installation.GetAllWithInstallerRequest) returns (installation.MultipleInstallationsResponse);
+  rpc GetAllWithVersionUUID(UUID) returns (installation.MultipleInstallationsResponse);
+  rpc GetAllWithApp(installation.GetAllWithAppRequest) returns (installation.GetAllWithAppResponse);
+  rpc GetInstallationHistory(installation.GetInstallationHistoryRequest) returns (installation.GetInstallationHistoryResponse);
+
+  rpc Upgrade(installation.InstallationUpgradeRequest) returns (installation.FullInstallationInfo);
+  rpc UpgradeMany(installation.InstallationUpgradeManyRequest) returns (installation.InstallationUpgradeManyResponse);
+
+  rpc Update(installation.InstallationUpdateRequest) returns (installation.FullInstallationInfo);
+
+  rpc Remove(UUID) returns (google.protobuf.Empty);
+}
+
+service Feedback {
+  rpc Create(feedback.CreateFeedbackRequest) returns (google.protobuf.Empty);
+}
+
+service DataApiAdmin {
+  // Data Token
+  rpc CreateDataToken(data_api.admin.auth.CreateDataTokenRequest) returns (data_api.admin.auth.CreateDataTokenResponse);
+  rpc GetDataTokenById(data_api.admin.auth.GetDataTokenByIdRequest) returns (data_api.admin.auth.GetDataTokenByIdResponse);
+  rpc GetDataTokensByOrganizationName(data_api.admin.auth.GetDataTokensByOrganizationNameRequest) returns (data_api.admin.auth.GetDataTokensByOrganizationNameResponse);
+  rpc RevokeDataTokenById(data_api.admin.auth.RevokeDataTokenByIdRequest) returns (data_api.admin.auth.RevokeDataTokenByIdResponse);
+
+  // Data Subscription
+  rpc CreateDataSubscription(data_api.admin.subscription.CreateDataSubscriptionRequest) returns (data_api.admin.subscription.CreateDataSubscriptionResponse);
+  rpc GetDataSubscriptionById(data_api.admin.subscription.GetDataSubscriptionByIdRequest) returns (data_api.admin.subscription.GetDataSubscriptionByIdResponse);
+  rpc GetDataSubscriptionsByOrganizationName(data_api.admin.subscription.GetDataSubscriptionsByOrganizationNameRequest) returns (data_api.admin.subscription.GetDataSubscriptionsByOrganizationNameResponse);
+  rpc UpdateDataSubscription(data_api.admin.subscription.UpdateDataSubscriptionRequest) returns (data_api.admin.subscription.UpdateDataSubscriptionResponse);
+  rpc DeleteDataSubscription(data_api.admin.subscription.DeleteDataSubscriptionRequest) returns (data_api.admin.subscription.DeleteDataSubscriptionResponse);
+
+  // Organizations
+  rpc CreateOrganization(data_api.admin.organization.CreateOrganizationRequest) returns (data_api.admin.organization.CreateOrganizationResponse);
+  rpc GetOrganizationByName(data_api.admin.organization.GetOrganizationByNameRequest) returns (data_api.admin.organization.GetOrganizationByNameResponse);
+  rpc GetOrganizations(data_api.admin.organization.GetOrganizationsRequest) returns (data_api.admin.organization.GetOrganizationsResponse);
+  rpc UpdateOrganization(data_api.admin.organization.UpdateOrganizationRequest) returns (data_api.admin.organization.UpdateOrganizationResponse);
+
+  // Audit Log
+  rpc GetAuditLogEvents(data_api.admin.audit.GetAuditLogEventsRequest) returns (data_api.admin.audit.GetAuditLogEventsResponse);
+
+  rpc AddUsersToOrg(data_api.admin.user.AddUsersToOrgRequest) returns (data_api.admin.user.AddUsersToOrgResponse);
+  rpc GetUsersByOrgId(data_api.admin.user.GetUsersByOrgIdRequest) returns (data_api.admin.user.GetUsersByOrgIdResponse);
+  rpc GetUserById(data_api.admin.user.GetUserByIdRequest) returns (data_api.admin.user.GetUserByIdResponse);
+  rpc DeleteUser(data_api.admin.user.DeleteUserRequest) returns (data_api.admin.user.DeleteUserResponse);
+}
+
+// A service to handle client-side events.
+service Events {
+  // Fire off a client-side event
+  rpc SendEvent(google.protobuf.Value) returns (google.protobuf.Empty);
+}
+
+service DevPortalInstallationSettings {
+  rpc GetForm(installation_settings.GetInstallationSettingsFormRequest) returns (installation_settings.GetInstallationSettingsFormResponse);
+  rpc ValidateForm(installation_settings.ValidateInstallationSettingsFormRequest) returns (installation_settings.ValidateInstallationSettingsFormResponse);
+  rpc GetSettings(installation_settings.GetInstallationSettingsRequest) returns (installation_settings.GetInstallationSettingsResponse);
+  rpc UpdateSettings(installation_settings.UpdateInstallationSettingsRequest) returns (installation_settings.UpdateInstallationSettingsResponse);
+}
+
+service DevPortalAppSettings {
+  rpc GetForm(app_settings.GetAppSettingsFormRequest) returns (app_settings.GetAppSettingsFormResponse);
+  rpc ValidateForm(app_settings.ValidateAppSettingsFormRequest) returns (app_settings.ValidateAppSettingsFormResponse);
+  rpc GetSettings(app_settings.GetAppSettingsRequest) returns (app_settings.GetAppSettingsResponse);
+  rpc UpdateSettings(app_settings.UpdateAppSettingsRequest) returns (app_settings.UpdateAppSettingsResponse);
+}
+
+// Service to support developer settings page. See here: https://docs.google.com/document/d/1HuAfNB_26jnNu7gGDHk-vafzgpnoNaFqHoumE2C40cA/edit?tab=t.0#bookmark=id.9kf1k0pojgnq
+// for more context.
+service DevPortalDeveloperSettings {
+  // Returns the payments verification status for a given user. This determines whether the user can get paid out and
+  // whether they can publish apps that accept payments.
+  rpc GetPaymentsVerificationStatus(payments.GetPaymentsVerificationStatusRequest) returns (payments.GetPaymentsVerificationStatusResponse);
+}
+
+service DevPortalAppPublishRequest {
+  rpc Submit(app_publish_request.AppPRCreateRequest) returns (UUID);
+  rpc Update(app_publish_request.AppPRUpdateRequest) returns (google.protobuf.Empty);
+  rpc Get(app_publish_request.AppPRGetRequest) returns (app_publish_request.FullPublishRequestInfo);
+  rpc FindMany(app_publish_request.AppPRFindManyRequest) returns (app_publish_request.MultiplePublishRequestInfos);
+
+  rpc SetReviewDecision(app_publish_request.review.AppPRSetReviewDecisionRequest) returns (UUID);
+  rpc RemoveReview(UUID) returns (google.protobuf.Empty);
+
+  rpc AddNote(app_publish_request.note.AppPRAddNoteRequest) returns (UUID);
+  rpc UpdateNote(app_publish_request.note.AppPRUpdateNoteRequest) returns (google.protobuf.Empty);
+  rpc RemoveNote(UUID) returns (google.protobuf.Empty);
+}
+
+// Developer Account service, for managing when users register their Reddit account for a Developer Account
+// A Developer account is specific to the Developer Platform, and is necessary to develop apps
+service DeveloperAccount {
+  rpc RegisterUser(developer_account.DeveloperAccountRegisterUserRequest) returns (developer_account.DeveloperAccountInfo);
+  rpc GetUserAccountInfoIfExists(google.protobuf.Empty) returns (developer_account.GetUserAccountInfoResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/developer_account/developer_account.proto

@@ -0,0 +1,46 @@
+syntax = "proto3";
+
+package devvit.dev_portal.developer_account;
+
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/dev_portal/developer_account";
+
+message DeveloperAccountRegisterUserRequest {
+  // Thing ID (T2 ID with prefix. eg, t2_123abc.)
+  string user_id = 1;
+  // Username
+  string user_name = 2;
+  bool does_consent_to_email = 3;
+}
+
+message GetUserAccountInfoResponse {
+  // The version of the developer terms & conditions accepted by the user upon Developer Account creation (ie, 2)
+  int32 accepted_terms_version = 1;
+  // The current version of the developer terms & conditions
+  int32 current_terms_version = 2;
+  bool has_verified_email = 3;
+  // User selected preferences for email communication from the Developer Platform
+  bool does_consent_to_email = 4;
+  // Thing ID (T2 ID with prefix. eg, t2_123abc.), optional because user could be logged out
+  optional string user_id = 5;
+}
+
+message DeveloperAccountInfo {
+  // UUID of the Developer Account, assigned in database
+  string id = 1;
+  // Thing I (T2 ID with prefix. eg, t2_123abc.), optional because user could be logged out
+  string user_id = 2;
+  // User's reddit username (eg, "spez")
+  string user_name = 3;
+
+  google.protobuf.Timestamp created_at = 4;
+  // The version of the developer terms & conditions accepted by the user upon Developer Account creation (ie, 2)
+  int32 accepted_terms_version = 5;
+  // Timestamp of when the user accepted the current developer terms & conditions
+  google.protobuf.Timestamp accepted_terms_version_at = 6;
+  // Whether the user has verified the email address associated with their Reddit Account
+  bool has_verified_email = 7;
+  // User selected preferences for email communication from the Developer Platform
+  bool does_consent_to_email = 8;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/feedback/feedback.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+
+package devvit.dev_portal.feedback;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/feedback";
+
+message CreateFeedbackRequest {
+  // The content of the feedback
+  string content = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/fetch_domain/fetch_domain.proto

@@ -0,0 +1,19 @@
+syntax = "proto3";
+
+package devvit.dev_portal.fetch_domain;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/fetchdomain";
+
+// Represents a domain's global status. UNDECIDED means the domain is not globally decided, ie only applies at the app level.
+enum FetchDomainGlobalStatus {
+  UNDECIDED = 0;
+  ALLOWED = 1;
+  DENIED = 2;
+}
+
+message FetchDomain {
+  // The domain name, eg 'api.stlouisfed.org'
+  string domain = 1;
+  // The status of the domain, one of UNDECIDED, ALLOWED, or DENIED
+  FetchDomainGlobalStatus global_status = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/fetch_domain_request/fetch_domain_request.proto

@@ -0,0 +1,64 @@
+syntax = "proto3";
+
+package devvit.dev_portal.fetch_domain_request;
+
+import "devvit/dev_portal/reddit/redditor.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/fetchdomainrequest";
+
+// The status of the domain request, eg 'PENDING', 'APPROVED', 'DENIED'
+enum FetchDomainRequestStatus {
+  PENDING = 0;
+  APPROVED = 1;
+  DENIED = 2;
+}
+
+// Represents information about a domain request.
+message FetchDomainRequestInfo {
+  // The UUID of the request, eg '19ecb14b-db3c-4757-9793-4d58893ba449'
+  string id = 1;
+  // The timestamp when the request was created, eg '2025-06-04T17:14:38.029Z'
+  google.protobuf.Timestamp created_at = 2;
+  // The timestamp when the request was last updated, eg '2025-06-04T17:14:38.029Z'
+  google.protobuf.Timestamp updated_at = 3;
+  // The domain that is being requesting, eg 'hello-world.org'
+  string domain = 4;
+  // The status of the request, eg 'PENDING', 'APPROVED', 'DENIED'
+  FetchDomainRequestStatus status = 5;
+  // The t2_ id of the user who reviewed the request, eg 't2_1a2b'
+  optional string reviewer_id = 6;
+  // The slug of the app that the request is for, eg 'wsb-app'.
+  optional string app_slug = 7;
+  // The account of the app owner who requested the domain, eg 't2_3c4d'
+  devvit.dev_portal.reddit.Redditor app_owner_account = 8;
+  // The account of the reviewer who reviewed the request, eg 't2_1a2b'
+  devvit.dev_portal.reddit.Redditor reviewer_account = 9;
+  // The formatted time representing how long a request has been pending, eg '2 days', '5 hours', '23 seconds'.
+  optional string time_in_queue = 10;
+}
+
+message GetPendingRequest {
+  // How many pending requests to return in a single page.
+  int32 page_size = 1;
+  // The page number of pending requests to return. The page number should start at 1.
+  int32 page_number = 2;
+}
+
+message GetResponse {
+  // The list of fetch domain request information.
+  repeated FetchDomainRequestInfo fetch_domain_requests = 1;
+  // Indicates whether or not there is a next page of fetch domain requests.
+  optional bool has_next_page = 2;
+}
+
+message UpdateStatusForAppRequest {
+  // The ID of the FetchDomainRequest to be updated.
+  string id = 1;
+  // The slug of the app that the request is for, eg 'wsb-app'.
+  string app_slug = 2;
+  // The domain on the request, eg 'api.hello-world.net'.
+  string domain = 3;
+  // The new status of the FetchDomainRequest. Can be one of PENDING, APPROVED, or DENIED.
+  FetchDomainRequestStatus status = 4;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/installation/installation.proto

@@ -0,0 +1,230 @@
+syntax = "proto3";
+
+package devvit.dev_portal.installation;
+
+import "devvit/dev_portal/app/info/app_info.proto";
+import "devvit/dev_portal/app_version/info/app_version_info.proto";
+import "devvit/reddit/thing_type.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/installation";
+
+// region Enums
+
+enum UpgradeStrategy {
+  MANUAL = 0;
+  AUTOMATIC = 1;
+}
+
+// endregion
+
+message OptionalUpgradeStrategy {
+  UpgradeStrategy value = 1;
+}
+
+// region Request parameters
+
+// Used to install an app
+message InstallationCreationRequest {
+  // What app version are you installing?
+  string app_version_id = 1;
+  // Who should this app run as? If not present, will be run by the user installing the app.
+  google.protobuf.StringValue run_as = 3;
+
+  // What type of install is this?
+  app_version.info.InstallationType type = 4;
+  // The subreddit or user to install on. For subreddits, this is either the
+  // subreddit name (**with** "r/" prefix) or its t5 ID. Eg, `r/beta` or
+  // `t5_15e`. For users, this is the username (**with** "u/" prefix) or the t2 ID.
+  string location = 5;
+
+  // What is the installation's upgrade strategy?
+  UpgradeStrategy upgrade_strategy = 6;
+  // If applicable, what is the configuration for that upgrade strategy?
+  google.protobuf.Struct upgrade_strategy_config = 7;
+
+  // installed_by is determined by the auth of the logged in user, does not need to be given
+}
+
+// Used to update an existing installation's information.
+// If a field is optional, omitting it will leave its value unchanged.
+message InstallationUpdateRequest {
+  // What is the ID of the installation you want to change?
+  string id = 1;
+  // Who should this app run as? If not present, will be run by the user installing the app.
+  google.protobuf.StringValue run_as = 3;
+
+  // installed_by, install type, location, and version are not editable
+
+  // What is the installation's upgrade strategy?
+  OptionalUpgradeStrategy upgrade_strategy = 4;
+  // If applicable, what is the configuration for that upgrade strategy?
+  google.protobuf.Struct upgrade_strategy_config = 5;
+  /** Disable this installation of the app? */
+  google.protobuf.BoolValue is_enabled = 6;
+}
+
+// Used to upgrade an existing installation to a newer version.
+message InstallationUpgradeRequest {
+  // What is the ID of the installation you want to change?
+  string id = 1;
+  // What version of the app are you upgrading to? (NOTE: This must be a version of
+  // the same app, and must be a later version than the one currently installed.)
+  // If not given, we will upgrade you to the latest non-prerelease version of the app.
+  google.protobuf.StringValue app_version_id = 2;
+}
+
+message InstallationUpgradeManyRequest {
+  // What are the IDs of the installations you want to change?
+  repeated string ids = 1;
+  // What version of the app are you upgrading them all to? (NOTE: This must be a version
+  // of the same app, and must be a later version than the one currently installed.)
+  string app_version_id = 2;
+}
+
+message GetByAppNameAndInstallLocationRequest {
+  // What is the slug of the app you're looking for?
+  string slug = 1;
+  // What type of install are you looking for?
+  app_version.info.InstallationType type = 2;
+  // What is the install location?
+  string location = 3;
+}
+
+// Used to get all installs in a given location
+message GetAllWithInstallLocationRequest {
+  // What type of install are you looking for?
+  app_version.info.InstallationType type = 1;
+  // What is the install location?
+  string location = 2;
+}
+
+// Used to get all installs made by a given user
+message GetAllWithInstallerRequest {
+  // Whose installs are you looking for? (Can be a t2_ ID or a username, with or without `u/`)
+  string installed_by = 1;
+}
+
+message GetAllWithAppRequest {
+  string id = 1;
+  optional uint32 take = 2;
+  optional uint32 skip = 3;
+}
+
+message GetInstallationHistoryRequest {
+  // What type of install are you looking for?
+  app_version.info.InstallationType type = 1;
+  // What is the install location?
+  string location = 2;
+  // What is the slug of the app you're looking for?
+  string slug = 3;
+  // Beginning of the time window. Leaving null implies searching from the beginning
+  google.protobuf.Timestamp from = 4;
+  // End of the time window. Leaving null implies searching until the end
+  google.protobuf.Timestamp to = 5;
+  // How many items to take?
+  optional uint32 take = 6;
+  // Order in desc order?
+  optional bool desc = 7;
+}
+
+// endregion
+
+// region Response types
+
+// Contains the details of an installation. For field documentation, refer to the Prisma schema.
+message InstallationInfo {
+  string id = 1;
+  // string installed_by = 2; // Removed; see DX-2225
+  UpgradeStrategy upgrade_strategy = 3;
+  google.protobuf.Struct upgrade_strategy_config = 4;
+  google.protobuf.StringValue run_as = 6;
+  app_version.info.InstallationType type = 7;
+  InstallationLocationInfo location = 8;
+  bool is_enabled = 9;
+}
+
+message InstallationLocationInfo {
+  // Thing ID; eg, `"t5_2qh0u"` for r/pics.
+  string id = 1;
+  // Thing name; eg, `"pics"` for r/pics.
+  string name = 2;
+  // Thing type; eg, `5`, the second character in `t5_2qh0u` for r/pics.
+  devvit.reddit.ThingType type = 3;
+  google.protobuf.StringValue icon = 4;
+  bool is_nsfw = 5;
+  // True if subreddit is private and the user isn't a member, or is not visible to viewer for any other reason.
+  bool is_unavailable = 6;
+}
+
+// Contains details of an installation, as well as what version was installed.
+message FullInstallationInfo {
+  InstallationInfo installation = 1;
+  app_version.info.AppVersionInfo app_version = 2;
+  app.info.AppInfo app = 3;
+}
+
+// Contains multiple installations.
+message MultipleInstallationsResponse {
+  repeated InstallationInfo installations = 1;
+}
+
+// Contains multiple installations and their app versions.
+message GetAllWithAppResponse {
+  repeated InstallationWithAppVersion installations = 1;
+}
+
+// An app installation with its matching app version info.
+message InstallationWithAppVersion {
+  InstallationInfo installation = 1;
+  app_version.info.AppVersionInfo app_version = 2;
+}
+
+message InstallationUpgradeManyResponse {
+  message InstallationUpgradeDetails {
+    string id = 1;
+    bool success = 2;
+    optional string error = 3;
+  }
+  repeated InstallationUpgradeDetails details = 1;
+}
+
+// Location details of an install including type of location, id, and name. (subreddit or user)
+message InstallationLocationDetails {
+  app_version.info.InstallationType type = 1;
+  // The thing ID of the valid install location
+  string thing_id = 2;
+  // The name of the valid install location
+  string name = 3;
+}
+
+enum InstallationHistoryEventName {
+  INSTALLED = 0;
+  UNINSTALLED = 1;
+  UPGRADED = 2;
+  UPDATED = 3;
+  BANNED = 4;
+  UNBANNED = 5;
+}
+
+message InstallationHistoryEvent {
+  // Who triggered this event? t2_id of the user
+  string user_id = 1;
+  // What kind of event what it?
+  InstallationHistoryEventName name = 2;
+  // What are the details of the event?
+  map<string, string> details = 3;
+  // When did this event occur?
+  google.protobuf.Timestamp created_at = 4;
+}
+
+message GetInstallationHistoryResponse {
+  // The events that occurred during the window specified by the request query
+  repeated InstallationHistoryEvent events = 1;
+  // Total number of events associated with the installation
+  uint32 total_events = 8;
+}
+
+// endregion

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/installation_settings/installation_settings.proto

@@ -0,0 +1,51 @@
+syntax = "proto3";
+
+package devvit.dev_portal.installation_settings;
+
+import "devvit/plugin/settings/v1alpha/settings.proto";
+import "devvit/ui/form_builder/v1alpha/form.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/installationsettings";
+
+message GetInstallationSettingsFormRequest {
+  string installation_id = 1;
+}
+
+message GetInstallationSettingsFormResponse {
+  // Installation settings Forms mapped by actor_name
+  map<string, devvit.ui.form_builder.v1alpha.Form> form = 1;
+}
+
+message ValidateInstallationSettingsFormRequest {
+  string installation_id = 1;
+  devvit.plugin.settings.v1alpha.SettingsValues settings = 2;
+}
+
+message ValidateInstallationSettingsFormResponse {
+  // If false, prevent submission and display errors on the form
+  bool success = 1;
+
+  // Map of field_id:error pairs to display on the form
+  map<string, string> errors = 2;
+}
+
+message GetInstallationSettingsRequest {
+  string installation_id = 1;
+}
+
+message GetInstallationSettingsResponse {
+  devvit.plugin.settings.v1alpha.SettingsValues settings = 1;
+}
+
+message UpdateInstallationSettingsRequest {
+  string installation_id = 1;
+  devvit.plugin.settings.v1alpha.SettingsValues settings = 2;
+}
+
+message UpdateInstallationSettingsResponse {
+  // If false, prevent submission and display errors on the form
+  bool success = 1;
+
+  // Map of field_id:error pairs to display on the form
+  map<string, string> errors = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/dev_portal/internal/authorization/v1alpha/authorization.proto

@@ -0,0 +1,45 @@
+syntax = "proto3";
+
+package devvit.dev_portal.internal.authorization.v1alpha;
+
+import "devvit/remote_logger/remote_logger.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/devportal/int/authorization";
+
+// An application version installed to a specific location
+message DevPortalAuthInstalledAppResource {
+  DevPortalAuthAppVersionResource app = 1;
+  DevPortalAuthLocationResource location = 2;
+}
+
+// Represents a specific application version
+message DevPortalAuthAppVersionResource {
+  string name = 1; // The short app name (slug)
+  string version = 2; // Semver of the application
+}
+
+// Represents a specific subreddit
+message DevPortalAuthLocationResource {
+  string id = 1; // t5_ for the subreddit or t2_ for user
+}
+
+message DevPortalAuthCanViewLogsRequest {
+  string user_id = 1;
+  oneof installation {
+    string id = 2; // Installation Id UUID
+    DevPortalAuthInstalledAppResource app = 3; // An app version + location combo
+  }
+  // The log stream type that will be read from. Admins may have access to more
+  // types than other types of users.
+  devvit.remote_logger.RemoteLogType type = 4;
+}
+
+message DevPortalAuthorizationResponse {
+  bool allowed = 1; // true if the requested action is allowed
+  string reason = 2; // a reason for the allow/deny. This is more likely present for the deny case.
+}
+
+service DevPortalAuthorization {
+  // Check if a user is allowed view logs
+  rpc CanViewLogs(DevPortalAuthCanViewLogsRequest) returns (DevPortalAuthorizationResponse);
+}