npm run command (#382)

* npm run command

* Formatting Markdown

---------

Co-authored-by: Tom Longhurst <thomhurst@users.noreply.github.com>

Author: thomhurst

src/ModularPipelines.Build/ReleaseNotes.md

@@ -1 +1 @@
-null
+*   Add npm run options

src/ModularPipelines.Node/INpm.cs

@@ -148,6 +148,8 @@ Task<CommandResult> ProfileDisable2fa(NpmProfileDisable2faOptions? options = def
 
     Task<CommandResult> Root(NpmRootOptions? options = default, CancellationToken token = default);
 
+    Task<CommandResult> Run(NpmRunOptions options, CancellationToken token = default);
+
     Task<CommandResult> Sbom(NpmSbomOptions? options = default, CancellationToken token = default);
 
     Task<CommandResult> Search(NpmSearchOptions options, CancellationToken token = default);

src/ModularPipelines.Node/Models/NpmRunOptions.cs

@@ -0,0 +1,10 @@
+using System.Diagnostics.CodeAnalysis;
+using ModularPipelines.Attributes;
+
+namespace ModularPipelines.Node.Models;
+
+[ExcludeFromCodeCoverage]
+[CommandPrecedingArguments("run")]
+public record NpmRunOptions(
+    [property: PositionalArgument(Position = Position.BeforeSwitches)] string ScriptName
+) : NpmOptions;

src/ModularPipelines.Node/Npm.cs

@@ -377,6 +377,11 @@ public async Task<CommandResult> Root(NpmRootOptions? options = default, Cancell
         return await _command.ExecuteCommandLineTool(options ?? new NpmRootOptions(), token);
     }
 
+    public async Task<CommandResult> Run(NpmRunOptions options, CancellationToken token = default)
+    {
+        return await _command.ExecuteCommandLineTool(options, token);
+    }
+
     public async Task<CommandResult> Sbom(NpmSbomOptions? options = default, CancellationToken token = default)
     {
         return await _command.ExecuteCommandLineTool(options ?? new NpmSbomOptions(), token);