ctor for Input User/Channel with mandatory access_hash parameter

.github/dev.yml

@@ -2,7 +2,7 @@ pr: none
 trigger:
 - master
 
-name: 2.1.4-dev.$(Rev:r)
+name: 2.2.1-dev.$(Rev:r)
 
 pool:
   vmImage: ubuntu-latest

.github/release.yml

@@ -1,7 +1,7 @@
 pr: none
 trigger: none
 
-name: 2.1.$(Rev:r)
+name: 2.2.$(Rev:r)
 
 pool:
   vmImage: ubuntu-latest

Examples/Program_CollectAccessHash.cs

@@ -61,7 +61,7 @@ namespace WTelegramClientTest
 			}
 
 			Console.WriteLine("With the access hash, we can now join the channel for example.");
-			await client.Channels_JoinChannel(new InputChannel { channel_id = DurovID, access_hash = durovAccessHash });
+			await client.Channels_JoinChannel(new InputChannel(DurovID, durovAccessHash));
 
 			Console.WriteLine("Channel joined. Press any key to save and exit");
 			Console.ReadKey(true);

src/TL.Extensions.cs

@@ -112,7 +112,7 @@ namespace TL
 								}
 								textUrl.url = sb.ToString(offset + 2, offset2 - offset - 3);
 								if (textUrl.url.StartsWith("tg://user?id=") && long.TryParse(textUrl.url[13..], out var user_id) && client.GetAccessHashFor<User>(user_id) is long hash)
-									entities[lastIndex] = new InputMessageEntityMentionName { offset = textUrl.offset, length = textUrl.length, user_id = new InputUser { user_id = user_id, access_hash = hash } };
+									entities[lastIndex] = new InputMessageEntityMentionName { offset = textUrl.offset, length = textUrl.length, user_id = new InputUser(user_id, hash) };
 								sb.Remove(offset, offset2 - offset);
 								break;
 							}
@@ -287,7 +287,7 @@ namespace TL
 							{
 								tag = tag[8..^1];
 								if (tag.StartsWith("tg://user?id=") && long.TryParse(tag[13..], out var user_id) && client.GetAccessHashFor<User>(user_id) is long hash)
-									entities.Add(new InputMessageEntityMentionName { offset = offset, length = -1, user_id = new InputUser { user_id = user_id, access_hash = hash } });
+									entities.Add(new InputMessageEntityMentionName { offset = offset, length = -1, user_id = new InputUser(user_id, hash) });
 								else
 									entities.Add(new MessageEntityTextUrl { offset = offset, length = -1, url = tag });
 							}

src/TL.Helpers.cs

@@ -15,8 +15,26 @@ namespace TL
 	}
 
 	partial class InputPeer				{ public static InputPeerSelf Self => new(); }
-	partial class InputPeerChannel		{ public static implicit operator InputChannel(InputPeerChannel channel) => new() { channel_id = channel.channel_id, access_hash = channel.access_hash }; }
-	partial class InputPeerUser			{ public static implicit operator InputUser(InputPeerUser user) => new() { user_id = user.user_id, access_hash = user.access_hash }; }
+	partial class InputPeerChat
+	{
+		/// <summary>⚠ Only for small private Chat. Chat groups of type Channel must use InputPeerChannel. See <see href="https://github.com/wiz0u/WTelegramClient/blob/master/README.md#terminology">Terminology</see> in README</summary>
+		/// <param name="chat_id">Chat identifier</param>
+		public InputPeerChat(long chat_id) => this.chat_id = chat_id;
+	}
+	partial class InputPeerUser
+	{
+		/// <param name="user_id">User identifier</param>
+		/// <param name="access_hash">⚠ <b>REQUIRED FIELD</b>. See FAQ for how to obtain it<br/><strong>access_hash</strong> value from the <see cref="User"/> constructor</param>
+		public InputPeerUser(long user_id, long access_hash) { this.user_id = user_id; this.access_hash = access_hash; }
+		public static implicit operator InputUser(InputPeerUser user) => new(user.user_id, user.access_hash);
+	}
+	partial class InputPeerChannel
+	{
+		/// <param name="channel_id">Channel identifier</param>
+		/// <param name="access_hash">⚠ <b>REQUIRED FIELD</b>. See FAQ for how to obtain it<br/><strong>access_hash</strong> value from the <see cref="Channel"/> constructor</param>
+		public InputPeerChannel(long channel_id, long access_hash) { this.channel_id = channel_id; this.access_hash = access_hash; }
+		public static implicit operator InputChannel(InputPeerChannel channel) => new(channel.channel_id, channel.access_hash);
+	}
 
 	partial class InputUserBase			{ public abstract long? UserId { get; } }
 	partial class InputUserSelf			{ public override long? UserId => null; }
@@ -25,7 +43,10 @@ namespace TL
 	{
 		public override long? UserId => user_id;
 		public static InputUserSelf Self => new();
-		public static implicit operator InputPeerUser(InputUser user) => new() { user_id = user.user_id, access_hash = user.access_hash };
+		/// <param name="user_id">User identifier</param>
+		/// <param name="access_hash">⚠ <b>REQUIRED FIELD</b>. See FAQ for how to obtain it<br/><strong>access_hash</strong> value from the <see cref="User"/> constructor</param>
+		public InputUser(long user_id, long access_hash) { this.user_id = user_id; this.access_hash = access_hash; }
+		public static implicit operator InputPeerUser(InputUser user) => new(user.user_id, user.access_hash);
 	}
 
 	partial class InputFileBase
