misc: deprecatedUntilVersion annotation

Author: 0marperez

runtime/runtime-core/api/runtime-core.api

@@ -15,6 +15,11 @@ public class aws/smithy/kotlin/runtime/ClientException : aws/smithy/kotlin/runti
 	public fun <init> (Ljava/lang/Throwable;)V
 }
 
+public abstract interface annotation class aws/smithy/kotlin/runtime/DeprecatedUntilVersion : java/lang/annotation/Annotation {
+	public abstract fun major ()I
+	public abstract fun minor ()I
+}
+
 public class aws/smithy/kotlin/runtime/ErrorMetadata {
 	public static final field Companion Laws/smithy/kotlin/runtime/ErrorMetadata$Companion;
 	public fun <init> ()V

runtime/runtime-core/common/src/aws/smithy/kotlin/runtime/Annotations.kt

@@ -58,3 +58,16 @@ public annotation class ExperimentalApi
  */
 @DslMarker
 public annotation class SdkDsl
+
+/**
+ * Indicates that the annotated API is deprecated and scheduled for removal in an upcoming minor version.
+ * Any code using this API should migrate to the suggested replacement as soon as possible.
+ */
+@RequiresOptIn(
+    message = "This API is deprecated and will be removed in an upcoming minor version.",
+    level = RequiresOptIn.Level.WARNING,
+)
+public annotation class DeprecatedUntilVersion(
+    val major: Int,
+    val minor: Int,
+)