Add PICSGetPrivateBeta

Author: xPaw

SteamKit2/SteamKit2/Steam/Handlers/SteamApps/Callbacks.cs

@@ -794,5 +794,39 @@ internal CheckAppBetaPasswordCallback( IPacketMsg packetMsg )
                 }
             }
         }
+
+        /// <summary>
+        /// This callback is received when a private beta request has been completed
+        /// </summary>
+        public sealed class PrivateBetaCallback : CallbackMsg
+        {
+            /// <summary>
+            /// Result of the operation
+            /// </summary>
+            public EResult Result { get; set; }
+            /// <summary>
+            /// Gets the keyvalue info to be merged into main appinfo
+            /// </summary>
+            public KeyValue DepotSection { get; private set; }
+
+            internal PrivateBetaCallback( IPacketMsg packetMsg )
+            {
+                var response = new ClientMsgProtobuf<CMsgClientPICSPrivateBetaResponse>( packetMsg );
+                var msg = response.Body;
+
+                JobID = response.TargetJobID;
+
+                Result = ( EResult )msg.eresult;
+
+                this.DepotSection = new KeyValue();
+
+                if ( msg.depot_section != null && msg.depot_section.Length > 0 )
+                {
+                    // we don't want to read the trailing null byte
+                    using var ms = new MemoryStream( msg.depot_section, 0, msg.depot_section.Length - 1 );
+                    this.DepotSection.ReadAsText( ms );
+                }
+            }
+        }
     }
 }

SteamKit2/SteamKit2/Steam/Handlers/SteamApps/SteamApps.cs

@@ -59,6 +59,7 @@ public PICSRequest( uint id = 0, ulong access_token = 0 )
             EMsg.ClientPICSProductInfoResponse => new PICSProductInfoCallback( packetMsg ),
             EMsg.ClientUpdateGuestPassesList => new GuestPassListCallback( packetMsg ),
             EMsg.ClientCheckAppBetaPasswordResponse => new CheckAppBetaPasswordCallback( packetMsg ),
+            EMsg.ClientPICSPrivateBetaResponse => new PrivateBetaCallback( packetMsg ),
             _ => null,
         };
 
@@ -298,6 +299,31 @@ public AsyncJob<LegacyGameKeyCallback> GetLegacyGameKey( uint appid )
             return new AsyncJob<LegacyGameKeyCallback>( this.Client, request.SourceJobID );
         }
 
+        /// <summary>
+        /// Submit a beta password for a given app to retrieve any betas and their encryption keys.
+        /// Results are returned in a <see cref="CheckAppBetaPasswordCallback"/> callback.
+        /// The returned <see cref="AsyncJob{T}"/> can also be awaited to retrieve the callback result.
+        /// </summary>
+        /// <param name="app">App id requested.</param>
+        /// <param name="accessToken">Access token associated with the app.</param>
+        /// <param name="branch">The branch name.</param>
+        /// <param name="branchPasswordHash">The branch password from <see cref="CheckAppBetaPasswordCallback"/></param>
+        /// <returns>The Job ID of the request. This can be used to find the appropriate <see cref="CheckAppBetaPasswordCallback"/>.</returns>
+        public AsyncJob<PrivateBetaCallback> PICSGetPrivateBeta( uint app, ulong accessToken, string branch, byte[] branchPasswordHash )
+        {
+            var request = new ClientMsgProtobuf<CMsgClientPICSPrivateBetaRequest>( EMsg.ClientPICSPrivateBetaRequest );
+            request.SourceJobID = Client.GetNextJobID();
+
+            request.Body.appid = app;
+            request.Body.access_token = accessToken;
+            request.Body.beta_name = branch;
+            request.Body.password_hash = branchPasswordHash;
+
+            this.Client.Send( request );
+
+            return new AsyncJob<PrivateBetaCallback>( this.Client, request.SourceJobID );
+        }
+
         /// <summary>
         /// Handles a client message. This should not be called directly.
         /// </summary>