Mark targeted messages and reactions as preview

Libraries/Microsoft.Teams.Api/Activities/Activity.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+using System.Diagnostics.CodeAnalysis;
 using System.Text.Json;
 using System.Text.Json.Serialization;
 
@@ -146,6 +147,7 @@ public partial class Activity : IActivity
     public ChannelData? ChannelData { get; set; }
 
     [JsonIgnore]
+    [Experimental("TEAMS0002")]
     public bool IsTargeted { get; set; }
 
     [JsonExtensionData]
@@ -226,13 +228,18 @@ public virtual Activity WithRelatesTo(ConversationReference value)
 
     public virtual Activity WithRecipient(Account value)
     {
+        #pragma warning disable TEAMS0002
         return WithRecipient(value, false);
+        #pragma warning restore TEAMS0002
     }
 
+    [Experimental("TEAMS0002")]
     public virtual Activity WithRecipient(Account value, bool isTargeted)
     {
         Recipient = value;
+        #pragma warning disable TEAMS0002
         IsTargeted = isTargeted;
+        #pragma warning restore TEAMS0002
         return this;
     }
 
@@ -423,10 +430,12 @@ public Activity Merge(Activity from)
         LocalTimestamp ??= from.LocalTimestamp;
         AddEntity(from.Entities?.ToArray() ?? []);
 
+        #pragma warning disable TEAMS0002
         if (from.IsTargeted)
         {
             IsTargeted = true;
         }
+        #pragma warning restore TEAMS0002
 
         if (from.ChannelData is not null)
         {

Libraries/Microsoft.Teams.Api/Activities/Message/MessageActivity.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+using System.Diagnostics.CodeAnalysis;
 using System.Text.Json.Serialization;
 
 using Microsoft.Teams.Api.Entities;
@@ -63,7 +64,7 @@ public class MessageActivity : Activity
     [JsonPropertyName("value")]
     [JsonPropertyOrder(43)]
     public object? Value { get; set; }
-        
+
     [JsonIgnore]
     public bool IsRecipientMentioned
     {
@@ -151,10 +152,13 @@ public override MessageActivity WithRecipient(Account value)
         return (MessageActivity)base.WithRecipient(value);
     }
 
+    [Experimental("TEAMS0002")]
+    #pragma warning disable TEAMS0002
     public override MessageActivity WithRecipient(Account value, bool isTargeted = false)
     {
         return (MessageActivity)base.WithRecipient(value, isTargeted);
     }
+    #pragma warning restore TEAMS0002
 
     public MessageActivity AddAttachment(params Attachment[] value)
     {

Libraries/Microsoft.Teams.Api/Activities/Message/MessageReactionActivity.cs

@@ -1,6 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+#pragma warning disable TEAMS0001
+
 using System.Text.Json.Serialization;
 
 using Microsoft.Teams.Common;
@@ -80,4 +82,5 @@ public MessageReactionActivity RemoveReaction(Messages.ReactionType type)
         ReactionsRemoved.Add(new() { Type = type });
         return this;
     }
-}
+}
+#pragma warning restore TEAMS0001

Libraries/Microsoft.Teams.Api/Clients/ActivityClient.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+using System.Diagnostics.CodeAnalysis;
 using System.Text.Json;
 
 using Microsoft.Teams.Api.Activities;
@@ -94,6 +95,7 @@ public async Task DeleteAsync(string conversationId, string id)
     /// <param name="conversationId">The ID of the conversation</param>
     /// <param name="activity">The activity to create</param>
     /// <returns>The created activity resource</returns>
