adding api endpoint for performing command

Author: toddtarsi

packages/selenium-ide/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seleniumhq/selenium-ide",
-  "version": "4.0.0-alpha.58",
+  "version": "4.0.0-alpha.59",
   "private": true,
   "description": "Selenium IDE electron app",
   "author": "Todd <[email protected]>",
@@ -105,7 +105,7 @@
     "@seleniumhq/code-export-python-pytest": "^4.0.0-alpha.2",
     "@seleniumhq/code-export-ruby-rspec": "^4.0.0-alpha.1",
     "@seleniumhq/get-driver": "^4.0.0-alpha.1",
-    "@seleniumhq/side-api": "^4.0.0-alpha.36",
+    "@seleniumhq/side-api": "^4.0.0-alpha.37",
     "@seleniumhq/side-model": "^4.0.0-alpha.4",
     "@seleniumhq/side-runtime": "^4.0.0-alpha.31",
     "dnd-core": "^16.0.1",

packages/selenium-ide/src/main/session/controllers/Playback/index.ts

@@ -1,11 +1,11 @@
+import { CommandShape, hasID } from '@seleniumhq/side-api'
 import {
   Playback,
   PlaybackEvents,
   PlaybackEventShapes,
   Variables,
 } from '@seleniumhq/side-runtime'
 import { WebDriverExecutorHooks } from '@seleniumhq/side-runtime/src/webdriver'
-import { hasID } from '@seleniumhq/side-api/dist/helpers/hasID'
 import { randomUUID } from 'crypto'
 import { session } from 'electron'
 import { Session } from 'main/types'
@@ -95,6 +95,23 @@ export default class PlaybackController extends BaseController {
     this.playbacks.forEach((playback) => playback.pause())
   }
 
+  async performCommand(
+    command: Omit<CommandShape, 'id'>
+  ) {
+    const playback = new Playback({
+      baseUrl: this.session.projects.project.url,
+      executor: await this.session.driver.build({}),
+      getTestByName: (name: string) => this.session.tests.getByName(name),
+      logger: console,
+      variables: new Variables(),
+      options: {
+        delay: this.session.projects.project.delay || 0,
+      },
+    })
+    await playback.playSingleCommand({ ...command, id: '-1' })
+    await playback.cleanup()
+  }
+
   async stop() {
     if (this.isPlaying) {
       await this.pause()

packages/side-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seleniumhq/side-api",
-  "version": "4.0.0-alpha.36",
+  "version": "4.0.0-alpha.37",
   "private": false,
   "description": "Selenium IDE API command shapes and such",
   "author": "Todd Tarsi <[email protected]>",

packages/side-api/src/commands/playback/index.ts

@@ -5,6 +5,7 @@ import type { Shape as OnBeforeAll } from './onBeforeAll'
 import type { Shape as OnPlayUpdate } from './onPlayUpdate'
 import type { Shape as OnStepUpdate } from './onStepUpdate'
 import type { Shape as Pause } from './pause'
+import type { Shape as PerformCommand } from './performCommand'
 import type { Shape as Play } from './play'
 import type { Shape as PlaySuite } from './playSuite'
 import type { Shape as Resume } from './resume'
@@ -17,6 +18,7 @@ import * as onBeforeAll from './onBeforeAll'
 import * as onPlayUpdate from './onPlayUpdate'
 import * as onStepUpdate from './onStepUpdate'
 import * as pause from './pause'
+import * as performCommand from './performCommand'
 import * as play from './play'
 import * as playSuite from './playSuite'
 import * as resume from './resume'
@@ -30,6 +32,7 @@ export const commands = {
   onPlayUpdate,
   onStepUpdate,
   pause,
+  performCommand,
   play,
   playSuite,
   resume,
@@ -47,6 +50,7 @@ export type Shape = {
   onPlayUpdate: OnPlayUpdate
   onStepUpdate: OnStepUpdate
   pause: Pause
+  performCommand: PerformCommand
   play: Play
   playSuite: PlaySuite
   resume: Resume

packages/side-api/src/commands/playback/performCommand.ts

@@ -0,0 +1,6 @@
+import { CommandShape } from '@seleniumhq/side-model'
+
+/**
+ * Attempts to execute a command supplied via API directly
+ */
+export type Shape = (cmd: Omit<CommandShape, 'id'>) => Promise<boolean>

packages/side-example-suite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seleniumhq/side-example-suite",
-  "version": "4.0.0-alpha.4",
+  "version": "4.0.0-alpha.5",
   "private": true,
   "description": "Selenium IDE example suite, with tests, plugin, and export format",
   "author": "Todd <[email protected]>",
@@ -21,7 +21,7 @@
     "@seleniumhq/code-export-python-pytest": "4.0.0-alpha.2"
   },
   "devDependencies": {
-    "@seleniumhq/side-api": "^4.0.0-alpha.33"
+    "@seleniumhq/side-api": "^4.0.0-alpha.37"
   },
   "repository": {
     "type": "git",