@aws-sdk/client-kinesis-video-webrtc-storage 3.623.0 → 3.624.0

package/README.md

@@ -6,6 +6,8 @@
 
 AWS SDK for JavaScript KinesisVideoWebRTCStorage Client for Node.js, Browser and React Native.
 
+<fullname>webrtc</fullname>
+
 <p>
 </p>
 
@@ -218,3 +220,11 @@ JoinStorageSession
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/kinesis-video-webrtc-storage/command/JoinStorageSessionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-kinesis-video-webrtc-storage/Interface/JoinStorageSessionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-kinesis-video-webrtc-storage/Interface/JoinStorageSessionCommandOutput/)
 
 </details>
+<details>
+<summary>
+JoinStorageSessionAsViewer
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/kinesis-video-webrtc-storage/command/JoinStorageSessionAsViewerCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-kinesis-video-webrtc-storage/Interface/JoinStorageSessionAsViewerCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-kinesis-video-webrtc-storage/Interface/JoinStorageSessionAsViewerCommandOutput/)
+
+</details>

package/dist-cjs/index.js

@@ -21,10 +21,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  $Command: () => import_smithy_client.Command,
   AccessDeniedException: () => AccessDeniedException,
   ClientLimitExceededException: () => ClientLimitExceededException,
   InvalidArgumentException: () => InvalidArgumentException,
+  JoinStorageSessionAsViewerCommand: () => JoinStorageSessionAsViewerCommand,
   JoinStorageSessionCommand: () => JoinStorageSessionCommand,
   KinesisVideoWebRTCStorage: () => KinesisVideoWebRTCStorage,
   KinesisVideoWebRTCStorageClient: () => KinesisVideoWebRTCStorageClient,
@@ -174,7 +174,7 @@ var KinesisVideoWebRTCStorageClient = _KinesisVideoWebRTCStorageClient;
 // src/KinesisVideoWebRTCStorage.ts
 
 
-// src/commands/JoinStorageSessionCommand.ts
+// src/commands/JoinStorageSessionAsViewerCommand.ts
 
 var import_middleware_serde = require("@smithy/middleware-serde");
 
@@ -284,6 +284,22 @@ var se_JoinStorageSessionCommand = /* @__PURE__ */ __name(async (input, context)
   b.m("POST").h(headers).b(body);
   return b.build();
 }, "se_JoinStorageSessionCommand");
