@runium/cli 0.0.3 → 0.0.4

package/src/services/shutdown.ts

@@ -1,147 +0,0 @@
-import { Inject, Service } from 'typedi';
-import { OutputService, PluginService } from '@services';
-
-type ShutdownBlocker = (reason?: string) => Promise<void> | void;
-
-const TIMEOUT = 30000;
-const EXIT_DELAY = 250;
-const SIGNALS: NodeJS.Signals[] = ['SIGHUP', 'SIGINT', 'SIGTERM', 'SIGQUIT'];
-
-@Service()
-export class ShutdownService {
-  private blockers: Set<ShutdownBlocker> = new Set();
-  private isShuttingDown = false;
-
-  constructor(
-    @Inject() private outputService: OutputService,
-    @Inject() private pluginService: PluginService
-  ) {}
-  /**
-   * Initialize shutdown handlers
-   */
-  async init(): Promise<void> {
-    SIGNALS.forEach(signal => {
-      process.on(signal, () => {
-        this.shutdown(signal).catch(error => {
-          this.outputService.error('Error during shutdown: %s', error.message);
-          this.outputService.debug('Error details:', error);
-          process.exit(1);
-        });
-      });
-    });
-
-    process.on('uncaughtException', error => {
-      this.outputService.error('Uncaught exception: %s', error.message);
-      this.outputService.debug('Error details:', error);
-      this.shutdown('uncaughtException').catch(() => {
-        process.exit(1);
-      });
-    });
-
-    process.on('unhandledRejection', (reason, promise) => {
-      this.outputService.error(
-        'Unhandled rejection at:',
-        promise,
-        'reason:',
-        reason
-      );
-      this.outputService.debug('Error details:', { reason, promise });
-      this.shutdown('unhandledRejection').catch(() => {
-        process.exit(1);
-      });
-    });
-
-    process.on('beforeExit', () => {
-      if (!this.isShuttingDown) {
-        this.shutdown('exit').catch(() => {
-          process.exit(1);
-        });
-      }
-    });
-  }
-
-  /**
-   * Add a shutdown blocker function
-   * @param blocker
-   */
-  addBlocker(blocker: ShutdownBlocker): void {
-    this.blockers.add(blocker);
-  }
-
-  /**
-   * Remove a shutdown blocker
-   * @param blocker
-   */
-  removeBlocker(blocker: ShutdownBlocker): boolean {
-    return this.blockers.delete(blocker);
-  }
-
-  /**
-   * Execute graceful shutdown
-   * @param reason
-   */
-  async shutdown(reason?: string): Promise<void> {
-    if (this.isShuttingDown || !reason) {
-      return;
-    }
-
-    // add plugin beforeExit hooks as shutdown blockers
-    const plugins = this.pluginService.getAllPlugins();
-    for (const plugin of plugins) {
-      const hook = plugin.hooks?.app?.beforeExit;
-      if (hook) {
-        this.addBlocker(hook.bind(plugin, reason));
-      }
-    }
-
-    this.isShuttingDown = true;
-
-    const exitProcess = (code: number): void => {
-      setTimeout(() => {
-        process.exit(code);
-      }, EXIT_DELAY);
-    };
-
-    if (this.blockers.size === 0) {
-      exitProcess(0);
-      return;
-    }
-
-    try {
-      await this.executeBlockersWithTimeout(reason);
-      exitProcess(0);
-    } catch (error) {
-      exitProcess(1);
-    }
-  }
-
-  /**
-   * Execute all blockers with timeout
-   * @param reason
-   */
-  private async executeBlockersWithTimeout(reason: string): Promise<void> {
-    const blockerPromises = Array.from(this.blockers).map(blocker =>
-      this.executeBlocker(blocker, reason)
-    );
-
-    const timeoutPromise = new Promise<never>((_, reject) => {
-      setTimeout(() => {
-        reject(new Error(`Shutdown timeout after ${TIMEOUT}ms`));
-      }, TIMEOUT);
-    });
-
-    await Promise.race([Promise.allSettled(blockerPromises), timeoutPromise]);
-  }
-
-  /**
-   * Execute a single blocker with error handling
-   * @param blocker
-   * @param reason
-   */
-  private async executeBlocker(
-    blocker: ShutdownBlocker,
-    reason: string
-  ): Promise<void> {
-    await blocker(reason);
-  }
-}

