Enhance Akka helper with optional module flags and encapsulation

- Made internal members private (resolvers, version objects, helper methods)
- Added ReleaseVersions sealed trait for type-safe version handling
- Enhanced forRelease() with boolean flags for optional modules:
  withHTTP, withGrpc, withPersistence, withProjections, withManagement, withKafka
- Core test modules now included automatically with core modules
- Enabled update command in scripted test (verified with AKKA_REPO_TOKEN)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: respencer-ncl

src/main/scala/com/ossuminc/sbt/helpers/Akka.scala

@@ -5,61 +5,70 @@ import sbt.Keys.*
 
 /** A helper that can be used to configure the complex dependencies in the Akka Platform.
   *
-  * IMPORTANT: Akka is licensed under the Business Source License (BSL) 1.1 as of 2024.
-  * Two separate credentials are required:
+  * IMPORTANT: Akka is licensed under the Business Source License (BSL) 1.1 as of 2024. Two separate
+  * credentials are required:
   *
-  * 1. AKKA_REPO_TOKEN - Repository access token for downloading artifacts.
-  *    Set this environment variable with your token from https://account.akka.io
-  *    Used in repository URL: https://repo.akka.io/{token}/secure
+  *   1. AKKA_REPO_TOKEN - Repository access token for downloading artifacts. Set this environment
+  *      variable with your token from https://account.akka.io Used in repository URL:
+  *      https://repo.akka.io/{token}/secure
   *
-  * 2. akka.license-key - Runtime license key for your application.
-  *    Configure this in your application.conf, NOT as an environment variable for sbt.
+  * 2. akka.license-key - Runtime license key for your application. Configure this in your
+  * application.conf, NOT as an environment variable for sbt.
   *
   * This helper automatically:
-  * - Adds the Akka repository resolver with tokenized URL (requires AKKA_REPO_TOKEN)
-  * - Configures CrossVersion.for3Use2_13 for Scala 3 projects (Akka is Scala 2.13 only)
+  *   - Adds the Akka repository resolver with tokenized URL (requires AKKA_REPO_TOKEN)
+  *   - Configures CrossVersion.for3Use2_13 for Scala 3 projects (Akka is Scala 2.13 only)
   */
 object Akka extends AutoPluginHelper {
 
-  /** Akka repository URL with embedded token.
-    * Akka uses tokenized URLs for authentication - the token is part of the URL path.
-    * See https://doc.akka.io/libraries/akka-dependencies/current/
+  /** Akka repository URL with embedded token. Akka uses tokenized URLs for authentication - the
+    * token is part of the URL path. See https://doc.akka.io/libraries/akka-dependencies/current/
     */
-  def akkaRepoUrl: String = {
+  private def akkaRepoUrl: String = {
     sys.env.get("AKKA_REPO_TOKEN") match {
       case Some(token) => s"https://repo.akka.io/$token/secure"
       case None =>
         System.err.println(
           "WARNING: AKKA_REPO_TOKEN environment variable not set. " +
-          "Get your repository access token at https://account.akka.io"
+            "Get your repository access token at https://account.akka.io"
         )
         // Return a URL that will fail with a clear error
         "https://repo.akka.io/MISSING_TOKEN/secure"
     }
   }
 
   /** Akka Maven-style repository resolver */
-  def akkaMavenResolver: MavenRepository = "akka-secure-mvn".at(akkaRepoUrl)
+  private def akkaMavenResolver: MavenRepository = "akka-secure-mvn".at(akkaRepoUrl)
 
-  /** Akka Ivy-style repository resolver.
-    * Some Akka artifacts are published in Ivy format and require Ivy-style patterns.
+  /** Akka Ivy-style repository resolver. Some Akka artifacts are published in Ivy format and
+    * require Ivy-style patterns.
     */
-  def akkaIvyResolver: URLRepository =
+  private def akkaIvyResolver: URLRepository =
     Resolver.url("akka-secure-ivy", url(akkaRepoUrl))(Resolver.ivyStylePatterns)
 
   /** Both Akka resolvers (Maven and Ivy style) */
-  def akkaResolvers: Seq[Resolver] = Seq(akkaMavenResolver, akkaIvyResolver)
+  private def akkaResolvers: Seq[Resolver] = Seq(akkaMavenResolver, akkaIvyResolver)
 
   /** Helper to create Akka dependency with Scala 2.13 cross-version for Scala 3 compatibility */
-  def akkaModule(org: String, name: String, version: String): ModuleID =
+  private def akkaModule(org: String, name: String, version: String): ModuleID =
     (org %% name % version).cross(CrossVersion.for3Use2_13)
 
   /** Helper to create Akka test dependency with Scala 2.13 cross-version */
-  def akkaTestModule(org: String, name: String, version: String): ModuleID =
+  private def akkaTestModule(org: String, name: String, version: String): ModuleID =
     (org %% name % version % Test).cross(CrossVersion.for3Use2_13)
 
+  sealed trait ReleaseVersions {
+    def akka_core: String
+    def akka_http: String
+    def akka_grpc: String
+    def akka_persistence_r2dbc: String
+    def akka_management: String
+    def akka_projections: String
+    def akka_kafka: String
+  }
+
   /** Version numbers for Akka 2024.10 release */
-  object V_24_10 {
+  private object V_24_10 extends ReleaseVersions {
     val akka_core = "2.10.0"
     val akka_http = "10.7.0"
     val akka_grpc = "2.5.0"
@@ -69,10 +78,10 @@ object Akka extends AutoPluginHelper {
     val akka_kafka = "7.0.0"
   }
 
-  /** Version numbers for Akka 25.10 release (latest as of Jan 2026)
-    * Version numbers from: https://doc.akka.io/libraries/akka-dependencies/current/
+  /** Version numbers for Akka 25.10 release (latest as of Jan 2026) Version numbers from:
+    * https://doc.akka.io/libraries/akka-dependencies/current/
     */
-  object V_25_10 {
+  private object V_25_10 extends ReleaseVersions {
     val akka_core = "2.10.14"
     val akka_http = "10.7.3"
     val akka_grpc = "2.5.10"
@@ -156,28 +165,59 @@ object Akka extends AutoPluginHelper {
   /** Configure Akka dependencies for a specific release.
     *
     * Automatically adds:
-    * - Akka repository resolvers (Maven and Ivy style) with tokenized URL from AKKA_LICENSE_KEY
-    * - Core Akka modules for the specified release
+    *   - Akka repository resolvers (Maven and Ivy style) with tokenized URL from AKKA_LICENSE_KEY
+    *   - Core Akka modules for the specified release
     *
-    * @param release The Akka release version ("25.10" or "24.10"). Default is latest (25.10).
-    * @param project The project to configure
-    * @return The configured project with Akka resolvers and core modules
+    * @param release
+    *   The Akka release version ("25.10" or "24.10"). Default is latest (25.10).
+    * @param project
+    *   The project to configure
+    * @return
+    *   The configured project with Akka resolvers and core modules
     */
-  def forRelease(release: String = "")(project: Project): Project = {
-    val coreVersion = release match {
-      case "2025.10" | "25.10" | "latest" | "" => V_25_10.akka_core
-      case "2024.10" | "24.10"                 => V_24_10.akka_core
-      case other: String => throw new IllegalArgumentException(
-        s"Unknown Akka release: $other. Supported releases: 25.10 (latest), 24.10"
-      )
+  def forRelease(
+    release: String = "",
+    withHTTP: Boolean = false,
+    withGrpc: Boolean = false,
+    withPersistence: Boolean = false,
+    withProjections: Boolean = false,
+    withManagement: Boolean = false,
+    withKafka: Boolean = false
+  )(project: Project): Project = {
+    val versions: ReleaseVersions = release match {
+      case "2025.10" | "25.10" | "latest" | "" => V_25_10
+      case "2024.10" | "24.10"                 => V_24_10
+      case other: String =>
+        throw new IllegalArgumentException(
+          s"Unknown Akka release: $other. Supported releases: 25.10 (latest), 24.10"
+        )
     }
 
     project.settings(
       resolvers ++= akkaResolvers,
-      libraryDependencies ++= coreModules(coreVersion)
+      libraryDependencies ++= coreModules(versions.akka_core),
+      libraryDependencies ++= coreTestModules(versions.akka_core),
+      libraryDependencies ++= {
+        Seq.empty[ModuleID] ++ {
+          if (withHTTP) httpModules(versions.akka_http) ++ httpTestModules(versions.akka_http)
+          else Seq.empty[ModuleID]
+        } ++ {
+          if (withGrpc) grpcModules(versions.akka_grpc) else Seq.empty[ModuleID]
+        } ++ {
+          if (withPersistence) persistenceR2dbcModules(versions.akka_persistence_r2dbc)
+          else Seq.empty[ModuleID]
+        } ++ {
+          if (withProjections) projectionsModules(versions.akka_projections)
+          else Seq.empty[ModuleID]
+        } ++ {
+          if (withManagement) managementModules(versions.akka_management) else Seq.empty[ModuleID]
+        } ++ {
+          if (withKafka) kafkaModules(versions.akka_kafka) else Seq.empty[ModuleID]
+        }
+      }
     )
   }
 
-  /** Configure Akka with latest release */
+  /** Configure Akka with the latest release */
   def apply(project: Project): Project = forRelease("")(project)
 }

src/sbt-test/sbt-ossuminc/akka/test

@@ -2,4 +2,4 @@
 # Note: Akka dependencies require AKKA_REPO_TOKEN environment variable to resolve
 # This is the repository access token from https://account.akka.io (not the runtime license key)
 > show libraryDependencies
-#> update
+> update