Azure.Communication.Email 1.1.0 - 2025-09-01 (Azure#52780)

ddouglas-msft · web-flow · commit d961a7fbc484 · 2025-10-07T11:16:09.000-07:00
* update email project

* update to 1.2.0

* update api

* update inline image test to use a real image to verify during live tests

* update tests

* updates from review

* fix build errors

* set version back to 1.1.0

* update
diff --git a/sdk/communication/Azure.Communication.Email/CHANGELOG.md b/sdk/communication/Azure.Communication.Email/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Release History
 
-## 1.1.0 (2025-09-01)
+## 1.1.0 (2025-10-01)
 
 ### Features Added
 
diff --git a/sdk/communication/Azure.Communication.Email/api/Azure.Communication.Email.net8.0.cs b/sdk/communication/Azure.Communication.Email/api/Azure.Communication.Email.net8.0.cs
@@ -36,13 +36,14 @@ public EmailClient(System.Uri endpoint, Azure.Core.TokenCredential credential, A
     }
     public partial class EmailClientOptions : Azure.Core.ClientOptions
     {
-        public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2024_07_01_Preview) { }
+        public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2025_09_01) { }
         public enum ServiceVersion
         {
             V2021_10_01_Preview = 1,
             V2023_01_15_Preview = 2,
             V2023_03_31 = 3,
             V2024_07_01_Preview = 4,
+            V2025_09_01 = 5,
         }
     }
     public partial class EmailContent
@@ -117,6 +118,14 @@ internal EmailSendResult() { }
         public static implicit operator Azure.Communication.Email.EmailSendStatus (string value) { throw null; }
         public static bool operator !=(Azure.Communication.Email.EmailSendStatus left, Azure.Communication.Email.EmailSendStatus right) { throw null; }
         public override string ToString() { throw null; }
+        public static partial class Values
+        {
+            public const string Canceled = "Canceled";
+            public const string Failed = "Failed";
+            public const string NotStarted = "NotStarted";
+            public const string Running = "Running";
+            public const string Succeeded = "Succeeded";
+        }
     }
 }
 namespace Microsoft.Extensions.Azure
diff --git a/sdk/communication/Azure.Communication.Email/api/Azure.Communication.Email.netstandard2.0.cs b/sdk/communication/Azure.Communication.Email/api/Azure.Communication.Email.netstandard2.0.cs
@@ -36,13 +36,14 @@ public EmailClient(System.Uri endpoint, Azure.Core.TokenCredential credential, A
     }
     public partial class EmailClientOptions : Azure.Core.ClientOptions
     {
-        public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2024_07_01_Preview) { }
+        public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2025_09_01) { }
         public enum ServiceVersion
         {
             V2021_10_01_Preview = 1,
             V2023_01_15_Preview = 2,
             V2023_03_31 = 3,
             V2024_07_01_Preview = 4,
+            V2025_09_01 = 5,
         }
     }
     public partial class EmailContent
@@ -117,6 +118,14 @@ internal EmailSendResult() { }
         public static implicit operator Azure.Communication.Email.EmailSendStatus (string value) { throw null; }
         public static bool operator !=(Azure.Communication.Email.EmailSendStatus left, Azure.Communication.Email.EmailSendStatus right) { throw null; }
         public override string ToString() { throw null; }
+        public static partial class Values
+        {
+            public const string Canceled = "Canceled";
+            public const string Failed = "Failed";
+            public const string NotStarted = "NotStarted";
+            public const string Running = "Running";
+            public const string Succeeded = "Succeeded";
+        }
     }
 }
 namespace Microsoft.Extensions.Azure
diff --git a/sdk/communication/Azure.Communication.Email/assets.json b/sdk/communication/Azure.Communication.Email/assets.json
@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "net",
   "TagPrefix": "net/communication/Azure.Communication.Email",
-  "Tag": "net/communication/Azure.Communication.Email_00a51dd0e7"
+  "Tag": "net/communication/Azure.Communication.Email_161e7ea9e0"
 }
diff --git a/sdk/communication/Azure.Communication.Email/src/EmailClientOptions.cs b/sdk/communication/Azure.Communication.Email/src/EmailClientOptions.cs
@@ -17,7 +17,7 @@ public class EmailClientOptions : ClientOptions
         /// The latest version of the Email service.
         /// </summary>
         ///
-        private const ServiceVersion LatestVersion = ServiceVersion.V2024_07_01_Preview;
+        private const ServiceVersion LatestVersion = ServiceVersion.V2025_09_01;
 
         internal string ApiVersion { get; }
 