package/src/utils/convert-path-to-valid-file-name.ts

@@ -1,39 +0,0 @@
-const MAX_FILENAME_LENGTH = 200;
-
-/**
- * Converts a file path to a valid filename by replacing invalid characters
- * @param filePath
- * @param replacement
- */
-export function convertPathToValidFileName(
-  filePath: string,
-  replacement: string = '_'
-): string {
-  let filename = filePath.trim();
-
-  // replace path separators (both forward and backward slashes)
-  filename = filename.replace(/^\/+/, '');
-  filename = filename.replace(/[/\\]/g, replacement);
-
-  // replace invalid filename characters
-  // Windows: < > : " | ? * and control characters (0-31)
-  // also replacing common problematic characters
-  // eslint-disable-next-line no-control-regex
-  filename = filename.replace(/[<>:"|?*\x00-\x1F]/g, replacement);
-
-  // remove leading/trailing dots and spaces (problematic on Windows)
-  filename = filename.replace(/^[.\s]+|[.\s]+$/g, '');
-
-  // replace multiple consecutive replacement characters with a single one
-  const replacementRegex = new RegExp(
-    `${replacement.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}+`,
-    'g'
-  );
-  filename = filename.replace(replacementRegex, replacement);
-
-  if (filename.length > MAX_FILENAME_LENGTH) {
-    filename = filename.substring(0, MAX_FILENAME_LENGTH);
-  }
-
-  return filename;
-}

package/src/utils/debounce.ts

@@ -1,23 +0,0 @@
-/**
- * Create a debounced function
- *
- * @param func
- * @param wait
- */
-export function debounce<T extends (...args: unknown[]) => unknown>(
-  func: T,
-  wait: number
-): (...args: Parameters<T>) => void {
-  let timeoutId: NodeJS.Timeout | null = null;
-
-  return function debounced(...args: Parameters<T>): void {
-    if (timeoutId !== null) {
-      clearTimeout(timeoutId);
-    }
-
-    timeoutId = setTimeout(() => {
-      func(...args);
-      timeoutId = null;
-    }, wait);
-  };
-}

package/src/utils/format-timestamp.ts

@@ -1,17 +0,0 @@
-/**
- * Format a timestamp to 'yyyy-mm-dd hh:mm:ss' format
- * @param timestamp
- */
-export function formatTimestamp(timestamp: number | Date): string {
-  const date = typeof timestamp === 'number' ? new Date(timestamp) : timestamp;
-
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, '0');
-  const day = String(date.getDate()).padStart(2, '0');
-  const hours = String(date.getHours()).padStart(2, '0');
-  const minutes = String(date.getMinutes()).padStart(2, '0');
-  const seconds = String(date.getSeconds()).padStart(2, '0');
-  const milliseconds = String(date.getMilliseconds()).padStart(3, '0');
-
-  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;
-}

package/src/utils/get-version.ts

@@ -1,13 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-let version: string | null = null;
-
-export function getVersion(): string {
-  if (!version) {
-    const packageJsonPath = resolve(import.meta.dirname, '..', 'package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    version = packageJson.version;
-  }
-  return version as string;
-}

package/src/utils/index.ts

@@ -1,4 +0,0 @@
-export { convertPathToValidFileName } from './convert-path-to-valid-file-name.js';
-export { debounce } from './debounce.js';
-export { formatTimestamp } from './format-timestamp.js';
-export { getVersion } from './get-version.js';

package/src/validation/create-validator.ts

@@ -1,27 +0,0 @@
-import Ajv, { ValidateFunction } from 'ajv/dist/2020.js';
-
-const classes = { Function: Function };
-
-export type Validator<T = unknown> = ValidateFunction<T>;
-
-/**
- * Create validator
- * @param schema
- */
-export function createValidator<T = unknown>(schema: object): Validator<T> {
-  const ajv = new Ajv({
-    allowUnionTypes: true,
-    allErrors: true,
-    verbose: true,
-  });
-
-  ajv.addKeyword({
-    keyword: 'instanceof',
-    schemaType: 'string',
-    validate: (schema: string, data: unknown) => {
-      return data instanceof classes[schema as keyof typeof classes];
-    },
-  });
-
-  return ajv.compile<T>(schema);
-}

package/src/validation/get-config-schema.ts

@@ -1,59 +0,0 @@
-/**
- * Get config schema
- */
-export function getConfigSchema(): object {
-  return {
-    $schema: 'https://json-schema.org/draft/2020-12/schema',
-    $id: 'https://runium.dev/schemas/config.json',
-    title: 'Runium Config',
-    type: 'object',
-    properties: {
-      env: {
-        type: 'object',
-        properties: {
-          path: {
-            type: 'array',
-            items: {
-              type: 'string',
-            },
-          },
-        },
-        additionalProperties: false,
-      },
-      output: {
-        type: 'object',
-        properties: {
-          debug: {
-            type: 'boolean',
-          },
-        },
-        additionalProperties: false,
-      },
-      profile: {
-        type: 'object',
-        properties: {
-          path: {
-            type: 'string',
-          },
-        },
-        additionalProperties: false,
-      },
-      plugins: {
-        type: 'object',
-        additionalProperties: {
-          type: 'object',
-          properties: {
-            disabled: {
-              type: 'boolean',
-            },
-            options: {
-              type: 'object',
-            },
-          },
-          additionalProperties: false,
-        },
-      },
-    },
-    additionalProperties: false,
-  };
-}

package/src/validation/get-error-messages.ts

@@ -1,35 +0,0 @@
-import { ErrorObject } from 'ajv';
-import { AggregateAjvError, Options } from '@segment/ajv-human-errors';
-import { AjvError } from '@segment/ajv-human-errors/dist/cjs/aggregate-ajv-error';
-
-interface GetErrorMessagesOptions extends Options {
-  filter?: (error: AjvError) => boolean;
-}
-
-/**
- * Get error messages
- * @param errors
- * @param options
- */
-export function getErrorMessages(
-  errors: ErrorObject[],
-  options: GetErrorMessagesOptions = {
-    filter: () => true,
-  }
-): string[] {
-  const humanErrors = new AggregateAjvError(errors, {
-    fieldLabels: 'jsonPath',
-    includeData: true,
-    includeOriginalError: true,
-  });
-
-  const filter = options?.filter ?? (_ => true);
-  const messages = [];
-  for (const error of humanErrors) {
-    if (filter(error)) {
-      messages.push(error.message);
-    }
-  }
-
-  return messages;
-}

package/src/validation/get-plugin-schema.ts

@@ -1,137 +0,0 @@
-import { ID_REGEX } from '@runium/core';
-
-/**
- * Get plugin schema with function validation
- */
-export function getPluginSchema(): object {
-  return {
-    $schema: 'https://json-schema.org/draft/2020-12/schema',
-    $id: 'https://runium.dev/schemas/plugin.json',
-    title: 'Runium Plugin',
-    type: 'object',
-    properties: {
-      name: {
-        type: 'string',
-        minLength: 2,
-        pattern: ID_REGEX.source,
-      },
-      options: {
-        type: 'object',
-        description: 'Plugin configuration options',
-      },
-      project: {
-        type: 'object',
-        description: 'Project-level plugin definitions',
-        properties: {
-          macros: {
-            type: 'object',
-            description: 'Macro definitions for config file expansion',
-            additionalProperties: {
-              instanceof: 'Function',
-            },
-          },
-          tasks: {
-            type: 'object',
-            description: 'Task constructor definitions',
-            additionalProperties: {
-              instanceof: 'Function',
-            },
-          },
-          actions: {
-            type: 'object',
-            description: 'Action function definitions',
-            additionalProperties: {
-              instanceof: 'Function',
-            },
-          },
-          triggers: {
-            type: 'object',
-            description: 'Trigger constructor definitions',
-            additionalProperties: {
-              instanceof: 'Function',
-            },
-          },
-          validationSchema: {
-            type: 'object',
-            description: 'JSON Schema extension for project config validation',
-            additionalProperties: true,
-          },
-        },
-        additionalProperties: false,
-      },
-      app: {
-        type: 'object',
-        description: 'Application-level plugin definitions',
-        properties: {
-          commands: {
-            type: 'array',
-            description: 'Command constructor definitions',
-            items: {
-              instanceof: 'Function',
-            },
-          },
-        },
-        additionalProperties: false,
-      },
-      hooks: {
-        type: 'object',
-        description: 'Lifecycle hooks for app and project events',
-        properties: {
-          app: {
-            type: 'object',
-            description: 'Application lifecycle hooks',
-            properties: {
-              afterInit: {
-                instanceof: 'Function',
-                description: 'Hook called after app initialization',
-              },
-              beforeExit: {
-                instanceof: 'Function',
-                description: 'Hook called before app exit',
-              },
-              beforeCommandRun: {
-                instanceof: 'Function',
-                description: 'Hook called before command execution',
-              },
-              afterCommandRun: {
-                instanceof: 'Function',
-                description: 'Hook called after command execution',
-              },
-            },
-            additionalProperties: false,
-          },
-          project: {
-            type: 'object',
-            description: 'Project lifecycle hooks',
-            properties: {
-              beforeConfigRead: {
-                instanceof: 'Function',
-                description: 'Hook called before reading config file',
-              },
-              afterConfigRead: {
-                instanceof: 'Function',
-                description: 'Hook called after reading config file content',
-              },
-              afterConfigMacrosApply: {
-                instanceof: 'Function',
-                description: 'Hook called after applying macros to config',
-              },
-              afterConfigParse: {
-                instanceof: 'Function',
-                description: 'Hook called after parsing config',
-              },
-              beforeStart: {
-                instanceof: 'Function',
-                description: 'Hook called before project starts',
-              },
-            },
-            additionalProperties: false,
-          },
-        },
-        additionalProperties: false,
-      },
-    },
-    required: ['name'],
-    additionalProperties: false,
-  };
-}

package/src/validation/index.ts

@@ -1,4 +0,0 @@
-export { createValidator } from './create-validator.js';
-export { getConfigSchema } from './get-config-schema.js';
-export { getErrorMessages } from './get-error-messages.js';
-export { getPluginSchema } from './get-plugin-schema.js';

package/tsconfig.json

@@ -1,38 +0,0 @@
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "target": "esnext",
-    "outDir": "./lib",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "forceConsistentCasingInFileNames": true,
-    "declaration": false,
-    "sourceMap": false,
-    "strictNullChecks": true,
-    "removeComments": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "allowSyntheticDefaultImports": true,
-    "paths": {
-      "@commands/*": ["src/commands/*"],
-      "@commands": ["src/commands/index.js"],
-      "@constants/*": ["src/constants/*"],
-      "@constants": ["src/constants/index.js"],
-      "@macros/*": ["src/macros/*"],
-      "@macros": ["src/macros/index.js"],
-      "@services/*": ["src/services/*"],
-      "@services": ["src/services/index.js"],
-      "@utils/*": ["src/utils/*"],
-      "@utils": ["src/utils/index.js"],
-      "@validation/*": ["src/validation/*"],
-      "@validation": ["src/validation/index.js"]
-    },
-    "types": ["node", "@runium/types-core"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["lib/**/*"]
-}