@devvit/protos 0.11.20-next-2025-07-23-16-35-06-4e9bd2820.0 → 0.11.20-next-2025-07-23-18-03-59-68cb855f3.0

package/schema/.snootobuf/deps/devvit/ui/effects/web_view/v1alpha/context.proto

@@ -7,7 +7,29 @@ import "google/protobuf/struct.proto";
 option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/ui/effects/web_view/v1alpha";
 option java_package = "com.reddit.devvit.ui.effects.web_view.v1alpha";
 
+// Initialization data sent from the client (Shreddit, Android, iOS) to the
+// web view.
+message BridgeContext {
+  // to-do: use webbit_token once it is a superset of DevvitPostData and a
+  //        decoder is available.
+  DevvitPostData post_data = 1 [deprecated = true];
+  ShareParam share_param = 2;
+  // to-do: use webbit_token once it is a superset of WebViewContext.
+  WebViewContext web_view_context = 3 [deprecated = true];
+  // Signed WebbitToken user JWT (header, payload, signature base64 strings
+  // separated by dots). Users shouldn't share their JWTs with others, but
+  // perfectly fine for a given user to see. Named WebbitToken to match GQL's
+  // definition. Eg:
+  //   eyJhbGciOiJIUzI1NiIsImtpZCI6ImVlYzJjOWUzLWM0NTctNTM3Zi05NThmLTI5MDg3N2U4NjNlYyIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJkZXZ2aXQtZ2F0ZXdheS5yZWRkaXQuY29tIiwiYXVkIjpbIjhlMGUwZWI3LTc0NzgtNGVmMS1hNGZmLTk5NTlmMTkzZmNkMC0wLTAtOS13ZWJ2aWV3LmRldnZpdC5uZXQiXSwiZXhwIjoxNzUzMzcxODU2LCJuYmYiOjE3NTMyODU0NTYsImlhdCI6MTc1MzI4NTQ1NiwianRpIjoiYTA5NWMyOTktOWJkNS00MGUzLWEyYTEtYzhkYTBiMDc0ZjRhIiwiZGV2dml0LXBvc3QtaWQiOiJ0M18xbTdjcHZxIiwiZGV2dml0LXBvc3QtZGF0YSI6e30sImRldnZpdC11c2VyLWlkIjoidDJfazZsZGJqaDMiLCJkZXZ2aXQtaW5zdGFsbGF0aW9uIjoiOGUwZTBlYjctNzQ3OC00ZWYxLWE0ZmYtOTk1OWYxOTNmY2QwIn0.6M4NKCUsB4kWhZmslE909IL-hf2FAVMrkjB-peaHLHc
+  string webbit_token = 4;
+  // Untrusted unknown debug user data passed in the case-insensitive
+  // `devvitdebug` query param of the hosting
+  // window (eg, `reddit.com?devvitdebug=...`).
+  string devvit_debug = 5;
+}
+
 message WebViewContext {
+  option deprecated = true;
   // Subreddit Thing ID (t5)
   string subreddit_id = 1;
   string subreddit_name = 2;
@@ -28,3 +50,26 @@ message DevvitPostData {
   // Developer-provided data on the Post, in JSON format. This is what developers set via submitPost({ postData: {...} }). Eg: { "riddle": "hello world" }
   google.protobuf.Struct developer_data = 2;
 }
+
+// App deep link. Passed in case-insensitive `devvitshare` query param of the
+// hosting window (eg, `reddit.com?devvitshare=...`) as user data.
+//
+//   url.searchParams.set(
+//     JSON.stringify({params: {foo: 'bar'}, path: '/a/b/c/index.html', hash: '#abc'} satisfies ShareParam) // Encodes.
+//   )
+//   const shareParam: ShareParam | undefined = JSON.parse(
+//     url.searchParams.get('devvitshare') || '{}' // Decodes.
+//   ) ?? undefined
+//   ...Verify user data...
+//
+// Links are always assumed to use PDP.
+message ShareParam {
+  // Everything after and including the first /. Aligns to
+  // https://developer.mozilla.org/en-US/docs/Web/API/URL/pathname.
+  string path = 1;
+  // URL query parameters (key-value).
+  map<string, string> params = 2;
+  // Everything after and including the first #. Aligns to
+  // https://developer.mozilla.org/en-US/docs/Web/API/URL/hash.
+  string hash = 3;
+}

package/schema/devvit/ui/effects/web_view/v1alpha/context.proto

@@ -7,7 +7,29 @@ import "google/protobuf/struct.proto";
 option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/ui/effects/web_view/v1alpha";
 option java_package = "com.reddit.devvit.ui.effects.web_view.v1alpha";
 
+// Initialization data sent from the client (Shreddit, Android, iOS) to the
+// web view.
+message BridgeContext {
+  // to-do: use webbit_token once it is a superset of DevvitPostData and a
+  //        decoder is available.
+  DevvitPostData post_data = 1 [deprecated = true];
+  ShareParam share_param = 2;
+  // to-do: use webbit_token once it is a superset of WebViewContext.
+  WebViewContext web_view_context = 3 [deprecated = true];
+  // Signed WebbitToken user JWT (header, payload, signature base64 strings
+  // separated by dots). Users shouldn't share their JWTs with others, but
+  // perfectly fine for a given user to see. Named WebbitToken to match GQL's
+  // definition. Eg:
+  //   eyJhbGciOiJIUzI1NiIsImtpZCI6ImVlYzJjOWUzLWM0NTctNTM3Zi05NThmLTI5MDg3N2U4NjNlYyIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJkZXZ2aXQtZ2F0ZXdheS5yZWRkaXQuY29tIiwiYXVkIjpbIjhlMGUwZWI3LTc0NzgtNGVmMS1hNGZmLTk5NTlmMTkzZmNkMC0wLTAtOS13ZWJ2aWV3LmRldnZpdC5uZXQiXSwiZXhwIjoxNzUzMzcxODU2LCJuYmYiOjE3NTMyODU0NTYsImlhdCI6MTc1MzI4NTQ1NiwianRpIjoiYTA5NWMyOTktOWJkNS00MGUzLWEyYTEtYzhkYTBiMDc0ZjRhIiwiZGV2dml0LXBvc3QtaWQiOiJ0M18xbTdjcHZxIiwiZGV2dml0LXBvc3QtZGF0YSI6e30sImRldnZpdC11c2VyLWlkIjoidDJfazZsZGJqaDMiLCJkZXZ2aXQtaW5zdGFsbGF0aW9uIjoiOGUwZTBlYjctNzQ3OC00ZWYxLWE0ZmYtOTk1OWYxOTNmY2QwIn0.6M4NKCUsB4kWhZmslE909IL-hf2FAVMrkjB-peaHLHc
+  string webbit_token = 4;
+  // Untrusted unknown debug user data passed in the case-insensitive
+  // `devvitdebug` query param of the hosting
+  // window (eg, `reddit.com?devvitdebug=...`).
+  string devvit_debug = 5;
+}
+
 message WebViewContext {
+  option deprecated = true;
   // Subreddit Thing ID (t5)
   string subreddit_id = 1;
   string subreddit_name = 2;
@@ -28,3 +50,26 @@ message DevvitPostData {
   // Developer-provided data on the Post, in JSON format. This is what developers set via submitPost({ postData: {...} }). Eg: { "riddle": "hello world" }
   google.protobuf.Struct developer_data = 2;
 }
+
+// App deep link. Passed in case-insensitive `devvitshare` query param of the
+// hosting window (eg, `reddit.com?devvitshare=...`) as user data.
+//
+//   url.searchParams.set(
+//     JSON.stringify({params: {foo: 'bar'}, path: '/a/b/c/index.html', hash: '#abc'} satisfies ShareParam) // Encodes.
+//   )
+//   const shareParam: ShareParam | undefined = JSON.parse(
+//     url.searchParams.get('devvitshare') || '{}' // Decodes.
+//   ) ?? undefined
+//   ...Verify user data...
+//
+// Links are always assumed to use PDP.
+message ShareParam {
+  // Everything after and including the first /. Aligns to
+  // https://developer.mozilla.org/en-US/docs/Web/API/URL/pathname.
+  string path = 1;
+  // URL query parameters (key-value).
+  map<string, string> params = 2;
+  // Everything after and including the first #. Aligns to
+  // https://developer.mozilla.org/en-US/docs/Web/API/URL/hash.
+  string hash = 3;
+}