@aws-sdk/client-connectparticipant 3.863.0 → 3.870.0

package/dist-cjs/index.js

@@ -23,6 +23,7 @@ var index_exports = {};
 __export(index_exports, {
   AccessDeniedException: () => AccessDeniedException,
   ArtifactStatus: () => ArtifactStatus,
+  AttendeeFilterSensitiveLog: () => AttendeeFilterSensitiveLog,
   CancelParticipantAuthenticationCommand: () => CancelParticipantAuthenticationCommand,
   ChatItemType: () => ChatItemType,
   CompleteAttachmentUploadCommand: () => CompleteAttachmentUploadCommand,
@@ -30,8 +31,10 @@ __export(index_exports, {
   ConnectParticipant: () => ConnectParticipant,
   ConnectParticipantClient: () => ConnectParticipantClient,
   ConnectParticipantServiceException: () => ConnectParticipantServiceException,
+  ConnectionDataFilterSensitiveLog: () => ConnectionDataFilterSensitiveLog,
   ConnectionType: () => ConnectionType,
   CreateParticipantConnectionCommand: () => CreateParticipantConnectionCommand,
+  CreateParticipantConnectionResponseFilterSensitiveLog: () => CreateParticipantConnectionResponseFilterSensitiveLog,
   DescribeViewCommand: () => DescribeViewCommand,
   DescribeViewResponseFilterSensitiveLog: () => DescribeViewResponseFilterSensitiveLog,
   DisconnectParticipantCommand: () => DisconnectParticipantCommand,
@@ -39,6 +42,7 @@ __export(index_exports, {
   GetAuthenticationUrlCommand: () => GetAuthenticationUrlCommand,
   GetTranscriptCommand: () => GetTranscriptCommand,
   InternalServerException: () => InternalServerException,
+  MeetingFeatureStatus: () => MeetingFeatureStatus,
   ParticipantRole: () => ParticipantRole,
   ResourceNotFoundException: () => ResourceNotFoundException,
   ResourceType: () => ResourceType,
@@ -352,8 +356,13 @@ var ServiceQuotaExceededException = class _ServiceQuotaExceededException extends
 };
 var ConnectionType = {
   CONNECTION_CREDENTIALS: "CONNECTION_CREDENTIALS",
+  WEBRTC_CONNECTION: "WEBRTC_CONNECTION",
   WEBSOCKET: "WEBSOCKET"
 };
+var MeetingFeatureStatus = {
+  AVAILABLE: "AVAILABLE",
+  UNAVAILABLE: "UNAVAILABLE"
+};
 var ResourceType = {
   CONTACT: "CONTACT",
   CONTACT_FLOW: "CONTACT_FLOW",
@@ -430,6 +439,18 @@ var ChatItemType = {
   TRANSFER_SUCCEEDED: "TRANSFER_SUCCEEDED",
   TYPING: "TYPING"
 };
+var AttendeeFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.JoinToken && { JoinToken: import_smithy_client.SENSITIVE_STRING }
+}), "AttendeeFilterSensitiveLog");
+var ConnectionDataFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.Attendee && { Attendee: AttendeeFilterSensitiveLog(obj.Attendee) }
+}), "ConnectionDataFilterSensitiveLog");
+var CreateParticipantConnectionResponseFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.WebRTCConnection && { WebRTCConnection: ConnectionDataFilterSensitiveLog(obj.WebRTCConnection) }
+}), "CreateParticipantConnectionResponseFilterSensitiveLog");
 var ViewContentFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
   ...obj,
   ...obj.InputSchema && { InputSchema: import_smithy_client.SENSITIVE_STRING },
@@ -664,6 +685,7 @@ var de_CreateParticipantConnectionCommand = /* @__PURE__ */ __name(async (output
   const data = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.expectObject)(await (0, import_core2.parseJsonBody)(output.body, context)), "body");
   const doc = (0, import_smithy_client.take)(data, {
     ConnectionCredentials: import_smithy_client._json,
+    WebRTCConnection: import_smithy_client._json,
     Websocket: import_smithy_client._json
   });
   Object.assign(contents, doc);
