docs: add thrown exceptions to command documentation

Author: kuhe

smithy-typescript-codegen/src/main/java/software/amazon/smithy/typescript/codegen/CommandGenerator.java

@@ -37,7 +37,10 @@
 import software.amazon.smithy.model.shapes.OperationShape;
 import software.amazon.smithy.model.shapes.ServiceShape;
 import software.amazon.smithy.model.shapes.Shape;
+import software.amazon.smithy.model.shapes.ShapeId;
 import software.amazon.smithy.model.shapes.StructureShape;
+import software.amazon.smithy.model.traits.DocumentationTrait;
+import software.amazon.smithy.model.traits.ErrorTrait;
 import software.amazon.smithy.rulesengine.traits.EndpointRuleSetTrait;
 import software.amazon.smithy.typescript.codegen.endpointsV2.EndpointsParamNameMap;
 import software.amazon.smithy.typescript.codegen.endpointsV2.RuleSetParameterFinder;
@@ -120,8 +123,13 @@ private void generateClientCommand() {
         writer.addImport("MiddlewareStack", "MiddlewareStack", "@aws-sdk/types");
 
         String name = symbol.getName();
-        writer.writeShapeDocs(operation, shapeDoc -> shapeDoc + "\n" + getCommandExample(serviceSymbol.getName(),
-                configType, name, inputType.getName(), outputType.getName()));
+        writer.writeShapeDocs(
+            operation, 
+            shapeDoc -> shapeDoc + "\n"
+            + getCommandExample(serviceSymbol.getName(), configType, name, inputType.getName(), outputType.getName())
+            + "\n"
+            + getThrownExceptions()
+        );
         writer.openBlock(
             "export class $L extends $$Command<$T, $T, $L> {", "}",
             name, inputType, outputType,
@@ -169,6 +177,25 @@ private String getCommandExample(String serviceName, String configName, String c
             + String.format("@see {@link %s | config} for %s's `config` shape.%n", configName, serviceName);
     }
 
+    private String getThrownExceptions() {
+        List<ShapeId> errors = operation.getErrors();
+        StringBuilder buffer = new StringBuilder();
+        for (ShapeId error : errors) {
+            Shape errorShape = model.getShape(error).get();
+            Optional<DocumentationTrait> doc = errorShape.getTrait(DocumentationTrait.class);
+            ErrorTrait errorTrait = errorShape.getTrait(ErrorTrait.class).get();
+
+            if (doc.isPresent()) {
+                buffer.append(String.format("@throws {@link %s} (%s fault) %s\n", 
+                    error.getName(), errorTrait.getValue(), doc.get().getValue()));
+            } else {
+                buffer.append(String.format("@throws {@link %s} (%s fault)\n", 
+                    error.getName(), errorTrait.getValue()));
+            }
+        }
+        return buffer.toString();
+    }
+
     private void generateCommandConstructor() {
         writer.openBlock("constructor(readonly input: $T) {", "}", inputType, () -> {
             // The constructor can be intercepted and changed.