Write actions

using Nimblio.Sdk;

[assembly: NimblioCategory("media", "Media", Icon = "play", Color = "#E86FA6")]

namespace MediaControls;

public enum VolumeChange
{
    [Option("Up")] Up,
    [Option("Down")] Down,
}

public sealed class VolumeInput
{
    [Field("Change", Kind = FieldKind.Segmented)]
    public VolumeChange Change { get; set; } = VolumeChange.Up;

    [Field("Steps", Kind = FieldKind.Slider, Min = 1, Max = 25, Help = "Each step is 2% of the volume.")]
    public int Steps { get; set; } = 5;
}

[NimblioAction("change_volume", Name = "Change volume by steps", Category = "media", Icon = "volume",
    Description = "Turns the volume up or down a few steps, like the volume keys on a keyboard.",
    Keywords = "sound louder quieter audio", Summary = "Turn the volume {change} by {steps}")]
public sealed class ChangeVolume : NimblioAction<VolumeInput>
{
    public override Task<ActionResult> RunAsync(VolumeInput input, IActionContext context, CancellationToken ct)
    {
        context.Require(Permissions.System);
        var key = input.Change == VolumeChange.Up ? MediaKeys.VolumeUp : MediaKeys.VolumeDown;
        for (var i = 0; i < input.Steps; i++) { ct.ThrowIfCancellationRequested(); MediaKeys.Press(key, context); }
        return Task.FromResult(ActionResult.Done($"Turned the volume {(input.Change == VolumeChange.Up ? "up" : "down")} {input.Steps} step(s)"));
    }
}

public enum Channel { General, Announcements }

public sealed class PostInput
{
    // string → text box. Tokens lets people insert {Files}, {Clipboard} or values from earlier steps.
    [Field("Message", Kind = FieldKind.Textarea, Tokens = true, Required = "Write the message to post.")]
    public string Message { get; set; } = "";

    // enum → drop-down. [Option] on each member sets its label.
    [Field("Channel")]
    public Channel Channel { get; set; } = Channel.General;

    // bool → switch, shown under “More settings”.
    [Field("Mention everyone", Advanced = true)]
    public bool MentionEveryone { get; set; }

    // Shown only while Channel is Announcements.
    [Field("Pin the message")]
    [ShowWhen(nameof(Channel), nameof(Channel.Announcements))]
    public bool Pin { get; set; }

    // A whole list value, such as {Files} from “Get files in folder”, arrives as one item per entry.
    [Field("Attachments", Tokens = true, Optional = true, Help = "Insert a list of files, or one path per line.")]
    public List<string> Attachments { get; set; } = new();

    [Field("Webhook URL", Kind = FieldKind.Url, Mono = true, Advanced = true,
        Regex = "^https://", RegexMessage = "Use an https:// address.")]
    public string WebhookUrl { get; set; } = "";
}

[NimblioAction("current_track", Name = "Get the current track", Category = "spotify", Icon = "music",
    Output = "Track name", Summary = "Get the track playing in Spotify")]
public sealed class CurrentTrack : NimblioAction<NoInput>
{
    public override async Task<ActionResult> RunAsync(NoInput input, IActionContext context, CancellationToken ct)
    {
        var track = await Spotify.GetCurrentTrackAsync(ct);
        return ActionResult.WithOutput($"Playing “{track}”", track);
    }
}

// A list that later steps can insert, or repeat over with “Repeat for each”:
return ActionResult.WithList($"Found {names.Count} playlists", names);

if (!Spotify.IsRunning)
    throw new ActionException(
        title: "Spotify isn't running",
        detail: "This action talks to the Spotify app on this PC.",
        fix: "Open Spotify, then run the workflow again.",
        code: "SPOTIFY_NOT_RUNNING");

if (!Uri.TryCreate(input.WebhookUrl, UriKind.Absolute, out _))
    throw new ActionException("The webhook address isn't valid", fix: "Copy it again from Discord's channel settings.",
        field: "webhookUrl");

public override async Task<ActionResult> RunAsync(PostInput input, IActionContext context, CancellationToken ct)
{
    context.Require(Permissions.Network);               // fails clearly if extension.json doesn't declare it

    var token = context.Secrets.Get("token");
    if (token == null)
    {
        token = await context.AskAsync("Paste your Discord bot token");
        if (token == null) throw new ActionException("No token was entered", fix: "Run the workflow again and paste the token.");
        context.Secrets.Set("token", token);             // encrypted for this Windows user
    }

    context.Report($"Posting to #{input.Channel}");      // an extra line in Run history
    context.Log("Using the bot API");                    // the log file and the nbext dev console
    await Discord.PostAsync(token, input.Message, ct);   // pass ct on, so Stop works
    return ActionResult.Done("Posted the message");
}

public sealed class SpotifyExtension : NimblioExtension
{
    internal static SpotifyClient? Client;

    public override async Task ActivateAsync(IExtensionContext context)
    {
        Client = await SpotifyClient.ConnectAsync(context.Secrets.Get("refresh-token"));
        context.Log("Connected to Spotify.");
    }

    public override Task DeactivateAsync() => Client?.DisposeAsync().AsTask() ?? Task.CompletedTask;
}