@devvit/protos 0.12.7 → 0.12.8-next-2025-12-30-18-45-56-2c333c463.0

package/schema/.snootobuf/deps/devvit/remote_logger/remote_logger.proto

@@ -0,0 +1,65 @@
+syntax = "proto3";
+
+package devvit.remote_logger;
+
+import "devvit/plugin/logger/logger.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/remote_logger";
+
+service RemoteLogPublisher {
+  rpc Put(RemoteLogMessage) returns (RemoteLogPutResponse);
+  rpc PutAll(RemoteLogMessages) returns (RemoteLogPutResponse);
+}
+
+service RemoteLogConsumer {
+  rpc Tail(RemoteLogQuery) returns (stream RemoteLogMessage);
+}
+
+message RemoteLogMessages {
+  repeated RemoteLogMessage messages = 1;
+}
+
+message RemoteLogPutResponse {}
+
+message KeepAliveMessage {
+  google.protobuf.Timestamp timestamp = 1;
+}
+
+message RemoteLogMessage {
+  oneof message {
+    devvit.plugin.logger.LogMessage log = 1;
+    devvit.plugin.logger.LogErrorMessage error = 2;
+    KeepAliveMessage keepalive = 3;
+    devvit.plugin.logger.LogEventMessage event = 4;
+  }
+}
+
+enum RemoteLogType {
+  LOG = 0;
+  ERROR = 1;
+  EVENT = 2;
+}
+
+// Filter on installation ID (encoded subreddit name AND app name).
+message RemoteLogInstallationFilter {
+  string installation_id = 1;
+}
+
+// Filter on subreddit name and / or app name. Not all combinations are
+// available on all streams.
+message RemoteLogSubredditAppNameFilter {
+  string subreddit = 2;
+  string app_name = 3;
+}
+
+message RemoteLogQuery {
+  // Not all filters are available on all log streams.
+  oneof filter {
+    RemoteLogInstallationFilter installation = 1;
+    RemoteLogSubredditAppNameFilter subreddit_app_name = 2;
+  }
+
+  RemoteLogType type = 3;
+  google.protobuf.Timestamp since = 4;
+}

package/schema/.snootobuf/deps/devvit/runtime/actor/bootstrap.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package devvit.runtime.actor;
+
+import "devvit/runtime/bundle.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/runtime/actor";
+option java_package = "com.reddit.devvit.runtime.actor";
+
+// Bootstraper used to load an actual Actor into the Worker
+service BootstrapActor {
+  // Loads an Actor into the Worker and binds its service to a URL
+  rpc LoadActor(LinkedBundle) returns (google.protobuf.Empty);
+}

package/schema/.snootobuf/deps/devvit/runtime/actor/v1alpha/health.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package devvit.runtime.actor.v1alpha;
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/runtime/actor/v1alpha";
+option java_package = "com.reddit.devvit.runtime.actor.v1alpha";
+
+message HealthStatus {
+  google.protobuf.Timestamp start = 1;
+  google.protobuf.Timestamp end = 2;
+}
+
+service Health {
+  rpc Check(google.protobuf.Empty) returns (HealthStatus);
+}

package/schema/.snootobuf/deps/devvit/runtime/bundle.proto

