rugk / threema-msgapi-sdk-php

source/Threema/Console/Command/Base.php

Doc Comments +2 added lines, -2 removed lines

@@ -48,7 +48,7 @@ 
 	 * @param string $subject
 	 * @param string[] $requiredArguments
 	 * @param string $description
-	 * @param array $optionalArguments
+	 * @param string[] $optionalArguments
 	 */
 	public function __construct($subject, array $requiredArguments, $description, array $optionalArguments = array()) {
 		$this->subject = $subject;
@@ -115,7 +115,7 @@ 
 	 * return a valid file path
 	 *
 	 * @param string $pos
-	 * @return null|string
+	 * @return string
 	 * @throws \Threema\Core\Exception
 	 */
 	public function getArgumentFile($pos) {

source/Threema/Core/AssocArray.php

Doc Comments +2 added lines, -2 removed lines

@@ -36,8 +36,8 @@
 	}
 
 	/**
-	 * @param $string
-	 * @param array|null $requiredKeys
+	 * @param string $string
+	 * @param string[] $requiredKeys
 	 * @return AssocArray
 	 * @throws Exception
 	 */

source/Threema/MsgApi/Commands/DownloadFile.php

Doc Comments +1 added lines, -1 removed lines

@@ -40,7 +40,7 @@
 	/**
 	 * @param int $httpCode
 	 * @param object $res
-	 * @return UploadFileResult
+	 * @return DownloadFileResult
 	 */
 	function parseResult($httpCode, $res){
 		return new DownloadFileResult($httpCode, $res);

source/Threema/MsgApi/Helpers/ReceiveMessageResult.php

Doc Comments +2 added lines, -2 removed lines

@@ -73,7 +73,7 @@ 
 	}
 
 	/**
-	 * @return \string[]
+	 * @return string[]
 	 */
 	public function getErrors() {
 		return $this->errors;
@@ -87,7 +87,7 @@ 
 	}
 
 	/**
-	 * @return \string[]
+	 * @return string[]
 	 */
 	public function getFiles() {
 		return $this->files;

source/Threema/MsgApi/Messages/DeliveryReceipt.php

Doc Comments +1 added lines, -1 removed lines

@@ -65,7 +65,7 @@
 
 	/**
 	 * Get the acknowledged message ids
-	 * @return array
+	 * @return string[]
 	 */
 	public function getAckedMessageIds() {
 		return $this->ackedMessageIds;

source/Threema/MsgApi/Tools/CryptTool.php

Doc Comments +16 added lines, -4 removed lines

@@ -145,6 +145,11 @@ 
 		return $this->makeBox($message, $nonce, $senderPrivateKey, $recipientPublicKey);
 	}
 
+	/**
+	 * @param string $senderPrivateKey
+	 * @param string $recipientPublicKey
+	 * @param string $nonce
+	 */
 	final public function encryptFileMessage(UploadFileResult $uploadFileResult,
 											 EncryptResult $encryptResult,
 											 UploadFileResult $thumbnailUploadFileResult = null,
@@ -193,9 +198,9 @@ 
 	 * make a secret box
 	 *
 	 * @param $data
-	 * @param $nonce
+	 * @param string $nonce
 	 * @param $key
-	 * @return mixed
+	 * @return string
 	 */
 	abstract protected function makeSecretBox($data, $nonce, $key);
 
@@ -337,6 +342,9 @@ 
 		return hash_hmac('sha256', $phoneNoClean, self::PHONENO_HMAC_KEY);
 	}
 
+	/**
+	 * @return string
+	 */
 	abstract protected function createRandom($size);
 
 	/**
@@ -379,7 +387,7 @@ 
 	abstract public function validate();
 
 	/**
-	 * @param $data
+	 * @param string $data
 	 * @return EncryptResult
 	 */
 	public final function encryptFile($data) {
@@ -391,7 +399,7 @@ 
 	/**
 	 * @param string $data as binary
 	 * @param string $key as binary
-	 * @return null|string
+	 * @return string
 	 */
 	public final function decryptFile($data, $key) {
 		$result =  $this->openSecretBox($data, self::FILE_NONCE, $key);
@@ -408,6 +416,10 @@ 
 		return new EncryptResult($box, $key,  self::FILE_THUMBNAIL_NONCE, strlen($box));
 	}
 
+	/**
+	 * @param string $data
+	 * @param string $key
+	 */
 	public final function decryptFileThumbnail($data, $key) {
 		$result = $this->openSecretBox($data, self::FILE_THUMBNAIL_NONCE, $key);
 		return false === $result ? null : $result;