@@ -30,6 +30,7 @@ public EmailClientOptions(ServiceVersion version = LatestVersion)
             {
                 ServiceVersion.V2023_03_31 => "2023-03-31",
                 ServiceVersion.V2024_07_01_Preview => "2024-07-01-preview",
+                ServiceVersion.V2025_09_01 => "2025-09-01",
                 _ => throw new ArgumentOutOfRangeException(nameof(version)),
             };
         }
@@ -56,6 +57,10 @@ public enum ServiceVersion
             /// The Inline Attachments preview version of the Email service.
             /// </summary>
             V2024_07_01_Preview = 4,
+            /// <summary>
+            /// The Inline Attachments GA version of the Email service.
+            /// </summary>
+            V2025_09_01 = 5,
 #pragma warning restore CA1707 // Identifiers should not contain underscores
         }
     }
diff --git a/sdk/communication/Azure.Communication.Email/src/Models/EmailSendStatus.cs b/sdk/communication/Azure.Communication.Email/src/Models/EmailSendStatus.cs
@@ -0,0 +1,32 @@
+﻿// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+#nullable disable
+
+using System;
+using Azure.Core;
+
+namespace Azure.Communication.Email
+{
+    [CodeGenModel("EmailSendStatus")]
+    [CodeGenSuppress("EmailSendStatus", typeof(string), typeof(string), typeof(string))]
+    public partial struct EmailSendStatus : IEquatable<EmailSendStatus>
+    {
+        /// <summary>
+        /// The values of all declared <see cref="EmailSendStatus"/> properties as string constants.
+        /// </summary>
+        public static class Values
+        {
+            /// <summary> Canceled </summary>
+            public const string Canceled = "Canceled";
+            /// <summary> Failed </summary>
+            public const string Failed = "Failed";
+            /// <summary> NotStarted </summary>
+            public const string NotStarted = "NotStarted";
+            /// <summary> Running </summary>
+            public const string Running = "Running";
+            /// <summary> Succeeded </summary>
+            public const string Succeeded = "Succeeded";
+        }
+    }
+}
diff --git a/sdk/communication/Azure.Communication.Email/src/autorest.md b/sdk/communication/Azure.Communication.Email/src/autorest.md
@@ -16,3 +16,5 @@ directive:
     $["x-ms-client-name"] = "content";
 ```
 
+
+
diff --git a/sdk/communication/Azure.Communication.Email/tests/EmailClientLiveTests.cs b/sdk/communication/Azure.Communication.Email/tests/EmailClientLiveTests.cs
@@ -83,7 +83,7 @@ public async Task SendEmailAndWaitForStatusWithAutomaticPollingAsync(
             Console.WriteLine($"Email send status = {statusMonitor.Status}");
         }
 
-        [Test]
+        [RecordedTest]
         [SyncOnly]
         [TestCaseSource(nameof(SetRecipientAddressState))]
         public void SendEmailAndWaitForStatusWithAutomaticPolling(
diff --git a/sdk/communication/Azure.Communication.Email/tests/Samples/Sample1_EmailClientAsync.cs b/sdk/communication/Azure.Communication.Email/tests/Samples/Sample1_EmailClientAsync.cs
@@ -316,7 +316,13 @@ public async Task SendEmailWithInlineAttachmentAsync()
 #else
             string attachmentName = "InlineImage.jpg";
             string contentType = MediaTypeNames.Image.Jpeg;
-            var content = new BinaryData("This is image file content.");
+
+            string base64String = "/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAAFAAUDAREAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAb/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAb/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCfAAf/2Q==";
+
+            // Convert Base64 to byte array
+            byte[] imageBytes = Convert.FromBase64String(base64String);
+
+            var content = new BinaryData(imageBytes);
             var contentId = "myInlineAttachmentContentId";
 #endif
             var emailAttachment = new EmailAttachment(attachmentName, contentType, content);

Original file line number	Diff line number	Diff line change
`@@ -36,13 +36,14 @@ public EmailClient(System.Uri endpoint, Azure.Core.TokenCredential credential, A`
`36`	`36`	`}`
`37`	`37`	`public partial class EmailClientOptions : Azure.Core.ClientOptions`
`38`	`38`	`{`
`39`		`- public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2024_07_01_Preview) { }`
	`39`	`+ public EmailClientOptions(Azure.Communication.Email.EmailClientOptions.ServiceVersion version = Azure.Communication.Email.EmailClientOptions.ServiceVersion.V2025_09_01) { }`
`40`	`40`	`public enum ServiceVersion`
`41`	`41`	`{`
`42`	`42`	`V2021_10_01_Preview = 1,`
`43`	`43`	`V2023_01_15_Preview = 2,`
`44`	`44`	`V2023_03_31 = 3,`
`45`	`45`	`V2024_07_01_Preview = 4,`
	`46`	`+ V2025_09_01 = 5,`
`46`	`47`	`}`
`47`	`48`	`}`
`48`	`49`	`public partial class EmailContent`
`@@ -117,6 +118,14 @@ internal EmailSendResult() { }`
`117`	`118`	`public static implicit operator Azure.Communication.Email.EmailSendStatus (string value) { throw null; }`
`118`	`119`	`public static bool operator !=(Azure.Communication.Email.EmailSendStatus left, Azure.Communication.Email.EmailSendStatus right) { throw null; }`
`119`	`120`	`public override string ToString() { throw null; }`
	`121`	`+ public static partial class Values`
	`122`	`+ {`
	`123`	`+ public const string Canceled = "Canceled";`
	`124`	`+ public const string Failed = "Failed";`
	`125`	`+ public const string NotStarted = "NotStarted";`
	`126`	`+ public const string Running = "Running";`
	`127`	`+ public const string Succeeded = "Succeeded";`
	`128`	`+ }`
`120`	`129`	`}`
`121`	`130`	`}`
`122`	`131`	`namespace Microsoft.Extensions.Azure`
Original file line number	Diff line number	Diff line change
`@@ -2,5 +2,5 @@`
`2`	`2`	`"AssetsRepo": "Azure/azure-sdk-assets",`
`3`	`3`	`"AssetsRepoPrefixPath": "net",`
`4`	`4`	`"TagPrefix": "net/communication/Azure.Communication.Email",`
`5`		`- "Tag": "net/communication/Azure.Communication.Email_00a51dd0e7"`
	`5`	`+ "Tag": "net/communication/Azure.Communication.Email_161e7ea9e0"`
`6`	`6`	`}`
Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@ public class EmailClientOptions : ClientOptions`
`17`	`17`	`/// The latest version of the Email service.`
`18`	`18`	`/// </summary>`
`19`	`19`	`///`
`20`		`- private const ServiceVersion LatestVersion = ServiceVersion.V2024_07_01_Preview;`
	`20`	`+ private const ServiceVersion LatestVersion = ServiceVersion.V2025_09_01;`
