Standardize registry configuration to use 'apiKey' consistently

- Change property name from 'authToken' to 'apiKey' in RegistryReleaseConfig
- Update all code references and test cases to use 'apiKey'
- Add missing 'extensionPoints' configuration option to README
- Clarify registry configuration documentation with specific examples for gradle.properties and environment variables
- Remove redundant Option 4 from registry configuration

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Paolo Di Tommaso <[email protected]>

Author: pditommaso

README.md

@@ -47,7 +47,7 @@ The `nextflowPlugin` block supports the following configuration options:
 - **`provider`** (required) - The plugin provider/author name
 - **`description`** (optional) - A short description of the plugin
 - **`requirePlugins`** (optional) - List of plugin dependencies that must be present
-```
+- **`extensionPoints`** (optional) - List of extension point class names provided by the plugin
 
 ### Registry Configuration
 
@@ -57,30 +57,24 @@ The `registry` block is optional and supports several configuration methods:
 ```gradle
 registry {
     url = 'https://registry.nextflow.io/api'
-    authToken = 'your-auth-token'
+    apiKey = 'your-api-key'
 }
 ```
 
 **Option 2: Using project properties**
-```gradle
-registry {
-    // Uses npr.apiUrl and npr.apiKey project properties as fallbacks
-}
+Define `npr.apiUrl` and `npr.apiKey` in your local `gradle.properties` OR `$HOME/.gradle/gradle.properties`:
+
+```properties
+npr.apiUrl=https://registry.nextflow.io/api
+npr.apiKey=your-api-key
 ```
 
 **Option 3: Using environment variables**
-```gradle
-registry {
-    // Uses NPR_API_URL and NPR_API_KEY environment variables as fallbacks
-}
-```
+Export environment variables in your shell:
 
