Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 2 people

lambdas/libs/aws-ssm-util/src/index.ts

@@ -17,6 +17,32 @@ export async function getParameter(parameter_name: string): Promise<string> {
   return result;
 }
 
+/**
+ * Retrieves multiple parameters from AWS Systems Manager Parameter Store.
+ *
+ * This function uses the AWS SSM {@link GetParametersCommand} API to fetch the values
+ * for the provided parameter names. Requests are automatically chunked into batches
+ * of up to 10 names per call to comply with the AWS GetParameters API limit.
+ *
+ * Each successfully retrieved parameter is added to the returned {@link Map}, where:
+ * - The map key is the full parameter name as stored in Parameter Store.
+ * - The map value is the decrypted string value of the parameter.
+ *
+ * Parameter names that are not found in Parameter Store (or that cannot be returned
+ * by the API) are silently omitted from the resulting map. They will not appear as
+ * keys in the returned {@link Map}.
+ *
+ * @param parameter_names - An array of parameter names to retrieve from SSM Parameter Store.
+ *   If the array is empty, an empty {@link Map} is returned without calling the AWS API.
+ *
+ * @returns A {@link Map} where each key is a parameter name and each value is the
+ *   corresponding decrypted string value for that parameter. Only parameters that
+ *   are successfully retrieved and have both a `Name` and a `Value` are included.
+ *
+ * @throws Error Propagates any error thrown by the underlying AWS SDK client,
+ *   such as network errors, AWS service errors (e.g., access denied, throttling),
+ *   or configuration issues (e.g., missing region or credentials).
+ */
 export async function getParameters(parameter_names: string[]): Promise<Map<string, string>> {
   if (parameter_names.length === 0) {
     return new Map();