@azure/communication-email 1.0.0-beta.1 → 1.0.0

package/dist-esm/test/public/utils/recordedClient.js

@@ -1,45 +1,59 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-import * as dotenv from "dotenv";
-import { env, record } from "@azure-tools/test-recorder";
+import { Recorder, env } from "@azure-tools/test-recorder";
 import { EmailClient } from "../../../src";
-import { isNode } from "@azure/core-http";
-import { parseConnectionString } from "@azure/communication-common";
-if (isNode) {
-    dotenv.config();
-}
-const replaceableVariables = {
-    COMMUNICATION_CONNECTION_STRING: "endpoint=https://someEndpoint/;accesskey=someAccessKeyw==",
+const envSetupForPlayback = {
+    COMMUNICATION_CONNECTION_STRING_EMAIL: "endpoint=https://someEndpoint/;accesskey=someAccessKeyw==",
     SENDER_ADDRESS: "someSender@contoso.com",
     RECIPIENT_ADDRESS: "someRecipient@domain.com",
 };
-export const environmentSetup = {
-    replaceableVariables: replaceableVariables,
-    customizationsOnRecordings: [
-        (recording) => recording.replace(/(https:\/\/)([^/',]*)/, "$1someEndpoint"),
-        (recording) => recording.replace(/("sender":)("(.*?)")/, "$1" + '"someSender@contoso.com"'),
-        (recording) => recording.replace(/("email":)("(.*?)")/g, "$1" + '"someRecipient@domain.com"'),
-        (recording) => recording.replace(/('Operation-Location',[\r\n] {2})'(.*?)'/, "$1" + '"someOperationLocation"'),
-        (recording) => recording.replace(/"operation-location"\s?:\s?"[^"]*"/g, '"operation-location": "someOperationLocation"'),
-        (recording) => recording.replace(/('x-ms-request-id',[\r\n] {2})'(.*?)'/, "$1" + '"someRequestId"'),
-        (recording) => recording.replace(/"x-ms-request-id"\s?:\s?"[^"]*"/g, '"x-ms-request-id": "someRequestId"'),
-        (recording) => recording.replace(/("messageId":)("(.*?)")/g, "$1" + '"someRequestId"'),
-        (recording) => recording.replace(/emails\/[^"']*/g, "emails/someRequestId/status"),
+const sanitizerOptions = {
+    connectionStringSanitizers: [
+        {
+            actualConnString: env.COMMUNICATION_CONNECTION_STRING_EMAIL,
+            fakeConnString: envSetupForPlayback["COMMUNICATION_CONNECTION_STRING_EMAIL"],
+        },
+    ],
+    headerSanitizers: [
+        { key: "x-ms-content-sha256", value: "Sanitized" },
+        {
+            key: "Operation-Location",
+            value: "https://someEndpoint/emails/operations/someId?api-version=2023-03-31",
+        },
+    ],
+    uriSanitizers: [
+        {
+            regex: true,
+            target: `emails/operations/.*?api`,
+            value: "emails/operations/someId?api",
+        },
+    ],
+    bodySanitizers: [
+        {
+            regex: true,
+            target: `"id"\\s?:\\s?"[^"]*"`,
+            value: `"id":"someId"`,
+        },
     ],
-    queryParametersToSkip: [],
 };
-export function createRecordedEmailClientWithConnectionString(context) {
-    const recorder = record(context, environmentSetup);
-    return {
-        client: new EmailClient(env.COMMUNICATION_CONNECTION_STRING),
-        recorder,
-    };
+export async function createRecorder(context) {
+    const recorder = new Recorder(context);
+    await recorder.start({ envSetupForPlayback });
+    await recorder.addSanitizers(sanitizerOptions, ["record", "playback"]);
+    await recorder.setMatcher("CustomDefaultMatcher", {
+        excludedHeaders: [
+            "Accept-Language",
+            "x-ms-content-sha256", // This is dependent on the current datetime
+        ],
+    });
+    return recorder;
 }
-export function createRecordedEmailClientWithKeyCredential(context) {
-    const recorder = record(context, environmentSetup);
-    const { endpoint, credential } = parseConnectionString(env.COMMUNICATION_CONNECTION_STRING);
+export async function createRecordedEmailClientWithConnectionString(context) {
+    var _a;
+    const recorder = await createRecorder(context.currentTest);
+    const client = new EmailClient((_a = env.COMMUNICATION_CONNECTION_STRING_EMAIL) !== null && _a !== void 0 ? _a : "", recorder.configureClientOptions({}));
     return {
-        client: new EmailClient(endpoint, credential),
+        client: client,
         recorder,
     };
 }

package/dist-esm/test/public/utils/recordedClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordedClient.js","sourceRoot":"","sources":["../../../../test/public/utils/recordedClient.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAsC,GAAG,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE7F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,IAAI,MAAM,EAAE;IACV,MAAM,CAAC,MAAM,EAAE,CAAC;CACjB;AAOD,MAAM,oBAAoB,GAA4B;IACpD,+BAA+B,EAAE,2DAA2D;IAC5F,cAAc,EAAE,wBAAwB;IACxC,iBAAiB,EAAE,0BAA0B;CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,oBAAoB,EAAE,oBAAoB;IAC1C,0BAA0B,EAAE;QAC1B,CAAC,SAAiB,EAAU,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,uBAAuB,EAAE,gBAAgB,CAAC;QAC3F,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,GAAG,0BAA0B,CAAC;QAC9E,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,GAAG,4BAA4B,CAAC;QAChF,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CACf,0CAA0C,EAC1C,IAAI,GAAG,yBAAyB,CACjC;QACH,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CACf,qCAAqC,EACrC,+CAA+C,CAChD;QACH,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,uCAAuC,EAAE,IAAI,GAAG,iBAAiB,CAAC;QACtF,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,kCAAkC,EAAE,oCAAoC,CAAC;QAC7F,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,GAAG,iBAAiB,CAAC;QACzE,CAAC,SAAiB,EAAU,EAAE,CAC5B,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;KACtE;IACD,qBAAqB,EAAE,EAAE;CAC1B,CAAC;AAEF,MAAM,UAAU,6CAA6C,CAC3D,OAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM,EAAE,IAAI,WAAW,CAAC,GAAG,CAAC,+BAA+B,CAAC;QAC5D,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0CAA0C,CAAC,OAAgB;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAEnD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAE5F,OAAO;QACL,MAAM,EAAE,IAAI,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC7C,QAAQ;KACT,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport * as dotenv from \"dotenv\";\nimport { Recorder, RecorderEnvironmentSetup, env, record } from \"@azure-tools/test-recorder\";\nimport { Context } from \"mocha\";\nimport { EmailClient } from \"../../../src\";\nimport { isNode } from \"@azure/core-http\";\nimport { parseConnectionString } from \"@azure/communication-common\";\n\nif (isNode) {\n  dotenv.config();\n}\n\nexport interface RecordedEmailClient {\n  client: EmailClient;\n  recorder: Recorder;\n}\n\nconst replaceableVariables: { [k: string]: string } = {\n  COMMUNICATION_CONNECTION_STRING: \"endpoint=https://someEndpoint/;accesskey=someAccessKeyw==\",\n  SENDER_ADDRESS: \"someSender@contoso.com\",\n  RECIPIENT_ADDRESS: \"someRecipient@domain.com\",\n};\n\nexport const environmentSetup: RecorderEnvironmentSetup = {\n  replaceableVariables: replaceableVariables,\n  customizationsOnRecordings: [\n    (recording: string): string => recording.replace(/(https:\\/\\/)([^/',]*)/, \"$1someEndpoint\"),\n    (recording: string): string =>\n      recording.replace(/(\"sender\":)(\"(.*?)\")/, \"$1\" + '\"someSender@contoso.com\"'),\n    (recording: string): string =>\n      recording.replace(/(\"email\":)(\"(.*?)\")/g, \"$1\" + '\"someRecipient@domain.com\"'),\n    (recording: string): string =>\n      recording.replace(\n        /('Operation-Location',[\\r\\n] {2})'(.*?)'/,\n        \"$1\" + '\"someOperationLocation\"'\n      ),\n    (recording: string): string =>\n      recording.replace(\n        /\"operation-location\"\\s?:\\s?\"[^\"]*\"/g,\n        '\"operation-location\": \"someOperationLocation\"'\n      ),\n    (recording: string): string =>\n      recording.replace(/('x-ms-request-id',[\\r\\n] {2})'(.*?)'/, \"$1\" + '\"someRequestId\"'),\n    (recording: string): string =>\n      recording.replace(/\"x-ms-request-id\"\\s?:\\s?\"[^\"]*\"/g, '\"x-ms-request-id\": \"someRequestId\"'),\n    (recording: string): string =>\n      recording.replace(/(\"messageId\":)(\"(.*?)\")/g, \"$1\" + '\"someRequestId\"'),\n    (recording: string): string =>\n      recording.replace(/emails\\/[^\"']*/g, \"emails/someRequestId/status\"),\n  ],\n  queryParametersToSkip: [],\n};\n\nexport function createRecordedEmailClientWithConnectionString(\n  context: Context\n): RecordedEmailClient {\n  const recorder = record(context, environmentSetup);\n\n  return {\n    client: new EmailClient(env.COMMUNICATION_CONNECTION_STRING),\n    recorder,\n  };\n}\n\nexport function createRecordedEmailClientWithKeyCredential(context: Context): RecordedEmailClient {\n  const recorder = record(context, environmentSetup);\n\n  const { endpoint, credential } = parseConnectionString(env.COMMUNICATION_CONNECTION_STRING);\n\n  return {\n    client: new EmailClient(endpoint, credential),\n    recorder,\n  };\n}\n"]}
+{"version":3,"file":"recordedClient.js","sourceRoot":"","sources":["../../../../test/public/utils/recordedClient.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,QAAQ,EAAoB,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,MAAM,mBAAmB,GAA4B;IACnD,qCAAqC,EACnC,2DAA2D;IAC7D,cAAc,EAAE,wBAAwB;IACxC,iBAAiB,EAAE,0BAA0B;CAC9C,CAAC;AAEF,MAAM,gBAAgB,GAAqB;IACzC,0BAA0B,EAAE;QAC1B;YACE,gBAAgB,EAAE,GAAG,CAAC,qCAAqC;YAC3D,cAAc,EAAE,mBAAmB,CAAC,uCAAuC,CAAC;SAC7E;KACF;IACD,gBAAgB,EAAE;QAChB,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE;QAClD;YACE,GAAG,EAAE,oBAAoB;YACzB,KAAK,EAAE,sEAAsE;SAC9E;KACF;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,0BAA0B;YAClC,KAAK,EAAE,8BAA8B;SACtC;KACF;IACD,cAAc,EAAE;QACd;YACE,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,sBAAsB;YAC9B,KAAK,EAAE,eAAe;SACvB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB;IAC5D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,CAAC,UAAU,CAAC,sBAAsB,EAAE;QAChD,eAAe,EAAE;YACf,iBAAiB;YACjB,qBAAqB,EAAE,4CAA4C;SACpE;KACF,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6CAA6C,CACjE,OAAgB;;IAEhB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,WAAW,CAC5B,MAAA,GAAG,CAAC,qCAAqC,mCAAI,EAAE,EAC/C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,CACpC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,MAAM;QACd,QAAQ;KACT,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { Context, Test } from \"mocha\";\nimport { Recorder, SanitizerOptions, env } from \"@azure-tools/test-recorder\";\nimport { EmailClient } from \"../../../src\";\n\nexport interface RecordedEmailClient {\n  client: EmailClient;\n  recorder: Recorder;\n}\n\nconst envSetupForPlayback: { [k: string]: string } = {\n  COMMUNICATION_CONNECTION_STRING_EMAIL:\n    \"endpoint=https://someEndpoint/;accesskey=someAccessKeyw==\",\n  SENDER_ADDRESS: \"someSender@contoso.com\",\n  RECIPIENT_ADDRESS: \"someRecipient@domain.com\",\n};\n\nconst sanitizerOptions: SanitizerOptions = {\n  connectionStringSanitizers: [\n    {\n      actualConnString: env.COMMUNICATION_CONNECTION_STRING_EMAIL,\n      fakeConnString: envSetupForPlayback[\"COMMUNICATION_CONNECTION_STRING_EMAIL\"],\n    },\n  ],\n  headerSanitizers: [\n    { key: \"x-ms-content-sha256\", value: \"Sanitized\" },\n    {\n      key: \"Operation-Location\",\n      value: \"https://someEndpoint/emails/operations/someId?api-version=2023-03-31\",\n    },\n  ],\n  uriSanitizers: [\n    {\n      regex: true,\n      target: `emails/operations/.*?api`,\n      value: \"emails/operations/someId?api\",\n    },\n  ],\n  bodySanitizers: [\n    {\n      regex: true,\n      target: `\"id\"\\\\s?:\\\\s?\"[^\"]*\"`,\n      value: `\"id\":\"someId\"`,\n    },\n  ],\n};\n\nexport async function createRecorder(context: Test | undefined): Promise<Recorder> {\n  const recorder = new Recorder(context);\n  await recorder.start({ envSetupForPlayback });\n  await recorder.addSanitizers(sanitizerOptions, [\"record\", \"playback\"]);\n  await recorder.setMatcher(\"CustomDefaultMatcher\", {\n    excludedHeaders: [\n      \"Accept-Language\", // This is env-dependent\n      \"x-ms-content-sha256\", // This is dependent on the current datetime\n    ],\n  });\n  return recorder;\n}\n\nexport async function createRecordedEmailClientWithConnectionString(\n  context: Context\n): Promise<RecordedEmailClient> {\n  const recorder = await createRecorder(context.currentTest);\n\n  const client = new EmailClient(\n    env.COMMUNICATION_CONNECTION_STRING_EMAIL ?? \"\",\n    recorder.configureClientOptions({})\n  );\n  return {\n    client: client,\n    recorder,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/communication-email",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0",
   "description": "The is the JS Client SDK for email. This SDK enables users to send emails and get the status of sent email message.",
   "author": "Microsoft Corporation",
   "license": "MIT",
@@ -18,8 +18,9 @@
     "execute:samples": "dev-tool samples run samples-dev",
     "extract-api": "tsc -p . && api-extractor run --local",
     "format": "prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"test/**/*.ts\" \"samples-dev/**/*.ts\" \"*.{js,json}\"",
-    "integration-test:browser": "karma start --single-run",
-    "integration-test:node": "nyc mocha -r esm --require source-map-support/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace -t 300000  dist-esm/test/public/*.spec.js dist-esm/test/public/node/*.spec.js",
+    "generate:client": "autorest --typescript ./swagger/README.md && rushx format",
+    "integration-test:browser": "dev-tool run test:browser",
+    "integration-test:node": "dev-tool run test:node-js-input -- --timeout 5000000 'dist-esm/test/**/*.spec.js'",
     "integration-test": "npm run integration-test:node && npm run integration-test:browser",
     "lint:fix": "eslint package.json api-extractor.json src test --ext .ts --fix --fix-type [problem,suggestion]",
     "lint": "eslint package.json api-extractor.json src test --ext .ts",
@@ -27,8 +28,8 @@
     "test": "npm run build:test && npm run unit-test && npm run integration-test",
     "test:browser": "npm run build:test && npm run unit-test:browser && npm run integration-test:browser",
     "test:node": "npm run build:test && npm run unit-test:node && npm run integration-test:node",
-    "unit-test:browser": "karma start --single-run",
-    "unit-test:node": "mocha -r esm -r ts-node/register --reporter ../../../common/tools/mocha-multi-reporter.js --full-trace --exclude \"test/**/browser/*.spec.ts\" \"test/**/*.spec.ts\"",
+    "unit-test:browser": "dev-tool run test:browser",
+    "unit-test:node": "dev-tool run test:node-ts-input -- --timeout 1200000 --exclude 'test/**/browser/*.spec.ts' 'test/**/*.spec.ts'",
     "unit-test": "npm run unit-test:node && npm run unit-test:browser"
   },
   "files": [
@@ -47,8 +48,10 @@
   ],
   "dependencies": {
     "@azure/core-auth": "^1.3.0",
-    "@azure/core-http": "^2.0.0",
-    "@azure/communication-common": "^1.1.0",
+    "@azure/core-client": "^1.3.2",
+    "@azure/core-lro": "^2.5.0",
+    "@azure/core-rest-pipeline": "^1.8.0",
+    "@azure/communication-common": "^2.2.0",
     "@azure/logger": "^1.0.0",
     "tslib": "^1.9.3",
     "uuid": "^8.3.2"
@@ -57,22 +60,20 @@
     "@azure/dev-tool": "^1.0.0",
     "@azure/eslint-plugin-azure-sdk": "^3.0.0",
     "@azure/test-utils": "^1.0.0",
-    "@azure-tools/test-recorder": "^1.0.0",
-    "@microsoft/api-extractor": "7.18.11",
-    "@types/node": "^12.0.0",
+    "@azure-tools/test-recorder": "^3.0.0",
+    "@microsoft/api-extractor": "^7.31.1",
+    "@types/node": "^14.0.0",
     "@types/uuid": "^8.3.2",
     "@types/chai": "^4.1.6",
     "@types/mocha": "^7.0.2",
     "chai": "^4.2.0",
-    "dotenv": "^8.2.0",
+    "dotenv": "^16.0.0",
     "eslint": "^7.15.0",
     "karma": "^6.2.0",
     "karma-chrome-launcher": "^3.0.0",
     "karma-coverage": "^2.0.0",
-    "karma-edge-launcher": "^0.4.2",
     "karma-env-preprocessor": "^0.1.1",
     "karma-firefox-launcher": "^1.1.0",
-    "karma-ie-launcher": "^1.0.0",
     "karma-json-preprocessor": "^0.3.3",
     "karma-json-to-file-reporter": "^1.0.1",
     "karma-junit-reporter": "^2.0.1",
@@ -82,7 +83,7 @@
     "mocha": "^7.1.1",
     "mocha-junit-reporter": "^2.0.0",
     "nyc": "^15.0.0",
-    "typescript": "~4.2.0",
+    "typescript": "~4.8.0",
     "prettier": "^2.5.1",
     "rimraf": "^3.0.0"
   },
@@ -91,7 +92,7 @@
     "url": "https://github.com/Azure/azure-sdk-for-js/issues"
   },
   "engines": {
-    "node": ">=12.0.0"
+    "node": ">=14.0.0"
   },
   "sideEffects": false,
   "autoPublish": true,

package/types/communication-email.d.ts

@@ -1,48 +1,33 @@
+import { CommonClientOptions } from '@azure/core-client';
 import { KeyCredential } from '@azure/core-auth';
-import { PipelineOptions } from '@azure/core-http';
+import { OperationOptions } from '@azure/core-client';
+import { PollerLike } from '@azure/core-lro';
+import { PollOperationState } from '@azure/core-lro';
+import { TokenCredential } from '@azure/core-auth';
 
-/**
- * An object representing the email address and its display name
- */
+/** An object representing the email address and its display name */
 export declare interface EmailAddress {
-    /**
-     * Email address.
-     */
-    email: string;
-    /**
-     * Email display name.
-     */
+    /** Email address. */
+    address: string;
+    /** Email display name. */
     displayName?: string;
 }
 
-/**
- * Attachment to the email.
- */
+/** Attachment to the email. */
 export declare interface EmailAttachment {
-    /**
-     * Name of the attachment
-     */
+    /** Name of the attachment */
     name: string;
-    /**
-     * The type of attachment file.
-     */
-    attachmentType: EmailAttachmentType;
-    /**
-     * Base64 encoded contents of the attachment
-     */
-    contentBytesBase64: string;
+    /** MIME type of the content being attached. */
+    contentType: string;
+    /** Base64 encoded contents of the attachment */
+    contentInBase64: string;
 }
 
-/**
- * Defines values for EmailAttachmentType.
- */
-export declare type EmailAttachmentType = "avi" | "bmp" | "doc" | "docm" | "docx" | "gif" | "jpeg" | "mp3" | "one" | "pdf" | "png" | "ppsm" | "ppsx" | "ppt" | "pptm" | "pptx" | "pub" | "rpmsg" | "rtf" | "tif" | "txt" | "vsd" | "wav" | "wma" | "xls" | "xlsb" | "xlsm" | "xlsx";
-
 /**
  *  The Email service client.
  */
 export declare class EmailClient {
-    private readonly api;
+    private readonly generatedClient;
     /**
      * Initializes a new instance of the EmailClient class.
      * @param connectionString - Connection string to connect to an Azure Communication Service resource.
@@ -56,145 +41,173 @@ export declare class EmailClient {
      * @param credential - An object that is used to authenticate requests to the service. Use the Azure KeyCredential or `@azure/identity` to create a credential.
      * @param options - Optional. Options to configure the HTTP pipeline.
      */
-    constructor(endpoint: string, credential: KeyCredential, options?: EmailClientOptions);
+    constructor(endpoint: string, credential: KeyCredential | TokenCredential, options?: EmailClientOptions);
     /**
      * Queues an email message to be sent to one or more recipients
-     * @param emailMessage - Message payload for sending an email
+     * @param message - Message payload for sending an email
+     * @param options - The options parameters.
      */
-    send(emailMessage: EmailMessage): Promise<SendEmailResult>;
-    /**
-     * Gets the status of a message sent previously.
-     * @param messageId - System generated message id (GUID) returned from a previous call to send email
-     */
-    getSendStatus(messageId: string): Promise<SendStatusResult>;
+    beginSend(message: EmailMessage, options?: EmailSendOptionalParams): Promise<PollerLike<PollOperationState<EmailSendResponse>, EmailSendResponse>>;
 }
 
 /**
- * Client options used to configure SMS Client API requests.
+ * Client options used to configure Email Client API requests.
  */
-export declare interface EmailClientOptions extends PipelineOptions {
+export declare interface EmailClientOptions extends CommonClientOptions {
 }
 
-/**
- * Content of the email.
- */
-export declare interface EmailContent {
-    /**
-     * Subject of the email message
-     */
-    subject: string;
-    /**
-     * Plain text version of the email message.
-     */
-    plainText?: string;
-    /**
-     * Html version of the email message.
-     */
-    html?: string;
+/** Content of the email. */
+export declare type EmailContent = HtmlEmailContent | PlainTextEmailContent;
+
+/** Message payload for sending an email */
+export declare interface EmailMessage {
+    /** Custom email headers to be passed. */
+    headers?: {
+        [propertyName: string]: string;
+    };
+    /** Sender email address from a verified domain. */
+    senderAddress: string;
+    /** Email content to be sent. */
+    content: EmailContent;
+    /** Recipients for the email. */
+    recipients: EmailRecipients;
+    /** List of attachments. Please note that we limit the total size of an email request (which includes attachments) to 10MB. */
+    attachments?: EmailAttachment[];
+    /** Email addresses where recipients' replies will be sent to. */
+    replyTo?: EmailAddress[];
+    /** Indicates whether user engagement tracking should be disabled for this request if the resource-level user engagement tracking setting was already enabled in the control plane. */
+    disableUserEngagementTracking?: boolean;
 }
 
-/**
- * Custom header for email.
- */
-export declare interface EmailCustomHeader {
-    /**
-     * Header name.
-     */
-    name: string;
-    /**
-     * Header value.
-     */
-    value: string;
+/** Recipients of the email */
+export declare interface EmailRecipients {
+    /** Email To recipients */
+    to?: EmailAddress[];
+    /** Email CC recipients */
+    cc?: EmailAddress[];
+    /** Email BCC recipients */
+    bcc?: EmailAddress[];
 }
 
-/**
- * Defines values for EmailImportance.
- */
-export declare type EmailImportance = "high" | "normal" | "low";
+/** Defines headers for Email_send operation. */
+export declare interface EmailSendHeaders {
+    /** Location url of where to poll the status of this operation from. */
+    operationLocation?: string;
+    /** This header will only be present when the operation status is a non-terminal status. It indicates the minimum amount of time in seconds to wait before polling for operation status again. */
+    retryAfter?: number;
+}
+
+/** Optional parameters for the beginSend method. */
+export declare interface EmailSendOptionalParams extends OperationOptions {
+    /** This is the ID used by the status monitor for this long running operation. */
+    operationId?: string;
+    /** Delay to wait until next poll, in milliseconds. */
+    updateIntervalInMs?: number;
+    /** A serialized poller which can be used to resume an existing paused Long-Running-Operation. */
+    resumeFrom?: string;
+}
+
+/** Contains response data for the send operation. */
+export declare type EmailSendResponse = EmailSendHeaders & EmailSendResult;
+
+/** Status of the long running operation */
+export declare interface EmailSendResult {
+    /** The unique id of the operation. Use a UUID. */
+    id: string;
+    /** Status of operation. */
+    status: EmailSendStatus;
+    /** Error details when status is a non-success terminal state. */
+    error?: ErrorDetail;
+}
 
 /**
- * Message payload for sending an email
+ * Defines values for EmailSendStatus. \
+ * {@link KnownEmailSendStatus} can be used interchangeably with EmailSendStatus,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **NotStarted** \
+ * **Running** \
+ * **Succeeded** \
+ * **Failed** \
+ * **Canceled**
  */
-export declare interface EmailMessage {
-    /**
-     * Custom email headers to be passed.
-     */
-    customHeaders?: EmailCustomHeader[];
+export declare type EmailSendStatus = string;
+
+/** The resource management error additional info. */
+export declare interface ErrorAdditionalInfo {
     /**
-     * Sender email address from a verified domain.
+     * The additional info type.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    sender: string;
+    readonly type?: string;
     /**
-     * Email content to be sent.
+     * The additional info.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    content: EmailContent;
+    readonly info?: Record<string, unknown>;
+}
+
+/** The error detail. */
+export declare interface ErrorDetail {
     /**
-     * The importance type for the email.
+     * The error code.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    importance?: EmailImportance;
+    readonly code?: string;
     /**
-     * Recipients for the email.
+     * The error message.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    recipients: EmailRecipients;
+    readonly message?: string;
     /**
-     * list of attachments
+     * The error target.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    attachments?: EmailAttachment[];
+    readonly target?: string;
     /**
-     * Email addresses where recipients' replies will be sent to.
+     * The error details.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    replyTo?: EmailAddress[];
+    readonly details?: ErrorDetail[];
     /**
-     * Indicates whether user engagement tracking should be disabled for this request if the resource-level user engagement tracking setting was already enabled in the control plane.
+     * The error additional info.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    disableUserEngagementTracking?: boolean;
+    readonly additionalInfo?: ErrorAdditionalInfo[];
 }
 
-/**
- * Recipients of the email
- */
-export declare interface EmailRecipients {
-    /**
-     * Email to recipients
-     */
-    to: EmailAddress[];
-    /**
-     * Email cc recipients
-     */
-    cC?: EmailAddress[];
-    /**
-     * Email bcc recipients
-     */
-    bCC?: EmailAddress[];
+/** Content of the email with a required html property. */
+export declare interface HtmlEmailContent {
+    /** Subject of the email message */
+    subject: string;
+    /** Plain text version of the email message. */
+    plainText?: string;
+    /** Html version of the email message. */
+    html: string;
 }
 
-/**
- * Results of a sent email.
- */
-export declare interface SendEmailResult {
-    /**
-     * MessageId of the sent email.
-     */
-    messageId: string;
+/** Known values of {@link EmailSendStatus} that the service accepts. */
+export declare enum KnownEmailSendStatus {
+    /** NotStarted */
+    NotStarted = "NotStarted",
+    /** Running */
+    Running = "Running",
+    /** Succeeded */
+    Succeeded = "Succeeded",
+    /** Failed */
+    Failed = "Failed",
+    /** Canceled */
+    Canceled = "Canceled"
 }
 
-/**
- * Defines values for SendStatus.
- */
-export declare type SendStatus = "queued" | "outForDelivery" | "dropped";
-
-/**
- * Status of an email message that was sent previously.
- */
-export declare interface SendStatusResult {
-    /**
-     * System generated id of an email message sent.
-     */
-    messageId: string;
-    /**
-     * The type indicating the status of a request.
-     */
-    status: SendStatus;
+/** Content of the email with a required plainText property. */
+export declare interface PlainTextEmailContent {
+    /** Subject of the email message */
+    subject: string;
+    /** Plain text version of the email message. */
+    plainText: string;
+    /** Html version of the email message. */
+    html?: string;
 }
 
 export { }

package/dist-esm/samples-dev/checkMessageStatus.js

@@ -1,46 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-/**
- * @summary Checks the message status of a sent email
- */
-import { EmailClient } from "@azure/communication-email";
-// Load the .env file (you will need to set these environment variables)
-import * as dotenv from "dotenv";
-dotenv.config();
-const connectionString = process.env["COMMUNICATION_CONNECTION_STRING"] || "";
-const senderAddress = process.env["SENDER_ADDRESS"] || "";
-const recipientAddress = process.env["RECIPIENT_ADDRESS"] || "";
-const getMessageStatusFromEmail = async () => {
-    // Create the Email Client
-    const emailClient = new EmailClient(connectionString);
-    // Create the Email Message to be sent
-    const emailMessage = {
-        sender: senderAddress,
-        content: {
-            subject: "This is the subject",
-            plainText: "This is the body",
-            html: "<html><h1>This is the body</h1></html>",
-        },
-        recipients: {
-            to: [
-                {
-                    email: recipientAddress,
-                    displayName: "Customer Name",
-                },
-            ],
-        },
-    };
-    try {
-        // Send the email message
-        const sendEmailResponse = await emailClient.send(emailMessage);
-        // Use the message id to get the status of the email
-        const messageId = sendEmailResponse.messageId || "";
-        const getMessageStatusResponse = await emailClient.getSendStatus(messageId);
-        console.log("Message Status: " + getMessageStatusResponse);
-    }
-    catch (error) {
-        console.log(error);
-    }
-};
-void getMessageStatusFromEmail();
-//# sourceMappingURL=checkMessageStatus.js.map

package/dist-esm/samples-dev/checkMessageStatus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkMessageStatus.js","sourceRoot":"","sources":["../../samples-dev/checkMessageStatus.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAgB,MAAM,4BAA4B,CAAC;AAEvE,wEAAwE;AACxE,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,IAAI,EAAE,CAAC;AAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;AAC1D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;AAEhE,MAAM,yBAAyB,GAAG,KAAK,IAAmB,EAAE;IAC1D,0BAA0B;IAC1B,MAAM,WAAW,GAAgB,IAAI,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAEnE,sCAAsC;IACtC,MAAM,YAAY,GAAiB;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,OAAO,EAAE,qBAAqB;YAC9B,SAAS,EAAE,kBAAkB;YAC7B,IAAI,EAAE,wCAAwC;SAC/C;QACD,UAAU,EAAE;YACV,EAAE,EAAE;gBACF;oBACE,KAAK,EAAE,gBAAgB;oBACvB,WAAW,EAAE,eAAe;iBAC7B;aACF;SACF;KACF,CAAC;IAEF,IAAI;QACF,yBAAyB;QACzB,MAAM,iBAAiB,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE/D,oDAAoD;QACpD,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,IAAI,EAAE,CAAC;QACpD,MAAM,wBAAwB,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAE5E,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,wBAAwB,CAAC,CAAC;KAC5D;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;KACpB;AACH,CAAC,CAAC;AAEF,KAAK,yBAAyB,EAAE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * @summary Checks the message status of a sent email\n */\n\nimport { EmailClient, EmailMessage } from \"@azure/communication-email\";\n\n// Load the .env file (you will need to set these environment variables)\nimport * as dotenv from \"dotenv\";\ndotenv.config();\n\nconst connectionString = process.env[\"COMMUNICATION_CONNECTION_STRING\"] || \"\";\nconst senderAddress = process.env[\"SENDER_ADDRESS\"] || \"\";\nconst recipientAddress = process.env[\"RECIPIENT_ADDRESS\"] || \"\";\n\nconst getMessageStatusFromEmail = async (): Promise<void> => {\n  // Create the Email Client\n  const emailClient: EmailClient = new EmailClient(connectionString);\n\n  // Create the Email Message to be sent\n  const emailMessage: EmailMessage = {\n    sender: senderAddress,\n    content: {\n      subject: \"This is the subject\",\n      plainText: \"This is the body\",\n      html: \"<html><h1>This is the body</h1></html>\",\n    },\n    recipients: {\n      to: [\n        {\n          email: recipientAddress,\n          displayName: \"Customer Name\",\n        },\n      ],\n    },\n  };\n\n  try {\n    // Send the email message\n    const sendEmailResponse = await emailClient.send(emailMessage);\n\n    // Use the message id to get the status of the email\n    const messageId = sendEmailResponse.messageId || \"\";\n    const getMessageStatusResponse = await emailClient.getSendStatus(messageId);\n\n    console.log(\"Message Status: \" + getMessageStatusResponse);\n  } catch (error) {\n    console.log(error);\n  }\n};\n\nvoid getMessageStatusFromEmail();\n"]}

package/dist-esm/src/constants.js

@@ -1,4 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-export const SDK_VERSION = "1.0.0-beta.1";
-//# sourceMappingURL=constants.js.map

package/dist-esm/src/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,CAAC,MAAM,WAAW,GAAW,cAAc,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport const SDK_VERSION: string = \"1.0.0-beta.1\";\n"]}