@runium/cli 0.0.3 → 0.0.5

package/src/commands/plugin/plugin-list.ts

@@ -1,61 +0,0 @@
-import { Option } from 'commander';
-import { PluginCommand } from './plugin-command.js';
-
-/**
- * Plugin list command
- */
-export class PluginListCommand extends PluginCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('list')
-      .addOption(
-        new Option('-d, --disabled', 'show only disabled plugins').conflicts(
-          'enabled'
-        )
-      )
-      .addOption(
-        new Option('-e, --enabled', 'show only enabled plugins').conflicts(
-          'disabled'
-        )
-      )
-      .option('-s, --sort', 'sort by name')
-      .description('list plugins');
-  }
-
-  /**
-   * Handle command
-   */
-  protected async handle({
-    disabled,
-    enabled,
-    sort,
-  }: {
-    disabled: boolean;
-    enabled: boolean;
-    sort: boolean;
-  }): Promise<void> {
-    let plugins = this.profileService.getPlugins();
-    if (disabled) {
-      plugins = plugins.filter(p => p.disabled === true);
-    }
-    if (enabled) {
-      plugins = plugins.filter(p => p.disabled === false);
-    }
-    if (sort) {
-      plugins.sort((a, b) => a.name.localeCompare(b.name));
-    }
-
-    if (plugins.length !== 0) {
-      this.outputService.table(plugins, [
-        'name',
-        'path',
-        ...(disabled || enabled ? [] : ['disabled']),
-      ]);
-    } else {
-      this.outputService.warn('No plugins found');
-    }
-  }
-}

package/src/commands/plugin/plugin-remove.ts

@@ -1,42 +0,0 @@
-import { PluginCommand } from './plugin-command.js';
-
-/**
- * Plugin remove command
- */
-export class PluginRemoveCommand extends PluginCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('remove')
-      .description('remove plugin')
-      .option('-a, --all', 'remove all plugins')
-      .argument('[name...]', 'plugin names');
-  }
-
-  /**
-   * Handle command
-   * @param names
-   * @param all
-   */
-  protected async handle(
-    names: string[],
-    { all }: { all: boolean }
-  ): Promise<void> {
-    if (names.length === 0 && !all) {
-      this.outputService.warn('No plugins specified to remove');
-      return;
-    }
-    if (all) {
-      names = this.profileService.getPlugins().map(p => p.name);
-    }
-
-    for (const name of names) {
-      this.ensureProfilePlugin(name);
-      await this.profileService.removePlugin(name);
-      await this.pluginService.unloadPlugin(name);
-      this.outputService.success(`Plugin "%s" successfully removed`, name);
-    }
-  }
-}

package/src/commands/plugin/plugin.ts

@@ -1,36 +0,0 @@
-import { RuniumCommand } from '@commands/runium-command.js';
-import { PluginAddCommand } from './plugin-add.js';
-import { PluginDisableCommand } from './plugin-disable.js';
-import { PluginEnableCommand } from './plugin-enable.js';
-import { PluginListCommand } from './plugin-list.js';
-import { PluginRemoveCommand } from './plugin-remove.js';
-
-/**
- * Plugin group command
- */
-export class PluginCommand extends RuniumCommand {
-  /**
-   * Subcommands
-   */
-  subcommands = [
-    PluginListCommand,
-    PluginAddCommand,
-    PluginRemoveCommand,
-    PluginDisableCommand,
-    PluginEnableCommand,
-  ];
-
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command.name('plugin').description('manage plugins');
-  }
-
-  /**
-   * Handle command
-   */
-  protected async handle(): Promise<void> {
-    this.command.help();
-  }
-}

package/src/commands/project/project-add.ts