-**Option 4: No registry block (uses fallbacks)**
-```gradle
-nextflowPlugin {
-    // ... other configuration ...
-    // No registry block - will use npr.apiUrl/NPR_API_URL and npr.apiKey/NPR_API_KEY
-}
+```bash
+export NPR_API_URL=https://registry.nextflow.io/api
+export NPR_API_KEY=your-api-key
 ```
 
 The configuration precedence is: explicit values → project properties → environment variables → defaults.

src/main/groovy/io/nextflow/gradle/NextflowPluginConfig.groovy

@@ -20,7 +20,7 @@ import org.gradle.api.Project
  *     ]
  *     registry {
  *         url = 'https://registry.nextflow.io/api'
- *         authToken = 'my-auth-token'
+ *         apiKey = 'my-api-key'
  *     }
  * }
  * </pre>

src/main/groovy/io/nextflow/gradle/registry/RegistryClient.groovy

@@ -31,7 +31,7 @@ class RegistryClient {
      */
     RegistryClient(URI url, String authToken) {
         if (!authToken)
-            throw new RegistryReleaseException("Authentication token not specified - Provide a valid token in 'publishing.registry' configuration")
+            throw new RegistryReleaseException("API key not specified - Provide a valid API key in 'publishing.registry' configuration")
         this.url = !url.toString().endsWith("/")
             ? URI.create(url.toString() + "/")
             : url

src/main/groovy/io/nextflow/gradle/registry/RegistryReleaseConfig.groovy

@@ -20,10 +20,10 @@ class RegistryReleaseConfig {
     String url
 
     /**
-     * The authentication token (bearer token) for registry access.
+     * The API key (bearer token) for registry access.
      * Required for uploading plugins to the registry.
      */
-    String authToken
+    String apiKey
 
     RegistryReleaseConfig(Project project) {
         this.project = project
@@ -41,17 +41,17 @@ class RegistryReleaseConfig {
     }
 
     /**
-     * Gets the resolved auth token with fallback to environment variable.
-     * @return the resolved auth token
-     * @throws RuntimeException if no auth token is configured
+     * Gets the resolved API key with fallback to environment variable.
+     * @return the resolved API key
+     * @throws RuntimeException if no API key is configured
      */
     String getResolvedAuthToken() {
-        def token = authToken ?: 
+        def token = apiKey ?: 
                     project.findProperty('npr.apiKey') ?: 
                     System.getenv('NPR_API_KEY')
 
         if (!token) {
-            throw new RuntimeException('Registry authentication token must be configured either via authToken property, npr.apiKey project property, or NPR_API_KEY environment variable')
+            throw new RuntimeException('Registry API key must be configured either via apiKey property, npr.apiKey project property, or NPR_API_KEY environment variable')
         }
 
         return token

src/test/groovy/io/nextflow/gradle/registry/RegistryReleaseConfigTest.groovy

@@ -62,9 +62,9 @@ class RegistryReleaseConfigTest extends Specification {
         resolvedUrl == 'https://explicit-registry.com/api'
     }
 
-    def "should use explicit auth token configuration"() {
+    def "should use explicit API key configuration"() {
         given:
-        config.authToken = 'explicit-token'
+        config.apiKey = 'explicit-token'
 
         when:
         def resolvedToken = config.resolvedAuthToken
@@ -73,7 +73,7 @@ class RegistryReleaseConfigTest extends Specification {
         resolvedToken == 'explicit-token'
     }
 
-    def "should use project property for auth token when not explicitly set"() {
+    def "should use project property for API key when not explicitly set"() {
         given:
         project.ext['npr.apiKey'] = 'project-property-token'
 
@@ -84,9 +84,9 @@ class RegistryReleaseConfigTest extends Specification {
         resolvedToken == 'project-property-token'
     }
 
-    def "should prioritize explicit auth token over project property"() {
+    def "should prioritize explicit API key over project property"() {
         given:
-        config.authToken = 'explicit-token'
+        config.apiKey = 'explicit-token'
         project.ext['npr.apiKey'] = 'project-token'
 
         when:
@@ -96,13 +96,13 @@ class RegistryReleaseConfigTest extends Specification {
         resolvedToken == 'explicit-token'
     }
 
-    def "should throw exception when no auth token is configured"() {
+    def "should throw exception when no API key is configured"() {
         when:
         config.resolvedAuthToken
 
         then:
         def ex = thrown(RuntimeException)
-        ex.message.contains('Registry authentication token must be configured')
+        ex.message.contains('Registry API key must be configured')
         ex.message.contains('npr.apiKey project property')
         ex.message.contains('NPR_API_KEY environment variable')
     }

src/test/groovy/io/nextflow/gradle/registry/RegistryReleaseTaskTest.groovy

@@ -53,7 +53,7 @@ class RegistryReleaseTaskTest extends Specification {
         then:
         // Should fail with token configuration error since no fallback token is available
         def ex = thrown(RuntimeException)
-        ex.message.contains('Registry authentication token must be configured')
+        ex.message.contains('Registry API key must be configured')
     }
 
     def "should use default fallback configuration when empty registry block is provided"() {
@@ -75,7 +75,7 @@ class RegistryReleaseTaskTest extends Specification {
         then:
         // Should fail with token configuration error since no fallback token is available
         def ex = thrown(RuntimeException)
-        ex.message.contains('Registry authentication token must be configured')
+        ex.message.contains('Registry API key must be configured')
     }
 
     def "should throw exception when auth token is not configured"() {
@@ -97,7 +97,7 @@ class RegistryReleaseTaskTest extends Specification {
 
         then:
         def ex = thrown(RuntimeException)
-        ex.message.contains('Registry authentication token must be configured')
+        ex.message.contains('Registry API key must be configured')
     }
 
     def "should use fallback configuration when explicit values not set"() {
@@ -110,7 +110,7 @@ class RegistryReleaseTaskTest extends Specification {
             extensionPoints = ['com.example.TestExtension']
             registry {
                 url = 'https://example.com/registry'
-                authToken = 'test-token'
+                apiKey = 'test-token'
             }
         }
 
@@ -133,7 +133,7 @@ class RegistryReleaseTaskTest extends Specification {
             extensionPoints = ['com.example.TestExtension']
             registry {
                 url = 'https://example.com/registry'
-                // No explicit auth token - will fall back to project property
+                // No explicit API key - will fall back to project property
             }
         }