@twilio/conversations 2.0.1-rc.7 → 2.1.0-rc.1

package/dist/data/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sources":["../../src/data/messages.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport { Logger } from '../logger';\n\nimport {\n  Message,\n  MessageUpdatedEventArgs,\n  MessageUpdateReason\n} from '../message';\nimport {\n  Conversation,\n  SendEmailOptions,\n  SendMediaOptions\n} from '../conversation';\nimport { UnsentMessage } from '../unsent-message';\n\nimport { SyncList, SyncClient } from 'twilio-sync';\nimport { SyncPaginator } from '../sync-paginator';\n\nimport { McsClient, McsMedia } from '@twilio/mcs-client';\nimport { Network } from '../services/network';\nimport { Configuration } from '../configuration';\nimport { CommandExecutor } from '../command-executor';\nimport { SendMessageRequest } from '../interfaces/commands/send-message';\nimport { MessageResponse } from '../interfaces/commands/message-response';\nimport { ReplayEventEmitter } from '@twilio/replay-event-emitter';\n\ntype MessagesEvents = {\n  messageAdded: (message: Message) => void;\n  messageRemoved: (message: Message) => void;\n  messageUpdated: (data: {\n    message: Message;\n    updateReasons: MessageUpdateReason[];\n  }) => void;\n};\n\nconst log = Logger.scope('Messages');\n\nexport interface MessagesServices {\n  mcsClient: McsClient;\n  network: Network;\n  syncClient: SyncClient;\n  commandExecutor: CommandExecutor;\n}\n\n/**\n * Represents the collection of messages in a conversation\n */\nclass Messages extends ReplayEventEmitter<MessagesEvents> {\n  public readonly conversation: Conversation;\n  private readonly configuration: Configuration;\n  private readonly services: MessagesServices;\n  private readonly messagesByIndex: Map<number, Message>;\n  private messagesListPromise: Promise<SyncList>;\n\n  public constructor(\n    conversation: Conversation,\n    configuration: Configuration,\n    services: MessagesServices\n  ) {\n    super();\n\n    this.conversation = conversation;\n    this.configuration = configuration;\n    this.services = services;\n\n    this.messagesByIndex = new Map();\n    this.messagesListPromise = null;\n  }\n\n  /**\n   * Subscribe to the Messages Event Stream\n   * @param name - The name of Sync object for the Messages resource.\n   */\n  public async subscribe(name: string) {\n    if (this.messagesListPromise) {\n      return this.messagesListPromise;\n    }\n\n    this.messagesListPromise = this.services.syncClient.list({\n      id: name,\n      mode: 'open_existing',\n    });\n\n    try {\n      const list = await this.messagesListPromise;\n\n      list.on('itemAdded', (args) => {\n        log.debug(`${this.conversation.sid} itemAdded: ${args.item.index}`);\n\n        const links = {\n          self: `${this.conversation.links.messages}/${args.item.data.sid}`,\n          conversation: this.conversation.links.self,\n          messages_receipts: `${this.conversation.links.messages}/${args.item.data.sid}/Receipts`,\n        };\n        const message = new Message(\n          args.item.index,\n          args.item.data,\n          this.conversation,\n          links,\n          this.configuration,\n          this.services\n        );\n\n        if (this.messagesByIndex.has(message.index)) {\n          log.debug(\n            'Message arrived, but is already known and ignored',\n            this.conversation.sid,\n            message.index\n          );\n          return;\n        }\n\n        this.messagesByIndex.set(message.index, message);\n\n        message.on('updated', (args: MessageUpdatedEventArgs) =>\n          this.emit('messageUpdated', args)\n        );\n\n        this.emit('messageAdded', message);\n      });\n\n      list.on('itemRemoved', (args) => {\n        log.debug(`#{this.conversation.sid} itemRemoved: ${args.index}`);\n\n        const index = args.index;\n\n        if (this.messagesByIndex.has(index)) {\n          let message = this.messagesByIndex.get(index);\n          this.messagesByIndex.delete(message.index);\n          message.removeAllListeners('updated');\n          this.emit('messageRemoved', message);\n        }\n      });\n\n      list.on('itemUpdated', (args) => {\n        log.debug(`${this.conversation.sid} itemUpdated: ${args.item.index}`);\n\n        const message = this.messagesByIndex.get(args.item.index);\n\n        if (message) {\n          message._update(args.item.data);\n        }\n      });\n\n      return list;\n    } catch (err) {\n      this.messagesListPromise = null;\n\n      if (this.services.syncClient.connectionState !== 'disconnected') {\n        log.error(\n          'Failed to get messages object for conversation',\n          this.conversation.sid,\n          err\n        );\n      }\n\n      log.debug(\n        'ERROR: Failed to get messages object for conversation',\n        this.conversation.sid,\n        err\n      );\n\n      throw err;\n    }\n  }\n\n  public async unsubscribe() {\n    if (!this.messagesListPromise) {\n      return;\n    }\n\n    const entity = await this.messagesListPromise;\n    entity.close();\n    this.messagesListPromise = null;\n  }\n\n  /**\n   * Send Message to the conversation, message could include both text and multiple media attachments.\n   * @param message Message to post\n   * @returns Returns promise which can fail\n   */\n  public async sendV2(message: UnsentMessage) {\n    log.debug(\n      'Sending message V2',\n      message.mediaContent,\n      message.attributes,\n      message.emailOptions\n    );\n\n    const media: McsMedia[] = [];\n\n    for (const [category, mediaContent] of message.mediaContent) {\n      log.debug(\n        `Adding media to a message as ${\n          mediaContent instanceof FormData ? 'FormData' : 'SendMediaOptions'\n        }`,\n        mediaContent\n      );\n\n      media.push(\n        mediaContent instanceof FormData\n          ? await this.services.mcsClient.postFormData(mediaContent, category)\n          : await this.services.mcsClient.post(\n            mediaContent.contentType,\n            mediaContent.media,\n            category,\n            mediaContent.filename\n          )\n      );\n    }\n\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n    >('post', this.conversation.links.messages, {\n      body: message.text,\n      subject: message.emailOptions?.subject,\n      media_sids: media.map((m) => m.sid),\n      attributes:\n        typeof message.attributes !== 'undefined'\n          ? JSON.stringify(message.attributes)\n          : undefined,\n    });\n  }\n\n  /**\n   * Send Message to the conversation\n   * @param message Message to post\n   * @param attributes Message attributes\n   * @param emailOptions Options that modify E-mail integration behaviors.\n   * @returns Returns promise which can fail\n   */\n  public async send(\n    message: string | null,\n    attributes: any = {},\n    emailOptions?: SendEmailOptions\n  ): Promise<MessageResponse> {\n    log.debug('Sending text message', message, attributes, emailOptions);\n\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n      >('post', this.conversation.links.messages, {\n      body: message ?? '',\n      attributes:\n        typeof attributes !== 'undefined'\n          ? JSON.stringify(attributes)\n          : undefined,\n      subject: emailOptions?.subject,\n    });\n  }\n\n  /**\n   * Send Media Message to the conversation\n   * @param mediaContent Media content to post\n   * @param attributes Message attributes\n   * @param emailOptions Email options\n   * @returns Returns promise which can fail\n   */\n  public async sendMedia(\n    mediaContent: FormData | SendMediaOptions,\n    attributes: any = {},\n    emailOptions?: SendEmailOptions\n  ) {\n    log.debug('Sending media message', mediaContent, attributes, emailOptions);\n    log.debug(\n      `Sending media message as ${\n        mediaContent instanceof FormData ? 'FormData' : 'SendMediaOptions'\n      }`,\n      mediaContent,\n      attributes\n    );\n\n    const media: McsMedia =\n      mediaContent instanceof FormData\n        ? await this.services.mcsClient.postFormData(mediaContent)\n        : await this.services.mcsClient.post(\n          mediaContent.contentType,\n          mediaContent.media,\n          'media',\n          mediaContent.filename\n        );\n\n    // emailOptions are currently ignored for media messages.\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n      >('post', this.conversation.links.messages, {\n      media_sids: [media.sid],\n      attributes:\n        typeof attributes !== 'undefined'\n          ? JSON.stringify(attributes)\n          : undefined,\n    });\n  }\n\n  /**\n   * Returns messages from conversation using paginator interface\n   * @param pageSize Number of messages to return in single chunk. By default it's 30.\n   * @param anchor Most early message id which is already known, or 'end' by default\n   * @param direction Pagination order 'backwards' or 'forward', 'forward' by default\n   * @returns Last page of messages by default\n   */\n  public async getMessages(\n    pageSize: number,\n    anchor: number | 'end',\n    direction: 'forward' | 'backwards' = 'backwards'\n  ): Promise<SyncPaginator<Message>> {\n    return this._getMessages(pageSize, anchor, direction);\n  }\n\n  private _wrapPaginator(order, page, op) {\n    // Due to an inconsistency between Sync and Chat conventions, next and\n    // previous pages should be swapped.\n    const shouldReverse = order === 'desc';\n\n    const nextPage = () =>\n      page.nextPage().then((page) => this._wrapPaginator(order, page, op));\n    const previousPage = () =>\n      page.prevPage().then((page) => this._wrapPaginator(order, page, op));\n\n    return op(page.items).then((items) => ({\n      items: items.sort((x, y) => {\n        return x.index - y.index;\n      }),\n      hasPrevPage: shouldReverse ? page.hasNextPage : page.hasPrevPage,\n      hasNextPage: shouldReverse ? page.hasPrevPage : page.hasNextPage,\n      prevPage: shouldReverse ? nextPage : previousPage,\n      nextPage: shouldReverse ? previousPage : nextPage,\n    }));\n  }\n\n  private _upsertMessage(index: number, value: any) {\n    const cachedMessage = this.messagesByIndex.get(index);\n\n    if (cachedMessage) {\n      return cachedMessage;\n    }\n\n    const links = {\n      self: `${this.conversation.links.messages}/${value.sid}`,\n      conversation: this.conversation.links.self,\n      messages_receipts: `${this.conversation.links.messages}/${value.sid}/Receipts`,\n    };\n    const message = new Message(\n      index,\n      value,\n      this.conversation,\n      links,\n      this.configuration,\n      this.services\n    );\n\n    this.messagesByIndex.set(message.index, message);\n\n    message.on('updated', (args: MessageUpdatedEventArgs) =>\n      this.emit('messageUpdated', args)\n    );\n\n    return message;\n  }\n\n  /**\n   * Returns last messages from conversation\n   * @param {Number} [pageSize] Number of messages to return in single chunk. By default it's 30.\n   * @param {String} [anchor] Most early message id which is already known, or 'end' by default\n   * @param {String} [direction] Pagination order 'backwards' or 'forward', or 'forward' by default\n   * @returns {Promise<SyncPaginator<Message>>} last page of messages by default\n   * @private\n   */\n  private async _getMessages(\n    pageSize = 30,\n    anchor: number | 'end' = 'end',\n    direction: 'forward' | 'backwards' = 'forward'\n  ): Promise<SyncPaginator<Message>> {\n    const order = direction === 'backwards' ? 'desc' : 'asc';\n    const list = await this.messagesListPromise;\n    const page = await list.getItems({\n      from: anchor !== 'end' ? anchor : void 0,\n      pageSize,\n      order,\n      limit: pageSize, // @todo Limit equals pageSize by default in Sync. This is probably not ideal.\n    });\n\n    return await this._wrapPaginator(order, page, (items) =>\n      Promise.all(\n        items.map((item) => this._upsertMessage(item.index, item.data))\n      )\n    );\n  }\n}\n\nexport { Messages };\n"],"names":["Logger","ReplayEventEmitter","message","Message"],"mappings":"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"}
+{"version":3,"file":"messages.js","sources":["../../src/data/messages.ts"],"sourcesContent":["import { Logger } from '../logger';\n\nimport {\n  Message,\n  MessageUpdatedEventArgs,\n  MessageUpdateReason\n} from '../message';\nimport {\n  Conversation,\n  SendEmailOptions,\n  SendMediaOptions,\n} from '../conversation';\nimport { UnsentMessage } from '../unsent-message';\n\nimport { SyncList, SyncClient } from 'twilio-sync';\nimport { SyncPaginator } from '../sync-paginator';\n\nimport { McsClient, McsMedia } from '@twilio/mcs-client';\nimport { Network } from '../services/network';\nimport { Configuration } from '../configuration';\nimport { CommandExecutor } from '../command-executor';\nimport { SendMessageRequest } from '../interfaces/commands/send-message';\nimport { MessageResponse } from '../interfaces/commands/message-response';\nimport { ReplayEventEmitter } from '@twilio/replay-event-emitter';\n\ntype MessagesEvents = {\n  messageAdded: (message: Message) => void;\n  messageRemoved: (message: Message) => void;\n  messageUpdated: (data: {\n    message: Message;\n    updateReasons: MessageUpdateReason[];\n  }) => void;\n};\n\nconst log = Logger.scope('Messages');\n\nexport interface MessagesServices {\n  mcsClient: McsClient;\n  network: Network;\n  syncClient: SyncClient;\n  commandExecutor: CommandExecutor;\n}\n\n/**\n * Represents the collection of messages in a conversation\n */\nclass Messages extends ReplayEventEmitter<MessagesEvents> {\n  public readonly conversation: Conversation;\n  private readonly configuration: Configuration;\n  private readonly services: MessagesServices;\n  private readonly messagesByIndex: Map<number, Message>;\n  private messagesListPromise: Promise<SyncList>;\n\n  public constructor(\n    conversation: Conversation,\n    configuration: Configuration,\n    services: MessagesServices\n  ) {\n    super();\n\n    this.conversation = conversation;\n    this.configuration = configuration;\n    this.services = services;\n\n    this.messagesByIndex = new Map();\n    this.messagesListPromise = null;\n  }\n\n  /**\n   * Subscribe to the Messages Event Stream\n   * @param name - The name of Sync object for the Messages resource.\n   */\n  public async subscribe(name: string) {\n    if (this.messagesListPromise) {\n      return this.messagesListPromise;\n    }\n\n    this.messagesListPromise = this.services.syncClient.list({\n      id: name,\n      mode: 'open_existing',\n    });\n\n    try {\n      const list = await this.messagesListPromise;\n\n      list.on('itemAdded', (args) => {\n        log.debug(`${this.conversation.sid} itemAdded: ${args.item.index}`);\n\n        const links = {\n          self: `${this.conversation.links.messages}/${args.item.data.sid}`,\n          conversation: this.conversation.links.self,\n          messages_receipts: `${this.conversation.links.messages}/${args.item.data.sid}/Receipts`,\n        };\n        const message = new Message(\n          args.item.index,\n          args.item.data,\n          this.conversation,\n          links,\n          this.configuration,\n          this.services\n        );\n\n        if (this.messagesByIndex.has(message.index)) {\n          log.debug(\n            'Message arrived, but is already known and ignored',\n            this.conversation.sid,\n            message.index\n          );\n          return;\n        }\n\n        this.messagesByIndex.set(message.index, message);\n\n        message.on('updated', (args: MessageUpdatedEventArgs) =>\n          this.emit('messageUpdated', args)\n        );\n\n        this.emit('messageAdded', message);\n      });\n\n      list.on('itemRemoved', (args) => {\n        log.debug(`#{this.conversation.sid} itemRemoved: ${args.index}`);\n\n        const index = args.index;\n\n        if (this.messagesByIndex.has(index)) {\n          let message = this.messagesByIndex.get(index);\n          this.messagesByIndex.delete(message.index);\n          message.removeAllListeners('updated');\n          this.emit('messageRemoved', message);\n        }\n      });\n\n      list.on('itemUpdated', (args) => {\n        log.debug(`${this.conversation.sid} itemUpdated: ${args.item.index}`);\n\n        const message = this.messagesByIndex.get(args.item.index);\n\n        if (message) {\n          message._update(args.item.data);\n        }\n      });\n\n      return list;\n    } catch (err) {\n      this.messagesListPromise = null;\n\n      if (this.services.syncClient.connectionState !== 'disconnected') {\n        log.error(\n          'Failed to get messages object for conversation',\n          this.conversation.sid,\n          err\n        );\n      }\n\n      log.debug(\n        'ERROR: Failed to get messages object for conversation',\n        this.conversation.sid,\n        err\n      );\n\n      throw err;\n    }\n  }\n\n  public async unsubscribe() {\n    if (!this.messagesListPromise) {\n      return;\n    }\n\n    const entity = await this.messagesListPromise;\n    entity.close();\n    this.messagesListPromise = null;\n  }\n\n  /**\n   * Send Message to the conversation, message could include both text and multiple media attachments.\n   * @param message Message to post\n   * @returns Returns a promise which can fail\n   */\n  public async sendV2(message: UnsentMessage): Promise<MessageResponse> {\n    log.debug(\n      'Sending message V2',\n      message.mediaContent,\n      message.attributes,\n      message.emailOptions\n    );\n\n    const media: McsMedia[] = [];\n\n    for (const [category, mediaContent] of message.mediaContent) {\n      log.debug(\n        `Adding media to a message as ${\n          mediaContent instanceof FormData ? 'FormData' : 'SendMediaOptions'\n        }`,\n        mediaContent\n      );\n\n      media.push(\n        mediaContent instanceof FormData\n          ? await this.services.mcsClient.postFormData(mediaContent, category)\n          : await this.services.mcsClient.post(\n            mediaContent.contentType,\n            mediaContent.media,\n            category,\n            mediaContent.filename\n          )\n      );\n    }\n\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n    >('post', this.conversation.links.messages, {\n      body: message.text,\n      subject: message.emailOptions?.subject,\n      media_sids: media.map((m) => m.sid),\n      attributes:\n        typeof message.attributes !== 'undefined'\n          ? JSON.stringify(message.attributes)\n          : undefined,\n    });\n  }\n\n  /**\n   * Send Message to the conversation\n   * @param message Message to post\n   * @param attributes Message attributes\n   * @param emailOptions Options that modify E-mail integration behaviors.\n   * @returns Returns promise which can fail\n   */\n  public async send(\n    message: string | null,\n    attributes: any = {},\n    emailOptions?: SendEmailOptions\n  ): Promise<MessageResponse> {\n    log.debug('Sending text message', message, attributes, emailOptions);\n\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n      >('post', this.conversation.links.messages, {\n      body: message ?? '',\n      attributes:\n        typeof attributes !== 'undefined'\n          ? JSON.stringify(attributes)\n          : undefined,\n      subject: emailOptions?.subject,\n    });\n  }\n\n  /**\n   * Send Media Message to the conversation\n   * @param mediaContent Media content to post\n   * @param attributes Message attributes\n   * @param emailOptions Email options\n   * @returns Returns promise which can fail\n   */\n  public async sendMedia(\n    mediaContent: FormData | SendMediaOptions,\n    attributes: any = {},\n    emailOptions?: SendEmailOptions\n  ) {\n    log.debug('Sending media message', mediaContent, attributes, emailOptions);\n    log.debug(\n      `Sending media message as ${\n        mediaContent instanceof FormData ? 'FormData' : 'SendMediaOptions'\n      }`,\n      mediaContent,\n      attributes\n    );\n\n    const media: McsMedia =\n      mediaContent instanceof FormData\n        ? await this.services.mcsClient.postFormData(mediaContent)\n        : await this.services.mcsClient.post(\n          mediaContent.contentType,\n          mediaContent.media,\n          'media',\n          mediaContent.filename\n        );\n\n    // emailOptions are currently ignored for media messages.\n    return await this.services.commandExecutor.mutateResource<\n      SendMessageRequest,\n      MessageResponse\n      >('post', this.conversation.links.messages, {\n      media_sids: [media.sid],\n      attributes:\n        typeof attributes !== 'undefined'\n          ? JSON.stringify(attributes)\n          : undefined,\n    });\n  }\n\n  /**\n   * Returns messages from conversation using paginator interface\n   * @param pageSize Number of messages to return in single chunk. By default it's 30.\n   * @param anchor Most early message id which is already known, or 'end' by default\n   * @param direction Pagination order 'backwards' or 'forward', 'forward' by default\n   * @returns Last page of messages by default\n   */\n  public async getMessages(\n    pageSize: number,\n    anchor: number | 'end',\n    direction: 'forward' | 'backwards' = 'backwards'\n  ): Promise<SyncPaginator<Message>> {\n    return this._getMessages(pageSize, anchor, direction);\n  }\n\n  private _wrapPaginator(order, page, op) {\n    // Due to an inconsistency between Sync and Chat conventions, next and\n    // previous pages should be swapped.\n    const shouldReverse = order === 'desc';\n\n    const nextPage = () =>\n      page.nextPage().then((page) => this._wrapPaginator(order, page, op));\n    const previousPage = () =>\n      page.prevPage().then((page) => this._wrapPaginator(order, page, op));\n\n    return op(page.items).then((items) => ({\n      items: items.sort((x, y) => {\n        return x.index - y.index;\n      }),\n      hasPrevPage: shouldReverse ? page.hasNextPage : page.hasPrevPage,\n      hasNextPage: shouldReverse ? page.hasPrevPage : page.hasNextPage,\n      prevPage: shouldReverse ? nextPage : previousPage,\n      nextPage: shouldReverse ? previousPage : nextPage,\n    }));\n  }\n\n  private _upsertMessage(index: number, value: any) {\n    const cachedMessage = this.messagesByIndex.get(index);\n\n    if (cachedMessage) {\n      return cachedMessage;\n    }\n\n    const links = {\n      self: `${this.conversation.links.messages}/${value.sid}`,\n      conversation: this.conversation.links.self,\n      messages_receipts: `${this.conversation.links.messages}/${value.sid}/Receipts`,\n    };\n    const message = new Message(\n      index,\n      value,\n      this.conversation,\n      links,\n      this.configuration,\n      this.services\n    );\n\n    this.messagesByIndex.set(message.index, message);\n\n    message.on('updated', (args: MessageUpdatedEventArgs) =>\n      this.emit('messageUpdated', args)\n    );\n\n    return message;\n  }\n\n  /**\n   * Returns last messages from conversation\n   * @param {Number} [pageSize] Number of messages to return in single chunk. By default it's 30.\n   * @param {String} [anchor] Most early message id which is already known, or 'end' by default\n   * @param {String} [direction] Pagination order 'backwards' or 'forward', or 'forward' by default\n   * @returns {Promise<SyncPaginator<Message>>} last page of messages by default\n   * @private\n   */\n  private async _getMessages(\n    pageSize = 30,\n    anchor: number | 'end' = 'end',\n    direction: 'forward' | 'backwards' = 'forward'\n  ): Promise<SyncPaginator<Message>> {\n    const order = direction === 'backwards' ? 'desc' : 'asc';\n    const list = await this.messagesListPromise;\n    const page = await list.getItems({\n      from: anchor !== 'end' ? anchor : void 0,\n      pageSize,\n      order,\n      limit: pageSize, // @todo Limit equals pageSize by default in Sync. This is probably not ideal.\n    });\n\n    return await this._wrapPaginator(order, page, (items) =>\n      Promise.all(\n        items.map((item) => this._upsertMessage(item.index, item.data))\n      )\n    );\n  }\n}\n\nexport { Messages };\n"],"names":["Logger","ReplayEventEmitter","message","Message"],"mappings":"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"}

package/dist/data/participants.js

@@ -219,7 +219,7 @@ class Participants extends replayEventEmitter.ReplayEventEmitter {
     /**
      * @returns {Promise<Array<Participant>>} returns list of participants {@see Participant}
      */
-    getParticipants() {
+    async getParticipants() {
         return this.rosterEntityPromise.then(() => {
             let participants = [];
             this.participants.forEach(participant => participants.push(participant));
@@ -273,14 +273,18 @@ class Participants extends replayEventEmitter.ReplayEventEmitter {
      * @param proxyAddress
      * @param address
      * @param attributes
+     * @param bindingOptions
      * @returns {Promise<any>}
      */
-    addNonChatParticipant(proxyAddress, address, attributes) {
+    addNonChatParticipant(proxyAddress, address, attributes = {}, bindingOptions = {}) {
+        var _a, _b;
         return this.services.commandExecutor.mutateResource('post', this.links.participants, {
             attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined,
             messaging_binding: {
                 address,
-                proxy_address: proxyAddress
+                proxy_address: proxyAddress,
+                name: (_a = bindingOptions === null || bindingOptions === void 0 ? void 0 : bindingOptions.email) === null || _a === void 0 ? void 0 : _a.name,
+                level: (_b = bindingOptions === null || bindingOptions === void 0 ? void 0 : bindingOptions.email) === null || _b === void 0 ? void 0 : _b.level,
             }
         });
     }

package/dist/data/participants.js.map

@@ -1 +1 @@
-{"version":3,"file":"participants.js","sources":["../../src/data/participants.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport {\n  ParticipantDescriptor,\n  Participant,\n  ParticipantUpdatedEventArgs,\n  ParticipantUpdateReason\n} from '../participant';\nimport { Logger } from '../logger';\n\nimport { Conversation } from '../conversation';\n\nimport { SyncMap, SyncClient } from 'twilio-sync';\nimport { Users } from './users';\nimport { CommandExecutor } from '../command-executor';\nimport {\n  AddParticipantRequest\n} from '../interfaces/commands/add-participant';\nimport { Configuration } from '../configuration';\nimport { ParticipantResponse } from '../interfaces/commands/participant-response';\nimport { ReplayEventEmitter } from '@twilio/replay-event-emitter';\n\ntype ParticipantsEvents = {\n  participantJoined: (participant: Participant) => void;\n  participantLeft: (participant: Participant) => void;\n  participantUpdated: (data: {\n    participant: Participant;\n    updateReasons: ParticipantUpdateReason[];\n  }) => void;\n};\n\nconst log = Logger.scope('Participants');\n\nexport interface ParticipantsServices {\n  syncClient: SyncClient;\n  users: Users;\n  commandExecutor: CommandExecutor;\n}\n\ninterface ParticipantsLinks {\n  participants: string;\n}\n\n/**\n * @classdesc Represents the collection of participants for the conversation\n * @fires Participants#participantJoined\n * @fires Participants#participantLeft\n * @fires Participants#participantUpdated\n */\nclass Participants extends ReplayEventEmitter<ParticipantsEvents> {\n\n  private readonly configuration: Configuration;\n  private readonly services: ParticipantsServices;\n  private readonly links: ParticipantsLinks;\n\n  rosterEntityPromise: Promise<SyncMap>;\n\n  public readonly conversation: Conversation;\n  public readonly participants: Map<string, Participant>;\n\n  constructor(\n    conversation: Conversation,\n    participants: Map<string, Participant>,\n    links: ParticipantsLinks,\n    configuration: Configuration,\n    services: ParticipantsServices,\n  ) {\n    super();\n    this.conversation = conversation;\n    this.participants = participants;\n    this.links = links;\n    this.configuration = configuration;\n    this.services = services;\n  }\n\n  async unsubscribe(): Promise<void> {\n    if (this.rosterEntityPromise) {\n      let entity = await this.rosterEntityPromise;\n      entity.close();\n      this.rosterEntityPromise = null;\n    }\n  }\n\n  subscribe(rosterObjectName: string) {\n    return this.rosterEntityPromise = this.rosterEntityPromise\n      || this.services.syncClient.map({ id: rosterObjectName, mode: 'open_existing' })\n             .then(rosterMap => {\n               rosterMap.on('itemAdded', args => {\n                 log.debug(this.conversation.sid + ' itemAdded: ' + args.item.key);\n                 this.upsertParticipant(args.item.key, args.item.data)\n                     .then(participant => {\n                       this.emit('participantJoined', participant);\n                     });\n               });\n\n               rosterMap.on('itemRemoved', args => {\n                 log.debug(this.conversation.sid + ' itemRemoved: ' + args.key);\n                 let participantSid = args.key;\n                 if (!this.participants.has(participantSid)) {\n                   return;\n                 }\n                 let leftParticipant = this.participants.get(participantSid);\n                 this.participants.delete(participantSid);\n                 this.emit('participantLeft', leftParticipant);\n               });\n\n               rosterMap.on('itemUpdated', args => {\n                 log.debug(this.conversation.sid + ' itemUpdated: ' + args.item.key);\n                 this.upsertParticipant(args.item.key, args.item.data);\n               });\n\n               let participantsPromises = [];\n               let that = this;\n               const rosterMapHandler = function(paginator) {\n                 paginator.items.forEach(item => { participantsPromises.push(that.upsertParticipant(item.key, item.data)); });\n                 return paginator.hasNextPage ? paginator.nextPage().then(rosterMapHandler) : null;\n               };\n\n               return rosterMap\n                 .getItems()\n                 .then(rosterMapHandler)\n                 .then(() => Promise.all(participantsPromises))\n                 .then(() => rosterMap);\n             })\n             .catch(err => {\n               this.rosterEntityPromise = null;\n               if (this.services.syncClient.connectionState != 'disconnected') {\n                 log.error('Failed to get roster object for conversation', this.conversation.sid, err);\n               }\n               log.debug('ERROR: Failed to get roster object for conversation', this.conversation.sid, err);\n               throw err;\n             });\n  }\n\n  async upsertParticipant(participantSid: string, data: ParticipantDescriptor): Promise<Participant> {\n    let participant = this.participants.get(participantSid);\n    if (participant) {\n      return participant._update(data);\n    }\n\n    const links = {\n      self: `${this.links.participants}/${participantSid}`\n    };\n\n    participant = new Participant(data, participantSid, this.conversation, links, this.services);\n    this.participants.set(participantSid, participant);\n    participant.on('updated', (args: ParticipantUpdatedEventArgs) => this.emit('participantUpdated', args));\n    return participant;\n  }\n\n  /**\n   * @returns {Promise<Array<Participant>>} returns list of participants {@see Participant}\n   */\n  getParticipants(): Promise<Array<Participant>> {\n    return this.rosterEntityPromise.then(() => {\n      let participants = [];\n      this.participants.forEach(participant => participants.push(participant));\n      return participants;\n    });\n  }\n\n  /**\n   * Get participant by SID from conversation\n   * @returns {Promise<Participant>}\n   */\n  async getParticipantBySid(participantSid: string): Promise<Participant> {\n    return this.rosterEntityPromise.then(() => {\n      let participant = this.participants.get(participantSid);\n      if (!participant) {\n        throw new Error('Participant with SID ' + participantSid + ' was not found');\n      }\n      return participant;\n    });\n  }\n\n  /**\n   * Get participant by identity from conversation\n   * @returns {Promise<Participant>}\n   */\n  async getParticipantByIdentity(identity: string): Promise<Participant> {\n    let foundParticipant = null;\n    return this.rosterEntityPromise.then(() => {\n      this.participants.forEach(participant => {\n        if (participant.identity === identity) {\n          foundParticipant = participant;\n        }\n      });\n      if (!foundParticipant) {\n        throw new Error('Participant with identity ' + identity + ' was not found');\n      }\n      return foundParticipant;\n    });\n  }\n\n  /**\n   * Add a chat participant to the conversation\n   * @returns {Promise<any>}\n   */\n  async add(identity: string, attributes: any): Promise<any> {\n    return await this.services.commandExecutor.mutateResource<AddParticipantRequest, ParticipantResponse>(\n      'post',\n      this.links.participants,\n      {\n        identity,\n        attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined\n      }\n    );\n  }\n\n  /**\n   * Add a non-chat participant to the conversation.\n   *\n   * @param proxyAddress\n   * @param address\n   * @param attributes\n   * @returns {Promise<any>}\n   */\n  addNonChatParticipant(proxyAddress: string, address: string, attributes: any): Promise<any> {\n    return this.services.commandExecutor.mutateResource<AddParticipantRequest, ParticipantResponse>(\n      'post',\n      this.links.participants,\n      {\n        attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined,\n        messaging_binding: {\n          address,\n          proxy_address: proxyAddress\n        }\n      }\n    );\n  }\n\n  /**\n   * Remove the participant with a given identity from a conversation.\n   */\n  remove(identity: string): Promise<any> {\n    return this.services.commandExecutor.mutateResource(\n      'delete',\n      `${this.links.participants}/${identity}`,\n    );\n  }\n}\n\nexport { Participants };\n\n/**\n * Fired when participant joined conversation\n * @event Participants#participantJoined\n * @type {Participant}\n */\n\n/**\n * Fired when participant left conversation\n * @event Participants#participantLeft\n * @type {Participant}\n */\n\n/**\n * Fired when participant updated\n * @event Participants#participantUpdated\n * @type {Object}\n * @property {Participant} participant - Updated Participant\n * @property {Participant#UpdateReason[]} updateReasons - Array of Participant's updated event reasons\n */\n"],"names":["Logger","ReplayEventEmitter","participant","Participant"],"mappings":"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"}
+{"version":3,"file":"participants.js","sources":["../../src/data/participants.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport {\n  ParticipantDescriptor,\n  Participant,\n  ParticipantUpdatedEventArgs,\n  ParticipantUpdateReason,\n  ParticipantEmailBinding\n} from '../participant';\nimport { Logger } from '../logger';\n\nimport { Conversation } from '../conversation';\n\nimport { SyncMap, SyncClient } from 'twilio-sync';\nimport { Users } from './users';\nimport { CommandExecutor } from '../command-executor';\nimport {\n  AddParticipantRequest\n} from '../interfaces/commands/add-participant';\nimport { Configuration } from '../configuration';\nimport { ParticipantResponse } from '../interfaces/commands/participant-response';\nimport { ReplayEventEmitter } from '@twilio/replay-event-emitter';\n\ntype ParticipantsEvents = {\n  participantJoined: (participant: Participant) => void;\n  participantLeft: (participant: Participant) => void;\n  participantUpdated: (data: {\n    participant: Participant;\n    updateReasons: ParticipantUpdateReason[];\n  }) => void;\n};\n\nconst log = Logger.scope('Participants');\n\nexport interface ParticipantsServices {\n  syncClient: SyncClient;\n  users: Users;\n  commandExecutor: CommandExecutor;\n}\n\ninterface ParticipantsLinks {\n  participants: string;\n}\n\nexport interface ParticipantBindingOptions {\n  email?: ParticipantEmailBinding;\n}\n\n/**\n * @classdesc Represents the collection of participants for the conversation\n * @fires Participants#participantJoined\n * @fires Participants#participantLeft\n * @fires Participants#participantUpdated\n */\nclass Participants extends ReplayEventEmitter<ParticipantsEvents> {\n\n  private readonly configuration: Configuration;\n  private readonly services: ParticipantsServices;\n  private readonly links: ParticipantsLinks;\n\n  rosterEntityPromise: Promise<SyncMap>;\n\n  public readonly conversation: Conversation;\n  public readonly participants: Map<string, Participant>;\n\n  constructor(\n    conversation: Conversation,\n    participants: Map<string, Participant>,\n    links: ParticipantsLinks,\n    configuration: Configuration,\n    services: ParticipantsServices,\n  ) {\n    super();\n    this.conversation = conversation;\n    this.participants = participants;\n    this.links = links;\n    this.configuration = configuration;\n    this.services = services;\n  }\n\n  async unsubscribe(): Promise<void> {\n    if (this.rosterEntityPromise) {\n      let entity = await this.rosterEntityPromise;\n      entity.close();\n      this.rosterEntityPromise = null;\n    }\n  }\n\n  subscribe(rosterObjectName: string) {\n    return this.rosterEntityPromise = this.rosterEntityPromise\n      || this.services.syncClient.map({ id: rosterObjectName, mode: 'open_existing' })\n             .then(rosterMap => {\n               rosterMap.on('itemAdded', args => {\n                 log.debug(this.conversation.sid + ' itemAdded: ' + args.item.key);\n                 this.upsertParticipant(args.item.key, args.item.data)\n                     .then(participant => {\n                       this.emit('participantJoined', participant);\n                     });\n               });\n\n               rosterMap.on('itemRemoved', args => {\n                 log.debug(this.conversation.sid + ' itemRemoved: ' + args.key);\n                 let participantSid = args.key;\n                 if (!this.participants.has(participantSid)) {\n                   return;\n                 }\n                 let leftParticipant = this.participants.get(participantSid);\n                 this.participants.delete(participantSid);\n                 this.emit('participantLeft', leftParticipant);\n               });\n\n               rosterMap.on('itemUpdated', args => {\n                 log.debug(this.conversation.sid + ' itemUpdated: ' + args.item.key);\n                 this.upsertParticipant(args.item.key, args.item.data);\n               });\n\n               let participantsPromises = [];\n               let that = this;\n               const rosterMapHandler = function(paginator) {\n                 paginator.items.forEach(item => { participantsPromises.push(that.upsertParticipant(item.key, item.data)); });\n                 return paginator.hasNextPage ? paginator.nextPage().then(rosterMapHandler) : null;\n               };\n\n               return rosterMap\n                 .getItems()\n                 .then(rosterMapHandler)\n                 .then(() => Promise.all(participantsPromises))\n                 .then(() => rosterMap);\n             })\n             .catch(err => {\n               this.rosterEntityPromise = null;\n               if (this.services.syncClient.connectionState != 'disconnected') {\n                 log.error('Failed to get roster object for conversation', this.conversation.sid, err);\n               }\n               log.debug('ERROR: Failed to get roster object for conversation', this.conversation.sid, err);\n               throw err;\n             });\n  }\n\n  async upsertParticipant(participantSid: string, data: ParticipantDescriptor): Promise<Participant> {\n    let participant = this.participants.get(participantSid);\n    if (participant) {\n      return participant._update(data);\n    }\n\n    const links = {\n      self: `${this.links.participants}/${participantSid}`\n    };\n\n    participant = new Participant(data, participantSid, this.conversation, links, this.services);\n    this.participants.set(participantSid, participant);\n    participant.on('updated', (args: ParticipantUpdatedEventArgs) => this.emit('participantUpdated', args));\n    return participant;\n  }\n\n  /**\n   * @returns {Promise<Array<Participant>>} returns list of participants {@see Participant}\n   */\n  async getParticipants(): Promise<Array<Participant>> {\n    return this.rosterEntityPromise.then(() => {\n      let participants = [];\n      this.participants.forEach(participant => participants.push(participant));\n      return participants;\n    });\n  }\n\n  /**\n   * Get participant by SID from conversation\n   * @returns {Promise<Participant>}\n   */\n  async getParticipantBySid(participantSid: string): Promise<Participant> {\n    return this.rosterEntityPromise.then(() => {\n      let participant = this.participants.get(participantSid);\n      if (!participant) {\n        throw new Error('Participant with SID ' + participantSid + ' was not found');\n      }\n      return participant;\n    });\n  }\n\n  /**\n   * Get participant by identity from conversation\n   * @returns {Promise<Participant>}\n   */\n  async getParticipantByIdentity(identity: string): Promise<Participant> {\n    let foundParticipant = null;\n    return this.rosterEntityPromise.then(() => {\n      this.participants.forEach(participant => {\n        if (participant.identity === identity) {\n          foundParticipant = participant;\n        }\n      });\n      if (!foundParticipant) {\n        throw new Error('Participant with identity ' + identity + ' was not found');\n      }\n      return foundParticipant;\n    });\n  }\n\n  /**\n   * Add a chat participant to the conversation\n   * @returns {Promise<any>}\n   */\n  async add(identity: string, attributes: any): Promise<any> {\n    return await this.services.commandExecutor.mutateResource<AddParticipantRequest, ParticipantResponse>(\n      'post',\n      this.links.participants,\n      {\n        identity,\n        attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined\n      }\n    );\n  }\n\n  /**\n   * Add a non-chat participant to the conversation.\n   *\n   * @param proxyAddress\n   * @param address\n   * @param attributes\n   * @param bindingOptions\n   * @returns {Promise<any>}\n   */\n  addNonChatParticipant(proxyAddress: string, address: string, attributes: Record<string, any> = {},\n                        bindingOptions: ParticipantBindingOptions = {}): Promise<any> {\n    return this.services.commandExecutor.mutateResource<AddParticipantRequest, ParticipantResponse>(\n      'post',\n      this.links.participants,\n      {\n        attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined,\n        messaging_binding: {\n          address,\n          proxy_address: proxyAddress,\n          name: bindingOptions?.email?.name,\n          level: bindingOptions?.email?.level,\n        }\n      }\n    );\n  }\n\n  /**\n   * Remove the participant with a given identity from a conversation.\n   */\n  remove(identity: string): Promise<any> {\n    return this.services.commandExecutor.mutateResource(\n      'delete',\n      `${this.links.participants}/${identity}`,\n    );\n  }\n}\n\nexport { Participants };\n\n/**\n * Fired when participant joined conversation\n * @event Participants#participantJoined\n * @type {Participant}\n */\n\n/**\n * Fired when participant left conversation\n * @event Participants#participantLeft\n * @type {Participant}\n */\n\n/**\n * Fired when participant updated\n * @event Participants#participantUpdated\n * @type {Object}\n * @property {Participant} participant - Updated Participant\n * @property {Participant#UpdateReason[]} updateReasons - Array of Participant's updated event reasons\n */\n"],"names":["Logger","ReplayEventEmitter","participant","Participant"],"mappings":"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"}

package/dist/index.js

@@ -130,6 +130,7 @@ This software includes platform.js under the following license.
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+require('isomorphic-form-data');
 var client = require('./client.js');
 var conversation = require('./conversation.js');
 var participant = require('./participant.js');

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/interfaces/attributes.js

@@ -0,0 +1,147 @@
+/*
+@license
+The following license applies to all parts of this software except as
+documented below.
+
+    Copyright (c) 2019, Twilio, inc.
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are
+    met:
+
+      1. Redistributions of source code must retain the above copyright
+         notice, this list of conditions and the following disclaimer.
+
+      2. Redistributions in binary form must reproduce the above copyright
+         notice, this list of conditions and the following disclaimer in
+         the documentation and/or other materials provided with the
+         distribution.
+
+      3. Neither the name of Twilio nor the names of its contributors may
+         be used to endorse or promote products derived from this software
+         without specific prior written permission.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+    HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+This software includes javascript-state-machine under the following license.
+
+    Copyright (c) 2012, 2013, 2014, 2015, Jake Gordon and contributors
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+
+This software includes loglevel under the following license.
+
+    Copyright (c) 2013 Tim Perry
+
+    Permission is hereby granted, free of charge, to any person
+    obtaining a copy of this software and associated documentation
+    files (the "Software"), to deal in the Software without
+    restriction, including without limitation the rights to use,
+    copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following
+    conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+    OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+    HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+    WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+    OTHER DEALINGS IN THE SOFTWARE.
+
+This software includes q under the following license.
+
+    Copyright 2009–2014 Kristopher Michael Kowal. All rights reserved.
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to
+    deal in the Software without restriction, including without limitation the
+    rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+    sell copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+    IN THE SOFTWARE.
+
+This software includes platform.js under the following license.
+
+    Copyright 2014 Benjamin Tan <https://d10.github.io/>
+    Copyright 2011-2015 John-David Dalton <http://allyoucanleet.com/>
+
+    Permission is hereby granted, free of charge, to any person obtaining
+    a copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+    OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+*/
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var declarativeTypeValidator = require('@twilio/declarative-type-validator');
+
+// Any JSON value
+const attributesValidator = declarativeTypeValidator.custom((value) => [
+    ['string', 'number', 'boolean', 'object'].includes(typeof value),
+    'a JSON type'
+]);
+const optionalAttributesValidator = declarativeTypeValidator.custom((value) => [
+    ['undefined', 'string', 'number', 'boolean', 'object'].includes(typeof value),
+    'an optional JSON type'
+]);
+
+exports.attributesValidator = attributesValidator;
+exports.optionalAttributesValidator = optionalAttributesValidator;
+//# sourceMappingURL=attributes.js.map

package/dist/interfaces/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sources":["../../src/interfaces/attributes.ts"],"sourcesContent":["import { custom } from '@twilio/declarative-type-validator';\n\n// Any JSON value\nexport const attributesValidator = custom((value) => [\n    ['string', 'number', 'boolean', 'object'].includes(typeof value),\n    'a JSON type'\n]);\n\nexport const optionalAttributesValidator = custom((value) => [\n    ['undefined', 'string', 'number', 'boolean', 'object'].includes(typeof value),\n    'an optional JSON type'\n]);\n"],"names":["custom"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;MACa,mBAAmB,GAAGA,+BAAM,CAAC,CAAC,KAAK,KAAK;IACjD,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC;IAChE,aAAa;CAChB,EAAE;MAEU,2BAA2B,GAAGA,+BAAM,CAAC,CAAC,KAAK,KAAK;IACzD,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC;IAC7E,uBAAuB;CAC1B;;;;;"}

package/dist/message-builder.js

@@ -154,6 +154,8 @@ class MessageBuilder {
     constructor(limits, messagesEntity) {
         this.limits = limits;
         this.message = new unsentMessage.UnsentMessage(messagesEntity);
+        this.emailBodies = new Map();
+        this.emailHistories = new Map();
     }
     /**
      * Sets the message body.
@@ -179,11 +181,38 @@ class MessageBuilder {
         this.message.attributes = attributes;
         return this;
     }
+    /**
+     * Set email body with given MIME-type.
+     * @param mimeType Format of the body to set (text/plain or text/html).
+     * @param body Body payload in selected format.
+     */
+    setEmailBody(mimeType, body) {
+        this.emailBodies.set(mimeType, body);
+        return this;
+    }
+    /**
+     * Set email history with given MIME-type.
+     * @param mimeType Format of the history to set (text/plain or text/html).
+     * @param history History payload in selected format.
+     */
+    setEmailHistory(mimeType, history) {
+        this.emailHistories.set(mimeType, history);
+        return this;
+    }
     /**
      * Adds media to the message.
      * @param payload Media to add.
      */
     addMedia(payload) {
+        if (typeof FormData === 'undefined' && (payload instanceof FormData)) {
+            throw new Error('Could not add FormData content whilst not in a browser');
+        }
+        if (!(payload instanceof FormData)) {
+            const mediaOptions = payload;
+            if (!mediaOptions.contentType || !mediaOptions.media) {
+                throw new Error('Media content in SendMediaOptions must contain non-empty contentType and media');
+            }
+        }
         this.message.mediaContent.push(['media', payload]);
         return this;
     }
@@ -191,10 +220,33 @@ class MessageBuilder {
      * Builds the message, making it ready to be sent.
      */
     build() {
+        this.emailBodies.forEach((_, key) => {
+            if (!this.limits.emailBodiesAllowedMimeTypes.includes(key)) {
+                throw new Error(`Unsupported email body MIME type ${key}`);
+            }
+        });
+        this.emailHistories.forEach((_, key) => {
+            if (!this.limits.emailHistoriesAllowedMimeTypes.includes(key)) {
+                throw new Error(`Unsupported email history MIME type ${key}`);
+            }
+        });
+        if (this.emailBodies.size > this.limits.emailBodiesAllowedMimeTypes.length) {
+            throw new Error(`Too many email bodies attached to the message (${this.emailBodies.size} > ${this.limits.emailBodiesAllowedMimeTypes.length})`);
+        }
+        if (this.emailHistories.size > this.limits.emailHistoriesAllowedMimeTypes.length) {
+            throw new Error(`Too many email histories attached to the message (${this.emailHistories.size} > ${this.limits.emailHistoriesAllowedMimeTypes.length})`);
+        }
         if (this.message.mediaContent.length > this.limits.mediaAttachmentsCountLimit) {
             throw new Error(`Too many media attachments in the message (${this.message.mediaContent.length} > ${this.limits.mediaAttachmentsCountLimit})`);
         }
         // @todo we don't know the sizes of the attachments in FormData
+        // @todo insertion below makes build() method non-repeatable - probably move to UnsentMessage.send() or even sendV2()?
+        this.emailBodies.forEach((body) => {
+            this.message.mediaContent.push(['body', body]);
+        });
+        this.emailHistories.forEach((history) => {
+            this.message.mediaContent.push(['history', history]);
+        });
         return this.message;
     }
     getPayloadContentType(payload) {

package/dist/message-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-builder.js","sources":["../src/message-builder.ts"],"sourcesContent":["import { Limits } from './interfaces/limits';\nimport { SendMediaOptions } from './conversation';\nimport { UnsentMessage } from './unsent-message';\n\n/**\n * Message builder. Allows the message to be built and sent via method chaining.\n *\n * Example:\n *\n * ```ts\n * await testConversation.prepareMessage()\n *   .setBody('Hello!')\n *   .setAttributes({foo: 'bar'})\n *   .addMedia(media1)\n *   .addMedia(media2)\n *   .build()\n *   .send();\n * ```\n */\nclass MessageBuilder {\n  private readonly message: UnsentMessage;\n\n  /**\n   * @internal\n   */\n  constructor(private readonly limits: Limits, messagesEntity: any) {\n    this.message = new UnsentMessage(messagesEntity);\n  }\n\n  /**\n   * Sets the message body.\n   * @param text Contents of the body.\n   */\n  setBody(text: string): MessageBuilder {\n    this.message.text = text;\n    return this;\n  }\n\n  /**\n   * Sets the message subject.\n   * @param subject Contents of the subject.\n   */\n  setSubject(subject: string): MessageBuilder {\n    this.message.emailOptions.subject = subject;\n    return this;\n  }\n\n  /**\n   * Sets the message attributes.\n   * @param attributes Message attributes.\n   */\n  setAttributes(attributes: any): MessageBuilder {\n    this.message.attributes = attributes;\n    return this;\n  }\n\n  /**\n   * Adds media to the message.\n   * @param payload Media to add.\n   */\n  addMedia(payload: FormData | SendMediaOptions): MessageBuilder {\n    this.message.mediaContent.push(['media', payload]);\n    return this;\n  }\n\n  /**\n   * Builds the message, making it ready to be sent.\n   */\n  build(): UnsentMessage {\n    if (this.message.mediaContent.length > this.limits.mediaAttachmentsCountLimit) {\n      throw new Error(`Too many media attachments in the message (${this.message.mediaContent.length} > ${this.limits.mediaAttachmentsCountLimit})`);\n    }\n\n    // @todo we don't know the sizes of the attachments in FormData\n\n    return this.message;\n  }\n\n  private getPayloadContentType(payload: FormData | SendMediaOptions): string {\n    if (typeof FormData !== 'undefined' && (payload instanceof FormData)) {\n      return payload.get('Content-Type') as string;\n    }\n    return (payload as SendMediaOptions).contentType;\n  }\n}\n\nexport { MessageBuilder };\n"],"names":["UnsentMessage"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA;;;;;;;;;;;;;;;AAeA,MAAM,cAAc;;;;IAMlB,YAA6B,MAAc,EAAE,cAAmB;QAAnC,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,OAAO,GAAG,IAAIA,2BAAa,CAAC,cAAc,CAAC,CAAC;KAClD;;;;;IAMD,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;KACb;;;;;IAMD,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5C,OAAO,IAAI,CAAC;KACb;;;;;IAMD,aAAa,CAAC,UAAe;QAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,OAAO,IAAI,CAAC;KACb;;;;;IAMD,QAAQ,CAAC,OAAoC;QAC3C,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;KACb;;;;IAKD,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE;YAC7E,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,0BAA0B,GAAG,CAAC,CAAC;SAChJ;;QAID,OAAO,IAAI,CAAC,OAAO,CAAC;KACrB;IAEO,qBAAqB,CAAC,OAAoC;QAChE,IAAI,OAAO,QAAQ,KAAK,WAAW,KAAK,OAAO,YAAY,QAAQ,CAAC,EAAE;YACpE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAW,CAAC;SAC9C;QACD,OAAQ,OAA4B,CAAC,WAAW,CAAC;KAClD;;;;;"}
+{"version":3,"file":"message-builder.js","sources":["../src/message-builder.ts"],"sourcesContent":["import { Limits } from './interfaces/limits';\nimport { Conversation, SendMediaOptions } from './conversation';\nimport { UnsentMessage } from './unsent-message';\n\n/**\n * Message builder. Allows the message to be built and sent via method chaining.\n *\n * Example:\n *\n * ```ts\n * await testConversation.prepareMessage()\n *   .setBody('Hello!')\n *   .setAttributes({foo: 'bar'})\n *   .addMedia(media1)\n *   .addMedia(media2)\n *   .build()\n *   .send();\n * ```\n */\nclass MessageBuilder {\n  private readonly message: UnsentMessage;\n  private emailBodies: Map<string, FormData | SendMediaOptions>;\n  private emailHistories: Map<string, FormData | SendMediaOptions>;\n\n  /**\n   * @internal\n   */\n  constructor(private readonly limits: Limits, messagesEntity: any) {\n    this.message = new UnsentMessage(messagesEntity);\n    this.emailBodies = new Map<string, FormData | SendMediaOptions>();\n    this.emailHistories = new Map<string, FormData | SendMediaOptions>();\n  }\n\n  /**\n   * Sets the message body.\n   * @param text Contents of the body.\n   */\n  setBody(text: string): MessageBuilder {\n    this.message.text = text;\n    return this;\n  }\n\n  /**\n   * Sets the message subject.\n   * @param subject Contents of the subject.\n   */\n  setSubject(subject: string): MessageBuilder {\n    this.message.emailOptions.subject = subject;\n    return this;\n  }\n\n  /**\n   * Sets the message attributes.\n   * @param attributes Message attributes.\n   */\n  setAttributes(attributes: any): MessageBuilder {\n    this.message.attributes = attributes;\n    return this;\n  }\n\n  /**\n   * Set email body with given MIME-type.\n   * @param mimeType Format of the body to set (text/plain or text/html).\n   * @param body Body payload in selected format.\n   */\n  setEmailBody(mimeType: string, body: FormData | SendMediaOptions): MessageBuilder {\n    this.emailBodies.set(mimeType, body);\n    return this;\n  }\n\n  /**\n   * Set email history with given MIME-type.\n   * @param mimeType Format of the history to set (text/plain or text/html).\n   * @param history History payload in selected format.\n   */\n  setEmailHistory(mimeType: string, history: FormData | SendMediaOptions): MessageBuilder {\n    this.emailHistories.set(mimeType, history);\n    return this;\n  }\n\n  /**\n   * Adds media to the message.\n   * @param payload Media to add.\n   */\n  addMedia(payload: FormData | SendMediaOptions): MessageBuilder {\n    if (typeof FormData === 'undefined' && (payload instanceof FormData)) {\n      throw new Error('Could not add FormData content whilst not in a browser');\n    }\n    if (!(payload instanceof FormData)) {\n      const mediaOptions = payload as SendMediaOptions;\n      if (!mediaOptions.contentType || !mediaOptions.media) {\n        throw new Error('Media content in SendMediaOptions must contain non-empty contentType and media');\n      }\n    }\n    this.message.mediaContent.push(['media', payload]);\n    return this;\n  }\n\n  /**\n   * Builds the message, making it ready to be sent.\n   */\n  build(): UnsentMessage {\n    this.emailBodies.forEach((_, key) => {\n      if (!this.limits.emailBodiesAllowedMimeTypes.includes(key)) {\n        throw new Error(`Unsupported email body MIME type ${key}`);\n      }\n    });\n    this.emailHistories.forEach((_, key) => {\n      if (!this.limits.emailHistoriesAllowedMimeTypes.includes(key)) {\n        throw new Error(`Unsupported email history MIME type ${key}`);\n      }\n    });\n    if (this.emailBodies.size > this.limits.emailBodiesAllowedMimeTypes.length) {\n      throw new Error(`Too many email bodies attached to the message (${this.emailBodies.size} > ${this.limits.emailBodiesAllowedMimeTypes.length})`);\n    }\n    if (this.emailHistories.size > this.limits.emailHistoriesAllowedMimeTypes.length) {\n      throw new Error(`Too many email histories attached to the message (${this.emailHistories.size} > ${this.limits.emailHistoriesAllowedMimeTypes.length})`);\n    }\n\n    if (this.message.mediaContent.length > this.limits.mediaAttachmentsCountLimit) {\n      throw new Error(`Too many media attachments in the message (${this.message.mediaContent.length} > ${this.limits.mediaAttachmentsCountLimit})`);\n    }\n\n    // @todo we don't know the sizes of the attachments in FormData\n    // @todo insertion below makes build() method non-repeatable - probably move to UnsentMessage.send() or even sendV2()?\n\n    this.emailBodies.forEach((body) => {\n      this.message.mediaContent.push(['body', body]);\n    });\n\n    this.emailHistories.forEach((history) => {\n      this.message.mediaContent.push(['history', history]);\n    });\n\n    return this.message;\n  }\n\n  private getPayloadContentType(payload: FormData | SendMediaOptions): string {\n    if (typeof FormData !== 'undefined' && (payload instanceof FormData)) {\n      return payload.get('Content-Type') as string;\n    }\n    return (payload as SendMediaOptions).contentType;\n  }\n}\n\nexport { MessageBuilder };\n"],"names":["UnsentMessage"],"mappings":"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"}

package/dist/message.js

@@ -136,6 +136,7 @@ var logger = require('./logger.js');
 var media = require('./media.js');
 var aggregatedDeliveryReceipt = require('./aggregated-delivery-receipt.js');
 var declarativeTypeValidator = require('@twilio/declarative-type-validator');
+var attributes = require('./interfaces/attributes.js');
 var restPaginator = require('./rest-paginator.js');
 var detailedDeliveryReceipt = require('./detailed-delivery-receipt.js');
 var replayEventEmitter = require('@twilio/replay-event-emitter');
@@ -224,11 +225,11 @@ class Message extends replayEventEmitter.ReplayEventEmitter {
      */
     get attributes() { return this.state.attributes; }
     /**
-     * Push notification type of the message.
+     * Type of the message.
      */
     get type() { return this.state.type; }
     /**
-     * One of the attached media.
+     * One of the attached media (if present).
      * @deprecated Use attachedMedia instead. Note that the latter is now an array.
      */
     get media() { return this.state.media; }
@@ -256,6 +257,24 @@ class Message extends replayEventEmitter.ReplayEventEmitter {
         var _a;
         return (_a = this.state.medias) === null || _a === void 0 ? void 0 : _a.filter((m) => categories.includes(m.category));
     }
+    /**
+     * Get a media descriptor for an email body attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailBodiesAllowedMimeTypes array.
+     * @param type Type of email body to request, defaults to `text/plain`.
+     */
+    getEmailBody(type = 'text/plain') {
+        var _a, _b;
+        return (_b = (_a = this.getMediaByCategory(['body'])) === null || _a === void 0 ? void 0 : _a.filter((m) => m.contentType == type).shift()) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * Get a media descriptor for an email history attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailHistoriesAllowedMimeTypes array.
+     * @param type Type of email history to request, defaults to `text/plain`.
+     */
+    getEmailHistory(type = 'text/plain') {
+        var _a, _b;
+        return (_b = (_a = this.getMediaByCategory(['history'])) === null || _a === void 0 ? void 0 : _a.filter((m) => m.contentType == type).shift()) !== null && _b !== void 0 ? _b : null;
+    }
     _update(data) {
         let updateReasons = [];
         if ((data.text || ((typeof data.text) === 'string')) && data.text !== this.state.body) {
@@ -424,6 +443,18 @@ class Message extends replayEventEmitter.ReplayEventEmitter {
  *     * {@link MessageUpdateReason}[] updateReasons - array of reasons for the update
  */
 Message.updated = 'updated';
+tslib_es6.__decorate([
+    declarativeTypeValidator.validateTypes(declarativeTypeValidator.nonEmptyString),
+    tslib_es6.__metadata("design:type", Function),
+    tslib_es6.__metadata("design:paramtypes", [String]),
+    tslib_es6.__metadata("design:returntype", media.Media)
+], Message.prototype, "getEmailBody", null);
+tslib_es6.__decorate([
+    declarativeTypeValidator.validateTypes(declarativeTypeValidator.nonEmptyString),
+    tslib_es6.__metadata("design:type", Function),
+    tslib_es6.__metadata("design:paramtypes", [String]),
+    tslib_es6.__metadata("design:returntype", media.Media)
+], Message.prototype, "getEmailHistory", null);
 tslib_es6.__decorate([
     declarativeTypeValidator.validateTypesAsync('string'),
     tslib_es6.__metadata("design:type", Function),
@@ -431,14 +462,14 @@ tslib_es6.__decorate([
     tslib_es6.__metadata("design:returntype", Promise)
 ], Message.prototype, "updateBody", null);
 tslib_es6.__decorate([
-    declarativeTypeValidator.validateTypesAsync(['string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]),
+    declarativeTypeValidator.validateTypesAsync(attributes.attributesValidator),
     tslib_es6.__metadata("design:type", Function),
     tslib_es6.__metadata("design:paramtypes", [Object]),
     tslib_es6.__metadata("design:returntype", Promise)
 ], Message.prototype, "updateAttributes", null);
 tslib_es6.__decorate([
     declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.custom(value => [
-        value instanceof Array && value.length > 0 && value.reduce((a, c) => a && c instanceof media.Media),
+        value instanceof Array && value.length > 0 && value.reduce((a, c) => a && c instanceof media.Media, true),
         'a non-empty array of Media'
     ])),
     tslib_es6.__metadata("design:type", Function),