@@ -1,64 +0,0 @@
-import { ID_REGEX, RuniumError } from '@runium/core';
-import { ErrorCode } from '@constants';
-import { ProjectCommand } from './project-command.js';
-
-/**
- * Project add command
- */
-export class ProjectAddCommand extends ProjectCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('add')
-      .description('add project')
-      .argument('<path>', 'project file path')
-      .argument('[name]', 'project name (default: project config id)');
-  }
-
-  /**
-   * Handle command
-   * @param path
-   * @param name
-   */
-  protected async handle(path: string, name?: string): Promise<void> {
-    const projectPath = this.projectService.resolvePath(path);
-    const project = await this.projectService.initProject(projectPath);
-    if (project) {
-      const projectName = name ?? project.getConfig().id;
-
-      this.validateProjectName(projectName);
-
-      await this.profileService.addProject({
-        name: projectName,
-        path: projectPath,
-      });
-      this.outputService.success(
-        `Project "%s" successfully added`,
-        projectName
-      );
-    } else {
-      throw new RuniumError(
-        `Failed to add project "${projectPath}"`,
-        ErrorCode.PROJECT_NOT_FOUND,
-        { path: projectPath }
-      );
-    }
-  }
-
-  /**
-   * Validate project name
-   * @param name - project name to validate
-   * @throws RuniumError if name contains invalid characters
-   */
-  private validateProjectName(name: string): void {
-    if (!ID_REGEX.test(name)) {
-      throw new RuniumError(
-        `Invalid project name "${name}". Only letters, digits, underscores (_), and hyphens (-) are allowed.`,
-        ErrorCode.INVALID_ARGUMENT,
-        { name }
-      );
-    }
-  }
-}

package/src/commands/project/project-command.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-import { Container } from 'typedi';
-import { RuniumError } from '@runium/core';
-import { RuniumCommand } from '@commands/runium-command.js';
-import { ErrorCode } from '@constants';
-import {
-  ProfileService,
-  ProjectService,
-  ProfileProject,
-  FileService,
-} from '@services';
-
-/**
- * Base project command
- */
-export abstract class ProjectCommand extends RuniumCommand {
-  protected projectService: ProjectService;
-  protected profileService: ProfileService;
-  protected fileService: FileService;
-
-  constructor(parent: Command) {
-    super(parent);
-    this.projectService = Container.get(ProjectService);
-    this.profileService = Container.get(ProfileService);
-    this.fileService = Container.get(FileService);
-  }
-
-  /**
-   * Ensure project exists
-   * @param name
-   */
-  protected ensureProfileProject(name: string): ProfileProject {
-    const project = this.profileService.getProjectByName(name);
-    if (!project) {
-      throw new RuniumError(
-        `Project "${name}" not found`,
-        ErrorCode.PROJECT_NOT_FOUND,
-        { name }
-      );
-    }
-    return project;
-  }
-}

package/src/commands/project/project-list.ts

@@ -1,32 +0,0 @@
-import { ProjectCommand } from './project-command.js';
-
-/**
- * Project list command
- */
-export class ProjectListCommand extends ProjectCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('list')
-      .description('list projects')
-      .option('-s, --sort', 'sort by name');
-  }
-
-  /**
-   * Handle command
-   */
-  protected async handle({ sort }: { sort: boolean }): Promise<void> {
-    const projects = this.profileService.getProjects();
-    if (sort) {
-      projects.sort((a, b) => a.name.localeCompare(b.name));
-    }
-    // handle empty list
-    if (projects.length !== 0) {
-      this.outputService.table(projects, ['name', 'path']);
-    } else {
-      this.outputService.warn('No projects found');
-    }
-  }
-}

package/src/commands/project/project-remove.ts

@@ -1,41 +0,0 @@
-import { ProjectCommand } from './project-command.js';
-
-/**
- * Project remove command
- */
-export class ProjectRemoveCommand extends ProjectCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('remove')
-      .description('remove project')
-      .option('-a, --all', 'remove all projects')
-      .argument('[name...]', 'project names');
-  }
-
-  /**
-   * Handle command
-   * @param names
-   * @param all
-   */
-  protected async handle(
-    names: string[],
-    { all }: { all: boolean }
-  ): Promise<void> {
-    if (names.length === 0 && !all) {
-      this.outputService.warn('No projects specified to remove');
-      return;
-    }
-    if (all) {
-      names = this.profileService.getProjects().map(p => p.name);
-    }
-
-    for (const name of names) {
-      this.ensureProfileProject(name);
-      await this.profileService.removeProject(name);
-      this.outputService.success(`Project "%s" successfully removed`, name);
-    }
-  }
-}

package/src/commands/project/project-start.ts

