@azure/communication-email 1.0.0-alpha.20220524.1 → 1.0.0-alpha.20220630.1

package/README.md

@@ -16,33 +16,27 @@ To create these resource, you can use the [Azure Portal][communication_resource_
 npm install @azure/communication-email
 ```
 
-### Browser support
-
-## Key concepts
+## Examples
 
 `EmailClient` provides the functionality to send email messages .
 
-## Examples
-
 ## Authentication
 
 Email clients can be authenticated using the connection string acquired from an Azure Communication Resource in the [Azure Portal][azure_portal].
 
-```typescript
-import { EmailClient } from "@azure/communication-email";
+```javascript
+const { EmailClient } = require("@azure/communication-email");
 
 const connectionString = `endpoint=https://<resource-name>.communication.azure.com/;accessKey=<Base64-Encoded-Key>`;
 const client = new EmailClient(connectionString);
 ```
 
-## Examples
-
 ### Send an Email Message
 
 To send an email message, call the `send` function from the `EmailClient`.
 
-```typescript Snippet:Azure_Communication_Email_Send
-const emailMessage: EmailMessage = {
+```javascript Snippet:Azure_Communication_Email_Send
+const emailMessage = {
   sender: "sender@contoso.com",
   content: {
     subject: "This is the subject",
@@ -65,8 +59,8 @@ const response = await emailClient.send(emailMessage);
 
 To send an email message to multiple recipients, add a object for each recipient type and an object for each recipient.
 
-```typescript Snippet:Azure_Communication_Email_Send_Multiple_Recipients
-const emailMessage: EmailMessage = {
+```javascript Snippet:Azure_Communication_Email_Send_Multiple_Recipients
+const emailMessage = {
   sender: "sender@contoso.com",
   content: {
     subject: "This is the subject",
@@ -83,7 +77,7 @@ const emailMessage: EmailMessage = {
         displayName: "Customer Name 2",
       },
     ],
-    cC: [
+    cc: [
       {
         email: "ccCustomer1@domain.com",
         displayName: " CC Customer 1",
@@ -93,7 +87,7 @@ const emailMessage: EmailMessage = {
         displayName: "CC Customer 2",
       },
     ],
-    bCC: [
+    bcc: [
       {
         email: "bccCustomer1@domain.com",
         displayName: " BCC Customer 1",
@@ -113,17 +107,17 @@ const response = await emailClient.send(emailMessage);
 
 Azure Communication Services support sending email with attachments.
 
-```typescript Snippet:Azure_Communication_Email_Send_With_Attachments
+```javascript Snippet:Azure_Communication_Email_Send_With_Attachments
 const filePath = "C://readme.txt";
 
-const emailMessage: EmailMessage = {
+const emailMessage = {
   sender: "sender@contoso.com",
   content: {
     subject: "This is the subject",
     plainText: "This is the body",
   },
   recipients: {
-    toRecipients: [
+    to: [
       {
         email: "customer@domain.com",
         displayName: "Customer Name",
@@ -146,10 +140,10 @@ const response = await emailClient.send(emailMessage);
 
 The result from the `send` call contains a `messageId` which can be used to query the status of the email.
 
-```typescript Snippet:Azure_Communication_Email_GetSendStatus
-const messageId = await emailClient.send(emailMessage);
+```javascript Snippet:Azure_Communication_Email_GetSendStatus
+const response = await emailClient.send(emailMessage);
 
-const status = await emailClient.getSendStatus(messageId);
+const status = await emailClient.getSendStatus(response.messageId);
 ```
 
 ## Next steps

package/dist/index.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var coreHttp = require('@azure/core-http');
 var communicationCommon = require('@azure/communication-common');
+var coreClient = require('@azure/core-client');
 var logger$1 = require('@azure/logger');
 var uuid = require('uuid');
 
@@ -25,7 +25,7 @@ function _interopNamespace(e) {
     return Object.freeze(n);
 }
 
-var coreHttp__namespace = /*#__PURE__*/_interopNamespace(coreHttp);
+var coreClient__namespace = /*#__PURE__*/_interopNamespace(coreClient);
 
 /*
  * Copyright (c) Microsoft Corporation.
@@ -103,7 +103,10 @@ const CommunicationError = {
                 type: {
                     name: "Sequence",
                     element: {
-                        type: { name: "Composite", className: "CommunicationError" }
+                        type: {
+                            name: "Composite",
+                            className: "CommunicationError"
+                        }
                     }
                 }
             },
@@ -127,7 +130,10 @@ const EmailMessage = {
                 type: {
                     name: "Sequence",
                     element: {
-                        type: { name: "Composite", className: "EmailCustomHeader" }
+                        type: {
+                            name: "Composite",
+                            className: "EmailCustomHeader"
+                        }
                     }
                 }
             },
@@ -163,14 +169,24 @@ const EmailMessage = {
                 serializedName: "attachments",
                 type: {
                     name: "Sequence",
-                    element: { type: { name: "Composite", className: "EmailAttachment" } }
+                    element: {
+                        type: {
+                            name: "Composite",
+                            className: "EmailAttachment"
+                        }
+                    }
                 }
             },
             replyTo: {
                 serializedName: "replyTo",
                 type: {
                     name: "Sequence",
-                    element: { type: { name: "Composite", className: "EmailAddress" } }
+                    element: {
+                        type: {
+                            name: "Composite",
+                            className: "EmailAddress"
+                        }
+                    }
                 }
             },
             disableUserEngagementTracking: {
@@ -241,21 +257,36 @@ const EmailRecipients = {
                 required: true,
                 type: {
                     name: "Sequence",
-                    element: { type: { name: "Composite", className: "EmailAddress" } }
+                    element: {
+                        type: {
+                            name: "Composite",
+                            className: "EmailAddress"
+                        }
+                    }
                 }
             },
-            cC: {
-                serializedName: "cC",
+            cc: {
+                serializedName: "CC",
                 type: {
                     name: "Sequence",
-                    element: { type: { name: "Composite", className: "EmailAddress" } }
+                    element: {
+                        type: {
+                            name: "Composite",
+                            className: "EmailAddress"
+                        }
+                    }
                 }
             },
-            bCC: {
+            bcc: {
                 serializedName: "bCC",
                 type: {
                     name: "Sequence",
-                    element: { type: { name: "Composite", className: "EmailAddress" } }
+                    element: {
+                        type: {
+                            name: "Composite",
+                            className: "EmailAddress"
+                        }
+                    }
                 }
             }
         }
@@ -325,6 +356,20 @@ const EmailGetSendStatusHeaders = {
         }
     }
 };
+const EmailGetSendStatusExceptionHeaders = {
+    type: {
+        name: "Composite",
+        className: "EmailGetSendStatusExceptionHeaders",
+        modelProperties: {
+            xMsErrorCode: {
+                serializedName: "x-ms-error-code",
+                type: {
+                    name: "String"
+                }
+            }
+        }
+    }
+};
 const EmailSendHeaders = {
     type: {
         name: "Composite",
@@ -357,6 +402,20 @@ const EmailSendHeaders = {
         }
     }
 };
+const EmailSendExceptionHeaders = {
+    type: {
+        name: "Composite",
+        className: "EmailSendExceptionHeaders",
+        modelProperties: {
+            xMsErrorCode: {
+                serializedName: "x-ms-error-code",
+                type: {
+                    name: "String"
+                }
+            }
+        }
+    }
+};
 
 var Mappers = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -370,7 +429,9 @@ var Mappers = /*#__PURE__*/Object.freeze({
     EmailAddress: EmailAddress,
     EmailAttachment: EmailAttachment,
     EmailGetSendStatusHeaders: EmailGetSendStatusHeaders,
-    EmailSendHeaders: EmailSendHeaders
+    EmailGetSendStatusExceptionHeaders: EmailGetSendStatusExceptionHeaders,
+    EmailSendHeaders: EmailSendHeaders,
+    EmailSendExceptionHeaders: EmailSendExceptionHeaders
 });
 
 /*
@@ -380,6 +441,17 @@ var Mappers = /*#__PURE__*/Object.freeze({
  * Code generated by Microsoft (R) AutoRest Code Generator.
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
+const accept = {
+    parameterPath: "accept",
+    mapper: {
+        defaultValue: "application/json",
+        isConstant: true,
+        serializedName: "Accept",
+        type: {
+            name: "String"
+        }
+    }
+};
 const endpoint = {
     parameterPath: "endpoint",
     mapper: {
@@ -455,10 +527,8 @@ const repeatabilityFirstSent = {
  * Code generated by Microsoft (R) AutoRest Code Generator.
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
-/**
- * Class representing a Email.
- */
-class Email {
+/** Class containing Email operations. */
+class EmailImpl {
     /**
      * Initialize a new instance of the class Email class.
      * @param client Reference to the service client
@@ -472,8 +542,7 @@ class Email {
      * @param options The options parameters.
      */
     getSendStatus(messageId, options) {
-        const operationOptions = coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {});
-        return this.client.sendOperationRequest({ messageId, options: operationOptions }, getSendStatusOperationSpec);
+        return this.client.sendOperationRequest({ messageId, options }, getSendStatusOperationSpec);
     }
     /**
      * Queues an email message to be sent to one or more recipients
@@ -489,17 +558,11 @@ class Email {
      * @param options The options parameters.
      */
     send(repeatabilityRequestId, repeatabilityFirstSent, emailMessage, options) {
-        const operationOptions = coreHttp__namespace.operationOptionsToRequestOptionsBase(options || {});
-        return this.client.sendOperationRequest({
-            repeatabilityRequestId,
-            repeatabilityFirstSent,
-            emailMessage,
-            options: operationOptions
-        }, sendOperationSpec);
+        return this.client.sendOperationRequest({ repeatabilityRequestId, repeatabilityFirstSent, emailMessage, options }, sendOperationSpec);
     }
 }
 // Operation Specifications
-const serializer = new coreHttp__namespace.Serializer(Mappers, /* isXml */ false);
+const serializer = coreClient__namespace.createSerializer(Mappers, /* isXml */ false);
 const getSendStatusOperationSpec = {
     path: "/emails/{messageId}/status",
     httpMethod: "GET",
@@ -510,11 +573,12 @@ const getSendStatusOperationSpec = {
         },
         default: {
             bodyMapper: CommunicationErrorResponse,
-            headersMapper: EmailGetSendStatusHeaders
+            headersMapper: EmailGetSendStatusExceptionHeaders
         }
     },
     queryParameters: [apiVersion],
     urlParameters: [endpoint, messageId],
+    headerParameters: [accept],
     serializer
 };
 const sendOperationSpec = {
@@ -526,13 +590,14 @@ const sendOperationSpec = {
         },
         default: {
             bodyMapper: CommunicationErrorResponse,
-            headersMapper: EmailSendHeaders
+            headersMapper: EmailSendExceptionHeaders
         }
     },
     requestBody: emailMessage,
     queryParameters: [apiVersion],
     urlParameters: [endpoint],
     headerParameters: [
+        accept,
         contentType,
         repeatabilityRequestId,
         repeatabilityFirstSent
@@ -548,15 +613,14 @@ const sendOperationSpec = {
  * Code generated by Microsoft (R) AutoRest Code Generator.
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
-const packageName = "@azure/communication-email";
-const packageVersion = "1.0.0-beta.1";
-class EmailRestApiClientContext extends coreHttp__namespace.ServiceClient {
+class EmailRestApiClient extends coreClient__namespace.ServiceClient {
     /**
-     * Initializes a new instance of the EmailRestApiClientContext class.
+     * Initializes a new instance of the EmailRestApiClient class.
      * @param endpoint The communication resource, for example https://my-resource.communication.azure.com
      * @param options The parameter options
      */
     constructor(endpoint, options) {
+        var _a, _b;
         if (endpoint === undefined) {
             throw new Error("'endpoint' cannot be null");
         }
@@ -564,43 +628,51 @@ class EmailRestApiClientContext extends coreHttp__namespace.ServiceClient {
         if (!options) {
             options = {};
         }
-        if (!options.userAgent) {
-            const defaultUserAgent = coreHttp__namespace.getDefaultUserAgentValue();
-            options.userAgent = `${packageName}/${packageVersion} ${defaultUserAgent}`;
-        }
-        super(undefined, options);
-        this.requestContentType = "application/json; charset=utf-8";
-        this.baseUri = options.endpoint || "{endpoint}";
+        const defaults = {
+            requestContentType: "application/json; charset=utf-8"
+        };
+        const packageDetails = `azsdk-js-communication-email/1.0.0-beta.2`;
+        const userAgentPrefix = options.userAgentOptions && options.userAgentOptions.userAgentPrefix
+            ? `${options.userAgentOptions.userAgentPrefix} ${packageDetails}`
+            : `${packageDetails}`;
+        const optionsWithDefaults = Object.assign(Object.assign(Object.assign({}, defaults), options), { userAgentOptions: {
+                userAgentPrefix
+            }, baseUri: (_b = (_a = options.endpoint) !== null && _a !== void 0 ? _a : options.baseUri) !== null && _b !== void 0 ? _b : "{endpoint}" });
+        super(optionsWithDefaults);
         // Parameter assignments
         this.endpoint = endpoint;
         // Assigning values to Constant parameters
         this.apiVersion = options.apiVersion || "2021-10-01-preview";
+        this.email = new EmailImpl(this);
+        this.addCustomApiVersionPolicy(options.apiVersion);
     }
-}
-
-/*
- * Copyright (c) Microsoft Corporation.
- * Licensed under the MIT License.
- *
- * Code generated by Microsoft (R) AutoRest Code Generator.
- * Changes may cause incorrect behavior and will be lost if the code is regenerated.
- */
-class EmailRestApiClient extends EmailRestApiClientContext {
-    /**
-     * Initializes a new instance of the EmailRestApiClient class.
-     * @param endpoint The communication resource, for example https://my-resource.communication.azure.com
-     * @param options The parameter options
-     */
-    constructor(endpoint, options) {
-        super(endpoint, options);
-        this.email = new Email(this);
+    /** A function that adds a policy that sets the api-version (or equivalent) to reflect the library version. */
+    addCustomApiVersionPolicy(apiVersion) {
+        if (!apiVersion) {
+            return;
+        }
+        const apiVersionPolicy = {
+            name: "CustomApiVersionPolicy",
+            async sendRequest(request, next) {
+                const param = request.url.split("?");
+                if (param.length > 1) {
+                    const newParams = param[1].split("&").map((item) => {
+                        if (item.indexOf("api-version") > -1) {
+                            return "api-version=" + apiVersion;
+                        }
+                        else {
+                            return item;
+                        }
+                    });
+                    request.url = param[0] + "?" + newParams.join("&");
+                }
+                return next(request);
+            }
+        };
+        this.pipeline.addPolicy(apiVersionPolicy);
     }
 }
 
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-const SDK_VERSION = "1.0.0-beta.1";
-
 // Copyright (c) Microsoft Corporation.
 /**
  * The \@azure/logger configuration for this package.
@@ -621,24 +693,14 @@ class EmailClient {
     constructor(connectionStringOrUrl, credentialOrOptions, maybeOptions = {}) {
         const { url, credential } = communicationCommon.parseClientArguments(connectionStringOrUrl, credentialOrOptions);
         const options = isEmailClientOptions(credentialOrOptions) ? credentialOrOptions : maybeOptions;
-        const libInfo = `azsdk-js-communication-email/${SDK_VERSION}`;
-        if (!options.userAgentOptions) {
-            options.userAgentOptions = {};
-        }
-        if (options.userAgentOptions.userAgentPrefix) {
-            options.userAgentOptions.userAgentPrefix = `${options.userAgentOptions.userAgentPrefix} ${libInfo}`;
-        }
-        else {
-            options.userAgentOptions.userAgentPrefix = libInfo;
-        }
         const internalPipelineOptions = Object.assign(Object.assign({}, options), {
             loggingOptions: {
                 logger: logger.info,
             },
         });
         const authPolicy = communicationCommon.createCommunicationAuthPolicy(credential);
-        const pipeline = coreHttp.createPipelineFromOptions(internalPipelineOptions, authPolicy);
-        this.api = new EmailRestApiClient(url, pipeline);
+        this.generatedClient = new EmailRestApiClient(url, internalPipelineOptions);
+        this.generatedClient.pipeline.addPolicy(authPolicy);
     }
     /**
      * Queues an email message to be sent to one or more recipients
@@ -646,7 +708,7 @@ class EmailClient {
      */
     async send(emailMessage) {
         var _a;
-        const response = await this.api.email.send(uuid.v4(), new Date().toUTCString(), emailMessage);
+        const response = await this.generatedClient.email.send(uuid.v4(), new Date().toUTCString(), emailMessage);
         return {
             messageId: (_a = response.xMsRequestId) !== null && _a !== void 0 ? _a : "",
         };
@@ -656,7 +718,7 @@ class EmailClient {
      * @param messageId - System generated message id (GUID) returned from a previous call to send email
      */
     async getSendStatus(messageId) {
-        const response = await this.api.email.getSendStatus(messageId);
+        const response = await this.generatedClient.email.getSendStatus(messageId);
         return {
             messageId: response.messageId,
             status: response.status,