@@ -0,0 +1,171 @@
+syntax = "proto3";
+
+package devvit.runtime;
+
+import "devvit/runtime/serializable.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "reddit/devvit/app_permission/v1/app_permission.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/runtime";
+option java_package = "com.reddit.devvit.runtime";
+
+// Bundle or plugin configuration. This config is usually set by Config.init()
+// but some plugins may configure differently.
+message ActorSpec {
+  // Bundle or plugin (PLUGIN_APP_NAME) name. This should be unique across app
+  // actors. Usually just "main".
+  string name = 1;
+  // Bundle or plugin (PLUGIN_OWNER) owner. Eg, "spez".
+  string owner = 2;
+  // Bundle or plugin version. Eg, 1.2.3 or 1.2.3.0.
+  string version = 3;
+}
+
+// See also LinkedBundle.
+enum LinkedBundleTargetPlatform {
+  // A LinkedBundle for browser runtimes.
+  BROWSER = 0;
+  // A LinkedBundle for V8 runtimes.
+  V8 = 1;
+  // An API definition that cannot be executed. This is a LinkedBundle with no
+  // code and no dependencies.
+  SKINNY = 2;
+}
+
+// Permitted and forbidden execution environments.
+message LocationFilter {
+  repeated string allow = 1;
+  repeated string deny = 2;
+}
+
+message Permissions {
+  // List of fetch domains requested by the app.
+  repeated string requested_fetch_domains = 1;
+  // List of scopes that dictate what the app can run on behalf of the user.
+  repeated .reddit.devvit.app_permission.v1.Scope as_user_scopes = 2;
+}
+
+// A provided implementation specified by a Bundle or plugin. See
+// Config.provides() and DependencySpec.provides.
+message PackageSpec {
+  ActorSpec actor = 1;
+  // The version provided.
+  devvit.runtime.SerializableServiceDefinition definition = 2;
+  LocationFilter locations = 3;
+  repeated string partitions_by = 4;
+}
+
+// A dependency use requirement specified by a Bundle or plugin. See
+// Config.use() and DependencySpec.uses. Dependencies may resolve to different
+// implementations in different execution environments.
+message PackageQuery {
+  // Limit resolution to a Bundle or plugins (PLUGIN_APP_NAME). Eg,
+  // com.devvit.example/foo.
+  google.protobuf.StringValue name = 1;
+  // Limit resolution to owner. Eg, com.reddit.
+  google.protobuf.StringValue owner = 2;
+  // Limit resolution to type. No slashes. Eg,
+  // "devvit.plugin.logger.Logger". See Definition.fullName.
+  string type_name = 3;
+  // Limit resolution to versions. Eg, ">=0" or "1.0.0".
+  google.protobuf.StringValue versions = 4;
+}
+
+// Dependencies offered and required by a Bundle or plugin. See Config.export().
+message DependencySpec {
+  ActorSpec actor = 1;
+  // Actor hostname. This may be a plugin or a user actor. Eg,
+  // "fd23937c-2891-44ed-a66c-5277265cfd54.pixelary-game.main.devvit-gateway.reddit.com":
+  //
+  // | Prisma Installation.id               | devvit.yaml app name / slug | ActorSpec.name |                           |
+  // | ------------------------------------ | --------------------------- | -------------- | ------------------------- |
+  // | fd23937c-2891-44ed-a66c-5277265cfd54 | pixelary-game               | main           | devvit-gateway.reddit.com |
+  //
+  // Which corresponds to the V8 LinkedBundle at
+  // https://devvit-gateway.reddit.com/bundles/fd23937c-2891-44ed-a66c-5277265cfd54/main/0.0.8-359.
+  //
+  // Multi-actor apps are deprecated so app name is usually what's most
+  // important. Plugins are simpler. Eg, "http.plugins.local".
+  string hostname = 2;
+  repeated PackageSpec provides = 3;
+  repeated PackageQuery uses = 4;
+  repeated Permissions permissions = 5;
+}
+
+// A fully built actor (either a user app or plugin). This resolved Bundle is
+// ready for execution by the runtime.
+message LinkedBundle {
+  ActorSpec actor = 1;
+  // Compiled bundle or plugin code. A hostname and empty code implies that the
+  // runtime should resolve this as a remote actor accessible over the network;
+  // this is empty for "skinny bundles" (AKA Gateway bundles).
+  string code = 2;
+  // Source map accompanying code. This should be a JSON string containing the
+  // source map bundle accompanying the code. Not required.
+  google.protobuf.StringValue source_map = 10;
+  // Actor hostname. This may be a plugin or a user. See DependencySpec.hostname
+  // which Community Portal copies here.
+  string hostname = 3;
+  repeated SerializableServiceDefinition provides = 4;
+  // True dependencies. This is empty for skinny bundles which describe the
+  // input / output API only. They have no code and cannot be executed so their
+  // dependencies are not needed.
+  repeated LinkedBundle uses = 5;
+  // Optional information about the environment the code was built in. Outdated
+  // dependencies may indicate an invalid build.
+  BuildInfo build_info = 6;
+
+  // Where did the uploaded ./assets folder land?  This is a URL to the FileSystem
+  // as JSON that contains the assets.
+  google.protobuf.StringValue assets_url = 7 [deprecated = true];
+
+  // This map is used to resolve relative asset paths to URLs. The key
+  // is the path to the asset, and the value is the URL to the asset.
+  // e.g. `"images/example.png": "https://i.redd.it/example.png"`. May include
+  // the app icon as `$devvit_icon.png`.
+  map<string, string> assets = 8;
+
+  // This map is used to resolve assets for the webview block. These are uploaded
+  // to S3 and servable as static contents from CDN.
+  map<string, string> webview_assets = 9;
+
+  // This map is used to resolve a sku to a UUID used by the Payment platform to identify the product
+  map<string, string> products = 11;
+  // Standalone server implementation, without Blocks rendering or "Devvit Classic".
+  // If provided, this code is expected to be an entry point for an HTTP server that can
+  // handle requests at process.env.WEBBIT_PORT. Present in server (UNIVERSAL)
+  // bundles only.
+  ServerBundle server = 12;
+}
+
+// This represents a standalone server implementation that starts an HTTP server
+// to execute on Devvit's compute platform.
+message ServerBundle {
+  // A compiled bundle of code to be executed as-is. Listening on the server port
+  // for HTTP requests should occur through side effects of evaluating this code.
+  string code = 1;
+  // Source map accompanying |code|, used for better stack traces when erorrs occur.
+  // Not required. For specification, see: https://tc39.es/ecma426/
+  string source_map = 2;
+}
+
+enum TargetRuntime {
+  // Server-only as of 2025-06-04 or so.
+  UNIVERSAL = 0;
+  CLIENT = 1;
+}
+
+// Detail about the tooling used to construct a LinkedBundle.
+message BuildInfo {
+  // When the LinkedBundle was built.
+  google.protobuf.Timestamp created = 1;
+  // Notable package.json versions recorded at build time. Eg:
+  //
+  //   @devvit/protos → 1.2.3
+  //   @devvit/public-api → 4.5.6
+  //   node → 7.8.9
+  map<string, string> dependencies = 2;
+  // Where the bundle can be executed
+  TargetRuntime target_runtime = 3;
+}