@@ -961,7 +983,7 @@ var CreateParticipantConnectionCommand = class extends import_smithy_client.Comm
     (0, import_middleware_serde.getSerdePlugin)(config, this.serialize, this.deserialize),
     (0, import_middleware_endpoint.getEndpointPlugin)(config, Command.getEndpointParameterInstructions())
   ];
-}).s("AmazonConnectParticipantServiceLambda", "CreateParticipantConnection", {}).n("ConnectParticipantClient", "CreateParticipantConnectionCommand").f(void 0, void 0).ser(se_CreateParticipantConnectionCommand).de(de_CreateParticipantConnectionCommand).build() {
+}).s("AmazonConnectParticipantServiceLambda", "CreateParticipantConnection", {}).n("ConnectParticipantClient", "CreateParticipantConnectionCommand").f(void 0, CreateParticipantConnectionResponseFilterSensitiveLog).ser(se_CreateParticipantConnectionCommand).de(de_CreateParticipantConnectionCommand).build() {
   static {
     __name(this, "CreateParticipantConnectionCommand");
   }
@@ -1138,6 +1160,7 @@ var paginateGetTranscript = (0, import_core.createPaginator)(ConnectParticipantC
   ConflictException,
   ServiceQuotaExceededException,
   ConnectionType,
+  MeetingFeatureStatus,
   ResourceType,
   ResourceNotFoundException,
   ScanDirection,
@@ -1145,6 +1168,9 @@ var paginateGetTranscript = (0, import_core.createPaginator)(ConnectParticipantC
   ArtifactStatus,
   ParticipantRole,
   ChatItemType,
+  AttendeeFilterSensitiveLog,
+  ConnectionDataFilterSensitiveLog,
+  CreateParticipantConnectionResponseFilterSensitiveLog,
   ViewContentFilterSensitiveLog,
   ViewFilterSensitiveLog,
   DescribeViewResponseFilterSensitiveLog

package/dist-es/commands/CreateParticipantConnectionCommand.js

@@ -2,6 +2,7 @@ import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
 import { commonParams } from "../endpoint/EndpointParameters";
+import { CreateParticipantConnectionResponseFilterSensitiveLog, } from "../models/models_0";
 import { de_CreateParticipantConnectionCommand, se_CreateParticipantConnectionCommand, } from "../protocols/Aws_restJson1";
 export { $Command };
 export class CreateParticipantConnectionCommand extends $Command
@@ -15,7 +16,7 @@ export class CreateParticipantConnectionCommand extends $Command
 })
     .s("AmazonConnectParticipantServiceLambda", "CreateParticipantConnection", {})
     .n("ConnectParticipantClient", "CreateParticipantConnectionCommand")
-    .f(void 0, void 0)
+    .f(void 0, CreateParticipantConnectionResponseFilterSensitiveLog)
     .ser(se_CreateParticipantConnectionCommand)
     .de(de_CreateParticipantConnectionCommand)
     .build() {

package/dist-es/models/models_0.js

@@ -86,8 +86,13 @@ export class ServiceQuotaExceededException extends __BaseException {
 }
 export const ConnectionType = {
     CONNECTION_CREDENTIALS: "CONNECTION_CREDENTIALS",
+    WEBRTC_CONNECTION: "WEBRTC_CONNECTION",
     WEBSOCKET: "WEBSOCKET",
 };
+export const MeetingFeatureStatus = {
+    AVAILABLE: "AVAILABLE",
+    UNAVAILABLE: "UNAVAILABLE",
+};
 export const ResourceType = {
     CONTACT: "CONTACT",
     CONTACT_FLOW: "CONTACT_FLOW",
@@ -150,6 +155,18 @@ export const ChatItemType = {
     TRANSFER_SUCCEEDED: "TRANSFER_SUCCEEDED",
     TYPING: "TYPING",
 };
+export const AttendeeFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.JoinToken && { JoinToken: SENSITIVE_STRING }),
+});
+export const ConnectionDataFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.Attendee && { Attendee: AttendeeFilterSensitiveLog(obj.Attendee) }),
+});
+export const CreateParticipantConnectionResponseFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.WebRTCConnection && { WebRTCConnection: ConnectionDataFilterSensitiveLog(obj.WebRTCConnection) }),
+});
 export const ViewContentFilterSensitiveLog = (obj) => ({
     ...obj,
     ...(obj.InputSchema && { InputSchema: SENSITIVE_STRING }),

package/dist-es/protocols/Aws_restJson1.js

@@ -201,6 +201,7 @@ export const de_CreateParticipantConnectionCommand = async (output, context) =>
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     const doc = take(data, {
         ConnectionCredentials: _json,
+        WebRTCConnection: _json,
         Websocket: _json,
     });
     Object.assign(contents, doc);

package/dist-types/commands/CancelParticipantAuthenticationCommand.d.ts

@@ -33,6 +33,13 @@ declare const CancelParticipantAuthenticationCommand_base: {
  *             <p>The current supported channel is chat. This API is not supported for Apple
  *                 Messages for Business, WhatsApp, or SMS chats.</p>
  *          </note>
+ *          <note>
+ *             <p>
+ *                <code>ConnectionToken</code> is used for invoking this API instead of
+ *                     <code>ParticipantToken</code>.</p>
+ *          </note>
+ *          <p>The Amazon Connect Participant Service APIs do not use <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature Version 4
+ *                     authentication</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CompleteAttachmentUploadCommand.d.ts

@@ -30,7 +30,7 @@ declare const CompleteAttachmentUploadCommand_base: {
  * <p>Allows you to confirm that the attachment has been uploaded using the pre-signed URL
  *             provided in StartAttachmentUpload API. A conflict exception is thrown when an attachment
  *             with that identifier is already being uploaded.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ConnectionToken</code> is used for invoking this API instead of

package/dist-types/commands/CreateParticipantConnectionCommand.d.ts

@@ -28,17 +28,20 @@ declare const CreateParticipantConnectionCommand_base: {
 };
 /**
  * <p>Creates the participant's connection. </p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
+ *          <p>For WebRTC security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-webrtc-security">Amazon Connect WebRTC security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ParticipantToken</code> is used for invoking this API instead of
  *                     <code>ConnectionToken</code>.</p>
  *          </note>
  *          <p>The participant token is valid for the lifetime of the participant – until they are
- *             part of a contact.</p>
- *          <p>The response URL for <code>WEBSOCKET</code> Type has a connect expiry timeout of 100s.
- *             Clients must manually connect to the returned websocket URL and subscribe to the desired
- *             topic. </p>
+ *             part of a contact. For WebRTC participants, if they leave or are disconnected for 60
+ *             seconds, a new participant needs to be created using the <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html">CreateParticipant</a> API. </p>
+ *          <p>
+ *             <b>For <code>WEBSOCKET</code> Type</b>: </p>
+ *          <p>The response URL for has a connect expiry timeout of 100s. Clients must manually
+ *             connect to the returned websocket URL and subscribe to the desired topic. </p>
  *          <p>For chat, you need to publish the following on the established websocket
  *             connection:</p>
  *          <p>
@@ -47,6 +50,18 @@ declare const CreateParticipantConnectionCommand_base: {
  *          <p>Upon websocket URL expiry, as specified in the response ConnectionExpiry parameter,
  *             clients need to call this API again to obtain a new websocket URL and perform the same
  *             steps as before.</p>
+ *          <p>The expiry time for the connection token is different than the
+ *                 <code>ChatDurationInMinutes</code>. Expiry time for the connection token is 1
+ *             day.</p>
+ *          <p>
+ *             <b>For <code>WEBRTC_CONNECTION</code> Type</b>: </p>
+ *          <p>The response includes connection data required for the client application to join the
+ *             call using the Amazon Chime SDK client libraries. The WebRTCConnection response contains
+ *             Meeting and Attendee information needed to establish the media connection. </p>
+ *          <p>The attendee join token in WebRTCConnection response is valid for the lifetime of the
+ *             participant in the call. If a participant leaves or is disconnected for 60 seconds,
+ *             their participant credentials will no longer be valid, and a new participant will need
+ *             to be created to rejoin the call. </p>
  *          <p>
  *             <b>Message streaming support</b>: This API can also be used
  *             together with the <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html">StartContactStreaming</a> API to create a participant connection for chat
@@ -55,9 +70,16 @@ declare const CreateParticipantConnectionCommand_base: {
  *                 message streaming</a> in the <i>Amazon Connect Administrator
  *             Guide</i>.</p>
  *          <p>
+ *             <b>Multi-user web, in-app, video calling support</b>: </p>
+ *          <p>For WebRTC calls, this API is used in conjunction with the CreateParticipant API to
+ *             enable multi-party calling. The StartWebRTCContact API creates the initial contact and
+ *             routes it to an agent, while CreateParticipant adds additional participants to the
+ *             ongoing call. For more information about multi-party WebRTC calls, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/enable-multiuser-inapp.html">Enable multi-user web, in-app, and video calling</a> in the <i>Amazon Connect
+ *                 Administrator Guide</i>. </p>
+ *          <p>
  *             <b>Feature specifications</b>: For information about feature
- *             specifications, such as the allowed number of open websocket connections per
- *             participant, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#feature-limits">Feature specifications</a> in the <i>Amazon Connect Administrator
+ *             specifications, such as the allowed number of open websocket connections per participant
+ *             or maximum number of WebRTC participants, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#feature-limits">Feature specifications</a> in the <i>Amazon Connect Administrator
  *                 Guide</i>. </p>
  *          <note>
  *             <p>The Amazon Connect Participant Service APIs do not use <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature Version 4
@@ -71,7 +93,7 @@ declare const CreateParticipantConnectionCommand_base: {
  * const client = new ConnectParticipantClient(config);
  * const input = { // CreateParticipantConnectionRequest
  *   Type: [ // ConnectionTypeList
- *     "WEBSOCKET" || "CONNECTION_CREDENTIALS",
+ *     "WEBSOCKET" || "CONNECTION_CREDENTIALS" || "WEBRTC_CONNECTION",
  *   ],
  *   ParticipantToken: "STRING_VALUE", // required
  *   ConnectParticipant: true || false,
@@ -87,6 +109,28 @@ declare const CreateParticipantConnectionCommand_base: {
  * //     ConnectionToken: "STRING_VALUE",
  * //     Expiry: "STRING_VALUE",
  * //   },
+ * //   WebRTCConnection: { // ConnectionData
+ * //     Attendee: { // Attendee
+ * //       AttendeeId: "STRING_VALUE",
+ * //       JoinToken: "STRING_VALUE",
+ * //     },
+ * //     Meeting: { // Meeting
+ * //       MediaRegion: "STRING_VALUE",
+ * //       MediaPlacement: { // MediaPlacement
+ * //         AudioHostUrl: "STRING_VALUE",
+ * //         AudioFallbackUrl: "STRING_VALUE",
+ * //         SignalingUrl: "STRING_VALUE",
+ * //         TurnControlUrl: "STRING_VALUE",
+ * //         EventIngestionUrl: "STRING_VALUE",
+ * //       },
+ * //       MeetingFeatures: { // MeetingFeaturesConfiguration
+ * //         Audio: { // AudioFeatures
+ * //           EchoReduction: "AVAILABLE" || "UNAVAILABLE",
+ * //         },
+ * //       },
+ * //       MeetingId: "STRING_VALUE",
+ * //     },
+ * //   },
  * // };
  *
  * ```

package/dist-types/commands/DescribeViewCommand.d.ts

@@ -28,7 +28,7 @@ declare const DescribeViewCommand_base: {
 };
 /**
  * <p>Retrieves the view for the specified view token.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DisconnectParticipantCommand.d.ts

@@ -28,7 +28,7 @@ declare const DisconnectParticipantCommand_base: {
 };
 /**
  * <p>Disconnects a participant. </p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ConnectionToken</code> is used for invoking this API instead of

package/dist-types/commands/GetAttachmentCommand.d.ts

@@ -29,11 +29,21 @@ declare const GetAttachmentCommand_base: {
 /**
  * <p>Provides a pre-signed URL for download of a completed attachment. This is an
  *             asynchronous API for use with active contacts.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
- *             <p>
- *                <code>ConnectionToken</code> is used for invoking this API instead of
- *                     <code>ParticipantToken</code>.</p>
+ *             <ul>
+ *                <li>
+ *                   <p>The participant role <code>CUSTOM_BOT</code> is not permitted to access
+ *                         attachments customers may upload. An <code>AccessDeniedException</code> can
+ *                         indicate that the participant may be a CUSTOM_BOT, and it doesn't have
+ *                         access to attachments.</p>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <code>ConnectionToken</code> is used for invoking this API instead of
+ *                             <code>ParticipantToken</code>.</p>
+ *                </li>
+ *             </ul>
  *          </note>
  *          <p>The Amazon Connect Participant Service APIs do not use <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature Version 4
  *                     authentication</a>.</p>

package/dist-types/commands/GetAuthenticationUrlCommand.d.ts

@@ -42,6 +42,13 @@ declare const GetAuthenticationUrlCommand_base: {
  *                </li>
  *             </ul>
  *          </note>
+ *          <note>
+ *             <p>
+ *                <code>ConnectionToken</code> is used for invoking this API instead of
+ *                     <code>ParticipantToken</code>.</p>
+ *          </note>
+ *          <p>The Amazon Connect Participant Service APIs do not use <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature Version 4
+ *                     authentication</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTranscriptCommand.d.ts

@@ -30,14 +30,14 @@ declare const GetTranscriptCommand_base: {
  * <p>Retrieves a transcript of the session, including details about any attachments. For
  *             information about accessing past chat contact transcripts for a persistent chat, see
  *                 <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html">Enable persistent chat</a>. </p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <p>If you have a process that consumes events in the transcript of an chat that has
  *             ended, note that chat transcripts contain the following event content types if the event
  *             has occurred during the chat session:</p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <code>application/vnd.amazonaws.connect.event.participant.left</code>
+ *                   <code>application/vnd.amazonaws.connect.event.participant.invited</code>
  *                </p>
  *             </li>
  *             <li>
@@ -47,6 +47,11 @@ declare const GetTranscriptCommand_base: {
  *             </li>
  *             <li>
  *                <p>
+ *                   <code>application/vnd.amazonaws.connect.event.participant.left</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
  *                   <code>application/vnd.amazonaws.connect.event.chat.ended</code>
  *                </p>
  *             </li>

package/dist-types/commands/SendEventCommand.d.ts

@@ -29,14 +29,14 @@ declare const SendEventCommand_base: {
 /**
  * <note>
  *             <p>The <code>application/vnd.amazonaws.connect.event.connection.acknowledged</code>
- *                 ContentType will no longer be supported starting December 31, 2024. This event has
- *                 been migrated to the <a href="https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html">CreateParticipantConnection</a> API using the
+ *                 ContentType is no longer maintained since December 31, 2024. This event has been
+ *                 migrated to the <a href="https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html">CreateParticipantConnection</a> API using the
  *                     <code>ConnectParticipant</code> field.</p>
  *          </note>
  *          <p>Sends an event. Message receipts are not supported when there are more than two active
  *             participants in the chat. Using the SendEvent API for message receipts when a supervisor
  *             is barged-in will result in a conflict exception.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ConnectionToken</code> is used for invoking this API instead of

package/dist-types/commands/SendMessageCommand.d.ts

@@ -28,7 +28,7 @@ declare const SendMessageCommand_base: {
 };
 /**
  * <p>Sends a message.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ConnectionToken</code> is used for invoking this API instead of

package/dist-types/commands/StartAttachmentUploadCommand.d.ts

@@ -29,7 +29,7 @@ declare const StartAttachmentUploadCommand_base: {
 /**
  * <p>Provides a pre-signed Amazon S3 URL in response for uploading the file directly to
  *             S3.</p>
- *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>.</p>
+ *          <p>For security recommendations, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>. </p>
  *          <note>
  *             <p>
  *                <code>ConnectionToken</code> is used for invoking this API instead of

package/dist-types/models/models_0.d.ts

@@ -134,6 +134,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
  */
 export declare const ConnectionType: {
     readonly CONNECTION_CREDENTIALS: "CONNECTION_CREDENTIALS";
+    readonly WEBRTC_CONNECTION: "WEBRTC_CONNECTION";
     readonly WEBSOCKET: "WEBSOCKET";
 };
 /**
@@ -184,6 +185,129 @@ export interface ConnectionCredentials {
      */
     Expiry?: string | undefined;
 }
+/**
+ * <p>The attendee information, including attendee ID and join token.</p>
+ * @public
+ */
+export interface Attendee {
+    /**
+     * <p>The Amazon Chime SDK attendee ID.</p>
+     * @public
+     */
+    AttendeeId?: string | undefined;
+    /**
+     * <p>The join token used by the Amazon Chime SDK attendee.</p>
+     * @public
+     */
+    JoinToken?: string | undefined;
+}
+/**
+ * <p>A set of endpoints used by clients to connect to the media service group for an Amazon Chime SDK meeting.</p>
+ * @public
+ */
+export interface MediaPlacement {
+    /**
+     * <p>The audio host URL.</p>
+     * @public
+     */
+    AudioHostUrl?: string | undefined;
+    /**
+     * <p>The audio fallback URL.</p>
+     * @public
+     */
+    AudioFallbackUrl?: string | undefined;
+    /**
+     * <p>The signaling URL.</p>
+     * @public
+     */
+    SignalingUrl?: string | undefined;
+    /**
+     * <p>The turn control URL.</p>
+     * @public
+     */
+    TurnControlUrl?: string | undefined;
+    /**
+     * <p>The event ingestion URL to which you send client meeting events.</p>
+     * @public
+     */
+    EventIngestionUrl?: string | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const MeetingFeatureStatus: {
+    readonly AVAILABLE: "AVAILABLE";
+    readonly UNAVAILABLE: "UNAVAILABLE";
+};
+/**
+ * @public
+ */
+export type MeetingFeatureStatus = (typeof MeetingFeatureStatus)[keyof typeof MeetingFeatureStatus];
+/**
+ * <p>Has audio-specific configurations as the operating parameter for Echo Reduction.</p>
+ * @public
+ */
+export interface AudioFeatures {
+    /**
+     * <p>Makes echo reduction available to clients who connect to the meeting.</p>
+     * @public
+     */
+    EchoReduction?: MeetingFeatureStatus | undefined;
+}
+/**
+ * <p>The configuration settings of the features available to a meeting.</p>
+ * @public
+ */
+export interface MeetingFeaturesConfiguration {
+    /**
+     * <p>The configuration settings for the audio features available to a meeting.</p>
+     * @public
+     */
+    Audio?: AudioFeatures | undefined;
+}
+/**
+ * <p>A meeting created using the Amazon Chime SDK.</p>
+ * @public
+ */
+export interface Meeting {
+    /**
+     * <p>The Amazon Web Services Region in which you create the meeting.</p>
+     * @public
+     */
+    MediaRegion?: string | undefined;
+    /**
+     * <p>The media placement for the meeting.</p>
+     * @public
+     */
+    MediaPlacement?: MediaPlacement | undefined;
+    /**
+     * <p>The configuration settings of the features available to a meeting.</p>
+     * @public
+     */
+    MeetingFeatures?: MeetingFeaturesConfiguration | undefined;
+    /**
+     * <p>The Amazon Chime SDK meeting ID.</p>
+     * @public
+     */
+    MeetingId?: string | undefined;
+}
+/**
+ * <p>Information required to join the call.</p>
+ * @public
+ */
+export interface ConnectionData {
+    /**
+     * <p>The attendee information, including attendee ID and join token.</p>
+     * @public
+     */
+    Attendee?: Attendee | undefined;
+    /**
+     * <p>A meeting created using the Amazon Chime SDK.</p>
+     * @public
+     */
+    Meeting?: Meeting | undefined;
+}
 /**
  * <p>The websocket for the participant's connection.</p>
  * @public
@@ -217,6 +341,12 @@ export interface CreateParticipantConnectionResponse {
      * @public
      */
     ConnectionCredentials?: ConnectionCredentials | undefined;
+    /**
+     * <p>Creates the participant's WebRTC connection data required for the client application
+     *             (mobile application or website) to connect to the call. </p>
+     * @public
+     */
+    WebRTCConnection?: ConnectionData | undefined;
 }
 /**
  * @public
@@ -748,8 +878,8 @@ export interface SendEventRequest {
      *                <p>application/vnd.amazonaws.connect.event.typing</p>
      *             </li>
      *             <li>
-     *                <p>application/vnd.amazonaws.connect.event.connection.acknowledged (will be
-     *                     deprecated on December 31, 2024) </p>
+     *                <p>application/vnd.amazonaws.connect.event.connection.acknowledged (is no longer
+     *                     maintained since December 31, 2024) </p>
      *             </li>
      *             <li>
      *                <p>application/vnd.amazonaws.connect.event.message.delivered</p>
@@ -804,9 +934,15 @@ export interface SendEventResponse {
  */
 export interface SendMessageRequest {
     /**
-     * <p>The type of the content. Supported types are <code>text/plain</code>,
+     * <p>The type of the content. Possible types are <code>text/plain</code>,
      *                 <code>text/markdown</code>, <code>application/json</code>, and
-     *                 <code>application/vnd.amazonaws.connect.message.interactive.response</code>.</p>
+     *                 <code>application/vnd.amazonaws.connect.message.interactive.response</code>.
+     *             </p>
+     *          <p>Supported types on the contact are configured through
+     *                 <code>SupportedMessagingContentTypes</code> on <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html">StartChatContact</a>
+     *             and <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundChatContact.html">StartOutboundChatContact</a>.</p>
+     *          <p> For Apple Messages for Business, SMS, and WhatsApp Business Messaging contacts, only
+     *                 <code>text/plain</code> is supported.</p>
      * @public
      */
     ContentType: string | undefined;
@@ -931,6 +1067,18 @@ export interface StartAttachmentUploadResponse {
      */
     UploadMetadata?: UploadMetadata | undefined;
 }
+/**
+ * @internal
+ */
+export declare const AttendeeFilterSensitiveLog: (obj: Attendee) => any;
+/**
+ * @internal
+ */
+export declare const ConnectionDataFilterSensitiveLog: (obj: ConnectionData) => any;
+/**
+ * @internal
+ */
+export declare const CreateParticipantConnectionResponseFilterSensitiveLog: (obj: CreateParticipantConnectionResponse) => any;
 /**
  * @internal
  */

package/dist-types/ts3.4/models/models_0.d.ts

@@ -59,6 +59,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
 }
 export declare const ConnectionType: {
   readonly CONNECTION_CREDENTIALS: "CONNECTION_CREDENTIALS";
+  readonly WEBRTC_CONNECTION: "WEBRTC_CONNECTION";
   readonly WEBSOCKET: "WEBSOCKET";
 };
 export type ConnectionType =
@@ -72,6 +73,39 @@ export interface ConnectionCredentials {
   ConnectionToken?: string | undefined;
   Expiry?: string | undefined;
 }
+export interface Attendee {
+  AttendeeId?: string | undefined;
+  JoinToken?: string | undefined;
+}
+export interface MediaPlacement {
+  AudioHostUrl?: string | undefined;
+  AudioFallbackUrl?: string | undefined;
+  SignalingUrl?: string | undefined;
+  TurnControlUrl?: string | undefined;
+  EventIngestionUrl?: string | undefined;
+}
+export declare const MeetingFeatureStatus: {
+  readonly AVAILABLE: "AVAILABLE";
+  readonly UNAVAILABLE: "UNAVAILABLE";
+};
+export type MeetingFeatureStatus =
+  (typeof MeetingFeatureStatus)[keyof typeof MeetingFeatureStatus];
+export interface AudioFeatures {
+  EchoReduction?: MeetingFeatureStatus | undefined;
+}
+export interface MeetingFeaturesConfiguration {
+  Audio?: AudioFeatures | undefined;
+}
+export interface Meeting {
+  MediaRegion?: string | undefined;
+  MediaPlacement?: MediaPlacement | undefined;
+  MeetingFeatures?: MeetingFeaturesConfiguration | undefined;
+  MeetingId?: string | undefined;
+}
+export interface ConnectionData {
+  Attendee?: Attendee | undefined;
+  Meeting?: Meeting | undefined;
+}
 export interface Websocket {
   Url?: string | undefined;
   ConnectionExpiry?: string | undefined;
@@ -79,6 +113,7 @@ export interface Websocket {
 export interface CreateParticipantConnectionResponse {
   Websocket?: Websocket | undefined;
   ConnectionCredentials?: ConnectionCredentials | undefined;
+  WebRTCConnection?: ConnectionData | undefined;
 }
 export interface DescribeViewRequest {
   ViewToken: string | undefined;
@@ -268,6 +303,13 @@ export interface StartAttachmentUploadResponse {
   AttachmentId?: string | undefined;
   UploadMetadata?: UploadMetadata | undefined;
 }
+export declare const AttendeeFilterSensitiveLog: (obj: Attendee) => any;
+export declare const ConnectionDataFilterSensitiveLog: (
+  obj: ConnectionData
+) => any;
+export declare const CreateParticipantConnectionResponseFilterSensitiveLog: (
+  obj: CreateParticipantConnectionResponse
+) => any;
 export declare const ViewContentFilterSensitiveLog: (obj: ViewContent) => any;
 export declare const ViewFilterSensitiveLog: (obj: View) => any;
 export declare const DescribeViewResponseFilterSensitiveLog: (

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-connectparticipant",
   "description": "AWS SDK for JavaScript Connectparticipant Client for Node.js, Browser and React Native",
-  "version": "3.863.0",
+  "version": "3.870.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-connectparticipant",
@@ -20,17 +20,17 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.863.0",
-    "@aws-sdk/credential-provider-node": "3.863.0",
+    "@aws-sdk/core": "3.864.0",
+    "@aws-sdk/credential-provider-node": "3.864.0",
     "@aws-sdk/middleware-host-header": "3.862.0",
     "@aws-sdk/middleware-logger": "3.862.0",
     "@aws-sdk/middleware-recursion-detection": "3.862.0",
-    "@aws-sdk/middleware-user-agent": "3.863.0",
+    "@aws-sdk/middleware-user-agent": "3.864.0",
     "@aws-sdk/region-config-resolver": "3.862.0",
     "@aws-sdk/types": "3.862.0",
     "@aws-sdk/util-endpoints": "3.862.0",
     "@aws-sdk/util-user-agent-browser": "3.862.0",
-    "@aws-sdk/util-user-agent-node": "3.863.0",
+    "@aws-sdk/util-user-agent-node": "3.864.0",
     "@smithy/config-resolver": "^4.1.5",
     "@smithy/core": "^3.8.0",
     "@smithy/fetch-http-handler": "^5.1.1",