`21`	`21`
`22`	`22`	`internal string ApiVersion { get; }`
`23`	`23`
`@@ -30,6 +30,7 @@ public EmailClientOptions(ServiceVersion version = LatestVersion)`
`30`	`30`	`{`
`31`	`31`	`ServiceVersion.V2023_03_31 => "2023-03-31",`
`32`	`32`	`ServiceVersion.V2024_07_01_Preview => "2024-07-01-preview",`
	`33`	`+ ServiceVersion.V2025_09_01 => "2025-09-01",`
`33`	`34`	`_ => throw new ArgumentOutOfRangeException(nameof(version)),`
`34`	`35`	`};`
`35`	`36`	`}`
`@@ -56,6 +57,10 @@ public enum ServiceVersion`
`56`	`57`	`/// The Inline Attachments preview version of the Email service.`
`57`	`58`	`/// </summary>`
`58`	`59`	`V2024_07_01_Preview = 4,`
	`60`	`+ /// <summary>`
	`61`	`+ /// The Inline Attachments GA version of the Email service.`
	`62`	`+ /// </summary>`
	`63`	`+ V2025_09_01 = 5,`
`59`	`64`	`#pragma warning restore CA1707 // Identifiers should not contain underscores`
`60`	`65`	`}`
`61`	`66`	`}`
-Original file line number
+Diff line change
     $["x-ms-client-name"] = "content";
 ```
++
++
Original file line number	Diff line number	Diff line change
`@@ -83,7 +83,7 @@ public async Task SendEmailAndWaitForStatusWithAutomaticPollingAsync(`
`83`	`83`	`Console.WriteLine($"Email send status = {statusMonitor.Status}");`
`84`	`84`	`}`
`85`	`85`
`86`		`- [Test]`
	`86`	`+ [RecordedTest]`
`87`	`87`	`[SyncOnly]`
`88`	`88`	`[TestCaseSource(nameof(SetRecipientAddressState))]`
`89`	`89`	`public void SendEmailAndWaitForStatusWithAutomaticPolling(`