package/schema/.snootobuf/deps/devvit/runtime/runtime_common.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+
+package devvit.runtime;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/runtime";
+option java_package = "com.reddit.devvit.runtime";
+
+message Strings {
+  repeated string values = 1;
+}

package/schema/.snootobuf/deps/devvit/runtime/serializable.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package devvit.runtime;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/runtime";
+option java_package = "com.reddit.devvit.runtime";
+
+// A Definition subset representable as JSON.
+message SerializableServiceDefinition {
+  // No slashes. Eg, "devvit.plugin.logger.Logger".
+  string full_name = 1;
+  repeated SerializableMethodDefinition methods = 2;
+  // Eg, "Logger".
+  string name = 3;
+  string version = 4;
+}
+
+// A MethodDefinition subset representable as JSON.
+message SerializableMethodDefinition {
+  // Leading slash. Eg, "/devvit.plugin.logger.Logger/Log".
+  string full_name = 1;
+  // Eg, "Log".
+  string name = 2;
+  bool request_stream = 3;
+  bool response_stream = 4;
+  string request_type = 5;
+  string response_type = 6;
+}

package/schema/.snootobuf/deps/devvit/service/bundle_service.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+
+package devvit.service;
+
+import "devvit/runtime/bundle.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/service";
+
+// Fetch a bundle
+message BundleRequest {
+  // Must be an identifier for the bundle, i.e. an app ID (UUID) in prod, or "untitled-1234567890" from play
+  string actor_id = 1;
+}
+
+service BundleService {
+  // Upload a bundle to the bundle repo
+  rpc Upload(devvit.runtime.LinkedBundle) returns (google.protobuf.Empty);
+
+  // Retrieve a bundle from the bundle repo
+  rpc Fetch(BundleRequest) returns (devvit.runtime.LinkedBundle);
+}

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

