Slotly.Core 10.0.2

Slotly.Core

Core types and abstractions for the Slotly plugin framework.

Part of the Slotly plugin framework.

Features

• IPlugin interface with explicit lifecycle methods (OnLoad, OnUnload, OnEnable, OnDisable)
• IPluginManifest for declaring plugin identity and dependencies
• IPluginContext providing host services and configuration to plugins
• PluginState enum modeling the full plugin lifecycle (Unloaded, Loaded, Enabled, Disabled, Faulted)
• PluginError base type with exhaustive Match for compile-time-safe error handling
• Result-based API throughout -- no exceptions, explicit error paths via Rustly Result<T, E>

Installation

dotnet add package Slotly.Core

Usage

Implement IPlugin to create a plugin with explicit lifecycle handling:

using Slotly;
using Slotly.Abstractions;
using Slotly.Errors.Abstractions;

public class GreeterPlugin : IPlugin
{
    public string Id => "com.example.greeter";
    public string Name => "Greeter";
    public string Version => "1.0.0";

    public Result<Unit, PluginError> OnLoad(IPluginContext context)
    {
        // Access host services through the context
        var logger = context.GetService<ILogger>();
        logger.Match(
            some: log => { log.Info("Greeter loaded"); return Unit.Value; },
            none: () => Unit.Value);

        return Unit.Value;
    }

    public Result<Unit, PluginError> OnUnload() => Unit.Value;
    public Result<Unit, PluginError> OnEnable() => Unit.Value;
    public Result<Unit, PluginError> OnDisable() => Unit.Value;
}

Use exhaustive error matching to handle every error variant at compile time:

Result<Unit, PluginError> result = plugin.OnLoad(context);

string message = result.UnwrapErr().Match(
    manifestNotFound:   e => $"Manifest missing: {e.Message}",
    manifestInvalid:    e => $"Manifest invalid: {e.Message}",
    dependencyMissing:  e => $"Missing dep: {e.Message}",
    dependencyCycle:    e => $"Cycle: {e.Message}",
    loadFailed:         e => $"Load failed: {e.Message}",
    entryPointNotFound: e => $"No entry point: {e.Message}",
    alreadyLoaded:      e => $"Already loaded: {e.Message}",
    invalidState:       e => $"Bad state: {e.Message}",
    sourceUnavailable:  e => $"Source gone: {e.Message}",
    archiveCorrupt:     e => $"Corrupt archive: {e.Message}",
    packagingFailed:    e => $"Packaging error: {e.Message}",
    versionInvalid:     e => $"Bad version: {e.Message}",
    permissionDenied:   e => $"Denied: {e.Message}",
    reloadFailed:       e => $"Reload error: {e.Message}",
    migrationFailed:    e => $"Migration error: {e.Message}");

License

MIT -- see LICENSE for details.