Merge branch 'dotnet-dynamodb-updates' of github.com:rlhagerm/aws-doc-sdk-examples into dotnet-dynamodb-updates

Author: rlhagerm

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -100,6 +100,14 @@ bedrock-runtime_Converse_AmazonNovaText:
             - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
               snippet_tags:
                 - bedrock-runtime.java2.Converse_AmazonNovaText
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
+              snippet_tags:
+                - javascript.v3.bedrock-runtime.Converse_AmazonTitanText
     .NET:
       versions:
         - sdk_version: 3
@@ -423,6 +431,14 @@ bedrock-runtime_ConverseStream_AmazonNovaText:
             - description: Send a text message to Amazon Nova using Bedrock's Converse API and process the response stream in real-time.
               snippet_tags:
                 - bedrock-runtime.java2.ConverseStream_AmazonNovaText
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova using Bedrock's Converse API and process the response stream in real-time.
+              snippet_tags:
+                - javascript.v3.bedrock-runtime.Converse_Mistral
     .NET:
       versions:
         - sdk_version: 3
@@ -1235,6 +1251,14 @@ bedrock-runtime_InvokeModel_AmazonNovaImageGeneration:
             - description: Create an image with Amazon Nova Canvas.
               snippet_tags:
                 - bedrock-runtime.java2.InvokeModel_AmazonNovaImageGeneration
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/bedrock-runtime
+          excerpts:
+            - description: Create an image with Amazon Nova Canvas.
+              snippet_tags:
+                - javascript.v3.bedrock-runtime.InvokeModel_AmazonNovaImageGeneration
     .NET:
       versions:
         - sdk_version: 3

.doc_gen/metadata/sqs_metadata.yaml

@@ -58,6 +58,18 @@ sqs_Hello:
             - description: Initialize an &SQS; client and list queues.
               snippet_tags:
                 - javascript.v3.sqs.hello
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description: The <code>Package.swift</code> file.
+              snippet_tags:
+                - swift.sqs.basics.package
+            - description: The Swift source code, <code>entry.swift</code>.
+              snippet_tags:
+                - swift.sqs.basics
   services:
     sqs: {ListQueues}
 sqs_CreateQueue:
@@ -163,6 +175,15 @@ sqs_CreateQueue:
               snippet_tags:
                 - cpp.example_code.sqs.CreateQueue.config
                 - cpp.example_code.sqs.CreateQueue
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.CreateQueue
   services:
     sqs: {CreateQueue}
 sqs_GetQueueUrl:
@@ -320,6 +341,15 @@ sqs_ListQueues:
               snippet_tags:
                 - cpp.example_code.sqs.ListQueues.config
                 - cpp.example_code.sqs.ListQueues
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.ListQueues
   services:
     sqs: {ListQueues}
 sqs_DeleteQueue:
@@ -414,6 +444,15 @@ sqs_DeleteQueue:
               snippet_tags:
                 - cpp.example_code.sqs.DeleteQueue.config
                 - cpp.example_code.sqs.DeleteQueue
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.DeleteQueue
   services:
     sqs: {DeleteQueue}
 sqs_SendMessage:
@@ -649,6 +688,15 @@ sqs_ReceiveMessage:
               snippet_tags:
                 - cpp.example_code.sqs.ReceiveMessage.config
                 - cpp.example_code.sqs.ReceiveMessage
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.ReceiveMessage
   services:
     sqs: {ReceiveMessage}
 sqs_DeleteMessage:
@@ -765,6 +813,15 @@ sqs_DeleteMessageBatch:
             - description:
               snippet_tags:
                 - sqs.JavaScript.messages.receiveMessageV3
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.DeleteMessageBatch
   services:
     sqs: {DeleteMessageBatch}
 sqs_Scenario_SendReceiveBatch:
@@ -836,6 +893,15 @@ sqs_GetQueueAttributes:
             - description:
               snippet_tags:
                 - javascript.v3.sqs.actions.GetQueueAttributes
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.GetQueueAttributes
   services:
     sqs: {GetQueueAttributes}
 sqs_ChangeMessageVisibility:
@@ -931,6 +997,15 @@ sqs_SetQueueAttributes:
             - description: Configure a dead-letter queue.
               snippet_tags:
                 - sqs.JavaScript.deadLetter.setQueueAttributesV3
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/sqs
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.sqs.SetQueueAttributes
   services:
     sqs: {SetQueueAttributes}
 sqs_Scenario_TopicsAndQueues:

javascriptv3/example_code/bedrock-runtime/.gitignore

@@ -1 +1,2 @@
 /tempx/
+/output/

javascriptv3/example_code/bedrock-runtime/README.md