@@ -95,8 +116,8 @@ namespace TL
 		public override long ID => id;
 		public override bool IsActive => (flags & Flags.deleted) == 0;
 		public override string ToString() => username != null ? '@' + username : last_name == null ? first_name : $"{first_name} {last_name}";
-		public override InputPeer ToInputPeer() => new InputPeerUser { user_id = id, access_hash = access_hash };
-		protected override InputUser ToInputUser() => new() { user_id = id, access_hash = access_hash };
+		public override InputPeer ToInputPeer() => new InputPeerUser(id, access_hash);
+		protected override InputUser ToInputUser() => new(id, access_hash);
 		/// <summary>An estimation of the number of days ago the user was last seen (Online=0, Recently=1, LastWeek=5, LastMonth=20, LongTimeAgo=150)</summary>
 		public TimeSpan LastSeenAgo => status?.LastSeenAgo ?? TimeSpan.FromDays(150);
 	}
@@ -137,7 +158,7 @@ namespace TL
 		public override bool IsActive => (flags & (Flags.kicked | Flags.left | Flags.deactivated)) == 0;
 		public override ChatPhoto Photo => photo;
 		public override bool IsBanned(ChatBannedRights.Flags flags = 0) => ((default_banned_rights?.flags ?? 0) & flags) != 0;
-		public override InputPeer ToInputPeer() => new InputPeerChat { chat_id = id };
+		public override InputPeer ToInputPeer() => new InputPeerChat(id);
 		public override string ToString() => $"Chat \"{title}\"" + (flags.HasFlag(Flags.deactivated) ? " [deactivated]" : null);
 	}
 	partial class ChatForbidden
@@ -145,7 +166,7 @@ namespace TL
 		public override bool IsActive => false;
 		public override ChatPhoto Photo => null;
 		public override bool IsBanned(ChatBannedRights.Flags flags = 0) => true;
-		public override InputPeer ToInputPeer() => new InputPeerChat { chat_id = id };
+		public override InputPeer ToInputPeer() => new InputPeerChat(id);
 		public override string ToString() => $"ChatForbidden {id} \"{title}\"";
 	}
 	partial class Channel
@@ -153,8 +174,8 @@ namespace TL
 		public override bool IsActive => (flags & Flags.left) == 0;
 		public override ChatPhoto Photo => photo;
 		public override bool IsBanned(ChatBannedRights.Flags flags = 0) => ((banned_rights?.flags ?? 0) & flags) != 0 || ((default_banned_rights?.flags ?? 0) & flags) != 0;
-		public override InputPeer ToInputPeer() => new InputPeerChannel { channel_id = id, access_hash = access_hash };
-		public static implicit operator InputChannel(Channel channel) => new() { channel_id = channel.id, access_hash = channel.access_hash };
+		public override InputPeer ToInputPeer() => new InputPeerChannel(id, access_hash);
+		public static implicit operator InputChannel(Channel channel) => new(channel.id, channel.access_hash);
 		public override string ToString() =>
 			(flags.HasFlag(Flags.broadcast) ? "Channel " : "Group ") + (username != null ? '@' + username : $"\"{title}\"");
 		public bool IsChannel => (flags & Flags.broadcast) != 0;
@@ -165,7 +186,7 @@ namespace TL
 		public override bool IsActive => false;
 		public override ChatPhoto Photo => null;
 		public override bool IsBanned(ChatBannedRights.Flags flags = 0) => true;
-		public override InputPeer ToInputPeer() => new InputPeerChannel { channel_id = id, access_hash = access_hash };
+		public override InputPeer ToInputPeer() => new InputPeerChannel(id, access_hash);
 		public override string ToString() => $"ChannelForbidden {id} \"{title}\"";
 	}
 
@@ -395,7 +416,13 @@ namespace TL
 		public static implicit operator InputStickerSetID(StickerSet stickerSet) => new() { id = stickerSet.id, access_hash = stickerSet.access_hash };
 	}
 
-	partial class InputChannel { public static implicit operator InputPeerChannel(InputChannel channel) => new() { channel_id = channel.channel_id, access_hash = channel.access_hash }; }
+	partial class InputChannel
+	{
+		/// <param name="channel_id">Channel identifier</param>
+		/// <param name="access_hash">⚠ <b>REQUIRED FIELD</b>. See FAQ for how to obtain it<br/><strong>access_hash</strong> value from the <see cref="Channel"/> constructor</param>
+		public InputChannel(long channel_id, long access_hash) { this.channel_id = channel_id; this.access_hash = access_hash; }
+		public static implicit operator InputPeerChannel(InputChannel channel) => new(channel.channel_id, channel.access_hash);
+	}
 
 	partial class Contacts_ResolvedPeer
 	{

src/TL.Schema.cs

@@ -39,7 +39,7 @@ namespace TL
 	public class InputPeerSelf : InputPeer { }
 	/// <summary>Defines a chat for further interaction.		<para>See <a href="https://corefork.telegram.org/constructor/inputPeerChat"/></para></summary>
 	[TLDef(0x35A95CB9)]
-	public class InputPeerChat : InputPeer
+	public partial class InputPeerChat : InputPeer
 	{
 		/// <summary>Chat identifier</summary>
 		public long chat_id;