+    [Experimental("TEAMS0002")]
     public async Task<Resource?> CreateTargetedAsync(string conversationId, IActivity activity)
     {
         var req = HttpRequest.Post(
@@ -116,6 +118,7 @@ public async Task DeleteAsync(string conversationId, string id)
     /// <param name="id">The ID of the activity to update</param>
     /// <param name="activity">The updated activity data</param>
     /// <returns>The updated activity resource</returns>
+    [Experimental("TEAMS0002")]
     public async Task<Resource?> UpdateTargetedAsync(string conversationId, string id, IActivity activity)
     {
         var req = HttpRequest.Put(
@@ -136,6 +139,7 @@ public async Task DeleteAsync(string conversationId, string id)
     /// </summary>
     /// <param name="conversationId">The ID of the conversation</param>
     /// <param name="id">The ID of the activity to delete</param>
+    [Experimental("TEAMS0002")]
     public async Task DeleteTargetedAsync(string conversationId, string id)
     {
         var req = HttpRequest.Delete(

Libraries/Microsoft.Teams.Api/Clients/ConversationClient.cs

@@ -13,38 +13,48 @@ public class ConversationClient : Client
     public readonly string ServiceUrl;
     public readonly ActivityClient Activities;
     public readonly MemberClient Members;
+    #pragma warning disable TEAMS0001
     public readonly ReactionClient Reactions;
+    #pragma warning restore TEAMS0001
 
     public ConversationClient(string serviceUrl, CancellationToken cancellationToken = default) : base(cancellationToken)
     {
         ServiceUrl = serviceUrl;
         Activities = new ActivityClient(serviceUrl, _http, cancellationToken);
         Members = new MemberClient(serviceUrl, _http, cancellationToken);
+        #pragma warning disable TEAMS0001
         Reactions = new ReactionClient(serviceUrl, _http, cancellationToken);
+        #pragma warning restore TEAMS0001
     }
 
     public ConversationClient(string serviceUrl, IHttpClient client, CancellationToken cancellationToken = default) : base(client, cancellationToken)
     {
         ServiceUrl = serviceUrl;
         Activities = new ActivityClient(serviceUrl, _http, cancellationToken);
         Members = new MemberClient(serviceUrl, _http, cancellationToken);
+        #pragma warning disable TEAMS0001
         Reactions = new ReactionClient(serviceUrl, _http, cancellationToken);
+        #pragma warning restore TEAMS0001
     }
 
     public ConversationClient(string serviceUrl, IHttpClientOptions options, CancellationToken cancellationToken = default) : base(options, cancellationToken)
     {
         ServiceUrl = serviceUrl;
         Activities = new ActivityClient(serviceUrl, _http, cancellationToken);
         Members = new MemberClient(serviceUrl, _http, cancellationToken);
+        #pragma warning disable TEAMS0001
         Reactions = new ReactionClient(serviceUrl, _http, cancellationToken);
+        #pragma warning restore TEAMS0001
     }
 
     public ConversationClient(string serviceUrl, IHttpClientFactory factory, CancellationToken cancellationToken = default) : base(factory, cancellationToken)
     {
         ServiceUrl = serviceUrl;
         Activities = new ActivityClient(serviceUrl, _http, cancellationToken);
         Members = new MemberClient(serviceUrl, _http, cancellationToken);
+        #pragma warning disable TEAMS0001
         Reactions = new ReactionClient(serviceUrl, _http, cancellationToken);
+        #pragma warning restore TEAMS0001
     }
 
     public async Task<ConversationResource> CreateAsync(CreateRequest request)

Libraries/Microsoft.Teams.Api/Clients/ReactionClient.cs

@@ -1,6 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+using System.Diagnostics.CodeAnalysis;
+
 using Microsoft.Teams.Api.Messages;
 using Microsoft.Teams.Common.Http;
 
@@ -9,6 +11,7 @@ namespace Microsoft.Teams.Api.Clients;
 /// <summary>
 /// Client for working with app message reactions for a given conversation/activity.
 /// </summary>
+[Experimental("TEAMS0001")]
 public class ReactionClient : Client
 {
     public readonly string ServiceUrl;
@@ -91,4 +94,4 @@ public async Task DeleteAsync(
 
         await _http.SendAsync(req, cancellationToken != default ? cancellationToken : _cancellationToken);
     }
-}
+}

Libraries/Microsoft.Teams.Api/Messages/Message.cs

@@ -130,5 +130,7 @@ public class Message
     /// </summary>
     [JsonPropertyName("reactions")]
     [JsonPropertyOrder(16)]
+    #pragma warning disable TEAMS0001
     public IList<Reaction>? Reactions { get; set; }
+    #pragma warning restore TEAMS0001
 }

Libraries/Microsoft.Teams.Api/Messages/Reaction.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+using System.Diagnostics.CodeAnalysis;
 using System.Text.Json.Serialization;
 
 using Microsoft.Teams.Common;
@@ -10,6 +11,7 @@ namespace Microsoft.Teams.Api.Messages;
 /// <summary>
 /// The type of reaction given to the message.
 /// </summary>
+[Experimental("TEAMS0001")]
 [JsonConverter(typeof(JsonConverter<ReactionType>))]
 public class ReactionType(string value) : StringEnum(value)
 {
@@ -53,6 +55,7 @@ public class ReactionType(string value) : StringEnum(value)
 /// <summary>
 /// Message Reaction
 /// </summary>
+[Experimental("TEAMS0001")]
 public class Reaction
 {
     /// <summary>

Libraries/Microsoft.Teams.Apps/App.cs

@@ -178,10 +178,12 @@ public async Task<T> Send<T>(string conversationId, T activity, ConversationType
         }
 
         // Validate targeted messages in proactive context
+        #pragma warning disable TEAMS0002
         if (activity is MessageActivity messageActivity && messageActivity.IsTargeted == true && messageActivity.Recipient is null)
         {
             throw new InvalidOperationException("Targeted messages sent proactively must specify an explicit recipient ID. Use WithRecipient(new Account { Id = recipientId }, true) with an explicit recipient.");
         }
+        #pragma warning restore TEAMS0002
 
         var reference = new ConversationReference()
         {

Libraries/Microsoft.Teams.Plugins/Microsoft.Teams.Plugins.AspNetCore/AspNetCorePlugin.cs

@@ -93,6 +93,7 @@ public async Task<TActivity> Send<TActivity>(TActivity activity, Api.Conversatio
 
         // For targeted messages with an explicit Recipient (proactive sends), preserve it.
         // Otherwise, use the reference User from the conversation context.
+        #pragma warning disable TEAMS0002
         var isTargetedWithRecipient = activity is MessageActivity msg && msg.IsTargeted == true && msg.Recipient is not null;
         if (!isTargetedWithRecipient)
         {
@@ -125,6 +126,7 @@ await client
         var res = isTargeted
             ? await client.Conversations.Activities.CreateTargetedAsync(reference.Conversation.Id, activity)
             : await client.Conversations.Activities.CreateAsync(reference.Conversation.Id, activity);
+        #pragma warning restore TEAMS0002
 
         activity.Id = res?.Id;
         return activity;

Samples/Samples.Reactions/Samples.Reactions.csproj

@@ -4,6 +4,7 @@
         <TargetFramework>net10.0</TargetFramework>
         <Nullable>enable</Nullable>
         <ImplicitUsings>enable</ImplicitUsings>
+        <NoWarn>$(NoWarn);TEAMS0001</NoWarn>
     </PropertyGroup>
 
     <ItemGroup>

Samples/Samples.TargetedMessages/Samples.TargetedMessages.csproj

@@ -4,6 +4,7 @@
     <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
+    <NoWarn>$(NoWarn);TEAMS0002</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>

Tests/Microsoft.Teams.Api.Tests/Microsoft.Teams.Api.Tests.csproj

@@ -6,6 +6,7 @@
     <Nullable>enable</Nullable>
     <IsPackable>false</IsPackable>
     <LangVersion>latest</LangVersion>
+    <NoWarn>$(NoWarn);TEAMS0001;TEAMS0002</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>

Tests/Microsoft.Teams.Apps.Tests/Microsoft.Teams.Apps.Tests.csproj

@@ -5,7 +5,7 @@
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>
         <IsPackable>false</IsPackable>
-        <NoWarn>$(NoWarn);CS0618</NoWarn>
+        <NoWarn>$(NoWarn);CS0618;TEAMS0001;TEAMS0002</NoWarn>
     </PropertyGroup>
 
     <ItemGroup>