feat: Add Parameters Utility

libraries/AWS.Lambda.Powertools.sln

@@ -23,6 +23,10 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AWS.Lambda.Powertools.Traci
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AWS.Lambda.Powertools.Common.Tests", "tests\AWS.Lambda.Powertools.Common.Tests\AWS.Lambda.Powertools.Common.Tests.csproj", "{4EC48E6A-45B5-4E25-ABBD-C23FE2BD6E1E}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AWS.Lambda.Powertools.Parameters", "src\AWS.Lambda.Powertools.Parameters\AWS.Lambda.Powertools.Parameters.csproj", "{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AWS.Lambda.Powertools.Parameters.Tests", "tests\AWS.Lambda.Powertools.Parameters.Tests\AWS.Lambda.Powertools.Parameters.Tests.csproj", "{386A9769-59BF-4BE3-99D4-A9603E300729}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -132,6 +136,30 @@ Global
 		{4EC48E6A-45B5-4E25-ABBD-C23FE2BD6E1E}.Release|x64.Build.0 = Release|Any CPU
 		{4EC48E6A-45B5-4E25-ABBD-C23FE2BD6E1E}.Release|x86.ActiveCfg = Release|Any CPU
 		{4EC48E6A-45B5-4E25-ABBD-C23FE2BD6E1E}.Release|x86.Build.0 = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|x64.Build.0 = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Debug|x86.Build.0 = Debug|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|x64.ActiveCfg = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|x64.Build.0 = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|x86.ActiveCfg = Release|Any CPU
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0}.Release|x86.Build.0 = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|x64.Build.0 = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Debug|x86.Build.0 = Debug|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|Any CPU.Build.0 = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|x64.ActiveCfg = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|x64.Build.0 = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|x86.ActiveCfg = Release|Any CPU
+		{386A9769-59BF-4BE3-99D4-A9603E300729}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 
 	GlobalSection(NestedProjects) = preSolution
@@ -143,5 +171,7 @@ Global
 		{A422C742-2CF9-409D-BDAE-15825AB62113} = {1CFF5568-8486-475F-81F6-06105C437528}
 		{4EC48E6A-45B5-4E25-ABBD-C23FE2BD6E1E} = {1CFF5568-8486-475F-81F6-06105C437528}
 		{A040AED5-BBB8-4BFA-B2A5-BBD82817B8A5} = {1CFF5568-8486-475F-81F6-06105C437528}
+		{1ECB31E8-2EF0-41E2-8C71-CB9876D207F0} = {73C9B1E5-3893-47E8-B373-17E5F5D7E6F5}
+		{386A9769-59BF-4BE3-99D4-A9603E300729} = {1CFF5568-8486-475F-81F6-06105C437528}
 	EndGlobalSection
 EndGlobal

libraries/src/AWS.Lambda.Powertools.Parameters/AWS.Lambda.Powertools.Parameters.csproj

@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <TargetFramework>net6.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+    </PropertyGroup>
+
+    <ItemGroup>
+      <PackageReference Include="AWSSDK.AppConfigData" Version="3.7.0.110" />
+      <PackageReference Include="AWSSDK.DynamoDBv2" Version="3.7.5.10" />
+      <PackageReference Include="AWSSDK.SecretsManager" Version="3.7.2.88" />
+      <PackageReference Include="AWSSDK.SimpleSystemsManagement" Version="3.7.18.2" />
+      <PackageReference Include="Microsoft.Extensions.Configuration" Version="6.0.1" />
+    </ItemGroup>
+
+</Project>

libraries/src/AWS.Lambda.Powertools.Parameters/Cache/ICacheManager.cs

@@ -0,0 +1,37 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+namespace AWS.Lambda.Powertools.Parameters.Cache;
+
+/// <summary>
+/// Represents a type used to manage cache.
+/// </summary>
+public interface ICacheManager
+{
+    /// <summary>
+    /// Retrieves a cached value by key. 
+    /// </summary>
+    /// <param name="key">The key to retrieve.</param>
+    /// <returns>The cached object.</returns>
+    object? Get(string key);
+
+    /// <summary>
+    /// Adds a value to the cache by key for a specific duration. 
+    /// </summary>
+    /// <param name="key">The key to store the value.</param>
+    /// <param name="value">The value to store.</param>
+    /// <param name="duration">The expiry duration.</param>
+    void Set(string key, object? value, TimeSpan duration);
+}

libraries/src/AWS.Lambda.Powertools.Parameters/Cache/IDateTimeWrapper.cs

@@ -0,0 +1,27 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+namespace AWS.Lambda.Powertools.Parameters.Cache;
+
+/// <summary>
+/// Represents a type used to wrap datetime.
+/// </summary>
+public interface IDateTimeWrapper
+{
+    /// <summary>
+    /// Gets the current UTC time.
+    /// </summary>
+    DateTime UtcNow { get; }
+}

libraries/src/AWS.Lambda.Powertools.Parameters/Configuration/ParameterProviderConfiguration.cs

@@ -0,0 +1,39 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+using AWS.Lambda.Powertools.Parameters.Transform;
+
+namespace AWS.Lambda.Powertools.Parameters.Configuration;
+
+/// <summary>
+/// ParameterProviderConfiguration class.
+/// </summary>
+public class ParameterProviderConfiguration
+{
+    /// <summary>
+    /// Fetches the latest value from the store regardless if already available in cache.
+    /// </summary>
+    public bool ForceFetch { get; set; }
+
+    /// <summary>
+    /// The cache maximum age.
+    /// </summary>
+    public TimeSpan? MaxAge { get; set; }
+
+    /// <summary>
+    /// The transformer instance.
+    /// </summary>
+    public ITransformer? Transformer { get; set; }
+}