@@ -1,158 +0,0 @@
-import { dirname } from 'node:path';
-import { Command, Option } from 'commander';
-import { Container } from 'typedi';
-import {
-  Project,
-  ProjectEvent,
-  ProjectState,
-  RuniumError,
-  TaskState,
-} from '@runium/core';
-import { ErrorCode } from '@constants';
-import { AtomicWriter, ShutdownService } from '@services';
-import { ProjectData, ProjectStateCommand } from './project-state-command.js';
-
-/**
- * Project start command
- */
-export class ProjectStartCommand extends ProjectStateCommand {
-  protected shutdownService: ShutdownService;
-  protected fileWriter: AtomicWriter | null = null;
-
-  constructor(parent: Command) {
-    super(parent);
-    this.shutdownService = Container.get(ShutdownService);
-  }
-
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('start')
-      .description('start project')
-      .option('-f, --file', 'use file path instead of project name')
-      .option('-o, --output', 'output project state changes')
-      .addOption(
-        new Option('-w, --working-dir <choice>', 'set working directory')
-          .choices(['cwd', 'project'])
-          .default('cwd')
-      )
-      .argument('<name>', 'project name');
-  }
-
-  /**
-   * Handle command
-   * @param name
-   * @param file
-   * @param workingDir
-   * @param output
-   */
-  protected async handle(
-    name: string,
-    {
-      file,
-      workingDir,
-      output,
-    }: { file: boolean; workingDir?: string; output?: boolean }
-  ): Promise<void> {
-    const path = file
-      ? this.projectService.resolvePath(name)
-      : this.ensureProfileProject(name).path;
-
-    const projectDataFileName = this.getProjectDataFileName(file ? path : name);
-    const projectDataFilePath = this.profileService.getPath(
-      'projects',
-      projectDataFileName
-    );
-
-    // check if project is started
-    const projectData = await this.readProjectData(projectDataFilePath);
-    if (projectData && this.isProjectProcessStarted(projectData.pid)) {
-      throw new RuniumError(
-        `Project "${name}" is already started`,
-        ErrorCode.PROJECT_ALREADY_STARTED,
-        { name }
-      );
-    }
-
-    if (workingDir === 'project') {
-      const projectDir = dirname(path);
-      if (projectDir !== process.cwd()) {
-        process.chdir(projectDir);
-      }
-    }
-
-    const project = await this.projectService.initProject(path);
-    this.shutdownService.addBlocker((reason?: string) => project.stop(reason));
-
-    await this.fileService.ensureDirExists(dirname(projectDataFilePath));
-    this.fileWriter = this.fileService.createAtomicWriter(projectDataFilePath);
-
-    this.addProjectListeners(project, {
-      projectPath: path,
-      output,
-    });
-
-    await this.projectService.runHook('project.beforeStart', project);
-
-    await project.start();
-  }
-
-  /**
-   * Add project listeners
-   * @param project
-   * @param options
-   */
-  protected addProjectListeners(
-    project: Project,
-    options: { projectPath: string; output?: boolean }
-  ): void {
-    const { projectPath, output } = options;
-
-    const projectData: ProjectData = {
-      id: project.getConfig().id,
-      pid: process.pid,
-      cwd: process.cwd(),
-      path: projectPath,
-      state: {
-        project: [],
-        tasks: {},
-      },
-    };
-
-    const writeProjectData = () => {
-      this.fileWriter!.writeJson(projectData).then();
-    };
-
-    // write initial data
-    writeProjectData();
-
-    project.on(ProjectEvent.STATE_CHANGE, async (state: ProjectState) => {
-      projectData.state.project.push(state);
-      writeProjectData();
-      if (output) {
-        this.outputService.info('Project %s', state.status);
-      }
-    });
-
-    project.on(
-      ProjectEvent.TASK_STATE_CHANGE,
-      (taskId: string, state: TaskState) => {
-        if (!projectData.state.tasks[taskId]) {
-          projectData.state.tasks[taskId] = [];
-        }
-        projectData.state.tasks[taskId].push(state);
-        writeProjectData();
-        if (output) {
-          this.outputService.info(
-            'Task %s %s %s',
-            taskId,
-            state.status,
-            state.exitCode || state.error || ''
-          );
-        }
-      }
-    );
-  }
-}

package/src/commands/project/project-state-command.ts