@@ -0,0 +1,162 @@
+syntax = "proto3";
+
+package devvit.data.triggers.v1alpha;
+
+import "devvit/events/v1alpha/events.proto";
+import "devvit/options/options.proto";
+import "devvit/reddit/v2alpha/modaction.proto";
+import "devvit/reddit/v2alpha/modmail.proto";
+import "google/protobuf/descriptor.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/devplatform-api/go/grpc/devvit/triggers/v1alpha";
+
+message TriggerEvent {
+  string id = 1; // UUID for the event
+  google.protobuf.Timestamp timestamp = 2; // Event timestamp
+
+  string subreddit = 3;
+
+  oneof type {
+    devvit.events.v1alpha.PostSubmit post_submit = 100 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.PostCreate post_create = 113 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = POST_CREATE
+    ];
+    devvit.events.v1alpha.PostUpdate post_update = 101 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = POST_EDIT
+    ];
+    devvit.events.v1alpha.PostReport post_report = 102 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.PostFlairUpdate post_flair_update = 109 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.PostDelete post_delete = 111 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = POST_DELETE
+    ];
+
+    devvit.events.v1alpha.CommentSubmit comment_submit = 103 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.CommentCreate comment_create = 114 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = COMMENT_CREATE
+    ];
+    devvit.events.v1alpha.CommentUpdate comment_update = 104 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = COMMENT_EDIT
+    ];
+    devvit.events.v1alpha.CommentReport comment_report = 105 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.CommentDelete comment_delete = 112 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = COMMENT_DELETE
+    ];
+
+    devvit.events.v1alpha.SubredditSubscribe subreddit_subscribe = 106 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.events.v1alpha.AppInstall app_install = 107 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    devvit.events.v1alpha.AppUpgrade app_upgrade = 108 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.reddit.v2alpha.ModAction mod_action = 110 [
+      (devvit.options.deliver_to) = {
+        to: [
+          GATEWAY,
+          FIREHOSE
+        ]
+      },
+      (devvit.options.firehose_event_type) = MOD_ACTION
+    ];
+
+    devvit.reddit.v2alpha.ModMail mod_mail = 115 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.events.v1alpha.AccountDelete account_delete = 116 [
+      (devvit.options.deliver_to) = {
+        to: [FIREHOSE]
+      },
+      (devvit.options.firehose_event_type) = ACCOUNT_DELETE
+    ];
+
+    devvit.events.v1alpha.Vote vote = 117 [
+      (devvit.options.deliver_to) = {
+        to: [FIREHOSE]
+      },
+      (devvit.options.firehose_event_type) = VOTE
+    ];
+
+    devvit.events.v1alpha.PostApprove post_approve = 118 [
+      (devvit.options.deliver_to) = {
+        to: [FIREHOSE]
+      },
+      (devvit.options.firehose_event_type) = POST_APPROVE
+    ];
+
+    devvit.events.v1alpha.CommentApprove comment_approve = 119 [
+      (devvit.options.deliver_to) = {
+        to: [FIREHOSE]
+      },
+      (devvit.options.firehose_event_type) = COMMENT_APPROVE
+    ];
+
+    devvit.events.v1alpha.PostNsfwUpdate nsfw_post_update = 120 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.events.v1alpha.PostSpoilerUpdate spoiler_post_update = 121 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.events.v1alpha.AutomoderatorFilterPost automoderator_filter_post = 122 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+
+    devvit.events.v1alpha.AutomoderatorFilterComment automoderator_filter_comment = 123 [(devvit.options.deliver_to) = {
+      to: [GATEWAY]
+    }];
+    // NEXT: 124
+  }
+}

package/schema/.snootobuf/deps/devvit/ui/block_kit/v1beta/attributes.proto

@@ -0,0 +1,69 @@
+syntax = "proto3";
+
+package devvit.ui.block_kit.v1beta;
+
+import "devvit/ui/block_kit/v1beta/enums.proto";
+import "google/protobuf/struct.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/ui/block_kit/v1beta";
+option java_package = "com.reddit.devvit.ui.block_kit.v1beta";
+
+message BlockAlignment {
+  optional BlockVerticalAlignment vertical = 1;
+  optional BlockHorizontalAlignment horizontal = 2;
+}
+
+message BlockBorder {
+  // @deprecated use colors instead
+  optional string color = 1 [deprecated = true];
+  optional BlockBorderWidth width = 2;
+  optional BlockColor colors = 3;
+}
+
+message BlockSizes {
+  message Dimension {
+    message Value {
+      float value = 1;
+      BlockSizeUnit unit = 2;
+    }
+
+    optional Value value = 1;
+    optional Value min = 2;
+    optional Value max = 3;
+  }
+
+  optional bool grow = 1;
+
+  optional Dimension width = 2;
+
+  optional Dimension height = 3;
+}
+
+// @deprecated Use BlockSizing
+message BlockSize {
+  // Grow this element to fill any free space in the container
+  optional bool grow = 1;
+
+  // Width
+  optional float width = 2;
+
+  // Unit of the width value
+  optional BlockSizeUnit width_unit = 4;
+
+  // Height
+  optional float height = 3;
+
+  // Unit of the height value
+  optional BlockSizeUnit height_unit = 5;
+}
+
+message BlockAction {
+  BlockActionType type = 1;
+  string id = 2;
+  google.protobuf.Struct data = 3;
+}
+
+message BlockColor {
+  optional string light = 1;
+  optional string dark = 2;
+}