+var se_JoinStorageSessionAsViewerCommand = /* @__PURE__ */ __name(async (input, context) => {
+  const b = (0, import_core.requestBuilder)(input, context);
+  const headers = {
+    "content-type": "application/json"
+  };
+  b.bp("/joinStorageSessionAsViewer");
+  let body;
+  body = JSON.stringify(
+    (0, import_smithy_client.take)(input, {
+      channelArn: [],
+      clientId: []
+    })
+  );
+  b.m("POST").h(headers).b(body);
+  return b.build();
+}, "se_JoinStorageSessionAsViewerCommand");
 var de_JoinStorageSessionCommand = /* @__PURE__ */ __name(async (output, context) => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
     return de_CommandError(output, context);
@@ -294,6 +310,16 @@ var de_JoinStorageSessionCommand = /* @__PURE__ */ __name(async (output, context
   await (0, import_smithy_client.collectBody)(output.body, context);
   return contents;
 }, "de_JoinStorageSessionCommand");
+var de_JoinStorageSessionAsViewerCommand = /* @__PURE__ */ __name(async (output, context) => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_CommandError(output, context);
+  }
+  const contents = (0, import_smithy_client.map)({
+    $metadata: deserializeMetadata(output)
+  });
+  await (0, import_smithy_client.collectBody)(output.body, context);
+  return contents;
+}, "de_JoinStorageSessionAsViewerCommand");
 var de_CommandError = /* @__PURE__ */ __name(async (output, context) => {
   const parsedOutput = {
     ...output,
@@ -382,7 +408,23 @@ var deserializeMetadata = /* @__PURE__ */ __name((output) => ({
   cfId: output.headers["x-amz-cf-id"]
 }), "deserializeMetadata");
 
+// src/commands/JoinStorageSessionAsViewerCommand.ts
+var _JoinStorageSessionAsViewerCommand = class _JoinStorageSessionAsViewerCommand extends import_smithy_client.Command.classBuilder().ep({
+  ...commonParams
+}).m(function(Command, cs, config, o) {
+  return [
+    (0, import_middleware_serde.getSerdePlugin)(config, this.serialize, this.deserialize),
+    (0, import_middleware_endpoint.getEndpointPlugin)(config, Command.getEndpointParameterInstructions())
+  ];
+}).s("AWSAcuityRoutingServiceLambda", "JoinStorageSessionAsViewer", {}).n("KinesisVideoWebRTCStorageClient", "JoinStorageSessionAsViewerCommand").f(void 0, void 0).ser(se_JoinStorageSessionAsViewerCommand).de(de_JoinStorageSessionAsViewerCommand).build() {
+};
+__name(_JoinStorageSessionAsViewerCommand, "JoinStorageSessionAsViewerCommand");
+var JoinStorageSessionAsViewerCommand = _JoinStorageSessionAsViewerCommand;
+
 // src/commands/JoinStorageSessionCommand.ts
+
+
+
 var _JoinStorageSessionCommand = class _JoinStorageSessionCommand extends import_smithy_client.Command.classBuilder().ep({
   ...commonParams
 }).m(function(Command, cs, config, o) {
@@ -397,7 +439,8 @@ var JoinStorageSessionCommand = _JoinStorageSessionCommand;
 
 // src/KinesisVideoWebRTCStorage.ts
 var commands = {
-  JoinStorageSessionCommand
+  JoinStorageSessionCommand,
+  JoinStorageSessionAsViewerCommand
 };
 var _KinesisVideoWebRTCStorage = class _KinesisVideoWebRTCStorage extends KinesisVideoWebRTCStorageClient {
 };
@@ -412,6 +455,7 @@ var KinesisVideoWebRTCStorage = _KinesisVideoWebRTCStorage;
   KinesisVideoWebRTCStorageClient,
   KinesisVideoWebRTCStorage,
   $Command,
+  JoinStorageSessionAsViewerCommand,
   JoinStorageSessionCommand,
   AccessDeniedException,
   ClientLimitExceededException,

package/dist-es/KinesisVideoWebRTCStorage.js

@@ -1,8 +1,10 @@
 import { createAggregatedClient } from "@smithy/smithy-client";
+import { JoinStorageSessionAsViewerCommand, } from "./commands/JoinStorageSessionAsViewerCommand";
 import { JoinStorageSessionCommand, } from "./commands/JoinStorageSessionCommand";
 import { KinesisVideoWebRTCStorageClient, } from "./KinesisVideoWebRTCStorageClient";
 const commands = {
     JoinStorageSessionCommand,
+    JoinStorageSessionAsViewerCommand,
 };
 export class KinesisVideoWebRTCStorage extends KinesisVideoWebRTCStorageClient {
 }

package/dist-es/commands/JoinStorageSessionAsViewerCommand.js

@@ -0,0 +1,24 @@
+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 { de_JoinStorageSessionAsViewerCommand, se_JoinStorageSessionAsViewerCommand } from "../protocols/Aws_restJson1";
+export { $Command };
+export class JoinStorageSessionAsViewerCommand extends $Command
+    .classBuilder()
+    .ep({
+    ...commonParams,
+})
+    .m(function (Command, cs, config, o) {
+    return [
+        getSerdePlugin(config, this.serialize, this.deserialize),
+        getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+})
+    .s("AWSAcuityRoutingServiceLambda", "JoinStorageSessionAsViewer", {})
+    .n("KinesisVideoWebRTCStorageClient", "JoinStorageSessionAsViewerCommand")
+    .f(void 0, void 0)
+    .ser(se_JoinStorageSessionAsViewerCommand)
+    .de(de_JoinStorageSessionAsViewerCommand)
+    .build() {
+}

package/dist-es/commands/index.js

@@ -1 +1,2 @@
+export * from "./JoinStorageSessionAsViewerCommand";
 export * from "./JoinStorageSessionCommand";

package/dist-es/protocols/Aws_restJson1.js

@@ -16,6 +16,20 @@ export const se_JoinStorageSessionCommand = async (input, context) => {
     b.m("POST").h(headers).b(body);
     return b.build();
 };
+export const se_JoinStorageSessionAsViewerCommand = async (input, context) => {
+    const b = rb(input, context);
+    const headers = {
+        "content-type": "application/json",
+    };
+    b.bp("/joinStorageSessionAsViewer");
+    let body;
+    body = JSON.stringify(take(input, {
+        channelArn: [],
+        clientId: [],
+    }));
+    b.m("POST").h(headers).b(body);
+    return b.build();
+};
 export const de_JoinStorageSessionCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_CommandError(output, context);
@@ -26,6 +40,16 @@ export const de_JoinStorageSessionCommand = async (output, context) => {
     await collectBody(output.body, context);
     return contents;
 };
+export const de_JoinStorageSessionAsViewerCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_CommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    await collectBody(output.body, context);
+    return contents;
+};
 const de_CommandError = async (output, context) => {
     const parsedOutput = {
         ...output,

package/dist-types/KinesisVideoWebRTCStorage.d.ts

@@ -1,4 +1,5 @@
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@smithy/types";
+import { JoinStorageSessionAsViewerCommandInput, JoinStorageSessionAsViewerCommandOutput } from "./commands/JoinStorageSessionAsViewerCommand";
 import { JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput } from "./commands/JoinStorageSessionCommand";
 import { KinesisVideoWebRTCStorageClient } from "./KinesisVideoWebRTCStorageClient";
 export interface KinesisVideoWebRTCStorage {
@@ -8,9 +9,16 @@ export interface KinesisVideoWebRTCStorage {
     joinStorageSession(args: JoinStorageSessionCommandInput, options?: __HttpHandlerOptions): Promise<JoinStorageSessionCommandOutput>;
     joinStorageSession(args: JoinStorageSessionCommandInput, cb: (err: any, data?: JoinStorageSessionCommandOutput) => void): void;
     joinStorageSession(args: JoinStorageSessionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: JoinStorageSessionCommandOutput) => void): void;
+    /**
+     * @see {@link JoinStorageSessionAsViewerCommand}
+     */
+    joinStorageSessionAsViewer(args: JoinStorageSessionAsViewerCommandInput, options?: __HttpHandlerOptions): Promise<JoinStorageSessionAsViewerCommandOutput>;
+    joinStorageSessionAsViewer(args: JoinStorageSessionAsViewerCommandInput, cb: (err: any, data?: JoinStorageSessionAsViewerCommandOutput) => void): void;
+    joinStorageSessionAsViewer(args: JoinStorageSessionAsViewerCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: JoinStorageSessionAsViewerCommandOutput) => void): void;
 }
 /**
- * <p>
+ * <fullname>webrtc</fullname>
+ *          <p>
  *     </p>
  * @public
  */

package/dist-types/KinesisVideoWebRTCStorageClient.d.ts

@@ -7,6 +7,7 @@ import { HttpHandlerUserInput as __HttpHandlerUserInput } from "@smithy/protocol
 import { Client as __Client, DefaultsMode as __DefaultsMode, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@smithy/smithy-client";
 import { AwsCredentialIdentityProvider, BodyLengthCalculator as __BodyLengthCalculator, CheckOptionalClientConfig as __CheckOptionalClientConfig, ChecksumConstructor as __ChecksumConstructor, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@smithy/types";
 import { HttpAuthSchemeInputConfig, HttpAuthSchemeResolvedConfig } from "./auth/httpAuthSchemeProvider";
+import { JoinStorageSessionAsViewerCommandInput, JoinStorageSessionAsViewerCommandOutput } from "./commands/JoinStorageSessionAsViewerCommand";
 import { JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput } from "./commands/JoinStorageSessionCommand";
 import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
 import { RuntimeExtension, RuntimeExtensionsConfig } from "./runtimeExtensions";
@@ -14,11 +15,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = JoinStorageSessionCommandInput;
+export type ServiceInputTypes = JoinStorageSessionAsViewerCommandInput | JoinStorageSessionCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = JoinStorageSessionCommandOutput;
+export type ServiceOutputTypes = JoinStorageSessionAsViewerCommandOutput | JoinStorageSessionCommandOutput;
 /**
  * @public
  */
@@ -152,7 +153,8 @@ export type KinesisVideoWebRTCStorageClientResolvedConfigType = __SmithyResolved
 export interface KinesisVideoWebRTCStorageClientResolvedConfig extends KinesisVideoWebRTCStorageClientResolvedConfigType {
 }
 /**
- * <p>
+ * <fullname>webrtc</fullname>
+ *          <p>
  *     </p>
  * @public
  */

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

@@ -0,0 +1,90 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../KinesisVideoWebRTCStorageClient";
+import { JoinStorageSessionAsViewerInput } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link JoinStorageSessionAsViewerCommand}.
+ */
+export interface JoinStorageSessionAsViewerCommandInput extends JoinStorageSessionAsViewerInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link JoinStorageSessionAsViewerCommand}.
+ */
+export interface JoinStorageSessionAsViewerCommandOutput extends __MetadataBearer {
+}
+declare const JoinStorageSessionAsViewerCommand_base: {
+    new (input: JoinStorageSessionAsViewerCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionAsViewerCommandInput, JoinStorageSessionAsViewerCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: JoinStorageSessionAsViewerCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionAsViewerCommandInput, JoinStorageSessionAsViewerCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ *       Join the ongoing one way-video and/or multi-way audio WebRTC session as
+ *       a viewer for an input channel. If there’s
+ *       no existing session for the channel, create a new streaming session and provide
+ *       the Amazon Resource Name (ARN) of the signaling channel (<code>channelArn</code>)
+ *       and client id (<code>clientId</code>).
+ *     </p>
+ *          <p>Currently for <code>SINGLE_MASTER</code> type, a video producing device
+ *       is able to ingest both audio and video media into a stream, while viewers
+ *       can only ingest audio. Both a video producing device and viewers can join
+ *       a session first and wait for other participants. While participants are having peer to peer conversations through WebRTC,
+ *       the ingested media session will be stored into the Kinesis Video Stream.
+ *       Multiple viewers are able to playback real-time media.
+ *     </p>
+ *          <p>Customers can also use existing Kinesis Video Streams features like
+ *       <code>HLS</code> or <code>DASH</code> playback, Image generation, and more
+ *       with ingested WebRTC media. If there’s an existing session with the same
+ *       <code>clientId</code> that's found in the join session request, the new request takes precedence.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { KinesisVideoWebRTCStorageClient, JoinStorageSessionAsViewerCommand } from "@aws-sdk/client-kinesis-video-webrtc-storage"; // ES Modules import
+ * // const { KinesisVideoWebRTCStorageClient, JoinStorageSessionAsViewerCommand } = require("@aws-sdk/client-kinesis-video-webrtc-storage"); // CommonJS import
+ * const client = new KinesisVideoWebRTCStorageClient(config);
+ * const input = { // JoinStorageSessionAsViewerInput
+ *   channelArn: "STRING_VALUE", // required
+ *   clientId: "STRING_VALUE", // required
+ * };
+ * const command = new JoinStorageSessionAsViewerCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param JoinStorageSessionAsViewerCommandInput - {@link JoinStorageSessionAsViewerCommandInput}
+ * @returns {@link JoinStorageSessionAsViewerCommandOutput}
+ * @see {@link JoinStorageSessionAsViewerCommandInput} for command's `input` shape.
+ * @see {@link JoinStorageSessionAsViewerCommandOutput} for command's `response` shape.
+ * @see {@link KinesisVideoWebRTCStorageClientResolvedConfig | config} for KinesisVideoWebRTCStorageClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have required permissions to perform this operation.</p>
+ *
+ * @throws {@link ClientLimitExceededException} (client fault)
+ *  <p>
+ *       Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client calls. Try making the call later.
+ *     </p>
+ *
+ * @throws {@link InvalidArgumentException} (client fault)
+ *  <p>The value for this input parameter is invalid.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource is not found.</p>
+ *
+ * @throws {@link KinesisVideoWebRTCStorageServiceException}
+ * <p>Base exception class for all service exceptions from KinesisVideoWebRTCStorage service.</p>
+ *
+ * @public
+ */
+export declare class JoinStorageSessionAsViewerCommand extends JoinStorageSessionAsViewerCommand_base {
+}

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { KinesisVideoWebRTCStorageClientResolvedConfig } from "../KinesisVideoWebRTCStorageClient";
+import { KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../KinesisVideoWebRTCStorageClient";
 import { JoinStorageSessionInput } from "../models/models_0";
 /**
  * @public
@@ -22,33 +22,66 @@ export interface JoinStorageSessionCommandInput extends JoinStorageSessionInput
 export interface JoinStorageSessionCommandOutput extends __MetadataBearer {
 }
 declare const JoinStorageSessionCommand_base: {
-    new (input: JoinStorageSessionCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput>;
-    new (__0_0: JoinStorageSessionCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput>;
+    new (input: JoinStorageSessionCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: JoinStorageSessionCommandInput): import("@smithy/smithy-client").CommandImpl<JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput, KinesisVideoWebRTCStorageClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>
- *       Join the ongoing one way-video and/or multi-way audio WebRTC session as
- *       a video producing device for an input channel. If there’s no existing
- *       session for the channel, a new streaming session needs to be created, and the
- *       Amazon Resource Name (ARN) of the signaling channel must be provided.
- *     </p>
+ * <note>
+ *             <p>Before using this API, you must call the <code>GetSignalingChannelEndpoint</code> API to request the WEBRTC endpoint. You then specify the endpoint and region in your <code>JoinStorageSession</code> API request.</p>
+ *          </note>
+ *          <p>Join the ongoing one way-video and/or multi-way audio WebRTC session as a video producing
+ *       device for an input channel. If there’s no existing session for the channel, a new streaming
+ *       session needs to be created, and the Amazon Resource Name (ARN) of the signaling channel must
+ *       be provided. </p>
  *          <p>Currently for the <code>SINGLE_MASTER</code> type, a video producing
- *       device is able to ingest both audio and video media into a stream,
- *       while viewers can only ingest audio. Both a video producing device
- *       and viewers can join the session first, and wait for other participants.</p>
- *          <p>While participants are having peer to peer conversations through webRTC,
- *       the ingested media session will be stored into the Kinesis Video Stream.
- *       Multiple viewers are able to playback real-time media.</p>
- *          <p>Customers can also use existing Kinesis Video Streams features like
- *       <code>HLS</code> or <code>DASH</code> playback, Image generation, and more
+ *       device is able to ingest both audio and video media into a stream. Only video producing devices can join the session and record media.</p>
+ *          <important>
+ *             <p>Both audio and video tracks are currently required for WebRTC ingestion.</p>
+ *             <p>Current requirements:</p>
+ *             <ul>
+ *                <li>
+ *                   <p>Video track: H.264</p>
+ *                </li>
+ *                <li>
+ *                   <p>Audio track: Opus</p>
+ *                </li>
+ *             </ul>
+ *          </important>
+ *          <p>The resulting ingested video in the Kinesis video stream will have the following
+ *       parameters: H.264 video and AAC audio.</p>
+ *          <p>Once a master participant has negotiated a connection through WebRTC, the ingested media
+ *       session will be stored in the Kinesis video stream. Multiple viewers are then able to play
+ *       back real-time media through our Playback APIs.</p>
+ *          <p>You can also use existing Kinesis Video Streams features like <code>HLS</code> or
+ *       <code>DASH</code> playback, image generation via <a href="https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html">GetImages</a>, and more
  *       with ingested WebRTC media.</p>
  *          <note>
+ *             <p>S3 image delivery and notifications are not currently supported.</p>
+ *          </note>
+ *          <note>
  *             <p>Assume that only one video producing device client
  *       can be associated with a session for the channel. If more than one
  *       client joins the session of a specific channel as a video producing device,
  *       the most recent client request takes precedence. </p>
  *          </note>
+ *          <p>
+ *             <b>Additional information</b>
+ *          </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <b>Idempotent</b> - This API is not idempotent.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <b>Retry behavior</b> - This is counted as a new API call.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <b>Concurrent calls</b> - Concurrent calls are allowed. An offer is sent once per each call.</p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -1 +1,2 @@
+export * from "./JoinStorageSessionAsViewerCommand";
 export * from "./JoinStorageSessionCommand";

package/dist-types/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * <p>
+ * <fullname>webrtc</fullname>
+ *          <p>
  *     </p>
  *
  * @packageDocumentation

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

@@ -62,3 +62,22 @@ export declare class ResourceNotFoundException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
+/**
+ * @public
+ */
+export interface JoinStorageSessionAsViewerInput {
+    /**
+     * <p>
+     *       The Amazon Resource Name (ARN) of the signaling channel.
+     *     </p>
+     * @public
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>
+     *       The unique identifier for the sender client.
+     *     </p>
+     * @public
+     */
+    clientId: string | undefined;
+}

package/dist-types/protocols/Aws_restJson1.d.ts

@@ -1,11 +1,20 @@
 import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@smithy/protocol-http";
 import { SerdeContext as __SerdeContext } from "@smithy/types";
+import { JoinStorageSessionAsViewerCommandInput, JoinStorageSessionAsViewerCommandOutput } from "../commands/JoinStorageSessionAsViewerCommand";
 import { JoinStorageSessionCommandInput, JoinStorageSessionCommandOutput } from "../commands/JoinStorageSessionCommand";
 /**
  * serializeAws_restJson1JoinStorageSessionCommand
  */
 export declare const se_JoinStorageSessionCommand: (input: JoinStorageSessionCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+/**
+ * serializeAws_restJson1JoinStorageSessionAsViewerCommand
+ */
+export declare const se_JoinStorageSessionAsViewerCommand: (input: JoinStorageSessionAsViewerCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 /**
  * deserializeAws_restJson1JoinStorageSessionCommand
  */
 export declare const de_JoinStorageSessionCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<JoinStorageSessionCommandOutput>;
+/**
+ * deserializeAws_restJson1JoinStorageSessionAsViewerCommand
+ */
+export declare const de_JoinStorageSessionAsViewerCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<JoinStorageSessionAsViewerCommandOutput>;

package/dist-types/ts3.4/KinesisVideoWebRTCStorage.d.ts

@@ -1,4 +1,8 @@
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@smithy/types";
+import {
+  JoinStorageSessionAsViewerCommandInput,
+  JoinStorageSessionAsViewerCommandOutput,
+} from "./commands/JoinStorageSessionAsViewerCommand";
 import {
   JoinStorageSessionCommandInput,
   JoinStorageSessionCommandOutput,
@@ -18,6 +22,19 @@ export interface KinesisVideoWebRTCStorage {
     options: __HttpHandlerOptions,
     cb: (err: any, data?: JoinStorageSessionCommandOutput) => void
   ): void;
+  joinStorageSessionAsViewer(
+    args: JoinStorageSessionAsViewerCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<JoinStorageSessionAsViewerCommandOutput>;
+  joinStorageSessionAsViewer(
+    args: JoinStorageSessionAsViewerCommandInput,
+    cb: (err: any, data?: JoinStorageSessionAsViewerCommandOutput) => void
+  ): void;
+  joinStorageSessionAsViewer(
+    args: JoinStorageSessionAsViewerCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: JoinStorageSessionAsViewerCommandOutput) => void
+  ): void;
 }
 export declare class KinesisVideoWebRTCStorage
   extends KinesisVideoWebRTCStorageClient

package/dist-types/ts3.4/KinesisVideoWebRTCStorageClient.d.ts

@@ -45,6 +45,10 @@ import {
   HttpAuthSchemeInputConfig,
   HttpAuthSchemeResolvedConfig,
 } from "./auth/httpAuthSchemeProvider";
+import {
+  JoinStorageSessionAsViewerCommandInput,
+  JoinStorageSessionAsViewerCommandOutput,
+} from "./commands/JoinStorageSessionAsViewerCommand";
 import {
   JoinStorageSessionCommandInput,
   JoinStorageSessionCommandOutput,
@@ -56,8 +60,12 @@ import {
 } from "./endpoint/EndpointParameters";
 import { RuntimeExtension, RuntimeExtensionsConfig } from "./runtimeExtensions";
 export { __Client };
-export type ServiceInputTypes = JoinStorageSessionCommandInput;
-export type ServiceOutputTypes = JoinStorageSessionCommandOutput;
+export type ServiceInputTypes =
+  | JoinStorageSessionAsViewerCommandInput
+  | JoinStorageSessionCommandInput;
+export type ServiceOutputTypes =
+  | JoinStorageSessionAsViewerCommandOutput
+  | JoinStorageSessionCommandOutput;
 export interface ClientDefaults
   extends Partial<__SmithyConfiguration<__HttpHandlerOptions>> {
   requestHandler?: __HttpHandlerUserInput;

package/dist-types/ts3.4/commands/JoinStorageSessionAsViewerCommand.d.ts

@@ -0,0 +1,36 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import {
+  KinesisVideoWebRTCStorageClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../KinesisVideoWebRTCStorageClient";
+import { JoinStorageSessionAsViewerInput } from "../models/models_0";
+export { __MetadataBearer };
+export { $Command };
+export interface JoinStorageSessionAsViewerCommandInput
+  extends JoinStorageSessionAsViewerInput {}
+export interface JoinStorageSessionAsViewerCommandOutput
+  extends __MetadataBearer {}
+declare const JoinStorageSessionAsViewerCommand_base: {
+  new (
+    input: JoinStorageSessionAsViewerCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    JoinStorageSessionAsViewerCommandInput,
+    JoinStorageSessionAsViewerCommandOutput,
+    KinesisVideoWebRTCStorageClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  new (
+    __0_0: JoinStorageSessionAsViewerCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    JoinStorageSessionAsViewerCommandInput,
+    JoinStorageSessionAsViewerCommandOutput,
+    KinesisVideoWebRTCStorageClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+export declare class JoinStorageSessionAsViewerCommand extends JoinStorageSessionAsViewerCommand_base {}

package/dist-types/ts3.4/commands/JoinStorageSessionCommand.d.ts

@@ -1,6 +1,10 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { KinesisVideoWebRTCStorageClientResolvedConfig } from "../KinesisVideoWebRTCStorageClient";
+import {
+  KinesisVideoWebRTCStorageClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../KinesisVideoWebRTCStorageClient";
 import { JoinStorageSessionInput } from "../models/models_0";
 export { __MetadataBearer };
 export { $Command };
@@ -14,8 +18,8 @@ declare const JoinStorageSessionCommand_base: {
     JoinStorageSessionCommandInput,
     JoinStorageSessionCommandOutput,
     KinesisVideoWebRTCStorageClientResolvedConfig,
-    JoinStorageSessionCommandInput,
-    JoinStorageSessionCommandOutput
+    ServiceInputTypes,
+    ServiceOutputTypes
   >;
   new (
     __0_0: JoinStorageSessionCommandInput
@@ -23,8 +27,8 @@ declare const JoinStorageSessionCommand_base: {
     JoinStorageSessionCommandInput,
     JoinStorageSessionCommandOutput,
     KinesisVideoWebRTCStorageClientResolvedConfig,
-    JoinStorageSessionCommandInput,
-    JoinStorageSessionCommandOutput
+    ServiceInputTypes,
+    ServiceOutputTypes
   >;
   getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };

package/dist-types/ts3.4/commands/index.d.ts

@@ -1 +1,2 @@
+export * from "./JoinStorageSessionAsViewerCommand";
 export * from "./JoinStorageSessionCommand";

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

@@ -31,3 +31,7 @@ export declare class ResourceNotFoundException extends __BaseException {
     opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>
   );
 }
+export interface JoinStorageSessionAsViewerInput {
+  channelArn: string | undefined;
+  clientId: string | undefined;
+}

package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts

@@ -3,6 +3,10 @@ import {
   HttpResponse as __HttpResponse,
 } from "@smithy/protocol-http";
 import { SerdeContext as __SerdeContext } from "@smithy/types";
+import {
+  JoinStorageSessionAsViewerCommandInput,
+  JoinStorageSessionAsViewerCommandOutput,
+} from "../commands/JoinStorageSessionAsViewerCommand";
 import {
   JoinStorageSessionCommandInput,
   JoinStorageSessionCommandOutput,
@@ -11,7 +15,15 @@ export declare const se_JoinStorageSessionCommand: (
   input: JoinStorageSessionCommandInput,
   context: __SerdeContext
 ) => Promise<__HttpRequest>;
+export declare const se_JoinStorageSessionAsViewerCommand: (
+  input: JoinStorageSessionAsViewerCommandInput,
+  context: __SerdeContext
+) => Promise<__HttpRequest>;
 export declare const de_JoinStorageSessionCommand: (
   output: __HttpResponse,
   context: __SerdeContext
 ) => Promise<JoinStorageSessionCommandOutput>;
+export declare const de_JoinStorageSessionAsViewerCommand: (
+  output: __HttpResponse,
+  context: __SerdeContext
+) => Promise<JoinStorageSessionAsViewerCommandOutput>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-kinesis-video-webrtc-storage",
   "description": "AWS SDK for JavaScript Kinesis Video Webrtc Storage Client for Node.js, Browser and React Native",
-  "version": "3.623.0",
+  "version": "3.624.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-kinesis-video-webrtc-storage",
@@ -20,10 +20,10 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/client-sso-oidc": "3.623.0",
-    "@aws-sdk/client-sts": "3.623.0",
-    "@aws-sdk/core": "3.623.0",
-    "@aws-sdk/credential-provider-node": "3.623.0",
+    "@aws-sdk/client-sso-oidc": "3.624.0",
+    "@aws-sdk/client-sts": "3.624.0",
+    "@aws-sdk/core": "3.624.0",
+    "@aws-sdk/credential-provider-node": "3.624.0",
     "@aws-sdk/middleware-host-header": "3.620.0",
     "@aws-sdk/middleware-logger": "3.609.0",
     "@aws-sdk/middleware-recursion-detection": "3.620.0",