Configuration

Builder API

Java

var config = new PlugwerkConfig.Builder(
    "https://myplugwerk.host",
    "acme-corp"
)
    .apiKey("pwk_...")
    .build();

Kotlin

val config = PlugwerkConfig.Builder(
    "https://myplugwerk.host",
    "acme-corp"
)
    .apiKey("pwk_...")
    .build()

Extension Points

The SDK provides these PF4J extension points:

Extension Point	Purpose
PlugwerkCatalog	Search and browse plugins
PlugwerkInstaller	Download, verify, and install plugins
PlugwerkUpdateChecker	Check for available updates
PlugwerkMarketplace	Facade combining all three

Usage

Access the SDK through the PlugwerkMarketplace facade:

Java

var marketplace = pluginManager
    .getExtensions(PlugwerkMarketplace.class)
    .getFirst();

// Browse catalog
var plugins = marketplace.catalog().listPlugins();

// Search
var results = marketplace.catalog()
    .searchPlugins(new SearchCriteria("crm", null, null));

// Install
var result = marketplace.installer()
    .install("com.acme.crm-connector", "3.0.0");

// Check for updates
var installed = Map.of("com.acme.crm-connector", "2.0.0");
var updates = marketplace.updateChecker()
    .checkForUpdates(installed);

Kotlin

val marketplace = pluginManager
    .getExtensions(PlugwerkMarketplace::class.java)
    .first()

// Browse catalog
val plugins = marketplace.catalog().listPlugins()

// Search
val results = marketplace.catalog()
    .searchPlugins(SearchCriteria(query = "crm"))

// Install
val result = marketplace.installer()
    .install("com.acme.crm-connector", "3.0.0")

// Check for updates
val installed = mapOf("com.acme.crm-connector" to "2.0.0")
val updates = marketplace.updateChecker()
    .checkForUpdates(installed)