@@ -50,6 +50,15 @@ functions within the same service.
 - [Converse](models/ai21LabsJurassic2/converse.js#L4)
 - [InvokeModel](models/ai21LabsJurassic2/invoke_model.js)
 
+### Amazon Nova
+
+- [Converse](models/amazonTitanText/converse.js#L4)
+- [ConverseStream](models/mistral/converse.js#L4)
+
+### Amazon Nova Canvas
+
+- [InvokeModel](models/amazonNovaCanvas/invokeModel.js#L4)
+
 ### Amazon Titan Text
 
 - [Converse](models/amazonTitanText/converse.js#L4)

javascriptv3/example_code/bedrock-runtime/models/amazonNovaCanvas/invokeModel.js

@@ -0,0 +1,93 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+// snippet-start:[javascript.v3.bedrock-runtime.InvokeModel_AmazonNovaImageGeneration]
+
+import {
+  BedrockRuntimeClient,
+  InvokeModelCommand,
+} from "@aws-sdk/client-bedrock-runtime";
+import { saveImage } from "../../utils/image-creation.js";
+import { fileURLToPath } from "node:url";
+
+/**
+ * This example demonstrates how to use Amazon Nova Canvas to generate images.
+ * It shows how to:
+ * - Set up the Amazon Bedrock runtime client
+ * - Configure the image generation parameters
+ * - Send a request to generate an image
+ * - Process the response and handle the generated image
+ *
+ * @returns {Promise<string>} Base64-encoded image data
+ */
+export const invokeModel = async () => {
+  // Step 1: Create the Amazon Bedrock runtime client
+  // Credentials will be automatically loaded from the environment
+  const client = new BedrockRuntimeClient({ region: "us-east-1" });
+
+  // Step 2: Specify which model to use
+  // For the latest available models, see:
+  // https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html
+  const modelId = "amazon.nova-canvas-v1:0";
+
+  // Step 3: Configure the request payload
+  // First, set the main parameters:
+  // - prompt: Text description of the image to generate
+  // - seed: Random number for reproducible generation (0 to 858,993,459)
+  const prompt = "A stylized picture of a cute old steampunk robot";
+  const seed = Math.floor(Math.random() * 858993460);
+
+  // Then, create the payload using the following structure:
+  // - taskType: TEXT_IMAGE (specifies text-to-image generation)
+  // - textToImageParams: Contains the text prompt
+  // - imageGenerationConfig: Contains optional generation settings (seed, quality, etc.)
+  // For a list of available request parameters, see:
+  // https://docs.aws.amazon.com/nova/latest/userguide/image-gen-req-resp-structure.html
+  const payload = {
+    taskType: "TEXT_IMAGE",
+    textToImageParams: {
+      text: prompt,
+    },
+    imageGenerationConfig: {
+      seed,
+      quality: "standard",
+    },
+  };
+
+  // Step 4: Send and process the request
+  // - Embed the payload in a request object
+  // - Send the request to the model
+  // - Extract and return the generated image data from the response
+  try {
+    const request = {
+      modelId,
+      body: JSON.stringify(payload),
+    };
+    const response = await client.send(new InvokeModelCommand(request));
+
+    const decodedResponseBody = new TextDecoder().decode(response.body);
+    // The response includes an array of base64-encoded PNG images
+    /** @type {{images: string[]}} */
+    const responseBody = JSON.parse(decodedResponseBody);
+    return responseBody.images[0]; // Base64-encoded image data
+  } catch (error) {
+    console.error(`ERROR: Can't invoke '${modelId}'. Reason: ${error.message}`);
+    throw error;
+  }
+};
+
+// If run directly, execute the example and save the generated image
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  console.log("Generating image. This may take a few seconds...");
+  invokeModel()
+    .then(async (imageData) => {
+      const imagePath = await saveImage(imageData, "nova-canvas");
+      // Example path: javascriptv3/example_code/bedrock-runtime/output/nova-canvas/image-01.png
+      console.log(`Image saved to: ${imagePath}`);
+    })
+    .catch((error) => {
+      console.error("Execution failed:", error);
+      process.exitCode = 1;
+    });
+}
+// snippet-end:[javascript.v3.bedrock-runtime.InvokeModel_AmazonNovaImageGeneration]

javascriptv3/example_code/bedrock-runtime/models/amazonNovaText/converse.js

@@ -0,0 +1,68 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+// snippet-start:[javascript.v3.bedrock-runtime.Converse_AmazonNovaText]
+// This example demonstrates how to use the Amazon Nova foundation models to generate text.
+// It shows how to:
+// - Set up the Amazon Bedrock runtime client
+// - Create a message
+// - Configure and send a request
+// - Process the response
+
+import {
+  BedrockRuntimeClient,
+  ConversationRole,
+  ConverseCommand,
+} from "@aws-sdk/client-bedrock-runtime";
+
+// Step 1: Create the Amazon Bedrock runtime client
+// Credentials will be automatically loaded from the environment
+const client = new BedrockRuntimeClient({ region: "us-east-1" });
+
+// Step 2: Specify which model to use:
+// Available Amazon Nova models and their characteristics:
+// - Amazon Nova Micro: Text-only model optimized for lowest latency and cost
+// - Amazon Nova Lite:  Fast, low-cost multimodal model for image, video, and text
+// - Amazon Nova Pro:   Advanced multimodal model balancing accuracy, speed, and cost
+//
+// For the most current model IDs, see:
+// https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html
+const modelId = "amazon.nova-lite-v1:0";
+
+// Step 3: Create the message
+// The message includes the text prompt and specifies that it comes from the user
+const inputText =
+  "Describe the purpose of a 'hello world' program in one line.";
+const message = {
+  content: [{ text: inputText }],
+  role: ConversationRole.USER,
+};
+
+// Step 4: Configure the request
+// Optional parameters to control the model's response:
+// - maxTokens: maximum number of tokens to generate
+// - temperature: randomness (max: 1.0, default: 0.7)
+//   OR
+// - topP: diversity of word choice (max: 1.0, default: 0.9)
+// Note: Use either temperature OR topP, but not both
+const request = {
+  modelId,
+  messages: [message],
+  inferenceConfig: {
+    maxTokens: 500, // The maximum response length
+    temperature: 0.5, // Using temperature for randomness control
+    //topP: 0.9,        // Alternative: use topP instead of temperature
+  },
+};
+
+// Step 5: Send and process the request
+// - Send the request to the model
+// - Extract and return the generated text from the response
+try {
+  const response = await client.send(new ConverseCommand(request));
+  console.log(response.output.message.content[0].text);
+} catch (error) {
+  console.error(`ERROR: Can't invoke '${modelId}'. Reason: ${error.message}`);
+  throw error;
+}
+// snippet-end:[javascript.v3.bedrock-runtime.Converse_AmazonNovaText]