@@ -1,53 +0,0 @@
-import { convertPathToValidFileName } from '@utils';
-import { ProjectCommand } from './project-command.js';
-import { ProjectState, TaskState } from '@runium/core';
-
-export interface ProjectData {
-  id: string;
-  pid: number;
-  cwd: string;
-  path: string;
-  state: {
-    project: ProjectState[];
-    tasks: Record<string, TaskState[]>;
-  };
-}
-
-/**
- * Base project state command
- */
-export abstract class ProjectStateCommand extends ProjectCommand {
-  /**
-   * Get project data file name
-   * @param name
-   */
-  protected getProjectDataFileName(name: string): string {
-    let fileName = convertPathToValidFileName(name);
-    if (!fileName.endsWith('.json')) {
-      fileName = fileName + '.json';
-    }
-    return fileName;
-  }
-
-  /**
-   * Read project data
-   * @param path
-   */
-  protected async readProjectData(path: string): Promise<ProjectData | null> {
-    return this.fileService
-      .readJson(path)
-      .catch(() => null) as Promise<ProjectData | null>;
-  }
-
-  /**
-   * Checks if a project process is started
-   * @param pid
-   */
-  protected isProjectProcessStarted(pid: number): boolean {
-    try {
-      return process.kill(Number(pid), 0);
-    } catch (ex) {
-      return (ex as { code?: string }).code === 'EPERM';
-    }
-  }
-}

package/src/commands/project/project-status.ts

@@ -1,116 +0,0 @@
-import { formatTimestamp } from '@utils';
-import { ProjectStateCommand } from './project-state-command.js';
-
-interface StateRecord {
-  name: string;
-  status: string;
-  time: string;
-  timestamp: number;
-  reason?: string;
-  exitCode?: number;
-}
-
-/**
- * Project status command
- */
-export class ProjectStatusCommand extends ProjectStateCommand {
-  /**
-   * Config command
-   */
-  protected config(): void {
-    this.command
-      .name('status')
-      .description('get project status')
-      .option('-f, --file', 'use file path instead of project name')
-      .option('-t, --tasks', 'show tasks status')
-      .option('-a, --all', 'show status change history')
-      .argument('<name>', 'project name');
-  }
-
-  /**
-   * Handle command
-   * @param name
-   * @param file
-   * @param tasks
-   * @param all
-   */
-  protected async handle(
-    name: string,
-    { file, tasks, all }: { file: boolean; tasks: boolean; all: boolean }
-  ): Promise<void> {
-    const path = file
-      ? this.projectService.resolvePath(name)
-      : this.ensureProfileProject(name).path;
-
-    const projectDataFileName = this.getProjectDataFileName(file ? path : name);
-    const projectDataFilePath = this.profileService.getPath(
-      'projects',
-      projectDataFileName
-    );
-
-    const projectData = await this.readProjectData(projectDataFilePath);
-    if (projectData) {
-      let { project: projectState = [] } = projectData.state;
-      if (!all) {
-        projectState =
-          projectState.length > 0
-            ? [projectState[projectState.length - 1]]
-            : [];
-      }
-
-      if (tasks) {
-        const projectMappedState = projectState.map(state => {
-          return {
-            name: 'Project',
-            status: state.status,
-            time: formatTimestamp(state.timestamp),
-            timestamp: state.timestamp,
-            reason: state.reason || '',
-          };
-        });
-
-        const { tasks: tasksState = [] } = projectData.state;
-
-        const tasksMappedState: StateRecord[] = [];
-        Object.entries(tasksState).forEach(([key, value]) => {
-          if (!all) {
-            value = value.length > 0 ? [value[value.length - 1]] : [];
-          }
-          value.forEach(task => {
-            tasksMappedState.push({
-              name: key,
-              status: task.status,
-              time: formatTimestamp(task.timestamp),
-              timestamp: task.timestamp,
-              reason: [task.reason, task.exitCode].filter(Boolean).join(' '),
-            });
-          });
-        });
-
-        const mappedState: StateRecord[] = [
-          ...projectMappedState,
-          ...tasksMappedState,
-        ];
-        mappedState.sort((a, b) => a.timestamp - b.timestamp);
-
-        this.outputService.table(mappedState, [
-          'time',
-          'name',
-          'status',
-          'reason',
-        ]);
-      } else {
-        const mappedState = projectState.map(state => {
-          return {
-            status: state.status,
-            time: formatTimestamp(state.timestamp),
-          };
-        });
-
-        this.outputService.table(mappedState, ['time', 'status']);
-      }
-    } else {
-      this.outputService.info(`No project status for "${name}"`);
-    }
-  }
-}